shadow_cast_2d — GFX2D light op

Datenarten: image2dimage2d

Aufruf: import gfx2d; gfx2d.shadow_cast_2d(occluder, x, y, steps=None, softness=0.0) (oder 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_scenepy -3.11 examples/gfx2d_scene.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

dither

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.