Helper class to simplify construction of PRM_Templates and dynamic user interfaces. More...

#include <openvdb_houdini/ParmFactory.h>

Public Types
using	AttrFilterFunc = std::function< bool(const GA_Attribute &, const PRM_Parm &, const SOP_Node &)>
	Functor to filter a list of attributes from a SOP's input. More...

Public Member Functions
	ParmFactory (PRM_Type, const std::string &token, const std::string &label)

	ParmFactory (PRM_MultiType, const std::string &token, const std::string &label)

ParmFactory &	setCallbackFunc (const PRM_Callback &)

ParmFactory &	setChoiceList (const PRM_ChoiceList *)
	Specify a menu of values for this parameter. More...

ParmFactory &	setChoiceListItems (PRM_ChoiceListType typ, const std::vector< std::string > &items)
	Specify a menu type and a list of token, label, token, label,... pairs for this parameter. More...

ParmFactory &	setChoiceListItems (PRM_ChoiceListType typ, const char const items)
	Specify a menu type and a list of token, label, token, label,... pairs for this parameter. More...

ParmFactory &	setGroupChoiceList (size_t inputIndex, PRM_ChoiceListType typ=PRM_CHOICELIST_TOGGLE)
	Specify a menu of primitive group names for this parameter. More...

ParmFactory &	setAttrChoiceList (size_t inputIndex, GA_AttributeOwner attrOwner, PRM_ChoiceListType typ=PRM_CHOICELIST_TOGGLE, AttrFilterFunc attrFilter=AttrFilterFunc{})
	Specify a menu of attribute names for this parameter. More...

ParmFactory &	setChoiceList (PRM_ChoiceListType typ, const std::vector< std::string > &items, bool paired=false)
	Specify a menu type and either a list of menu item labels or a list of token, label, token, label,... pairs for this parameter. More...

ParmFactory &	setChoiceList (PRM_ChoiceListType typ, const char const items, bool paired=false)
	Specify a menu type and either a list of menu item labels or a list of token, label, token, label,... pairs for this parameter. More...

ParmFactory &	setConditional (const PRM_ConditionalBase *)

ParmFactory &	setDefault (fpreal, const char *=nullptr, CH_StringMeaning=CH_STRING_LITERAL)
	Specify a default value for this parameter. More...

ParmFactory &	setDefault (const std::string &, CH_StringMeaning=CH_STRING_LITERAL)
	Specify a default string value for this parameter. More...

ParmFactory &	setDefault (const std::vector< fpreal > &)
	Specify default numeric values for the vector elements of this parameter (assuming its vector size is > 1). More...

ParmFactory &	setDefault (const std::vector< PRM_Default > &)
	Specify default values for the vector elements of this parameter (assuming its vector size is > 1). More...

ParmFactory &	setDefault (const PRM_Default *)
	Specify a default value or values for this parameter. More...

ParmFactory &	setHelpText (const char *)
	Specify a plain text tooltip for this parameter. More...

ParmFactory &	setTooltip (const char *)
	Specify a plain text tooltip for this parameter. More...

ParmFactory &	setDocumentation (const char *)
	Add documentation for this parameter. More...

ParmFactory &	setParmGroup (int)

ParmFactory &	setRange (PRM_RangeFlag minFlag, fpreal minVal, PRM_RangeFlag maxFlag, fpreal maxVal)
	Specify a range for this parameter's values. More...

ParmFactory &	setRange (const std::vector< PRM_Range > &)
	Specify range for the values of this parameter's vector elements (assuming its vector size is > 1). More...

ParmFactory &	setRange (const PRM_Range *)
	Specify a range or ranges for this parameter's values. More...

ParmFactory &	setSpareData (const SpareDataMap &)
	Specify (key, value) pairs of spare data for this parameter. More...

ParmFactory &	setSpareData (const PRM_SpareData *)
	Specify spare data for this parameter. More...

ParmFactory &	setMultiparms (const ParmList &)
	Specify the list of parameters for each instance of a multiparm. More...

ParmFactory &	setTypeExtended (PRM_TypeExtended)
	Specify an extended type for this parameter. More...

ParmFactory &	setVectorSize (int)
	Specify the number of vector elements for this parameter. More...

ParmFactory &	setInvisible ()
	Mark this parameter as hidden from the UI. More...

PRM_Template	get () const
	Construct and return the parameter template. More...

Detailed Description

Helper class to simplify construction of PRM_Templates and dynamic user interfaces.

