SZ-04 – Feste Webabmessungen mit Leerraum erzeugen¶
specialSize: "fixed" ist das dokumentierte Webrezept für festgelegte Außenmaße ohne verzerrtes Motiv. Das Bild wird proportional eingepasst und die verbleibende Fläche mit Leerraum ergänzt. Das ist kein Ausschnitt, der das Motiv auf das gewünschte Seitenverhältnis beschneidet.
Konfigurationsort und Werte¶
Kunden-JSON: vorhandenes Objekt unter mainFolder.web.subFolder[].
| Feld | Wert im Rezept | Bedeutung |
|---|---|---|
widthPx |
positive Pixelzahl | gewünschte Außenbreite |
heightPx |
positive Pixelzahl | gewünschte Außenhöhe |
specialSize |
"fixed" |
feste Arbeitsfläche statt nur Maximalrahmen |
mindestens |
für dieses Rezept false |
nicht gleichzeitig Mindestgrößenmodus verlangen |
Die Maße sind gewählte Zielvorgaben, keine Standards. Ein transparenter Rand ist nicht allein durch fixed garantiert; Format, Dokumentzustand und Hintergrundbearbeitung spielen mit.
Vorgehen und passendes Beispiel¶
- Wähle einen bestehenden aktiven Webausgang. Ergänze keinen neuen Listeneintrag anstelle der vorgeschriebenen Standardziele.
- Setze beide Zielmaße positiv und ausdrücklich
specialSize: "fixed". - Prüfe Quelllimit, Canvas sowie Aktionen/Skripte. Vermeide widersprechende Zusatzanforderungen.
- Übernimm die Änderung nach Konfiguration bearbeiten. Prüfe beide Außenmaße, unverzerrten Inhalt und den ergänzten Rand.
Fragment im vorhandenen Webausgang, kein vollständiger Kunde und kein Default:
Anders als ein reines "no"-/"square"-Beispiel enthält dieses Fragment tatsächlich den entscheidenden Wert "fixed".
Print ist ein eigener Zweig¶
Nicht allein aus dem gleichnamigen Printfeld dieselbe Webwirkung ableiten. Der gelesene Source enthält allerdings in DruckBildSpeichern für Print 1/3/4 ebenfalls einen fixed-Aufruf von ResizeCanvas. Deshalb wäre auch die pauschale Aussage „fixed bleibt bei Print immer proportional“ falsch. Print 2 besitzt einen separaten JPEG-Speicherweg. Diese Seite empfiehlt nur das oben belegte Webrezept, keine slotübergreifende Printgarantie.
Versionsgrenze¶
Ein Projektbefund vom 08.09.2026 meldete fehlenden fixed-Canvas am damals geprüften Webausgang. Die Hersteller-History nennt am 10.09.2026 ausdrücklich die bis dahin fehlende Implementierung. Der Source vom 13.10.2026 enthält den Web-Canvaszweig. Der alte Fehler ist deshalb kein Beleg für einen heutigen Fehler; umgekehrt beweist Sourcelektüre keine installierte Fehlerfreiheit.
Felder: Web-specialSize, Breite, Höhe; zum Vergleich Print-specialSize, Printbreite, Printhöhe. Weiter: square, Quelllimit, Arbeitsfläche, Größenanleitung.
Quellen¶
ImageConvert-4.pdf, 09.10.2026, PDF-S. 21 (gedruckt 17), FAQ PDF-S. 69 und History PDF-S. 73, Eintrag 10.09.2026. Statischer Intake IC/Form1.cs, compiledate 20261013: 2591–2598 (Print), 4597–4607 und 4719–4722 (Web), 4205–4221 (Print 2).