DATAKIT API  V2025.1
Dtk_Annotation Class Referenceabstract

This is abstract Dtk_Annotation class. More...

+ Inheritance diagram for Dtk_Annotation:

Public Member Functions

virtual Dtk_ErrorStatus _Store (void *)
 
void AddAdditionnalGeometries (const Dtk_tab< Dtk_EntityPtr > &inAdditionnalGeometries)
 Adds some additionnal geometries to the Dtk_2dEntity. More...
 
void AddAdditionnalGeometry (const Dtk_EntityPtr &inAdditionnalGeometry)
 Adds an additionnal geometry to the Dtk_2dEntity. More...
 
void AddAdditionnalTexts (Dtk_CompositeText inAddtionnalTexts)
 Adds some additionnal texts to the Dtk_2dEntity. More...
 
Dtk_ErrorStatus AddLeader (const Dtk_LeaderPtr &leader)
 Adds a leader to the Dtk_Annotation. More...
 
Dtk_Int32 DtkDynamicType (const Dtk_Int32 &inId)
 Retrieves the dynamic entity type. More...
 
int DtkDynamicType (const int &inId)
 
virtual void dump (FILE *file=stdout)
 
Dtk_InfoPtr get_info () const
 
virtual type_detk get_type_detk () const =0
 
const Dtk_tab< Dtk_EntityPtr > & GetAdditionnalGeometries () const
 Retrieves the additionnal geometries of the Dtk_2dEntity. More...
 
const Dtk_CompositeTextGetAdditionnalTexts () const
 Retrieves the additionnal texts of the Dtk_2dEntity. More...
 
virtual Dtk_ErrorStatus GetAnchorPoints (Dtk_pnt(&outTabPnts)[DTK_NB_ANCHOR_TYPES]) const =0
 Processes all the Dtk_Annotation anchor points. More...
 
const Dtk_IDGetID () const
 Get Internal UniqueID. More...
 
Dtk_LeaderPtr GetLeader (const Dtk_Size_t &inPos) const
 Gets the i'th leader. More...
 
virtual Dtk_pnt GetLocation () const
 Get the annoation location point. More...
 
const Dtk_anchor_typeGetLocationAnchorType () const
 Gets the location anchor type - read only -. More...
 
Dtk_Size_t GetNumLeaders () const
 Retrieves the number of leaders. More...
 
Dtk_Double64 GetOffset () const
 Gets the annotation offset - read only -. More...
 
Dtk_Double64 GetRotationAngle (const Dtk_dir &inXAxis=Dtk_dir(1, 0, 0), const Dtk_dir &inYAxis=Dtk_dir(0, 1, 0)) const
 Gets the text rotation angle giving a reference base. More...
 
virtual Dtk_Size_t GetSize () const
 
Dtk_dir GetXAxis () const
 Get the X Axis - read only -. More...
 
Dtk_dir GetYAxis () const
 Get the Y Axis - read only -. More...
 
Dtk_InfoPtrinfo ()
 
virtual std::ostream & operator<< (std::ostream &o) const
 
Dtk_Annotationoperator= (const Dtk_Annotation &inToBeAssigned)
 Assignment Operator. More...
 
Dtk_Annotationoperator= (Dtk_Annotation &&inToBeMoved) DTK_NOEXCEPT
 \MoveOp{inToBeAssigned} More...
 
virtual void PrepareTransfo ()
 
virtual Dtk_ErrorStatus Reverse ()
 Reverses the Dtk_Annotation. More...
 
virtual Dtk_ErrorStatus SetAnchorPoint (const Dtk_pnt &inNewLocation, const Dtk_anchor_type &inLocationAnchorType)=0
 Sets the Dtk_Annotation anchor point. More...
 
 SetAsDeprecated ("Undefined", "Use Dtk_TextStyle::Justification()") Dtk_justication_type GetJustification() const
 Get the justification type - read only -. More...
 
virtual Dtk_ErrorStatus SetLocation (const Dtk_pnt &inLocation)=0
 Sets the location point of the Dtk_Annotation. More...
 
