Projector

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

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

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.