INuiFusionReconstruction::SmoothDepthFloatFrame Method

Spatially smoothes a depth float image frame using edge-preserving filtering.

Syntax

public:
HRESULT SmoothDepthFloatFrame(
         const NUI_FUSION_IMAGE_FRAME *pDepthFloatFrame,
         const NUI_FUSION_IMAGE_FRAME *pSmoothDepthFloatFrame,
         UINT kernelWidth,
         FLOAT distanceThreshold
)

Parameters

  • pDepthFloatFrame
    Type: NUI_FUSION_IMAGE_FRAME
    A source depth float frame.
  • pSmoothDepthFloatFrame
    Type: NUI_FUSION_IMAGE_FRAME
    A depth float frame that receives the smoothed depth frame.
  • kernelWidth
    Type: UINT
    The smoothing kernel width. The valid values are listed in the following table.
    kernelWidth value Smoothing kernel block size
    1 3×3
    2 5×5
    3 7×7
  • distanceThreshold
    Type: FLOAT
    The distance difference range that smoothing occurs in. Pixels with neighboring pixels outside this distance range will not be smoothed (larger values indicate discontinuity/edge). This value must be greater than zero.

Return value

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

Requirements

Header: nuikinectfusionvolume.h

Library: TBD