ADC Home > Reference Library > Reference > Apple Applications > Final Cut Pro/Final Cut Express > FxPlug Reference

 


FxParameterRetrievalAPI

Declared In:

Introduction

Defines the functions the application provides to retrieve parameter values.

Discussion

This is version 1 of the FxParameterRetrievalAPI protocol.

NOTE: The -getAngle:fromParm:atTime: method has been deprecated. Please use -getFloatValue: instead.



Methods

-getBitmap:layerOffsetX:layerOffsetY:requestInfo:fromParm:atTime:
Gets a bitmap image from a parameter. This method allocates memory for the image that the plug-in should release when processing is complete.
-getBoolValue:fromParm:atTime:
Gets a boolean value from a parameter.
-getCustomParameterValue:fromParm:
Gets an opaque value object from a custom parameter.
-getFloatValue:fromParm:atTime:
Gets a floating point value from a parameter.
-getIntValue:fromParm:atTime:
Gets an integer value from a parameter.
-getParameterFlags:fromParm:
Gets current state of a parameter.
-getRedValue:GreenValue:BlueValue:AlphaValue:fromParm:atTime:
Gets RGBA color value (in 0.0 - 1.0 floating point) from a parameter.
-getRedValue:GreenValue:BlueValue:fromParm:atTime:
Gets RGB color values (in 0.0 - 1.0 floating point) from a parameter.
-getTexture:layerOffsetX:layerOffsetY:requestInfo:fromParm:atTime:
Gets a texture image from a parameter. This method allocates memory for the image that the plug-in should release when processing is complete.
-getXValue:YValue:fromParm:atTime:
Gets the xy position value (in 0.0 - 1.0 floating point) from a parameter.

getBitmap:layerOffsetX:layerOffsetY:requestInfo:fromParm:atTime:


Gets a bitmap image from a parameter. This method allocates memory for the image that the plug-in should release when processing is complete.

- (BOOL)getBitmap:(FxBitmap **)image layerOffsetX:(double *)offsetX layerOffsetY:(double *)offsetY requestInfo:(FxRenderInfo)info fromParm:(UInt32)parmID atTime:(double)time; 
Parameters
image
Pointer to the location of the bitmap image.
offsetX
X value for the bottom left corner of this image in layer space. If this pointer is NULL, no translation is calculated.
offsetY
Y value for the bottom left corner of this image in layer space. If this pointer is NULL, no translation is calculated.
info
Information about the requested image, including quality, scale and bit depth.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the image.
Return Value

Returns YES if the image is retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


getBoolValue:fromParm:atTime:


Gets a boolean value from a parameter.

- (BOOL)getBoolValue:(BOOL *)value fromParm:(UInt32)parmID atTime:(double)time; 
Parameters
value
Pointer to the plug-in variable for the value.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the value.
Return Value

Returns YES if the value is retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


getCustomParameterValue:fromParm:


Gets an opaque value object from a custom parameter.

- (BOOL)getCustomParameterValue:(id <NSCoding> *)value fromParm:(UInt32)parmId; 
Parameters
value
Pointer to the id to receive the value object.
parmId
Unique identifier for the parameter.
Return Value

Returns YES if the value is retrieved successfully; NO otherwise.


getFloatValue:fromParm:atTime:


Gets a floating point value from a parameter.

- (BOOL)getFloatValue:(double *)value fromParm:(UInt32)parmId atTime:(double)time;
Parameters
value
Pointer to the plug-in variable for the value.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the value.
Return Value

Returns YES if the value is retrieved successfully; NO otherwise.

Discussion

When used to get the value of an angle parameter, the result will be expressed in counter-clockwise degrees. Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.
In FxPlug 1.2, the documentation for this method incorrectly stated that angle values were returned in radians.


getIntValue:fromParm:atTime:


Gets an integer value from a parameter.

- (BOOL)getIntValue:(int *)value fromParm:(UInt32)parmId atTime:(double)time; 
Parameters
value
Pointer to the plug-in variable for the value.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the value.
Return Value

Returns YES if the value is retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


getParameterFlags:fromParm:


Gets current state of a parameter.

- (BOOL)getParameterFlags:(FxParameterFlags *)flags fromParm:(UInt32)parmId; 
Parameters
flags
Flags that encode various state values for the parameter.
parmId
Unique identifier for the parameter.
Return Value

Returns YES if the state information is retrieved successfully; NO otherwise.


getRedValue:GreenValue:BlueValue:AlphaValue:fromParm:atTime:


Gets RGBA color value (in 0.0 - 1.0 floating point) from a parameter.

- (BOOL)getRedValue:(double *)red GreenValue:(double *)green BlueValue:(double *)blue AlphaValue:(double *)alpha fromParm:(UInt32)parmID atTime:(double)time; 
Parameters
red
Pointer to the plug-in variable for the red value.
green
Pointer to the plug-in variable for the green value.
blue
Pointer to the plug-in variable for the blue value.
alpha
Pointer to the plug-in variable for the alpha value.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the values.
Return Value

Returns YES if the values are retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


getRedValue:GreenValue:BlueValue:fromParm:atTime:


Gets RGB color values (in 0.0 - 1.0 floating point) from a parameter.

- (BOOL)getRedValue:(double *)red GreenValue:(double *)green BlueValue:(double *)blue fromParm:(UInt32)parmID atTime:(double)time; 
Parameters
red
Pointer to the plug-in variable for the red value.
green
Pointer to the plug-in variable for the green value.
blue
Pointer to the plug-in variable for the blue value.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the values.
Return Value

Returns YES if the values are retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


getTexture:layerOffsetX:layerOffsetY:requestInfo:fromParm:atTime:


Gets a texture image from a parameter. This method allocates memory for the image that the plug-in should release when processing is complete.

- (BOOL)getTexture:(FxTexture **)image layerOffsetX:(double *)offsetX layerOffsetY:(double *)offsetY requestInfo:(FxRenderInfo)info fromParm:(UInt32)parmID atTime:(double)time; 
Parameters
image
Pointer to the location of the texture image.
offsetX
X value for the bottom left corner of this image in layer space. If this pointer is NULL, no translation is calculated.
offsetY
Y value for the bottom left corner of this image in layer space. If this pointer is NULL, no translation is calculated.
info
Information about the requested image, including quality, scale and bit depth.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the image.
Return Value

Returns YES if the image is retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


getXValue:YValue:fromParm:atTime:


Gets the xy position value (in 0.0 - 1.0 floating point) from a parameter.

- (BOOL)getXValue:(double *)x YValue:(double *)y fromParm:(UInt32)parmID atTime:(double)time; 
Parameters
x
Pointer to the plug-in variable for the x value.
y
Pointer to the plug-in variable for the y value.
parmId
Unique identifier for the parameter.
time
Specified time, expressed in canonical frames, to get the values.
Return Value

Returns YES if the values are retrieved successfully; NO otherwise.

Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See the header file FxPlug/FxHostCapabilities.h.


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.
Last Updated: 2008-06-05