Even if in the NITHsensors collection, NITHwebcamWrapper is not properly a sensor, but a Python script to use a webcam as a sensor.
Please see the NITHwebcamWrapper GitHub repository readme and follow the instructions in order to download and use it!
https://github.com/LIMUNIMI/NithFC
NITHwebcamWrapper extracts head position, eyes aperture and mouth aperture through the Mediapipe library.
NITHwebcamWrapper does not provide some values by default, such as binary blink detection and calibration thresholds for eyes aperture and mouth aperture. However, the library NITHlibrary and NITHdmis does provide a preprocessor for NithModule (NithPreprocessor_FaceCam) able to compute these, client side. See the library for more informations!
head_pos_pitch, head_pos_yaw, head_pos_roll describe the position of the head (should be in degrees but not so much precise imho)eyeLeft_ape, eyeRight_ape are eye apertures ratio. Only base, but using the preprocessor also the Max will become available (through calibration).mouth_ape is mouth aperture ratio. As above, only base, but using the preprocessor also the Max will become available (through calibration).In addition, using the preprocessor, the following parameters will become available:
mouth_isOpen is a boolean value which indicates if the mouth is closed or even slightly open. Adjusts by calibration (manual or automatic).eyeLeft_isOpen and eyeRight_isOpen are both boolean values which indicate if the left eye and the right eye are open. Adjusts by calibration (manual or automatic).