7.15. SetCurrentViewpoint

set_current_viewpoint ‐ An action for changing the viewpoint of the current user

7.15.1. Attributes

NameTypeDefaults
indexINTEGERNone (required if URI is not provided)
xlink:hrefURIEmpty string

7.15.2. Description

This action is used to change the view_point of the current user (the user associated with the currently selected window). The integer value of the index attribute defines rank of the viewpoint (viewpoint #0 is the base viewpoint located at the origin) and viewpoints are ranked according to their order in a depth first traversal of the scene graph. If the string contains parenthesized expressions, they are dynamically evaluated as numerical expressions and their values replace the expressions in the string.

If the index attribute is not provided, the xlink:href attribute must be provided and is used to refer to the current viewpoint by its URI reference.

7.15.3. Expected children

None.

7.15.4. Expected target

None.

7.15.5. Example

The example below defines an action that shifts to the third viewpoint.

<set_current_viewpoint index="3" />