Renditions

Getting a rendition is done using the entity object (IEntity ). Not all entities support renditions, but for example M.Asset does.

The renditions can be accessed through the IEntity.Renditions property, which returns a list of IRendition objects. The rendition consists of the rendition's name and its rendition items. By default, an asset's renditions are named like this (but can be customized):

The number of rendition items (IRendition.Items) depends on the file and the rendition. An image could be processed to one or multiple items. For example, there could be an item per layer in the image. A PDF file can have a rendition item per page.

Entities that don't support renditions return an empty list of renditions.

Downloading renditions can be done through the IRendition and IRenditionItem objects. The rendition can be downloaded manually by using the Href property of the IRenditionItem object, but it also supports downloading directly to a specified filepath or as a stream.

In the following example, the first rendition item of the original file (named "downloadOriginal") is downloaded from the asset with the id 8626. The directory variable is the folder where the rendition will be saved.

var asset = await MClient.Entities.GetAsync(8626);
var original = asset.GetRendition("downloadOriginal");
var rendition = original.Items.FirstOrDefault();

if (rendition != null)
{
  var filename = asset.GetPropertyValue<string>(Constants.Asset.FileName);
  var directory = @"C:\Users\Stylelabs\Desktop";
  var filepath = Path.Combine(directory, filename);
  await rendition.DownloadAsync(filepath);
}