VR Headset Camera
Method #
A VR headset camera, currently compatible with the Oculus Rift and HTC Vive.
The camera reads the head tracking data from the VR headset and renders the appropriate view inline with the headset vendors specifications.
See Using Headset VR for instructions on how to create a VR enabled scene.
VR Headset support is under active development. Please contact us if you are planning to use this feature so that we can work with you to achieve your goal.
Not all Post-FX nodes are currently compatible with the VR Headset camera. Development is continuing to bring compatibility for all relevant effects. If your immediate project needs a specific effect supported, please contact us directly.
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 or 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.
Control the inheritance of the transforms from the parent.
Parameter Details Position Toggle inheritance of the Position from the parent.
Rotation Toggle inheritance of the Rotation from the parent.
Scale Toggle inheritance of the 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 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.
Recentre Headset X To 0 Recentres the headset x position to the origin.
Recentre Headset Y To 0 Recentres the headset y position to the origin.
Recentre Headset Z To 0 Recentres the headset z position to the origin.
Dynamic Resolution When enabled, these properties control how the resolution can dynamically scale depending on the current frame rate, to maintain a high performance target.
Dynamic Scale Min Sets the minimum scale of the resolution
Dynamic Scale Max Sets the maximum scale of the resolution
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. |
| Scale X | Scale along the local x-axis. |
| Scale Y | Scale along the local y-axis. |
| Scale Z | Scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the 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 |
|---|---|
| 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. |
| Recentre Headset X To 0 | Recentres the headset x position to the origin. |
| Recentre Headset Y To 0 | Recentres the headset y position to the origin. |
| Recentre Headset Z To 0 | Recentres the headset z position to the origin. |
| Dynamic Resolution | When enabled, these properties control how the resolution can dynamically scale depending on the current frame rate, to maintain a high performance target. |
| Dynamic Scale Min | Sets the minimum scale of the resolution |
| Dynamic Scale Max | Sets the maximum scale of the resolution |
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 |