Version: 2021.3
LanguageEnglish
  • C#

XRMeshSubsystem.GetUpdatedMeshTransforms

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public NativeArray<MeshTransform> GetUpdatedMeshTransforms(Unity.Collections.Allocator allocator);

Parameters

allocator The allocator to use for the returned NativeArray.

Returns

NativeArray<MeshTransform> A new NativeArray of MeshTransforms.

Description

Gets the updated mesh transforms.

Use this to get updated transforms for each mesh tracked by the subsystem. The number of transforms returned may be less than the total number of tracked meshes. The results may be affected by previous calls to this method. That is, only transforms that have changed since the last call to this method may be returned.

Typically, you should call this at regular intervals, for example, once per frame, in order to update the transform of each mesh. When a mesh is generated using XRMeshSubsystem.GenerateMeshAsync, the MeshGenerationResult also contains a transform and timestamp. Because generation is asynchronous, you can compare timestamps to ensure you are using the most recent transform. Larger values indicate newer transforms.

This method always returns a new NativeArray, even when there are no updated transforms. The caller is responsible for disposing the returned NativeArray.

Additional resources: MeshTransform, XRMeshSubsystem.GenerateMeshAsync, MeshGenerationResult