Main Page   Class Hierarchy   Compound List   File List   Compound Members  

dimeRecordHolder Class Reference

The dimeRecordHolder class is a superclass for objects that store records. More...

#include <dime/RecordHolder.h>

Inheritance diagram for dimeRecordHolder::

dimeBase dimeClass dimeEntity dimeObject dimeTableEntry dimeUnknownClass dimeBlock dimeExtrusionEntity dimeFaceEntity dimeInsert dimeSpline dimeUnknownEntity dimeVertex dimeUnknownObject dimeLayerTable dimeUCSTable dimeUnknownTable List of all members.

Public Methods

 dimeRecordHolder (const int separator)
virtual ~dimeRecordHolder ()
void setRecord (const int groupcode, const dimeParam &value, dimeMemHandler *const memhandler=NULL)
void setRecords (const int *const groupcodes, const dimeParam *const params, const int numrecords, dimeMemHandler *const memhandler=NULL)
void setIndexedRecord (const int groupcode, const dimeParam &value, const int index, dimeMemHandler *const memhandler=NULL)
virtual bool getRecord (const int groupcode, dimeParam &param, const int index=0) const
virtual bool read (dimeInput *const in)
virtual bool write (dimeOutput *const out)
virtual bool isOfType (const int thetypeid) const
virtual int countRecords () const
dimeRecordfindRecord (const int groupcode, const int index=0)
int getNumRecordsInRecordHolder (void) const
dimeRecordgetRecordInRecordHolder (const int idx) const

Protected Methods

virtual bool handleRecord (const int groupcode, const dimeParam &param, dimeMemHandler *const memhandler)
bool copyRecords (dimeRecordHolder *const rh, dimeMemHandler *const memhandler) const
virtual bool shouldWriteRecord (const int groupcode) const

Protected Attributes

dimeRecord ** records
int numRecords

Detailed Description

The dimeRecordHolder class is a superclass for objects that store records.

This class makes it very easy to add new classes to dime, as it handles all of the reading, error checking and storing of records of no use to the subclass. Subclasses will only need to implement the dimeRecordHolder::handleRecord() and dimeRecordHolder::getRecord() methods.


Constructor & Destructor Documentation

dimeRecordHolder::dimeRecordHolder const int    sep
 

Constructor. separator is the group code that will separate objects, to enable the record holder to stop reading the object at the correct time. For instance, entities are separated by group code 0 (a group code 0 signals a new entity is about to start).

dimeRecordHolder::~dimeRecordHolder   [virtual]
 

Destructor.


Member Function Documentation

bool dimeRecordHolder::copyRecords dimeRecordHolder *const    rh,
dimeMemHandler *const    memh
const [protected]
 

Copies the stored records into rh.

int dimeRecordHolder::countRecords   const [virtual]
 

Returns the number of records in the record holder. Should be overloaded by subclasses which should count their records, and then call the parent's method. This method is used to precalculate the number of records to be written. Very useful when progress information is needed during write().

Reimplemented in dimeClass, dimeUnknownClass, dime3DFace, dimeArc, dimeBlock, dimeCircle, dimeEllipse, dimeEntity, dimeExtrusionEntity, dimeFaceEntity, dimeInsert, dimeLine, dimeLWPolyline, dimePoint, dimePolyline, dimeSolid, dimeSpline, dimeTrace, dimeUnknownEntity, dimeVertex, dimeObject, dimeUnknownObject, dimeLayerTable, dimeTableEntry, dimeUCSTable, and dimeUnknownTable.

dimeRecord * dimeRecordHolder::findRecord const int    groupcode,
const int    index = 0
 

Returns the record with group code groupcode. If index > 0, the index'th record with group code groupcode will be returned. Returns NULL if the record is not found or index is out of bounds.

int dimeRecordHolder::getNumRecordsInRecordHolder void    const
 

Returns the number of records stored in this record holder.

bool dimeRecordHolder::getRecord const int    groupcode,
dimeParam   param,
const int    index = 0
const [virtual]
 

Will return the value of the record with group code groupcode. false is returned if the record could not be found. Subclasses should overload this method if one or several records are stored in the class. If the groupcode queried is not stored internally, the subclass should call its parent's method.

Reimplemented in dime3DFace, dimeArc, dimeBlock, dimeCircle, dimeEllipse, dimeEntity, dimeExtrusionEntity, dimeFaceEntity, dimeInsert, dimeLine, dimeLWPolyline, dimePoint, dimePolyline, dimeSolid, dimeSpline, dimeTrace, and dimeVertex.

dimeRecord * dimeRecordHolder::getRecordInRecordHolder const int    idx const
 

Returns the idx'th record in the record holder.

See also:
getNumRecordsInRecordHolder().

bool dimeRecordHolder::handleRecord const int    groupcode,
const dimeParam   param,
dimeMemHandler *const    memhandler
[protected, virtual]
 

Must be overloaded by entities that directly supports a record type. During dimeRecordHolder::read(), dimeRecordHolder::setRecord and dimeRecordHolder::setRecords, this function is called for every record found, and it is up to the subclass if the record should be stored internally, or if a generic record should be created and stored in this superclass. A subclass should return \true when it will handle the record, false otherwise. Default function does nothing, and returns false.

For entities, records with group codes 8 (layer name) and 62 (color number) are automatically handled by the dimeEntity class.

See also:
dimeRecordHolder::read() , dimeRecordHolder::setRecord()

Reimplemented in dimeClass, dime3DFace, dimeArc, dimeBlock, dimeCircle, dimeEllipse, dimeEntity, dimeExtrusionEntity, dimeFaceEntity, dimeInsert, dimeLine, dimeLWPolyline, dimePoint, dimePolyline, dimeSolid, dimeSpline, dimeTrace, dimeVertex, dimeObject, dimeLayerTable, dimeTableEntry, and dimeUCSTable.

bool dimeRecordHolder::isOfType const int    thetypeid const [virtual]
 

Returns true if the object is of type typeid or is inherited from it. Function in base class checks whether thetypeid equals the virtual dimeBase::typeId() value or equals dimeBaseType. Must be implemented by all subclasses that are superclasses of other classes, and should check if thetypeid equals its typeId, and then call its parent's isOfType function. Leaf-classes do not have to implement this method.

Reimplemented from dimeBase.

Reimplemented in dimeClass, dimeEntity, dimeExtrusionEntity, dimeFaceEntity, dimeObject, and dimeTableEntry.

bool dimeRecordHolder::read dimeInput *const    file [virtual]
 

Reads records from in until the separator groupcode (specified in constructor) is found. Can be overloaded by subclasses, but in most cases this will not be necessary as dimeRecordHolder::handleRecord() is called for each record found in the stream.

See also:
dimeEntity::handleRecord().

Reimplemented in dimeClass, dimeBlock, dimeEntity, dimeInsert, dimePolyline, dimeObject, dimeLayerTable, and dimeTableEntry.

void dimeRecordHolder::setIndexedRecord const int    groupcode,
const dimeParam   value,
const int    index,
dimeMemHandler *const    memhandler = NULL
 

Basically the same function as setRecord(), but also allows you to specify an index for the record. This is useful if you're going to set several records with the same group code.

See also:
dimeRecordHolder::setRecord()

void dimeRecordHolder::setRecord const int    groupcode,
const dimeParam   value,
dimeMemHandler *const    memhandler = NULL
 

Sets the data for the record with group code groupcode. If the record already exists, it's value will simply be overwritten, otherwise a new record will be created. If the record is handled by a subclass, param will be passed on to the subclass (using dimeRecordHolder::handleRecord()), and will be ignored by dimeRecordHolder.

For entities, you cannot use this method to set the layer name. Use dimeEntity::setLayer() to do that. Also, you should not use this function to set the block name for a dimeInsert entity; use dimeInsert::setBlock() instead.

See also:
dimeRecordHolder::handleRecord() , dimeRecordHolder::getRecord() , dimeRecordHolder::setRecords()

void dimeRecordHolder::setRecords const int *const    groupcodes,
const dimeParam *const    params,
const int    numrecords,
dimeMemHandler *const    memhandler = NULL
 

Sets an array of entities. It is much more efficient to use this than using dimeRecordHolder::setRecord() several times if you are going to set the value of more than one record. Otherwise behaves exactly as dimeRecordHolder::setRecord().

bool dimeRecordHolder::shouldWriteRecord const int    groupcode const [protected, virtual]
 

Can be overloaded by subclasses that want the record holder to store a record, but handles writing themselves. Default method returns true for all group codes.

Reimplemented in dimeEntity.

bool dimeRecordHolder::write dimeOutput *const    file [virtual]
 

Will write the records to file.

Reimplemented in dimeClass, dimeUnknownClass, dime3DFace, dimeArc, dimeBlock, dimeCircle, dimeEllipse, dimeEntity, dimeInsert, dimeLine, dimeLWPolyline, dimePoint, dimePolyline, dimeSolid, dimeSpline, dimeTrace, dimeUnknownEntity, dimeVertex, dimeObject, dimeUnknownObject, dimeLayerTable, dimeTableEntry, dimeUCSTable, and dimeUnknownTable.


The documentation for this class was generated from the following files:
Copyright © 1998-1999, Systems In Motion <sales@sim.no>. All rights reserved.
System documentation was generated using doxygen.