Markers annotate time inside a story element. Collections group the clips of an event or a library.
Markers, ratings and keywords
These are the marker items allowed inside story elements. From version 1.13,
an empty hidden-clip-marker element joins them; Apple does not describe it.
| Element | Attributes | Meaning |
|---|---|---|
marker | start (required), duration, value (required), completed, note | A marker. With completed it is a to-do item: 0 not completed, 1 completed. |
chapter-marker | start (required), duration, value (required), note, posterOffset | A chapter marker. |
rating | name, start, duration, value (required), note | value is favorite or reject. |
keyword | start, duration, value (required), note | value is a comma-separated list of keywords. |
analysis-marker | start, duration | Holds one or more of shot-type and stabilization-type. |
shot-type | value (required) | onePerson, twoPersons, group, closeUp, mediumShot or wideShot. |
stabilization-type | value (required) | excessiveShake. |
Collection items
| Element | Attributes | Content |
|---|---|---|
keyword-collection | name (required) | Empty. |
collection-folder | name (required) | Any number of collection items. |
smart-collection | name (required), match (required): any or all | Any number of the match rules below. |
Smart collection rules
Each rule has enabled, 0 or 1 with a default of
1.
| Rule | Attributes and values |
|---|---|
match-text | rule: includes (default), doesNotInclude, is, isNot, from 1.12 startsWith, endsWith, from 1.14 isRelatedTo. value (required). scope: all (default), notes, names, markers, from 1.14 transcript, visual, all-text. |
match-ratings | value (required): favorites or rejected. |
match-media | rule: is (default) or isNot. type (required): videoWithAudio, videoOnly, audioOnly or stills. |
match-clip | rule: is (default) or isNot. type (required): audition, synchronized, compound, multicam, layeredGraphic or project. |
match-stabilization | rule: includesAny (default), includesAll, doesNotIncludeAny or doesNotIncludeAll. Holds stabilization-type*. |
match-keywords | The same four rules. Holds keyword-name*, each with a required value. |
match-shot | The same four rules. Holds shot-type*. |
match-property | key (required): reel, scene, take, audioOutputChannels, frameSize, videoFrameRate, audioSampleRate, cameraName, cameraAngle, projection, stereoscopic or cinematic. rule: includes (default), doesNotInclude, is, isNot, isSet, isNotSet, from 1.12 startsWith, endsWith. value, absent for isSet and isNotSet. |
match-time | type (required): contentCreated or dateImported. rule (required): is, isBefore or isAfter. value (required). |
match-timeRange | type (required): as above. rule (required): isInLast or isNotInLast. value (required). units: hour, day, week, month or year. |
match-roles | The same four rules as match-stabilization. Holds role*, each with a required name. |
match-usage | rule: used (default) or unused. |
match-representation | type (required): original, optimized or proxy. rule: isAvailable (default) or isMissing. |
match-markers | type: all (default), standard, allTodo, complete or incomplete. |
match-analysis-type (1.14) | rule: isAvailable (default) or isMissing. value: any (default), transcript or visual. |