xrCreateSpatialGraphNodeSpaceMSFT - Create an Space from a spatial graph node.

Valid Usage (Implicit)

• The @@ extension must be enabled prior to calling createSpatialGraphNodeSpaceMSFT

• session must be a valid Session handle
• createInfo must be a pointer to a valid SpatialGraphNodeSpaceCreateInfoMSFT structure
• space must be a pointer to an Space handle

Return Codes

Success

• SUCCESS

Failure

• ERROR_INSTANCE_LOST
• ERROR_OUT_OF_MEMORY
• ERROR_FUNCTION_UNSUPPORTED
• ERROR_VALIDATION_FAILURE
• ERROR_HANDLE_INVALID
• ERROR_SESSION_LOST
• SESSION_LOSS_PENDING
• ERROR_POSE_INVALID

See Also

Session, Space, SpatialGraphNodeSpaceCreateInfoMSFT

A convenience wrapper to make a compatible pair of calls to createSpatialGraphNodeSpaceMSFT and destroySpace

To ensure that destroySpace is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

XrSpatialGraphNodeSpaceCreateInfoMSFT - The information to create space from a spatial graph node.

Valid Usage (Implicit)

• The @@ extension must be enabled prior to using SpatialGraphNodeSpaceCreateInfoMSFT

• type must be TYPE_SPATIAL_GRAPH_NODE_SPACE_CREATE_INFO_MSFT
• next must be NULL or a valid pointer to the next structure in a structure chain
• nodeType must be a valid SpatialGraphNodeTypeMSFT value

See Also

Posef, SpatialGraphNodeTypeMSFT, StructureType, createSpatialGraphNodeSpaceMSFT

XrSpatialGraphNodeTypeMSFT - The type of spatial graph node.

Description

There are two types of spatial graph nodes: static and dynamic.

Static spatial nodes track the pose of a fixed location in the world relative to reference spaces. The tracking of static nodes may slowly adjust the pose over time for better accuracy but the pose is relatively stable in the short term, such as between rendering frames. For example, a QR code tracking library can use a static node to represent the location of the tracked QR code. Static spatial nodes are represented by SPATIAL_GRAPH_NODE_TYPE_STATIC_MSFT.

Dynamic spatial nodes track the pose of a physical object that moves continuously relative to reference spaces. The pose of dynamic spatial nodes can be very different within the duration of a rendering frame. It is important for the application to use the correct timestamp to query the space location using locateSpace. For example, a color camera mounted in front of a HMD is also tracked by the HMD so a web camera library can use a dynamic node to represent the camera location. Dynamic spatial nodes are represented by SPATIAL_GRAPH_NODE_TYPE_DYNAMIC_MSFT.

See Also

SpatialGraphNodeSpaceCreateInfoMSFT