3D Texture
Description
The 3D Texture node places an input image on a card or geometric primitive in a 3D scene. Use it to attach a replacement image, graphic, or texture to an existing surface, then adjust how the image fits and moves across that surface.
A card is replaced by a textured image plane. A primitive is replaced by a textured primitive of the same shape. The replacement initially carries the target’s placement and transform animation. The rest of the scene continues downstream.
Note: 3D Texture outputs scene data. Connect it to a 3D Renderer node to create an image for compositing or output.
Go to the 3D Texture tutorial to see how it works.
Node Group
3D.
Controls
Surface
Selects the card or primitive to receive the input image. The menu lists eligible objects from the Data input, with parent names included where needed to identify objects in a hierarchy.
Auto
Automatically uses the first card in the scene hierarchy. If the scene has no cards, the first geometric primitive is used. Choose a named target when the scene contains several possible surfaces.
Side
Selects how much of the target receives the image. Whole Object is the default and maps the image across the object’s surface layout.
Cube and Pyramid targets also offer numbered sides. Choose a number to place the image on that face alone. Other faces retain any upstream projections. Faces without images render according to the replacement primitive’s Wireframe setting.
Note: Face numbers are hidden on faces where an image is displayed in the 3D Viewer, including inherited images. Untextured faces retain their numbers. Disconnecting this node’s Input does not restore a number if an upstream image remains on that face.
Fit Mode
Controls how the input image is sized to the surface before Scale X and Scale Y are applied. Surface is the default. For a numbered Side, fitting uses that face’s dimensions. Whole Object on a primitive uses its UV surface layout.
Surface
Sizes the image to fill the surface in both directions. The image’s proportions change when the image and surface have different aspect ratios.
Width
Matches the image width to the surface width while preserving the image’s proportions. The resulting height can leave uncovered areas or extend beyond the surface, depending on the aspect ratios. Uncovered areas are handled by Edges; parts outside the surface are cropped.
Height
Matches the image height to the surface height while preserving the image’s proportions. The resulting width can leave uncovered areas or extend beyond the surface, depending on the aspect ratios. Uncovered areas are handled by Edges; parts outside the surface are cropped.
Scale X and Scale Y
Set the horizontal and vertical image size as percentages of the size established by Fit Mode. Both default to 100. Smaller values reduce the image and larger values enlarge it. Use equal values to preserve the proportions established by Fit Mode.
Offset X and Offset Y
Move the image across the surface. Values are percentages of the surface width and height, with 0 placing the image at the center. Positive Offset X moves right and positive Offset Y moves up.
Rotate
Rotates the image around its center in degrees.
Flip X and Flip Y
Flip X reverses the image left to right. Flip Y reverses it top to bottom. Both are off by default.
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.
Wireframe
For a geometric primitive, Wireframe affects both its Viewer display and its render. With Wireframe enabled, OpenGL and Ray Tracer render only faces with available image textures. Bare faces are omitted rather than filled with the object color; the wireframe edges themselves remain Viewer guides.
To render bare faces as solid geometry, select the replacement primitive in the Object List and disable Wireframe. Faces without textures then render with the object color and can obscure surfaces behind them. A face whose image cannot be loaded is also treated as bare.
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.
