How to stitch multiple files to an existing item [VC UG]
Stitching is done using the functions "Timeline API" and "Item conform" in Vidispine.
What is "Timeline API"?
Timeline API is used to store and retrieve timelines in the system. A timeline is represented in the system as a combination of:
The timeline itself (in the native format, but can be converted to other formats)
The rendered result as a new item.
The timeline with its constituent parts as a collection.
More information on API Timeline;
http://apidoc.vidispine.com/latest/ref/item/timeline.html
What is "Item conform"?
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. There are two different types of conforming;
Start a confirm job = Starts a new CONFORM job that creates a new item and one or more shapes that contains media according to the conform timeline.The rendered result as a new item.
Start a conform job for an existing item = Starts a new CONFORM job that creates one or more shapes that contains media according to the conform timeline.
More information on Item conform and different query parameters;
http://apidoc.vidispine.com/latest/ref/item/conform.html
In the example guide below we will be using "Start a conform job for an existing item".
Example guide;
It's only for the item that the resulting shape should belong to that needs a conform job as a timeline. For example, given three items VX-1, VX-2 and VX-3 with original shapes with media. To concatenate these into a new shape for item VX-100 one would do:
PUT API/item/VX-100/timeline/vidispine
<ConformDocument xmlns="http://xml.vidispine.com/schema/vidispine">
<timeBase>
<numerator>1</numerator>
<denominator>25</denominator>
</timeBase>
<timeline>
<segment>
<source>
<id>VX-1</id>
</source>
</segment>
<segment>
<source>
<id>VX-2</id>
</source>
</segment>
<segment>
<source>
<id>VX-3</id>
</source>
</segment>
</timeline>
</ConformDocument>
Then start the conform job using:
POST /API/item/VX-100/timeline/vidispine/conform?sourceTag=original&tag=house
This would then create a shape on VX-100 tagged with house containing the media from those three files. Note that the source items (VX-1, VX-2 and VX-3) do not need a timeline on them.