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.
Control the inheritance of the transforms 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.
Camera 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
Control the Depth Of Field properties on the camera. Depth OF FIeld must be enabled on a Renderer Node to function.
Parameter Details Focus Mode Control how the camera chooses its focus method. Adding a focus target as a child to the camera overwrites this property.
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 Bluriness How blurry the focal point is. Requires a Depth of Field Post-FX node to be used.
Focus Adaption Rate Controls how quickly the focus plane adapts to the new distance in auto mode.
Bokeh Shape control the shape used for generating a bokeh shapes in the depth of field
Blades If in polygon mode, set the number of blades used to generate the polygon.
Blade Rotation If in Polygon mode, Rotate the polygon shape.
Bokeh Image Select an image to use in Image mode.
Use Separate Near/Far Ranges When enabled, the new and far distance offsets are controlled seperately.
Focal Range The range around the focal plane that is sharp. Requires a Depth of Field Post-FX node to be used.
Near DOF Range Control the near range for the depth of field.
Far DOF Range Control the near range for the depth of field.
Use In Focus Area When enabled, control a range within the depth of field which isn’t affected by the blur.
In Focus Area Control the range for the in focus area.
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. |
Control the inheritance of the transforms 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. |
| Camera 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 |
Control the Depth Of Field properties on the camera. Depth OF FIeld must be enabled on a Renderer Node to function.
| Parameter | Details |
|---|---|
| Focus Mode | Control how the camera chooses its focus method. Adding a focus target as a child to the camera overwrites this property. |
| 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 Bluriness | How blurry the focal point is. Requires a Depth of Field Post-FX node to be used. |
| Focus Adaption Rate | Controls how quickly the focus plane adapts to the new distance in auto mode. |
| Bokeh Shape | control the shape used for generating a bokeh shapes in the depth of field |
| Blades | If in polygon mode, set the number of blades used to generate the polygon. |
| Blade Rotation | If in Polygon mode, Rotate the polygon shape. |
| Bokeh Image | Select an image to use in Image mode. |
| Use Separate Near/Far Ranges | When enabled, the new and far distance offsets are controlled seperately. |
| Focal Range | The range around the focal plane that is sharp. Requires a Depth of Field Post-FX node to be used. |
| Near DOF Range | Control the near range for the depth of field. |
| Far DOF Range | Control the near range for the depth of field. |
| Use In Focus Area | When enabled, control a range within the depth of field which isn’t affected by the blur. |
| In Focus Area | Control the range for the in focus area. |
| 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 |
