Reconstruction.ResetReconstruction Method (Matrix4, Matrix4)

Clear the reconstruction volume, and set a world-to-camera transform (camera view pose) and a world-to-volume transform.

The world-volume transform expresses the location and orientation of the world coordinate system origin in volume coordinates and the scaling of the world coordinates to volume indices. In practice, this controls where the reconstruction volume appears in the real world with respect to the world origin position, or with respect to the camera if identity is passed for the initial world-to-camera transform (as the camera and world origins then coincide).

To create your own world-volume transformation first get the current transform by calling GetCurrentWorldToVolumeTransform then either modify the matrix directly or multiply with your own similarity matrix to alter the volume translation or rotation with respect to the world coordinate system. Note that other transforms such as skew are not supported. To reset the volume while keeping the same world-volume transform, first get the current transform by calling GetCurrentWorldToVolumeTransform and pass this Matrix4 as the worldToVolumeTransform parameter when calling this reset function.

Syntax

public void ResetReconstruction (
         Matrix4 initialWorldToCameraTransform,
         Matrix4 worldToVolumeTransform
)

Parameters

• initialWorldToCameraTransform
  Type: Matrix4
  The initial camera pose with respect to the world origin. Pass identity as the default camera pose.
• worldToVolumeTransform
  Type: Matrix4
  A Matrix4 instance, containing the world to volume transform.

This method raises the following exceptions:

Requirements

Namespace: Microsoft.Kinect.Toolkit.Fusion

Assembly: Microsoft.Kinect.Toolkit.Fusion (in microsoft.kinect.toolkit.fusion.dll)

See Also

Reference

Reconstruction Class
Reconstruction Members
Microsoft.Kinect.Toolkit.Fusion Namespace