radial_light — GFX2D light op

Datenarten: keinergb (ein Operator, der allein durch seine Argumente bestimmt ist — er nimmt kein Bild und keine Daten entgegen)

Aufruf: import gfx2d; gfx2d.radial_light(height, width, x, y, radius, intensity=1.0, falloff='smooth', color='emphasis', scheme='okabe_ito') (oder opsgfx2d.get("radial_light"))

Verwendung

Eine radiale Lichtkarte, `rgb (H, W, 3), zentriert auf (x, y)`.

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

`falloff`:

• `"smooth"(1 - t^2)^2`, compactly supported: exactly zero at and

beyond `radius`. The default, because a light that ends somewhere is the

only kind you can budget.

• `"linear"1 - t`, also compact.

• `"inverse_square"1 / (1 + (3t)^2)`, the physical law softened at

the origin. Not compactly supported: it is 10 % of peak at the nominal

radius and never reaches zero, so a scene full of these never gets dark.

The value at the centre is exactly `intensity * color`. This is a

*linear-light* quantity: add lights together, then encode once.

With `intensity > 1 the result leaves [0, 1]` — deliberately, because a

light map is not a picture. :func:light_mask accepts it; the operators that

take an `rgb` *image* reject it with the documented range error rather than

clipping a light budget behind your back.

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 rgb als Eingabe)

srgb_to_linear · linear_to_srgb · blend_mode · light_mask · normal_map_decode · bloom · vignette · chromatic_aberration

Gleiche Kategorie (light)

light_mask · normal_map_decode · normal_map_shade · shadow_cast_2d


*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.