Class representing parameters for enumeration values. More...

#include <EnumerationParameter.h>

Inheritance diagram for Frapper::EnumerationParameter:

Collaboration diagram for Frapper::EnumerationParameter:

[legend]

Public Member Functions
	EnumerationParameter (const QString &name, const QVariant &value)
	Constructor of the EnumerationParameter class.

	EnumerationParameter (const EnumerationParameter &parameter)
	Copy constructor of the EnumerationParameter class.

virtual	~EnumerationParameter ()
	Destructor of the EnumerationParameter class.

virtual AbstractParameter *	clone ()
	Creates an exact copy of the parameter.

int	getCurrentIndex ()
	Returns the index of the item currently selected in the enumeration.

QString	getCurrentLiteral ()
	Returns the literal of the item currently selected in the enumeration.

QString	getCurrentValue ()
	Returns the value of the item currently selected in the enumeration.

QStringList	getLiterals () const
	Returns the list of string literals of the enumeration.

void	setLiterals (QStringList literals)
	Sets the list of string literals for the enumeration.

QStringList	getValues () const
	Returns the list of values of the enumeration.

void	setValues (QStringList values)
	Sets the list of values for the enumeration.

Public Member Functions inherited from Frapper::Parameter
	Parameter (const QString &name, Type type, const QVariant &value)
	Constructor of the Parameter class.

	Parameter (const Parameter &parameter)
	Copy constructor of the Parameter class.

virtual	~Parameter ()
	Destructor of the Parameter class.

virtual bool	isGroup () const
	Returns whether the parameter object derived from this class is a parameter group.

Type	getType () const
	Returns the parameter's type.

Size	getSize () const
	Returns the parameter's size specifying how many values of the given type it stores.

void	setSize (Size size)
	Sets the parameter's size specifying how many values of the given type it stores.

int	getMultiplicity () const
	Returns the parameter's multiplicity specifying how many parameters of the given type can be connected to it.

void	setMultiplicity (int multiplicity)
	Sets the parameter's multiplicity specifying how many parameters of the given type can be connected to it.

int	getNumberOfConnections () const
	Returns the parameter's number of connections.

virtual QVariant	getValue (bool triggerEvaluation=false)
	Returns the parameter's value while optionally triggering the evaluation chain.

virtual const QVariantList &	getValueList () const
	Returns the parameter's value list. Which contains the values of all connected parameters.

void	setValue (const QVariant &value, bool triggerDirtying=false)
	Sets the parameter's value to the given value.

void	setValue (int index, const QVariant &value, bool triggerDirtying=false)
	Sets the parameter's value with the given index to the given value.

bool	hasDefaultValue () const
	Returns whether the parameter's current value is the default value.

void	setDefaultValue (const QVariant &defaultValue)
	Sets the parameter's default value to the given value.

virtual void	reset ()
	Resets the parameter to its default value.

List	getAffectedParameters () const
	Returns the list of parameters that are affected when the value of this parameter is changed.

void	addAffectedParameter (Parameter *affectedParameter)
	Adds a parameter to the list of parameters that are affected when the value of this parameter is changed.

void	removeAffectedParameter (Parameter *affectedParameter)
	Removes a parameter from the list of parameters that are affected when the value of this parameter is changed.

List	getAffectingParameters () const
	Returns the list of parameters that affect this parameter when their value is changed.

void	addAffectingParameter (Parameter *affectingParameter)
	Adds a parameter to the list of parameters that are affected when the value of this parameter is changed.

void	removeAffectingParameter (Parameter *affectingParameter)
	Removes a parameter from the list of parameters that are affected when the value of this parameter is changed.

QString	getDescription () const
	Returns the description of the parameter.

void	setDescription (const QString &description)
	Sets the description for the parameter.

PinType	getPinType () const
	Returns the type of pin that should be created to represent the parameter.

void	setPinType (PinType pinType)
	Sets the type of pin that should be created to represent the parameter.

Connection::Map	getConnectionMap () const
	Returns all connections currently connected to this parameter.

void	addConnection (Connection *connection)
	Adds the given connection to the list of connections.

void	removeConnection (Connection::ID id)
	Removes the given connection from the list of connections.

bool	isConnected () const
	Returns whether the parameter is connected to at least one other parameter.

Parameter *	getConnectedParameter () const
	Returns the first parameter connected to this parameter.

bool	isDirty ()
	Returns whether the parameter's value has changed.

virtual void	setDirty (bool dirty)
	Sets whether the parameter's value has changed.

bool	isAuxDirty ()
	Returns the auxiliary dirty flag.

virtual void	setAuxDirty (bool dirty)
	Sets the auxiliary dirty flag.

bool	isVisible () const
	Returns the visibility for this parameter.

void	setVisible (bool visible)
	Sets the visibility for this parameter.

bool	isReadOnly () const
	Returns whether the parameter can not be modified using a control in the UI.

void	setReadOnly (bool readOnly)
	Sets whether the parameter can not be modified using a control in the UI.

