Skip to content

Instantly share code, notes, and snippets.

@allenday

allenday/fcpxml-structure.md

Last active March 29, 2022 03:03
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save allenday/44cafa9d698ae6f94c5d55205f86f5b9 to your computer and use it in GitHub Desktop.
Save allenday/44cafa9d698ae6f94c5d55205f86f5b9 to your computer and use it in GitHub Desktop.
Download ZIP
Raw
fcpxml-structure.md

overall structure

  • resources (multiple audio files, video files, and other resources referenced in the sequence)
  • project
    • sequence (a group of multiple assets that compose a single timeline)
      • spine' (a timeline. this is the OUTER spine in which everything else is contained)
        • marker
          • complete="0" is a TODO marker
        • video (ignore these)
        • asset-clip' (a segment of a video or audio file)
          • spine (this is a floating timeline that contains one or more of...)
            • asset-clip
            • gap

asset-clip

has attributes:

  • ref (from resources section)
  • offset (a time offset in seconds, relative to the containing spine i think)
  • duration (a time in seconds of how long this asset clip is
  • start (not sure, seems to be the same as offset)

spine

has attributes:

  • lane (an id? the vertical sort order?)
  • offset (seems to be identical to offset and start from asset-clip. same values)
  • asset clip sub-element has attributes:
    • offset (relative to the containing spine)
    • ref (from resources)
    • duration (length of the asset-clip, in seconds)
    • start (start time in seconds, relative to the resource)
    • videoRole (logical grouping label)
    • audioRole (logical grouping label)
    • enabled (0 if disabled, 1 or omitted if enabled)
    • NOTE *start and stop can be identical and on a frame boundary for a perfect clip cut
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment