Version: 2019.2
Billboard Asset
Mesh Components

Projector

Switch to Scripting

Note: Projector components are compatible only with the Built-in Render Pipeline. You cannot use Projector components in Projects that use the Universal Render Pipeline (URP) or High Definition Render Pipeline (HDRP).

A Projector allows you to project a MaterialAn asset that defines how a surface should be rendered, by including references to the Textures it uses, tiling information, Color tints and more. The available options for a Material depend on which Shader the Material is using. More info
See in Glossary
onto all objects that intersect its frustum. The Material must use the Projector/Light or Projector/Multiply shadersA small script that contains the mathematical calculations and algorithms for calculating the Color of each pixel rendered, based on the lighting input and the Material configuration. More info
See in Glossary
, available in Unity’s Standard Assets.

You can use a Projector to create:

  1. Blob shadows
  2. Bullet holes, or similar effects
  3. The effect of a real-world projector, using another CameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
    See in Glossary
    that is renderingThe process of drawing graphics to the screen (or to a render texture). By default, the main camera in Unity renders its view to the screen. More info
    See in Glossary
    to a Render TextureA special type of Texture that is created and updated at runtime. To use them, first create a new Render Texture and designate one of your Cameras to render into it. Then you can use the Render Texture in a Material just like a regular Texture. More info
    See in Glossary
  4. Stylized lighting effects
A Projector is used to create a Blob Shadow for this Robot
A Projector is used to create a Blob Shadow for this Robot

Using the Projector component

Standard Assets contains example PrefabsAn asset type that allows you to store a GameObject complete with components and properties. The prefab acts as a template from which you can create new object instances in the scene. More info
See in Glossary
that demonstrate the use of Projector components.

To use the Prefabs:

  1. Download Standard AssetsA collection of useful assets supplied with Unity. Unity ships with multiple Standard Asset such as 2D, Cameras, Characters, CrossPlatformInput, Effects, Environment, ParticleSystems, Prototyping, Utility, and Vehicles. More info
    See in Glossary
  2. Import StandardAssets > Effects > Projectors into your Project
  3. In the Project window, navigate to StandardAssets > Effects > Projectors > Prefabs
  4. Drag the one of the Prefabs into your Scene

You can use the Prefab as is in your Project, modify it, or examine it to see how it is configured.

Component properties

Property: Function:
Near Clip Plane Objects in front of the near clip plane will not be projected upon.
Far Clip Plane Objects beyond this distance will not be projected upon.
Field Of View The field of view in degrees. This is only used if the Projector is not Orthographic.
Aspect RatioThe relationship of an image’s proportional dimensions, such as its width and height.
See in Glossary
This allows you to tune the height and width of the Projector.
Orthographic If enabled, the Projector will be Orthographic instead of perspective.
Orthographic Size The Orthographic size of the Projection. This is only used if Orthographic is enabled.
Material The Material that will be projected.
Ignore Layers Objects in Layers that you specify here will not be projected upon. The default value is None.

Material configuration

When configuring a Material to use with the Projector/Light and Projector/Multiply shaders, be aware of the following:

Cookie texture:

  • Make sure texture wrap mode is set to “Clamp”
  • Turn on “Border Mipmaps” option in import settings
  • Use uncompressed texture format
  • Projector/Shadow also requires alpha channel to be present (typically Alpha from Grayscale option is ok)

Falloff texture (if present):

  • Data needs to be in alpha channel, so typically Alpha8 texture format
  • Make sure texture wrap mode is set to “Clamp”
  • Make sure leftmost pixelThe smallest unit in a computer image. Pixel size depends on your screen resolution. Pixel lighting is calculated at every screen pixel. More info
    See in Glossary
    column is black; and “Border mipmaps” import setting is on.
Billboard Asset
Mesh Components