void	setSelfEvaluating (bool selfEvaluating)
	Sets whether the parameter is self-evaluating.

bool	isSelfEvaluating () const
	Returns wether the parameter is self-evaluating.

void	propagateDirty (bool setFirstTrue=true)
	Sets the dirty flag for all parameters that are connected with and affected by this parameter.

void	propagateAuxDirty ()
	Sets the aux dirty flag for all parameters that are affecting this parameter..

void	propagateEvaluation ()
	Propagates the evaluation of nodes.

void	setChangeFunction (const char *changeFunction)
	Sets the function to call when the parameter's value changes.

void	setProcessingFunction (const char *processingFunction)
	Sets the function to use for computing the parameter's value.

void	setAuxProcessingFunction (const char *processingFunction)
	Sets the function to use for computing auxiliary value dependant things.

void	setCommandFunction (const char *commandFunction)
	Sets the function to use for executing the command represented by the parameter.

void	setOnConnectFunction (const char *onConnectFunction)
	Sets the function which should be called on parameter's connection.

void	setOnDisconnectFunction (const char *onDisconnectFunction)
	Sets the function which should be called on parameter's disconnection.

void	executeCommand ()
	Emits the commandExecutionRequested signal to notify connected objects that the command represented by the parameter should be executed.

QString	getValueString ()
	Returns the parameter's value as a character string.

Public Member Functions inherited from Frapper::AbstractParameter
	AbstractParameter (const QString &name)
	Constructor of the AbstractParameter class.

	AbstractParameter (const AbstractParameter &parameter)
	Copy constructor of the AbstractParameter class.

virtual	~AbstractParameter ()
	Destructor of the AbstractParameter class.

QString	getName () const
	Returns the name of the parameter or parameter group.

bool	isEnabled () const
	Returns whether the controls for editing the parameter or parameter group in the UI should be enabled.

virtual void	setEnabled (bool enabled, bool propagate=true)
	Sets whether the controls for editing the parameter or parameter group in the UI should be enabled.

virtual void	setName (const QString &name)
	Sets name of the parameter.

Node *	getNode () const
	Returns the node to which this parameter or parameter group belongs.

virtual void	setNode (Node *node)
	Sets the node to which this parameter or parameter group belongs.

Private Attributes
QStringList	m_literals
	The list of string literals of the enumeration.

QStringList	m_values
	The list of values of the enumeration.

Additional Inherited Members
Public Types inherited from Frapper::Parameter
enum	Type { T_Unknown = -1, T_Bool, T_Int, T_UnsignedInt, T_Float, T_String, T_Filename, T_Color, T_Enumeration, T_TextInfo, T_Command, T_Geometry, T_Light, T_Camera, T_Image, T_Group, T_PlugIn, T_Generic, T_NumTypes }
	Nested enumeration for the different types of parameters. More...

enum	Multiplicity { M_Invalid = -1, M_OneOrMore }
	Nested enumeration for special types of multiplicity. More...

enum	PinType { PT_None = -1, PT_Input, PT_Output }
	Nested enumeration for the different types of pins to represent parameters. More...

typedef unsigned int	Size
	Type definition for the size of a parameter, specifying how many values of the given type the parameter can store.

Signals inherited from Frapper::Parameter
void	dirtied ()
	Signal that is emitted when the value of the parameter becomes dirty.

void	valueChanged ()
	Signal that is emitted when the parameter's value has changed.

void	valueChanged (int index)
	Signal that is emitted when the parameter's value with the given index has changed.

void	processingRequested ()
	Signal that is emitted when the value of the parameter should be processed.

void	auxProcessingRequested ()
	Signal that is emitted when auxiliary changes in combination with the value happen.

void	commandExecutionRequested ()
	Signal that is emitted when a command parameter is triggered.

void	connectionEstablished ()
	Signal that is emitted when a connection is established.

void	connectionDestroyed ()
	Signal that is emitted when a connection is destroyed.

Static Public Member Functions inherited from Frapper::Parameter
static QString	getTypeName (Type type)
	Returns the name of the given parameter type.

static QColor	getTypeColor (Type type)
	Returns the color of the given parameter type.

static Type	getTypeByName (const QString &typeName)
	Returns the parameter type corresponding to the given name.

static QVariant	getDefaultValue (Type type)
	Returns the default value for parameters of the given type.

static QColor	decodeIntColor (const QString &color)
	Converts the given string to a color value. The string should contain comma-separated integer values for the red, green and blue channels respectively.

static QColor	decodeDoubleColor (const QString &color)
	Converts the given string to a color value. The string should contain comma-separated double-precision floating point values for the red, green and blue channels respectively.

static Size	decodeSize (const QString &size)
	Converts the given string to a size value.

static int	decodeMultiplicity (const QString &multiplicity)
	Converts the given string to a multiplicity value.

static PinType	decodePinType (const QString &pinTypeString)
	Converts the given string to a pin type value.

