Skip to content

CloudinaryTransformResources - Cloudinary

← Cloudinary Add-On Übersicht

This step downloads your resources and transforms them on request.


Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

NameDatentypBeschreibungPflichtfeldWerte
accountACCOUNTJa
limitSTRINGThe maximal number of files/rows tro process.Nein
public_idsSTRINGAn comma separated list of Public IDs of assets uploaded to Cloudinary. Can be empty if a spreadsheet with public_ids is given. Global set parameters will be ignored if a public_id has custom settings in this spreadsheet.Nein
transformationsSPREADSHEETOptional. Spreadsheet to set parameters per public_id. Global set parameters will be ignored if a public_id has custom settings in this spreadsheet.Nein
mappingdefinitionSTRINGThe mapping definition JSON StringNein
Folgende Felder sind zu konfigurieren:

FeldDatentypBeschreibungPflichtfeldStandardwert
public_idSINGLEThe name of the file. Has to be present in the input filelist. Otherwise the corresponding row will be ignored.Ja
asset_folderSINGLEThe folder where the asset is placed within the Cloudinary repository.Nein
contextSINGLEA pipe-separated list of the key-value pairs of contextual metadata to attach to an uploaded asset. The context values of uploaded files can be retrieved using the Admin API. For example: alt=My image❘caption=Profile imageNein
metadataSINGLEA pipe-separated list of custom metadata fields (by external\_id) and the values to assign to each of them. For example: in_stock_id=50❘color_id=[\"green\",\"red\"].Nein
crop_modeSINGLEIf the requested dimensions have a different aspect ratio than the original, these modes crop out part of the image.Nein
resize_modeSINGLEThese modes adjust the size of the delivered image without cropping out any elements of the original image.Nein
gravity_modeSINGLEWhen used with cropping modes that crop out part of an image, the gravity qualifier specifies which part of the original image to keep when one or both of the requested dimensions is smaller than the original.Nein
qualitySINGLECloudinary's intelligent quality and encoding algorithm analyzes an image to find the best quality compression level and optimal encoding settings based on the image content and the viewing browser, in order to produce an image with good visual quality while minimizing the file size. Cloudinary automates the file size versus quality trade-off decision, on the fly using perceptual metrics and heuristics that tune the quality settings based on the specific image content and format. Analyzing every image individually to find the optimal compression level and image encoding settings allows for precise adjustment of the compression level complemented by fine tuning of the encoding settings, and can significantly reduce the file size without any degradation noticeable to the human eye.Nein
widthSINGLEYou can set the target dimensions of your resized image by specifying width, height, and/or the target aspect ratio as qualifiers of your resize transformation. Using an integer value for w (width) or h (height) sets the new dimension to that number in pixels. For example, w_150 sets the width to exactly 150 pixels. Using a decimal value for width or height sets the new dimension relative to the original dimension. For example, w_0.5 sets the width to half the original width.Nein
heightSINGLENein
aspect_ratioSINGLEAspect ratios are specified as follows: -a:b where a signifies the relative width and b the relative height (e.g., ar_4:3 or ar_16:9). -a decimal value representing the ratio of the width divided by the height (e.g., ar_1.33 or ar_2.5). 1.0 is a perfect square. Nein
opacitySINGLEAdjust the opacity of an image using the opacity transformation. Specify a value between 0 and 100, representing the percentage of transparency, where 100 means completely opaque and 0 is completely transparent.Nein
content_aware_paddingSINGLEYou can automatically set the background color to the most prominent color in the image when applying one of the padding crop modes (pad, lpad, or mpad) by setting the background parameter to auto. For more parameters (gradient, color number, direction) visit the documentation at: https://cloudinary.com/documentation/transformation_reference#b_autoNein
background_colorSINGLEUse the background parameter to set the background color of the image. The image background is visible when padding is added with one of the padding crop modes, when rounding corners, when adding overlays, and with semi-transparent PNGs and GIFs. An opaque color can be set as an RGB hex triplet (e.g., b_rgb:3e2222), a 3-digit RGB hex (e.g., b_rgb:777) or a named color (e.g., b_green). Cloudinary's client libraries also support a # shortcut for RGB (e.g., setting background to #3e2222 which is then translated to rgb:3e2222). You can also use a 4-digit or 8-digit RGBA hex quadruplet for the background color, where the 4th hex value represents the alpha (opacity) value (e.g., co_rgb:3e222240 results in 25% opacity).Nein
bordersSINGLEAdd a solid border around images with the border parameter. The parameter accepts a value with a CSS-like format: width_style_color (e.g., 3px_solid_black). An opaque color can be set as an RGB hex triplet (e.g., rgb:3e2222), a 3-digit RGB hex (e.g., rgb:777) or a named color (e.g., green). You can also use a 4-digit or 8-digit RGBA hex quadruplet for the color, where the 4th hex value represents the alpha (opacity) value (e.g., co_rgb:3e222240 results in 25% opacity). Additionally, Cloudinary's client libraries also support a # shortcut for RGB (e.g., setting color to #3e2222 which is then translated to rgb:3e2222), and when using Cloudinary's client libraries, you can optionally set the border values programmatically instead of as a single string (e.g., :border => { :width => 4, :color => 'black' }). For more options visit: https://cloudinary.com/documentation/transformation_reference#bo_borderNein
artistic_filterSINGLEApply artistic filters to the image.Nein
advanced_filterSINGLESee respective reference for more options: cartoonify: https://cloudinary.com/documentation/transformation_reference#e_cartoonify pixelate: https://cloudinary.com/documentation/transformation_reference#e_pixelate sepia: https://cloudinary.com/documentation/transformation_reference#e_sepia vignette: https://cloudinary.com/documentation/transformation_reference#e_vignette Nein
target_formatSINGLETarget image format. Leave empty to retain original. If no valid extension is specified, source format will be used.Nein
custom_propertiesSINGLESet you own custom transformation operation. If set all other parameters will be ignored. For full transformation documentation visit: https://cloudinary.com/documentation/image_transformations Nein
transformation qualitySTRINGTarget transformation quality (auto modes or in percent).Nein
  • disabled
  • auto
  • best
  • good
  • eco
  • low
  • 100
  • 80
  • 50
  • 35
  • 20
transformation widthSTRINGTarget transformation width (in pixels). Select default to keep original width.Nein
  • default
  • 1000
  • 500
  • 250
  • 150
  • 100
  • 50
  • 30
transformation heightSTRINGTarget transformation height (in pixels). Select default to keep original height.Nein
  • default
  • 1000
  • 500
  • 250
  • 150
  • 100
  • 50
  • 30
transformation cropping modeSTRINGIf the requested dimensions have a different aspect ratio than the original, these modes crop out part of the image.Nein
  • none
  • fill
  • lfill
  • fill_pad
  • crop
  • thumb
transformation resize modeSTRINGThese modes adjust the size of the delivered image without cropping out any elements of the original image. If resize mode is selected, the crop mode will be ignored.Nein
  • none
  • scale
  • fit
  • limit
  • mfit
  • pad
  • lpad
  • mpad
transformation gravity modeSTRINGWhen used with cropping modes that crop out part of an image, the gravity qualifier specifies which part of the original image to keep when one or both of the requested dimensions is smaller than the original.Nein
  • none
  • auto
  • face
  • center
  • north_east
  • north
  • north_west
  • west
  • south_west
  • south
  • south_east
  • east
transformation custom propertiesSTRINGWith this parameter custom transformation properties can be set. All other transformation properties are ignored if this parameter is set. For more information visit this cloudinary documentation at: <b>https://cloudinary.com/documentation/image_transformations</b>Nein
transformation target formatSTRINGTarget image format. Select default to retain original.Nein
  • default
  • auto select
  • BMP
  • GIF
  • HEIF
  • JPEG
  • JPEG 2000
  • JPEG XR
  • PNG
  • SVG
  • TIFF
  • WebP

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

NameDatentypBeschreibungWerte
resultSPREADSHEETThe result spreadsheet containing the processing parameters and file uris.
failedSPREADSHEETThe spreadsheet containing the failed requests.
Folgende Felder sind im Output enthalten:

FeldDatentypBeschreibungStandardwert
public_idSINGLE
asset_idSINGLE
filenameSINGLE
versionSINGLE
version_idSINGLE
signatureSINGLE
widthSINGLE
heightSINGLE
formatSINGLE
target_formatSINGLE
resource_typeSINGLE
created_atSINGLE
tagsSINGLE
bytesSINGLE
typeSINGLE
etagSINGLE
placeholderSINGLE
urlSINGLE
folderSINGLE
overwrittenSINGLE
error_messageSINGLE
result filelistFILELISTList containing all processed files.