Despite its name, this type does not actively recognize anything but merely stores the data, in the form of per-finger FingerFeatureConfigLists, which is needed for a ShapeRecognizerActiveState to perform the calculations needed to determine whether the described hand shape has been recognized or not. In this sense, ShapeRecognizer might be thought of as a definition or descriptor of a hand shape.

Fields

IReadOnlyList< FingerFeatureConfig > ThumbFeatureConfigs[Get]

The list of FingerFeatureConfigs which must be satisfied for the thumb to be acceptable for recognition by this ShapeRecognizer.

For an overview of the role of this list in shape recognition, see the remarks on FingerFeatureConfigList.

IReadOnlyList< FingerFeatureConfig > IndexFeatureConfigs[Get]

The list of FingerFeatureConfigs which must be satisfied for the index finger to be acceptable for recognition by this ShapeRecognizer.

For an overview of the role of this list in shape recognition, see the remarks on FingerFeatureConfigList.

IReadOnlyList< FingerFeatureConfig > MiddleFeatureConfigs[Get]

The list of FingerFeatureConfigs which must be satisfied for the middle finger to be acceptable for recognition by this ShapeRecognizer.

For an overview of the role of this list in shape recognition, see the remarks on FingerFeatureConfigList.

IReadOnlyList< FingerFeatureConfig > RingFeatureConfigs[Get]

The list of FingerFeatureConfigs which must be satisfied for the ring finger to be acceptable for recognition by this ShapeRecognizer.

For an overview of the role of this list in shape recognition, see the remarks on FingerFeatureConfigList.

IReadOnlyList< FingerFeatureConfig > PinkyFeatureConfigs[Get]

The list of FingerFeatureConfigs which must be satisfied for the pinky finger to be acceptable for recognition by this ShapeRecognizer.

For an overview of the role of this list in shape recognition, see the remarks on FingerFeatureConfigList.

string ShapeName[Get]

The human-readable name assigned to this hand shape.

Member Functions

IReadOnlyList< FingerFeatureConfig > GetFingerFeatureConfigs

( HandFinger finger )

Retrieves the list of FingerFeatureConfigs which must be satisfied for the provided finger to be acceptable for recognition by this ShapeRecognizer.

This is a equivalent to calling ThumbFeatureConfigs/IndexFeatureConfigs/etc. for the finger in question.

Parameters

finger

The finger for which to retrieve the list of required FingerFeatureConfigs.

Returns

The list of required FingerFeatureConfigs for finger .

IEnumerable< ValueTuple< HandFinger, IReadOnlyList< FingerFeatureConfig > > > GetFingerFeatureConfigs ( )

Enumerates the required FingerFeatureConfigs for each finger in this ShapeRecognizer.

This is a convenience method equivalent to calling GetFingerFeatureConfigs(HandFinger) for every finger in turn.

Returns

An iterator exposing, in turn, each finger and its associated FingerFeatureConfigs as a tuple.

void InjectAllShapeRecognizer

( IDictionary< HandFinger, FingerFeatureConfig[]> fingerFeatureConfigs )

Sets the FingerFeatureConfigs for all fingers for a dynamically instantiated ShapeRecognizer.