Example: houdini_utils::ParmList parms;
parms.add(houdini_utils::ParmFactory(PRM_STRING, "group", "Group")
.setHelpText("Specify a subset of the input VDB grids to be processed.")
.setChoiceList(&houdini_utils::PrimGroupMenu));
parms.add(houdini_utils::ParmFactory(PRM_FLT_J, "tolerance", "Pruning Tolerance")
.setDefault(PRMzeroDefaults)
.setRange(PRM_RANGE_RESTRICTED, 0, PRM_RANGE_UI, 1));

Member Typedef Documentation

using AttrFilterFunc = std::function<bool (const GA_Attribute&, const PRM_Parm&, const SOP_Node&)>

Functor to filter a list of attributes from a SOP's input.

Arguments to the functor are an attribute to be filtered and the parameter and SOP for which the filter is being called. The functor should return true for attributes that should be added to the list and false for attributes that should be ignored.

Constructor & Destructor Documentation

ParmFactory	(	PRM_Type	,
		const std::string &	token,
		const std::string &	label
	)

ParmFactory	(	PRM_MultiType	,
		const std::string &	token,
		const std::string &	label
	)

Member Function Documentation

PRM_Template get ( ) const

Construct and return the parameter template.

ParmFactory& setAttrChoiceList	(	size_t	inputIndex,
		GA_AttributeOwner	attrOwner,
		PRM_ChoiceListType	typ = `PRM_CHOICELIST_TOGGLE`,
		AttrFilterFunc	attrFilter = `AttrFilterFunc{}`
	)

Specify a menu of attribute names for this parameter.

Parameters

inputIndex	the zero-based index of the input from which to get attributes
attrOwner	the class of attribute with which to populate the menu: either per-vertex (`GA_ATTRIB_VERTEX`), per-point (`GA_ATTRIB_POINT`), per-primitive (`GA_ATTRIB_PRIMITIVE`), global (`GA_ATTRIB_GLOBAL`), or all of the above (`GA_ATTRIB_INVALID` or any other value)
typ	the menu behavior (toggle, replace, etc.)
attrFilter	an optional filter functor that returns `true` for each attribute that should appear in the menu; the functor will be moved, if possible, or else copied

Note: This method is supported only for SOPs.

Example: Create a menu that allows multiple selection from among all the string attributes on a SOP's first input:
houdini_utils::ParmList parms;
parms.add(houdini_utils::ParmFactory(PRM_STRING, "stringattr", "String Attribute")
.setAttrChoiceList(/*input=*/0, GA_ATTRIB_INVALID, PRM_CHOICELIST_TOGGLE,
[](const GA_Attribute& attr, const PRM_Parm&, const SOP_Node&) {
return (attr.getStorageClass() == GA_STORECLASS_STRING);
}));

ParmFactory& setCallbackFunc ( const PRM_Callback & )

ParmFactory& setChoiceList ( const PRM_ChoiceList * )

Specify a menu of values for this parameter.

ParmFactory& setChoiceList	(	PRM_ChoiceListType	typ,
		const std::vector< std::string > &	items,
		bool	paired = `false`
	)

Specify a menu type and either a list of menu item labels or a list of token, label, token, label,... pairs for this parameter.

Parameters

typ	specifies the menu behavior (toggle, replace, etc.)
items	a list of menu item labels or token, label, token, label,... pairs
paired	if `false`, treat all the elements of items as labels and assign them numeric tokens starting from zero; otherwise, treat the elements of items as token, label, token, label,... pairs

Deprecated:: Use setChoiceListItems() instead. Using unpaired items may mean less typing now, but it prevents you from reordering or deleting entries later.

ParmFactory& setChoiceList	(	PRM_ChoiceListType	typ,
		const char const	items,
		bool	paired = `false`
	)

Specify a menu type and either a list of menu item labels or a list of token, label, token, label,... pairs for this parameter.

Parameters

typ	specifies the menu behavior (toggle, replace, etc.)
items	a list of menu item labels or token, label, token, label,... pairs
paired	if `false`, treat all the elements of items as labels and assign them numeric tokens starting from zero; otherwise, treat the elements of items as token, label, token, label,... pairs

Note: The items array must be null-terminated.

Deprecated:: Use setChoiceListItems() instead. Using unpaired items may mean less typing now, but it prevents you from reordering or deleting entries later.

ParmFactory& setChoiceListItems	(	PRM_ChoiceListType	typ,
		const std::vector< std::string > &	items
	)

