Package org.lwjgl.openxr

Class METASpatialEntityMesh

java.lang.Object

org.lwjgl.openxr.METASpatialEntityMesh

public class METASpatialEntityMesh
extends Object

The XR_META_spatial_entity_mesh extension.

This extension expands on the concept of spatial entities to include a way for a spatial entity to represent a triangle mesh that describes 3D geometry of the spatial entity in a scene. Spatial entities are defined in XR_FB_spatial_entity extension using the Entity-Component System. The triangle mesh is a component type that may be associated to a spatial entity.

In order to enable the functionality of this extension, you must pass the name of the extension into CreateInstance via the XrInstanceCreateInfo::enabledExtensionNames parameter as indicated in the extension section.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	XR_META_SPATIAL_ENTITY_MESH_EXTENSION_NAME	The extension name.
static final int	XR_META_spatial_entity_mesh_SPEC_VERSION	The extension specification version.
static final int	XR_SPACE_COMPONENT_TYPE_TRIANGLE_MESH_META	Extends XrSpaceComponentTypeFB.
static final int	XR_TYPE_SPACE_TRIANGLE_MESH_GET_INFO_META	Extends XrStructureType.
static final int	XR_TYPE_SPACE_TRIANGLE_MESH_META	Extends XrStructureType.

Method Summary

Modifier and Type	Method	Description
static int	nxrGetSpaceTriangleMeshMETA(XrSpace space, long getInfo, long triangleMeshOutput)	Unsafe version of: GetSpaceTriangleMeshMETA
static int	xrGetSpaceTriangleMeshMETA(XrSpace space, XrSpaceTriangleMeshGetInfoMETA getInfo, XrSpaceTriangleMeshMETA triangleMeshOutput)	Gets an XrSpaceTriangleMeshMETA that represents a triangle mesh.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

XR_META_spatial_entity_mesh_SPEC_VERSION

public static final int XR_META_spatial_entity_mesh_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

XR_META_SPATIAL_ENTITY_MESH_EXTENSION_NAME

public static final String XR_META_SPATIAL_ENTITY_MESH_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

XR_SPACE_COMPONENT_TYPE_TRIANGLE_MESH_META

public static final int XR_SPACE_COMPONENT_TYPE_TRIANGLE_MESH_META

Extends XrSpaceComponentTypeFB.

See Also:

• Constant Field Values

XR_TYPE_SPACE_TRIANGLE_MESH_GET_INFO_META

public static final int XR_TYPE_SPACE_TRIANGLE_MESH_GET_INFO_META

Extends XrStructureType.

Enum values:

• TYPE_SPACE_TRIANGLE_MESH_GET_INFO_META
• TYPE_SPACE_TRIANGLE_MESH_META

See Also:

• Constant Field Values

XR_TYPE_SPACE_TRIANGLE_MESH_META

public static final int XR_TYPE_SPACE_TRIANGLE_MESH_META

Extends XrStructureType.

Enum values:

• TYPE_SPACE_TRIANGLE_MESH_GET_INFO_META
• TYPE_SPACE_TRIANGLE_MESH_META

See Also:

• Constant Field Values

Method Details

nxrGetSpaceTriangleMeshMETA

public static int nxrGetSpaceTriangleMeshMETA(XrSpace space,
 long getInfo,
 long triangleMeshOutput)

Unsafe version of: GetSpaceTriangleMeshMETA

xrGetSpaceTriangleMeshMETA

public static int xrGetSpaceTriangleMeshMETA(XrSpace space,
 XrSpaceTriangleMeshGetInfoMETA getInfo,
 XrSpaceTriangleMeshMETA triangleMeshOutput)

Gets an XrSpaceTriangleMeshMETA that represents a triangle mesh.

C Specification

The GetSpaceTriangleMeshMETA function is defined as:

 XrResult xrGetSpaceTriangleMeshMETA(
     XrSpace                                     space,
     const XrSpaceTriangleMeshGetInfoMETA*       getInfo,
     XrSpaceTriangleMeshMETA*                    triangleMeshOutput);

Description

The GetSpaceTriangleMeshMETA function is used by the application to perform the two calls required to obtain a triangle mesh associated to a spatial entity specified by space.

The spatial entity space must have the SPACE_COMPONENT_TYPE_TRIANGLE_MESH_META component type enabled, otherwise this function will return ERROR_SPACE_COMPONENT_NOT_ENABLED_FB.

Valid Usage (Implicit)

• The XR_META_spatial_entity_mesh extension must be enabled prior to calling GetSpaceTriangleMeshMETA
• space must be a valid XrSpace handle
• getInfo must be a pointer to a valid XrSpaceTriangleMeshGetInfoMETA structure
• triangleMeshOutput must be a pointer to an XrSpaceTriangleMeshMETA structure

Return Codes

On success, this command returns

• SUCCESS
• SESSION_LOSS_PENDING

On failure, this command returns

• ERROR_FUNCTION_UNSUPPORTED
• ERROR_VALIDATION_FAILURE
• ERROR_RUNTIME_FAILURE
• ERROR_HANDLE_INVALID
• ERROR_INSTANCE_LOST
• ERROR_SESSION_LOST
• ERROR_SIZE_INSUFFICIENT
• ERROR_SPACE_COMPONENT_NOT_ENABLED_FB
• ERROR_FEATURE_UNSUPPORTED

See Also

XrSpaceTriangleMeshGetInfoMETA, XrSpaceTriangleMeshMETA

Parameters:

space - a handle to an XrSpace.

getInfo - exists for extensibility purposes. It is NULL or a pointer to a valid XrSpaceTriangleMeshGetInfoMETA.

triangleMeshOutput - the output parameter that points to an XrSpaceTriangleMeshMETA.