Dtk_ErrorStatus SetLocation (const Dtk_pnt &location, const Dtk_anchor_type &inAnchorType)
 Sets the location point of the Dtk_Annotation. More...
 
virtual Dtk_ErrorStatus SetOffset (const Dtk_Double64 &inOffset)=0
 Sets the offset of the Dtk_Annotation. More...
 
virtual Dtk_ErrorStatus SetRotationAngle (const Dtk_Double64 &inRotationAngle)
 Sets the annotation angle using the annotation base. More...
 
virtual Dtk_ErrorStatus Transform (const Dtk_transfo &inTransfo)=0
 Applies a transformation matrix to the entity. //! More...
 

Static Public Member Functions

static Dtk_AnnotationDtkDynamicCast (Dtk_Object *s)
 Performs a dynamic cast - doesn't need RTTI -. More...
 

Protected Types

enum  { _typeID = DTK_TYPE_2D_ENTITY }
 
enum  { _typeID = DTK_TYPE_ENTITY }
 
enum  { _typeID = DTK_TYPE_ANNOTATION }
 

Protected Member Functions

void _Copy (const Dtk_2dEntity &s)
 
void _copy (const Dtk_Entity &s)
 
void _copy (const Dtk_Object &s)
 
void _init ()
 
void _reset ()
 
virtual Dtk_ObjectClone ()=0
 
 Dtk_Annotation ()
 Base constructor. More...
 
 Dtk_Annotation (const Dtk_Annotation &s)
 Copy constructor. More...
 
 Dtk_Annotation (const Dtk_pnt &inLocationPnt, const Dtk_InfoPtr &inInfos, Dtk_tab< Dtk_LeaderPtr > inLeadersArray=Dtk_tab< Dtk_LeaderPtr >(), const Dtk_Double64 &inAngle=0.0, const Dtk_Double64 &inOffSet=0.0, const Dtk_anchor_type &inAnchorType=DTK_ANCHOR_BOTTOM_LEFT, const Dtk_justication_type &inJustificationType=DTK_JUSTIFY_LEFT)
 Full featured constructor. More...
 
 Dtk_Annotation (Dtk_Annotation &&s) DTK_NOEXCEPT
 \MoveConstructor{s} More...
 
virtual ~Dtk_Annotation ()
 Destructor. More...
 

Protected Attributes

Dtk_Handle * _Private
 
unsigned long count_
 

Friends

class Dtk_SmartPtr< Dtk_Annotation >
 
std::ostream & operator<< (std::ostream &o, const Dtk_Annotation &d)
 

Detailed Description

This is abstract Dtk_Annotation class.

See also
Please use the Dtk_Annotation class to handle it.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
protectedinherited
Enumerator
_typeID 
1787  {
1789  };

◆ anonymous enum

anonymous enum
protectedinherited
Enumerator
_typeID 

◆ anonymous enum

anonymous enum
protected
Enumerator
_typeID 
2542  {
2544  };

Constructor & Destructor Documentation

◆ ~Dtk_Annotation()

virtual Dtk_Annotation::~Dtk_Annotation ( )
protectedvirtual

Destructor.

◆ Dtk_Annotation() [1/4]

Dtk_Annotation::Dtk_Annotation ( )
protected

Base constructor.

◆ Dtk_Annotation() [2/4]

Dtk_Annotation::Dtk_Annotation ( const Dtk_Annotation s)
protected

Copy constructor.

Parameters
sObject to copy.

◆ Dtk_Annotation() [3/4]

Dtk_Annotation::Dtk_Annotation ( Dtk_Annotation &&  s)
protected

\MoveConstructor{s}

◆ Dtk_Annotation() [4/4]

Dtk_Annotation::Dtk_Annotation ( const Dtk_pnt inLocationPnt,
const Dtk_InfoPtr inInfos,
Dtk_tab< Dtk_LeaderPtr inLeadersArray = Dtk_tabDtk_LeaderPtr >(),
const Dtk_Double64 inAngle = 0.0,
const Dtk_Double64 inOffSet = 0.0,
const Dtk_anchor_type inAnchorType = DTK_ANCHOR_BOTTOM_LEFT,
const Dtk_justication_type inJustificationType = DTK_JUSTIFY_LEFT 
)
protected

