QCPlugIn
QCPlugIn
класс обеспечивает базовый класс для разделения на подклассы для записи пользовательских Кварцевых патчей Композитора. Вы реализуете пользовательский патч путем разделения на подклассы QCPlugIn
, переопределение надлежащих методов, упаковывая код как NSBundle
объект и установка пакета в надлежащем расположении. Пакет может содержать больше чем один подкласс QCPlugIn
, разрешение Вам обеспечить комплект пользовательских патчей в одном пакете. Пользовательское Руководство по программированию Патча Композитора кварца обеспечивает подробные инструкции о том, как создать и упаковать пользовательский патч. Ссылка класса QCPlugIn дополняет информацию в руководстве по программированию.
Методы имели отношение к выполнению пользовательского патча (вызванный, когда Кварцевый механизм Композитора представляет), передаются непрозрачный объект, соответствующий QCPlugInContext Protocol
протокол. Этот объект представляет контекст выполнения QCPlugIn
объект. Вы не должны сохранять контекст выполнения или использовать его за пределами объема метода выполнения, которому он передается.
Оператор импорта
Swift
import Quartz
Objective C
@import Quartz;
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает режим выполнения пользовательского патча.
Объявление
Swift
class func executionMode() -> QCPlugInExecutionMode
Objective C
+ (QCPlugInExecutionMode)executionMode
Возвращаемое значение
Режим выполнения пользовательского патча. Посмотрите
“Execution Modes”
для констант можно возвратиться.Обсуждение
Необходимо реализовать этот метод, чтобы определить, является ли пользовательский патч провайдером, процессором или потребителем.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает режим времени для пользовательского патча.
Возвращаемое значение
Режим времени пользовательского патча. Посмотрите
“Time Modes”
для констант можно возвратиться.Обсуждение
Необходимо реализовать этот метод, чтобы определить, не зависите ли Вы, пользовательский патч зависит вовремя, вовремя или требуетесь время для бездействия.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Выполняет обработку или рендеринг задач, подходящих для пользовательского патча.
Объявление
Swift
func execute(_
context
: QCPlugInContext!, atTimetime
: NSTimeInterval, withArgumentsarguments
: [NSObject : AnyObject]!) -> BoolObjective C
- (BOOL)execute:(id<QCPlugInContext>)
context
atTime:(NSTimeInterval)time
withArguments:(NSDictionary *)arguments
Параметры
context
Непрозрачный объект, соответствуя
QCPlugInContext Protocol
протокол, представляющий контекст выполненияQCPlugIn
объект. Не сохраняйте этот объект или используйте его за пределами объема этого метода.time
Интервал выполнения.
arguments
Словарь параметров, которые могут использоваться во время выполнения. Посмотрите
“Execution Arguments”
.Возвращаемое значение
NO
false
указывает, что пользовательский патч не смог выполниться успешно. В этом случае Кварцевый механизм Композитора прекращает представлять текущий кадр.Обсуждение
Кварцевый механизм Композитора вызывает этот метод каждый раз, когда Ваш пользовательский патч должен выполниться. Необходимо реализовать этот метод. Метод должен выполнить любые задачи, являются подходящими для пользовательского патча, такими как:
чтение значений от входных портов
вычисления выходных значений
обновление значений на выходных портах
рендеринг к контексту выполнения
Например, реализации этого метода, посмотрите Кварцевого Композитора Пользовательское Руководство по программированию Патча.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Позволяет Вам выполнять пользовательские задачи установки, прежде чем Кварцевый механизм Композитора начнет представлять.
Объявление
Swift
func startExecution(_
context
: QCPlugInContext!) -> BoolObjective C
- (BOOL)startExecution:(id<QCPlugInContext>)
context
Параметры
context
Непрозрачный объект, соответствуя
QCPlugInContext Protocol
протокол, представляющий контекст выполненияQCPlugIn
объект. Не сохраняйте этот объект или используйте его за пределами объема этого метода.Возвращаемое значение
NO
false
указывает, что фатальная ошибка произошла и препятствует тому, чтобы запустился Кварцевый механизм Композитора.Обсуждение
Когда Ваш пользовательский патч начинает представлять, Кварцевый механизм Композитора вызывает этот метод. Можно дополнительно переопределить этот метод выполнения для выполнения задач установки.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Позволяет Вам выполнять пользовательские задачи когда выполнение
QCPlugIn
объект возобновляется.Объявление
Swift
func enableExecution(_
context
: QCPlugInContext!)Objective C
- (void)enableExecution:(id<QCPlugInContext>)
context
Параметры
context
Непрозрачный объект, соответствуя
QCPlugInContext Protocol
протокол, представляющий контекст выполненияQCPlugIn
объект. Не сохраняйте этот объект или используйте его за пределами объема этого метода.Обсуждение
Когда результаты начинают вытягиваться от пользовательского патча, Кварцевый механизм Композитора вызывает этот метод. Можно дополнительно переопределить этот метод выполнения для выполнения пользовательских задач в то время.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Позволяет Вам выполнять пользовательские задачи когда выполнение
QCPlugIn
объект приостанавливается.Объявление
Swift
func disableExecution(_
context
: QCPlugInContext!)Objective C
- (void)disableExecution:(id<QCPlugInContext>)
context
Параметры
context
Непрозрачный объект, соответствуя
QCPlugInContext Protocol
протокол, представляющий контекст выполненияQCPlugIn
объект. Не сохраняйте этот объект или используйте его за пределами объема этого метода.Обсуждение
Когда результаты больше не вытягивают от пользовательского патча, Кварцевый механизм Композитора вызывает этот метод. Можно дополнительно переопределить этот метод выполнения для выполнения пользовательских задач в то время.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Позволяет Вам выполнять пользовательские задачи когда
QCPlugIn
возразите прекращает выполняться.Объявление
Swift
func stopExecution(_
context
: QCPlugInContext!)Objective C
- (void)stopExecution:(id<QCPlugInContext>)
context
Параметры
context
Непрозрачный объект, соответствуя
QCPlugInContext Protocol
протокол, представляющий контекст выполненияQCPlugIn
объект. Не сохраняйте этот объект или используйте его за пределами объема этого метода.Обсуждение
Кварцевый механизм Композитора вызывает этот метод, когда это прекращает выполняться. Можно дополнительно переопределить этот метод выполнения для выполнения задач очистки.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает словарь, содержащий строки для пользовательского интерфейса, описывающие пользовательский патч.
Объявление
Swift
class func attributes() -> [NSObject : AnyObject]!
Objective C
+ (NSDictionary *)attributes
Возвращаемое значение
Словарь может содержать один или больше этих ключей вместе с надлежащей строкой:
QCPlugInAttributeNameKey
,QCPlugInAttributeDescriptionKey
, иQQCPlugInAttributeCopyrightKey
.Обсуждение
Рекомендуется реализовать этот метод для улучшения опыта тех, кто использует пользовательский патч. Строка названия атрибута, которую Вы обеспечиваете, выведена на экран в Кварцевом редакторе Композитора окно, когда пользовательское имя патча выбрано в Создателе Патча (см. рис.). Ключ описания атрибута выведен на экран в информационной области инспектора для пользовательского патча.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает словарь, содержащий строки для пользовательского интерфейса, описывающие дополнительные атрибуты для портов, создаваемых из свойств.
Объявление
Objective C
+ (NSDictionary *)attributesForPropertyPortWithKey:(NSString *)
key
Параметры
key
Имя свойства.
Возвращаемое значение
Словарь, содержащий пары ключ/значение для атрибутов порта. Ключи должны быть один или больше констант, определенных в Атрибутах порта Ввода и вывода.
Обсуждение
Рекомендуется реализовать этот метод для улучшения опыта тех, кто использует пользовательский патч. Когда пользователь нависает указатель над портом свойства на Вашем пользовательском патче, атрибуты появляются в теге справки. Как минимум необходимо обеспечить читаемое пользователем имя для порта. Могло бы также быть полезно обеспечить значение по умолчанию, минимум и максимальные значения для порта.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Создает и возвращает контроллер представления для области Settings пользовательского патча.
Объявление
Swift
func createViewController() -> QCPlugInViewController!
Objective C
- (QCPlugInViewController *)createViewController
Возвращаемое значение
Контроллер представления для пользовательского патча. Кварцевый Композитор выпускает контроллер, когда он больше не необходим. Если необходимо, можно возвратить подкласс
QCPlugInViewController
, но это это не обычно сделанный.Обсуждение
Это расширение
QCPlugInViewController
класс предоставляет поддержку пользовательского интерфейса для области Settings инспектора для пользовательского патча. Если пользовательский патч обеспечивает область Settings, необходимо переопределить этот метод.QCPlugInViewController
возразите действиям как контроллеру для привязки Какао между пользовательским экземпляром патча (модель) иNSView
это содержит средства управления. Это загружает файл пера из пакета.Реализация является прямой. Вы выделяете a
QCPlugInViewController
возразите, инициализируйте его и обеспечьте имя файла пера, содержащего пользовательский интерфейс для области Settings.Обратите внимание на то, что этот метод следует, Базовая Основа «создают» правило. Посмотрите политику владения в Руководстве по программированию управления памятью для Базовой Основы.
Например, если имя файла пера, содержащее область настроек,
MySettingsPane.nib
, реализация:- (QCPlugInViewController *) createViewController
{
return [[QCPlugInViewController alloc] initWithPlugIn:self
viewNibName:@"MySettingsPane"];
}
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает ключи для внутренних настроек пользовательского патча.
Возвращаемое значение
Массив ключей используется для кодирования значения ключа (KVC) внутренних настроек.
Обсуждение
Если патч обеспечивает область Settings, необходимо переопределить этот метод. Это вводит, используются для автоматической сериализации внутренних настроек и также используются
QCPlugInViewController
экземпляр для области Settings. Реализация является прямой; ключи являются строками, представляющими переменные экземпляра, используемые для области Settings. Например,plugInKeys
метод для этих переменных экземпляра:@property(ivar, byref) NSColor * systemColor;
@property(ivar, byref) NSConfiguration * systemConfiguration;
:
+ (NSArray*) plugInKeys
{
return [NSArray arrayWithObjects: @"systemColor",
@"systemConfiguration",
nil];
}
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Обеспечивает пользовательскую сериализацию для патча внутренние настройки, не соответствующие
NSCoding
протокол.Объявление
Swift
func serializedValueForKey(_
key
: String!) -> AnyObject!Objective C
- (id)serializedValueForKey:(NSString *)
key
Параметры
key
Ключ для значения для получения.
Возвращаемое значение
Также
nil
или значение это совместимо со списками свойств:NSString
,NSNumber
,NSDate
,NSData
,NSArray
, илиNSDictionary
.Обсуждение
Если Ваш патч имеет внутренние настройки, не соответствующие
NSCoding
протокол, необходимо реализовать этот метод.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Обеспечивает пользовательскую десериализацию для патча внутренние настройки, ранее сериализированные с помощью метода
serializedValueForKey:
.Объявление
Swift
func setSerializedValue(_
serializedValue
: AnyObject!, forKeykey
: String!)Objective C
- (void)setSerializedValue:(id)
serializedValue
forKey:(NSString *)key
Параметры
serializedValue
Значение для десериализации.
key
Ключ для значения для десериализации.
Обсуждение
Если Ваш патч имеет внутренние настройки, не соответствующие
NSCoding
протокол, необходимо реализовать этот метод. После десериализации значения необходимо вызвать[self set:value forKey:key]
установить соответствующую внутреннюю установку пользовательского экземпляра патча к десериализованному значению.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Добавляет входной порт указанного типа и связывает ключ и атрибуты с портом.
Объявление
Swift
func addInputPortWithType(_
type
: String!, forKeykey
: String!, withAttributesattributes
: [NSObject : AnyObject]!)Objective C
- (void)addInputPortWithType:(NSString *)
type
forKey:(NSString *)key
withAttributes:(NSDictionary *)attributes
Параметры
type
Тип порта. Посмотрите
“Port Input and Output Types”
.key
Ключ для соединения с портом.
attributes
Словарь атрибутов для порта. Посмотрите
“Input and Output Port Attributes”
. Несмотря на то, что словарь является дополнительным, рекомендуется, чтобы обеспечили атрибуты для улучшения опыта тех, кто использует пользовательский патч. Когда пользователь нависает указатель над портом свойства на Вашем пользовательском патче, атрибуты появляются в теге справки. (См.attributesForPropertyPortWithKey:
.) Передачаnil
если Вы не хотите обеспечивать атрибуты.Обсуждение
Этот метод выдает исключение, если вызвано из
execute:atTime:withArguments:
метод или если уже существует порт ввода или вывода с тем ключом.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Удаляет входной порт для данного ключа.
Объявление
Swift
func removeInputPortForKey(_
key
: String!)Objective C
- (void)removeInputPortForKey:(NSString *)
key
Параметры
key
Ключ связался с портом, который Вы хотите удалить.
Обсуждение
Этот метод выдает исключение если из
execute:atTime:withArguments:
метод, если нет входного порта с тем ключом, или если порт создается из свойства.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Добавляет выходной порт указанного типа и связывает ключ и атрибуты с портом.
Объявление
Swift
func addOutputPortWithType(_
type
: String!, forKeykey
: String!, withAttributesattributes
: [NSObject : AnyObject]!)Objective C
- (void)addOutputPortWithType:(NSString *)
type
forKey:(NSString *)key
withAttributes:(NSDictionary *)attributes
Параметры
type
Тип порта. Посмотрите
“Port Input and Output Types”
.key
Ключ для соединения с портом.
attributes
Словарь атрибутов для порта. Посмотрите
“Input and Output Port Attributes”
. Несмотря на то, что словарь является дополнительным, рекомендуется, чтобы обеспечили атрибуты для улучшения опыта тех, кто использует пользовательский патч. Когда пользователь нависает указатель над портом свойства на Вашем пользовательском патче, атрибуты появляются в теге справки. (См.attributesForPropertyPortWithKey:
.) Передачаnil
если Вы не хотите обеспечивать атрибуты.Обсуждение
Этот метод выдает исключение, если вызвано из
execute:atTime:withArguments:
метод или если уже существует выходной порт с тем ключом.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Удаляет выходной порт для данного ключа.
Объявление
Swift
func removeOutputPortForKey(_
key
: String!)Objective C
- (void)removeOutputPortForKey:(NSString *)
key
Параметры
key
Ключ связался с портом, который Вы хотите удалить.
Обсуждение
Этот метод выдает исключение, если вызвано из
execute:atTime:withArguments:
метод, если нет выходного порта с тем ключом, или если порт создается из свойства.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Возвраты, изменилось ли значение входного порта начиная с последнего выполнения пользовательского патча.
Объявление
Swift
func didValueForInputKeyChange(_
key
: String!) -> BoolObjective C
- (BOOL)didValueForInputKeyChange:(NSString *)
key
Параметры
key
Ключ для входного порта, значение которого Вы хотите проверить.
Возвращаемое значение
YES
true
если значение на входном порту изменилось с прошлого разаexecute:atTime:withArguments:
метод вызвали; всегда возвратыNO
false
если вызвано за пределамиexecute:atTime:withArguments:
метод.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает текущую стоимость для входного порта.
Объявление
Swift
func valueForInputKey(_
key
: String!) -> AnyObject!Objective C
- (id)valueForInputKey:(NSString *)
key
Параметры
key
Ключ для входного порта Вы хотите проверить.
Возвращаемое значение
Значение связалось с ключом или
nil
если вызвано за пределамиexecute:atTime:withArguments:
метод.Обсуждение
Вы вызываете этот метод из Вашего
execute:atTime:withArguments:
метод для получения входных значений пользовательского патча.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Устанавливает значение выходного порта.
Объявление
Swift
func setValue(_
value
: AnyObject!, forOutputKeykey
: String!) -> BoolObjective C
- (BOOL)setValue:(id)
value
forOutputKey:(NSString *)key
Параметры
key
Ключ связался с выходным портом, значение которого Вы хотите установить.
Возвращаемое значение
YES
true
если успешный;NO
false
если вызвано за пределамиexecute:atTime:withArguments:
метод.Обсуждение
Вы вызываете этот метод из Вашего
execute:atTime:withArguments:
метод для установки выходных значений пользовательского патча.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Загружает Кварцевый пакет плагина Композитора из указанного пути.
Объявление
Swift
class func loadPlugInAtPath(_
path
: String!) -> BoolObjective C
+ (BOOL)loadPlugInAtPath:(NSString *)
path
Параметры
path
Расположение пакета.
Возвращаемое значение
YES
true
в случае успеха.Обсуждение
Вызовите этот метод, только если необходимо загрузить сменный пакет из нестандартного расположения. Обычно Вы не должны вызывать этот метод, потому что Кварцевый Композитор автоматически загружает пакеты, которые Вы устанавливаете в одном из следующих расположений:
/Library/Graphics/Quartz Composer Plug-Ins
~/Library/Graphics/Quartz Composer Plug-Ins
Если пакет уже загружается, этот метод ничего не делает. (Этот метод не загружается во всех средах. Веб-Набор, например, не может загрузить пользовательские патчи.)
Пакет может содержать больше чем один
QCPlugIn
подкласс. После того, как пакет загружается, каждыйQCPlugIn
подкласс появляется как патч в Кварцевой библиотеке патча Композитора.Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Регистры a
QCPlugIn
подкласс.Объявление
Swift
class func registerPlugInClass(_
aClass
: AnyClass!)Objective C
+ (void)registerPlugInClass:(Class)
aClass
Параметры
aClass
QCPlugIn
подкласс.Обсуждение
Вы вызываете этот метод, только если код для Вашего пользовательского патча смешан с Вашим кодом приложения, и Вы планируете только использовать пользовательский патч из своего приложения.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Возвраты и массив порта свойства вводят порядок, Вы хотите, чтобы они появились в пользовательском интерфейсе.
Объявление
Swift
class func sortedPropertyPortKeys() -> [AnyObject]!
Objective C
+ (NSArray *)sortedPropertyPortKeys
Возвращаемое значение
Порт свойства вводит порядок, Вы хотите, чтобы они появились в пользовательском интерфейсе.
Обсуждение
Переопределите этот метод, чтобы указать, что дополнительное упорядочивание для свойства базировало порты в пользовательском интерфейсе.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
Атрибуты для пользовательских патчей.
Объявление
Objective C
extern NSString* const QCPlugInAttributeNameKey; extern NSString* const QCPlugInAttributeDescriptionKey; extern NSString* const QCPlugInAttributeCopyrightKey;
Константы
-
QCPlugInAttributeNameKey
QCPlugInAttributeNameKey
Ключ для пользовательского имени патча. Присваиваемое значение
NSString
объект.Доступный в OS X v10.5 и позже.
-
QCPlugInAttributeDescriptionKey
QCPlugInAttributeDescriptionKey
Ключ для пользовательского описания патча. Присваиваемое значение
NSString
объект.Доступный в OS X v10.5 и позже.
-
QQCPlugInAttributeCopyrightKey
QQCPlugInAttributeCopyrightKey
Ключ для пользовательской информации об авторском праве патча. Присваиваемое значение
NSString
объект.
-
-
Атрибуты для портов ввода и вывода.
Объявление
Swift
let QCPortAttributeTypeKey: NSString! let QCPortAttributeNameKey: NSString! let QCPortAttributeMinimumValueKey: NSString! let QCPortAttributeMaximumValueKey: NSString! let QCPortAttributeDefaultValueKey: NSString! let QCPortAttributeMenuItemsKey: NSString!
Objective C
extern NSString* const QCPortAttributeTypeKey; extern NSString* const QCPortAttributeNameKey; extern NSString* const QCPortAttributeMinimumValueKey; extern NSString* const QCPortAttributeMaximumValueKey; extern NSString* const QCPortAttributeDefaultValueKey; extern NSString* const QCPortAttributeMenuItemsKey;
Константы
-
QCPortAttributeTypeKey
QCPortAttributeTypeKey
Ключ для типа порта. Присваиваемое значение может иметь любую из следующих констант:
QCPortTypeBoolean
,QCPortTypeIndex
,QCPortTypeNumber
,QCPortTypeString
,QCPortTypeColor
,QCPortTypeImage
, илиQCPortTypeStructure
.Доступный в OS X v10.4 и позже.
-
QCPortAttributeNameKey
QCPortAttributeNameKey
Ключ для имени порта. Присваиваемое значение
NSString
объект.Доступный в OS X v10.4 и позже.
-
QCPortAttributeMinimumValueKey
QCPortAttributeMinimumValueKey
Ключ для минимального значения порта. Присваиваемое значение
NSNumber
объект, указывающий минимальное численное значение, принятое портом.Доступный в OS X v10.4 и позже.
-
QCPortAttributeMaximumValueKey
QCPortAttributeMaximumValueKey
Ключ для максимального значения порта. Присваиваемое значение
NSNumber
объект, указывающий максимальное численное значение, принятое портом.Доступный в OS X v10.4 и позже.
-
QCPortAttributeDefaultValueKey
QCPortAttributeDefaultValueKey
Ключ для значения по умолчанию порта. Можно использовать этот ключ только для портов значения (булевская переменная, Индекс, Число, Цвет и Строка).
Доступный в OS X v10.5 и позже.
-
QCPortAttributeMenuItemsKey
QCPortAttributeMenuItemsKey
Ключ для пунктов меню. Присваиваемое значение является массивом строк, выведенных на экран в пользовательском интерфейсе как всплывающее меню, когда пользователь дважды щелкает по порту, как показано для Смешивающегося входного порта патча Billboard. Можно использовать этот ключ только для индексного порта.
Доступный в OS X v10.5 и позже.
-
-
Типы данных для портов ввода и вывода.
Объявление
Swift
let QCPortTypeBoolean: NSString! let QCPortTypeIndex: NSString! let QCPortTypeNumber: NSString! let QCPortTypeString: NSString! let QCPortTypeColor: NSString! let QCPortTypeImage: NSString! let QCPortTypeStructure: NSString!
Objective C
extern NSString* const QCPortTypeBoolean; extern NSString* const QCPortTypeIndex; extern NSString* const QCPortTypeNumber; extern NSString* const QCPortTypeString; extern NSString* const QCPortTypeColor; extern NSString* const QCPortTypeImage; extern NSString* const QCPortTypeStructure;
Константы
-
QCPortTypeBoolean
QCPortTypeBoolean
Тип порта для булева значения. Присваиваемое значение может быть
NSNumber
возразите или любой объект, отвечающий на-intValue
,-floatValue
, или-doubleValue
методы.Доступный в OS X v10.4 и позже.
-
QCPortTypeIndex
QCPortTypeIndex
Тип порта для индексного значения. Присваиваемое значение может быть
NSNumber
возразите или любой объект, отвечающий на-intValue
,-floatValue
, или-doubleValue
методы.Доступный в OS X v10.4 и позже.
-
QCPortTypeNumber
QCPortTypeNumber
Тип порта для числового значения. Присваиваемое значение может быть
NSNumber
возразите или любой объект, отвечающий на-intValue
,-floatValue
, или-doubleValue
методы.Доступный в OS X v10.4 и позже.
-
QCPortTypeString
QCPortTypeString
Тип порта для строки. Присваиваемое значение может быть
NSString
возразите или любой объект, отвечающий на-stringValue
или-description
методы.Доступный в OS X v10.4 и позже.
-
QCPortTypeColor
QCPortTypeColor
Тип порта для значения цвета. Присваиваемое значение должно быть
NSColor
объект.Доступный в OS X v10.4 и позже.
-
QCPortTypeImage
QCPortTypeImage
Доступный в OS X v10.4 и позже.
-
QCPortTypeStructure
QCPortTypeStructure
Тип порта для массива, словаря или другой структуры, такой как
NSArray
илиNSDictionary
объект.Доступный в OS X v10.4 и позже.
-
-
Поддерживаемые форматы пикселя изображения.
Объявление
Swift
let QCPlugInPixelFormatARGB8: NSString! let QCPlugInPixelFormatBGRA8: NSString! let QCPlugInPixelFormatRGBAf: NSString! let QCPlugInPixelFormatI8: NSString! let QCPlugInPixelFormatIf: NSString!
Objective C
extern NSString* const QCPlugInPixelFormatARGB8; extern NSString* const QCPlugInPixelFormatBGRA8; extern NSString* const QCPlugInPixelFormatRGBAf; extern NSString* const QCPlugInPixelFormatI8; extern NSString* const QCPlugInPixelFormatIf;
Константы
-
QCPlugInPixelFormatARGB8
QCPlugInPixelFormatARGB8
Формат ARGB8. Альфа-компонент сохранен в старших значащих битах каждого пикселя. Каждый пиксельный компонент составляет 8 битов. Для лучшей производительности используйте этот формат на основанных на PowerPC компьютерах Macintosh, поскольку это представляет порядка данных в памяти.
Доступный в OS X v10.5 и позже.
-
QCPlugInPixelFormatBGRA8
QCPlugInPixelFormatBGRA8
Формат BGRA8. Альфа-компонент сохранен в младших значащих битах каждого пикселя. Каждый пиксельный компонент составляет 8 битов. Для лучшей производительности используйте этот формат на ОСНОВАННЫХ НА INTEL-PC компьютерах Macintosh, поскольку это представляет порядка данных в памяти.
Доступный в OS X v10.5 и позже.
-
QCPlugInPixelFormatRGBAf
QCPlugInPixelFormatRGBAf
Формат RGBAf. Пиксельные компоненты представлены как значения с плавающей точкой.
Доступный в OS X v10.5 и позже.
-
QCPlugInPixelFormatI8
QCPlugInPixelFormatI8
Формат I8. Информация об интенсивности представлена как 8-разрядное значение.
Доступный в OS X v10.5 и позже.
-
QCPlugInPixelFormatIf
QCPlugInPixelFormatIf
Если формат. Информация об интенсивности представлена как значение с плавающей точкой.
Доступный в OS X v10.5 и позже.
-
-
Параметры методу
execute:atTime:withArguments:
.Объявление
Swift
let QCPlugInExecutionArgumentEventKey: NSString! let QCPlugInExecutionArgumentMouseLocationKey: NSString!
Objective C
extern NSString* const QCPlugInExecutionArgumentEventKey; extern NSString* const QCPlugInExecutionArgumentMouseLocationKey;
Константы
-
QCPlugInExecutionArgumentEventKey
QCPlugInExecutionArgumentEventKey
Ток
NSEvent
при наличии.Доступный в OS X v10.5 и позже.
-
QCPlugInExecutionArgumentMouseLocationKey
QCPlugInExecutionArgumentMouseLocationKey
Текущее расположение мыши (как
NSPoint
объект, хранивший вNSValue
объект) в нормализованных координатах относительно области просмотра контекста OpenGL ([0,1] x [0,1] с источником (0,0
) в нижнем левом углу).Доступный в OS X v10.5 и позже.
-
-
Режимы выполнения для пользовательских патчей.
Объявление
Swift
struct QCPlugInExecutionMode { init(_
value
: UInt32) var value: UInt32 }Objective C
typedef enum { kQCPlugInExecutionModeProvider = 1, kQCPlugInExecutionModeProcessor, kQCPlugInExecutionModeConsumer } QCPlugInExecutionMode;
Константы
-
kQCPlugInExecutionModeProvider
kQCPlugInExecutionModeProvider
Режим выполнения провайдера. Пользовательский патч выполняется по требованию — т.е. каждый раз, когда данные запрашиваются его, но самое большее один раз на кадр.
Доступный в OS X v10.5 и позже.
-
kQCPlugInExecutionModeProcessor
kQCPlugInExecutionModeProcessor
Режим выполнения процессора. Пользовательский патч выполняется каждый раз, когда его вводы изменяются или если изменение времени (принимающий это с временной зависимостью).
Доступный в OS X v10.5 и позже.
-
kQCPlugInExecutionModeConsumer
kQCPlugInExecutionModeConsumer
Потребительский режим выполнения. Пользовательский патч всегда выполняет предположение, что значение Разрешать входной порт
true
. (Порт Enable автоматически добавляется системой.)Доступный в OS X v10.5 и позже.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-
-
Режимы времени для пользовательских патчей.
Объявление
Swift
struct QCPlugInTimeMode { init(_
value
: UInt32) var value: UInt32 }Objective C
typedef enum { kQCPlugInTimeModeNone = 0, kQCPlugInTimeModeIdle, kQCPlugInTimeModeTimeBase } QCPlugInTimeMode;
Константы
-
kQCPlugInTimeModeNone
kQCPlugInTimeModeNone
Никакая зависимость времени. Пользовательский патч не зависит вовремя вообще. (Это не использует
time
параметрexecute:atTime:withArguments:
метод.)Доступный в OS X v10.5 и позже.
-
kQCPlugInTimeModeIdle
kQCPlugInTimeModeIdle
Зависимость времени простоя. Пользовательский патч не зависит вовремя, но нуждается в системе для выполнения его периодически. Например, если пользовательский патч соединяется с частью аппаратных средств, чтобы гарантировать, что это вытягивает данные от аппаратных средств, Вы установили бы пользовательскую зависимость времени патча в режим времени простоя. На сей раз режим обычно используется с провайдерами.]]
Доступный в OS X v10.5 и позже.
-
kQCPlugInTimeModeTimeBase
kQCPlugInTimeModeTimeBase
Зависимость от основы времени. Пользовательский патч действительно зависит вовремя явно и определил основу времени системой. (Это использует
time
параметрexecute:atTime:withArguments:
метод.)Доступный в OS X v10.5 и позже.
Оператор импорта
Objective C
@import Quartz;
Swift
import Quartz
Доступность
Доступный в OS X v10.5 и позже.
-