Aller au contenu

uProjector Node

By Kriss Norde

The uProjector projects an image onto USD geometry.

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.