CameraQuery

Queries parameters from a camera, creating an output for each query.

user

Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.

scene

The scene to query the camera from.

cameraMode

How the camera to be queried is specified.

• Render Camera : Uses the value of the render:camera option in the scene globals.

• Location : Uses the camera specified on the location plug.

location

The location within the scene containing a camera to query.

Note

If the location does not exist then the query will not be performed and all outputs will be set to their default values with each output source plug set to “None” (0).

queries

The camera parameters to be queried - arbitrary numbers of queries may be added as children of this plug via the user interface, or via python. Each child is a StringPlug whose value is the parameter to query.

Note

While a query typically returns the value of a parameter, a few special inbuilt queries return values not represented by a parameter but which are instead computed from the camera.

• apertureAspectRatio : aperture.x / aperture.y.

• fieldOfView : The horizontal field of view in degrees, based on focalLength and aperture.

• frustum : The screen window at a distance of 1 unit from the camera, taking into account filmFit, resolution, and pixelAspectRatio render overrides on the camera or values from the scene globals.

out

The parent plug of the query outputs. The order of outputs corresponds to the order of children of queries.