Class representing general ML objects that support import/export via strings (setPersistentState() and getPersistentState()), arbitrary tree structures (using addStateToTree() and readStateFromTree()) or a data stream (using writeTo() and readFrom()). More...
#include <mlBase.h>
Public Member Functions | |
| Base () | |
| Constructor. | |
| virtual | ~Base () |
| Destructor. | |
| virtual Base * | deepCopy () const |
| Creates a deep copy of the given object. | |
| bool | isOfAllowedType (const std::vector< const RuntimeType * > &types) const |
| Check if this object's type is equal to or derived from one of the types given in the argument. | |
| virtual bool | isRefCountedBase () const |
| Returns if the instance is derived from RefCountedBase. | |
Persistence interfaces | |
| enum | PersistenceInterface { PersistenceByString, PersistenceByTreeNode, PersistenceByStream } |
| This enum describes the different persistence interfaces available. More... | |
| virtual bool | implementsPersistence (PersistenceInterface) const |
| Override this method to declare which persistence interfaces are implemented by your derived class. | |
| virtual char * | getPersistentState () const ML_RETURN_VALUE_SHOULD_BE_USED |
| Returns a C string describing the object's internal state. | |
| virtual void | setPersistentState (const char *) |
Restores the object's internal state from a string that had been previously generated using getPersistentState(). | |
| virtual void | clearPersistentState (char *) const |
Disposes a string previously allocated by getPersistentState(). | |
| virtual void | addStateToTree (TreeNode *) const |
| Attaches the object state as children of the given parent node. | |
| virtual void | readStateFromTree (TreeNode *) |
| Reads the object state from the children of the given parent node. | |
| virtual void | writeTo (AbstractPersistenceOutputStream *) const |
| Write the objects state to the data stream object. | |
| virtual void | readFrom (AbstractPersistenceInputStream *, int) |
| Read the objects state from the data stream object. | |
| ML_PERSISTENCE_VERSION (0) | |
| Set addStateToTree version number that can be accessed via getAddStateVersion() | |
Detailed Description
Class representing general ML objects that support import/export via strings (setPersistentState() and getPersistentState()), arbitrary tree structures (using addStateToTree() and readStateFromTree()) or a data stream (using writeTo() and readFrom()).
Objects of class Base
- can be represented using the field concept (class
BaseField) - provide an interface to allow the import/export of a persistent representation of an object's internal state.
Remark: This class is base class for Module and all derived modules.
Member Enumeration Documentation
Constructor & Destructor Documentation
| ml::Base::Base | ( | ) |
Constructor.
| virtual ml::Base::~Base | ( | ) | [virtual] |
Destructor.
Member Function Documentation
| virtual void ml::Base::addStateToTree | ( | TreeNode * | ) | const [inline, virtual] |
Attaches the object state as children of the given parent node.
Reimplemented in ml::LUTFLinear, ml::BaseItem, ml::BaseContainerItem, ml::CurveData, ml::CurveList, ml::ListBase, ml::ListTemplate< T >, ml::BaseListTemplate< T >, ml::StylePalette, ml::XMarker, ml::CSOList, ml::CSOVoxelSetList, ml::BaseGraphItem, ml::Graph, ml::Skeleton, ml::VesselEdge, ml::VesselNode, ml::PropertyContainer, ml::PropertyManager, ml::ListTemplate< Vector6 >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< vec6i >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< XMarker >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::BaseListTemplate< BaseItem >, ml::BaseListTemplate< BaseContainerItem >, and ml::BaseListTemplate< XMarker >.
| virtual void ml::Base::clearPersistentState | ( | char * | ) | const [inline, virtual] |
Disposes a string previously allocated by getPersistentState().
Reimplemented in ml::BaseItem, ml::BaseContainerItem, ml::DiscList, ml::ListTemplate< T >, ml::MarkerList, ml::PointList, ml::RasterFunction, ml::RasterFunctionList, ml::SphereList, ml::VectorList, ml::MLVTKParentWrapper, ml::ListTemplate< Vector6 >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< vec6i >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< XMarker >, ml::ListTemplate< vec3i >, and ml::ListTemplate< vec4i >.
| virtual Base* ml::Base::deepCopy | ( | ) | const [inline, virtual] |
Creates a deep copy of the given object.
The default implementation returns a NULL pointer and has to be overloaded by derived classes. It can be used to clone Base objects without knowledge of the exact type of object.
Reimplemented in ml::BaseItem, ml::BaseList, ml::CurveData, ml::CurveList, ml::ListBase, ml::ListTemplate< T >, ml::StylePalette, ml::WEM, ml::CSOList, ml::Graph, ml::ListTemplate< Vector6 >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< vec6i >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< XMarker >, ml::ListTemplate< vec3i >, and ml::ListTemplate< vec4i >.
| virtual char* ml::Base::getPersistentState | ( | ) | const [inline, virtual] |
Returns a C string describing the object's internal state.
The memory for the string will be allocated here and has to be deallocated using clearPersistentState().
Reimplemented in ml::BaseItem, ml::BaseContainerItem, ml::DiscList, ml::ListTemplate< T >, ml::MarkerList, ml::PointList, ml::RasterFunction, ml::RasterFunctionList, ml::SphereList, ml::VectorList, ml::XMarker, ml::MLVTKParentWrapper, ml::ListTemplate< Vector6 >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< vec6i >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< XMarker >, ml::ListTemplate< vec3i >, and ml::ListTemplate< vec4i >.
| virtual bool ml::Base::implementsPersistence | ( | PersistenceInterface | ) | const [inline, virtual] |
Override this method to declare which persistence interfaces are implemented by your derived class.
Reimplemented in ml::StandardItemModel.
| bool ml::Base::isOfAllowedType | ( | const std::vector< const RuntimeType * > & | types | ) | const |
Check if this object's type is equal to or derived from one of the types given in the argument.
This method will also return true if the vector is empty, since this denotes that any type is allowed.
| virtual bool ml::Base::isRefCountedBase | ( | ) | const [inline, virtual] |
Returns if the instance is derived from RefCountedBase.
Reimplemented in ml::RefCountedBase.
| ml::Base::ML_PERSISTENCE_VERSION | ( | 0 | ) |
Set addStateToTree version number that can be accessed via getAddStateVersion()
| virtual void ml::Base::readFrom | ( | AbstractPersistenceInputStream * | , |
| int | |||
| ) | [inline, virtual] |
Read the objects state from the data stream object.
version is the version number given through ML_PERSISTENCE_VERSION at the time the object was written to the AbstractPersistenceOutStream.
Include mlAbstractPersistenceStream.h for the implementation of this method.
If you are sub-classing from another Base class that implements persistence, use the macro ML_READFROM_SUPER() to load the super-class data, because this takes care of reading and checking the version number of the super class.
Reimplemented in ml::BaseItem, and ml::StandardItemModel.
| virtual void ml::Base::readStateFromTree | ( | TreeNode * | ) | [inline, virtual] |
Reads the object state from the children of the given parent node.
Reimplemented in ml::LUTFLinear, ml::BaseItem, ml::BaseContainerItem, ml::CurveData, ml::CurveList, ml::ListBase, ml::ListTemplate< T >, ml::BaseListTemplate< T >, ml::StylePalette, ml::XMarker, ml::CSOList, ml::CSOVoxelSetList, ml::BaseGraphItem, ml::Graph, ml::Skeleton, ml::VesselEdge, ml::VesselNode, ml::PropertyContainer, ml::PropertyManager, ml::ListTemplate< Vector6 >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< vec6i >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< XMarker >, ml::ListTemplate< vec3i >, ml::ListTemplate< vec4i >, ml::BaseListTemplate< BaseItem >, ml::BaseListTemplate< BaseContainerItem >, and ml::BaseListTemplate< XMarker >.
| virtual void ml::Base::setPersistentState | ( | const char * | ) | [inline, virtual] |
Restores the object's internal state from a string that had been previously generated using getPersistentState().
Reimplemented in ml::BaseItem, ml::BaseContainerItem, ml::DiscList, ml::ListTemplate< T >, ml::MarkerList, ml::PointList, ml::RasterFunction, ml::RasterFunctionList, ml::SphereList, ml::VectorList, ml::XMarker, ml::MLVTKParentWrapper, ml::ListTemplate< Vector6 >, ml::ListTemplate< BaseItem >, ml::ListTemplate< KeyFrame >, ml::ListTemplate< BaseContainerItem >, ml::ListTemplate< Vector3 >, ml::ListTemplate< Matrix4 >, ml::ListTemplate< Vector4 >, ml::ListTemplate< vec6i >, ml::ListTemplate< Matrix3 >, ml::ListTemplate< XMarker >, ml::ListTemplate< vec3i >, and ml::ListTemplate< vec4i >.
| virtual void ml::Base::writeTo | ( | AbstractPersistenceOutputStream * | ) | const [inline, virtual] |
Write the objects state to the data stream object.
Include mlAbstractPersistenceStream.h for the implementation of this method.
If you are sub-classing from another Base class that implements persistence, use the macro ML_WRITETO_SUPER() to save the super-class data, because this takes care of writing the version number of the super class.
Reimplemented in ml::BaseItem, and ml::StandardItemModel.
The documentation for this class was generated from the following file:
- MeVis/Foundation/Sources/MLUtilities/mlBase.h
