Digizuiteā¢ Dynamic Image Resize
Do you need dynamic or on-demand resize?
We have a solution for you which mustĀ be used together with a CDN.Ā
So what is described here must act as an origin to a CDN for it to not be to costly. The CDN must be caching all unique URLs.
How it works
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.
2- Send the Publishing Profile to R&D
Ā
3- When R&D have deployed to your azure function, then you must create a CDN (Microsoft CDN). You already have the Azure Function web app which must be the origin.
Important is to receive your Client ID from R&D and add this as Origin Path /api/integrations/resize/{client_id}
Create the Origin like this an ensure Origin Type as āWeb Appā.
Configure Origin path like this:
4- Ensure that Caching is correct. It must Cache every unique URL and then
And then also ensure that it caches for at least 60 days if nothing else has been stated:
Ā
5- Now start to use (following the details in How it works). Simply take the āEndpoint hostnameā and start to use it.
Ā