Deliverables and error checking
A deliverable is a spec that a file should match. This includes codec, resolution,
and frame rate. Each deliverable has a
short identifier, such as d001, that should be included in the file name. This
id is used to check whether or not a file passes or fails the defined requirements.
You set deliverables up on the Deliverables page.
How a file finds its deliverable
Section titled “How a file finds its deliverable”Volare looks for an identifier between underscores, at the start or end of the name, or with underscores either side. Matching is case-insensitive.
| File name | Matches d001? |
|---|---|
show_d001_v02.mov | Yes |
d001_v02.mov | Yes |
SHOW_D001_V02.mov | Yes |
show-d001-v02.mov | No: hyphens, not underscores |
show_d0012_v02.mov | No: d0012 is a different identifier |
An identifier can contain underscores of its own, such as upstage_wall. However,
when using these types of identifiers, it is important to ensure that there is
not also a deliverable with a matching substring as well, such as upstage.
A file without a matched identifier, or one that matches numerous (as in the example above), is checked against the global fallback instead.
Pass, fail and unknown
Section titled “Pass, fail and unknown”Volare checks codec, resolution and frame rate separately, and each gets its own result:
| Result | Means |
|---|---|
| Pass | The file matches the spec. |
| Fail | The file doesn’t match the spec. |
| Unknown | There was nothing to check against: typically resolution under the global fallback. |
- Codec passes when the file’s codec contains one of the codecs the
deliverable lists, so a deliverable that lists
prorespassesprores_422andprores_4444alike. Upper and lower case don’t matter. A deliverable can have multiple codec options. - Resolution passes only when width and height both match exactly. When it fails, or reads unknown under the global fallback, the Staging Inspector suggests any deliverable whose resolution the file does match. It’s only a suggestion and doesn’t change the result.
- Frame rate passes only when it matches exactly. A still image has no frame rate, so frame rate never fails it.
A file that has failed its deliverable check is not blocked from being pushed to servers.
The global fallback
Section titled “The global fallback”Every Show has one Global Fallback spec. This is used for checking a codec and frame rate for a file that doesn’t match a deliverable. Resolution is not checked since that doesn’t make sense in a global context. So a file checked against the global fallback always reads unknown for resolution.
Audio is checked against one audio spec. It covers:
- Channels, sample rate and bit depth, checked as soon as a file with audio arrives. A field set to Any passes whatever the file has.
When a spec changes
Section titled “When a spec changes”When you add, remove or change a deliverable, or change the audio spec, Volare checks every file again to always show the current state versus the state prior to any spec changes.