This is a short guid of how to use assetstreamer.aspx
Instructions
When you want to stream qualities, use this:
- [DAMURL]/Dmm3BWSV3/AssetStream.aspx?assetID=[AssetId]&mediaformatid=[MediaFormatId]&destinationid=[DestinationId]&accesskey=[AccessKey]
Where:
- [DAMURL] is the URL of the DAM Center (remember http/https)
- [AssetId] is the assetId you want to stream
- [MediaFormatId] is the formatId of the quality you want to download
- [DestinationId] is the destination (child if using SM)
- [AccessKey] is a valid accesskey generated (e.g. from user/password through the API (Connect-service))
This only applies to qualities of an asset you have R access to and that are actual qualities on the Frontend.Data destination(s).
To download an assets source file, use this:
Notice
The below resizing is working only in 5.6 and also subject to change in near future (Q3-Q4 in 2022)
PLEASE be aware of using on demand resizing with too large files. If you have larger files for resize and crop then use specific pre-generated media formats instead.
Do you need dynamic or on-demand resize?
We have a solution for you which must be used together with a CDN.
Please contact Digizuite for getting the resize URL but here follows a explanation:
To add resizing then you can add the following
- 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)
- Mandatory
- Example (NOT THE DAM URL):
**Resize can be combined with a crop of the resized image. You can add either x+y coordinates with cH and cW or you can do gravity + cH and cW.
Where:
- [DAMURL] is the URL of the DAM Center (remember http/https)
- [AssetId] is the assetId you want to stream
- [AccessKey] is a valid accesskey generated (e.g. from user/password through the API (Connect-service))
Note: static parameter AssetOutputIdent=44 - no not change/alter
Related articles