Class ARCameraBackground

Add this component to a Camera to copy the color camera's texture onto the background.

If you are using the Universal Render Pipeline (version 7.0.0 or later), you must also add the ARBackgroundRendererFeature to the list of render features for the scriptable renderer.

Inheritance
object
Object
Component
Behaviour
MonoBehaviour
ARCameraBackground
Inherited Members
MonoBehaviour.IsInvoking()
MonoBehaviour.CancelInvoke()
MonoBehaviour.StopCoroutine(Coroutine)
MonoBehaviour.StopAllCoroutines()
MonoBehaviour.useGUILayout
MonoBehaviour.runInEditMode
Behaviour.enabled
Behaviour.isActiveAndEnabled
Component.GetComponent<T>()
Component.TryGetComponent<T>(out T)
Component.GetComponentInChildren<T>()
Component.GetComponentsInChildren<T>()
Component.GetComponentInParent<T>()
Component.GetComponentsInParent<T>()
Component.GetComponents<T>()
Component.transform
Component.gameObject
Component.tag
Object.GetInstanceID()
Object.GetHashCode()
Object.Instantiate(Object, Vector3, Quaternion)
Object.Instantiate(Object, Vector3, Quaternion, Transform)
Object.Instantiate(Object)
Object.Instantiate(Object, Transform)
Object.Instantiate<T>(T)
Object.Instantiate<T>(T, Vector3, Quaternion)
Object.Instantiate<T>(T, Vector3, Quaternion, Transform)
Object.Instantiate<T>(T, Transform)
Object.Destroy(Object)
Object.DestroyImmediate(Object)
Object.DontDestroyOnLoad(Object)
Object.DestroyObject(Object)
Object.FindObjectsOfType<T>()
Object.FindObjectOfType<T>()
Object.ToString()
Object.name
Object.hideFlags
Namespace: UnityEngine.XR.ARFoundation
Assembly: Unity.XR.ARFoundation.dll
Syntax
[DisallowMultipleComponent]
[RequireComponent(typeof(Camera))]
[RequireComponent(typeof(ARCameraManager))]
public class ARCameraBackground : MonoBehaviour
Remarks

For information about how to set up the Universal Rendering Pipeline, refer to Universal Rendering Pipeline.

Related information: Camera components

Fields

OnCameraRenderingModeChanged

A delegate for capturing when the currentRenderingMode has changed. Use to change make any changes to the parameters of the ARCameraBackground (IE. changing custom materials out) before configuring the command buffer for background rendering.

Declaration
public static Action<XRCameraBackgroundRenderingMode> OnCameraRenderingModeChanged
Field Value
Type Description
Action<XRCameraBackgroundRenderingMode>

Properties

backgroundRenderingEnabled

Whether background rendering is enabled.

Declaration
public bool backgroundRenderingEnabled { get; }
Property Value
Type Description
bool

true if background rendering is enabled and if at least one camera frame has been received. Otherwise, false.

camera

The camera to which the projection matrix is set on each frame event.

Declaration
protected Camera camera { get; }
Property Value
Type Description
Camera

The camera to which the projection matrix is set on each frame event.

cameraManager

The camera manager from which frame information is pulled.

Declaration
protected ARCameraManager cameraManager { get; }
Property Value
Type Description
ARCameraManager

The camera manager from which frame information is pulled.

currentRenderingMode

The current XRCameraBackgroundRenderingMode. Determines which render order to use.

Declaration
public XRCameraBackgroundRenderingMode currentRenderingMode { get; }
Property Value
Type Description
XRCameraBackgroundRenderingMode

customMaterial

A custom material for rendering the background.

Declaration
public Material customMaterial { get; set; }
Property Value
Type Description
Material

A custom material for rendering the background.

legacyCameraEvents

The list of CameraEvents to add to the CommandBuffer. By default, it will select either s_DefaultBeforeOpaqueCameraEvents or s_DefaultAfterOpaqueCameraEvents depending on the value of currentRenderingMode.

In the case where Before Opaques rendering has been selected it will return:

BeforeForwardOpaque and BeforeGBuffer}.

In the case where After Opaques rendering has been selected it will return:

AfterForwardOpaque and AfterGBuffer}.

Override to use different camera events.

Declaration
protected virtual IEnumerable<CameraEvent> legacyCameraEvents { get; }
Property Value
Type Description
IEnumerable<CameraEvent>

material

The current Material used for background rendering.

Declaration
public Material material { get; }
Property Value
Type Description
Material

occlusionManager

The occlusion manager, which might not exist, from which occlusion information is pulled.

Declaration
protected AROcclusionManager occlusionManager { get; }
Property Value
Type Description
AROcclusionManager

shouldInvertCulling

Whether culling should be inverted. Used during command buffer configuration, see CommandBuffer.SetInvertCulling.

Declaration
protected bool shouldInvertCulling { get; }
Property Value
Type Description
bool
See Also

useCustomMaterial

Whether to use the custom material for rendering the background.

Declaration
public bool useCustomMaterial { get; set; }
Property Value
Type Description
bool

true if the custom material should be used for rendering the camera background. Otherwise, false.

Methods

ConfigureLegacyCommandBuffer(CommandBuffer)

Configures the commandBuffer by first clearing it, then adding necessary render commands.

Declaration
protected virtual void ConfigureLegacyCommandBuffer(CommandBuffer commandBuffer)
Parameters
Type Name Description
CommandBuffer commandBuffer

The command buffer to configure.