Asset File Functions

< All Topics

ASSET_FILE_TAG

{{ ASSET_FILE_TAG }}

Outputs the tag of the input asset file, e.g. ‘Original’ is the default tag of the ingested master Asset File.


SOURCE_FILENAME

{{ SOURCE_FILENAME }}

Inserts the filename of the input Asset File.


SOURCE_FILENAME_WITHOUT_EXTENSION

{{ SOURCE_FILENAME_WITHOUT_EXTENSION }}

Inserts the filename of the input Asset File without the extension.


SOURCE_FILENAME_EXTENSION

{{ SOURCE_FILENAME_EXTENSION }}

Outputs the Asset File’s file extension (includes the ‘.’)


ORIGINAL_FILENAME

{{ ORIGINAL_FILENAME }}

Outputs the Asset File’s original filename which is set when the asset file is first created.


DOWNLOAD_LINK

{{ DOWNLOAD_LINK }}

{{ DOWNLOAD_LINK(3) }}

{{ DOWNLOAD_LINK(2, 5) }}

Generates a shareable download link for the input Asset File valid for one day and one use. The first optional argument sets the number of days (integer) the link is valid for. The second optional argument sets the number of valid download attempts before the link expires.


PREVIEW_LINK

{{ PREVIEW_LINK }}

{{ PREVIEW_LINK(3) }}

Generates a shareable preview link which directs the user to the BLAM public preview player for the input browse/proxy asset file. The optional argument sets the number of days (integer) the link is valid for.


FILE_LOCATION

{{ FILE_LOCATION(locationCount) }}

{{ FILE_LOCATION(FileStore, DMZ, dateCreated) }}

{{ FILE_LOCATION(FileStore, Bucket, location_schema_fieldname) }}

{{ FILE_LOCATION(1, dateCreated) }}

{{ FILE_LOCATION(1, fileStore) }}

{{ FILE_LOCATION(1, location_schema_fieldname) }}

Inserts the specified file location metadata. ‘locationCount’ returns the total number of locations the file is located. All other metadata arguments can optionally take either the location number as the first argument or can use ‘FileStore’ followed by the file store name to return the first location on the given file store. If no location number or file store is provided then the first location is selected by default.


FILE

{{ FILE(tag) }}

{{ FILE(fileLocationsCount) }}

{{ FILE(originalFilename) }}

{{ FILE(sizeInBytes) }}

{{ FILE(sizeInBytes, kilobytes) }}

{{ FILE(sizeInBytes, megabytes) }}

{{ FILE(sizeInBytes, gigabytes) }}

{{ FILE(format) }}

{{ FILE(formatProfile) }}

{{ FILE(formatCommercial) }}

{{ FILE(bitrate) }}

{{ FILE(bitrate, kbps) }}

{{ FILE(bitrate, kilobits) }}

{{ FILE(bitrate, mbps) }}

{{ FILE(bitrate, megabits) }}

{{ FILE(encodedDate) }}

{{ FILE(encodedDate, dd/MM/yyyy) }}

{{ FILE(encodedApplication) }}

{{ FILE(checksum) }}

Inserts the specified file technical metadata.


AUDIO

{{ AUDIO(trackLayout) }}

{{ AUDIO(trackCount) }}

{{ AUDIO(channelCount) }}

{{ AUDIO(1, trackNumber) }}

{{ AUDIO(1, codec) }}

{{ AUDIO(1, bitrate) }}

{{ AUDIO(1, bitrate, kbps) }}

{{ AUDIO(1, bitrate, kilobits) }}

{{ AUDIO(1, bitrate, mbps) }}

{{ AUDIO(1, bitrate, megabits) }}

{{ AUDIO(1, bitDepth) }}

{{ AUDIO(1, channels) }}

{{ AUDIO(1, channelsOriginal) }}

{{ AUDIO(1, samplingRate) }}

{{ AUDIO(1, samplingRate, khz) }}

{{ AUDIO(1, samplingRate, kilohertz) }}

{{ AUDIO(1, language) }}

{{ AUDIO(1, channelLayout) }}

{{ AUDIO(1, channelPositions) }}

{{ AUDIO(1, ChannelsInformation, 1, channelNumber) }}

{{ AUDIO(1, ChannelsInformation, 1, check) }}

