kOfxInteractActionPenUp

kOfxInteractActionPenUp
Prev	Chapter 14. Actions Passed to an Interact	Next

kOfxInteractActionPenUp

	#include "ofxCore.h"
	#define kOfxInteractActionPenUp "OfxInteractActionPenUp"

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
- kOfxInteractPropPenPosition - postion of the pen in,
- kOfxInteractPropPenViewportPosition - postion of the pen in,
- kOfxInteractPropPenPressure - the pressure of the pen,
outArgs is redundant and is set to NULL.

Description

This action is issued when a pen transitions for the 'down' to the 'up' state.

No openGL calls should be issued by the plug-in during this action.

Preconditions

kOfxActionCreateInstance has been called on the instance handle,
the current instance handle has had kOfxInteractActionGainFocus called on it

Postconditions

if the instance returns kOfxStatOK , the host should not pass the pen motion to any other interactive object it may own that shares the same view.

Return Values

kOfxStatOK , the action was trapped and the host should not pass the event to other objects it may own
kOfxStatReplyDefault , the action was not trapped and the host can deal with it if it wants

Prev	Up	Next
kOfxInteractActionPenDown	Home	kOfxInteractActionKeyDown