...
Parameter
| Asset-Typ | Bedeutung | Optional | Default | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
id | alle | Die ID des herunter zu ladenden Assets. Die ID ist ein BASE64 codierter String, der die UUID sowie die Version des gewünschten Assets enthält. Diese ID kann als Eindeutigkeitsmerkmal für das Caching verwendet werden. (Ist die ID gleich, hat sich am Assets und seinen Metadaten inkl. Bereichen nichts verändert.) Beispiel für die Asset-ID: url-codierte id: MGM3ZjA1MzItNjU3NS00ZGUxLWI1Y2EtZjU0YTgwNmJiODVlOzEuMA%3D%3D entspricht: MGM3ZjA1MzItNjU3NS00ZGUxLWI1Y2EtZjU0YTgwNmJiODVlOzEuMA== decodiert: 0c7f0532-6575-4de1-b5ca-f54a806bb85e;1.0 | nein | - | ||||||
fillIptc
| nur Bilder | Wenn "true" werden die am Asset hinterlegten Metadaten vor dem Download in die IPTC Metadaten des Bildes aufgenommen.
| ja | false | ||||||
width height | nur Bilder | Zielhöhe / -breite des Ausschnitts in Pixel. Wird nur ein Wert (Höhe oder Breite) angegeben, wird der ausgelassene Wert proportional berechnet. Werden beide Werte angegeben, wird der Ausschnitt in der vorgegebenen Größe aus der Mitte des Bildes heraus gebildet.
| ja | 0 | ||||||
cropmode
| nur Bilder | Legt fest, ob (bei am Asset vorhandenen Bildbereichen) der Ausschnitt möglichst nah am relevanten Bereich sein soll, oder ob möglichst viel vom eigentlichen Bild gezeigt werden soll. Siehe Presetkonfiguration (image-processing.crop-presets).
| ja | enclose | ||||||
preset | nur Bilder | Liefert das Asset (sofern es ein Bild ist) in der in der Presetkonfiguration (image-processing.crop-presets) hinterlegten Werten zurück. Je Preset kann die Höhe, Breite, JPEG Qualität und der CropMode bestimmt werden. Die Preset-Werte des CropMode und der Qualität können in der URL übersteuert werden. Wird ein Preset angefordert, welches nicht in der Konfiguration existiert, wird entweder das Default-Preset (sofern hinterlegt) oder das original Asset ausgeliefert.
| ja | - | ||||||
| original | nur Bilder | true | false true → das Bild wird nicht beschnitten sondern im "original" (gegebenfalls größenreduziert) bereit gestellt. Je nach Konfiguration bzw zusätzlicher Parameter (max-pixels) wird die Bildgröße auf eine maximale Pixelanzahl beschränkt | ja | false | ||||||
| max-pixels | nur Bilder | wird nur ausgewertet, falls original = true beschränkt die Anzahl der Pixel des zur Verfügung gestellten Bildes (Einheit: Pixel) übersteuert einen ggf. konfigurierten Standardwert für maximalen Pixel | ja | - |
URL-Parameter für Asset-Previews
| Parameter | Asset-Typ | Bedeutung | Optional | Default |
|---|---|---|---|---|
| id | alle | Die ID des herunter zu ladenden Assets. vergleiche Download-Parameter id | nein | - |
| preset | nur Bilder | Liefert das Asset (sofern es ein Bild ist) in der in der Presetkonfiguration (image-processing.crop-presets) hinterlegten Werten zurück. vergleiche Download-Parameter preset | ja | - |
| size | nur Bilder | Zielhöhe / -breite des Ausschnitts in Pixel. Der Ausschnitt wird in der vorgegebenen Größe aus der Mitte des Bildes heraus gebildet. vergleiche Download-Parameter width-height | ja | 0 |
| width height | nur Bilder | Zielhöhe / -breite des Ausschnitts in Pixel. Wird nur ein Wert (Höhe oder Breite) angegeben, wird der ausgelassene Wert proportional berechnet. Werden beide Werte angegeben, wird der Ausschnitt in der vorgegebenen Größe aus der Mitte des Bildes heraus gebildet. |
vergleiche Download-Parameter width-height | ja | 0 |
| draw-selection | nur Bilder | Zeichnet den relevanten und nicht-relevanten Bildbereich in das Vorschaubild. |
| ja | false |
| draw-selection-rasterized | nur Bilder | Ist die Option draw-selection aktiv, kann hiermit ein rasterisiertes Vorschaubild mit den relevanten und nicht-relevanten Bildbereichen erzeugt werden. |
| ja | false | ||
| manipulations | nur Bilder | JSON-serialisierter String mit Befehlen (Commands) zur Bildmanipulation - z.B. Rotation eines Bildes. | ja | - |
Statische & Default Asset-Presets
Folgende Presets liefert HUP als Standard mit dem PS.Content System aus.
| Name | Default | Beschreibung | Anmerkung |
|---|---|---|---|
vector | Liefert SVG und PDF Dateien im Originalformat aus. | Wird das Preset auf ein nicht-Vektor Asset angewendet, greift das Default Preset. | |
favicon | JPEG 32x32, 100% | ||
extrasmall4x3 | JPEG 320x240, 75% | ||
small4x3 | JPEG 640x480, 75% | ||
medium4x3 | JPEG 800x600, 75% | ||
large4x3 | JPEG 1600x1200, 75% | ||
extrasmall16x9 | JPEG 320x180, 75% | ||
small16x9 | JPEG 640x360, 75% | ||
medium16x9 | JPEG 800x450, 75% | ||
large16x9 | JPEG 1600x900, 75% | ||
teaser | JPEG 400x320, 75% | Ausschnitt nah am relevanten Bereich. | |
teaser-expand | JPEG 400x320, 75% | Ausschnitt zeigt möglichst viel Bild. | |
thumbnail | JPEG 100px Breit, 75% | ||
fullhd |  | JPEG 1920px Breit, 75% | |
| width### | JPEG ###px Breit, 75% | ### = 200, 400, 600, 800, 1000, 1200 | |
| height### | JPEG ###px Hoch, 75% | ### = 200, 400, 600, 800, 1000, 1200 | |
| square### | JPEG ###px Quadratisch zugeschnitten, 75% | ### = 200, 400, 600, 800, 1000, 1200 |
Handhabung von Bildbereichen am Asset
...
| Erweitern | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
Folgendes Bild dient als Beispiel. In jedem Falle soll das Schild im grünen Rechteck zu sehen sein. Nicht zu sehen sein soll alles außerhalb des roten Rechtecks.
Beispiele für Aufrufe des Download-Service:
|
Ist kein Bereich am Asset gespeichert, wird das Bild wie für Web-Browser üblich aus der Mitte heraus auf "möglichst viel Bild" beschnitten.
...