This topic has not yet been rated - Rate this topic

INuiSensor::NuiTransformSmooth Method

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, out] On entry, points to a NUI_SKELETON_FRAME Structure 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, optional] 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.
Did you find this helpful?
(1500 characters remaining)

Community Additions

© 2013 Microsoft. All rights reserved.