Unterstützte Vorgänge

In diesem Abschnitt werden die von der Cloud CDN-Bildoptimierung unterstützten Vorgänge aufgeführt. Die Tabelle enthält Parameter wie Vorgang, Syntax, Attribute, Beschreibung und Beispiele, die Ihnen bei der Erstellung Ihrer imop-Abfrage helfen.

Die Cloud CDN-Bildoptimierung unterstützt eine Reihe von Vorgängen, mit denen Sie Ihre Bilder transformieren können, z. B. Größe anpassen, zuschneiden und skalieren. Jeder Vorgang hat eine eigene Syntax, unterstützte Attribute und Einschränkungen.

Auf dieser Seite werden die von der Cloud CDN-Bildoptimierung unterstützten Vorgänge mit Beispielen aufgeführt, die Ihnen bei der Erstellung Ihrer imop-Abfrage helfen.

Vorgang Syntax und Beispiel Attribute Beschreibung

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125
  • width-Typ: Ganzzahl (Bereich: 1–8192)
  • height-Typ: Ganzzahl (Bereich: 1–8192)

Die maximale width * height darf 67 MP (67.108.864 Pixel) nicht überschreiten.

  • Skalierung (optional) Typ: Enum, Werte: proportional, stretch.
    		•

    Bei diesem Vorgang wird das Seitenverhältnis nicht beibehalten, wenn Sie sowohl die Parameter für Breite als auch für Höhe angeben. Wenn Sie eine der Dimensionen weglassen, berechnet die Cloud CDN-Bildoptimierung die andere, um das Seitenverhältnis beizubehalten.

    Standardmäßig erzwingt die Bildoptimierung eine strikte Strategie, bei der nur die Größe verringert wird. Wenn Sie den scaling=stretch Parameter angeben, wird die Vergrößerung aktiviert. Das System lässt dies jedoch nicht zu, wenn Sie nur einen Größenparameter angeben.

    Scale

    ?imop=Scale,ratio=<scale_ratio>

    https://www.example.com/image.jpg?imop=Scale,ratio=0.5

    		 ratio
    • Typ: Gleitkommazahl (auf 2 Dezimalstellen begrenzt)
    • Einschränkung: 0 < value

    Bei diesem Vorgang wird die Größe des Bildes um einen bestimmten Faktor geändert und nur die Verkleinerung erzwungen. Schließt die Vorgänge „Resize“ und „Crop“ gegenseitig aus.

    Wenn Sie den Vorgang Scale zusammen mit den Vorgängen Resize oder Crop in einer einzigen Anfrage verwenden, gibt das System einen Fehler zurück.

    Crop

    ?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

    https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

    		 shape
    • Typ: String (rectangle, circle)
    • Standardwert: rectangle
    • Abhängigkeit: Muss mit dem Parameter „crop“ verwendet werden. Ein ungültiger Wert gibt den HTTP-Fehler 400 zurück.
    left, right, top, bottom
    • Typ: Gleitkommazahl
    • Bereich: 0,0 bis 1,0, maximal 3 Dezimalstellen
    • Standardwert: 0,0, 1,0, 0,0, 1,0
    snap_to_x, snap_to_y
    • Typ: Ganzzahl
    • Bereich: 0 oder höher
    • Standardwert: 0
    • Einschränkung: Mindestens einer der folgenden Parameter muss angegeben werden: „left“, „right“, „top“, „bottom“.

    Bei diesem Vorgang wird das Bild anhand von regionalen Markierungen zugeschnitten. Wenn Sie einen ungültigen Wert für den shape Parameter angeben, gibt das System den HTTP 400 Bad Request zurück.

    Die Zuschneidekoordinaten werden automatisch auf das nächste Vielfache des angegebenen Werts snap_to_x oder snap_to_y ausgerichtet.

    Canvas

    ?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

    https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

    		 width, height
    • Typ: Ganzzahl
    • Bereich: 1–8192
    • Die maximale Breite × Höhe darf 67.108.864 Pixel nicht überschreiten.
    gravity
    • Typ: String
    • Werte: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
    • Standardwert: center
    background_color
    • Typ: String
    • Format: 3‑, 4‑ oder 6‑stellige Hex-Farbcodes
    • Standardwert: 000000 (Schwarz).

    Bei diesem Vorgang werden Bilder verbessert, indem ein Hintergrundlayout mit den angegebenen Abmessungen und der angegebenen Farbe hinzugefügt wird. Der gravity Parameter bestimmt die Platzierung des inneren Bildes auf diesem Hintergrund-Canvas.

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

    https://www.example.com/image.jpg?imop=Rotate,degrees=90

    		 degrees
    • Typ: Ganzzahl
    • Zulässige Werte: 90, 180, 270.

    Bei diesem Vorgang wird das Zielbild im Uhrzeigersinn gedreht.

    Mirror

    ?imop=Mirror,flip=<flip>

    https://www.example.com/image.jpg?imop=Mirror,flip=h

    		 flip
    • Typ: String
    • Zulässige Werte: h (horizontal), v (vertikal), hv (horizontal und vertikal).

    Bei diesem Vorgang wird das Bild entweder horizontal, vertikal oder beides gespiegelt.

    Compress

    ?imop=Compress,strength=<value>

    https://www.example.com/image.jpg?imop=Compress,strength=medium

    		 strength
    • Typ: String
    • Zulässige Werte: very_weak, weak, medium, strong, very_strong.
    • Einschränkung: Wird nur für JPEG, AVIF und WebP unterstützt. Werte außerhalb dieses Bereichs geben den HTTP-Fehler 400 zurück.

    Bei diesem Vorgang wird das Bild komprimiert, indem die Qualität des Zielbildes verringert wird. Mit dem Parameter strength können Sie den aktiven Bildkomprimierungsgrad steuern.

    Convert

    ?imop=Convert,format=<format>

    https://www.example.com/image.jpg?imop=Convert,format=webp

    		 format
    • Typ: String.
    • Zulässige Werte: jpeg, png, webp, avif, gif
    • Einschränkung: Jeder andere nicht aufgeführte Wert führt zu einem Verarbeitungsfehler.

    Bei diesem Vorgang wird das endgültige Bereitstellungsformat des Bildes geändert. Wenn es einen Verarbeitungskonflikt mit der eingehenden ACCEPT Header-Spezifikation des Browsers gibt, gibt das System einen HTTP 406 Not Acceptable Fehler zurück.

    Metadata

    ?imop=Metadata,preserve=<preserve>

    https://www.example.com/image.jpg?imop=Metadata,preserve=none

    		 preserve
    • Typ: String
    • Zulässige Werte: none, copyright, max
    • Standardwert: copyright

    Bei diesem Vorgang wird gesteuert, wie Bildmetadateneigenschaften während der Ausführung verarbeitet werden:

    none: Entfernt alle Metadateneigenschaften.

    max: Behält alle Felder mit Ausnahme der EXIF-Ausrichtung und der Farbprofile bei, die auf die Transformation angewendet werden .

    .

    copyright: Behält nur die Felder Author, Copyright, und Caption bei.

    Tone

    ?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

    https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50
    • brightness
      • Typ: Ganzzahl
      • Bereich: -100 bis 100
    • contrast
      • Typ: Ganzzahl
      • Bereich: -100 bis 100
    • saturation
      • Typ: Ganzzahl
      • Bereich: -100 bis 100

    Bei diesem Vorgang werden die Werte für brightness, contrast, und saturation eines Bildes dynamisch geändert. Wenn Sie einen bestimmten Parameter weglassen oder auf 0 setzen, ändert das System dieses Attribut nicht. Wenn Sie die Sättigung auf -100 setzen, wird die Graustufenkonvertierung erzwungen.

    Sharpen

    ?imop=Sharpen,strength=<sharpness>

    https://www.example.com/image.jpg?imop=Sharpen,strength=50

    		 strength
    • Typ: Ganzzahl
    • Bereich: 0 bis 100

    Bei diesem Vorgang wird die Schärfe des Bildes erhöht.

    Blur

    ?imop=Blur,strength=<blur_size>

    https://www.example.com/image.jpg?imop=Blur,strength=50

    		 strength
    • Typ: Ganzzahl
    • Bereich: 0 bis 100

    Bei diesem Vorgang wird ein lokaler Weichzeichnungsfilter auf das Bild angewendet.

    Freeze

    ?imop=freeze,frame=<frame>

    https://www.example.com/image.gif?imop=freeze,frame=0

    		 frame
    • Typ: Ganzzahl
    • Bereich: 0 bis 100.

    Bei diesem Vorgang wird ein einzelnes statisches Frame aus einer animierten Bildsequenz extrahiert, z. B. aus einem animierten GIF. Der Parameter „frame“ gibt den genauen Frame-Index an, der extrahiert werden soll.

    Nächste Schritte