События Apple и Final Cut Pro

Версия 5.1.2 Final Cut Pro и более поздние предложения поддерживают для событий Apple, которые внешние приложения могут использовать для прямого управления импортом и экспортом XML в проекте Окончательного варианта.

Эти пользовательские события Apple обеспечивают следующие функции:

Для предупреждения пользователя к следующим изменениям в проекте, они импортируют или экспортируют операции, существует также несколько событий Apple, управляющих дисплеем информации о проекте, включая:

Final Cut Pro 6.0.2 обеспечил События Apple в поддержку следующих функций:

Новый в Final Cut Pro 7.0

Final Cut Pro 7.0 обеспечивает новые События Apple, поддерживающие следующие функции:

Final Cut Pro события Apple


Откройте Project (kFCPOpenProjectFile 'ofcP')
Описание
Открывает указанный файл проекта. Если файл проекта уже открыт, событие приносит его к переднему плану в Final Cut Pro.
Параметр
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Файл проекта для открытия.


Близкий проект (kFCPSaveAndCloseProjectFile 'cfcP')
Описание
Закрывает указанный файл проекта, или сохраняющий любые изменения или отбрасывающий их.
Параметры
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Проект закрыться. Если проект не открыт, ничто не происходит. Если никакой проект не указан, последний раз открытый файл закрывается.
kFCPProjectFileCloseFlagsKey 'fcCF' typeSInt32. Флаг, управляющий поведением близкого события. Возможные значения:
  • kFCPSaveAndCloseProject - сохраняет любые изменения и затем закрывает файл.

  • kFCPDiscardAndCloseProject - отбрасывания любые изменения и завершения файл.

Если никакой флаг не указан, поведение по умолчанию является сохранением и близко.


Сохраните проект как (kFCPSaveProjectFileAs 'sfcP')
Описание
Сохранил указанный файл проекта, возможно к новому названию и местоположению. Если указанный проект не открыт, ничто не происходит. Если никакой файл проекта не указан, самый важный открытый проект сохраняется.
Параметры
kFCPProjectFileKey 'fcpP'. Файл проекта для сохранения (FSRef).
kFCPProjectFileURL 'fcpU'. Название и местоположение для сохраненного файла проекта (URL файла).
kFCPProjectFileOverwriteFlag 'fsOF'. Дополнительная перезапись управления булева флага. TRUE означает, что Final Cut Pro перезаписывает файл проекта с тем же названием и местоположением; FALSE означает, что Final Cut Pro отменяет работу сохранения, если проект существует с тем же названием и местоположением. Настройкой по умолчанию является FALSE.


Получите оглавление (kFCPGetProjectTOC 'eTCX')
Описание
Возвращает список Оглавления стеллажей, клипов, и упорядочивает в данном проекте. Если никакой параметр файла проекта не отправляется, самый важный проект используется.
Параметр
kFCPProjectFileKey 'fcpP' . Файл проекта для перечисления.
Результаты
kFCPXMLDataKey 'xmlD'. Поток XML, перечисляющий 'оглавление' для проекта. Каждое перечисление включает имя, uuid, продолжительность и информацию об уровне для указанного элемента.


Доберитесь открывают Projects List (kFCPGetAllOpenProjects 'fcLP')
Описание
Возвращает список открытых файлов проекта как FSRefs. Только проекты со связанным файлом возвращаются.
Результаты
kFCPOpenProjectList 'fcOP'. AEList AERecords, каждый из которых имеет a kFCPOneOpenProjectFile параметр.
kFCPOneOpenProjectFile 'fcPf'. Единственный путь к файлу проекта в списке открытых проектов. Этот параметр только происходит в AEList, возвращенном kFCPOpenProjectList. Его значение является файлом FSRef.


