Share via

INuiFusionReconstruction::DepthToDepthFloatFrame Method

  • Article

Converts the specified array of Kinect depth pixels to a NUI_FUSION_IMAGE_FRAME object representing a depth float frame.

Syntax

public:
HRESULT DepthToDepthFloatFrame(
         const UINT16 *pDepthImageData,
         UINT countDepthImageDataBytes,
         const NUI_FUSION_IMAGE_FRAME *pDepthFloatFrame,
         FLOAT minDepthClip,
         FLOAT maxDepthClip,
         BOOL mirrorDepth
)

Parameters

  • pDepthImageData
    Type: UINT16
    The array of Kinect depth pixels in unsigned short format to convert. This data must have the same pixel resolution as the depthFloatFrame parameter.
  • countDepthImageDataBytes
    Type: UINT
    The size of the depth image, in bytes.
  • pDepthFloatFrame
    Type: NUI_FUSION_IMAGE_FRAME
    A floating-point depth float frame that receives the converted depth data. This data must have the same pixel resolution as the depthImageData parameter.
  • minDepthClip
    Type: FLOAT
    The minimum depth threshold, meters. Values below this threshold will be set to zero.
  • maxDepthClip
    Type: FLOAT
    The maximum depth threshold, in meters. Values above this threshold will be set to 1,000.
  • mirrorDepth
    Type: BOOL
    Specify true to mirror the depth values. Specify false so the image appears correct if viewing the Kinect sensor from behind.

Return value

Type: HRESULT
S_OK if successful; otherwise, returns a failure code.

Requirements

Header: nuikinectfusionvolume.h

Library: TBD