Seitenvergleich

Inhalt

Der PS.Content Asset-Download Service ermöglicht es, Assets, die zB. in einem Artikel enthalten sind, herunter zu laden. Dabei können verschiedene Parameter übergeben werden, die steuern, wie das Asset vor dem Herunterladen bearbeitet werden soll.

...

Parameter

Asset-Typ

Bedeutung

Optional

Default

id

Anker

	{ID}
	{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.

Der Download des Assets wird dadurch minimal verlangsamt. (Die Metadaten werden on the fly geschrieben.)

Der zurück gegebene zurückgegebene Dateityp ist immer JPEG - egal, von welchem Typ das Asset vorher war.

ja

false

width

height

Anker

	{width-heigth}
	{width-heigth}

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.

Der Download des Assets wird unter Umständen minimal verlangsamt. (Liegt kein geeigneter Ausschnitt im Cache, wird der Ausschnitt on the Fly erzeugt.)

Der zurück gegebene zurückgegebene Dateityp ist immer JPEG - egal, von welchem Typ das Asset vorher war.

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).

Der Download des Assets wird unter Umständen minimal verlangsamt. (Liegt kein geeigneter Ausschnitt im Cache, wird der Ausschnitt on the Fly erzeugt.)

Der zurück gegebene zurückgegebene Dateityp ist immer JPEG - egal, von welchem Typ das Asset vorher war.

ja

enclose

preset

Anker

	{preset}
	{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.

Der Download des Assets wird unter Umständen minimal verlangsamt. (Liegt kein geeigneter Ausschnitt im Cache, wird der Ausschnitt on the Fly erzeugt.)

Der zurück gegebene zurückgegebene Dateityp ist immer JPEG - egal, von welchem Typ das Asset vorher war.

Folgende Presets liefert HUP aus: small4x3(320,240,75); medium4x3(800,600); large4x3(1600,1200); small16x9(320,180,75); medium16x9(800,450,75); large16x9(1600,900); teaser(400,320).

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
→ die Parameter width, height, cropmode und preset werden in diesem Modus nicht ausgewertet

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. Wird nur ausgewertet, wenn size nicht angegeben ist vergleiche Download-Parameter width-height	ja	0
draw-selection	nur Bilder	Zeichnet den relevanten und nicht-relevanten Bildbereich in das Vorschaubild. Der zurückgegebene Dateityp ist immer SVG - egal, von welchem Typ das Asset vorher war.	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. Der zurückgegebene Dateityp hängt vom Asset-Bildtyp ab.	ja	false
manipulations	nur Bilder	JSON-serialisierter String mit Befehlen (Commands) zur Bildmanipulation - z.B. Rotation eines Bildes.	ja	-

Handhabung von Bildbereichen am Asset

...

Versionen im Vergleich

Alte Version 8

Neue Version 9

Schlüssel

URL-Parameter für Asset-Previews

Handhabung von Bildbereichen am Asset