Share via

CameraPoseFinder.FindCameraPose Method

  • Article

Kinect for Windows 1.8

Retrieves the poses in the camera pose finder database that are most similar to the current camera input.

Syntax

public MatchCandidates FindCameraPose (
         FusionFloatImageFrame depthFloatFrame,
         FusionColorImageFrame colorFrame
)

Parameters

  • depthFloatFrame
    Type: FusionFloatImageFrame
    The depth float frame to be processed. This frame must have valid camera parameters. Also, this frame must be the same size and have been captured at the same time as the colorFrame parameter.
  • colorFrame
    Type: FusionColorImageFrame
    The color frame to be processed. This frame must have valid camera parameters. Also, this frame must be the same size and have been captured at the same time as the depthFloatFrame parameter.

Return Value

Type: MatchCandidates
Returns a MatchCandidates object that contains a set of matched frames and poses. These poses and similarity measurements are ordered in terms of decreasing similarity.

Exceptions

Exception type Condition
ArgumentException One of the following occurred:
  • The depthFloatFrame or colorFrame parameter is an incorrect image size.
  • The image sizes of the depthFloatFrame and colorFrame parameters do not match.
  • The CameraParameters for the depthFloatFrame or colorFrame parameter is null.
  • The focal length of the depthFloatFrame or colorFrame parameter is an incorrect size.
ArgumentNullException The depthFloatFrame or colorFrame parameter is null.
InvalidOperationException One of the following occurred:
  • The Kinect Runtime could not be accessed.
  • The call failed for an unknown reason.

Requirements

Namespace: Microsoft.Kinect.Toolkit.Fusion

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

See Also

Reference

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