Document Export and Import

Documents in the Final Cut Pro XML Interchange Format are stored on disk as plain text documents that you can view, parse, and edit on any platform.

You can validate an interchange format document using an interchange format DTD. (See “DTD for the Interchange Format”)

You can export an interchange format document from Final Cut Pro, or import an interchange format document into Final Cut Pro, using either the Final Cut Pro user interface or, alternatively, Apple Events from an independent application. This chapter describes importing and exporting with the user interface. For information about using Apple Events see “Apple Events and Final Cut Pro”

Exporting Documents

To export an interchange format document from Final Cut Pro:

  1. Select an item in the Browser that you want to describe in an interchange format document. (If nothing is selected, a description of the entire contents of the Browser is exported.)

  2. Choose File > Export > XML.

  3. Check the Export XML dialog to make sure that the source for the interchange format document is correct. In Figure 2-1 the source is a single sequence.

  4. Choose the version of the XML Interchange Format for the document.

  5. If clips in your source have master clips, you can select the option to Include Master Clips Outside Selection.

  6. Select or deselect the option “Save project with latest clip metadata.“ Since XML Export may make changes that affect project metadata (such as itemhistory), saving the project at the time you export ensures that this metadata is persistent. On the other hand, not saving the project can ensure the user’s ability to undo changes.

  7. Click OK.

  8. Enter a title for the interchange format document and choose a location. (You may want to use .xml as a suffix.)

Figure 2-1  Export XML dialog
export

Interchange format documents you export from Final Cut Pro have the Final Cut Pro XML file icon.

Figure 2-2  Final Cut Pro XML file icon
Final Cut Pro XML file icon

Importing Documents

There are several ways you can import an interchange format document into Final Cut Pro.

You can use the Import menu to import any interchange format document:

  1. Choose File > Import > XML.

  2. Navigate to the document, select it, and then click Choose.

If the document file has a Final Cut Pro XML file icon, you can do any of the following:

When you import an interchange format document, the Import XML dialog appears.

Figure 2-3  Import XML dialog
Import XML dialog

The settings in this dialog are:

Errors During Import

When you import an interchange format document, Final Cut Pro first checks to make sure the document is well-formed and that all required elements are present. It then translates the interchange format document into Final Cut Pro components.

If Final Cut Pro finds critical errors during import, the interchange format document is not imported. If noncritical errors occur, the document is imported, though the components constructed from the document may differ from your expectations.

Information about noncritical errors appears in an Final Cut Pro XML Error Log Window. (Note that you can suppress the reporting of noncritical errors by setting displaynoncriticalerrors to FALSE. See “Import Options”

In general, you should study error information about a document you are attempting to import, modify the document, and then reimport it, continuing this process until you can import the document without errors.