Получите XML Проекта (kFCPGetDocumentXML 'eXML')
Описание
Запрашивает представление XML проекта Окончательного варианта. Если файл проекта закрывается, он сначала открыт. Проект всегда приносится к переднему плану в Окончательном варианте. Если никакой файл проекта не указан, Final Cut Pro возвращает XML для переднего больше всего проекта.
Параметры
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Проект воздействовать на.
kFCPXMLDataVersion 'xmlV' typeFloat. Версия Final Cut Pro Формат обмена XML для использования. Если неуказанный, то текущая версия используется.
Результаты
kFCPXMLDataKey 'xmlD' typeUTF8Text. Данные XML для проекта, представленного как строка UTF-8.


Получите элемент XML (kFCPGetItemXML 'gXML')
Описание
Запрашивает представление XML единственного элемента в проекте Final Cut Pro UUID.
Параметры
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Проект воздействовать на. Если Вы опускаете этот параметр и указываете параметр UUID только, Окончательный вариант ищет элемент в переднем больше всего проекте.
kFCPItemUUID 'fcIU' typeUTF8Text. UUID для элемента. Если Вы опускаете этот параметр и указываете проект, который открыт, Окончательный вариант возвращает XML для передней больше всего последовательности, является ли эта последовательность в указанном проекте или нет. Если Вы опускаете этот параметр и указываете проект, закрывающийся, Окончательный вариант открывает проект, делает любую открытую последовательность в той передней стороне больше всего проекта и возвращает XML для той последовательности.
kFCPXMLDataVersion 'xmlV' typeFloat. Версия Final Cut Pro Формат обмена XML для использования. Если неуказанный, то текущая версия используется.
Результаты
kFCPXMLDataKey 'xmlD' typeUTF8Text. Данные XML для элемента, представленного как строка UTF-8.


Импортируйте XML (kFCPImportXMLToDocument 'iXML')
Описание
Непосредственно импорт XML в Final Cut Pro, не ссылаясь на XML экономил на диске. Можно указать определенный файл проекта для импорта XML в. Если Вы не указываете файл, XML импортируется в новый, неназванный проект. Используя updatebehavior, можно указать, заменяют ли импортированные элементы элементы в проекте или просто добавляются к проекту.
Параметр
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Проект импортировать в. Если неуказанный, новый неназванный проект создается.
kFCPXMLDataKey 'xmlD' typeUTF8Text. Данные XML для импорта представленный как строка UTF-8. Обратите внимание на то, что это - буфер данных XML, не URL. Посмотрите пример кода для Событий Apple в Final Cut Pro.


Получите все эффекты (kFCPGetAllEffectsXML 'eFXX')
Описание
Позволяет приложению запрашивать представление XML всех установленных эффектов.
Параметры
kFCPXMLDataVersion 'xmlV' typeFloat. Дополнительное значение, управляющее версией Формата обмена XML для использования. Значение по умолчанию является текущей версией.
Результаты
kFCPXMLDataKey 'xmlD' typeUTF8Text. Данные XML, представленные как строка UTF-8.Примечание: XML для эффектов не может быть импортирован назад в Final Cut Pro.


Медиа-файл обновления (kFCPUpdateMediaFile 'udfF')
Описание
Запросы Final Cut Pro, чтобы исследовать время изменения медиа-файла и выполнить тихое переподключение или обновление при необходимости.
Параметры
kFCPMediaFileKey 'fcpM' typeFSRef/typeFileURL. Медиа-файл, чтобы исследовать и обновить.
kFCPUpdateFileIgnoreModDate 'fIMD'. Дополнительное обновление управления булева флага. TRUE означает, что Final Cut Pro обновляет медиа-файл независимо от своего времени изменения; FALSE означает, что Final Cut Pro обновляет медиа-файл, только если это изменилось с прошлого раза Окончательный вариант исследовал файл. Настройкой по умолчанию является FALSE.


