normal_map_decode — GFX2D light op

Datenarten: rgbnormalmap

Aufruf: import gfx2d; gfx2d.normal_map_decode(rgb) (oder opsgfx2d.get("normal_map_decode"))

Verwendung

Tangentenraum-Normalenkarte `rgb in [0, 1] zu Einheitsvektoren (H, W, 3)`.

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

The usual encoding `n = 2c - 1` followed by normalisation. The result is

the `normalmap` sort the rest of the library already speaks, so a decoded

map can go straight into the 3-D normals family.

Raises ValueError: a pixel whose decoded vector has zero length (the encoded

colour was exactly mid-grey), because normalising it would silently invent a

direction.

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

normal_map_shade

Gleiche Kategorie (light)

radial_light · light_mask · 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.