About Final Cut Pro X XML 1.7
You use the Final Cut Pro X app to create, edit, and produce high-quality video. With the Final Cut Pro X XML (FCPXML) format, you can transfer the details of your events and projects between Final Cut Pro X and third-party applications, devices, and media asset management tools that do not natively recognize Final Cut Pro X events or projects. FCPXML 1.7 requires Final Cut Pro X 10.4 or later.
FCPXML describes certain aspects of projects and events that are useful for other applications. It does not describe all possible data, and therefore is not a substitute for the native project and event data organized in a library bundle.
You can use Final Cut Pro X to export and import FCPXML documents to accomplish the following tasks:
Exchange Final Cut Pro X event and project data with other applications.
Create new Final Cut Pro X events and projects.
In this document, it is assumed that you understand XML and have used Final Cut Pro X.
Starting with Final Cut Pro X 10.3, you can import XML documents into existing events and exchange objects through drag-and-drop as XML with another application that supports FCPXML. Refer to the Final Cut Pro X Workflows Developer Guide for more information.
FCPXML 1.7 includes the following changes:
External asset identifiers—Added support for asset identifiers assigned by third parties.
High Dynamic Range (HDR) projects and media—Enhanced support for project and media color space, added support for HDR library processing mode.
360-degree projects and media—Added support for describing projection information.
FCPXML 1.6 included the following changes:
Single asset reference—New
<asset-clip>element to add both the audio and video media components from a media file as a clip.
<sync-clip>element to describe clips whose contained items and anchored items are synchronized.
Audio components—Added support for audio components identified in terms of their roles.
Wide-gamut color—Added support for projects using wide gamut color (Rec. 2020).
FCPXML 1.5 included the following changes:
Collections—Added support for smart collections in Final Cut Pro X libraries.
Video filter masks—Now applies video filters to a region defined by a collection of masks.
Color filtering and adjustments—Now describes color correction, color matching, and color balance effects using the
<filter-video>element instead of the
3D text—Now applies three dimensional text appearance to titles.
Structured parameter data—Describes three dimensional text and other effects.
ASC CDL color information—Now exports as an XML comment the primary color correction definition in American Society of Cinematographers Color Decision List (ASC CDL) format.
FCPXML 1.4 included the following changes:
Structural changes reflecting the organization of Final Cut Pro X libraries.
Change in specifying keyframe animations.
Visual adjustments on a multicam clip must now be specified on individual angles instead of the entire clip.
FCPXML 1.3 added support for the following Final Cut Pro X features:
Color adjustments—Define and preserve color adjustments, such as balancing, matching, and correction.
Audio adjustments—Define audio component enhancements, such as loudness, noise and hum reduction, and equalization.
Video adjustments—Define the stabilization and rolling shutter reduction applied to a clip.
Text styles—Define text style effects for titles, such as font, size, color, alignment, spacing, style, stroke, baseline, and kerning.
Color filtering—Apply color filter effects to a clip.
Import options—Control certain options during XML import.
Collections—Group clips and projects using folders, keywords, and other search criteria.
FCPXML 1.2 added support for the following Final Cut Pro X features:
Audio Component Editing—Define how audio components are used (for example, channel mappings, enabled, role, effects, and mute ranges).
Metadata Export/Import—Import and export metadata associated with media assets or clips in an event or project.
FCPXML 1.1 added support for the following Final Cut Pro X features:
Multicam editing—Manage media from multiple cameras or other synchronized footage.
Video and image transformation—Crop, trim, pan and zoom, distort, conform, move, resize, rotate, and blend videos and images.
Audio adjustment—Adjust audio volume and panning.
Retrieve ASC CDL color information—Export the first primary color correction definition in American Society of Cinematographers Color Decision List (ASC CDL) format.
The following resources may be helpful as you work with the FCPXML format: