Container Clips

## Container Clips Concept

A Container Clip is a Media Item and the Timeline Clip made from it that has three items packed together as a single entity: Program, Unrendered Media and Rendered Media.

### Components

1. Unrendered Media This is what is displayed on timeline if container clip media is not rendered.
2. Program This data is used to render a media clip on timeline, sometimes using unrendered media as input.
3. Rendered Media This is what is displayed on timeline when Container Clip is rendered.

## Selection Container Clips

##### Components

- Unrendered Media A MLT XML vdieo clip created from selection or sequence like Compound clips previously.
- Program A MLT XML video clip created from selection or sequence like Compound clips previously. Here Program is the same as unrendered media.
- Rendered Media Clip Rendered from MLT XML Clip.

##### Use Cases

- Make possible to create Media items from selections and full Sequences.
- Give better timeline performance for complex multitrack container clips by pre-rendering them on timeline.

##### Creating Selection Container Clip from Selection

1. Select 2 or more adjacent clips from a single track.
2. Select Project->Create Container Clip->From Selected Clips
3. A new Media Item appears in the current Bin.

##### Creating Selection Container Clip from Sequence

1. Select Project->Create Container Clip->From Current Sequence
2. A new Media Item appears in the current Bin.

##### Creating audio synced Selection Container Clip from two Media Items

1. Select 2 Media Items in Media panel.
   - The expected case is to select 1 Video and 1 Audio Clip.
   - If you select 2 Video Clips then which is used as video depends on selection order.
   - Audio from clip treated as video is muted.
2. Select Project->Create Compound Clip->Audio Sync Merge Clip From 2 Media Items
3. If audio sync is successful a dialog appears. Give a name for the new Media Item in the dialog.
4. A new Media Item appears in the current Bin.

Audio syncing looks for best mathemathical match between two audio waveforms, so audio syncing non-matching audio will produce random results.

## Generator Container Clips

Generators are Container Clips too, see more info in chapter Generators and Fluxity API

## Sequence Link Container Clips

- Unrendered Media A MLT XML video clip created or recreated from Contents of a Sequence on request
- Program Contents of a Sequence.
- Rendered Media Clip Rendered from MLT XML Clip.

##### Use Cases

- Provide a convenient way to use Sequences as parts of a master Sequence.

##### Creating Sequence Link Container Clips

- Select from menu Project->Add Sequence Link Container Clip to create a Sequence Link Container Clip media item.
- Drag Sequence Link Container Clip Media Item on Timeline to create a clip.
- Sequence Link Container Clips can't be placed on Sequences they link to and creating cyclic dependencies between sequencse using Sequence Link Container Clips is not allowed.

##### Updating Sequence Link Container Clips

- Click Right Mouse on clip and select Update Sequence Link Clip to update clip to display current contents of Sequence it is linked to.

##### Replacing Sequence Link Container Clip with Sequence Contents

- Place Playhead at the beginning of Sequence Link Container Clip.
- Select from menu Sequence->Import Another Sequence Into This Sequence... and select option Insert Sequence at Playhead position and do import.
- Delete Sequence Link Container Clip.

## G'Mic Script Container Clips

##### Components

- Unrendered Media Video Clip.
- Program G'Mic script created and saved from G'Mic tool.
- Rendered Media A clip rendered with G'mic effect.

##### Use Cases

- Render G'Mic effects only on clip ranges used on timeline.
- Make easier to use single user defined G'Mic effect on multiple clips.

##### Creating G'Mic Script Container Clips

1. Open G'Mic tool.
2. Create G'Mic effect script. See section on G'Mic Effects in Chapter Tools.
3. Press Save Script button in bottom left corner and save effect.
4. Select menu item Project -> Create Container Clip -> From G'Mic Script.
5. Select the script you saved and the clip that it will be applied on to create Container Clip.

## Rendering Container Clips

#### Container Clip Render Actions

Render actions are available from Clip Right Mouse context menu in Generator and Container Rendering submenu.

- Render Clip... Renders Clip and stops using Unrendered Media on timeline.
- Render Settings... Allows setting how and where a clip is rendered.
- Switch to Unrendered Media Switch to using Unrendered Media and drops the current Rendered Media version of Program.
- Set Default Encoding... Allows setting encoding format that is used for all Container Clips and Generator as default video encoding.