KiCad PCB EDA Suite
Loading...
Searching...
No Matches
Public Member Functions | Protected Attributes | Private Member Functions | List of all members
WRL1BASE Class Reference

Represent the top node of a VRML1 model. More...

#include <vrml1_base.h>

Inheritance diagram for WRL1BASE:
WRL1NODE

Public Member Functions

 WRL1BASE ()
 
virtual ~WRL1BASE ()
 
bool Read (WRLPROC &proc)
 
bool ReadNode (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
virtual std::string GetName (void) override
 
virtual bool SetName (const std::string &aName) override
 
bool Read (WRLPROC &proc, WRL1BASE *aTopNode) override
 
bool SetParent (WRL1NODE *aParent, bool doUnlink=true) override
 Set the parent WRL1NODE of this object.
 
SGNODE * TranslateToSG (SGNODE *aParent, WRL1STATUS *sp) override
 Produce a representation of the data using the intermediate scenegraph structures of the kicad_3dsg library.
 
void cancelDict (void)
 
WRL1NODES getNodeTypeID (const std::string &aNodeName)
 Return the ID based on the given aNodeName or WRL1_INVALID (WRL1_END) if no such node name exists.
 
virtual void unlinkChildNode (const WRL1NODE *aNode)
 Remove references to an owned child; it is invoked by the child upon destruction to ensure that the parent has no invalid references.
 
virtual void unlinkRefNode (const WRL1NODE *aNode)
 Remove pointers to a referenced node; it is invoked by the referenced node upon destruction to ensure that the referring node has no invalid references.
 
void addNodeRef (WRL1NODE *aNode)
 Add a pointer to a node which references, but does not own, this node.
 
void delNodeRef (WRL1NODE *aNode)
 Remove a pointer to a node which references, but does not own, this node.
 
WRL1NODES GetNodeType (void) const
 Return the type of this node instance.
 
WRL1NODE * GetParent (void) const
 Return a pointer to the parent SGNODE of this object or NULL if the object has no parent (ie.
 
const char * GetNodeTypeName (WRL1NODES aNodeType) const
 
size_t GetNItems (void) const
 
virtual WRL1NODE * FindNode (const std::string &aNodeName)
 Search the tree of linked nodes and returns a reference to the current node with the given name.
 
virtual bool AddChildNode (WRL1NODE *aNode)
 
virtual bool AddRefNode (WRL1NODE *aNode)
 
std::string GetError (void)
 

Protected Attributes

WRL1NODE * m_Parent
 
WRL1NODES m_Type
 
std::string m_Name
 
std::list< WRL1NODE * > m_BackPointers
 
std::list< WRL1NODE * > m_Children
 
std::list< WRL1NODE * > m_Refs
 
std::list< WRL1NODE * > m_Items
 
std::string m_error
 
WRL1STATUS m_current
 
SGNODE * m_sgNode
 
NAMEREGISTER * m_dictionary
 

Private Member Functions

bool implementUse (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool implementDef (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readGroup (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readSeparator (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readSwitch (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readMaterial (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readMatBinding (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readCoords (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readFaceSet (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readTransform (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
bool readShapeHints (WRLPROC &proc, WRL1NODE *aParent, WRL1NODE **aNode)
 
void addItem (WRL1NODE *aNode)
 
void delItem (const WRL1NODE *aNode)
 

Detailed Description

Represent the top node of a VRML1 model.

Definition at line 45 of file vrml1_base.h.

Constructor & Destructor Documentation

◆ WRL1BASE()

WRL1BASE::WRL1BASE ( )

Definition at line 42 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1NODE::m_Type, WRL1_BASE, and WRL1NODE::WRL1NODE().

Referenced by Read().

◆ ~WRL1BASE()

WRL1BASE::~WRL1BASE ( )
virtual

Definition at line 50 of file vrml1_base.cpp.

References WRL1NODE::cancelDict(), and traceVrmlPlugin.

Member Function Documentation

◆ AddChildNode()

bool WRL1NODE::AddChildNode ( WRL1NODE * aNode)
virtualinherited

Reimplemented in WRL1COORDS, WRL1FACESET, WRL1MATBINDING, WRL1MATERIAL, WRL1SHAPEHINTS, and WRL1TRANSFORM.

Definition at line 376 of file vrml1_node.cpp.

References addItem(), GetNodeType(), GetParent(), m_Children, SetParent(), WRL1_BASE, and WRL1NODE().

◆ addItem()

void WRL1NODE::addItem ( WRL1NODE * aNode)
privateinherited

Definition at line 458 of file vrml1_node.cpp.

References m_Items, and WRL1NODE().

Referenced by AddChildNode(), and AddRefNode().

◆ addNodeRef()

void WRL1NODE::addNodeRef ( WRL1NODE * aNode)
inherited

Add a pointer to a node which references, but does not own, this node.

Such back-pointers are required to ensure that invalidated references are removed when a node is deleted

Parameters
aNodeis the node holding a reference to this object.

Definition at line 216 of file vrml1_node.cpp.

References m_BackPointers, m_Parent, and WRL1NODE().

Referenced by AddRefNode().

◆ AddRefNode()

bool WRL1NODE::AddRefNode ( WRL1NODE * aNode)
virtualinherited

Reimplemented in WRL1COORDS, WRL1FACESET, WRL1MATBINDING, WRL1MATERIAL, WRL1SHAPEHINTS, and WRL1TRANSFORM.

Definition at line 403 of file vrml1_node.cpp.

References addItem(), addNodeRef(), GetNodeType(), m_Refs, WRL1_BASE, and WRL1NODE().

Referenced by WRL1BASE::implementUse().

◆ cancelDict()

void WRL1NODE::cancelDict ( void )
inherited

Definition at line 198 of file vrml1_node.cpp.

References m_Children, m_dictionary, m_Type, and WRL1_BASE.

Referenced by WRL1BASE::~WRL1BASE().

◆ delItem()

void WRL1NODE::delItem ( const WRL1NODE * aNode)
privateinherited

Definition at line 464 of file vrml1_node.cpp.

References m_Items, and WRL1NODE().

Referenced by unlinkChildNode(), and unlinkRefNode().

◆ delNodeRef()

void WRL1NODE::delNodeRef ( WRL1NODE * aNode)
inherited

Remove a pointer to a node which references, but does not own, this node.

Parameters
aNodeis the node holding a reference to this object.

Definition at line 237 of file vrml1_node.cpp.

References m_BackPointers, traceVrmlPlugin, and WRL1NODE().

◆ FindNode()

WRL1NODE * WRL1NODE::FindNode ( const std::string & aNodeName)
virtualinherited

Search the tree of linked nodes and returns a reference to the current node with the given name.

The reference is then typically added to another node via AddRefNode().

Parameters
aNodeNameis the name of the node to search for.
Returns
is a valid node pointer on success, otherwise NULL.

Definition at line 350 of file vrml1_node.cpp.

References m_dictionary, and WRL1NODE().

Referenced by WRL1BASE::implementUse().

◆ GetError()

std::string WRL1NODE::GetError ( void )
inherited

Definition at line 344 of file vrml1_node.cpp.

References m_error.

◆ GetName()

std::string WRL1BASE::GetName ( void )
overridevirtual

Reimplemented from WRL1NODE.

Definition at line 64 of file vrml1_base.cpp.

◆ GetNItems()

size_t WRL1NODE::GetNItems ( void ) const
inherited

Definition at line 338 of file vrml1_node.cpp.

References m_Items.

◆ GetNodeType()

WRL1NODES WRL1NODE::GetNodeType ( void ) const
inherited

Return the type of this node instance.

Definition at line 254 of file vrml1_node.cpp.

References m_Type.

Referenced by AddChildNode(), AddRefNode(), and WRL1BASE::implementUse().

◆ getNodeTypeID()

WRL1NODES WRL1NODE::getNodeTypeID ( const std::string & aNodeName)
inherited

Return the ID based on the given aNodeName or WRL1_INVALID (WRL1_END) if no such node name exists.

Definition at line 327 of file vrml1_node.cpp.

References nodenames, and WRL1_INVALID.

Referenced by WRL1BASE::ReadNode().

◆ GetNodeTypeName()

const char * WRL1NODE::GetNodeTypeName ( WRL1NODES aNodeType) const
inherited

Definition at line 312 of file vrml1_node.cpp.

References nodenames, WRL1_BASE, WRL1_BEGIN, and WRL1_END.

Referenced by WRL1BASE::implementUse().

◆ GetParent()

WRL1NODE * WRL1NODE::GetParent ( void ) const
inherited

Return a pointer to the parent SGNODE of this object or NULL if the object has no parent (ie.

top level transform).

Definition at line 260 of file vrml1_node.cpp.

References m_Parent, and WRL1NODE().

Referenced by AddChildNode().

◆ implementDef()

bool WRL1BASE::implementDef ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 156 of file vrml1_base.cpp.

References WRLPROC::GetError(), WRLPROC::GetFilePosition(), WRL1NODE::m_dictionary, WRLPROC::ReadName(), ReadNode(), WRL1NODE::SetName(), traceVrmlPlugin, and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ implementUse()

bool WRL1BASE::implementUse ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 111 of file vrml1_base.cpp.

References WRL1NODE::AddRefNode(), WRL1NODE::FindNode(), WRLPROC::GetError(), WRL1NODE::GetNodeType(), WRL1NODE::GetNodeTypeName(), WRLPROC::ReadName(), traceVrmlPlugin, and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ Read() [1/2]

bool WRL1BASE::Read ( WRLPROC & proc)

Definition at line 77 of file vrml1_base.cpp.

References WRLPROC::eof(), WRLPROC::GetError(), WRLPROC::GetFilePosition(), WRLPROC::GetVRMLType(), WRLPROC::Peek(), ReadNode(), traceVrmlPlugin, and VRML_V1.

Referenced by LoadVRML().

◆ Read() [2/2]

bool WRL1BASE::Read ( WRLPROC & proc,
WRL1BASE * aTopNode )
overridevirtual

Implements WRL1NODE.

Definition at line 346 of file vrml1_base.cpp.

References WRL1BASE().

◆ readCoords()

bool WRL1BASE::readCoords ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 449 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1COORDS::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readFaceSet()

bool WRL1BASE::readFaceSet ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 469 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1FACESET::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readGroup()

bool WRL1BASE::readGroup ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 352 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1GROUP::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readMatBinding()

bool WRL1BASE::readMatBinding ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 429 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1MATBINDING::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readMaterial()

bool WRL1BASE::readMaterial ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 409 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1MATERIAL::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ ReadNode()

bool WRL1BASE::ReadNode ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )

Definition at line 200 of file vrml1_base.cpp.

References WRLPROC::DiscardNode(), WRLPROC::eof(), WRLPROC::GetError(), WRLPROC::GetFilePosition(), WRL1NODE::getNodeTypeID(), implementDef(), implementUse(), readCoords(), readFaceSet(), readGroup(), readMatBinding(), readMaterial(), WRLPROC::ReadName(), readSeparator(), readShapeHints(), readSwitch(), readTransform(), traceVrmlPlugin, WRL1_COORDINATE3, WRL1_GROUP, WRL1_INDEXEDFACESET, WRL1_MATERIAL, WRL1_MATERIALBINDING, WRL1_ROTATION, WRL1_SCALE, WRL1_SEPARATOR, WRL1_SHAPEHINTS, WRL1_SWITCH, WRL1_TRANSFORM, WRL1_TRANSLATION, and WRL1NODE::WRL1NODE().

Referenced by implementDef(), Read(), WRL1GROUP::Read(), WRL1SEPARATOR::Read(), and WRL1SWITCH::Read().

◆ readSeparator()

bool WRL1BASE::readSeparator ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 372 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1SEPARATOR::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readShapeHints()

bool WRL1BASE::readShapeHints ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 509 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1SHAPEHINTS::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readSwitch()

bool WRL1BASE::readSwitch ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 392 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1SWITCH::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ readTransform()

bool WRL1BASE::readTransform ( WRLPROC & proc,
WRL1NODE * aParent,
WRL1NODE ** aNode )
private

Definition at line 489 of file vrml1_base.cpp.

References WRL1NODE::m_dictionary, WRL1TRANSFORM::Read(), and WRL1NODE::WRL1NODE().

Referenced by ReadNode().

◆ SetName()

bool WRL1BASE::SetName ( const std::string & aName)
overridevirtual

Reimplemented from WRL1NODE.

Definition at line 71 of file vrml1_base.cpp.

◆ SetParent()

bool WRL1BASE::SetParent ( WRL1NODE * aParent,
bool doUnlink = true )
overridevirtual

Set the parent WRL1NODE of this object.

Parameters
aParent[in] is the desired parent node.
doUnlinkindicates that the child must be unlinked from the parent
Returns
true if the operation succeeds; false if the given node is not allowed to be a parent to the derived object.

Reimplemented from WRL1NODE.

Definition at line 58 of file vrml1_base.cpp.

References WRL1NODE::WRL1NODE().

◆ TranslateToSG()

SGNODE * WRL1BASE::TranslateToSG ( SGNODE * aParent,
WRL1STATUS * sp )
overridevirtual

Produce a representation of the data using the intermediate scenegraph structures of the kicad_3dsg library.

Parameters
aParentis a pointer to the parent SG node.
Returns
is non-NULL on success.

Implements WRL1NODE.

Definition at line 529 of file vrml1_base.cpp.

References IFSG_NODE::Destroy(), IFSG_NODE::GetRawPtr(), WRL1NODE::m_current, WRL1NODE::m_Items, and traceVrmlPlugin.

Referenced by LoadVRML().

◆ unlinkChildNode()

void WRL1NODE::unlinkChildNode ( const WRL1NODE * aNode)
virtualinherited

Remove references to an owned child; it is invoked by the child upon destruction to ensure that the parent has no invalid references.

Parameters
aNodeis the child which is being deleted.

Definition at line 420 of file vrml1_node.cpp.

References delItem(), m_Children, and WRL1NODE().

◆ unlinkRefNode()

void WRL1NODE::unlinkRefNode ( const WRL1NODE * aNode)
virtualinherited

Remove pointers to a referenced node; it is invoked by the referenced node upon destruction to ensure that the referring node has no invalid references.

Parameters
aNodeis the node which is being deleted.

Definition at line 439 of file vrml1_node.cpp.

References delItem(), m_Refs, and WRL1NODE().

Member Data Documentation

◆ m_BackPointers

std::list< WRL1NODE* > WRL1NODE::m_BackPointers
protectedinherited

Definition at line 230 of file vrml1_node.h.

Referenced by addNodeRef(), delNodeRef(), WRL1GROUP::TranslateToSG(), WRL1SEPARATOR::TranslateToSG(), WRL1SWITCH::TranslateToSG(), WRL1FACESET::~WRL1FACESET(), WRL1GROUP::~WRL1GROUP(), ~WRL1NODE(), WRL1SEPARATOR::~WRL1SEPARATOR(), WRL1SWITCH::~WRL1SWITCH(), and WRL1TRANSFORM::~WRL1TRANSFORM().

◆ m_Children

std::list< WRL1NODE* > WRL1NODE::m_Children
protectedinherited

Definition at line 231 of file vrml1_node.h.

Referenced by AddChildNode(), cancelDict(), WRL1GROUP::TranslateToSG(), WRL1SEPARATOR::TranslateToSG(), WRL1SWITCH::TranslateToSG(), unlinkChildNode(), WRL1FACESET::~WRL1FACESET(), WRL1GROUP::~WRL1GROUP(), ~WRL1NODE(), WRL1SEPARATOR::~WRL1SEPARATOR(), WRL1SWITCH::~WRL1SWITCH(), and WRL1TRANSFORM::~WRL1TRANSFORM().

◆ m_current

WRL1STATUS WRL1NODE::m_current
protectedinherited

Definition at line 236 of file vrml1_node.h.

Referenced by WRL1BASE::TranslateToSG(), WRL1FACESET::TranslateToSG(), WRL1GROUP::TranslateToSG(), WRL1SEPARATOR::TranslateToSG(), and WRL1SWITCH::TranslateToSG().

◆ m_dictionary

NAMEREGISTER* WRL1NODE::m_dictionary
protectedinherited

Definition at line 246 of file vrml1_node.h.

Referenced by cancelDict(), FindNode(), WRL1BASE::implementDef(), WRL1BASE::readCoords(), WRL1BASE::readFaceSet(), WRL1BASE::readGroup(), WRL1BASE::readMatBinding(), WRL1BASE::readMaterial(), WRL1BASE::readSeparator(), WRL1BASE::readShapeHints(), WRL1BASE::readSwitch(), WRL1BASE::readTransform(), SetName(), WRL1BASE::WRL1BASE(), WRL1NODE(), and ~WRL1NODE().

◆ m_error

std::string WRL1NODE::m_error
protectedinherited

Definition at line 234 of file vrml1_node.h.

Referenced by GetError().

◆ m_Items

std::list< WRL1NODE* > WRL1NODE::m_Items
protectedinherited

Definition at line 233 of file vrml1_node.h.

Referenced by addItem(), delItem(), GetNItems(), WRL1BASE::TranslateToSG(), WRL1GROUP::TranslateToSG(), WRL1SEPARATOR::TranslateToSG(), WRL1SWITCH::TranslateToSG(), and ~WRL1NODE().

◆ m_Name

std::string WRL1NODE::m_Name
protectedinherited

Definition at line 228 of file vrml1_node.h.

Referenced by GetName(), SetName(), and ~WRL1NODE().

◆ m_Parent

WRL1NODE* WRL1NODE::m_Parent
protectedinherited

Definition at line 226 of file vrml1_node.h.

Referenced by addNodeRef(), GetParent(), SetParent(), WRL1FACESET::TranslateToSG(), WRL1GROUP::TranslateToSG(), WRL1SEPARATOR::TranslateToSG(), WRL1TRANSFORM::TranslateToSG(), WRL1COORDS::WRL1COORDS(), WRL1FACESET::WRL1FACESET(), WRL1GROUP::WRL1GROUP(), WRL1MATBINDING::WRL1MATBINDING(), WRL1MATERIAL::WRL1MATERIAL(), WRL1NODE(), WRL1SEPARATOR::WRL1SEPARATOR(), WRL1SHAPEHINTS::WRL1SHAPEHINTS(), WRL1SWITCH::WRL1SWITCH(), WRL1TRANSFORM::WRL1TRANSFORM(), and ~WRL1NODE().

◆ m_Refs

std::list< WRL1NODE* > WRL1NODE::m_Refs
protectedinherited

Definition at line 232 of file vrml1_node.h.

Referenced by AddRefNode(), WRL1GROUP::TranslateToSG(), WRL1SEPARATOR::TranslateToSG(), WRL1SWITCH::TranslateToSG(), unlinkRefNode(), WRL1FACESET::~WRL1FACESET(), WRL1GROUP::~WRL1GROUP(), ~WRL1NODE(), WRL1SEPARATOR::~WRL1SEPARATOR(), WRL1SWITCH::~WRL1SWITCH(), and WRL1TRANSFORM::~WRL1TRANSFORM().

◆ m_sgNode

SGNODE* WRL1NODE::m_sgNode
protectedinherited

Definition at line 237 of file vrml1_node.h.

Referenced by WRL1NODE().

◆ m_Type

WRL1NODES WRL1NODE::m_Type
protectedinherited

Definition at line 227 of file vrml1_node.h.

Referenced by cancelDict(), GetNodeType(), WRL1BASE::WRL1BASE(), WRL1COORDS::WRL1COORDS(), WRL1COORDS::WRL1COORDS(), WRL1FACESET::WRL1FACESET(), WRL1FACESET::WRL1FACESET(), WRL1GROUP::WRL1GROUP(), WRL1GROUP::WRL1GROUP(), WRL1MATBINDING::WRL1MATBINDING(), WRL1MATBINDING::WRL1MATBINDING(), WRL1MATERIAL::WRL1MATERIAL(), WRL1MATERIAL::WRL1MATERIAL(), WRL1NODE(), WRL1SEPARATOR::WRL1SEPARATOR(), WRL1SEPARATOR::WRL1SEPARATOR(), WRL1SHAPEHINTS::WRL1SHAPEHINTS(), WRL1SHAPEHINTS::WRL1SHAPEHINTS(), WRL1SWITCH::WRL1SWITCH(), WRL1SWITCH::WRL1SWITCH(), WRL1TRANSFORM::WRL1TRANSFORM(), WRL1TRANSFORM::WRL1TRANSFORM(), and ~WRL1NODE().

The documentation for this class was generated from the following files: