The Draw Action

The Draw Action
Prev	Chapter 14. Actions Passed to an Interact	Next

	#include "ofxCore.h"
	#define kOfxInteractActionDraw "OfxInteractActionDraw"

Arguments

handle handle to an interact instance, cast to an OfxInteractHandle
inArgs has the following properties on an image effect plugin,
- kOfxPropEffectInstance - a handle to the effect for which the interact has been,
- kOfxInteractPropPixelScale - the scale factor to convert cannonical pixels to screen pixels
- kOfxInteractPropBackgroundColour - the background colour of the application behind the current view
- kOfxPropTime - the effect time at which changed occured
- kOfxImageEffectPropRenderScale - the render scale applied to any image fetched
outArgs is redundant and is set to NULL.

Description

This action is issued to an interact whenever the host needs the plugin to redraw the given interact. The interact should issue any openGL calls it needs at this point.

Note that the interact may (in the case of custom parameter GUIS) or may not (in the case of image effect overlays) be required to swap buffers, that is up to the kind of interact.

Preconditions

kOfxActionCreateInstance has been called on the instance handle,
the openGL context for this interact has been set
the projection matrix will correspond to the interact's cannonical voew

Return Values

kOfxStatOK , the action was trapped and all was well
kOfxStatReplyDefault , the action was ignored
kOfxStatErrFatal ,
kOfxStatFailed , something went wrong, the host should ignore this interact in future

Prev	Up	Next
The Destroy Instance Action	Home	kOfxInteractActionPenMotion