Hi All,
This is mostly a WebCGM 2.0 issue, but it also applies to 2.1 also. The WebCGM
2.0 and WebCGM 2.1 PR spec says the following about the highlight method:
highlight
Highlights a collection of Application Structures (APSs). WebCGM also allows
for highlighting of APSs using the IRI
fragment syntax. The exact method of highlighting is viewer dependent. The
highlight method provides a way for WebCGM script writers to highlight APSs in
the same way a IRI fragment would. It also allows for highlighting of entire
layers. Highlighting is not defined for WebCGMPicture nodes or XML Metadata
nodes. APS of type 'grnode'
are not valid in the node list, and shall cause no change to the viewed image
or the DOM tree. See the 'visibility'
APS Attribute for discussion of its effect on execution of the highlight
method.
Parameters
nodes of type WebCGMNodeList
A WebCGMNodeList of APP_STRUCTURE_NODEs to highlight.
type of type WebCGMString
Denotes a behavior identical to the corresponding highlighting
object behavior keywords of the fragment syntax. Values: { add | new }.
Return value
No return value.
Exceptions
No exceptions.
More specifically about the type attribute. The spec says behavior identical to
the corresponding highlighting object behavior keywords of the fragment syntax.
Values: add | new.
Now jumping to the fragment syntax, we notice that add and new or not in the
list. Instead we have:
full
zoom
move
newHighlight
addHighlight
full+newHighlight
zoom+newHighlight (default)
move+newHighlight
full+addHighlight
zoom+addHighlight
move+addHighlight
clearHighlight
Questions:
- What do add and new map
to?
- Should the highlight()
method do any navigation (zoom, full, move)? Is that up to the implementation?
- I don t think we can
say identical to the corresponding [&] keywords , there is no corresponding
keywords?
- What should be done if
a user is expecting navigation (say zoom); and another doesn t want the
zooming. After all, one could argue that zooming should be included since that
s WebCGM 2.0 default and there is no zooming API in the WebCGM 2.0
specification.
Regards,
Benoit