This page describes the frame of references and coordinate systems (CS) used by Vuforia Engine. Use this information to orient your targets and content with respect to your device and the world coordinate system as the starting origin.
Note: In Unity, all coordinates are automatically transformed into Unity's coordinate system, and the poses are automatically applied to the scene objects.
There are three major frames of reference defined in the Vuforia Engine:
- World: defined as the start position of the device. This is your reference origin for the AR interaction. Its CS is right-handed, Y-Up, and gravity aligned.
- Camera/Device: origin on the physical device (or more precisely the camera position on the device). Camera/Device pose are reported in the World CS. Its CS is right-handed and Y-up.
- Target: used for tracking physical objects or environment locations. Target poses are reported in the World CS. Their CS is right-handed, but the Up convention varies on the type of target (Anchor Y-up, ImageTarget Z-up, ModelTarget varies depending on original model, etc.).
Frames of Reference: World, Camera and Targets.
The CS used (world, camera, targets) and the right-handed, Y-up convention, follows the conventional “GL” frame of reference (right-handed, Y-Up), which is familiar to that 3D and graphics developers apply.
The transformation between CS and device poses are available from
vuObservationGetPoseInfo. In addition to the device pose, retrieve the view pose from the State with
vuStateGetRenderState. Call this after starting the engine and camera and make sure to set
vuRenderControllerSetRenderViewConfig() to determine the view port size. On some platforms, Vuforia Engine might fail to auto-detect the view port and consequently the video rendering data would return 0 if it not set.
For actions to inverse device pose and transposing it, the math utilities have functions for matrix manipulation and vector calculations.
modelMatrix = poseInfo.pose; // We transpose here because Matrix44FInverse returns a transposed matrix devicePoseMatrix = SampleMath.vuMatrix44FTranspose(SampleMath.vuMatrix44FInverse(modelMatrix));
The relation between the poses delivered by Vuforia and the transformation you will use in your rendering engine can be interpreted as:
|Device Pose||Inversing pose for View Matrix|