Connecting Source Clips to the Database

Because source clips and database records can be created by different means at different times, you may need to establish the link between a source clip and its record after they both exist. This process is called connecting a clip to a record. How you connect clips to the database depends on how you captured your clips.

Keep in mind these basic rules for connecting clips:

Avoid Moving or Renaming Your Source Clips in the Finder

Once a source clip is connected to the database, that link must be intact when you generate any film lists. If the link is broken, the lists will be incomplete. A clip-to-database link is broken if:

  • The source clip filename is changed

  • The source clip file is moved or deleted

See Fixing Broken Clip-to-Database Links for information about fixing broken links.

Using the Connect Clips Command

You can use the Connect Clips command to connect source clips to the database in a variety of situations:

  • If you captured clips using a batch capture list: The Connect Clips command can connect your captured source clip files to the appropriate database records. This process requires that the reel name and the timecode of the captured clips match those of the database entries.
  • If you moved your connected clips to a new location: Once you have clips connected to your database, moving the clips to a different folder or disk causes the clips to be disconnected. You can use the Connect Clips command to reconnect the records to the relocated clips.
  • If you renamed one or more of your clips: Once you have clips connected to your database, renaming the clips causes them to be disconnected. As long as the clips still have the same reel number and timecode information, you can use the Connect Clips command to reconnect the records to the renamed clips.
  • If some clips have been updated and put in a different folder: If you have created different versions of some connected clips (for example, versions that have been color corrected or recaptured using a different codec) and have put the new clips in a separate folder, you can use the Connect Clips command to connect records to those new clips.

Important: Records connected to DPX image sequence clips use the folder name that contains the image sequence files as the reel name, and the name of the first image as the clip name. If you change the name of the folder that contains the image sequence files, you have effectively changed the clip’s reel name, and you cannot use Connect Clips to reconnect to the DPX image sequence clip.

The Connect Clips command uses a record’s video reel and timecode values when trying to connect records in the found set to clips in the selected folder (and its subfolders). You also need to keep the following in mind when using the Connect Clips command:

  • Only records with video reel and timecode entries can be connected to a clip.

  • If a record in the found set matches a clip in the selected folder, the record is connected to that clip, even if the record already had a connected clip. This is useful when you have moved a set of clips to a new location and want to reconnect them to their records.

  • Any records that do not match clips in the selected folder are not modified—if a record is already connected to a clip in a different folder, it remains connected to that clip if no matching clip is found in the selected folder.

To use the Connect Clips command to connect clips to the database
  1. Make sure that the List View window displays the records to which you want to connect clips.

    To display all of the records in the database, click Show All in the List View window.

    Figure. List View window.
  2. Choose Database > Connect Clips.

  3. In the dialog that appears, navigate to the folder where the clips are located.

    All clips in the folder and its subfolders are available for Cinema Tools to connect to.

  4. Click Open.

For every database record, Cinema Tools looks in the selected folder and its subfolders for a clip with a matching video reel and timecode value. Each time Cinema Tools finds a matching clip, it connects the clip to the correct database record.

Additionally, poster frames are automatically created for each record that gets a clip connected.

Connecting Clips Using the Detail View Window

In the Detail View window, you can tell whether a database record is connected to a clip by looking at the button below the clip poster frame.

Figure. Thumbnail display area of the Detail View window, showing a clip's poster frame and the Open Clip button.

If the button is labeled Open Clip, the current database record has a clip connected to it. If the button is labeled Connect Clip, there is no clip connected to the database record.

To use the Detail View window to connect a clip to a database record
  1. Open the database record in the Detail View window.

    See Finding and Opening Database Records for details.

  2. Click the Connect Clip button.

    Note: If the button is labeled Open Clip, the database record already has a clip connected to it. If you want to connect a different clip to the record, you need to disconnect the current clip first.

  3. In the dialog that appears, select a clip to connect to the current database record.

When you select the clip, three things happen:

  • The clip is connected to the database.

  • A poster frame of the first frame of the clip appears in the Detail View window, and above the poster frame you see the name of the clip.

    Figure. Thumbnail display area of the Detail View window, showing the clip's name above the poster frame.

    Tip: Additionally, placing the pointer over the thumbnail display shows a tooltip with the clip’s location. This can be especially useful if the clip is missing because it lets you know where Cinema Tools thinks the clip should be.

  • A Clip window opens for the clip. If you want a different frame to represent the clip in the database, go to that frame, then click the Set Poster Frame button. See Choosing a Different Poster Frame for a Clip and Settings in the Clip Window for more information.

Note: If you don’t want the Clip window to open after you connect a clip, press the Command key when you click the Connect Clip button.

To use the Detail View window to disconnect a captured clip
  1. Open the database record in the Detail View window and press the Command key.

    The Open Clip button changes to Disconnect Clip.

  2. Click Disconnect Clip.

    Note: Clicking this button breaks the link between the source clip and the record so that they are no longer connected. It does not delete the clip from your hard disk.

Connecting Clips Using the Clip Window

When a clip has not been connected to a database record, the Clip window contains a button labeled Enter in Database. If a clip is already connected, the button is labeled Disconnect Clip.

The Enter in Database button offers you a way to connect a source clip to an existing database record or create a new database record and connect the clip to it.

To use the Clip window to connect a source clip to the database
  1. Choose File > Open Clip to open the clip in the Clip window, then select the clip in the dialog.

  2. Click the Enter in Database button.

    Figure. Enter in Database button in the Clip window.
  3. Enter a scene and take identifier for the source clip in the dialog that appears.

    Figure. Dialog for entering a scene and take identifier.

    Important: Text entries are case sensitive. Additionally, do not enter the hyphen that separates the take number from the scene/shot value.

    See Using Scene, Shot, and Take Identifiers for more information.

  4. Do one of the following:

    • Click OK to connect this clip to the existing record in the database that corresponds to the scene and take you entered in the dialog. If no record exists for that scene and take, a new record is created.

    • Click New Record to create a new record, even if there already is an existing record that corresponds to the scene and take you entered.

    In either case, the source clip in the Clip window is connected to the record, so the relationship is established in the database. A source clip can be connected to a record in more than one database, but within one database it can only be connected or related to one record. If the source clip is moved or renamed, the relationship should be re-created.

To use the Clip window to disconnect a captured clip
  1. Open the clip in the Clip window.

  2. Click Disconnect Clip.

    Note: Clicking this button breaks the link between the source clip and the record so that they are no longer connected. It does not delete the clip from your hard disk.