normal_map_shade — GFX2D `light` op

• Datenarten: normalmap → rgb

• Aufruf: import gfx2d; gfx2d.normal_map_shade(normals, light_dir=(0.0, 0.0, 1.0), ambient=0.1, diffuse='reference', specular=0.0, shininess=32.0, view_dir=(0.0, 0.0, 1.0), scheme='okabe_ito') (oder opsgfx2d.get("normal_map_shade"))

Verwendung

Schattiert eine 2-D-Normalenkarte mit einer gerichteten Lichtquelle (Lambert + Blinn 1977).

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

`normals is a normalmap: (H, W, 3)` unit vectors, as

:func:normal_map_decode returns. Non-unit input raises rather than being

normalised for you — a normal map that is not normalised is usually a map

that was never decoded, and quietly fixing it hides the mistake.

`out = diffuse * (ambient + max(n·l, 0)) + specular * max(n·h, 0)^shininess`

with `h` the normalised halfway vector between light and view.

Directions are `(x, y, z)` with **+x right, +y down, +z out of the

screen** — the same handedness as the pixel grid, so a light at

`(0, -1, 1)` comes from above the screen. Getting the sign of y wrong

flips the perceived relief (bumps become dents) without raising anything;

that is the one thing to check on first render.

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

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

Gleiche Kategorie (`light`)

radial_light · light_mask · normal_map_decode · shadow_cast_2d

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

normal_map_shade — GFX2D light op