transform

fun transform(cameraPose: Transform): Transform

Calculates the world-space transform of this LigTag device.

This method combines the camera's pose in world space with this LigTag's pose relative to the camera to produce the final world-space transform of the LigTag device. This is essential for AR applications that need to place virtual objects at the LigTag's real-world location.

Coordinate Systems:

  • Input: Camera pose in world coordinates (typically from ARCore/ARKit)

  • Device pose: Relative to camera coordinates (from SDK detection)

  • Output: LigTag pose in world coordinates

Requirements:

  • validPose must be true for accurate results

  • Camera pose should be from the same frame as this detection

Return

A new Transform representing this LigTag's position and rotation in world space

Usage Example

// In ARCore session
val cameraTransform = Transform(camera.pose)
val worldTransform = ligTag.transform(cameraTransform)

// Place AR object at LigTag location
val anchor = session.createAnchor(worldTransform.toPose())

Parameters

cameraPose

The camera's transform in world space coordinates, typically obtained from ARCore's camera pose or similar AR framework