Using a camera from the 3D Scenes panel create Trigger zones that will react when specified objects of the 3d scene are being touched in your pixel workspace by sensor coordinates in the input array.
This node is designed to be used in conjunction with the specified camera instantiated in the timeline and displayed in the preview and final rendering of the show.
It is intended to make elements in your 3d scenes interactive relative to user input.
This is a process sometimes referred to as 3D Picking where rasterized 2D content (e.g. pixel coorinates) are matched to the primitive (or object) in a 3D scene projected on the same surface.
Properties
Camera: (mandatory) Drag & drop the camera from the3D Scenespanel to be used to view the 3d scene and interact with objects
Default : Empty
Scene width: Set the width of the 3d render for the picking. This should be set to the same ratio as the one being used in the 2D preview/content
Default : 1920
Scene height: Set the height of the 3d render for the picking. This should be set to the same ratio as the one being used in the 2D preview/content
Default : 1080
Scale Factor: Sets a factor on the above resolution to reduce the quantity of pixels to process.
Default : 25 percent
Layer ID: Matches the ID property of the nodes in the3D Scenespanel. This enables to filter which objects should react to the 3D Picking and which shouldn’t.
Default : Empty
Inputs
| Name | Type | Description |
|---|---|---|
| Array | Array | Array containing the 2D coordinates (X, Y) to use for the Picking |
| Layer | Integer | Layer used to filter which objects should react to the picking in the 3D Scene |
Outputs
| Name | Type | Description |
|---|---|---|
| Array Enter | Array | Array of points touching pickable objects when an interaction occurs This output pin is only populated for a single frame for the On Enter’s Trigger Event |
| Count in Area | Integer | Number of points in interaction with pickable objects |
| Array in Area | Array | Array of points touching pickable objects Constantly refreshed as long as there are interactions |
| On Enter | Boolean | Sends a Trigger Event when a point enters in contact with a pickable object |
| On Exit | Boolean | Sends a Trigger Event when a point leaves a pickable object |
| Node | String | Name of the node that was picked |
| Tag | String | Tag of the node that was picked. The Tag is set by selecting the node in the 3D Scenes |
| X | Float | X coordinate of the point at the moment of the interaction Value is kept (not refreshed) until another Picking event occurs (enter or exit) |
| Y | Float | Y coordinate of the point at the moment of the interaction Value is kept (not refreshed) until another Picking event occurs (enter or exit) |
Example
In the following example, a Render Graph displaying white Debug Circles at the sensor’s coordinates is being used to visually render where the user’s input is.
Notice how the Trigger Area Scene 3d node reacts when the user input touches the Dodecahedron obejct in the 3d scene.
Need more help with this?
Don’t hesitate to contact us here.