Field to encapsulate a float value. More...

#include <mlFields.h>

Inheritance diagram for ml::FloatField:

Public Member Functions
	FloatField ()
	Implements the runtime type system interface for this class.

	FloatField (const std::string &name)
	Constructor, create a field with a `name` to manage a float value, with 0 as a default value.

void	setStringValue (const std::string &stringValue) override
	Sets the value of the field to `stringValue`.

void	setFloatValue (float floatValue)
	Sets the field value to `floatValue`.

void	updateFloatValue (float floatValue)
	Sets the field value to `floatValue`, but only touch field if the new value is different from the old value.

std::string	getStringValue () const override
	Returns the value of the field as a string value.

float	getFloatValue () const
	Returns the value of the field.

void	setValue (float floatValue)
	Same as setFloatValue().

void	updateValue (float floatValue)
	Same as updateFloatValue().

float	getValue () const
	Same as getFloatValue().

Public Member Functions inherited from ml::Field
	Field (const std::string &name=std::string())
	Constructor: Creates a field with `name`.

virtual	~Field ()
	Destructor: Destroy field and remove all connection to fields an sensors.

FieldContainer *	getFieldContainer () const
	Get the field container of the field (which may be NULL).

const std::string &	getName () const
	Returns name of field.

void	setName (const std::string &name)
	Sets the `name` of field. Should be called only once after or while construction.

std::string	getFullName () const
	Returns "fieldContainerType(instanceName).fieldName" (if field container is available, otherwise only field name is returned).

bool	isOutputOnly () const
	Returns if this field is marked as pure output field.

void	setOutputOnly (bool outputOnly=true)
	Mark field as a pure output field that is never read by its module.

virtual MLint	isValidValue ()
	Returns true (=1) if the field's value is valid; otherwise false (=0) is returned.

void	copyCStringValue (char *valueBuffer, MLint bufferSize)
	Copies the value of the field (as character string) into the specified buffer `valueBuffer`.

MLint	getCStringValueSize ()
	Returns the length of the character string of the string value of the field.

void	attachFieldSensor (FieldSensor *sensor)
	Attaches a field sensor `sensor` of this class instance in both directions.

void	detachFieldSensor (FieldSensor *sensor)
	Detaches the field sensor `sensor` of this class instance in both directions.

void	detachFieldSensors ()
	Detaches all field sensors of this class instance in both directions.

void	attachField (OutputConnectorField *targetField)
	This calls attachField(targetField, false).

void	attachField (BaseField *targetField)

void	attachField (SoNodeField *targetField)

void	attachField (NotifyField *targetField)

void	attachField (Field *targetField, bool propagateValueOnConnect)
	Connects this class instance with the target field `targetField`.

void	detachField (Field *targetField)
	Disconnects connections between target field `targetField` and this instance.

void	detachSourceFields ()
	Disconnects all source fields of this instance in both directions.

void	detachDestinationFields ()
	Disconnects all target fields of this instance in both directions.

void	detachAllFields ()
	Disconnects all source and target fields of this instance in both directions.

size_t	getNumDestinationFields ()
	Returns the number of destination fields which could receive notifications or value sets.

Field *	getDestinationField (size_t index)
	Returns destination field at `index`. Returns NULL if `index` is out of range.

size_t	getNumSourceFields ()
	Returns the number of source fields which could send notifications or value sets.

Field *	getSourceField (size_t index)
	Returns the source field at `index`. Returns NULL if `index` is out of range.

virtual void	touch (FieldSensor::Strength strength=FieldSensor::CHANGED)
	Notifies all connected fields and field sensors.

void	enableNotifications (bool flag)
	Enables or disables notification of attached fields and field sensors when the field value is set or notified (by notifyAttachments() or set*Value() -methods), depending on the parameter `flag`.

bool	areNotificationsEnabled ()
	Returns whether the notification mechanism for this field (e.g., when field values are set) is enabled (see enableNotifications(bool) ).

Static Public Member Functions
static void	setValueCallback (void *field, double value)
	Callback method that can be used as a MLRequestProgressCB to set the progress to the field.

Static Public Member Functions inherited from ml::Field
static void	enableNotificationsGlobally (bool flag)
	Enables or disables globally the notification mechanism for all fields and field sensors when field values are set or notified (by notifyAttachments() or set*Value() methods), depending on the parameter `flag`.

static bool	areNotificationsEnabledGlobally ()
	Returns whether the notification mechanism for all fields (e.g., when field values are set) is enabled (see enableNotificationsGlobally(bool) ) Usually it is false(=0) within all calls of Module::calc* methods to avoid that field changes within these methods recursively start the calculation process of the ML.

static MLint &	enableNotificationsCounterState ()
	Provides read/write access to the current counter state (see enableNotificationsGlobally(bool) ).

Protected Member Functions
void	setValueFromField (const Field &field) override
	Reimplementation from Field which copies the field value more efficiently..

void	_initialize (const std::string &name="", float *valuePtr=nullptr)
	Initializes this field.

Protected Member Functions inherited from ml::Field
void	attachSourceField (Field *field)
	Inserts a field as source `field` in this instance, i.e., from now on *this might receive values and/or notifications from that field.

