3D Projection
Description
The 3D Projection node projects an input image onto a card or geometric primitive through a camera in a 3D scene. Use it to project painted repairs, replacement images, or graphics onto an existing surface.
The projection can follow the camera and input image sequence, or both can be frozen at a selected frame. Freezing the projection is useful when painting a repair on one frame and viewing it through a moving camera.
Note: 3D Projection outputs scene data. Connect it to a 3D Renderer node to create an image for compositing or output.
Go to the 3D Projection tutorial to see how it works.
Node Group
3D.
Controls
Surface
Selects the card or geometric primitive that receives the input image. The menu lists eligible surfaces from the incoming scene, with parent names included to identify objects in a hierarchy. Auto automatically selects the first eligible card in the scene hierarchy. If no eligible card is available, the first eligible geometric primitive is used. Select a named surface when the scene contains several possible targets.
Camera
Selects the camera used to project the input image onto the surface. The menu lists cameras from the incoming scene.
The projection camera determines where the image falls on the surface. The scene’s active camera determines the view used by the 3D Renderer. These can be different cameras.
Active Camera
Uses the active camera of the scene being rendered as the projection camera. Changing the scene’s active camera also changes the camera used for projection.
Choose a named camera to keep the projection associated with that camera while viewing or rendering through another camera.
Freeze Frame
Holds both the input image and projection camera at the Projection Frame. This keeps the projection at the selected frame’s camera position and settings while the scene is viewed through a moving camera.
When disabled, the input image and projection camera update with the current frame. Freeze Frame is enabled by default.
Note: Freeze Frame holds the projection, not the surface. An object that moves independently through the scene can move through the frozen projection.
Projection Frame
Sets the frame used for both the input image and projection camera when Freeze Frame is enabled.
Choose the frame on which the image was painted or aligned to the surface. Projection Frame is unavailable when Freeze Frame is disabled.
Edges
Determines what appears where the surface samples outside the input image. Transparent is the default.
Transparent
Leaves the area outside the image transparent.
Clamp
Extends the image’s border pixels beyond its edges.
Repeat
Tiles the image beyond its edges.
Mirror
Tiles the image with alternating mirrored copies.
Opacity
Sets the projected image’s opacity from 0 to 100 percent.
Scene Transform
Select Scene Transform in the Object List to adjust the scene’s Position, Rotate, and Scale. You can also click a point in the scene and choose Make Origin to shift the entire scene relative to the world-origin grid, including its camera, and these changes stack with upstream scene transforms. Use the replacement object’s own transform when you want to move only that surface, or use the node’s placement controls when you want to move only its image.
Object Transform
Cameras, cards, and primitives can all be transformed using the Position, Scale, and Rotate controls.
Position
Moves the selected object along the x, y or z axis.
Scale
Scales the selected object along the x, y or z axis.
Rotate
Rotates the selected object along the x, y or z axis.
3D Views
Located in the Viewer, there are a number of 3D Views to visualize the 3D point cloud. See the 3D Views options for more information.
