ML Reference
ml::PlaneField Class Reference

Field to encapsulate a vector of four double values representing a plane with all properties of Vector4Field. More...

#include <mlFields.h>

Inheritance diagram for ml::PlaneField:
ml::Vector4Field ml::Field

Public Member Functions

 PlaneField (const std::string &name="")
 Implements the runtime type system interface for this class. More...
 
void setPlaneValue (double f0, double f1, double f2, double f3)
 Sets field value to f0, f1, f2, and f3. More...
 
void setPlaneValue (const Plane &p)
 Sets field value to p. More...
 
void getPlaneValue (double &f0, double &f1, double &f2, double &f3) const
 Returns the value of the field. More...
 
void getPlaneValue (Plane &plane) const
 Returns the value of the field. More...
 
Plane getPlaneValue () const
 Returns the value of the field. More...
 
- Public Member Functions inherited from ml::Vector4Field
 Vector4Field ()=default
 Implements the runtime type system interface for this class. More...
 
 Vector4Field (const std::string &name)
 Constructor; creates a field with a name to manage a vector of four double values. More...
 
void setStringValue (const std::string &stringValue) override
 Sets the value of the field to stringValue. More...
 
void setVector4Value (const Vector4 &vectorValue)
 Sets the value of the field to vectorValue. More...
 
void updateVector4Value (const Vector4 &vectorValue)
 Sets the value of the field to vectorValue, but only touches the field if the new value is different from the old value. More...
 
void setVectorValue (const Vector4 &vectorValue)
 Sets the value of the field to vectorValue. More...
 
std::string getStringValue () const override
 Returns the value of the field as a string value. More...
 
const Vector4getVector4Value () const
 Returns the value of the field. More...
 
const Vector4getVectorValue () const
 Returns the value of the field. More...
 
void setValue (const Vector4 &vectorValue)
 Same as setVector4Value(). More...
 
void updateValue (const Vector4 &vectorValue)
 Same as updateVector4Value(). More...
 
const Vector4getValue () const
 Same as getVector4Value(). More...
 
- Public Member Functions inherited from ml::Field
 Field (const std::string &name=std::string())
 Constructor: Creates a field with name. More...
 
virtual ~Field ()
 Destructor: Destroys a field and removes all connection to fields and sensors. More...
 
FieldContainergetFieldContainer () const
 Returns the field container of the field (which may be NULL). More...
 
const std::string & getName () const
 Returns the name of field. More...
 
void setName (const std::string &name)
 Sets the name of field. Should be called only once after or while construction. More...
 
std::string getFullName () const
 Returns 'fieldContainerType(instanceName).fieldName' if field container is available, otherwise only the field name is returned. More...
 
bool isOutputOnly () const
 Returns whether this field is marked as a pure output field. More...
 
void setOutputOnly (bool outputOnly=true)
 Marks this field as a pure output field that is only changed by its module. More...
 
virtual MLint isValidValue ()
 Returns true (=1) if the field's value is valid; otherwise, false (=0) is returned. More...
 
void copyCStringValue (char *valueBuffer, MLint bufferSize)
 Copies the value of the field (as character string) into the specified buffer valueBuffer. More...
 
MLint getCStringValueSize ()
 Returns the length of the character string of the string value of the field. More...
 
void attachFieldSensor (FieldSensor *sensor)
 Attaches a field sensor sensor of this class instance in both directions. More...
 
void detachFieldSensor (FieldSensor *sensor)
 Detaches the field sensor sensor of this class instance in both directions. More...
 
void detachFieldSensors ()
 Detaches all field sensors of this class instance in both directions. More...
 
void attachField (OutputConnectorField *targetField)
 This calls attachField(targetField, false). More...
 
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. More...
 
void detachField (Field *targetField)
 Disconnects connections between the target field targetField and this instance. More...
 
void detachSourceFields ()
 Disconnects all source fields of this instance in both directions. More...
 
void detachDestinationFields ()
 Disconnects all target fields of this instance in both directions. More...
 
void detachAllFields ()
 Disconnects all source and target fields of this instance in both directions. More...
 
size_t getNumDestinationFields ()
 Returns the number of destination fields that could receive notifications or value sets. More...
 
FieldgetDestinationField (size_t index)
 Returns the destination field at index. Returns NULL if index is out of range. More...
 
size_t getNumSourceFields ()
 Returns the number of source fields that could send notifications or value sets. More...
 
FieldgetSourceField (size_t index)
 Returns the source field at index. Returns NULL if index is out of range. More...
 
virtual void touch (FieldSensor::Strength strength=FieldSensor::CHANGED)
 Notifies all connected fields and field sensors. More...
 
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. More...
 
bool areNotificationsEnabled ()
 Returns whether the notification mechanism for this field (e.g., when field values are set) is enabled (see enableNotifications(bool) ). More...
 

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. More...
 
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. More...
 
static MLintenableNotificationsCounterState ()
 Provides read/write access to the current counter state (see enableNotificationsGlobally(bool) ). More...
 
- Protected Member Functions inherited from ml::Vector4Field
void setValueFromField (const Field &field) override
 Reimplementation from Field that copies the field value more efficiently. More...
 
- 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. More...
 
void detachSourceField (Field *field)
 Removes a source field from this instance. If not found, then this call does nothing. More...
 
void detachFieldInternal (Field *field)
 Only removes the given field from the destination list. More...
 
- Protected Attributes inherited from ml::Field
std::string _name
 The name of this field. More...
 
std::vector< FieldSensor * > _sensors
 List of field sensors. More...
 
std::vector< Field * > _destinationFields
 List of (target) fields that shall be set to the value of this field or that shall be notified only if this field is changed or notified. More...
 
std::vector< Field * > _sourceFields
 List of (source) fields that will notify this field or that will copy their value to this field. More...
 
FieldContainer_fieldContainer
 The owning field container. More...
 
Flags _flags
 
- Static Protected Attributes inherited from ml::Field
static MLint _enableNotifications
 Flag that disables the notification process of field (-sensors) globally. More...
 

Detailed Description

Field to encapsulate a vector of four double values representing a plane with all properties of Vector4Field.

Definition at line 2036 of file mlFields.h.

Constructor & Destructor Documentation

◆ PlaneField()

ml::PlaneField::PlaneField ( const std::string &  name = "")
inlineexplicit

Implements the runtime type system interface for this class.

Constructor; creates a field with name name to manage a vector of four double values interpreted as plane.

Definition at line 2044 of file mlFields.h.

Member Function Documentation

◆ getPlaneValue() [1/3]

Plane ml::PlaneField::getPlaneValue ( ) const

Returns the value of the field.

◆ getPlaneValue() [2/3]

void ml::PlaneField::getPlaneValue ( double &  f0,
double &  f1,
double &  f2,
double &  f3 
) const

Returns the value of the field.

◆ getPlaneValue() [3/3]

void ml::PlaneField::getPlaneValue ( Plane plane) const

Returns the value of the field.

◆ setPlaneValue() [1/2]

void ml::PlaneField::setPlaneValue ( const Plane p)

Sets field value to p.

◆ setPlaneValue() [2/2]

void ml::PlaneField::setPlaneValue ( double  f0,
double  f1,
double  f2,
double  f3 
)

Sets field value to f0, f1, f2, and f3.


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