Exposable Camera
Method #
This camera is designed to be controlled directly by a media server when running as a block. This is useful for Augmented Reality (AR/XR) camera tracking setups, where the media server is passing through the camera tracking data.
See this video to see this feature in action.
When the Exposable Camera Values attribute is exposed, it is recognised by the media server as a controllable camera and it provides higher-level controls in the media server.
Nodes parented to this node will generally follow the standard parent-child relationship with nodes in Notch, with a couple exceptions:
- Most Post-FX nodes will only run when viewed through a camera when connected to the camera.
- The Camera Focus Target controls the focus position and attributes for the camera.
Parameters
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
Parameter Details
Position X Move along the local x-axis.
Position Y Move along the local y-axis.
Position Z Move along the local z-axis.
Rotation Heading Rotate around the local y-axis.
Rotation Pitch Rotate around the local x-axis.
Rotation Bank Rotate around the local z-axis.
Scale X Scale along the local x-axis.
Scale Y Scale along the local y-axis.
Scale Z Scale along the local z-axis.
Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.
Parameter Details
Position X Toggle inheritance of the X Position from the parent.
Position Y Toggle inheritance of the Y Position from the parent.
Position Z Toggle inheritance of the Z Position from the parent.
Rotation Heading Toggle inheritance of the Rotation Heading from the parent.
Rotation Pitch Toggle inheritance of the Rotation Pitch from the parent.
Rotation Bank Toggle inheritance of the Rotation Bank from the parent.
Scale X Toggle inheritance of the X Scale from the parent.
Scale Y Toggle inheritance of the Y Scale from the parent.
Scale Z Toggle inheritance of the Z Scale from the parent.
World Position Only Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details
Field Of View Y The angle to modify the FOV with. Only functions with Use Field OF View Y enabled.
Aspect Ratio Defines the ratio between the cameras width and height.
Near Clip The closest distance that will be rendered. WARNING: Reducing this value too low can reduce the accuracy of aspects of the render.
Far Clip The furthest distance that will be rendered by this camera. WARNING: Increasing this value too high, without increasing the Near Clip can reduce the accuracy of aspects of the renderer. Generally best left untouched.
Focal Plane Distance The distance from the camera that is sharp, when utilising Depth of Field. Requires a Depth of Field Post-FX node to be used.
Focal Range The range around the focal plane that is sharp. Requires a Depth of Field Post-FX node to be used.
Focal Bluriness How blurry the focal point is. Requires a Depth of Field Post-FX node to be used.
Priority Change the priority of the camera. If two or more cameras have the same priority, the highest camera node in the nodegraph heirarchy is used.
Flip Z Axis Flip the Z axis of the values passed by the media server
Exposable Camera Values You must expose this value for the media server to be able to control the Exposable Camera
Inputs
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
| Parameter | Details |
|---|---|
| Position X | Move along the local x-axis. |
| Position Y | Move along the local y-axis. |
| Position Z | Move along the local z-axis. |
| Rotation Heading | Rotate around the local y-axis. |
| Rotation Pitch | Rotate around the local x-axis. |
| Rotation Bank | Rotate around the local z-axis. |
| Scale X | Scale along the local x-axis. |
| Scale Y | Scale along the local y-axis. |
| Scale Z | Scale along the local z-axis. |
Toggle which transform channels should be inherited from the parent node. By default, all transforms will be inherited.
| Parameter | Details |
|---|---|
| Position X | Toggle inheritance of the X Position from the parent. |
| Position Y | Toggle inheritance of the Y Position from the parent. |
| Position Z | Toggle inheritance of the Z Position from the parent. |
| Rotation Heading | Toggle inheritance of the Rotation Heading from the parent. |
| Rotation Pitch | Toggle inheritance of the Rotation Pitch from the parent. |
| Rotation Bank | Toggle inheritance of the Rotation Bank from the parent. |
| Scale X | Toggle inheritance of the X Scale from the parent. |
| Scale Y | Toggle inheritance of the Y Scale from the parent. |
| Scale Z | Toggle inheritance of the Z Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| Field Of View Y | The angle to modify the FOV with. Only functions with Use Field OF View Y enabled. |
| Aspect Ratio | Defines the ratio between the cameras width and height. |
| Near Clip | The closest distance that will be rendered. WARNING: Reducing this value too low can reduce the accuracy of aspects of the render. |
| Far Clip | The furthest distance that will be rendered by this camera. WARNING: Increasing this value too high, without increasing the Near Clip can reduce the accuracy of aspects of the renderer. Generally best left untouched. |
| Focal Plane Distance | The distance from the camera that is sharp, when utilising Depth of Field. Requires a Depth of Field Post-FX node to be used. |
| Focal Range | The range around the focal plane that is sharp. Requires a Depth of Field Post-FX node to be used. |
| Focal Bluriness | How blurry the focal point is. Requires a Depth of Field Post-FX node to be used. |
| Priority | Change the priority of the camera. If two or more cameras have the same priority, the highest camera node in the nodegraph heirarchy is used. |
| Flip Z Axis | Flip the Z axis of the values passed by the media server |
| Exposable Camera Values | You must expose this value for the media server to be able to control the Exposable Camera |
| Name | Description | Typical Input |
|---|---|---|
| Included Objects | Select nodes will be included in the final rendering from this camera. Once a node is connected, all unconnected nodes will be treated as excluded. | 3D Object |
| Excluded Objects | Select objects to be ignored by this camera. These objects will not be rendered, but will otherwise be generated and impact performance. Once a node is connected, all unconnected nodes will be treated as included. | 3D Object |
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |
