5.6. ChangeUserViewpoint (transformation)

<change_user_viewpoint> ‐ A transformation through viewpoint change during rendering

5.6.1. Attributes

NameTypeDefaults
viewpointINTEGER0
xlink:href_viewpointURIEmpty string
xlink:hrefURINone (required)

5.6.2. Description

This element defines a transformation during the course of rendering by changing the viewpoint to an intermediary viewpoint for a given user during the scene graph traversal.

The integer value of the viewpoint attribute defines the index of the viewpoint that is chosen as intermediary viewpoint during scene graph traversal (and replaces the current viewpoint). The viewpoints are indexed in the order in which they are encountered in the scene description, the first one is viewpoint number 1. In addition to these explicitly defined viewpoints, there is a base viewpoint numbered 0 that is located at the origin.

If the viewpoint attribute is not provided and if the xlink:href_viewpoint attribute is provided, it is used to refer to the intermediary viewpoint by its URI reference.

If no intermediary viewpoint is defined, the default viewpoint is the base viewpoint.

The user that is concerned by the change of viewpoint is referred to by its URI reference by the value of the xlink:href attribute.

5.6.3. Expected child

None.

5.6.4. Example

In the example below, the user user_1 will have its viewpoint changed to the persp_camera viewpoint when this node is encountered during the scene graph traversal.

<node id="change_user_1" displayed="true">
  <change_user_viewpoint id="change_user_1" 
        xlink:href="#user_1" xlink:href_viewpoint="#persp_camera"/>
</node>