Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[2.5.0] - 2026-06-15

Added

  • Added hierarchy window warning icon and inspector warnings for camera clear flags or background alpha using underlay or passthrough composition layers.
  • Added Individual, Left and Right Target Eye option to the source texture component. Allowing per-eye or single eye textures for standard Quad, Cylinder, Equirect, and Cube layers.

Fixed

  • Fixed Color Scale and Bias emulation in the Editor and Standalone builds.
  • Fixed composition layer emulation not rendering in Editor Play Mode or Standalone builds.
  • Fixed CompositionLayer to successfully open prefabs from scenes that do not contain any composition layers.
  • Fixed EmulatedLayerData so it no longer logs an error related to a destroyed CompositionLayer when changing scenes from within prefab mode.
  • Fixed InteractableUIMirror so that its fields are correctly serialized, resolving a warning that was previously logged to the console in Unity 6000.6.0a5 or newer.
  • Fixed CameraTargetTextureFactory so that it no longer logs an error related to releasing render texture that is set as Camera.targetTexture.

Changed

  • Emulation in Play mode and Standalone builds previously depended on the now obsolete com.unity.modules.vr and now depends oncom.unity.modules.xr and falls back to always emulating when the XR module is not present.

[2.4.0] - 2026-03-12

Added

  • Added CompositionLayerManager.TryGetLayerId(CompositionLayer layer, out int layerId) to get a layer's unique id instead of GetInstanceID() or GetEntityID().

Fixed

  • Fixed InteractableUIMirror to support creating or duplicating them during runtime such as with prefabs or asset bundles.
  • Fixed CompositionLayersRuntimeSettings so that the Script property is no longer modifiable from the inspector.
  • Fixed InteractableUIMirror so cameras can be added at runtime without camera layer issues.
  • Fixed ScriptableSingleton warning log when first launching a project with the composition layers package.

Changed

  • Changed InteractactableUIMirror Cameras so they are visible in the inspector
  • Changed how CompositionLayerManager initializes LayerInfo.Id to use its own generated unique ids instead of GetInstanceID() or GetEntityID().

[2.3.0] - 2025-12-15

Added

  • Added Background Type option to the Composition Layer Splash Screen settings to allow using Passthrough as the background.

Fixed

  • Fixed DefaultLayerData so it no longer logs a warning related to the SerializeReferenceAttribute when you install this package for the first time.
  • Fixed internal code so that inspecting a CompositionLayersRuntimeSettings object soon after package import no longer causes a warning to be logged to the console.

[2.2.0] - 2025-10-07

Deprecated

  • Deprecated EmulationLayerUniversalScriptableRendererPass.Execute. This method depends on URP Compatibility Mode, which has been deprecated since Unity 6.0 and is removed in Unity 6.4.

[2.1.1] - 2025-09-30

Added

  • Added Right-eye configuration support to the Stereo Projection Layer.

Fixed

  • Fixed CompositionLayer's LayerType property to not ask the user twice to add an extension when set to anything other than [Empty] if the user chooses No.
  • Fixed NullReferenceException when adding a Source Textures component to an empty GameObject.
  • Fixed shader warnings.
  • Fixed a build warning by updating SceneEmulatedProjectionRig to no longer implement IPreprocessBuildWithReport.

[2.1.0] - 2025-06-25

Added

  • Added Game view and Standalone color scale bias emulation for Default Scene Layer for the Built-in Render Pipeline and Universal Render Pipeline.
  • Added Project Validation rules for Composition Layer Transparency.

Fixed

  • Fixed CompositionLayerManager so that it correctly sets layers to be visible when they are enabled after previously being disabled.

[2.0.0] - 2024-12-10

Fixed

  • Fixed Composition Layers not hiding or showing correctly when using Scene Visibility in the hierarchy.
  • Fixed an issue where non-cubemap textures could be assigned to the Cube Projection Layer.

Changed

  • Moved ProjectionEyeRigUtil to the Unity.XR.CompositionLayers.Layers.Editor namespace.
  • Moved CompositionSplash to the Unity.XR.CompositionLayers namespace.

[1.0.0] - 2024-10-09

Added

  • Added Default Layer Support allows for the creation of a default layer and rearragment of the default layer order.
  • Added Composition Layer Sample Scene to demonstrate the use of Composition Layers in a scene.
  • Added Composition Layer Android Sample Surface Scene to demonstrate the use of Andriods External Surface in a scene.
  • Added supporing HDR Tonemapping extension. It allows to set HDR parameters for each layer.
  • Added supporting MirrorViewRenderer. It provides to draw mirror view rendering with layers on XR.
  • Added supporting automatically renderer feature settings on URP and HDRP.

Fixed

  • Fixed Interactable UI Scalings are now consistent between editor and build.
  • Fixed Projection Eye Rig Emulation for URP and Unity6.

Changed

  • Removed EmulationLayerUniversalScriptableRendererFeature.(Manual configuration is no longer required.)

[0.6.0] - 2024-06-26

Added

  • Added a projection validation to check if EmulationLayerUniversalScriptableRendererFeature is added to the current pipeline for URP. Click "Fix" button will automatically add the emulation render feature to enable URP Editor emulation.
  • Added composition layer splash screen support. See Composition Layer Splash Screen section in documentation for details.

Changed

  • Emulation In Playmode or Standalone now is only available when no XR provider is active or no headset is connected for visual approximation and preview purposes.

Fixed

  • Fixed error spamming issue when creating a UI canvas and drag it into a quad layer.

[0.5.0] - 2024-02-25

This is the first experimental release of Unity Package XR CompositionLayers <com.unity.xr.compositionlayers>.