ApertureEditManager

Обзор

Определение протокола для интерфейса Aperture Edit. Необходимо только вызвать эти методы от основного потока.

Методы

- addCustomMetadata:toVersions:

Добавляют указанные пары ключ/значение к Пользовательским Метаданным для этого изображения.

- addHierarchicalKeywords:toVersions:

Передача в массиве массивов, указывающих иерархию ключевого слова.

- apertureWindow

Главное окно Апертуры возвратов

- cancelEditSession

Подобный-endEditSession, но автоматически удаляет любые доступные для редактирования версии, создаваемые плагином во время этого сеанса.

- canImport

YES возвратов, если Апертура позволяет плагину импортировать изображения в текущий альбом; НЕТ иначе.

- deleteVersions:

Удаляет указанные версии и их основные файлы от библиотеки пользователя.

- editableVersionIds

Возвращает уникальные идентификаторы, которые может отредактировать плагин.

- editableVersionsOfVersions:requestedFormat:stackWithOriginal:

Возвращает массив уникальных идентификаторов.

- editableVersionsOfVersions:stackWithOriginal:

Возвращает массив уникальных идентификаторов.

- endEditSession

Уведомляет Апертуру, что плагин завершил свою работу.

- importedVersionIds

Возвращает уникальные идентификаторы изображений, которые плагин импортировал во время сеанса.

- importImageAtPath:

Асинхронно импортирует изображение в текущий альбом.

- importImageAtPath:referenced:stackWithVersions:

Асинхронно импортирует изображение в текущий альбом.

- pathOfEditableFileForVersion:

Возвращает путь к файлу, что плагин должен чтение-запись для этой версии.

- propertiesWithoutThumbnailForVersion:

Доступы все доступные свойства для указанного изображения.

- selectedVersionIds

Возвращает уникальные идентификаторы версий пользователь, выбранный в Апертуре.

- setUserDefaultsValue:forKey:

Устанавливает пользовательские предпочтительные значения.

- thumbnailForVersion:size:

Возвращает миниатюру для изображения.

- userDefaultsObjectForKey:

Читает указанные значения пользовательских настроек.

addCustomMetadata:toVersions:

Добавляют указанные пары ключ/значение к Пользовательским Метаданным для этого изображения.

- (void)addCustomMetadata:(NSDictionary *)customMetadata 
        toVersions:(NSArray *)versionUniqueIDs; 

Параметры

Обсуждение

Эти данные появляются на вкладке «Other» в инспекторе метаданных. Если изображение уже имеет значение для указанного ключа, оно обновляется к новому значению

addHierarchicalKeywords:toVersions:

Передача в массиве массивов, указывающих иерархию ключевого слова.

- (void)addHierarchicalKeywords:(NSArray *)hierarchicalKeywords 
        toVersions:(NSArray *)versionUniqueIDs; 

Параметры

apertureWindow

Главное окно Апертуры возвратов

- (NSWindow *)apertureWindow; 

Возвращаемое значение

NSWindow.

Обсуждение

Плагин Редактирования использует этот метод в случае, если это должно представить лист.

cancelEditSession

Подобный-endEditSession, но автоматически удаляет любые доступные для редактирования версии, создаваемые плагином во время этого сеанса.

- (void)cancelEditSession; 

Обсуждение

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

canImport

YES возвратов, если Апертура позволяет плагину импортировать изображения в текущий альбом; НЕТ иначе.

- (BOOL)canImport; 

Возвращаемое значение

Булевская переменная.

Обсуждение

Например, Апертура не позволяет импорт в умные альбомы.

deleteVersions:

Удаляет указанные версии и их основные файлы от библиотеки пользователя.

- (void)deleteVersions:(NSArray *)versionUniqueIDs; 

Параметры

Обсуждение

Апертура только выполняет эту работу для версий, создаваемых плагином во время текущего сеанса. Проигнорированы уникальные идентификаторы для любых изображений, не создававшихся плагином. Это включает изображения, которые были уже доступны для редактирования, который изменил плагин. Обратите внимание на то, что этот вызов удалит основные файлы для доступных для редактирования версий, ссылаются ли на те ведущие устройства или нет. Если теми файлами будут управлять (не ссылаемый), Однако это только удалит основные файлы импортированных версий.

editableVersionIds

Возвращает уникальные идентификаторы, которые может отредактировать плагин.

- (NSArray *)editableVersionIds; 

Возвращаемое значение

NSArray.

Обсуждение

Массив может включать некоторые изображения пользователь, выбранный, если они были уже отмечены как доступные для редактирования.

editableVersionsOfVersions:requestedFormat:stackWithOriginal:

Возвращает массив уникальных идентификаторов.

- (NSArray *)editableVersionsOfVersions:(NSArray *)versionUniqueIDs 
        requestedFormat:(ApertureImageFormat)format 
        stackWithOriginal:(BOOL)stackWithOriginal; 

Параметры

Возвращаемое значение

NSArray. Каждая запись в массиве содержит словарь свойств для доступной для редактирования версии.

Обсуждение

Если изображение было уже доступно для редактирования, и пользователь не хотел гарантировать копию (путем содержания функциональной клавиши при выборе плагина из меню) тогда, этот метод возвратится, уникальный идентификатор передал в для той версии. Иначе, этот метод говорит Апертуре выписывать доступное для редактирования изображение в формате, указанном форматом, и создает новую запись в библиотеке пользователя. Обычно, плагин тогда вызвал бы-pathOfEditableFileForVersion: для уникальных идентификаторов, возвращенных из этого метода или-propertiesWithoutThumbnailForVersion: и-thumbnailForVersion: методы.