{{ AUDIO(1, ChannelsInformation, 1, description) }}

{{ AUDIO(1, ChannelsInformation, 1, endPeakDbfs) }}

{{ AUDIO(1, ChannelsInformation, 1, language) }}

{{ AUDIO(1, ChannelsInformation, 1, layout) }}

{{ AUDIO(1, ChannelsInformation, 1, lineUpDb) }}

{{ AUDIO(1, ChannelsInformation, 1, loudnessLufs) }}

{{ AUDIO(1, ChannelsInformation, 1, loudnessStandard) }}

{{ AUDIO(1, ChannelsInformation, 1, phase) }}

Inserts the specified audio technical metadata. ‘trackLayout’, ‘channelCount’ and ‘trackCount’ return technical metadata related to all tracks. All other metadata arguments can optionally take the track number as the first argument. If no track number is provided then the first track is selected by default.
‘channelsInformation’ returns the individual channel metadata on the selected track. A channel number corresponding to the channel number on the track can optionally be specified. If no channel number is provided, then the first channel on the track is selected by default. The remaining argument corresponds to the technical metadata field on the selected channel.


AUDIO_CHANNEL

{{ AUDIO_CHANNEL(count) }}

{{ AUDIO_CHANNEL(1, channelNumber) }}

{{ AUDIO_CHANNEL(1, check) }}

{{ AUDIO_CHANNEL(1, description) }}

{{ AUDIO_CHANNEL(1, endPeakDbfs) }}

{{ AUDIO_CHANNEL(1, language) }}

{{ AUDIO_CHANNEL(1, layout) }}

{{ AUDIO_CHANNEL(1, lineUpDb) }}

{{ AUDIO_CHANNEL(1, loudnessLufs) }}

{{ AUDIO_CHANNEL(1, loudnessStandard) }}

{{ AUDIO_CHANNEL(1, phase) }}

Inserts the specified audio channel technical l metadata. All metadata arguments except for ‘count’ can optionally take the channel number as the first argument. If no channel number is provided then the first channel is selected by default.
Channels are numbered in line with the track order. An audio arrangement with 2 tracks each with 2 channels would assign channel numbers 1 and 2 for track 1 and numbers 3 and 4 for track 2.
The ‘channelNumber’ field refers to the channel number on the given track.


AUDIO_TRACK

{{ AUDIO_TRACK(count) }}

{{ AUDIO_TRACK(1, trackNumber) }}

{{ AUDIO_TRACK(1, codec) }}

{{ AUDIO_TRACK(1, bitrate) }}

{{ AUDIO_TRACK(1, bitrate, kbps) }}

{{ AUDIO_TRACK(1, bitrate, kilobits) }}

{{ AUDIO_TRACK(1, bitrate, mbps) }}

{{ AUDIO_TRACK(1, bitrate, megabits) }}

{{ AUDIO_TRACK(1, bitDepth) }}

{{ AUDIO_TRACK(1, channels) }}

{{ AUDIO_TRACK(1, channelsOriginal) }}

{{ AUDIO_TRACK(1, samplingRate) }}

{{ AUDIO_TRACK(1, samplingRate, khz) }}

{{ AUDIO_TRACK(1, samplingRate, kilohertz) }}

{{ AUDIO_TRACK(1, language) }}

{{ AUDIO_TRACK(1, channelLayout) }}

{{ AUDIO_TRACK(1, channelPositions) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, check) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, description) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, endPeakDbfs) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, language) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, layout) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, lineUpDb) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, loudnessLufs) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, loudnessStandard) }}

{{ AUDIO_TRACK(1, channelsInformation, 1, phase) }}

Inserts the specified audio technical metadata. All metadata arguments except for ‘count’ can optionally take the track number as the first argument. If no track number is provided then the first track is selected by default.
‘channelsInformation’ returns the individual channel metadata on the selected track. A channel number corresponding to the channel number on the track can optionally be specified. If none is provided then the first channel on the track is selected by default. The remaining argument corresponds to the technical metadata field on the selected channel.


IMAGE

{{ IMAGE(width) }}

{{ IMAGE(height) }}

{{ IMAGE(resolution) }}

{{ IMAGE(format) }}

{{ IMAGE(chromaSubsampling) }}