Full featured constructor.

Parameters
inLocationPntLocation of the Dtk_Annotation
inInfosInfos
inLeadersArrayAddittional leaders array
inAngleAngle
inOffSetOffset
inAnchorTypeAnnotation anchor type
inJustificationTypeAnnotation justification type

Member Function Documentation

◆ _Copy()

void Dtk_2dEntity::_Copy ( const Dtk_2dEntity s)
protectedinherited

◆ _copy() [1/2]

void Dtk_Entity::_copy ( const Dtk_Entity s)
protectedinherited

◆ _copy() [2/2]

void Dtk_Object::_copy ( const Dtk_Object s)
protectedinherited

◆ _init()

void Dtk_Entity::_init ( )
protectedinherited

◆ _reset()

void Dtk_Entity::_reset ( )
protectedinherited

◆ _Store()

◆ AddAdditionnalGeometries()

void Dtk_2dEntity::AddAdditionnalGeometries ( const Dtk_tab< Dtk_EntityPtr > &  inAdditionnalGeometries)
inherited

Adds some additionnal geometries to the Dtk_2dEntity.

Parameters
inAdditionnalGeometriesThe geometries to be added

◆ AddAdditionnalGeometry()

void Dtk_2dEntity::AddAdditionnalGeometry ( const Dtk_EntityPtr inAdditionnalGeometry)
inherited

Adds an additionnal geometry to the Dtk_2dEntity.

Parameters
inAdditionnalGeometryThe geometry to be added

◆ AddAdditionnalTexts()

void Dtk_2dEntity::AddAdditionnalTexts ( Dtk_CompositeText  inAddtionnalTexts)
inherited

Adds some additionnal texts to the Dtk_2dEntity.

Parameters
inAddtionnalTextsThe texts to be added

◆ AddLeader()

Dtk_ErrorStatus Dtk_Annotation::AddLeader ( const Dtk_LeaderPtr leader)

Adds a leader to the Dtk_Annotation.

Parameters
leaderThe leader to be added
Returns
dtkNoError is OK
Remarks
If Added leader is NULL, so no leader is added.

◆ Clone()

virtual Dtk_Object* Dtk_Annotation::Clone ( )
protectedpure virtual

◆ DtkDynamicCast()

static Dtk_Annotation* Dtk_Annotation::DtkDynamicCast ( Dtk_Object s)
static

Performs a dynamic cast - doesn't need RTTI -.

◆ DtkDynamicType() [1/2]

Dtk_Int32 Dtk_Annotation::DtkDynamicType ( const Dtk_Int32 inId)

Retrieves the dynamic entity type.

◆ DtkDynamicType() [2/2]

◆ dump()

virtual void Dtk_Object::dump ( FILE *  file = stdout)
virtualinherited

◆ get_info()

Dtk_InfoPtr Dtk_Entity::get_info ( ) const
inherited

◆ get_type_detk()

virtual type_detk Dtk_Annotation::get_type_detk ( ) const
pure virtual

◆ GetAdditionnalGeometries()

const Dtk_tab< Dtk_EntityPtr >& Dtk_2dEntity::GetAdditionnalGeometries ( ) const
inherited

Retrieves the additionnal geometries of the Dtk_2dEntity.

Returns
The additionnal geometries array - read only -.

◆ GetAdditionnalTexts()

const Dtk_CompositeText& Dtk_2dEntity::GetAdditionnalTexts ( ) const
inherited

Retrieves the additionnal texts of the Dtk_2dEntity.

Returns
The additionnal texts - read only -.

◆ GetAnchorPoints()

virtual Dtk_ErrorStatus Dtk_Annotation::GetAnchorPoints ( Dtk_pnt(&)  outTabPnts[DTK_NB_ANCHOR_TYPES]) const
pure virtual

