Struct XRCameraFrame

Parameters of the Unity Camera that may be necessary/useful to the provider.

Namespace: UnityEngine.XR.ARSubsystems

Syntax

public struct XRCameraFrame : IEquatable<XRCameraFrame>

Properties

averageBrightness

The estimated brightness of the scene.

Declaration

public float averageBrightness { get; }

Property Value

Type	Description
Single	The estimated brightness of the scene.

averageColorTemperature

The estimated color temperature of the scene.

Declaration

public float averageColorTemperature { get; }

Property Value

Type	Description
Single	The estimated color temperature of the scene.

averageIntensityInLumens

The estimated intensity, in lumens, of the scene.

Declaration

public float averageIntensityInLumens { get; }

Property Value

Type	Description
Single	The estimated intensity, in lumens, of the scene.

colorCorrection

The estimated color correction value of the scene.

Declaration

public Color colorCorrection { get; }

Property Value

Type	Description
Color	The estimated color correction value of the scene.

displayMatrix

The 4x4 display matrix for the camera frame.

Declaration

public Matrix4x4 displayMatrix { get; }

Property Value

Type	Description
Matrix4x4	The 4x4 display matrix for the camera frame.

exposureDuration

The camera exposure duration, in seconds with sub-millisecond precision, of the scene.

Declaration

public double exposureDuration { get; }

Property Value

Type	Description
Double	The camera exposure duration, in seconds with sub-millisecond precision, of the scene.

exposureOffset

The camera exposure offset of the scene for lighting scaling

Declaration

public float exposureOffset { get; }

Property Value

Type	Description
Single	The camera exposure offset of the scene for lighting scaling

hasAverageBrightness

Whether the frame has an average brightness.

Declaration

public bool hasAverageBrightness { get; }

Property Value

Type	Description
Boolean	Whether the frame has an average brightness.

hasAverageColorTemperature

Whether the frame has an average color temperature.

Declaration

public bool hasAverageColorTemperature { get; }

Property Value

Type	Description
Boolean	Whether the frame has an average color temperature.

hasAverageIntensityInLumens

Whether the frame has an average intensity in lumens.

Declaration

public bool hasAverageIntensityInLumens { get; }

Property Value

Type	Description
Boolean	Whether the frame has an average intensity in lumens.

hasColorCorrection

Whether the frame has a color correction value.

Declaration

public bool hasColorCorrection { get; }

Property Value

Type	Description
Boolean	Whether the frame has a color correction value.

hasDisplayMatrix

Whether the frame has a display matrix.

Declaration

public bool hasDisplayMatrix { get; }

Property Value

Type	Description
Boolean	Whether the frame has a display matrix.

hasExposureDuration

Whether the frame has an exposure duration in seconds with sub-millisecond precision.

Declaration

public bool hasExposureDuration { get; }

Property Value

Type	Description
Boolean	Whether the frame has an exposure duration in seconds with sub-millisecond precision.

hasExposureOffset

Whether the frame has an exposure offset for scaling lighting.

Declaration

public bool hasExposureOffset { get; }

Property Value

Type	Description
Boolean	Whether the frame has an exposure offset for scaling lighting.

hasProjectionMatrix

Whether the frame has a projection matrix.

Declaration

public bool hasProjectionMatrix { get; }

Property Value

Type	Description
Boolean	Whether the frame has a projection matrix.

hasTimestamp

Whether the frame has a timestamp.

Declaration

public bool hasTimestamp { get; }

Property Value

Type	Description
Boolean	Whether the frame has a timestamp.

nativePtr

A native pointer associated with this frame. The data pointed to by this pointer is specific to provider implementation.

Declaration

public IntPtr nativePtr { get; }

Property Value

Type	Description
IntPtr	The native pointer associated with this frame.

projectionMatrix

The 4x4 projection matrix for the camera frame.

Declaration

public Matrix4x4 projectionMatrix { get; }

Property Value

Type	Description
Matrix4x4	The 4x4 projection matrix for the camera frame.

properties

The set of all flags indicating which properties are included in the frame.

Declaration

public XRCameraFrameProperties properties { get; }

Property Value

Type	Description
XRCameraFrameProperties	The set of all flags indicating which properties are included in the frame.

timestampNs

The timestamp, in nanoseconds, associated with this frame.

Declaration

public long timestampNs { get; }

Property Value

Type	Description
Int64	The timestamp, in nanoseconds, associated with this frame.

