Zum Inhalt

WB-12 – Bei genau einem Nicht-Arbeitspfad auch ohne Clipping-Flag beschneiden

Was macht die Funktion?

onlyOnePath erweitert die normale Clipping-Pfadsuche: Wenn kein echter Beschneidungspfad gefunden wurde, darf auch der einzige vorhandene Pfad verwendet werden, sofern er kein Arbeitspfad ist. Der Modus bedeutet nicht „bei mehreren Pfaden einen davon auswählen“ und schließt echte Clipping-Pfade nicht aus.

Wo wird sie konfiguriert?

Kunden-JSON: webOptions.switches.trim, Typ String, Wert onlyOnePath. Weitere zulässige Werte: clipping, no.

Quellzustand Erwartung aus dem gelesenen Auswahlzweig
Echter Clipping-Pfad vorhanden Ersten gefundenen Clipping-Pfad benutzen
Kein Clipping-Pfad, genau ein gespeicherter Nicht-Arbeitspfad Diesen Pfad als Ersatz verwenden
Nur ein Arbeitspfad (psWorkPath) Nicht als Ersatz zulassen
Mehrere normale Pfade, kein Clipping-Pfad Keinen davon willkürlich auswählen

Der lokale Reader initialisiert trim mit onlyOnePath, bevor er das vorhandene Feld liest. Das ist ein belegter Source-Default, kein Grund, die gewünschte Regel in einer Kundenkonfiguration unklar zu lassen.

Konfigurieren und Beispiel

  1. Prüfe in Photoshop Anzahl und Typ der Dokumentpfade. Ein Pfad muss dauerhaft gespeichert sein; bloßes Vorhandensein eines Arbeitspfads genügt nicht.
  2. Trage den Modus ausdrücklich ein. Kunden-JSON-Fragment, keine Defaults:
{
  "webOptions": {
    "switches": {
      "trim": "onlyOnePath",
      "transparentBeschneiden": true,
      "useWeissBeschneiden": false
    }
  }
}
  1. Prüfe noTrim/nocrop, die den nutzbaren Webzweig beeinflussen.
  2. Vergleiche das Ergebnis mit der tatsächlichen Pfadkontur, nicht nur mit der ursprünglichen rechteckigen Bildfläche.

Beispiel: Ein TIFF enthält einen einzigen gespeicherten Freistellpfad, aber kein Clipping-Flag. Nach der Pfadfreistellung löscht der Webzweig außen liegende Pixel; mit transparentBeschneiden: true verkleinert er anschließend die Fläche. Dieselbe Einstellung macht einen alleinigen Arbeitspfad nicht zum gültigen Positivfall.

Verifizierter Projektstand und Grenzen

Der Abschluss-Minitest vom 31.08.2026 bestätigte einen engen Webbeschnitt für 1Pfad.tif, nicht aber dieselbe Behandlung für Arbeitspfad.tif. Auch der echte Clipping-Fall wurde plausibel verarbeitet. Das ist keine Aussage, dass jedes Ein-Pfad-Dokument oder jede Kombination mit lokalen/globalen Schaltern heute geprüft ist. Print blieb im damaligen regulären Variantenblock unbeschnitten; die Crop-Ausnahme bleibt getrennt.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, PDF-S. 15, 40–41 und 68 (FAQ). IC/Form1.cs 1006–1014, 3730–3753, 4437–4448; Quellstand. Historisch docs/ABSCHLUSS_MINITEST_31.08.2026.md. Kein neuer Lauf.

Feldanker: trim. Weiter: Transparenztrim · Bedienanleitung · Web.