Overview
The uProjector is useful for texturing objects with multiple layers, applying a texture across multiple separate objects, projecting background shots from the camera's viewpoint, and more. The manual describes it as a variant of the uDisk node:
- lighting must be turned on to see the result of the projection;
- the projected light is treated as diffuse and specular light: it is affected by surface normals and can cause specular highlights;
- with Enable Shadows, it casts shadows;
- the projected light affects all objects downstream of the uProjector in the USD node tree;
- in Light mode, the image alpha does not clip geometry (use Texture mode instead);
- if two projections overlap, their light contributions are added.
If the object moves relative to the projector, the texture slides. To keep it locked to the object, group both in a uMerge so they move as one.
Where to find this node
- Effects Library:
Tools > USD > Projector > uProjector - Quick add: right-click in the Node Editor →
Add Tool > USD > Projector > uProjector
Inputs
- SceneInput (orange) - a USD scene. If a scene is connected, transformations applied to the projector also affect the rest of the scene.
- ProjectiveImage (white) - the 2D image to project. This connection is required.
Setup
Background → uProjector → uMerge
In the manual's example, the uProjector projects a Background onto USD primitives gathered in a uMerge, which outputs the projected set into a larger scene with camera and lights.
Controls tab
- Color
- the image is multiplied by this color before being projected.
- Intensity
- intensity of the projection in Light and Ambient Light modes. In Texture mode, it scales the color values of the texture.
- Exposure
- how much light exposes the scene, similar to Intensity.
- Color Temperature
- color temperature (Enable checkbox), 6500K (daylight) by default.
- Diffuse Response
- how much the light contributes to the diffuse color of materials.
- Specular Response
- how much the light contributes to the specular color of materials.
- Decay Type
- Quadratic Decay by default (intensity falls off with distance), Linear Decay (similar look) or No Decay (equal intensity everywhere).
- Decay Rate
- rate of falloff over distance. The lower the value, the stronger the projection.
- Shaping Focus
- focuses the projection from the edges to the center.
- Shaping Cone Angle
- width of the cone where the projector emits its full intensity, up to 180 degrees.
- Normalize Intensity
- checked, the width and height of the projection use default values; unchecked, you adjust them manually.
- Fit Method
- how the image fits within the cone (actually a pyramid of light, always square for the uProjector). Inside (the largest dimension fits inside the cone), Width, Height, Outside (the smallest dimension fits inside the cone, the image covers the whole pyramid) or Stretch (non-uniform scaling to exactly cover the cone).
- Projection Mode
- Light (projects as diffuse and specular light) or Texture (re-lightable projection that only strikes objects whose material uses a uCatcher).
Shadows
- Enable Shadows
- the projector produces shadows, using shadow maps. Selected by default.
- Shadow Color
- color of the shadow, black (0, 0, 0) by default.
- Density
- transparency of the shadow.
- Softness
- softness of the shadow.
- Softness Quality
- quality of that softness.
- Shadow Map Size
- size of the bitmap used for the shadow map. Larger values give more detailed shadows at the expense of memory and performance.
- Shadow Map Bias
- if no shadows are seen, fine tunes the shadow map to make it visible.
- Shadow Map Offset
- offsets the value of Shadow Map Size.
The Transform and Settings tabs are common to USD nodes.
Use cases
- Texture objects with multiple layers, or apply one texture across several separate objects.
- Project a background shot from the camera's viewpoint.
- Build a set by texturing groups of USD shapes (the manual's example).
Tips
- For a projection that must match a camera, the manual recommends the uCamera projection instead, which gives more control over aperture, film back and clip planes. The uProjector is mainly a custom light, with better control over intensity, color, decay and shadows.
- In Texture mode, connect a uCatcher to the specular texture input of a material: objects using that material receive the projection as part of their specular highlight.
