URP calculates the frame-to-frame screen-space movement of surface fragments using a motion vector render pass. URP stores the movement data in a full-screen texture and the stored per-pixel values are called motion vectors.
Unity runs the motion vector render pass only when there are active features in the frame with render passes that request it. For example, the following URP features request the motion vector pass: temporal anti-aliasing and motion blur. For information on how to request the motion vector pass in a custom passes, refer to section Using the motion vector texture in your passes.
Incorrect or missing motion vectors can result in visual artifacts in effects that rely on them. Follow the instructions on this page to ensure that your object renderers, Materials, and shadersA program that runs on the GPU. More info
See in Glossary are set up correctly to support motion vectors.
URP supports motion vectors only for opaque materials, including alpha-clipped materials. URP does not support motion vectors for transparent materials.
This section describes how URP implements motion vectors.
A motion vector is a 2D vector representing a surface fragment’s motion relative to the 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 since the last frame, projected onto the camera’s near clipping planeA plane that limits how far or close a camera can see from its current position. A camera’s viewable range is between the far and near clipping planes. See far clipping plane and near clipping plane. More info
See in Glossary. The motion vector texture uses 2 channels (R and G). Each texel stores the UV offset of each visible surface fragment. If you subtract the motion vector for a given texel from its current UV coordinate, you will get the UV coordinate of where this texel would have been on the screen last frame. The computed last frame UV coordinate can be outside the screen bounds.
There are two categories of motion vectors:
Camera motion vectors: motion vectors caused only by the camera’s own motion.
Object motion vectors: motion vectors caused by a combination of the camera’s motion and the world-space motion of the object the fragment belongs to.
Given only the motion vector texture it’s impossible to infer whether a fragment’s motion on screen is due to only camera motion, object motion or a combination of both.
A single full-screen pass is enough to calculate camera motion vectors. Such pass has a fixed per-frame computation load independent of sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary complexity. It’s only necessary to know the current 3D positions of all pixelsThe 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 on screen and how the camera moved, which can be inferred from the depth bufferA memory store that holds the z-value depth of each pixel in an image, where the z-value is the depth for each rendered pixel from the projection plane. More info
See in Glossary and the camera matrices for the current and the previous frames.
Object motion vectors have computation load which depends on the number and complexity of the moving objects in the scene because a draw per-object is required to account for each object’s motion. Each draw needs to apply the camera’s motion contribution too.
Unity renders object motion vectors for a meshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary in a frame when the following three conditions are met:
The shader associated with the mesh has a MotionVectors pass in an active SubShader block.
The mesh is being rendered through any of the following renderers:
SkinnedMeshRenderer.
MeshRenderer, when its Motion Vectors property is not set to Camera Motion Only.
Using the following APIs: Graphics.RenderMesh, Graphics.RenderMeshInstanced or Graphics.RenderMeshIndirect, with the MotionVectorMode member of the RenderParams struct not set to Camera.
If any of the following conditions is true:
The MotionVectorGenerationMode property is set to ForceNoMotion on the MeshRenderer or the RenderParams.MotionVectorMode struct member of the Grphics.Render... APIs.
Note: The ForceNoMotion option requires a per-object motion vector pass to be rendered every frame so that the camera motion vectors for such objects can be overwritten with zeros.
The MotionVectors pass is enabled on the material (for example, when a material has a vertex animation in Shader Graph or alembic animation).
The MotionVectors pass is disabled on the material but the model matrices for the previous and the current frame don’t match, or if the object has skeletal animation. Stationary renderers without skeletal animation are not rendered with an object motion vector pass if their shader has a MotionVectors pass but it’s disabled on their material.
When the MotionVectors pass is enabled for the pre-built shaders, Unity renders object motion vectors for mesh renderersA mesh component that takes the geometry from the Mesh Filter and renders it at the position defined by the object’s Transform component. More info
See in Glossary even if they don’t move.
Unity enables the MotionVectors pass in the pre-built URP shaders when the following conditions are true:
URP ShaderLabUnity’s language for defining the structure of Shader objects. More info
See in Glossary shaders: on a Material, the Alembic Motion Vectors property is enabled in the Advanced Options section.
URP Lit and Unlit Shader Graph shaders: in the Graph InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary, any of the following properties is set: