kOfxInteractActionPenMotion

kOfxInteractActionPenMotion
Prev	Chapter 14. Actions Passed to an Interact	Next

kOfxInteractActionPenMotion

	#include "ofxCore.h"
	#define kOfxInteractActionPenMotion "OfxInteractActionPenMotion"

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 whenever the pen moves an the interact's has focus. It should be issued whether the pen is currently up or down.

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
The Draw Action	Home	kOfxInteractActionPenDown