Выберите Item (kFCPSelectItemInBrowser 'fcSI')
Описание
Выделяет указанный элемент или элементы в Окне браузера. Используйте это событие для обеспечения одного или более элементов к вниманию пользователя.
Параметры
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Файл проекта для работы на.
kFCPItemUUID 'fcIU' typeUTF8Text. UUID единственного элемента для выбора в Браузере.
kFCPItemsToSelectList 'fcSL' AEDescList. Список, указывающий многократные элементы для выбора одновременно. Параметр является AEList AERecords, каждый из которых имеет сингл kFCPItemUUID параметр.
Примечание: Можно использовать любого a kFCPItemUUID параметр или a kFCPItemsToSelectList параметр, но не оба.


Открытая позиция (kFCPOpenItemInProject 'fcOI')
Описание
Открывает указанный элемент. Клипы открываются в Средстве просмотра; последовательности во Временной шкале; стеллажи в отдельном окне.
Параметры
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Файл проекта для работы на.
kFCPItemUUID 'fcIU' typeUTF8Text. UUID элемента для открытия.


Найдите элементы (kFCPFindItemsInProject 'ffcP')
Описание
Поиски элементов. Если окно Find Results активно, поиск имеет место среди элементов в этом окне. Иначе, поиск имеет место в Браузере. Результаты поиска выведены на экран в новом окне Find Results. Это позволяет Вам принести многократные элементы к вниманию пользователя когда-то.
kFCPFindParameters список содержит одну или более записей, составляющих критерии поиска. Можно использовать многократные записи для точного управления полученными результатами. Например, одна запись может указать, что столбец Name элементов должен запустить со строки 'Камеру', и следующая запись указывает, что столбец Notes не должен содержать строку, 'плохо берут'. Каждая запись критериев составлена из четырех элементов: строка для поиска, способ соответствовать строку, столбец для поиска, и использовать ли соответствие или несоответствие элементов. Обратите внимание на то, что каждая запись критериев является AERecord, таким образом, список состоит из записей, каждая из которых содержит несколько параметров.
Параметры
kFCPProjectFileKey 'fcpP' typeFSRef/typeFileURL. Файл проекта для работы на.
kFCPFindLogicMode 'fndL' typeSInt32. Логический режим для поиска. Можно объединить критерии поиска с помощью AND (все критерии применяются), или OR (только один критерий должен применяться). Возможные значения:
  • kFCPFindLogicAnd = 0

  • kFCPFindLogicOr = 1

kFCPFindParameters 'fndP' typeAEList typeAERecord. Список AEDescList критериев AERecords. Список составлен из одной или более записей «критериев», определяющих строку для поиска, логика сопоставления строк для использования, найти ли соответствие элементов или элементов, не соответствующих (т.е. 'пропуск'), и имя Столбца браузера для поиска в. Существует четыре критерия, которые можно указать: kFCPFindSearchString, kFCPFindOmitCriteria, kFCPFindMatchMode и kFCPFindColumnName .
Критерии поиска
kFCPFindSearchString 'fndS' typeUFT8Text. Строка для поиска.
kFCPFindOmitCriteria 'fndO' typeSInt32. Путем seach критерии должны использоваться. Средние значения нулевого значения находят элементы, соответствующие строку поиска. Средние значения ненулевого значения находят элементы, не соответствующие строку seach. (Т.е. пропустите любой элемент, соответствующий строку поиска.)
kFCPFindMatchMode 'fndM' typeSInt32. Путем строка должна быть соответствующей. Действительные доступы:
  • kFCPFindMatchStartsWith = (1 << 0)

  • kFCPFindMatchContains = (1 << 1)

  • kFCPFindMatchEquals = (1 << 2 )

  • kFCPFindMatchEndsWith = (1 << 3)

  • kFCPFindMatchLessThan = (1 << 4)

  • kFCPFindMatchGreaterThan = (1 << 5)

kFCPFindColumnName 'fndC' typeUTF8Text. Ограничивает поиск определенным Столбцом браузера. Если не указанный или если переданная строка не является действительным доступом, то все столбцы ищутся. Допустимые имена столбцов: name, duration, in, out, start, end, scene, shottake, lognote, good, label, label2, mastercomment1, mastercomment2, mastercomment3, mastercomment4, clipcommenta, clipcommentb.