Zum Inhalt

WB-13 – Pfadbeschneidung für Kunden komplett abschalten

Was macht die Funktion?

trim: "no" verhindert, dass ImageConvert einen Dokumentpfad für die reguläre Webfreistellung auswählt. Das ist eine Pfadregel, kein universeller Schutz der Quellfläche. Weißtrim, Transparenztrim, Koordinaten-Crop und spätere Flächenänderungen sind getrennte Mechanismen.

Wo wird sie konfiguriert?

Kunden-JSON: webOptions.switches.trim, Typ String. Erlaubte Werte sind clipping, onlyOnePath, no. Der Source sucht bei no keinen echten Clipping-Pfad und aktiviert auch nicht den Ein-Pfad-Ersatz.

Weiterer Mechanismus Warum trim: "no" allein nicht genügt
useWeissBeschneiden Weißscript wird im gelesenen Webablauf separat aufgerufen
transparentBeschneiden Transparenztrim existiert auch im Zweig ohne ausgewählten Pfad
.crop Expliziter Koordinatenbeschnitt mit eigener Reichweite
canvas, specialSize Können Außenmaße unabhängig von Pfadwahl ändern

Konfigurieren und Beispiel

  1. Setze trim auf den String no, nicht auf Boolean false.
  2. Entscheide getrennt, ob Weiß- und Transparenztrim weiterhin gewünscht sind.
  3. Soll die vollständige Quellfläche erhalten bleiben, prüfe zusätzlich noTrim/nocrop, vorhandene Cropaufträge und Größen-/Canvasregeln.
  4. Kontrolliere am Ergebnis die Motivlage relativ zur gesamten Fläche. Ein noch vorhandener Pfadname beweist weder Beschnitt noch Nichtbeschnitt.

Fragment der Kunden-JSON, das ausdrücklich alle drei aufgeführten Beschneidungsoptionen abschaltet, statt nur die Pfadwahl:

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

Beispiel: Ein freigestelltes Produkt soll mit seinem großzügigen transparenten Quellrand geliefert werden. trim: "no" allein könnte den transparenten Rand trotzdem verlieren lassen. Deshalb die separaten Trimschalter und das lokale noTrim prüfen; für ein transparentes Ausgabeformat zusätzlich die Exportoptionen beachten. Auch diese Kombination annulliert keinen ausdrücklich eingereichten .crop-Auftrag.

Grenzen und Zusammenhänge

Das Handbuch kommentiert no verkürzt als „gar nicht beschneiden“. Der gelesene Code stützt eng die ausgeschaltete Pfadsuche, nicht diese unbegrenzte Wirkung. Bei widersprüchlichen globalen/lokalen Einstellungen ist der tatsächliche Lieferstand entscheidend; WB-14 beschreibt einen konkreten Readerkonflikt. Kein allgemeiner aktueller Laufnachweis wird daraus abgeleitet.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, PDF-S. 15, 27, 40–42. Statisch IC/Form1.cs 1006–1014, 3730–3753, 4321–4327, 4481–4489; Quellstand. Kein neuer Lauf.

Feldanker: trim. Weiter: Transparenz · Weißtrim · Crop · Bedienanleitung · Web.