Specify a menu type and a list of token, label, token, label,... pairs for this parameter.

Parameters

typ	specifies the menu behavior (toggle, replace, etc.)
items	a list of token, label, token, label,... string pairs

ParmFactory& setChoiceListItems	(	PRM_ChoiceListType	typ,
		const char const	items
	)

Specify a menu type and a list of token, label, token, label,... pairs for this parameter.

Parameters

typ	specifies the menu behavior (toggle, replace, etc.)
items	a list of token, label, token, label,... string pairs

Note: The items array must be null-terminated.

ParmFactory& setConditional ( const PRM_ConditionalBase * )

ParmFactory& setDefault	(	fpreal	,
		const char *	= `nullptr`,
		CH_StringMeaning	= `CH_STRING_LITERAL`
	)

Specify a default value for this parameter.

If the string is null, the floating-point value will be used (but rounded if this parameter is integer-valued).

Note: The string pointer must not point to a temporary.

ParmFactory& setDefault	(	const std::string &	,
		CH_StringMeaning	= `CH_STRING_LITERAL`
	)

Specify a default string value for this parameter.

ParmFactory& setDefault ( const std::vector< fpreal > & )

Specify default numeric values for the vector elements of this parameter (assuming its vector size is > 1).

Floating-point values will be rounded if this parameter is integer-valued.

ParmFactory& setDefault ( const std::vector< PRM_Default > & )

Specify default values for the vector elements of this parameter (assuming its vector size is > 1).

ParmFactory& setDefault ( const PRM_Default * )

Specify a default value or values for this parameter.

ParmFactory& setDocumentation ( const char * )

Add documentation for this parameter.

Pass a null pointer or an empty string to inhibit the generation of documentation for this parameter.

The text is parsed as wiki markup. See the Houdini Wiki Markup Reference for the syntax.

ParmFactory& setGroupChoiceList	(	size_t	inputIndex,
		PRM_ChoiceListType	typ = `PRM_CHOICELIST_TOGGLE`
	)

Specify a menu of primitive group names for this parameter.

Parameters

inputIndex	the zero-based index of the input from which to get primitive groups
typ	the menu behavior (toggle, replace, etc.)

Calling this method with the default (toggle) behavior is equivalent to calling setChoiceList(&houdini_utils::PrimGroupMenuInput1), setChoiceList(&houdini_utils::PrimGroupMenuInput2), etc.

Example: To limit the user to choosing a single primitive group, replace
parms.add(houdini_utils::ParmFactory(PRM_STRING, "reference", "Reference")
.setChoiceList(&houdini_utils::PrimGroupMenuInput2);
with
parms.add(houdini_utils::ParmFactory(PRM_STRING, "reference", "Reference")
.setGroupChoiceList(1, PRM_CHOICELIST_REPLACE); // input index is zero based

ParmFactory& setHelpText ( const char * )

Specify a plain text tooltip for this parameter.

This method is equivalent to setTooltip()

ParmFactory& setInvisible ( )

Mark this parameter as hidden from the UI.

Note: Marking parameters as obsolete is preferable to making them invisible as changing invisible parameter values will still trigger a re-cook, however this is not possible when using multi-parms.

ParmFactory& setMultiparms ( const ParmList & )

Specify the list of parameters for each instance of a multiparm.

Note: This setting is ignored for non-multiparm parameters.; Parameter name tokens should include a '#' character.

ParmFactory& setParmGroup ( int )

ParmFactory& setRange	(	PRM_RangeFlag	minFlag,
		fpreal	minVal,
		PRM_RangeFlag	maxFlag,
		fpreal	maxVal
	)

Specify a range for this parameter's values.

ParmFactory& setRange ( const std::vector< PRM_Range > & )

Specify range for the values of this parameter's vector elements (assuming its vector size is > 1).

ParmFactory& setRange ( const PRM_Range * )

Specify a range or ranges for this parameter's values.

ParmFactory& setSpareData ( const SpareDataMap & )

Specify (key, value) pairs of spare data for this parameter.

ParmFactory& setSpareData ( const PRM_SpareData * )

Specify spare data for this parameter.

ParmFactory& setTooltip ( const char * )

Specify a plain text tooltip for this parameter.

This method is equivalent to setHelpText()

ParmFactory& setTypeExtended ( PRM_TypeExtended )

Specify an extended type for this parameter.

ParmFactory& setVectorSize ( int )

Specify the number of vector elements for this parameter.

(The default vector size is one element.)

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation