linear_to_srgb — GFX2D colorspace op

• Datenarten: rgb → rgb

• Aufruf: import fullseye as fs; fs.ledger.linear_to_srgb(img) (die Implementierung direkt: import gfx2d; gfx2d.linear_to_srgb(img); aus dem Register: opsgfx2d.get("linear_to_srgb"))

Verwendung

Lineares Licht zurück in die sRGB-Kodierung. Die exakte Umkehrung von srgb_to_linear.

Formel (IEC 61966-2-1): 12.92 c für c <= 0.0031308, sonst 1.055 c^(1/2.4) - 0.055. Unabhängig je Kanal und je Pixel.

• img: float der Form (H, W) / (H, W, 1) / (H, W, 3) / (H, W, 4). Werte müssen in [0, 1] liegen (Toleranz 1e-9), sonst ValueError -- HDR-Werte linearen Lichts (über 1) zuerst per Belichtung in den Bereich bringen. Integer-Arrays passieren nur, wenn das Maximum höchstens 1 ist (Puffer mit 0-255 werden abgewiesen). bool passiert als 0/1. NaN/Inf, komplexe Zahlen und maskierte Arrays ergeben ValueError.

• Das Alpha von (H, W, 4) (4. Kanal) wird nicht umgerechnet (Bedeckungsgrad ist von vornherein linear).

• Rückgabewert: float64-Kopie derselben Form, [0, 1].

• 1 Farbe als (3,) oder eine Farbtabelle (N, 3) nimmt diese op nicht an (Bild-API). Für beliebige Formen delegiert die gleichnamige Funktion auf der imgmetrics-Seite hierher.

Auf in linearem Licht berechnete Ergebnisse wie radial_light / light_mask / bloom genau 1 Mal anwenden, unmittelbar vor dem Schreiben in eine Datei oder der Anzeige. Zweimal angewendet werden die Mitteltöne angehoben (es wird keine Ausnahme ausgelöst).

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

• poc_leaf_disease_area — py -3.11 examples/poc_leaf_disease_area.py

• poc_pigment_unmixing — py -3.11 examples/poc_pigment_unmixing.py

• poc_white_balance — py -3.11 examples/poc_white_balance.py

Typkompatible Folge-Operatoren (nehmen rgb als Eingabe)

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

Gleiche Kategorie (colorspace)

srgb_to_linear


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