Zum Inhalt

WB-15 – An transparenten Pixeln beschneiden

Was macht die Funktion?

Transparenztrim entfernt transparente Außenränder, damit das sichtbare Motiv die Bildfläche enger ausfüllt. Es erzeugt selbst keine Freistellung und entfernt keinen deckend weißen Hintergrund. Nach einer Pfadfreistellung kann es die neu entstandenen transparenten Außenbereiche wegnehmen.

Wo wird sie konfiguriert?

Kunden-JSON: webOptions.switches.transparentBeschneiden, Typ Boolean.

Wert Bedeutung
true Transparenztrim im entsprechenden Webzweig versuchen
false Diesen Trimaufruf unterlassen; keine allgemeine Sperre sämtlicher Beschnittmechanismen

Der Reader initialisiert den Schalter mit true; das ist ein Source-Default, nicht aus einem Beispiel abgeleitet. Er wird im Pfadfall nach dem Löschen außerhalb der Auswahl und im Fall ohne ausgewählten Pfad ausgewertet. Ein deaktivierter Transparenztrim verhindert daher nicht zwangsläufig die Pfadfreistellung selbst. Ein lokales noTrim wählt dagegen die ungetrimmte Vorlage des regulären Ausgangs.

Konfigurieren und Beispiel

  1. Prüfe in Photoshop, ob der Rand tatsächlich transparent oder nur weiß gefüllt ist.
  2. Wähle den Schalter und prüfe noTrim sowie den tatsächlichen Eingang.
  3. Beurteile die Außenmaße vor zusätzlichem Canvas und die sichtbare Motivkontur. Die später konfigurierte Zielgröße kann die absolute Pixelzahl wieder verändern.

Kunden-JSON-Fragment für Transparenztrim ohne Pfad- und Weißtrim:

{
  "webOptions": {
    "switches": {
      "trim": "no",
      "transparentBeschneiden": true,
      "useWeissBeschneiden": false
    }
  }
}

Beispiel: Ein transparentes PNG enthält ein kleines Motiv mit großzügigem leerem Rand. An einem trimfähigen Ausgang soll nur der transparente Außenrand entfallen. Für ein Vergleichsziel mit vollständiger Quellfläche setze lokal noTrim: true. Beide Ziele können weiter dasselbe PNG-Format mit Transparenzexport verwenden.

Verifizierter Projektstand

Die Retests vom 26./27.08.2026 sowie der Abschluss vom 31.08.2026 bestätigten einzelne Pfad-/PNG-Positivfälle. Die spätere Regression des Builds 20260915 betraf die lokale Unterdrückung durch noTrim, nicht bloß die Existenz einer Trimwirkung. Im Retest zu Build 20261009 war der geprüfte lokale noTrim-Fall wieder korrekt; siehe WB-14. Diese Befunde sind keine allgemeine heutige Freigabe aller Trimkombinationen.

Grenzen und Zusammenhänge

Einfarbige beziehungsweise vollständig leere Ergebnisse können Photoshop-Trims scheitern lassen; der gelesene Zweig fängt Trim-Ausnahmen ab. Ein erfolgloser Trim ist daher nicht automatisch ein Beleg, dass der Schalter ausgeschaltet war. Eine reduzierte Boundingbox beweist außerdem nicht, ob Pfadtrim, Transparenztrim oder Weißtrim die Ursache war.

Flatten kann Alpha beim Speichern entfernen. Die PNG-Transparenzoption kann vorhandenes Alpha zulassen, aber keine abgeschnittene Fläche zurückholen. Für Weißrand siehe WB-16, für Canvas WB-18.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, PDF-S. 15 und 40–41. IC/Form1.cs 1034–1036, 4443–4453, 4481–4489; Quellstand. Historisch docs/ABSCHLUSS_MINITEST_31.08.2026.md, docs/ERGEBNIS_FEHLER_RETEST_BUILD_20261009.md. Kein neuer Programmlauf.

Feldanker: transparentBeschneiden. Anleitung: Freistellung und Transparenz · Web.