ML Reference
|
Field to encapsulate a vector of 10 double values. More...
#include <mlFields.h>
Public Member Functions | |
Vector10Field () | |
Implements the runtime type system interface for this class. | |
Vector10Field (const std::string &name) | |
Constructor, creates a field with a name to manage a vector of 10 double values initialized to (0,0,0,0,0,0,0,0,0,0) by default. | |
void | setStringValue (const std::string &stringValue) override |
Sets the value of the field to stringValue . | |
void | setVector10Value (const Vector10 &vectorValue) |
Sets the value of the field to vectorValue . | |
void | updateVector10Value (const Vector10 &vectorValue) |
Sets the value of the field to vectorValue , but only touch field if the new value is different from the old value. | |
void | setVectorValue (const Vector10 &vectorValue) |
Sets the value of the field to vectorValue . | |
std::string | getStringValue () const override |
Returns the value of the field as string value. | |
const Vector10 & | getVector10Value () const |
Returns the value of the field. | |
const Vector10 & | getVectorValue () const |
Returns the value of the field. | |
void | setValue (const Vector10 &vectorValue) |
Same as setVector10Value(). | |
void | updateValue (const Vector10 &vectorValue) |
Same as updateVector10Value(). | |
const Vector10 & | getValue () const |
Same as getVector10Value(). | |
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) ). | |
Protected Member Functions | |
void | setValueFromField (const Field &field) override |
Reimplementation from Field which copies the field value more efficiently. | |
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. | |
Additional Inherited Members | |
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 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 |
Static Protected Attributes inherited from ml::Field | |
static MLint | _enableNotifications |
Flag which disables the notification process of field (sensors) globally. | |
Field to encapsulate a vector of 10 double values.
Definition at line 1372 of file mlFields.h.
ml::Vector10Field::Vector10Field | ( | ) |
Implements the runtime type system interface for this class.
Default constructor, do not use it.
ml::Vector10Field::Vector10Field | ( | const std::string & | name | ) |
Constructor, creates a field with a name
to manage a vector of 10 double values initialized to (0,0,0,0,0,0,0,0,0,0) by default.
|
overridevirtual |
Returns the value of the field as string value.
setStringValue must be able to reinterpret this returned string correctly.
Implements ml::Field.
|
inline |
Same as getVector10Value().
Definition at line 1420 of file mlFields.h.
const Vector10 & ml::Vector10Field::getVector10Value | ( | ) | const |
Returns the value of the field.
|
inline |
Returns the value of the field.
Definition at line 1411 of file mlFields.h.
|
overridevirtual |
Sets the value of the field to stringValue
.
Implements ml::Field.
|
inline |
Same as setVector10Value().
Definition at line 1414 of file mlFields.h.
|
overrideprotectedvirtual |
void ml::Vector10Field::setVector10Value | ( | const Vector10 & | vectorValue | ) |
Sets the value of the field to vectorValue
.
|
inline |
Sets the value of the field to vectorValue
.
Definition at line 1399 of file mlFields.h.
|
inline |
Same as updateVector10Value().
Definition at line 1417 of file mlFields.h.
void ml::Vector10Field::updateVector10Value | ( | const Vector10 & | vectorValue | ) |
Sets the value of the field to vectorValue
, 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!)