{{ IMAGE(bitDepth) }}

{{ IMAGE(colourSpace) }}

{{ IMAGE(compression) }}

Inserts the specified image technical metadata.


VIDEO

{{ VIDEO(width) }}

{{ VIDEO(height) }}

{{ VIDEO(resolution) }}

{{ VIDEO(codec) }}

{{ VIDEO(bitrate) }}

{{ VIDEO(bitrate, kbps) }}

{{ VIDEO(bitrate, kilobits) }}

{{ VIDEO(bitrate, mbps) }}

{{ VIDEO(bitrate, megabits) }}

{{ VIDEO(duration) }}

{{ VIDEO(duration, f) }}

{{ VIDEO(duration, ms) }}

{{ VIDEO(duration, milliseconds) }}

{{ VIDEO(duration, s) }}

{{ VIDEO(duration, ss) }}

{{ VIDEO(duration, sec) }}

{{ VIDEO(duration, seconds) }}

{{ VIDEO(duration, timecode) }}

{{ VIDEO(aspectRatio) }}

{{ VIDEO(aspectRatio, decimal) }}

{{ VIDEO(aspectRatio, ratio) }}

{{ VIDEO(frameRate) }}

{{ VIDEO(som) }}

{{ VIDEO(eom) }}

{{ VIDEO(chromaSubsampling) }}

{{ VIDEO(bitDepth) }}

{{ VIDEO(scanType) }}

{{ VIDEO(scanOrder) }}

Inserts the specified video technical metadata. ‘duration’ returns media duration in seconds by default. Similarly, ‘aspect_ratio’ will return the aspect ratio as a ratio if no second argument is provided.


QC_CHECKS

{{ QC_CHECKS(audioGrade) }}

{{ QC_CHECKS(audioToneCorrect) }}

{{ QC_CHECKS(clockTcCorrect) }}

{{ QC_CHECKS(iStillsCorrect) }}

{{ QC_CHECKS(lineUpCorrect) }}

{{ QC_CHECKS(pseCheck) }}

{{ QC_CHECKS(slateInfoCorrect) }}

{{ QC_CHECKS(standardBars) }}

{{ QC_CHECKS(startTcCorrect) }}

{{ QC_CHECKS(titleSafe) }}

{{ QC_CHECKS(videoGrade) }}

Inserts the specified QC checks metadata.


QC_MARKER

{{ QC_MARKER(count) }}

{{ QC_MARKER(1, type) }}

{{ QC_MARKER(1, title) }}

{{ QC_MARKER(1, text) }}

{{ QC_MARKER(1, level) }}

{{ QC_MARKER(1, grade) }}

{{ QC_MARKER(1, startsAt) }}

{{ QC_MARKER(1, startsAtTimecode) }}

{{ QC_MARKER(1, finishesAt) }}

{{ QC_MARKER(1, finishesAtTimecode) }}

{{ QC_MARKER(1, username) }}

{{ QC_MARKER(1, comments) }}

Inserts the specified QC marker metadata. All metadata arguments except for ‘count’ can optionally take the marker number as the first argument. If no marker number is provided then the first marker is selected by default.


QC_RECOMMENDATION

{{ QC_RECOMMENDATION(count) }}

{{ QC_RECOMMENDATION(1, text) }}

{{ QC_RECOMMENDATION(1, username) }}

{{ QC_RECOMMENDATION(1, extra_data_fieldname) }}

Inserts the specified QC recommendation metadata. All metadata arguments except for ‘count’ can optionally take the recommendation number as the first argument. If no recommendation number is provided then the first recommendation is selected by default.


PROGRAMME_PART

{{ PROGRAMME_PART(1, type) }}

{{ PROGRAMME_PART(1, startsAtMillisecond, ss) }}

{{ PROGRAMME_PART(1, startsAtTimecode) }}

{{ PROGRAMME_PART(1, finishesAtMillisecond, ss) }}

{{ PROGRAMME_PART(1, finishesAtTimecode) }}

{{ PROGRAMME_PART(1, durationMillisecond, ss) }}

{{ PROGRAMME_PART(1, durationTimecode) }}

Inserts the specified programme part metadata. Can optionally take the programme part number as the first argument. If no programme part number is provided then the first programme part is selected by default.