Stable identity for this component, unique within a session. Auto-generated for runtime-created components; the editor overwrites it with a persistent id when projecting a saved document so references survive save / load / undo.
The owning GameObject; assigned by addComponent before onAttach runs.
Texture/video the projector samples. Null = nothing is projected.
Frustum shape. See ProjectorShape.
Vertical field of view in degrees, used when focalLength is null
and shape is 'perspective'.
Physical focal length in millimeters. When set (non-null), it overrides
fovY: the vertical FOV is derived from it and sensorHeight
as 2·atan(sensorHeight / (2·focalLength)) — matching a real camera lens.
Sensor height in millimeters used with focalLength (default 24mm, full-frame).
Width/height aspect ratio of the projected image.
World-space width of the ortho frustum when shape is 'rect'.
World-space height of the ortho frustum when shape is 'rect'.
Near plane of the projection frustum.
Far plane; surfaces beyond this receive nothing.
Linear RGB tint multiplied into the sampled color.
Overall strength in [0,1], folded into the blend per ProjectorBlend.
How the projected color combines with the target.
When false (default) the projector composites after deferred lighting as a flat unlit image. When true it instead writes the G-buffer albedo before lighting, so the projected texture receives scene light and shadow like a painted-on surface.
Sub-rectangle of the source image to project, as
[offsetX, offsetY, scaleX, scaleY] in [0,1]. Composed with any atlas
packing rect. [0,0,1,1] projects the whole image.
Fraction of the frustum edge [0,1] over which the image fades to zero,
softening the hard rectangular/cone boundary. 0 = hard edge.
Optional id selecting a registered custom projection program (e.g. a depth-aware per-texel reprojection). Null uses the built-in projection.
The simulation clock of the scene this component belongs to. Read inside
update (or any time after the GameObject is added to a scene) for
absolute time, frame count, FPS, and timeScale-aware delta — e.g.
this.time.elapsed, this.time.delta, this.time.frameCount.
this.time.delta equals the dt argument passed to update, so
components can ignore that argument entirely and pull everything from here.
Called once when the component is added to a GameObject. Override to acquire references to siblings/children or initialize resources.
Called once when the component is removed from its GameObject. Override to release resources or unsubscribe from events.
Called every frame by the GameObject's update traversal.
Frame delta time in seconds.
Called every frame by the GameObject's render traversal, after update and any input/controller mutations to the transform. Override to refresh per-frame state that render passes consume (e.g. Camera recomputes its cached view/projection matrices here).
Active render context (provides canvas width/height etc.).
Vertical field of view in radians for the perspective frustum, derived from focalLength+sensorHeight when a focal length is set, otherwise from fovY.
World-space position of the projector (GameObject origin).
World-space forward direction (GameObject local -Z, normalized).
Right-handed view matrix from the projector's position looking down its forward axis.
Combined projection·view matrix that maps a world position into the
projector's clip space. A point is inside the frustum when, after the
perspective divide, its xy lie in [-1,1] and z in [0,1].
Projects a texture (or video) onto scene surfaces from this GameObject's transform — the unlit, shape-controlled counterpart to a textured spotlight.
The GameObject's world transform supplies the projector's position and forward (-Z) direction; the shape/focalLength/range fields define the frustum the image is cast through. The projector pass reconstructs each shaded pixel's world position from the G-buffer depth, transforms it by projectionViewProj, and — when the pixel lands inside the frustum — samples source and blends it per blend.
Unlike SpotLight's cookie (which only modulates lit radiance on a cone), a projector composites its texture directly, so it can show as a flat unlit image, supports rectangular or perspective frusta, alpha transparency, and cropping.