Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Please contact Digizuite for getting the resize URL. When you have this URL then you can manipulate your images in the following way (docs also here: How to use assetstreamer (stream qualities / download source file) ):

  • These parameters can be added to the above:

    • Mandatory

      • function=resize

      • mimeType: The format to store image in such as image/jpeg or image/png

      • destinationid must aslo be present always

    • Optional for resize:

      • Height: New height of image as number (or when used with x, y or gravity then it becomes the height around the focal point)

      • Width: New width of image as number (or when used with x, y or gravity then it becomes the width around the focal point)

      • aspectType: Scale image acording formula: aspectType=0 Dont hold ascpec, aspectType=1 Hold height scrink width, aspectType=2 hold width scrink height, aspectType=3 in box

      • quality: Quality of the image in a value between 0 and 100 (The quality setting applies only to the JPEG encoder. PNG and BMP are both lossless, meaning that there's no quality/space trade-off to be made)

      • force: if this is true then it will always recalculate so only use this when needing to update the underlying asset to ensure newest version (do not use on all requests)

      • lastUpdated: Timestamp (just in miliseconds) of when the asset was last updated in the DAM (this is important for CDN since each URL is unique). This is often received from the DAM or if push-based integration then it is the last update you received.

    • Focal Point (optional)**

      • x: Offset for the x coordinate (in pixels)

      • y: Offset for y coordinate (in pixels)

      • gravity: Specific placement of gravity (overrules x and y). Read more: https://www.google.com/search?q=ImageMagick.Gravity

        • Northwest, North, Northeast, West, Center, East, Southwest, South, Southeast

      • cH: Crop height in pixels (must be used with either x,y or gravity)

      • cW: Crop width in pixels (must be used with either x,y or gravity)

  •  Example (NOT THE DAM URL):

    • [DAM_RESIZE_URL]/Dmm3BWSV3/AssetStream.aspx?assetID=[AssetId]&mediaformatid=[MediaFormatId]&destinationid=[DestinationId]&accesskey=[AccessKey]&function=resize&width=[Width]&height=[Height]&quality=[Quality]&mimetype=[MimeType]&aspecttype=[AspectType]&force=false&lastUpdated=[LastUpdated]

Functional Approach

The above approach can also be mapped to a functional approach. Query parameters are then instead an integrated segment in URL (as know from cloudflare and others)

  • Important changes are

    • We have added filename.extension to the URL to control filename in the Content-Disposition header in the response

    • mimeType is no longer applicable, and the type is controlled by the extension of the filename provided. 

    • The query parameters are now a segment after /assets/ and before /filename.extension where the parameters are comma separated.

  • Example: [DAM_RESIZE_URL]/assets/assetID=[AssetId],mediaformatid=[MediaFormatId],destinationid=[DestinationId],width=[Width],height=[Height],quality=[Quality],aspecttype=[AspectType],timestamp=[LastUpdated]/filename.extension

Configuring it in Azure

1- Create Azure Function in a customer Azure Portal. Give it a name, select the below and ensure that region is corresponding to the one of the customer.

...