Merge origin/hugging_face_final into hugging_face_final

Resolve conflict in main.py: keep refactored drawing imports
(draw_face_mesh, draw_hud from api.drawing) over inline definitions.

.gitignore

@@ -46,3 +46,4 @@ static/
 __pycache__/
 docs/
 docs
+LOCAL_TESTING.md

main.py

@@ -201,6 +201,7 @@ class VideoTransformTrack(VideoStreamTrack):
                 # Draw face mesh + HUD on the video frame
                 h_f, w_f = img.shape[:2]
                 lm = out.get("landmarks")
+                eye_gaze_enabled = _l2cs_boost_enabled or model_name == "l2cs"
                 if lm is not None:
                     draw_face_mesh(img, lm, w_f, h_f)
                 draw_hud(img, out, model_name)
@@ -671,6 +672,7 @@ async def websocket_endpoint(websocket: WebSocket):
                     "model": model_name,
                     "fc": frame_count,
                     "frame_count": frame_count,
+                    "eye_gaze_enabled": _l2cs_boost_enabled or model_name == "l2cs",
                 }
                 if out is not None:
                     if out.get("yaw") is not None:

src/utils/VideoManagerLocal.js

@@ -164,7 +164,7 @@ export class VideoManagerLocal {
                 this.ws.onclose = null;
                 try {
                     this.ws.close();
-                } catch (_) {}
+                } catch (_) { }
                 this.ws = null;
             }
 
@@ -464,6 +464,7 @@ export class VideoManagerLocal {
                     on_screen: data.on_screen,
                     gaze_yaw: data.gaze_yaw,
                     gaze_pitch: data.gaze_pitch,
+                    eye_gaze_enabled: data.eye_gaze_enabled || false,
                 };
                 this.drawDetectionResult(detectionData);
                 break;
@@ -576,15 +577,15 @@ export class VideoManagerLocal {
         152, 148, 176, 149, 150, 136, 172, 58, 132,
         93, 234, 127, 162, 21, 54, 103, 67, 109, 10,
     ];
-    static LEFT_EYE = [33,7,163,144,145,153,154,155,133,173,157,158,159,160,161,246];
-    static RIGHT_EYE = [362,382,381,380,374,373,390,249,263,466,388,387,386,385,384,398];
-    static LEFT_IRIS = [468,469,470,471,472];
-    static RIGHT_IRIS = [473,474,475,476,477];
-    static LEFT_EYEBROW = [70,63,105,66,107,55,65,52,53,46];
-    static RIGHT_EYEBROW = [300,293,334,296,336,285,295,282,283,276];
-    static NOSE_BRIDGE = [6,197,195,5,4,1,19,94,2];
-    static LIPS_OUTER = [61,146,91,181,84,17,314,405,321,375,291,409,270,269,267,0,37,39,40,185,61];
-    static LIPS_INNER = [78,95,88,178,87,14,317,402,318,324,308,415,310,311,312,13,82,81,80,191,78];
+    static LEFT_EYE = [33, 7, 163, 144, 145, 153, 154, 155, 133, 173, 157, 158, 159, 160, 161, 246];
+    static RIGHT_EYE = [362, 382, 381, 380, 374, 373, 390, 249, 263, 466, 388, 387, 386, 385, 384, 398];
+    static LEFT_IRIS = [468, 469, 470, 471, 472];
+    static RIGHT_IRIS = [473, 474, 475, 476, 477];
+    static LEFT_EYEBROW = [70, 63, 105, 66, 107, 55, 65, 52, 53, 46];
+    static RIGHT_EYEBROW = [300, 293, 334, 296, 336, 285, 295, 282, 283, 276];
+    static NOSE_BRIDGE = [6, 197, 195, 5, 4, 1, 19, 94, 2];
+    static LIPS_OUTER = [61, 146, 91, 181, 84, 17, 314, 405, 321, 375, 291, 409, 270, 269, 267, 0, 37, 39, 40, 185, 61];
+    static LIPS_INNER = [78, 95, 88, 178, 87, 14, 317, 402, 318, 324, 308, 415, 310, 311, 312, 13, 82, 81, 80, 191, 78];
     static LEFT_EAR_POINTS = [33, 160, 158, 133, 153, 145];
     static RIGHT_EAR_POINTS = [362, 385, 387, 263, 373, 380];
     // Iris/eye corners for gaze lines
@@ -680,11 +681,12 @@ export class VideoManagerLocal {
                 outer: VideoManagerLocal.RIGHT_EYE_OUTER,
             },
         ];
-        // Get L2CS gaze angles + on_screen state from latest detection data
+        // Get L2CS gaze angles + on_screen state + eye gaze toggle from latest detection data
         const detection = this._lastDetection;
         const gazeYaw = detection ? detection.gaze_yaw : undefined;
         const gazePitch = detection ? detection.gaze_pitch : undefined;
         const onScreen = detection ? detection.on_screen : undefined;
+        const eyeGazeEnabled = detection ? detection.eye_gaze_enabled : false;
         const hasL2CSGaze = gazeYaw !== undefined && gazePitch !== undefined;
         const gazeLineColor = (onScreen === false) ? '#FF0000' : '#00FF00';
         const gazeLineLength = 100;
@@ -716,57 +718,60 @@ export class VideoManagerLocal {
             ctx.lineWidth = 1;
             ctx.stroke();
 
-            // Gaze direction line — use L2CS angles when available, else geometric fallback
-            if (hasL2CSGaze) {
-                // L2CS pitch/yaw in radians -> pixel direction vector
-                // Matches upstream L2CS-Net vis.py draw_gaze formula:
-                //   dx = -length * sin(pitch) * cos(yaw)
-                //   dy = -length * sin(yaw)
-                const dx = -gazeLineLength * Math.sin(gazePitch) * Math.cos(gazeYaw);
-                const dy = -gazeLineLength * Math.sin(gazeYaw);
-                const ex = cx + dx;
-                const ey = cy + dy;
-
-                // Main gaze line (thick, color-coded)
-                ctx.beginPath();
-                ctx.moveTo(cx, cy);
-                ctx.lineTo(ex, ey);
-                ctx.strokeStyle = gazeLineColor;
-                ctx.lineWidth = 3;
-                ctx.stroke();
-
-                // Arrowhead
-                const angle = Math.atan2(ey - cy, ex - cx);
-                const arrowLen = 10;
-                ctx.beginPath();
-                ctx.moveTo(ex, ey);
-                ctx.lineTo(ex - arrowLen * Math.cos(angle - 0.4), ey - arrowLen * Math.sin(angle - 0.4));
-                ctx.moveTo(ex, ey);
-                ctx.lineTo(ex - arrowLen * Math.cos(angle + 0.4), ey - arrowLen * Math.sin(angle + 0.4));
-                ctx.strokeStyle = gazeLineColor;
-                ctx.lineWidth = 2;
-                ctx.stroke();
-            } else {
-                // Geometric fallback: iris displacement from eye center (scaled up)
-                const innerPt = _get(inner);
-                const outerPt = _get(outer);
-                if (innerPt && outerPt) {
-                    const eyeCx = (innerPt[0] + outerPt[0]) / 2.0 * w;
-                    const eyeCy = (innerPt[1] + outerPt[1]) / 2.0 * h;
-                    const fdx = cx - eyeCx;
-                    const fdy = cy - eyeCy;
-                    const flen = Math.hypot(fdx, fdy);
-                    if (flen > 0.5) {
-                        const scale = gazeLineLength / flen;
-                        ctx.beginPath();
-                        ctx.moveTo(cx, cy);
-                        ctx.lineTo(cx + fdx * scale, cy + fdy * scale);
-                        ctx.strokeStyle = '#00FFFF';
-                        ctx.lineWidth = 2;
-                        ctx.stroke();
+            // Gaze direction line — only draw when eye gaze toggle is ON
+            if (eyeGazeEnabled) {
+                if (hasL2CSGaze) {
+                    // L2CS pitch/yaw in radians -> pixel direction vector
+                    // Matches upstream L2CS-Net vis.py draw_gaze formula:
+                    //   dx = -length * sin(pitch) * cos(yaw)
+                    //   dy = -length * sin(yaw)
+                    const dx = -gazeLineLength * Math.sin(gazePitch) * Math.cos(gazeYaw);
+                    const dy = -gazeLineLength * Math.sin(gazeYaw);
+                    const ex = cx + dx;
+                    const ey = cy + dy;
+
+                    // Main gaze line (thick, color-coded)
+                    ctx.beginPath();
+                    ctx.moveTo(cx, cy);
+                    ctx.lineTo(ex, ey);
+                    ctx.strokeStyle = gazeLineColor;
+                    ctx.lineWidth = 3;
+                    ctx.stroke();
+
+                    // Arrowhead
+                    const angle = Math.atan2(ey - cy, ex - cx);
+                    const arrowLen = 10;
+                    ctx.beginPath();
+                    ctx.moveTo(ex, ey);
+                    ctx.lineTo(ex - arrowLen * Math.cos(angle - 0.4), ey - arrowLen * Math.sin(angle - 0.4));
+                    ctx.moveTo(ex, ey);
+                    ctx.lineTo(ex - arrowLen * Math.cos(angle + 0.4), ey - arrowLen * Math.sin(angle + 0.4));
+                    ctx.strokeStyle = gazeLineColor;
+                    ctx.lineWidth = 2;
+                    ctx.stroke();
+                } else {
+                    // Geometric fallback: iris displacement from eye center (scaled up)
+                    const innerPt = _get(inner);
+                    const outerPt = _get(outer);
+                    if (innerPt && outerPt) {
+                        const eyeCx = (innerPt[0] + outerPt[0]) / 2.0 * w;
+                        const eyeCy = (innerPt[1] + outerPt[1]) / 2.0 * h;
+                        const fdx = cx - eyeCx;
+                        const fdy = cy - eyeCy;
+                        const flen = Math.hypot(fdx, fdy);
+                        if (flen > 0.5) {
+                            const scale = gazeLineLength / flen;
+                            ctx.beginPath();
+                            ctx.moveTo(cx, cy);
+                            ctx.lineTo(cx + fdx * scale, cy + fdy * scale);
+                            ctx.strokeStyle = '#00FFFF';
+                            ctx.lineWidth = 2;
+                            ctx.stroke();
+                        }
                     }
                 }
             }
+            // When eye gaze is OFF, no gaze lines are drawn
         }
     }