Skip to main content Link Search Menu Expand Document (external link)
Hidale.com Docs

@faceprop attribute

:electric_plug: dp.kinect2
:information_source: signature
faceprop FACEPROP_BOOLEAN
:house: values
0
no face property output default
1
output face properties
:bulb: examples
@faceprop 1

Face properties for the appearance or state of a tracked face. Output on the fifth outlet. @faces must be enabled for this face tracking feature to function.

Microsoft’s Kinect v2 SDK used by dp.kinect2 provides details on these face properties. These properties may be noisy and benefit from a filter or smoothing.

# Max native:   @faces 1 @faceprop 1 @skeletonformat 1
face playerId property state confidence

# OSC protocol: @faces 1 @faceprop 1
/face/playerId/property state confidence
playerId
same integer used for a tracked skeleton
property
name of happy, engaged, wearingglasses, lefteyeclosed, righteyeclosed, mouthopen, mouthmoved, or lookingaway
state
boolean (0 = false, 1 = true) of the state of the face property
confidence
normalized float [0.0..1.0] for the confidence of that property. 1.0 indicates the highest confidence

Examples 

# face on skeleton 2 expresses happiness and sensor is very confident
face 2 happy 1 1.0

# face on skeleton 2 may express happiness and sensor is only somewhat confident
face 2 happy 1 0.5

# face on skeleton 2 does not express happiness and sensor is very confident
face 2 happy 0 1.0

# face on skeleton 2 has the left eye closed and sensor is very confident
face 2 lefteyeclosed 1 1.0

# face on skeleton 2 has the left eye open and sensor is very confident
face 2 lefteyeclosed 0 1.0

# face on skeleton 2 is looking away and sensor is very confident
face 2 lookingaway 1 1.0

# face on skeleton 2 is probably partially looking away and sensor is only somewhat confident
face 2 lookingaway 1 0.5

# face on skeleton 2 is wearing eye glasses and sensor is very confident
face 2 wearingglasses 1 1.0