WB-08 – AVIF Lossless, Subsampling, Bittiefe, Geschwindigkeit und Metadaten steuern

Was macht die Funktion?

Der AVIF-Speicherweg bietet verlustfreie oder verlustbehaftete Farbbildkompression, auswählbare Bittiefe und Subsampling. ImageConvert baut dafür einen Photoshop-Speicherdescriptor. Der gelesene Source schaltet CMYK vor diesem Save auf RGB um; ein AVIF-Ziel ist hier kein CMYK-Lieferweg.

Wo wird sie konfiguriert?

Kunden-JSON: mainFolder.web.subFolder[].avif, am Ausgang mit format: "avif".

Feld im Ausgang	Typ / dokumentierte Werte	Wirkung bzw. Grenze
avif.lossless	Boolean	true: verlustfreie Farbe; false: verlustbehaftet
qualityJPG	Zahl, im Descriptor Integer	Farbqualität bei verlustbehaftetem AVIF; Sourcekommentar nennt 0–100, keine hier neu laufgeprüfte Bereichsgarantie
avif.chromeSubsampling	String 420, 422, 444	Subsampling; Schlüssel heißt tatsächlich chromeSubsampling
avif.imageDepth	Integer 8, 10, 12	Zielbittiefe
avif.encoderSpeed	Integer 2, 4, 6, 8, 10 laut Tabelle 9	Geschwindigkeitsvorgabe; keine Strings wie Fastest verwenden
avif.keepColorProfil	Boolean	Profilretention laut Handbuch; Reader vorhanden, eigenständige Wirkung im gelesenen Save-Descriptor nicht bestätigt
avif.keepExif, avif.keepXMP	Boolean	EXIF-/XMP-Übernahme anfordern; Descriptor setzt beide Flags
flatten	Boolean	Vor dem Save Transparenz explizit auf Hintergrund reduzieren oder diesen Schritt auslassen

Keine Defaults aus Tabelle oder Beispiel ableiten. Der historische Name compressionSpeed ist kein belegter Alias von encoderSpeed. Auch keepColorProfile und chromaSubsampling sind keine still zu korrigierenden Ersatzschlüssel.

Konfigurieren und Beispiel

1. Wähle den vorhandenen Webausgang und setze format: "avif".
2. Entscheide zwischen Lossless und einer verlustbehafteten Qualitätsvorgabe.
3. Trage Subsampling, Bittiefe und Speed mit den genannten Typen ein. Die Kombination muss vom tatsächlichen Photoshop-Speicherweg unterstützt werden; eine Liste einzeln beschriebener Werte beweist nicht jede Kombination.
4. Prüfe nach sicherer Änderung Container, decodierbare Bilddaten, Bittiefe, Subsampling, Alpha und gewünschte Metadaten.

Fragment eines vorhandenen Ausgangsobjekts, Beispielwerte, keine vollständige Konfiguration:

{
  "format": "avif",
  "qualityJPG": 80,
  "flatten": false,
  "avif": {
    "lossless": true,
    "chromeSubsampling": "444",
    "imageDepth": 8,
    "encoderSpeed": 6,
    "keepColorProfil": true,
    "keepExif": true,
    "keepXMP": true
  }
}

Hier ist 80 keine wirksame Lossy-Farbqualität, solange lossless: true gesetzt ist. „Lossless“ betrifft die Speicherstufe, nicht rückwirkend vorherige Skalierungen, Profilkonvertierungen oder Bittiefenänderungen. Der gelesene Descriptor fordert Alpha-Kompression separat verlustfrei an.

Quellenbefund und Grenze des Laufzeitnachweises (23.10.2026)

encoderSpeed wird im gelesenen Source als Integer in das verschachtelte AVIF-Objekt gesetzt und über DoJavaScript/executeAction(save, …) übergeben. Das belegt den Codeweg, nicht die tatsächliche Übergabe in einer installierten EXE. Aus Dateigröße, Laufzeit oder dem fertigen AVIF lässt sich Speed 6 nicht zuverlässig zurücklesen. Eine fehlende Messung ist weder ein Nachweis der Wirkung noch der generellen Unmöglichkeit einer Instrumentierung.

Der Reader liest keepColorProfil; der Whole-Form1-Abgleich der aktuellen Kundenfeldreferenz findet keinen konsumierenden Zugriff auf dieses Array. Der Schalter belegt deshalb keine ICC-Erhaltung. ICC-Retention am Ergebnis kontrollieren.

Vorsicht bei beiden Optionsobjekten im selben Ausgang: Der Reader liest zunächst AVIF, danach WEBP in gemeinsame Arrays. Vorhandene webp.lossless, webp.keepExif und webp.keepXMP überschreiben die entsprechenden AVIF-Werte desselben Slots. Auch webp.keepPSExtras beeinflusst den AVIF-Descriptor. Das Beispiel setzt daher bewusst kein zusätzliches webp-Objekt. Ein aus einem anderen Format kopiertes Optionsobjekt ist nicht sicher wirkungslos, nur weil format: "avif" ausgewählt ist. EXIF/XMP-Flags ersetzen ebenfalls keinen Metadatenvergleich. Die am 24.10.2026 dokumentierte praktische Ergebnisprüfung war eine Prüfentscheidung, kein bereits ausgeführter Produkt-PASS.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, PDF-S. 68, 76–77, Tabelle 9 (gedruckt 72–73). IC/Form1.cs 1072–1087, 7872–7927; Whole-Form1-Abgleich aus docs/programmdoku-referenz-kunde/felder.json und dessen ABNAHME.md, Punkt 5; Quellstand. Datierte Messgrenzen: docs/kompletttest/representative-20261021/bindings-avif-observer-decision/DECISION.md; praktische Abgrenzung PRAKTISCHE_OPERATIONS_RUN1060.md im übergeordneten Verzeichnis. Keine neue Ausführung oder Installationszusage.

Feldanker: lossless · chromeSubsampling · imageDepth · encoderSpeed · keepColorProfil · keepExif · keepXMP.

Weiter: Flatten · WEBP · Ausgänge einrichten · Web.