DataPool User Guide

Version 2.13 | Published November 30, 2018 ©

DataCamera

images/download/attachments/30910247/plugins_datacamera-icon.png
The DataCamera plugin controls camera position and target according to the incoming data. If the container that the plugin controls has child containers, then the specified camera locks its position to the first child container and the destination of the camera is locked to the second child container. In this case the data should be of the following format:

DATA=<camera> <x position> <y position> <z position> <x target> <y target> <z target>;

Note: Position and target values are used as offsets from the child containers location.

If the container doesn’t have any child containers then the data should be of the following format:

DATA=<camera> <x position> <y position> <z position> <pan> <tilt> <twist>;

Note: Camera position change is relative to the container that the plugin works on.

The plugin works in two different modes: First, the data contains both the camera ID, the position and target of the camera and second, the data contains just the camera ID and the position and the target of the camera are calculated from the center of the first two children of the container. In the second mode, the container must have two children. The center of the first child determines the center of the camera and the center of the second child determines the target of the camera.

images/download/attachments/41810517/plugins_datacamera.png

Unique Parameters

  • Set Current: Defines whether a camera switch in the render window occurs if the incoming data refers to a different camera than the current camera. If set to On, then when incoming data refers to a camera other than the current camera selected in the render window, the camera switches to the camera defined in the incoming data. When set to Off, the camera defined in the incoming data is moved, but the current camera remains the same.

  • Function: This parameter is inactive. The parameter is kept for backwards compatibility and should not be used.