XML Elements Reference

The following table describes the XML elements supported by the VisionVideo QCS.

Element

Required?

Description

<fps>

Required for H.264 Annex B

Specifies the frame rate for the reference file. Required only for H.264 Annex B files.

Use one of the following formats to represent the frame rate:

  • A string in numerator/denominator format. Example: 30000/1001

  • A floating point number. Example: 25 or 15.5

  • A valid abbreviation:

    • ntsc (30000/1001)

    • pal (25/1)

    • qntsc (30000/1001 -- VCD compliant NTSC)

    • qpal (25/1 -- VCD compliant PAL)

    • sntsc (30000/1001 -- square pixel NTSC)

    • spal (25/1 -- square pixel PAL)

    • film (24/1)

    • ntsc-film (24000/1001)

<group>

Optional

Reserved for future use. Contains a string that describes a group, such as a company name.

<job>

Required

Specifies the job request. This element must have version=1.0 as its attribute and value.

<metadata>

Optional

Describes supplemental information about the job request. It is not used in job processing other than for display in the Job results.

This element has two required child elements: <name> and <value>.

  • <name> - the name of the metadata

  • <value> - the value of the metadata name

You can choose to enclose the value in a CDATA tag. This technique allows you to include special characters, such as ampersand (&), single quote (' '), and less than (<) in the data without XML escaping.

<reference>

Required

Specifies the reference file information. Use once only in the XML document.

This element has two child elements: <uri> and <fps>.  

<target>

Required

Specifies the target file information. Use once only in the XML document.

This element has two child elements: <uri> and <fps>.  

<uri>

Required

Specifies the complete path and file name on the file system as accessed from the VisionVideo QCS.

This element is a child of <reference> and <target>.