The End Sequence Render Action

The End Sequence Render Action
Prev	Chapter 13. Actions Passed to An Image Effect	Next

	#include "ofxImageEffect.h"
	#define kOfxImageEffectActionEndSequenceRender      "OfxImageEffectActionEndSequenceRender"

Arguments

handle handle to the instance, cast to an OfxImageEffectHandle ,
inArgs has the following properties...
- kOfxImageEffectPropFrameRange - the range of frames (inclusive) that will be renderred,
- kOfxImageEffectPropFrameStep - what is the step between frames, generally set to 1 (for full frame renders) or 0.5 (for fielded renders),
- kOfxPropIsInteractive - is this a single frame render due to user interaction in a GUI, or a proper full sequence render.
- kOfxImageEffectPropRenderScale - the scale factor to apply to images for this call
- kOfxImageEffectPropSequentialRenderStatus - whether the effect is currently being rendered in strict frame order on a single instance
- kOfxImageEffectPropInteractiveRenderStatus - if the render is in response to a user modifying the effect in an interactive session
outArgs is redundant and is set to NULL.

Description

This action is passed to an image effect after is has rendered a range of frames. It is there to allow an effect to free resources after a long sequence of frame renders. Note that this is still called, even if only a single frame is being rendered in an interactive environment.

Preconditions

kOfxActionCreateInstance has been called on the instance
kOfxImageEffectActionEndSequenceRender action was called on the instance
kOfxImageEffectActionRender action was called at least once on the instance

Postconditions

Return Values

kOfxStatOK, the action was trapped and handled cleanly by the effect,
kOfxStatReplyDefault, the action was not trapped, but all is well anyway,
kOfxStatErrMemory, in which case the action may be called again after a memory purge,
kOfxStatFailed, something wrong, but no error code appropriate, plugin to post message,
kOfxStatErrFatal

Prev	Up	Next
The Begin Sequence Render Action	Home	The Get Clip Preferences Action