OfxParameterSuiteV1::paramDefine
— Defines a new parameter of the given type in a describe action
#include "ofxParam.h"
OfxStatus(*paramDefine)( | OfxParamSetHandleparamSet, |
const char *paramType, | |
const char *name, | |
OfxPropertySetHandle *propertySet) ; |
This function defines a parameter in a parameter set and returns a property set which is used to describe that parameter.
This function does not actually create a parameter, it only says that one should exist in any subsequent instances. To fetch an parameter instance paramGetHandle must be called on an instance.
This function can always be called in one of a plug-in's "describe" functions which defines the parameter sets common to all instances of a plugin.
kOfxStatOK
- the parameter was created correctlykOfxStatErrBadHandle
- if the plugin handle was invalidkOfxStatErrExists
- if a parameter of that name exists already in this pluginkOfxStatErrUnknown
- if the type is unknownkOfxStatErrUnsupported
- if the type is known but unsupported