The representation of a single tool. More...

#include <Tool.h>

Public Types
enum ToolMaterial { MATUNDEFINED, HIGHSPEEDSTEEL, HIGHCARBONTOOLSTEEL, CASTALLOY, CARBIDE, CERAMICS, DIAMOND, SIALON }

enum ToolType { UNDEFINED, DRILL, CENTERDRILL, COUNTERSINK, COUNTERBORE, FLYCUTTER, REAMER, TAP, ENDMILL, SLOTCUTTER, BALLENDMILL, CHAMFERMILL, CORNERROUND, ENGRAVER }

Public Member Functions
virtual unsigned int getMemSize (void) const
	This method is used to get the size of objects It is not meant to have the exact size, it is more or less an estimation which runs fast! Is it two bytes or a GB? More...

virtual void Restore (Base::XMLReader &)
	This method is used to restore properties from an XML document. More...

virtual void Save (Base::Writer &) const
	This method is used to save properties to an XML document. More...

Tool ()

Tool (const char *name, ToolType type=Tool::UNDEFINED, ToolMaterial material=Tool::MATUNDEFINED, double diameter=10.0, double lengthoffset=100, double flatradius=0, double cornerradius=0, double cuttingedgeangle=0, double cuttingedgeheight=0)

~Tool ()

Public Member Functions inherited from Base::Persistence
void dumpToStream (std::ostream &stream, int compression)

virtual Base::Type getTypeId (void) const

virtual void RestoreDocFile (Reader &)
	This method is used to restore large amounts of data from a file In this method you simply stream in your SaveDocFile() saved data. More...

void restoreFromStream (std::istream &stream)

virtual void SaveDocFile (Writer &) const
	This method is used to save large amounts of data to a binary file. More...

Public Member Functions inherited from Base::BaseClass
BaseClass ()
	Construction. More...

virtual PyObject * getPyObject (void)
	This method returns the Python wrapper for a C++ object. More...

bool isDerivedFrom (const Type type) const

virtual void setPyObject (PyObject *)

virtual ~BaseClass ()
	Destruction. More...

Static Public Member Functions
static ToolMaterial getToolMaterial (std::string mat)

static ToolType getToolType (std::string type)

static const char * MaterialName (ToolMaterial mat)

static const std::vector< std::string > ToolMaterials (void)

static const std::vector< std::string > ToolTypes (void)

static const char * TypeName (ToolType typ)

Static Public Member Functions inherited from Base::Persistence
static void * create (void)

static std::string encodeAttribute (const std::string &)
	Encodes an attribute upon saving. More...

static Base::Type getClassTypeId (void)

static void init (void)

Static Public Member Functions inherited from Base::BaseClass
static void * create (void)

static Type getClassTypeId (void)

static void init (void)

Public Attributes
double CornerRadius

double CuttingEdgeAngle

double CuttingEdgeHeight

double Diameter

double FlatRadius

double LengthOffset

ToolMaterial Material

std::string Name

ToolType Type

Additional Inherited Members
Static Protected Member Functions inherited from Base::BaseClass
static void initSubclass (Base::Type &toInit, const char ClassName, const char ParentName, Type::instantiationMethod method=nullptr)

Detailed Description

The representation of a single tool.

Member Enumeration Documentation

◆ ToolMaterial

enum Path::Tool::ToolMaterial

Enumerator
MATUNDEFINED
HIGHSPEEDSTEEL
HIGHCARBONTOOLSTEEL
CASTALLOY
CARBIDE
CERAMICS
DIAMOND
SIALON

◆ ToolType

enum Path::Tool::ToolType

Enumerator
UNDEFINED
DRILL
CENTERDRILL
COUNTERSINK
COUNTERBORE
FLYCUTTER
REAMER
TAP
ENDMILL
SLOTCUTTER
BALLENDMILL
CHAMFERMILL
CORNERROUND
ENGRAVER

Constructor & Destructor Documentation

◆ Tool() [1/2]

Tool::Tool ( )

◆ Tool() [2/2]

Tool::Tool	(	const char *	name,
		ToolType	type = `Tool::UNDEFINED`,
		ToolMaterial	material = `Tool::MATUNDEFINED`,
		double	diameter = `10.0`,
		double	lengthoffset = `100`,
		double	flatradius = `0`,
		double	cornerradius = `0`,
		double	cuttingedgeangle = `0`,
		double	cuttingedgeheight = `0`
	)

◆ ~Tool()

Tool::~Tool ( )

Member Function Documentation

◆ getMemSize()

unsigned int Tool::getMemSize ( void ) const

virtual

This method is used to get the size of objects It is not meant to have the exact size, it is more or less an estimation which runs fast! Is it two bytes or a GB?

Implements Base::Persistence.

◆ getToolMaterial()

Tool::ToolMaterial Tool::getToolMaterial ( std::string mat )

static

Referenced by Path::ToolPy::PyInit(), and Path::ToolPy::setMaterial().

◆ getToolType()

Tool::ToolType Tool::getToolType ( std::string type )

static

Referenced by Path::ToolPy::PyInit(), and Path::ToolPy::setToolType().

◆ MaterialName()

const char * Tool::MaterialName ( Tool::ToolMaterial mat )

static

Referenced by Path::ToolPy::getMaterial(), and Path::ToolPy::templateAttrs().

◆ Restore()

void Tool::Restore ( Base::XMLReader & )

virtual

This method is used to restore properties from an XML document.

It uses the XMLReader class, which bases on SAX, to read the in Save() written information. Again the Vector as an example:

void PropertyVector::Restore(Base::XMLReader &reader)
{
  // read my Element
  reader.readElement("PropertyVector");
  // get the value of my Attribute
  _cVec.x = reader.getAttributeAsFloat("valueX");
  _cVec.y = reader.getAttributeAsFloat("valueY");
  _cVec.z = reader.getAttributeAsFloat("valueZ");
}

Implements Base::Persistence.

References Base::XMLReader::getAttribute(), Base::XMLReader::getAttributeAsFloat(), Base::XMLReader::hasAttribute(), and Base::XMLReader::readElement().

Referenced by Path::Tooltable::Restore(), Path::PropertyTool::Restore(), and Path::ToolPy::setFromTemplate().

◆ Save()

void Tool::Save ( Base::Writer & ) const

virtual

This method is used to save properties to an XML document.

A good example you'll find in PropertyStandard.cpp, e.g. the vector:

void PropertyVector::Save (Writer &writer) const
{
   writer << writer.ind() << "<PropertyVector valueX=\"" <<  _cVec.x <<
                                          "\" valueY=\"" <<  _cVec.y <<
                                          "\" valueZ=\"" <<  _cVec.z <<"\"/>" << endl;
}

The writer.ind() expression writes the indentation, just for pretty printing of the XML. As you see, the writing of the XML document is not done with a DOM implementation because of performance reasons. Therefore the programmer has to take care that a valid XML document is written. This means closing tags and writing UTF-8.