C Specification

The xrTriangleMeshBeginVertexBufferUpdateFB function is defined as:

XrResult xrTriangleMeshBeginVertexBufferUpdateFB(
    XrTriangleMeshFB                            mesh,
    uint32_t*                                   outVertexCount);

Parameters

Parameter Descriptions
  • mesh is the XrTriangleMeshFB to update.

  • outVertexCount is the current vertex count. The updated data must have the exact same number of vertices.

Description

Begins an update of the vertex positions of a triangle mesh. Can only be called once the mesh topology has been set using xrTriangleMeshBeginUpdateFB followed by xrTriangleMeshEndUpdateFB. The vertex count is defined by the last invocation to xrTriangleMeshEndUpdateFB. Once the modification is done, call xrTriangleMeshEndVertexBufferUpdateFB to commit the changes. Runtime must return XR_ERROR_VALIDATION_FAILURE if an invalid count is passed. Runtime must return XR_ERROR_VALIDATION_FAILURE if the mesh is immutable.

Valid Usage (Implicit)
Return Codes
On success, this command returns
  • XR_SUCCESS

  • XR_SESSION_LOSS_PENDING

On failure, this command returns
  • XR_ERROR_FUNCTION_UNSUPPORTED

  • XR_ERROR_VALIDATION_FAILURE

  • XR_ERROR_RUNTIME_FAILURE

  • XR_ERROR_HANDLE_INVALID

  • XR_ERROR_INSTANCE_LOST

  • XR_ERROR_SESSION_LOST

  • XR_ERROR_FEATURE_UNSUPPORTED

See Also

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright (c) 2014-2021, The Khronos Group Inc.