FxTransition

Introduction

Specifies the methods a transition plug-in needs to implement.

Discussion

This protocol inherits from the parent protocol FxBaseEffect, whose methods must be implemented by any type of plug-in.

Methods

-frameCleanup

Asks the plug-in to clean up any memory allocated in frameSetup:. Called after renderOutput:.

-frameSetup:inputInfo:hardware:software:

Determines the type of input/output image the plug-in wants. The application calls this method before renderOutput:.

-frameSetup:inputInfoA:inputInfoB:timeFraction:hardware:software:

Determines the type of input/output image the plug-in wants. The application calls this method before renderOutput:.

-getOutputWidth:height:withInputA:withInputB:withTimeFraction:withInfo:

Allows the host application to retrieve the size of an output image produced by the plug-in. The application can then allocate and setup a proper output image for rendering.

-renderOutput:withInputA:withInputB:withInfo:

Renders output image from a plug-in.

-renderOutput:withInputA:withInputB:withTimeFraction:withInfo:

Renders output image from a plug-in.

Asks the plug-in to clean up any memory allocated in frameSetup:. Called after renderOutput:.

- (BOOL)frameCleanup; 

Return Value

Returns YES if the cleanup is successful; NO otherwise.

Determines the type of input/output image the plug-in wants. The application calls this method before renderOutput:.

frameSetup:inputInfoA:inputInfoB:timeFraction:hardware:software:

- (BOOL)frameSetup:(FxRenderInfo)renderInfo inputInfoA:(FxImageInfo)inputInfoA inputInfoB:(FxImageInfo)inputInfoB timeFraction:(float)timeFraction hardware:(BOOL *)canRenderHardware software:(BOOL *)canRenderSoftware; 

Parameters

renderInfo

FxRenderInfo structure that defines the render request.

inputInfoA

FxImageInfo structure that defines the first input image.

inputInfoB

FxImageInfo structure that defines the second input image.

timeFraction

fraction of duration (between 0.0 and 1.0)

canRenderHardware

Set to YES if the frame can be rendered in hardware.

canRenderSoftware

Set to YES if the frame can be rendered in software.

Return Value

Returns YES if frame setup is successful; NO otherwise.

Determines the type of input/output image the plug-in wants. The application calls this method before renderOutput:.

frameSetup:inputInfo:hardware:software:

- (BOOL)frameSetup:(FxRenderInfo)renderInfo inputInfoA:(FxImageInfo)inputInfoA inputInfoB:(FxImageInfo)inputInfoB timeFraction:(float)timeFraction hardware:(BOOL *)canRenderHardware software:(BOOL *)canRenderSoftware; 

Parameters

renderInfo

FxRenderInfo structure that defines the render request.

inputInfoA

FxImageInfo structure that defines the first input image.

inputInfoB

FxImageInfo structure that defines the second input image.

timeFraction

fraction of duration (between 0.0 and 1.0)

canRenderHardware

Set to YES if the frame can be rendered in hardware.

canRenderSoftware

Set to YES if the frame can be rendered in software.

Allows the host application to retrieve the size of an output image produced by the plug-in. The application can then allocate and setup a proper output image for rendering.

- (BOOL)getOutputWidth:(UInt32 *)width height:(UInt32 *)height withInputA:(FxImageInfo)inputInfoA withInputB:(FxImageInfo)inputInfoB withTimeFraction:(float)timeFraction withInfo:(FxRenderInfo)renderInfo;

Parameters

width

The width of the output image generated by the plug-in.

height

The height of the output image generated by the plug-in.

inputInfoA

FxImageInfo structure that defines the first input image.

inputInfoB

FxImageInfo structure that defines the second input image.

timeFraction

fraction of duration (between 0.0 and 1.0)

renderInfo

Information about the render type the application is requesting.

Return Value

Returns YES if the output size is properly determined and set to the width and height parameters; NO otherwise.
NOTE: This method may not be called by some host applications that do not support resizing.

Renders output image from a plug-in.

renderOutput:withInputA:withInputB:withTimeFraction:withInfo:

- (BOOL)renderOutput:(FxImage *)output withInputA:(FxImage *)inputImageA withInputB:(FxImage *)inputImageB withTimeFraction:(float)timeFraction withInfo:(FxRenderInfo)renderInfo; 

Parameters

output

Target image for final output from the plug-in.

inputImageA

First input image.

inputImageB

Second input image.

timeFraction

fraction of duration (between 0.0 and 1.0)

renderInfo

Information about the render type the application is currently requesting.

Return Value

Returns YES if the output image is correctly populated and processing is successful; NO otherwise.

Renders output image from a plug-in.

renderOutput:withInputA:withInputB:withInfo:

- (BOOL)renderOutput:(FxImage *)output withInputA:(FxImage *)inputImageA withInputB:(FxImage *)inputImageB withTimeFraction:(float)timeFraction withInfo:(FxRenderInfo)renderInfo; 

Parameters

output

Target image for final output from the plug-in.

inputImageA

First input image.

inputImageB

Second input image.

timeFraction

fraction of duration (between 0.0 and 1.0)

renderInfo

Information about the render type the application is currently requesting.

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