Dario Sassi
427 lines
24 KiB
C++
427 lines
24 KiB
C++
////////////////////////////////////////////////////////////////////////////////
|
||
/**
|
||
\file
|
||
\brief \ru Пользовательские атрибуты.
|
||
\en User attributes. \~
|
||
|
||
*/
|
||
////////////////////////////////////////////////////////////////////////////////
|
||
|
||
#ifndef __ATTR_USER_ATTRIBUT_H
|
||
#define __ATTR_USER_ATTRIBUT_H
|
||
|
||
|
||
#include <attribute.h>
|
||
#include <io_memory_buffer.h>
|
||
#include <math_define.h>
|
||
#include <attr_registry.h>
|
||
#include <tool_cstring.h>
|
||
#include <tool_multithreading.h>
|
||
#include <memory>
|
||
|
||
class MATH_CLASS MbExternalAttribute;
|
||
class MATH_CLASS MbUserAttribute;
|
||
class MATH_CLASS MbFixAttrSet;
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Интерфейс определения атрибута.
|
||
\en Attribute definition interface. \~
|
||
\details \ru Интерфейс определения атрибута. Определение атрибута - объект используемый
|
||
для преобразования пользовательских внесистемных атрибутов в пользовательские системные,
|
||
а так же для разборки пользовательских системных атрибутов
|
||
на составные части - другие атрибуты системные атрибуты, и обратной сборки.
|
||
\en Attribute definition interface. Attribute definition - the object used
|
||
for converting user external attributes to user system attributes
|
||
and for a disassembly of user system attributes
|
||
to their components - other system attributes, and for reassembly. \~
|
||
\ingroup Model_Attributes
|
||
*/
|
||
class IAttrDefinition
|
||
{
|
||
public:
|
||
/// \ru Преобразовать из пользовательского в "системный". \en Convert user attribute to "system" one.
|
||
virtual MbUserAttribute * ReduceUserAttrib ( const MbExternalAttribute & source ) = 0;
|
||
|
||
/// \ru Преобразовать из "системного" в пользовательский. \en Convert "system" attribute to user one.
|
||
virtual MbExternalAttribute * AdvanceUserAttrib( const MbUserAttribute & source ) = 0;
|
||
|
||
/// \ru "Разобрать" на составляющие атрибуты. \en Disassemble on attributes.
|
||
virtual MbFixAttrSet * DisassembleUsetAttrib( const MbExternalAttribute & source ) = 0;
|
||
|
||
/// \ru "Собрать" из составляющих атрибутов. \en Reassemble from attributes.
|
||
virtual bool ReassembleUsetAttrib ( const MbFixAttrSet & source, MbExternalAttribute & targer ) = 0;
|
||
};
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Шаблон "определения" пользовательского атрибута.
|
||
\en A template of user attribute definition. \~
|
||
\details \ru Шаблонный класс "Определения" пользовательского атрибута - используется для создания
|
||
стандартных определений, с предопределенным функционалом.
|
||
\en Template class "Definition" of user attribute - used for creation
|
||
of standard definitions with predefined functionality. \~
|
||
\ingroup Model_Attributes
|
||
*/
|
||
template <typename AttrClass>
|
||
class UserAttrDefinition : public IAttrDefinition
|
||
{
|
||
public:
|
||
/// \ru Преобразовать из пользовательского в "системный". \en Convert user attribute to "system" one.
|
||
virtual MbUserAttribute * ReduceUserAttrib ( const MbExternalAttribute & source );
|
||
|
||
/// \ru Преобразовать из "системного" в пользовательский. \en Convert "system" attribute to user one.
|
||
virtual MbExternalAttribute * AdvanceUserAttrib( const MbUserAttribute & source );
|
||
|
||
/// \ru "Разобрать" на составляющие атрибуты. \en Disassemble on attributes.
|
||
virtual MbFixAttrSet * DisassembleUsetAttrib( const MbExternalAttribute & source );
|
||
|
||
/// \ru "Собрать" из составляющих атрибутов. \en Reassemble from attributes.
|
||
virtual bool ReassembleUsetAttrib( const MbFixAttrSet & source, MbExternalAttribute & targer );
|
||
};
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Пользовательский системный атрибут.
|
||
\en User system attribute. \~
|
||
\details \ru Пользовательский системный атрибут. \n
|
||
\en User system attribute. \n \~
|
||
\ingroup Model_Attributes
|
||
*/
|
||
class MATH_CLASS MbUserAttribute : public MbAttribute, public MbSyncItem {
|
||
typedef std_unique_ptr<membuf> UniqueMembufPtr;
|
||
protected :
|
||
MbUserAttribType userType_; ///< \ru Тип пользовательского атрибута. \en Type of user attribute.
|
||
c3d::string_t prompt_; ///< \ru Строка описания. \en String of description.
|
||
private:
|
||
SPtr<MbExternalAttribute> extAttr;
|
||
mutable UniqueMembufPtr userBuf;
|
||
|
||
private: // public: // You must inherit from MbExternalAttribute only!!!
|
||
/// \ru Конструктор. \en Constructor.
|
||
MbUserAttribute( const TCHAR * prompt, const MbUserAttribType & id );
|
||
|
||
public:
|
||
virtual MbeAttributeType AttributeFamily() const; // \ru Дать тип атрибута. \en Get type of an attribute.
|
||
virtual MbeAttributeType AttributeType() const; // \ru Выдать подтип атрибута. \en Get subtype of an attribute.
|
||
|
||
/// \ru Выдать подтип пользовательского атрибута по пользовательскому типу. \en Get subtype of an user attribute by user-defined type.
|
||
static MbeAttributeType AttributeType( const MbUserAttribType & userType );
|
||
|
||
virtual MbAttribute & Duplicate( MbRegDuplicate * = NULL ) const; // \ru Сделать копию элемента. \en Create a copy of the element.
|
||
virtual bool IsSame( const MbAttribute &, double accuracy ) const; // \ru Определить, являются ли объекты равными. \en Determine whether objects are equal.
|
||
virtual bool Init( const MbAttribute & ); // \ru Инициализировать данные по присланным. \en Initialize data by given attribute.
|
||
|
||
// \ru Выполнить действия при изменении владельца не связанное с другими действиями \en Perform actions which are not associated with other actions when changing the owner
|
||
virtual void OnChangeOwner( const MbAttributeContainer & owner );
|
||
|
||
// \ru Выполнить действия при конвертации владельца \en Perform actions when converting the owner
|
||
virtual void OnConvertOwner( const MbAttributeContainer & owner, MbAttributeContainer & other );
|
||
|
||
// \ru Выполнить действия при трансформировании владельца \en Perform actions when transforming the owner
|
||
virtual void OnTransformOwner( const MbAttributeContainer & owner, const MbMatrix3D & matr, MbRegTransform * iReg );
|
||
|
||
// \ru Выполнить действия при перемещении владельца. \en Perform actions when moving the owner.
|
||
virtual void OnMoveOwner( const MbAttributeContainer & owner, const MbVector3D & to, MbRegTransform * iReg = NULL );
|
||
|
||
// \ru Выполнить действия при вращении владельца. \en Perform actions when rotating the owner.
|
||
virtual void OnRotateOwner( const MbAttributeContainer & owner, const MbAxis3D & axis, double angle, MbRegTransform * iReg = NULL );
|
||
|
||
// \ru Выполнить действия при копировании владельца \en Perform actions when copying the owner.
|
||
virtual void OnCopyOwner( const MbAttributeContainer & owner, MbAttributeContainer & other, MbRegDuplicate * iReg );
|
||
|
||
// \ru Выполнить действия при объединении владельца \en Perform actions when merging the owner.
|
||
virtual void OnMergeOwner( const MbAttributeContainer & owner, MbAttributeContainer & other );
|
||
|
||
// \ru Выполнить действия при замене владельца. \en Perform actions when replacing the owner.
|
||
virtual void OnReplaceOwner( const MbAttributeContainer & owner, MbAttributeContainer & other );
|
||
|
||
// \ru Выполнить действия при разделении владельца. \en Perform actions when splitting the owner.
|
||
virtual void OnSplitOwner( const MbAttributeContainer & owner, const std::vector<MbAttributeContainer*> & others );
|
||
|
||
// \ru Выполнить действия при удалении владельца. \en Perform actions when deleting the owner.
|
||
virtual void OnDeleteOwner( const MbAttributeContainer & owner );
|
||
|
||
/// \ru Выдать подсказку. \en Get a hint.
|
||
const TCHAR * GetPrompt() const;
|
||
/// \ru Выдать идентификатор хранимого атрибута. \en Get identifier of stored attribute.
|
||
void GetUserAttribId( MbUserAttribType & attrId ) const;
|
||
|
||
/// \ru Установить пользовательские данные. \en Set user data.
|
||
void SetUserData( const char * extAttrMemory );
|
||
/// \ru Установить пользовательские данные. \en Set user data.
|
||
void SetUserData( const std::vector<char> & extAttrData );
|
||
/// \ru Получить пользовательские данные. \en Get user data.
|
||
bool GetUserData( membuf & memBuf ) const;
|
||
/// \ru Создать пользовательский внесистемный атрибут по пользовательским данным. \en Make a user external attribute using user data.
|
||
bool MakeExternalAttribute( bool keepExisting );
|
||
/// \ru Обновить пользовательские данные по внесистемному атрибуту пользователя. \en Update user data using the user external attribute.
|
||
bool UpdateByExternalAttribute() const;
|
||
|
||
/// \ru Выдать пользовательский внесистемный атрибут. \en Get a user external attribute.
|
||
const MbExternalAttribute * GetExternalAttribute() const { return extAttr; }
|
||
/// \ru Установить пользовательский внесистемный атрибут. \en Set a user external attribute.
|
||
bool SetExternalAttribute( MbExternalAttribute * );
|
||
/// \ru Установить пользовательский внесистемный атрибут (его копию). \en Set a user external attribute (сopy).
|
||
void SetExternalAttribute( const MbExternalAttribute & );
|
||
|
||
virtual void GetProperties( MbProperties & ); // \ru Выдать свойства объекта. \en Get properties of the object.
|
||
virtual size_t SetProperties( const MbProperties & ); // \ru Установить свойства объекта. \en Set properties of the object.
|
||
virtual MbePrompt GetPropertyName(); // \ru Выдать заголовок свойства объекта. \en Get a name of object property.
|
||
|
||
template <typename AttrClass>
|
||
friend MbUserAttribute * UserAttrDefinition<AttrClass>::ReduceUserAttrib( const MbExternalAttribute & );
|
||
|
||
protected:
|
||
virtual ~MbUserAttribute(); // Use AddRef/Release or smart pointer SPtr<MbAttribute> to destruct it correctly.
|
||
|
||
DECLARE_PERSISTENT_CLASS_NEW_DEL( MbUserAttribute )
|
||
OBVIOUS_PRIVATE_COPY( MbUserAttribute )
|
||
};
|
||
|
||
IMPL_PERSISTENT_OPS( MbUserAttribute )
|
||
|
||
class MATH_CLASS MbFixAttrSet;
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Пользовательский внесистемный атрибут - базовый класс.
|
||
\en User external attribute - the base class. \~
|
||
\details \ru Пользовательский внесистемный атрибут - базовый класс. \n
|
||
\en User external attribute - the base class. \n \~
|
||
\ingroup Model_Attributes
|
||
*/
|
||
class MATH_CLASS MbExternalAttribute : public MbAttribute
|
||
{
|
||
public :
|
||
/// \ru Конструктор. \en Constructor.
|
||
MbExternalAttribute();
|
||
/// \ru Деструктор. \en Destructor.
|
||
virtual ~MbExternalAttribute();
|
||
|
||
virtual MbeAttributeType AttributeFamily() const; // \ru Дать тип атрибута. \en Get type of an attribute.
|
||
virtual MbeAttributeType AttributeType() const; // \ru Выдать подтип атрибута. \en Get subtype of an attribute.
|
||
/// \ru Выдать подтип атрибута. \en Get subtype of an attribute.
|
||
virtual MbUserAttribType AttrTypeEx() const = 0;
|
||
|
||
virtual MbAttribute & Duplicate( MbRegDuplicate * = NULL ) const = 0; // \ru Сделать копию элемента. \en Create a copy of the element.
|
||
virtual bool IsSame( const MbAttribute &, double accuracy ) const = 0; // \ru Определить, являются ли объекты равными. \en Determine whether objects are equal.
|
||
virtual bool Init( const MbAttribute & attr ) = 0; // \ru Инициализировать данные по присланным. \en Initialize data.
|
||
|
||
// \ru Выполнить действия при изменении владельца, не связанное с другими действиями. \en Perform actions which are not associated with other actions when changing the owner.
|
||
virtual void OnChangeOwner( const MbAttributeContainer & owner );
|
||
// \ru Выполнить действия при конвертации владельца. \en Perform actions when converting the owner.
|
||
virtual void OnConvertOwner( const MbAttributeContainer & owner, MbAttributeContainer & other );
|
||
// \ru Выполнить действия при трансформировании владельца. \en Perform actions when transforming the owner.
|
||
virtual void OnTransformOwner( const MbAttributeContainer & owner, const MbMatrix3D & matr, MbRegTransform * iReg = NULL );
|
||
// \ru Выполнить действия при перемещении владельца. \en Perform actions when moving the owner.
|
||
virtual void OnMoveOwner( const MbAttributeContainer & owner, const MbVector3D & to, MbRegTransform * iReg = NULL );
|
||
// \ru Выполнить действия при вращении владельца. \en Perform actions when rotating the owner.
|
||
virtual void OnRotateOwner( const MbAttributeContainer & owner, const MbAxis3D & axis, double angle, MbRegTransform * iReg = NULL );
|
||
// \ru Выполнить действия при копировании владельца. \en Perform actions when copying the owner.
|
||
virtual void OnCopyOwner( const MbAttributeContainer & owner, MbAttributeContainer & other, MbRegDuplicate * iReg = NULL );
|
||
// \ru Выполнить действия при объединении владельца. \en Perform actions when merging the owner.
|
||
virtual void OnMergeOwner( const MbAttributeContainer & owner, MbAttributeContainer & other );
|
||
// \ru Выполнить действия при замене владельца. \en Perform actions when replacing the owner.
|
||
virtual void OnReplaceOwner( const MbAttributeContainer & owner, MbAttributeContainer & other );
|
||
// \ru Выполнить действия при разделении владельца. \en Perform actions when splitting the owner.
|
||
virtual void OnSplitOwner( const MbAttributeContainer & owner, const std::vector<MbAttributeContainer*> & others );
|
||
// \ru Выполнить действия при удалении владельца. \en Perform actions when deleting the owner.
|
||
virtual void OnDeleteOwner( const MbAttributeContainer & owner );
|
||
|
||
virtual void GetProperties( MbProperties & ); // \ru Выдать свойства объекта. \en Get properties of the object.
|
||
virtual size_t SetProperties( const MbProperties & ); // \ru Установить свойства объекта. \en Set properties of the object.
|
||
virtual MbePrompt GetPropertyName(); // \ru Выдать заголовок свойства объекта. \en Get a name of object property.
|
||
|
||
protected:
|
||
static MbFixAttrSet * CreateFixAttrSet( const MbUserAttribType &, c3d::AttrVector & );
|
||
|
||
OBVIOUS_PRIVATE_COPY( MbExternalAttribute )
|
||
};
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Фиксированный набор атрибутов
|
||
\en Fixed set of attributes. \~
|
||
\details \ru Набор атрибутов, состав которого нельзя изменить, но никто не запрещает
|
||
менять значение самих атрибутов.
|
||
\en A set of attributes the structure of which cannot be changed, but it is possible
|
||
to change values of the attributes. \~
|
||
\ingroup Model_Attributes
|
||
*/
|
||
class MATH_CLASS MbFixAttrSet
|
||
{
|
||
private:
|
||
MbUserAttribType userAttrId; ///< \ru Идентификатор соответствующего пользовательского атрибута. \en Identifier of the corresponding external attribute.
|
||
c3d::AttrVector attributes; ///< \ru Атрибуты. \en Attributes.
|
||
|
||
private:
|
||
/// \ru Конструктор. \en Constructor.
|
||
MbFixAttrSet( c3d::AttrVector & attrs );
|
||
public:
|
||
/// \ru Деструктор. \en Destructor.
|
||
~MbFixAttrSet() { std::for_each( attributes.begin(), attributes.end(), ReleaseItem<MbAttribute> ); }
|
||
|
||
public:
|
||
/// \ru Выдать идентификатор атрибута. \en Get attribute identifier.
|
||
const MbUserAttribType & GetUserAttrId() const;
|
||
|
||
/// \ru Установить атрибуты. \en Set attributes.
|
||
void SetAttribute ( size_t index, const MbAttribute & attrib );
|
||
/// \ru Выдать атрибуты. \en Get attributes.
|
||
const MbAttribute & GetAttribute ( size_t index, const MbAttribute & attrib ) const;
|
||
|
||
// \ru Выдать количество атрибутов. \en Get the number of attributes.
|
||
size_t AttributesCount() const { return attributes.size(); }
|
||
|
||
// \ru Доступ хотелось бы ограничить только функцией. \en Access should be constrained only by a function.
|
||
// static MbFixAttrSet * MbExternalAttribute::CreateFixAttrSet( const MbUserAttribType & attrId, std::vector<MbAttribute*> & attrs );
|
||
friend class MbExternalAttribute;
|
||
|
||
OBVIOUS_PRIVATE_COPY( MbFixAttrSet )
|
||
};
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Шаблон явления "Определения" пользовательского атрибута.
|
||
\en A template of "Definition" phenomenon of user attribute. \~
|
||
\ingroup Model_Attributes
|
||
*/
|
||
template <typename AttrDefClass>
|
||
class UserAttrDefinitionInstance : public AttrDefInstance
|
||
{
|
||
private:
|
||
AttrDefClass * attrDef; ///< \ru "Определение" пользовательского атрибута. \en "Definition" of user attribute.
|
||
|
||
public:
|
||
/// \ru Конструктор. \en Constructor.
|
||
UserAttrDefinitionInstance( const MbUserAttribType & type );
|
||
/// \ru Деструктор. \en Destructor.
|
||
virtual ~UserAttrDefinitionInstance();
|
||
|
||
public:
|
||
// \ru Дать "определение" пользовательского атрибута. \en Get a "definition" of user attribute.
|
||
virtual IAttrDefinition * GetAttrDefinition();
|
||
};
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/// \ru Преобразовать из пользовательского в "системный". \en Convert user attribute to "system" one.
|
||
// ---
|
||
template <typename AttrClass>
|
||
MbUserAttribute * UserAttrDefinition<AttrClass>::ReduceUserAttrib( const MbExternalAttribute & source )
|
||
{
|
||
MbUserAttribType attrId( source.AttrTypeEx() );
|
||
|
||
MbUserAttribute * resAttr = new MbUserAttribute( _T("AttrClass"), attrId );
|
||
resAttr->InitActions( source );
|
||
{
|
||
const char * charBuf = NULL;
|
||
size_t memLen = 0;
|
||
{
|
||
membuf memBuf;
|
||
{
|
||
const AttrClass * attrPtr = static_cast<const AttrClass *>(&source);
|
||
writer out( memBuf, io::out );
|
||
if ( out.good() )
|
||
out << attrPtr;
|
||
}
|
||
memBuf.closeBuff(); // before memBuf.getMemLen!!!
|
||
|
||
memLen = memBuf.getMemLen();
|
||
charBuf = new char[memLen];
|
||
memBuf.toMemory( charBuf, memLen );
|
||
}
|
||
resAttr->SetUserData( charBuf );
|
||
delete [] charBuf;
|
||
}
|
||
|
||
return resAttr;
|
||
}
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/// \ru Преобразовать из "системного" в пользовательский. \en Convert "system" attribute to user one.
|
||
// ---
|
||
template <typename AttrClass>
|
||
MbExternalAttribute * UserAttrDefinition<AttrClass>::AdvanceUserAttrib( const MbUserAttribute & source )
|
||
{
|
||
AttrClass * resAttr = NULL;
|
||
MbUserAttribType attrId;
|
||
source.GetUserAttribId( attrId );
|
||
{
|
||
membuf memBuf;
|
||
{
|
||
bool canRead = true;
|
||
if ( !source.GetUserData( memBuf ) ) {
|
||
canRead = false;
|
||
if ( source.UpdateByExternalAttribute() ) {
|
||
canRead = source.GetUserData( memBuf );
|
||
}
|
||
}
|
||
if ( canRead ) {
|
||
reader in( memBuf, io::in );
|
||
if ( in.good() )
|
||
in >> resAttr;
|
||
}
|
||
}
|
||
memBuf.closeBuff();
|
||
}
|
||
return resAttr;
|
||
}
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/// \ru "Разобрать" на составляющие атрибуты. \en Disassemble on attributes.
|
||
// ---
|
||
template <typename AttrClass>
|
||
MbFixAttrSet * UserAttrDefinition<AttrClass>::DisassembleUsetAttrib( const MbExternalAttribute & /*source*/ ) {
|
||
return NULL;
|
||
}
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/// \ru "Собрать" из составляющих атрибутов. \en Reassemble from attributes.
|
||
// ---
|
||
template <typename AttrClass>
|
||
bool UserAttrDefinition<AttrClass>::ReassembleUsetAttrib( const MbFixAttrSet & /*source*/, MbExternalAttribute & /*targer*/ ) {
|
||
return false;
|
||
}
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
// \ru Конструктор. \en Constructor.
|
||
// ---
|
||
template <typename AttrDefClass>
|
||
UserAttrDefinitionInstance<AttrDefClass>::UserAttrDefinitionInstance(const MbUserAttribType & type)
|
||
: AttrDefInstance( type )
|
||
, attrDef( NULL )
|
||
{
|
||
}
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
// \ru Деструктор. \en Destructor.
|
||
// ---
|
||
template <typename AttrDefClass>
|
||
UserAttrDefinitionInstance<AttrDefClass>::~UserAttrDefinitionInstance()
|
||
{
|
||
if ( attrDef != NULL )
|
||
delete attrDef;
|
||
}
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
// \ru Дать "определение" пользовательского атрибута. \en Get a "definition" of user attribute.
|
||
// ---
|
||
template <typename AttrDefClass>
|
||
IAttrDefinition * UserAttrDefinitionInstance<AttrDefClass>::GetAttrDefinition()
|
||
{
|
||
if ( attrDef == NULL )
|
||
attrDef = new AttrDefClass();
|
||
return attrDef;
|
||
}
|
||
|
||
|
||
#endif // __ATTR_USER_ATTRIBUT_H
|