focus_sweep_surface_video — LIVE4D render op

• Datenarten: volseq → rgbvideo

• Aufruf: import fullseye as fs; fs.ledger.focus_sweep_surface_video(volseq, window: 'int' = 5, zscale: 'float' = 1.0, light=(0.4, 0.4, 0.8), ambient: 'float' = 0.25) -> 'np.ndarray' (die Implementierung direkt: import live4d; live4d.focus_sweep_surface_video(volseq, window: 'int' = 5, zscale: 'float' = 1.0, light=(0.4, 0.4, 0.8), ambient: 'float' = 0.25) -> 'np.ndarray'; aus dem Register: opslive4d.get("focus_sweep_surface_video"))

Verwendung

Erzeugt aus einer Zeitreihe von Fokus-Sweeps (jeder Frame ein Fokusstapel in z) ein schattiertes Höhenfeld-Video (T, Y, X, 3) (rgbvideo).

Die Höhe ist dieselbe wie bei focus_sweep_height_video (maximale Schärfe per Parabel auf Subvoxel verfeinert). Aus dem Gradienten des Höhenfelds werden Normalen gebildet (zscale ist die reale Länge von 1 z-Schicht / die reale Länge eines Pixels), und Lambert-Schattierung in Richtung light (mit ambient als Sockel) wird auf die Farbe der Höhe (blau = niedrig → rot = hoch) multipliziert. Bewegt sich das Objekt während des Sweeps, bricht die Konsistenz der Schichten und die Höhe springt (nur diesen Zeitpunkten misstrauen).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie live4d

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_live4d — py -3.11 examples/poc_live4d.py

Typkompatible Folge-Operatoren (nehmen rgbvideo als Eingabe)

—

Gleiche Kategorie (render)

volseq_render_orbit · focus_sweep_height_video


*Provenance: live4d.py — LIVE4D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.