Processes all the Dtk_Annotation anchor points.

Parameters
outTabPntsThe resulting anchor point array.
Returns
dtkNoError if OK

Implemented in Dtk_Region, Dtk_Symbol, Dtk_GeometricalTolerance, Dtk_Grid, Dtk_Table, Dtk_DatumTarget, Dtk_Roughness, and Dtk_Welding.

◆ GetID()

const Dtk_ID& Dtk_Entity::GetID ( ) const
inherited

Get Internal UniqueID.

Returns
InternalID

◆ GetLeader()

Dtk_LeaderPtr Dtk_Annotation::GetLeader ( const Dtk_Size_t inPos) const

Gets the i'th leader.

Parameters
inPosThe leader position - 0 indexed -
Returns
The inPos'th leader

◆ GetLocation()

virtual Dtk_pnt Dtk_Annotation::GetLocation ( ) const
virtual

Get the annoation location point.

Returns
The location point

◆ GetLocationAnchorType()

const Dtk_anchor_type& Dtk_Annotation::GetLocationAnchorType ( ) const

Gets the location anchor type - read only -.

Returns
The location anchor type.

◆ GetNumLeaders()

Dtk_Size_t Dtk_Annotation::GetNumLeaders ( ) const

Retrieves the number of leaders.

Returns
The number of leaders

◆ GetOffset()

Dtk_Double64 Dtk_Annotation::GetOffset ( ) const

Gets the annotation offset - read only -.

Returns
The annotation offset.
Warning
For internal use only

◆ GetRotationAngle()

Dtk_Double64 Dtk_Annotation::GetRotationAngle ( const Dtk_dir inXAxis = Dtk_dir(1, 0, 0),
const Dtk_dir inYAxis = Dtk_dir(0, 1, 0) 
) const

Gets the text rotation angle giving a reference base.

Parameters
inXAxisThe reference X Axis - default value = (1,0,0) -
inYAxisThe reference Y Axis - default value = (0,1,0) -
Returns
The rotation angle.

◆ GetSize()

◆ GetXAxis()

Dtk_dir Dtk_Annotation::GetXAxis ( ) const

Get the X Axis - read only -.

Returns
The X Axis.

◆ GetYAxis()

Dtk_dir Dtk_Annotation::GetYAxis ( ) const

Get the Y Axis - read only -.

Returns
The Y Axis.

◆ info()

Dtk_InfoPtr& Dtk_Entity::info ( )
inherited

◆ operator<<()

virtual std::ostream& Dtk_2dEntity::operator<< ( std::ostream &  o) const
virtualinherited
1846  {
1847  return o << "Dtk_2dEntity Base class";
1848  }

◆ operator=() [1/2]

Dtk_Annotation& Dtk_Annotation::operator= ( const Dtk_Annotation inToBeAssigned)

Assignment Operator.

Parameters
inToBeAssignedObject to copy.

◆ operator=() [2/2]

Dtk_Annotation& Dtk_Annotation::operator= ( Dtk_Annotation &&  inToBeMoved)

\MoveOp{inToBeAssigned}

◆ PrepareTransfo()

virtual void Dtk_Entity::PrepareTransfo ( )
virtualinherited

Reimplemented in Dtk_OffsetSurface.

◆ Reverse()

virtual Dtk_ErrorStatus Dtk_Annotation::Reverse ( )
virtual

Reverses the Dtk_Annotation.

Reimplemented in Dtk_DatumTarget.

◆ SetAnchorPoint()

virtual Dtk_ErrorStatus Dtk_Annotation::SetAnchorPoint ( const Dtk_pnt inNewLocation,
const Dtk_anchor_type inLocationAnchorType 
)
pure virtual

Sets the Dtk_Annotation anchor point.

Parameters
inNewLocationThe new location point.
inLocationAnchorTypeThe anchor type related to the new location.
Returns
dtkNoError if OK

Implemented in Dtk_Region, Dtk_Symbol, Dtk_GeometricalTolerance, Dtk_Grid, Dtk_Table, Dtk_DatumTarget, Dtk_Welding, and Dtk_Roughness.

◆ SetAsDeprecated()

Dtk_Annotation::SetAsDeprecated ( "Undefined"  ,
"Use Dtk_TextStyle::Justification()"   
) const

Get the justification type - read only -.

Returns
The justification type
Deprecated:
use the Dtk_TextStyle::Justification() instead

◆ SetLocation() [1/2]

virtual Dtk_ErrorStatus Dtk_Annotation::SetLocation ( const Dtk_pnt inLocation)
pure virtual

Sets the location point of the Dtk_Annotation.

The location point is related to the anchor type

Parameters
inLocationthe location point
Returns
dtkNoError if OK

Implemented in Dtk_Region, Dtk_Symbol, Dtk_GeometricalTolerance, Dtk_Grid, Dtk_Table, Dtk_DatumTarget, Dtk_Welding, and Dtk_Roughness.

◆ SetLocation() [2/2]

Dtk_ErrorStatus Dtk_Annotation::SetLocation ( const Dtk_pnt location,
const Dtk_anchor_type inAnchorType 
)

Sets the location point of the Dtk_Annotation.

The location point is related to the anchor type

Parameters
locationthe location point
inAnchorTypeThe anchor type related to the new location.
Returns
dtkNoError if OK

◆ SetOffset()

virtual Dtk_ErrorStatus Dtk_Annotation::SetOffset ( const Dtk_Double64 inOffset)
pure virtual

Sets the offset of the Dtk_Annotation.

The Offset is used to process bounding frames.

Parameters
inOffsetThe offset
Returns
dtkNoError if OK
Warning
For internal use only

Implemented in Dtk_Region, Dtk_Symbol, Dtk_GeometricalTolerance, Dtk_Grid, Dtk_Table, Dtk_DatumTarget, Dtk_Welding, and Dtk_Roughness.

◆ SetRotationAngle()

virtual Dtk_ErrorStatus Dtk_Annotation::SetRotationAngle ( const Dtk_Double64 inRotationAngle)
virtual

Sets the annotation angle using the annotation base.

Parameters
inRotationAngleThe rotation angle to be set
Returns
dtkNoError if OK

Reimplemented in Dtk_Symbol, Dtk_GeometricalTolerance, Dtk_Table, Dtk_DatumTarget, Dtk_Welding, and Dtk_Roughness.

◆ Transform()

virtual Dtk_ErrorStatus Dtk_Annotation::Transform ( const Dtk_transfo inTransfo)
pure virtual

Applies a transformation matrix to the entity. //!

Parameters
inTransfoThe transformation matrix to apply.

Implements Dtk_2dEntity.

Implemented in Dtk_Region, Dtk_Symbol, Dtk_GeometricalTolerance, Dtk_Grid, Dtk_Table, Dtk_DatumTarget, Dtk_Welding, and Dtk_Roughness.

Friends And Related Function Documentation

◆ Dtk_SmartPtr< Dtk_Annotation >

friend class Dtk_SmartPtr< Dtk_Annotation >
friend

◆ operator<<

std::ostream& operator<< ( std::ostream &  o,
const Dtk_Annotation d 
)
friend

Field Documentation

◆ _Private

Dtk_Handle* Dtk_Annotation::_Private
protected

◆ count_

unsigned long Dtk_Object::count_
protectedinherited
DTK_TYPE_ANNOTATION
@ DTK_TYPE_ANNOTATION
Definition: define.h:436
DTK_TYPE_ENTITY
@ DTK_TYPE_ENTITY
Definition: define.h:466
Dtk_Annotation::_typeID
@ _typeID
Definition: util_draw_dtk.hpp:2543
Dtk_Entity::_typeID
@ _typeID
Definition: util_ent_dtk.hpp:333
Dtk_2dEntity::_typeID
@ _typeID
Definition: util_draw_dtk.hpp:1788
DTK_TYPE_2D_ENTITY
@ DTK_TYPE_2D_ENTITY
Definition: define.h:471