Zum Inhalt

WB-03 – Webformate AVIF, GIF, JPG, PDF/AI, PNG-8, PNG-24, PSD, SVG, WEBP

Was macht die Funktion?

format wählt den Speicherweg eines Webausgangs. Ein Webziel ist nicht auf Browserformate beschränkt: Auch PSD oder PDF sind vorgesehen. Die Dateiendung allein sagt weder etwas über Transparenz noch über erhaltene Vektoren oder Ebenen aus.

Wo wird sie konfiguriert?

Kunden-JSON: mainFolder.web.subFolder[].format, Typ String. Die folgenden Tokens sind im Handbuch beschrieben:

Wert Ausgabe und Besonderheit
avif JavaScript-Speicherweg, RGB und eigene AVIF-Optionen
gif Save-for-Web-Export mit GIF-Optionen
jpg Save-for-Web; im gelesenen Source bei gesetztem Profil stattdessen SaveAs, siehe WB-05
ai, pdf PDF-Speicherung, auch ai erzeugt in diesem Webzweig eine .pdf; kein allgemeiner Illustrator-Vektorexport
png-8, png-24 PNG-Export mit getrennten Optionen; Source besitzt bei Profilen alternative SaveAs-Zweige
psd Photoshop-Datei des bereits verarbeiteten Webstands; keine Zusage, die ursprüngliche Ebenenstruktur zurückzubekommen
svg Eingangs-SVG übernehmen oder generische AI/EPS/PDF konvertieren; WB-09
webp JavaScript-Speicherweg mit WEBP-Optionen

Der konkrete Source enthält zusätzlich bmp- und tif-Zweige. Das erweitert nicht rückwirkend die im Handbuch aufgeführte Formatliste; deren vollständiger Bedienvertrag ist hier nicht als qualifiziert angeboten.

Konfigurieren und Beispiel

  1. Wähle das vorhandene Ausgangsobjekt, nicht nur dessen Ordnernamen.
  2. Setze format auf das gewünschte Token und ergänze die dazugehörigen Optionen auf der passenden Ebene.
  3. Kontrolliere Größe, Profil und Transparenz unabhängig vom Format. Sie können den Saver oder den sichtbaren Inhalt verändern.
  4. Prüfe nach einer sicheren Konfigurationsänderung tatsächlichen Dateityp, Endung und Zielablage.

Änderungsfragment eines vorhandenen Ausgangs, kein vollständiges Listenobjekt:

{
  "format": "png-24",
  "flatten": false
}

Damit wird ein PNG-24-Ziel gewählt. Für Alpha muss außerdem webOptions.png24Options.transparency: true gesetzt und Transparenz in der Webvorlage vorhanden sein. flatten: false erzeugt keine Freistellung.

Grenzen und Fehlerfälle

Das Handbuch nennt JPG als Ersatz für unbekannte Webtypen. Der Source bestätigt einen Defaultzweig mit .jpg und Diagnoseeintrag; zusätzlich existiert ein eigener Exception-Ersatzversuch. Das ist keine Garantie, dass jeder fehlerhafte Export ein brauchbares JPG liefert. Tippfehler nicht durch diesen Mechanismus kaschieren. Ein fehlendes format wird im gelesenen Reader mit jpg initialisiert; das ist ein Sourcebefund und keine Empfehlung, das Feld wegzulassen.

Ebenenzusammenfassung findet vor der Speicherung statt: WB-10. Transparenzverlust durch explizites Flatten: WB-22.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, physische PDF-S. 42–44, Abschnitt 3.9 (gedruckt 38–40). Statisch: IC/Form1.cs 1116–1119, 7737–7980, Formatwechsel, Profilzweige und Ersatzpfade; Quellstand. Kein neuer Lauf-/Verfügbarkeitsnachweis.

Feldanker: format. Anleitung: Ausgänge einrichten.

Zurück zu Web