docs.unity3d.com
    Show / Hide Table of Contents

    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 readonly float averageBrightness { get; }
    Property Value
    Type Description
    Single

    The estimated brightness of the scene.

    averageColorTemperature

    The estimated color temperature of the scene.

    Declaration
    public readonly float averageColorTemperature { get; }
    Property Value
    Type Description
    Single

    The estimated color temperature of the scene.

    colorCorrection

    The estimated color correction value of the scene.

    Declaration
    public readonly 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 readonly Matrix4x4 displayMatrix { get; }
    Property Value
    Type Description
    Matrix4x4

    The 4x4 display matrix for the camera frame.

    hasAverageBrightness

    Whether the frame has an average brightness.

    Declaration
    public readonly 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 readonly bool hasAverageColorTemperature { get; }
    Property Value
    Type Description
    Boolean

    Whether the frame has an average color temperature.

    hasColorCorrection

    Whether the frame has a color correction value.

    Declaration
    public readonly 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 readonly bool hasDisplayMatrix { get; }
    Property Value
    Type Description
    Boolean

    Whether the frame has a display matrix.

    hasProjectionMatrix

    Whether the frame has a projection matrix.

    Declaration
    public readonly bool hasProjectionMatrix { get; }
    Property Value
    Type Description
    Boolean

    Whether the frame has a projection matrix.

    hasTimestamp

    Whether the frame has a timestamp.

    Declaration
    public readonly 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 readonly 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 readonly 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 readonly 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 readonly 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 readonly TrackingState trackingState { get; }
    Property Value
    Type Description
    TrackingState

    The tracking state associated with the camera.

    Methods

    Equals(System.Object)

    Declaration
    public override bool Equals(System.Object obj)
    Parameters
    Type Name Description
    System.Object obj
    Returns
    Type Description
    Boolean

    Equals(XRCameraFrame)

    Declaration
    public bool Equals(XRCameraFrame other)
    Parameters
    Type Name Description
    XRCameraFrame other
    Returns
    Type Description
    Boolean

    GetHashCode()

    Declaration
    public override int GetHashCode()
    Returns
    Type Description
    Int32

    ToString()

    Declaration
    public override string ToString()
    Returns
    Type Description
    String

    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.

    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)

    Declaration
    public static bool operator ==(XRCameraFrame lhs, XRCameraFrame rhs)
    Parameters
    Type Name Description
    XRCameraFrame lhs
    XRCameraFrame rhs
    Returns
    Type Description
    Boolean

    Inequality(XRCameraFrame, XRCameraFrame)

    Declaration
    public static bool operator !=(XRCameraFrame lhs, XRCameraFrame rhs)
    Parameters
    Type Name Description
    XRCameraFrame lhs
    XRCameraFrame rhs
    Returns
    Type Description
    Boolean
    Back to top Copyright © 2022 Unity Technologies
    Generated by DocFX
    on Friday, January 7, 2022
    Terms of use