trackingState

The TrackingState associated with the camera.

Declaration

public TrackingState trackingState { get; }

Property Value

Type	Description
TrackingState	The tracking state associated with the camera.

Methods

Equals(Object)

Compares for equality.

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
Object	obj	An object to compare against.

Returns

Type	Description
Boolean	true if obj is an XRCameraFrame and Equals(XRCameraFrame) is also true. Otherwise, false.

Overrides

ValueType.Equals(Object)

Equals(XRCameraFrame)

Compares for equality.

Declaration

public bool Equals(XRCameraFrame other)

Parameters

Type	Name	Description
XRCameraFrame	other	The other XRCameraFrame to compare against.

Returns

Type	Description
Boolean	true if the XRCameraFrame represents the same object.

GetHashCode()

Generates a hash code suitable for use in HashSet and Dictionary.

Declaration

public override int GetHashCode()

Returns

Type	Description
Int32	A hash of the XRCameraFrame.

Overrides

ValueType.GetHashCode()

ToString()

Declaration

public override string ToString()

Returns

Type	Description
String

Overrides

ValueType.ToString()

TryGetAverageBrightness(out Single)

Provides brightness for the whole image as an average of all pixels' brightness.

Declaration

public bool TryGetAverageBrightness(out float averageBrightness)

Parameters

Type	Name	Description
Single	averageBrightness	An estimated average brightness for the environment.

Returns

Type	Description
Boolean	true if average brightness was provided. Otherwise, false.

TryGetAverageColorTemperature(out Single)

Provides color temperature for the whole image as an average of all pixels' color temperature.

Declaration

public bool TryGetAverageColorTemperature(out float averageColorTemperature)

Parameters

Type	Name	Description
Single	averageColorTemperature	An estimated color temperature.

Returns

Type	Description
Boolean	true if average color temperature was provided. Otherwise, false.

TryGetAverageIntensityInLumens(out Single)

Provides intensity, in lumens, for the environment.

Declaration

public bool TryGetAverageIntensityInLumens(out float averageIntensityInLumens)

Parameters

Type	Name	Description
Single	averageIntensityInLumens

Returns

Type	Description
Boolean	true if average intensity was provided. Otherwise, false.

TryGetDisplayMatrix(out Matrix4x4)

Provides display matrix defining how texture is being rendered on the screen.

Declaration

public bool TryGetDisplayMatrix(out Matrix4x4 displayMatrix)

Parameters

Type	Name	Description
Matrix4x4	displayMatrix	The display matrix for rendering.

Returns

Type	Description
Boolean	true if the display matrix was provided. Otherwise, false.

TryGetProjectionMatrix(out Matrix4x4)

Provides projection matrix for the camera frame.

Declaration

public bool TryGetProjectionMatrix(out Matrix4x4 projectionMatrix)

Parameters

Type	Name	Description
Matrix4x4	projectionMatrix	The projection matrix used by the XRCameraSubsystem.

Returns

Type	Description
Boolean	true if the projection matrix was provided. Otherwise, false.

TryGetTimestamp(out Int64)

Provides timestamp of the camera frame.

Declaration

public bool TryGetTimestamp(out long timestampNs)

Parameters

Type	Name	Description
Int64	timestampNs	The timestamp of the camera frame.

Returns

Type	Description
Boolean	true if the timestamp was provided. Otherwise, false.

Operators

Equality(XRCameraFrame, XRCameraFrame)

Compares lhs and rhs for equality using Equals(XRCameraFrame).

Declaration

public static bool operator ==(XRCameraFrame lhs, XRCameraFrame rhs)

Parameters

Type	Name	Description
XRCameraFrame	lhs	The left-hand-side XRCameraFrame of the comparison.
XRCameraFrame	rhs	The right-hand-side XRCameraFrame of the comparison.

Returns

Type	Description
Boolean	true if lhs compares equal to rhs, false otherwise.

Inequality(XRCameraFrame, XRCameraFrame)

Compares lhs and rhs for inequality using Equals(XRCameraFrame).

Declaration

public static bool operator !=(XRCameraFrame lhs, XRCameraFrame rhs)

Parameters

Type	Name	Description
XRCameraFrame	lhs	The left-hand-side XRCameraFrame of the comparison.
XRCameraFrame	rhs	The right-hand-side XRCameraFrame of the comparison.

Returns

Type	Description
Boolean	false if lhs compares equal to rhs, true otherwise.