Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Pixel Perfect Camera component reference for URP

Explore the different properties available to customize the appearance of your 2D pixel art with the Pixel Perfect Camera.
Read time 3 minutesLast updated 20 days ago
Explore the properties you can use to automatically adjust the camera to scale and rotate pixel art precisely in the Universal Render Pipeline (URP).
Important
The pixel perfect camera is included by default when you set up a project for 2D games with the Universal 2D template. Don't install the separate 2D Pixel Perfect package, which works only with the Built-In Render Pipeline.
For more information, refer to Add a pixel perfect camera and Configure a pixel perfect camera.

Property

Description

Asset Pixels Per UnitSets how many pixels of width and height in the sprite image correspond to one unit in world space. Set this value to match the Pixels Per Unit values of all the sprites in the scene.
Reference ResolutionSets the screen resolution your sprites are designed for. For example, if you set X to 320 and Y to 180, Unity sets the camera view to 320 sprite pixels in width and 180 sprite pixels in height.
Crop FrameCrops the viewport with black bars to hide the areas beyond the aspect ratio of the Reference Resolution. The options are:
  • None: Doesn't crop.
  • Pillarbox: Crops the viewport vertically, using black bars on the left and right to match the width of the Reference Resolution.
  • Letterbox: Crops the viewport horizontally, using black bars at the top and bottom to match the height of the Reference Resolution.
  • Windowbox: Crops the viewport both vertically and horizontally, using black bars on all sides to match the Reference Resolution.
  • Stretch Fill: Stretches the camera view to fill the viewport.
For more information, refer to Configure a pixel perfect camera.
Grid SnappingSets how Unity snaps and scales sprites. The options are:
  • None: Doesn't align or upscale.
  • Pixel Snapping: Renders sprites so they align to the pixel grid, which prevents sprites moving between pixels. The Transform position of sprites isn't affected.
  • Upscale Render Texture: Renders the scene to a temporary texture with a resolution that matches Reference Resolution, or larger if the viewport has a wider or taller aspect ratio. Unity then upscales the temporary texture to the viewport size. This approach results in unaliased and unrotated pixels. For more information, refer to Configure a pixel perfect camera.
Filter ModeSets how Unity stretches the camera view when you set Crop Frame to Stretch Fill. The options are:
  • Point: Stretches the camera view using point filtering, which keeps pixels sharp but can result in shimmering.
  • Retro AA: Stretches the camera view using bilinear filtering, which can make the edges of pixels blurrier but reduces shimmer.
For more information, refer to Configure a pixel perfect camera.
Current Pixel RatioThe ratio of the sprites in the Game view to their original size. For example, 2:1 means the sprites are twice their original size.

Additional resources