editableVersionsOfVersions:stackWithOriginal:

Возвращает массив уникальных идентификаторов.

- (NSArray *)editableVersionsOfVersions:(NSArray *)versionUniqueIDs 
        stackWithOriginal:(BOOL)stackWithOriginal; 

Параметры

Возвращаемое значение

NSArray. Каждая запись в массиве содержит словарь свойств для доступной для редактирования версии.

Обсуждение

Если изображение было уже доступно для редактирования, и пользователь не хотел гарантировать копию (путем содержания функциональной клавиши при выборе плагина из меню), то этот метод возвращается, уникальный идентификатор передал в для той версии. Иначе, этот метод говорит Апертуре выписывать доступное для редактирования изображение в формате, указанном в предпочтениях пользователя (PSD или TIFF), и создает новую запись в библиотеке пользователя. Обычно, плагин тогда вызывает-pathOfEditableFileForVersion: для уникальных идентификаторов, возвращенных из этого метода или-propertiesWithoutThumbnailForVersion: и-thumbnailForVersion: методы.

endEditSession

Уведомляет Апертуру, что плагин завершил свою работу.

- (void)endEditSession; 

Обсуждение

Плагин должен быть готов к dealloc во время этого вызова и не должен быть выполняющимися задачами ни на каких других потоках или чем-либо на цикле выполнения, который может перезвонить после того, как этот вызов закончен.

importedVersionIds

Возвращает уникальные идентификаторы изображений, которые плагин импортировал во время сеанса.

- (NSArray *)importedVersionIds; 

Возвращаемое значение

NSArray.

importImageAtPath:

Асинхронно импортирует изображение в текущий альбом.

- (void)importImageAtPath:(NSString *)imagePath referenced:(BOOL)isReferenced 
        stackWithVersions:(NSArray *)versionUniqueIdsToStack; 

Параметры

Обсуждение

Это вызовы метода-editManager:didImportImageAtPath:versionUniqueID: метод после успешного завершения или-editManager:didNotImportImageAtPath:error: если импорт был неуспешен. Если-canImport возвращается нет, этот метод ничего не делает, и плагин не получает обратный вызов. Плагин не должен вызывать-endEditSession или-cancelEditSession, пока это не получило обратный вызов импорта.

См. также

importImageAtPath:referenced:stackWithVersions:

Асинхронно импортирует изображение в текущий альбом.

- (void)importImageAtPath:(NSString *)imagePath referenced:(BOOL)isReferenced 
        stackWithVersions:(NSArray *)versionUniqueIdsToStack; 

Параметры

Обсуждение

Это вызовы метода-editManager:didImportImageAtPath:versionUniqueID: метод после успешного завершения или-editManager:didNotImportImageAtPath:error: если импорт был неуспешен. Если-canImport возвращается нет, этот метод ничего не делает, и плагин не получает обратный вызов. Плагин не должен вызывать-endEditSession или-cancelEditSession, пока это не получило обратный вызов импорта.

См. также

pathOfEditableFileForVersion:

Возвращает путь к файлу, что плагин должен чтение-запись для этой версии.

- (NSString *)pathOfEditableFileForVersion:(NSString *)versionUniqueID; 

Параметры

Возвращаемое значение

NSString

Обсуждение

Если эта версия не доступна для редактирования, ноль возвратов метода, этот путь также доступен через словарь свойств, но.

propertiesWithoutThumbnailForVersion:

Доступы все доступные свойства для указанного изображения.

- (NSDictionary *)propertiesWithoutThumbnailForVersion:(NSString *)versionUniqueID; 

Параметры

Возвращаемое значение

NSDictionary

Обсуждение

Изображение миниатюр не включено. Можно получить миниатюру с помощью метода-thumbnailForVersion:.

selectedVersionIds

Возвращает уникальные идентификаторы версий пользователь, выбранный в Апертуре.

- (NSArray *)selectedVersionIds; 

Возвращаемое значение

NSArray.

Обсуждение

IDs упорядочивается в том же порядке, что пользователь выбрал их, кроме основного выбора является всегда первым.

setUserDefaultsValue:forKey:

Устанавливает пользовательские предпочтительные значения.

- (void)setUserDefaultsValue:(id)value forKey:(NSString *)key; 

Параметры

Обсуждение

Предпочтения записей оценивают в предпочтительный файл, определенный для плагина, не предпочтительного файла Апертуры.

thumbnailForVersion:size:

Возвращает миниатюру для изображения.

- (NSImage *)thumbnailForVersion:(NSString *)versionUniqueID 
        size:(ApertureExportThumbnailSize)size; 

Параметры

Возвращаемое значение

NSImage.

Обсуждение

Некоторые плагины могут принять решение воздействовать на большую миниатюру и не запросить доступную для редактирования версию изображения, пока не сделан пользователь.

userDefaultsObjectForKey:

Читает указанные значения пользовательских настроек.

- (id)userDefaultsObjectForKey:(NSString *)key; 

Параметры

Возвращаемое значение

ID

Обсуждение

Читает указанные предпочтительные значения из предпочтительного файла, определенного для плагина, не предпочтительного файла Апертуры.