...

• Name: A unique name of the format.

• Description: An optional, more elaborate description of the format. This is visible to users when downloading a rendition that uses the format. It can, e.g., be used to describe which use cases the format is intended for.

• Format type: The type of the format.

• Immediately generated for: The asset types for which renditions of the format should be generated immediately when an asset’s file is uploaded or replaced. See below for more information.

• Mapped media formats: In previous versions, the transcode system worked with a concept of media formats, similar to the new format concept. This parameter can be used when migrating from the old transcode system to the new transcode system. More details can be found here.

• Channel filter: Limits the visibility of the format based on channels. More details can be found here

• Asset type filter: Limits the visibility of the format based on asset type. More details can be found here.

...

Depending on the chosen format type, a number of different parameters will appear. Most parameters should be self-explanatory. However, a short description of some of the key features can be found here.

...

Note that renditions of a specific format can not be generated for all input file types. For instance, renditions of video or audio formats can not be generated for image assets such as png, jpeg, and webp since it does not make sense to create a video or an audio file from an image. However, renditions of image formats can be generated for most common input file types. Thus, even though a limited set of output formats are available, a wide range of input formats are supported.

Format visibility

The visibility of a format can be controlled via download qualities and format filters.

Download qualities

One use-case for defining a format is to make it easy for users to download renditions of assets in this format. However, by default, a format is not visible in the download dialog in the Media Manager. The visibility of formats in the download dialog can be controlled from the general settings page in the Media Manager, where it can be configured for individual user groups.

...

Note that the configured download formats only affect the visibility of formats in the download dialog and does not affect security. Thus, a user is able to request a rendition of a format that is not visible to the user, as long as the user has access to the asset.

Format filters

A format can be defined with a channel filter and/or an asset type filter.

...

Note that the configured format filter only affects which formats that the backend indicates can be streamed and downloaded for assets. Consequently, when a user has read access to an asset that does not pass a specific format filter, the user is still able to request a rendition of the asset in the specific format.

Custom renditions

In addition to the formats defined on the system administration page, it is possible to allow users to request custom renditions of formats that the users define on-the-fly. This can be done via the “Custom rendition” button in the download dialog shown above or by calling the endpoint <api-url>/DigizuiteCore/LegacyService/api/renditions/<asset-id>/custom.

...