Returns a handle for an new spatial anchor at pPose. On success, pHandle will contain a handle valid for this session. Caller can wait for an event or occasionally poll GetSpatialAnchorDescriptor() to find the permanent descriptor for this pose. The result of GetSpatialAnchorPose() may evolve from this initial position if the driver chooses to update it. The anchor will be associated with the driver that provides unDeviceIndex, and the driver may use that specific device as a hint for how to best create the anchor. The eOrigin must match whatever tracking origin you are working in (seated/standing/raw). This should be called when the user is close to (and ideally looking at/interacting with) the target physical location. At that moment, the driver will have the most information about how to recover that physical point in the future, and the quality of the anchor (when the descriptor is re-used) will be highest. The caller may decide to apply offsets from this initial pose, but is advised to stay relatively close to the original pose location for highest fidelity.
Get the descriptor for a given handle. This will be empty for handles where the driver has not yet built a descriptor. It will be the application-supplied descriptor for previously saved anchors that the application is requesting poses for. If the driver has called UpdateSpatialAnchorDescriptor() already in this session, it will be the descriptor provided by the driver. Returns true if the descriptor fits into the buffer, else false. Buffer size should be at least k_unMaxSpatialAnchorDescriptorSize.
Page generated by adrdox