void	detachSourceField (Field *field)
	Removes a source `field` from this instance. If not found then this call does nothing.

void	detachFieldInternal (Field *field)
	Only remove the given field from the destination list.

Protected Attributes
float *	_valuePtr
	Points to the variable containing the field value.

float	_internalValue
	Stores the float value (if no external deprecated reference was given).

float	_minValue
	Minimum float value which can be set.

float	_maxValue
	Maximum float value which can be set.

Protected Attributes inherited from ml::Field
std::string	_name
	The name of this field.

std::vector< FieldSensor * >	_sensors
	List of field sensors.

std::vector< Field * >	_destinationFields
	List of (target) fields which shall be set to the value of this field or which shall be notified only if this field is changed or notified.

std::vector< Field * >	_sourceFields
	List of (source) fields, which will notify this field or which will copy their value to this field.

FieldContainer *	_fieldContainer
	The owning field container.

Flags	_flags

Additional Inherited Members
Static Protected Attributes inherited from ml::Field
static MLint	_enableNotifications
	Flag which disables the notification process of field (sensors) globally.

Detailed Description

Field to encapsulate a float value.

Definition at line 414 of file mlFields.h.

Constructor & Destructor Documentation

◆ FloatField() [1/2]

ml::FloatField::FloatField ( )

Implements the runtime type system interface for this class.

Default constructor, do not use it.

◆ FloatField() [2/2]

ml::FloatField::FloatField ( const std::string & name )

Constructor, create a field with a name to manage a float value, with 0 as a default value.

Member Function Documentation

◆ _initialize()

void ml::FloatField::_initialize	(	const std::string &	name = "",
		float *	valuePtr = nullptr )

protected

Initializes this field.

◆ getFloatValue()

float ml::FloatField::getFloatValue ( ) const

Returns the value of the field.

Referenced by ml::CSOGenerator::getDefaultPathPointAlpha(), ml::CSOGenerator::getDefaultPathPointWidth(), ml::CSOGenerator::getDefaultSeedPointAlpha(), ml::CSOGenerator::getDefaultSeedPointSize(), and ml::CSOGenerator::getDefaultVoxelWriteValue().

◆ getStringValue()

std::string ml::FloatField::getStringValue ( ) const

overridevirtual

Returns the value of the field as a string value.

setStringValue must be able to reinterpret this returned string correctly.

Implements ml::Field.

◆ getValue()

float ml::FloatField::getValue ( ) const

inline

Same as getFloatValue().

Definition at line 455 of file mlFields.h.

◆ setFloatValue()

void ml::FloatField::setFloatValue ( float floatValue )

Sets the field value to floatValue.

By default the entire float type range can be set.

◆ setStringValue()

void ml::FloatField::setStringValue ( const std::string & stringValue )

overridevirtual

Sets the value of the field to stringValue.

Implements ml::Field.

◆ setValue()

void ml::FloatField::setValue ( float floatValue )

inline

Same as setFloatValue().

Definition at line 449 of file mlFields.h.

References mlrange_cast().

◆ setValueCallback()

static void ml::FloatField::setValueCallback	(	void *	field,
		double	value )

static

Callback method that can be used as a MLRequestProgressCB to set the progress to the field.

◆ setValueFromField()

void ml::FloatField::setValueFromField ( const Field & field )

overrideprotectedvirtual

Reimplementation from Field which copies the field value more efficiently..

Reimplemented from ml::Field.

◆ updateFloatValue()

void ml::FloatField::updateFloatValue ( float floatValue )

Sets the field value to floatValue, but only touch field if the new value is different from the old value.

(NOTE that values must be identical to avoid touching the field!) By default the entire float type range can be set.

◆ updateValue()

void ml::FloatField::updateValue ( float floatValue )

inline

Same as updateFloatValue().

Definition at line 452 of file mlFields.h.

References mlrange_cast().

Member Data Documentation

◆ _internalValue

float ml::FloatField::_internalValue

protected

Stores the float value (if no external deprecated reference was given).

Definition at line 472 of file mlFields.h.

◆ _maxValue

float ml::FloatField::_maxValue

protected

Maximum float value which can be set.

Deprecated

Definition at line 479 of file mlFields.h.

◆ _minValue

float ml::FloatField::_minValue

protected

Minimum float value which can be set.

Deprecated

Definition at line 476 of file mlFields.h.

◆ _valuePtr

float* ml::FloatField::_valuePtr

protected

Points to the variable containing the field value.

Definition at line 469 of file mlFields.h.

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

MeVis/Foundation/Sources/ML/include/mlFields.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ FloatField() [1/2]

◆ FloatField() [2/2]

Member Function Documentation

◆ _initialize()

◆ getFloatValue()

◆ getStringValue()

◆ getValue()

◆ setFloatValue()

◆ setStringValue()

◆ setValue()

◆ setValueCallback()

◆ setValueFromField()

◆ updateFloatValue()

◆ updateValue()

Member Data Documentation

◆ _internalValue

◆ _maxValue

◆ _minValue

◆ _valuePtr