stabilizing

Frame analyzed during stabilization.

Details

It is emitted on each frame while the stabilization process is active.

Event: stabilizing

Type: FacephiSelphiWidgetCustomEvent<StabilizingEvent> | CustomEvent<StabilizingEvent>

Syntax

selphi.addEventListener('stabilizing', onStabilizing);

Received object

The useful payload is of type SelphiStabilizingDetail and is in event.detail.detail:

• eventType (string): Type of event emitted.

• diagnostic (number): Stabilization code for the current frame.

Stabilization codes diagnostic:

ID	Name	Description
1	OK	Stabilization phase passed.
2	NotStabilized	The user must remain still and facing forward.
3	NotStabilizedTooFar	The user must be within the predefined area.
4	NotStabilizedSunGlasses	Occlusions on the face prevent detection.
5	NotStabilizedTooClose	The user must move farther away to avoid optical distortion.
6	NotStabilizedTooMovement	The user does not remain still.
8	NotStabilizedNoFrontal	Face not centered (generic incorrect posture).
9	NotStabilizedNoFrontalTooLeft	Face turned too far to the left.
10	NotStabilizedNoFrontalTooRight	Face turned too far to the right.
11	NotStabilizedNoFrontalTooDown	Face tilted too far down.
12	NotStabilizedNoFrontalTooUp	Face tilted too far up.
13	NoStabilizedNoColor	Color image with insufficient color.
14	NotStabilizedLowQuality	Low image quality.
15	NotStabilizedLowFaceQuality	Low face quality.
16	NotStabilizedLowPatternQuality	Poor pattern.
17	OkGlasses	Stabilization passed with glasses.
18	NotStabilizedInvalidResolution	Invalid resolution (720 or 480 expected).
19	NotStabilizedMask	Does not pass stabilization due to wearing a mask.

Description

Reports the result of each stabilization attempt. When the widget returns OK or OkGlasses, it moves on to the next step before extraction.

Considerations

Only emitted if stabilization is enabled. The useful payload is in event.detail.detail (see event format).

---

Example

<facephi-selphi-widget
    onStabilizing={(event) => {
      const { diagnostic } = event.detail.detail;
      console.log('Stabilizing diagnostic:', diagnostic);
    }}
/>

import { type SelphiStabilizingDetail } from '@facephi/sdk-web-wc';

selphi.addEventListener('stabilizing', (event) => {
  const detail: SelphiStabilizingDetail = event.detail.detail;
});