Export (0) Print
Expand All

INuiSensor::NuiTransformSmooth Method

Kinect for Windows 1.5, 1.6, 1.7, 1.8

Filters skeleton positions to reduce jitter between frames.

public:
HRESULT NuiTransformSmooth(
         NUI_SKELETON_FRAME *pSkeletonFrame,
         const NUI_TRANSFORM_SMOOTH_PARAMETERS *pSmoothingParams
)

Parameters

pSkeletonFrame
Type: NUI_SKELETON_FRAME
[in] On entry, points to a NUI_SKELETON_FRAME that contains the skeleton data to be smoothed. On exit, the skeleton data in the structure has been replaced by smoothed data. If NuiTransformSmooth does not return S_OK, the data is unchanged.
pSmoothingParams
Type: NUI_TRANSFORM_SMOOTH_PARAMETERS
[in] The parameters for the smoothing function. See the NUI_TRANSFORM_SMOOTH_PARAMETERS structure for a description of the parameters.

Return Value

Type: HRESULT
Returns S_OK if successful; otherwise, returns one of the failure codes in the following table.
ErrorDescription
E_OUTOFMEMORYThe allocation failed.
E_POINTERThe value of the pSkeletonFrame parameter is NULL.

The filter used is based on the Holt double-exponential smoothing method used for statistical analysis of economic data, which provides smoothing with less latency than other smoothing filter algorithms. A single call of this function updates all currently tracked skeletons.

Header: Declared in NuiSensor.h; however, include NuiApi.h in your project.

Community Additions

ADD
Show:
© 2014 Microsoft