shadow_cast_2d — GFX2D light op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.shadow_cast_2d(occluder, x, y, steps=None, softness=0.0) (die Implementierung direkt: import gfx2d; gfx2d.shadow_cast_2d(occluder, x, y, steps=None, softness=0.0); aus dem Register: opsgfx2d.get("shadow_cast_2d"))

Verwendung

Die Sichtbarkeit jedes Pixels von einer Punktlichtquelle bei (x, y), als image2d.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

Ray-marches the segment from each pixel to the light, sampling occluder (2-D, [0, 1], 1 = fully blocking) at steps points with nearest lookup, and returns 1 - max(occluder along the ray). For a binary occluder that is exactly 0 or 1 — no tolerance involved.

The sample excludes the pixel itself, so an occluder is lit on its own light-facing surface and casts behind itself.

softness > 0 blurs the visibility map by that sigma afterwards, which is a penumbra-shaped lie rather than a penumbra: a real one widens with distance from the occluder. It is offered because it looks right and named so it cannot be mistaken for physics.

steps defaults to the image diagonal, which samples about once per pixel. An occluder thinner than the step spacing can be missed; that is the honest limit of a fixed-step march and the reason steps is an argument.

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)

• gfx2d_scene — py -3.11 examples/gfx2d_scene.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

dither · raw_black_level · raw_dead_pixel_mask · raw_dead_pixel_correct · lens_shading_gain · lens_shading_correct · raw_apply_gains · raw_demosaic_bilinear

Gleiche Kategorie (light)

radial_light · light_mask · normal_map_decode · normal_map_shade


*Provenance: gfx2d.py — GFX2D 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.