WB-07 – WEBP mit Qualität/Flatten und Metadatenoptionen

Was macht die Funktion?

Ein WEBP-Ausgang speichert die verarbeitete Webvorlage über einen Photoshop-JavaScript-Descriptor. Qualität und Metadaten lassen sich am Ausgang einstellen. Das Handbuch beschreibt außerdem lossless; der untersuchte Speicherweg setzt jedoch ausdrücklich verlustbehaftete Kompression. Ein lesbares Feld ist daher noch keine nachgewiesene Wirkung.

Wo wird sie konfiguriert?

Kunden-JSON, jeweils im vorhandenen Objekt mainFolder.web.subFolder[]:

Feld	Typ / Werte	Bedeutung und Beleggrenze
format	String webp	WEBP-Saver wählen
qualityJPG	Zahl, im Saver als Integer weitergegeben	Qualität des verlustbehafteten WEBP, trotz Feldname nicht nur JPG; hier kein zusätzlicher unbelegter Wertebereich
flatten	Boolean	true: vor dem WEBP-Speichern auf Hintergrund reduzieren; false: diesen expliziten Schritt nicht verlangen
webp.lossless	Boolean	Im Handbuch beschrieben und im Reader vorhanden; im gelesenen Savewebp nicht wirksam angeschlossen
webp.keepExif	Boolean	EXIF-Übernahme anfordern
webp.keepXMP	Boolean	XMP-Übernahme anfordern
webp.keepPSExtras	Boolean	Photoshop-Extras anfordern; nicht gleichbedeutend mit garantiertem Ebenenerhalt

Gemeinsame Optionsarrays: AVIF wird im Reader vor WEBP eingelesen. webp.lossless, webp.keepExif und webp.keepXMP überschreiben bei Vorhandensein dieselben Slotvariablen wie die entsprechenden AVIF-Felder, selbst wenn format auf avif steht. webp.keepPSExtras speist zudem das auch im AVIF-Descriptor benutzte Flag. Deshalb nicht beide Optionsobjekte mit widersprüchlichen Werten in dasselbe Ausgangsobjekt kopieren. Das gilt pro Slot, nicht pauschal zwischen verschiedenen Ausgängen.

Die Metadatenflags sind Speicherabsichten. Sie erzeugen keine fehlenden Quellmetadaten und belegen nicht deren vollständige Retention. Im gelesenen WEBP-Weg wird CMYK vor dem Save auf RGB umgestellt. Defaults werden aus den Handbuchbeispielen nicht abgeleitet.

Konfigurieren und Beispiel

1. Ergänze oder wähle einen vorhandenen Webausgang.
2. Setze format, Qualität und die gewünschten WEBP-Unteroptionen direkt an diesem Objekt.
3. Für Transparenz flatten: false wählen und die vorgelagerte Webvorlage prüfen. Ein JPG-Hintergrund wird dadurch nicht transparent.
4. Kontrolliere tatsächlichen WEBP-Typ, Alpha und die gewünschten Metadaten, nicht nur Dateigröße oder Endung.

Fragment für ein vorhandenes Ausgangsobjekt, ohne Ablage-/Größenfelder und ohne Defaultanspruch:

{
  "format": "webp",
  "qualityJPG": 80,
  "flatten": false,
  "webp": {
    "lossless": false,
    "keepExif": true,
    "keepXMP": true,
    "keepPSExtras": false
  }
}

Dieses Beispiel verlangt bewusst verlustbehaftetes WEBP; es ist kein Beispiel für einen bereits nachgewiesenen Lossless-Weg. Soll verlustfrei geliefert werden, lossless: true nicht allein als Erfüllungsbeleg verwenden: Die Diskrepanz muss für den tatsächlich eingesetzten Lieferstand geklärt sein.

Grenzen und Zusammenhänge

Savewebp erhält Qualität und drei Metadatenflags, aber keinen lossless-Parameter; der erzeugte Descriptor enthält fest compressionLossy. Das ist ein konkreter statischer Befund des lokalen Source, kein Nachweis der installierten EXE. Der frühere pauschale Hinweis „webp-Objekt fehlt“ gilt nicht als heutige Nichtverfügbarkeitsaussage: Objekt und Reader sind vorhanden, die Anbindung ist differenziert zu betrachten.

Flatten ist nicht sichtbare Ebenen zusammenfassen. noTrim schützt die Bildfläche vor bestimmten Beschnittwegen, nicht die Metadaten.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, PDF-S. 44, 68 und 77–78 (Historyobjekt). IC/Form1.cs 1072–1087, 6525–6558, 7850–7868 und 7915–7917; Abgleich mit docs/programmdoku-referenz-kunde/felder.json und dessen ABNAHME.md, Punkt 5; Quellstand. Keine neue native Exportprüfung.

Feldanker: lossless · keepExif · keepXMP · keepPSExtras · flatten.

Anleitung: Web-/Printausgänge · Web.