static Parameter *	create (const QString &name, Type type, QVariant defaultValue=QVariant())
	Creates a parameter with the given name and type.

static Parameter *	create (const QDomElement &element)
	Creates a parameter from the given XML element.

static Parameter *	clone (const Parameter &parameter)
	Creates a copy of the given parameter.

static QString	extractFirstGroupName (QString *path)
	Extracts the name of first group found in the given parameter path.

static Parameter *	createImageParameter (const QString &name, Ogre::TexturePtr texturePointer=Ogre::TexturePtr(0))
	Creates an image parameter with the given name.

static Parameter *	createGroupParameter (const QString &name, ParameterGroup *parameterGroup=0)
	Creates a group parameter with the given name.

Static Public Attributes inherited from Frapper::Parameter
static const QString	PathSeparator = " > "
	The string that separates parts in parameter paths.

static const QString	EnumerationSeparator = "---"
	The string that identifies enumeration separators.

Protected Attributes inherited from Frapper::Parameter
QMutex	m_mutex
	Mutex for threaded programming.

QStringList	m_mutexList

Type	m_type
	The type of the parameter's value.

int	m_size
	The parameter's size specifying how many values of the given type it stores.

int	m_multiplicity
	The parameter's multiplicity specifying how many parameters of the given type can be connected to it.

QVariant	m_defaultValue
	The parameter's default value.

QVariant	m_value
	The parameter's value.

QVariantList	m_valueList
	The parameter's value.

QString	m_description
	A description of the parameter.

PinType	m_pinType
	The type of pin that should be created to represent the parameter.

Connection::Map	m_connectionMap
	The map of connections that are connected to this connector with connection IDs as keys.

List	m_affectedParameters
	A list of parameter names that are affected when the value of this parameter is changed.

List	m_affectingParameters
	A list of parameter names that affect this parameter.

bool	m_dirty
	Flag that states whether the parameter's value has changed.

bool	m_auxDirty
	Auxiliary dirty flag.

bool	m_visible
	Flag that states whether the parameter's should be visible in e.g. ParameterPanel or not.

bool	m_readOnly
	Flag that states whether the parameter's value can not be changed using an input control in the UI.

bool	m_selfEvaluating
	Flag that states whether the parameter is self-evaluating.

Detailed Description

Class representing parameters for enumeration values.

Constructor & Destructor Documentation

Frapper::EnumerationParameter::EnumerationParameter	(	const QString &	name,
		const QVariant &	value
	)

Constructor of the EnumerationParameter class.

Constructors and Destructors.

Parameters

name	The name of the parameter.
value	The parameter's value.

Constructor of the EnumerationParameter class.

Parameters

name	The name of the parameter.
value	The parameter's value.

Frapper::EnumerationParameter::EnumerationParameter ( const EnumerationParameter & parameter )

Copy constructor of the EnumerationParameter class.

Parameters

parameter The parameter to copy.

Frapper::EnumerationParameter::~EnumerationParameter ( )

virtual

Destructor of the EnumerationParameter class.

Member Function Documentation

AbstractParameter * Frapper::EnumerationParameter::clone ( )

virtual

Creates an exact copy of the parameter.

Public Functions.

Returns: An exact copy of the parameter.

Creates an exact copy of the parameter.

Returns: An exact copy of the parameter.

Reimplemented from Frapper::Parameter.

int Frapper::EnumerationParameter::getCurrentIndex ( )

Returns the index of the item currently selected in the enumeration.

Convenience function that calls getValue().toInt() on the parameter.

Returns: The index of the item currently selected in the enumeration.

QString Frapper::EnumerationParameter::getCurrentLiteral ( )

Returns the literal of the item currently selected in the enumeration.

Returns: The literal of the item currently selected in the enumeration, or an invalid QString when no item is currently selected.; The literal of the item currently selected in the enumeration.

QString Frapper::EnumerationParameter::getCurrentValue ( )

Returns the value of the item currently selected in the enumeration.

Returns: The value of the item currently selected in the enumeration, or an invalid QString when no item is currently selected.

QStringList Frapper::EnumerationParameter::getLiterals ( ) const

Returns the list of string literals of the enumeration.

Returns: The list of string literals of the enumeration.; The list of string literals of the enumeration, or an invalid QString when no item is currently selected.

void Frapper::EnumerationParameter::setLiterals ( QStringList literals )

Sets the list of string literals for the enumeration.

Parameters

literals The list of string literals for the enumeration.

QStringList Frapper::EnumerationParameter::getValues ( ) const

Returns the list of values of the enumeration.

Returns: The list of values of the enumeration.

void Frapper::EnumerationParameter::setValues ( QStringList values )

Sets the list of values for the enumeration.

Parameters

values The list of values for the enumeration.

Member Data Documentation

QStringList Frapper::EnumerationParameter::m_literals

private

The list of string literals of the enumeration.

QStringList Frapper::EnumerationParameter::m_values

private

The list of values of the enumeration.

The documentation for this class was generated from the following files:

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation