MFCameraExtrinsic_CalibratedTransform structure
[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]
A transform describing the location of a camera relative to other cameras or an established external reference.
Syntax
typedef struct _MFCameraExtrinsic_CalibratedTransform { GUID CalibrationId; MF_FLOAT3 Position; MF_QUATERNION Orientation; } MFCameraExtrinsic_CalibratedTransform, *PMFCameraExtrinsic_CalibratedTransform;
Members
- CalibrationId
-
A reference GUID identifying the calibration process for the data, allowing different consumers to identify calibration data from the same process.
- Position
-
The transform position.
- Orientation
-
The transform rotation.
Remarks
The Position value should be expressed in real-world coordinates in units of meters. The coordinate system of both position and orientation should be right-handed Cartesian as shown in the following diagram.

The position and orientation are expressed as transforms toward the reference frame or origin. For example, a Position value of {-5, 0, 0} means that the origin is 5 meters to the left of the sensor, and therefore the sensor is 5 meters to the right of the origin. A sensor that is positioned 2 meters above the origin should specify a Position of {0, -2, 0} because that is the translation from the sensor to the origin.
If the sensor is aligned with the origin, the rotation is the identity quaternion and the forward vector is along the -Z axis {0, 0, -1}. If the sensor is rotated +30 degrees around the Y axis from the origin, then the Orientation value should be a rotation of -30 degrees around the Y axis, because it represents the rotation from the sensor to the origin.
Requirements
|
Minimum supported client |
Windows 10 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2016 [desktop apps only] |
|
Header |
|
See also