WB-18 – Arbeitsfläche global oder je Ausgang prozentual vergrößern und ausrichten¶

Was macht die Funktion?¶

Canvas erweitert die Arbeitsfläche um das Motiv. Es streckt nicht einfach die Motivpixel und ist kein automatischer Beschnitt. Globale Einstellungen und lokale Ausgangseinstellungen sitzen im gelesenen Ablauf an unterschiedlichen Stellen; sie sind nicht pauschal ein überschreibbarer Einheitswert.

Wo wird sie konfiguriert?¶

Kunden-JSON: global imageDefaults.canvas, lokal mainFolder.web.subFolder[].canvas.

Feld im jeweiligen Canvasobjekt	Typ / belegte Werte	Bedeutung
`widthPercent`	Zahl; 0 ohne zusätzliche Breite, positive Angabe für Erweiterung	Gesamte zusätzliche Breite in Prozent der aktuellen Vorlage, nicht Prozent je Rand
`heightPercent`	Zahl entsprechend	Gesamte zusätzliche Höhe
`horizontalAlignment`	String `Left`, `Cntr`, `Rght`	Verankerung des vorhandenen Motivs
`verticalAlignment`	String `Top`, `Cntr`, `Bttm`	Vertikale Verankerung

Ein allgemeiner Maximalbereich ist hier nicht belegt. Negative Werte nicht als dokumentierten Verkleinerungsmodus anbieten. Bei Left bleibt das Motiv links und neuer Raum entsteht rechts; bei Top entsteht er unten. Cntr verteilt den Raum auf beide gegenüberliegenden Seiten.

Konfigurieren und Beispiel¶

Entscheide, ob du eine globale Schattenvorlage oder einen lokalen Rand an einem konkreten Ausgang ändern willst.
Setze am betreffenden Objekt die beiden Prozentwerte und beide Ausrichtungen ausdrücklich.
Prüfe specialSize: fixed/square können danach erneut die Außenfläche festlegen.
Kontrolliere Motivgröße, Rand und Außenmaße getrennt. Finale Maße allein beweisen nicht, dass die gewünschte Canvasphase stattfand.

Fragment eines vorhandenen Ausgangsobjekts, keine Defaultwerte:

{
  "canvas": {
    "widthPercent": 10,
    "heightPercent": 10,
    "horizontalAlignment": "Cntr",
    "verticalAlignment": "Cntr"
  }
}

Das Beispiel fordert eine Erweiterung der jeweiligen Gesamtachse um 10 Prozent an, mittig verteilt. Es bedeutet nicht zehn Prozent auf jeder Seite. Für feste Außenmaße nutze die Größenregel fixed, statt beide Mechanismen ungeprüft zu kombinieren.

Ablauf und Grenzen¶

Der gelesene Source erweitert die globale Canvasfläche nach Pfadfreistellung nur im aktiven Schattenzweig. Ohne Schattenaktivität ist damit kein unabhängiger globaler Rand nachgewiesen. Die lokalen Canvaswerte werden separat initialisiert und gelesen; im regulären Ausgangszweig wird nach Größenanpassung erweitert. Danach folgen square/fixed-Flächenregeln. Deshalb kann lokaler Canvas zusätzlich zur bereits veränderten globalen Vorlage wirken; nicht pauschal als vollständigen Override beschreiben.

Ein Border-Modus für überall gleich breite Ränder ist nicht implementiert belegt. border, keepborders, greater, smaller, width, height werden nicht als verfügbare Canvasoptionen angeboten. Die Füllung hängt unter anderem von Dokument-/Hintergrundzustand und Speicherformat ab; eine frei wählbare Canvasfarbe wird durch diese vier Felder nicht festgelegt.

Verifizierter Projektstand¶

Am 08.09.2026 blieb ein konkret geladener lokaler Override wirkungslos. Dieser historische Fehler ist kein heutiger allgemeiner Ausfallnachweis. Ein Fall vom 07.10.2026 zeigte Canvaswirkung, aber nach unerwünschtem Trim. Die noTrim-Korrektur zu Build 20261009 belegte den konkret geprüften lokalen Randfall positiv. Eine komplette globale/lokale Ausrichtungsserie wurde damit nicht nachgewiesen.

Einzelziel-Crop blieb am 07.10.2026 trotz Canvasoption unvergrößert; die Interaktion bleibt begrenzt offen: WB-17. Dokumentierte Abschaltung über nocanvas nicht ohne Lieferstandprüfung als universell wirksam annehmen.

Quellen und Einordnung¶

ImageConvert-4.pdf, 09.10.2026, PDF-S. 22, 25, 40 und 69–70. IC/Form1.cs 797–833, 1052–1053, 1160–1171, 4463–4477, 4625–4632, 4664–4722; Quellstand. Historisch test-runs/diagnostic-retests/RUN_LOG.md, A3/A4; docs/ABSCHLUSS_MINITEST_WIEDERHOLUNG_20261007.md; docs/ERGEBNIS_FEHLER_RETEST_BUILD_20261009.md. Kein neuer Lauf.

Feldanker global: Breite · Höhe · horizontal · vertikal.

Feldanker lokal: Breite · Höhe · horizontal · vertikal.

Weiter: Schatten · Anleitung · Web.