The Create Instance Action

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

	#include "ofxCore.h"
	#define kOfxActionCreateInstance        "OfxActionCreateInstance"

Arguments

handle handle to the interact instance, cast to an OfxInteractHandle
inArgs is redundant and is set to NULL,
outArgs is redundant and is set to NULL.

Description

The kOfxActionCreateInstance is the first action passed to an interact instance after its creation. It is there to allow a plugin to create any per-instance data structures it may need.

Preconditions

kOfxActionDescribe has been called on this interact

Postconditions

the instance pointer will be valid until the kOfxActionDestroyInstance action is passed to the plug-in with the same instance handle

Return Values

kOfxStatOK , the action was trapped and all was well
kOfxStatReplyDefault , the action was ignored, but all was well anyway
kOfxStatErrFatal
kOfxStatErrMemory , in which case this may be called again after a memory purge
kOfxStatFailed , in which case the host should ignore this interact