Frapper::FilenameParameter Class Reference

Class representing parameters for filenames. More...

#include <FilenameParameter.h>

Inheritance diagram for Frapper::FilenameParameter:

Collaboration diagram for Frapper::FilenameParameter:

Public Types
enum	Type { FT_Open, FT_Save }
	Nested enumeration of different filename types. More...
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.
Public Types inherited from Frapper::AbstractParameter
typedef QHash< QString, AbstractParameter * >	Map
	Type definition for a map of parameters and parameter groups.
typedef QList < AbstractParameter * >	List
	Type definition for a list of parameters and parameter groups.

Public Member Functions
	FilenameParameter (const QString &name, const QVariant &value)
	Constructor of the FilenameParameter class.
	FilenameParameter (const FilenameParameter &parameter)
	Copy constructor of the FilenameParameter class.
virtual	~FilenameParameter ()
	Destructor of the FilenameParameter class.
virtual AbstractParameter *	clone ()
	Creates an exact copy of the parameter.
QString	getFilters () const
	Returns the filename filters to use when selecting a file in a file browser dialog.
void	setFilters (const QString &filters)
	Sets the filename filters to use when selecting a file in a file browser dialog.
Type	getType () const
	Returns the type for the filename.
void	setType (Type filenameType)
	Sets the type for the filename.
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
QString	m_filters
	The filename filters to use when selecting a file in a file browser dialog.
Type	m_filenameType
	The type of the filename.

Additional Inherited Members
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 filenames.

Member Enumeration Documentation

enum Frapper::FilenameParameter::Type

Nested enumeration of different filename types.

Enumerator:

FT_Open
FT_Save

Constructor & Destructor Documentation

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

Constructor of the FilenameParameter class.

Constructors and Destructors.

Parameters

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

Constructor of the FilenameParameter class.

Parameters

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

Frapper::FilenameParameter::FilenameParameter

(

const FilenameParameter &

parameter

)

Copy constructor of the FilenameParameter class.

Parameters

parameter

The parameter to copy.

Frapper::FilenameParameter::~FilenameParameter ( )

virtual

Destructor of the FilenameParameter class.

Member Function Documentation

AbstractParameter * Frapper::FilenameParameter::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.

QString Frapper::FilenameParameter::getFilters

(

)

const

Returns the filename filters to use when selecting a file in a file browser dialog.

Returns

The filters to use when selecting a file in a file dialog.

void Frapper::FilenameParameter::setFilters

(

const QString &

filters

)

Sets the filename filters to use when selecting a file in a file browser dialog.

Parameters

filters

The filters to use when selecting a file in a file dialog.

FilenameParameter::Type Frapper::FilenameParameter::getType

(

)

const

Returns the type for the filename.

Returns

The type for the filename.

void Frapper::FilenameParameter::setType

(

FilenameParameter::Type

filenameType

)

Sets the type for the filename.

Parameters

filenameType

The type for the filename.

Member Data Documentation

QString Frapper::FilenameParameter::m_filters

private

The filename filters to use when selecting a file in a file browser dialog.

Type Frapper::FilenameParameter::m_filenameType

private

The type of the filename.

---

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

• FilenameParameter.h
• FilenameParameter.cpp