Skip to main content
Skip table of contents

Item conform [VC 21.3 GEN]

The conform resource exposes a simple way to combine media from one or more items into a new item. It is also possible to select specific parts from the input by specifying an input interval.

This could be used when you for example want to:

  • Merge spanned P2 clips.

  • Render a simple sequence as defined by a user.

Conforming

Start a conform job

POST /conform

Starts a new CONFORM job that creates a new item and one or more shapes that contains media according to the conform timeline.

Query Parameters:
  • conformMetadata (boolean) –

    • true (default) - Copy metadata from the source items, according to the timeline, to the resulting item.

    • false - Do not copy metadata from the source items.

  • sourceTag (string) – Comma-separated list of shape tags, that specify the shapes that should be used as inputs.

  • original (string) – If specified, should be one of the tags specified in the tag parameter. Specifies that the original shape tag will be reset to the shape created to this tag.

  • resourceId (string) – The transcoder resource to use to execute the transcode.

  • tag (string) – Comma-separated list of shape tags, that specify the desired output.

  • createThumbnails (boolean) –

    • true (default) - Creates thumbnails according to default transcoder rules.

    • false - No thumbnails will be created.

  • createPosters (string) – A list of time codes to use for creating posters.

  • thumbnailService (string) – Identifies which thumbnail resource that should be used.

  • destinationItem (string) – An item id, to which the new new shape will be associated.

  • notification (string) – The placeholder job notification to use for this job.

  • notificationData (string) – Any additional data to include for notifications on this job.

  • priority (string) – The priority to assign to the job. Default is MEDIUM .

  • jobmetadata (string[]) – Additional information for the job task.

Accepts:
Produces:
Role:

_job_write

Start a conform job for an existing item

POST /item/(id)/timeline/(timeline-format)/conform

Starts a new CONFORM job that creates one or more shapes that contains media according to the conform timeline.

The timeline must be a ConformDocument, else the request will be rejected.

Query Parameters:
  • conformMetadata (boolean) –

    • true (default) - Copy metadata from the source items, according to the timeline, to the resulting item.

    • false - Do not copy metadata from the source items.

  • sourceTag (string) – Comma-separated list of shape tags, that specify the shapes that should be used as inputs.

  • original (string) – If specified, should be one of the tags specified in the tag parameter. Specifies that the original shape tag will be reset to the shape created to this tag.

  • resourceId (string) – The transcoder resource to use to execute the transcode.

  • tag (string) – Comma-separated list of shape tags, that specify the desired output.

  • createThumbnails (boolean) –

    • true (default) - Creates thumbnails according to default transcoder rules.

    • false - No thumbnails will be created.

  • createPosters (string) – A list of time codes to use for creating posters.

  • thumbnailService (string) – Identifies which thumbnail resource that should be used.

  • destinationItem (string) – An item id, to which the new new shape will be associated.

  • overrideFastStart (boolean) –

    • true (default) - Use transcoder’s estimate of the duration for allocating header space in MOV files and similar files.

    • false - Do not use the transcoder’s estimate of the duration.

  • requireFastStart (boolean) –

    • true (default) - Try to put the index tables (header) in front of the file.

    • false - Put header at end of file.

  • fastStartLength (string) – Estimated duration of the clip in seconds.

  • notification (string) – The placeholder job notification to use for this job.

  • notificationData (string) – Any additional data to include for notifications on this job.

  • priority (string) – The priority to assign to the job. Default is MEDIUM .

  • jobmetadata (string[]) – Additional information for the job task.

Produces:
Role:

_job_write

Example: joining two clips

In this example item VX-1 and VX-2 are the two clips that should be joined/concatenated. A shape-tag with an empty preset (here the original tag) is specified so that the output has the same format as the input.

NONE
POST /conform?tag=original
Content-Type: application/xml

<ConformRequestDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <conform>
    <timeline>
      <segment>
        <source>
          <id>VX-1</id>
        </source>
      </segment>
      <segment>
        <source>
          <id>VX-2</id>
        </source>
      </segment>
    </timeline>
  </conform>
  <metadata>
    <timespan start="-INF" end="+INF">
      <field>
        <name>title</name>
        <value>Joined A and B</value>
      </field>
    </timespan>
  </metadata>
</ConformRequestDocument>
HTML/XML
<JobDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <jobId>VX-21527</jobId>
  <user>admin</user>
  <started>2013-05-14T06:56:40.868Z</started>
  <status>READY</status>
  <type>CONFORM</type>
  <priority>MEDIUM</priority>
</JobDocument>
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.