KiCad PCB EDA Suite
|
Define the basic data set required to represent a 3D model. More...
#include <scenegraph.h>
Public Member Functions | |
void | unlinkChildNode (const SGNODE *aNode) override |
Remove references to an owned child. | |
void | unlinkRefNode (const SGNODE *aNode) override |
Remove pointers to a referenced node. | |
SCENEGRAPH (SGNODE *aParent) | |
virtual | ~SCENEGRAPH () |
virtual bool | SetParent (SGNODE *aParent, bool notify=true) override |
Set the parent SGNODE of this object. | |
SGNODE * | FindNode (const char *aNodeName, const SGNODE *aCaller) override |
Search the tree of linked nodes and return a reference to the first node found with the given name. | |
bool | AddRefNode (SGNODE *aNode) override |
bool | AddChildNode (SGNODE *aNode) override |
void | ReNameNodes (void) override |
Rename a node and all its child nodes in preparation for write operations. | |
bool | WriteVRML (std::ostream &aFile, bool aReuseFlag) override |
Writes this node's data to a VRML file. | |
bool | WriteCache (std::ostream &aFile, SGNODE *parentNode) override |
Write this node's data to a binary cache file. | |
bool | ReadCache (std::istream &aFile, SGNODE *parentNode) override |
Reads binary format data from a cache file. | |
bool | Prepare (const glm::dmat4 *aTransform, S3D::MATLIST &materials, std::vector< SMESH > &meshes) |
S3D::SGTYPES | GetNodeType (void) const noexcept |
Return the type of this node instance. | |
SGNODE * | GetParent (void) const noexcept |
Returns a pointer to the parent SGNODE of this object or NULL if the object has no parent (ie. | |
bool | SwapParent (SGNODE *aNewParent) |
Swap the ownership with the given parent. | |
const char * | GetName (void) |
void | SetName (const char *aName) |
const char * | GetNodeTypeName (S3D::SGTYPES aNodeType) const noexcept |
void | AssociateWrapper (SGNODE **aWrapperRef) noexcept |
Associate this object with a handle to itself. | |
void | DisassociateWrapper (SGNODE **aWrapperRef) noexcept |
Remove the association between an IFSG* wrapper object and this object. | |
void | ResetNodeIndex (void) noexcept |
Reset the global SG* node indices in preparation for write operations. | |
void | addNodeRef (SGNODE *aNode) |
Add a pointer to a node which references this node, but does not own. | |
void | delNodeRef (const SGNODE *aNode) |
Remove a pointer to a node which references this node, but does not own. | |
bool | isWritten (void) noexcept |
Return true if the object had already been written to a cache file or VRML file. | |
Public Attributes | |
SGPOINT | center |
SGPOINT | translation |
SGVECTOR | rotation_axis |
double | rotation_angle |
SGPOINT | scale |
SGVECTOR | scale_axis |
double | scale_angle |
Protected Attributes | |
std::list< SGNODE * > | m_BackPointers |
nodes which hold a reference to this. | |
SGNODE * | m_Parent |
Pointer to parent node; may be NULL for top level transform. | |
S3D::SGTYPES | m_SGtype |
Type of Scene Graph node. | |
std::string | m_Name |
name to use for referencing the entity by name. | |
bool | m_written |
Set to true when the object has been written after a ReNameNodes(). | |
Private Member Functions | |
void | unlinkNode (const SGNODE *aNode, bool isChild) |
bool | addNode (SGNODE *aNode, bool isChild) |
Private Attributes | |
std::vector< SCENEGRAPH * > | m_Transforms |
std::vector< SGSHAPE * > | m_Shape |
std::vector< SCENEGRAPH * > | m_RTransforms |
std::vector< SGSHAPE * > | m_RShape |
SGNODE ** | m_Association |
Handle to the instance held by a wrapper. | |
Define the basic data set required to represent a 3D model.
This model must remain compatible with VRML2.0 in order to facilitate VRML export of scene graph data created by available 3D plugins.
Definition at line 44 of file scenegraph.h.
SCENEGRAPH::SCENEGRAPH | ( | SGNODE * | aParent | ) |
Definition at line 38 of file scenegraph.cpp.
References SGNODE::AddChildNode(), SGNODE::GetNodeType(), SGNODE::m_Parent, SGNODE::m_SGtype, rotation_angle, scale, scale_angle, S3D::SGTYPE_TRANSFORM, SGPOINT::x, SGPOINT::y, and SGPOINT::z.
|
virtual |
Definition at line 64 of file scenegraph.cpp.
References DEL_OBJS, DROP_REFS, m_RShape, m_RTransforms, m_Shape, and m_Transforms.
|
overridevirtual |
|
private |
Definition at line 164 of file scenegraph.cpp.
References ADD_NODE, SGNODE::GetName(), SGNODE::GetNodeType(), m_RShape, m_RTransforms, m_Shape, m_Transforms, S3D::SGTYPE_SHAPE, and S3D::SGTYPE_TRANSFORM.
Referenced by AddChildNode(), and AddRefNode().
|
inherited |
Add a pointer to a node which references this node, but does not own.
Such back-pointers are required to ensure that invalidated references are removed when a node is deleted.
aNode | is the node holding a reference to this object. |
Definition at line 170 of file sg_node.cpp.
References SGNODE::m_BackPointers.
Referenced by SGFACESET::addNode(), SGSHAPE::addNode(), SGFACESET::ReadCache(), and SGSHAPE::ReadCache().
|
overridevirtual |
Implements SGNODE.
Definition at line 181 of file scenegraph.cpp.
References addNode().
Referenced by ReadCache().
|
noexceptinherited |
Associate this object with a handle to itself.
The handle is typically held by an IFSG* wrapper and the pointer which it refers to is set to NULL upon destruction of this object. This mechanism provides a scheme by which a wrapper can be notified of the destruction of the object which it wraps.
Definition at line 207 of file sg_node.cpp.
Referenced by S3D::AssociateSGNodeWrapper(), IFSG_APPEARANCE::Attach(), IFSG_COLORS::Attach(), IFSG_COORDINDEX::Attach(), IFSG_COORDS::Attach(), IFSG_FACESET::Attach(), IFSG_NORMALS::Attach(), IFSG_SHAPE::Attach(), IFSG_TRANSFORM::Attach(), IFSG_APPEARANCE::IFSG_APPEARANCE(), IFSG_COLORS::IFSG_COLORS(), IFSG_COORDINDEX::IFSG_COORDINDEX(), IFSG_COORDS::IFSG_COORDS(), IFSG_FACESET::IFSG_FACESET(), IFSG_NORMALS::IFSG_NORMALS(), IFSG_SHAPE::IFSG_SHAPE(), IFSG_TRANSFORM::IFSG_TRANSFORM(), IFSG_APPEARANCE::NewNode(), IFSG_COLORS::NewNode(), IFSG_COORDINDEX::NewNode(), IFSG_COORDS::NewNode(), IFSG_FACESET::NewNode(), IFSG_NORMALS::NewNode(), IFSG_SHAPE::NewNode(), and IFSG_TRANSFORM::NewNode().
|
inherited |
Remove a pointer to a node which references this node, but does not own.
aNode | is the node holding a reference to this object. |
Definition at line 185 of file sg_node.cpp.
References SGNODE::GetNodeType(), SGNODE::m_BackPointers, and SGNODE::m_SGtype.
Referenced by SGFACESET::unlinkNode(), SGSHAPE::unlinkNode(), SGFACESET::~SGFACESET(), and SGSHAPE::~SGSHAPE().
|
noexceptinherited |
Remove the association between an IFSG* wrapper object and this object.
Definition at line 225 of file sg_node.cpp.
Referenced by IFSG_APPEARANCE::Attach(), IFSG_COLORS::Attach(), IFSG_COORDINDEX::Attach(), IFSG_COORDS::Attach(), IFSG_FACESET::Attach(), IFSG_NORMALS::Attach(), IFSG_SHAPE::Attach(), IFSG_TRANSFORM::Attach(), IFSG_NODE::Destroy(), IFSG_APPEARANCE::NewNode(), IFSG_COLORS::NewNode(), IFSG_COORDINDEX::NewNode(), IFSG_COORDS::NewNode(), IFSG_FACESET::NewNode(), IFSG_NORMALS::NewNode(), IFSG_SHAPE::NewNode(), IFSG_TRANSFORM::NewNode(), and IFSG_NODE::~IFSG_NODE().
Search the tree of linked nodes and return a reference to the first node found with the given name.
The reference is then typically added to another node via AddRefNode().
aNodeName | is the name of the node to search for. |
aCaller | is a pointer to the node invoking this function. |
Implements SGNODE.
Definition at line 106 of file scenegraph.cpp.
References FIND_NODE, SGNODE::FindNode(), SGNODE::m_Name, SGNODE::m_Parent, m_Shape, and m_Transforms.
Referenced by ReadCache().
|
inherited |
Definition at line 146 of file sg_node.cpp.
References getNodeName(), SGNODE::m_Name, and SGNODE::m_SGtype.
Referenced by addNode(), SGFACESET::addNode(), SGSHAPE::addNode(), IFSG_NODE::GetName(), ReNameNodes(), SGAPPEARANCE::ReNameNodes(), SGCOLORS::ReNameNodes(), SGCOORDS::ReNameNodes(), SGFACESET::ReNameNodes(), SGINDEX::ReNameNodes(), SGNORMALS::ReNameNodes(), SGSHAPE::ReNameNodes(), WriteCache(), SGAPPEARANCE::WriteCache(), SGCOLORS::WriteCache(), SGCOORDS::WriteCache(), SGFACESET::WriteCache(), SGINDEX::WriteCache(), SGNORMALS::WriteCache(), SGSHAPE::WriteCache(), WriteVRML(), SGAPPEARANCE::WriteVRML(), SGCOLORS::WriteVRML(), SGCOORDS::WriteVRML(), SGFACESET::WriteVRML(), SGNORMALS::WriteVRML(), and SGSHAPE::WriteVRML().
|
noexceptinherited |
Return the type of this node instance.
Definition at line 104 of file sg_node.cpp.
Referenced by addNode(), SGFACESET::addNode(), SGSHAPE::addNode(), IFSG_APPEARANCE::Attach(), IFSG_COLORS::Attach(), IFSG_COORDINDEX::Attach(), IFSG_COORDS::Attach(), IFSG_FACESET::Attach(), IFSG_NORMALS::Attach(), IFSG_SHAPE::Attach(), IFSG_TRANSFORM::Attach(), SGNODE::delNodeRef(), S3D::GetMatIndex(), S3D::GetModel(), IFSG_NODE::GetNodeType(), S3D::GetSGNodeType(), IFSG_APPEARANCE::NewNode(), IFSG_COLORS::NewNode(), IFSG_COORDINDEX::NewNode(), IFSG_COORDS::NewNode(), IFSG_FACESET::NewNode(), IFSG_NORMALS::NewNode(), IFSG_SHAPE::NewNode(), IFSG_TRANSFORM::NewNode(), ReadCache(), SGFACESET::ReadCache(), SGSHAPE::ReadCache(), SCENEGRAPH(), SetParent(), SGAPPEARANCE::SetParent(), SGCOLORS::SetParent(), SGCOORDS::SetParent(), SGFACESET::SetParent(), SGINDEX::SetParent(), SGNORMALS::SetParent(), SGSHAPE::SetParent(), SGAPPEARANCE::SGAPPEARANCE(), SGCOLORS::SGCOLORS(), SGCOORDINDEX::SGCOORDINDEX(), SGCOORDS::SGCOORDS(), SGFACESET::SGFACESET(), SGINDEX::SGINDEX(), SGNORMALS::SGNORMALS(), SGSHAPE::SGSHAPE(), SGNODE::SwapParent(), unlinkNode(), and S3D::WriteVRML().
|
noexceptinherited |
Definition at line 164 of file sg_node.cpp.
References node_names.
Referenced by IFSG_NODE::GetNodeTypeName(), IFSG_APPEARANCE::NewNode(), IFSG_COLORS::NewNode(), IFSG_COORDINDEX::NewNode(), IFSG_COORDS::NewNode(), IFSG_FACESET::NewNode(), IFSG_NORMALS::NewNode(), IFSG_SHAPE::NewNode(), and IFSG_TRANSFORM::NewNode().
|
noexceptinherited |
Returns a pointer to the parent SGNODE of this object or NULL if the object has no parent (ie.
top level transform).
Definition at line 110 of file sg_node.cpp.
Referenced by IFSG_NODE::GetParent(), S3D::GetSGNodeParent(), IFSG_APPEARANCE::NewNode(), IFSG_COLORS::NewNode(), IFSG_COORDINDEX::NewNode(), IFSG_COORDS::NewNode(), IFSG_FACESET::NewNode(), IFSG_NORMALS::NewNode(), IFSG_SHAPE::NewNode(), IFSG_TRANSFORM::NewNode(), WriteCache(), SGAPPEARANCE::WriteCache(), SGCOLORS::WriteCache(), SGCOORDS::WriteCache(), SGFACESET::WriteCache(), SGINDEX::WriteCache(), SGNORMALS::WriteCache(), and SGSHAPE::WriteCache().
|
inlinenoexceptinherited |
Return true if the object had already been written to a cache file or VRML file.
For internal use only.
Definition at line 220 of file sg_node.h.
References SGNODE::m_written.
Referenced by WriteCache(), SGFACESET::WriteCache(), and SGSHAPE::WriteCache().
bool SCENEGRAPH::Prepare | ( | const glm::dmat4 * | aTransform, |
S3D::MATLIST & | materials, | ||
std::vector< SMESH > & | meshes | ||
) |
Definition at line 647 of file scenegraph.cpp.
References center, SGVECTOR::GetVector(), m_RShape, m_RTransforms, m_Shape, m_Transforms, rotation_angle, rotation_axis, scale, scale_angle, scale_axis, translation, SGPOINT::x, SGPOINT::y, and SGPOINT::z.
Referenced by S3D::GetModel().
|
overridevirtual |
Reads binary format data from a cache file.
To read a cache file, open the file for reading and invoke this function from a new SCENEGRAPH node.
Implements SGNODE.
Definition at line 466 of file scenegraph.cpp.
References AddRefNode(), center, FindNode(), SGNODE::GetNodeType(), SGNODE::m_Name, m_RShape, m_RTransforms, m_Shape, m_Transforms, name, ReadCache(), SGSHAPE::ReadCache(), S3D::ReadPoint(), S3D::ReadTag(), S3D::ReadVector(), rotation_angle, rotation_axis, scale, scale_angle, scale_axis, SGNODE::SetName(), S3D::SGTYPE_SHAPE, S3D::SGTYPE_TRANSFORM, and translation.
Referenced by ReadCache().
|
overridevirtual |
Rename a node and all its child nodes in preparation for write operations.
Implements SGNODE.
Definition at line 193 of file scenegraph.cpp.
References SGNODE::GetName(), SGNODE::m_Name, m_Shape, m_Transforms, and SGNODE::m_written.
Referenced by WriteCache().
|
noexceptinherited |
Reset the global SG* node indices in preparation for write operations.
Definition at line 238 of file sg_node.cpp.
References node_counts, and S3D::SGTYPE_END.
Referenced by S3D::ResetNodeIndex(), WriteCache(), and S3D::WriteVRML().
|
inherited |
Definition at line 155 of file sg_node.cpp.
References getNodeName(), SGNODE::m_Name, and SGNODE::m_SGtype.
Referenced by ReadCache(), SGFACESET::ReadCache(), SGSHAPE::ReadCache(), and IFSG_NODE::SetName().
|
overridevirtual |
Set the parent SGNODE of this object.
aParent | [in] is the desired parent node |
Implements SGNODE.
Definition at line 76 of file scenegraph.cpp.
References SGNODE::AddChildNode(), SGNODE::GetNodeType(), SGNODE::m_Parent, S3D::SGTYPE_TRANSFORM, and SGNODE::unlinkChildNode().
|
inherited |
Swap the ownership with the given parent.
This operation may be required when reordering nodes for optimization.
aNewParent | will become the new parent to the object; it must be the same type as the parent of this instance. |
Definition at line 116 of file sg_node.cpp.
References SGNODE::AddChildNode(), SGNODE::AddRefNode(), SGNODE::GetNodeType(), SGNODE::m_Parent, SGNODE::unlinkChildNode(), and SGNODE::unlinkRefNode().
Referenced by SGFACESET::WriteCache(), and SGSHAPE::WriteCache().
|
overridevirtual |
Remove references to an owned child.
This is invoked by the child upon destruction to ensure that the parent has no invalid references.
aNode | is the child which is being deleted. |
Implements SGNODE.
Definition at line 150 of file scenegraph.cpp.
References unlinkNode().
|
private |
Definition at line 125 of file scenegraph.cpp.
References SGNODE::GetNodeType(), m_RShape, m_RTransforms, m_Shape, m_Transforms, S3D::SGTYPE_SHAPE, S3D::SGTYPE_TRANSFORM, and UNLINK_NODE.
Referenced by unlinkChildNode(), and unlinkRefNode().
|
overridevirtual |
Remove pointers to a referenced node.
This is invoked by the referenced node upon destruction to ensure that the referring node has no invalid references.
aNode | is the node which is being deleted. |
Implements SGNODE.
Definition at line 157 of file scenegraph.cpp.
References unlinkNode().
|
overridevirtual |
Write this node's data to a binary cache file.
The data includes all data of children and references to children. If this function is invoked by the user, parentNode must be set to NULL in order to ensure coherent data.
Implements SGNODE.
Definition at line 337 of file scenegraph.cpp.
References center, SGNODE::GetName(), SGNODE::GetParent(), SGNODE::isWritten(), SGNODE::m_Parent, m_RShape, m_RTransforms, m_Shape, m_Transforms, SGNODE::m_written, ReNameNodes(), SGNODE::ResetNodeIndex(), rotation_angle, rotation_axis, scale, scale_angle, scale_axis, translation, WriteCache(), SGNODE::WriteCache(), S3D::WritePoint(), and S3D::WriteVector().
Referenced by WriteCache().
|
overridevirtual |
Writes this node's data to a VRML file.
This includes all data of child and referenced nodes.
Implements SGNODE.
Definition at line 231 of file scenegraph.cpp.
References center, S3D::FormatOrientation(), S3D::FormatPoint(), SGNODE::GetName(), m_RShape, m_RTransforms, m_Shape, m_Transforms, SGNODE::m_written, rotation_angle, rotation_axis, scale, scale_angle, scale_axis, translation, SGPOINT::x, SGPOINT::y, and SGPOINT::z.
SGPOINT SCENEGRAPH::center |
Definition at line 73 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), WriteCache(), and WriteVRML().
|
privateinherited |
Handle to the instance held by a wrapper.
Definition at line 233 of file sg_node.h.
Referenced by SGNODE::SGNODE(), and SGNODE::~SGNODE().
|
protectedinherited |
nodes which hold a reference to this.
Definition at line 226 of file sg_node.h.
Referenced by SGNODE::addNodeRef(), SGCOORDS::CalcNormals(), SGNODE::delNodeRef(), and SGNODE::~SGNODE().
|
protectedinherited |
name to use for referencing the entity by name.
Definition at line 229 of file sg_node.h.
Referenced by FindNode(), SGFACESET::FindNode(), SGSHAPE::FindNode(), SGNODE::GetName(), ReadCache(), ReNameNodes(), SGAPPEARANCE::ReNameNodes(), SGCOLORS::ReNameNodes(), SGCOORDS::ReNameNodes(), SGFACESET::ReNameNodes(), SGINDEX::ReNameNodes(), SGNORMALS::ReNameNodes(), SGSHAPE::ReNameNodes(), and SGNODE::SetName().
|
protectedinherited |
Pointer to parent node; may be NULL for top level transform.
Definition at line 227 of file sg_node.h.
Referenced by SGCOORDS::CalcNormals(), FindNode(), SGFACESET::FindNode(), SGSHAPE::FindNode(), SCENEGRAPH(), SetParent(), SGAPPEARANCE::SetParent(), SGCOLORS::SetParent(), SGCOORDS::SetParent(), SGFACESET::SetParent(), SGINDEX::SetParent(), SGNORMALS::SetParent(), SGSHAPE::SetParent(), SGAPPEARANCE::SGAPPEARANCE(), SGCOLORS::SGCOLORS(), SGCOORDINDEX::SGCOORDINDEX(), SGCOORDS::SGCOORDS(), SGFACESET::SGFACESET(), SGINDEX::SGINDEX(), SGNODE::SGNODE(), SGNORMALS::SGNORMALS(), SGSHAPE::SGSHAPE(), SGNODE::SwapParent(), WriteCache(), SGAPPEARANCE::WriteCache(), SGCOLORS::WriteCache(), SGCOORDS::WriteCache(), SGFACESET::WriteCache(), SGINDEX::WriteCache(), SGNORMALS::WriteCache(), SGSHAPE::WriteCache(), and SGNODE::~SGNODE().
|
private |
Definition at line 92 of file scenegraph.h.
Referenced by addNode(), Prepare(), ReadCache(), unlinkNode(), WriteCache(), WriteVRML(), and ~SCENEGRAPH().
|
private |
Definition at line 91 of file scenegraph.h.
Referenced by addNode(), Prepare(), ReadCache(), unlinkNode(), WriteCache(), WriteVRML(), and ~SCENEGRAPH().
|
protectedinherited |
Type of Scene Graph node.
Definition at line 228 of file sg_node.h.
Referenced by SGNODE::delNodeRef(), SGNODE::GetName(), SCENEGRAPH(), SGNODE::SetName(), SGAPPEARANCE::SGAPPEARANCE(), SGCOLORS::SGCOLORS(), SGCOORDINDEX::SGCOORDINDEX(), SGCOORDS::SGCOORDS(), SGFACESET::SGFACESET(), SGNODE::SGNODE(), SGNORMALS::SGNORMALS(), SGSHAPE::SGSHAPE(), and SGINDEX::WriteVRML().
|
private |
Definition at line 89 of file scenegraph.h.
Referenced by addNode(), FindNode(), Prepare(), ReadCache(), ReNameNodes(), unlinkNode(), WriteCache(), WriteVRML(), and ~SCENEGRAPH().
|
private |
Definition at line 88 of file scenegraph.h.
Referenced by addNode(), FindNode(), Prepare(), ReadCache(), ReNameNodes(), unlinkNode(), WriteCache(), WriteVRML(), and ~SCENEGRAPH().
|
protectedinherited |
Set to true when the object has been written after a ReNameNodes().
Definition at line 230 of file sg_node.h.
Referenced by SGNODE::isWritten(), ReNameNodes(), SGAPPEARANCE::ReNameNodes(), SGCOLORS::ReNameNodes(), SGCOORDS::ReNameNodes(), SGFACESET::ReNameNodes(), SGINDEX::ReNameNodes(), SGNORMALS::ReNameNodes(), SGSHAPE::ReNameNodes(), SGNODE::SGNODE(), WriteCache(), SGAPPEARANCE::WriteCache(), SGCOLORS::WriteCache(), SGCOORDS::WriteCache(), SGFACESET::WriteCache(), SGINDEX::WriteCache(), SGNORMALS::WriteCache(), SGSHAPE::WriteCache(), WriteVRML(), SGAPPEARANCE::WriteVRML(), SGCOLORS::WriteVRML(), SGCOORDS::WriteVRML(), SGFACESET::WriteVRML(), SGNORMALS::WriteVRML(), and SGSHAPE::WriteVRML().
double SCENEGRAPH::rotation_angle |
Definition at line 76 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), SCENEGRAPH(), WriteCache(), and WriteVRML().
SGVECTOR SCENEGRAPH::rotation_axis |
Definition at line 75 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), WriteCache(), and WriteVRML().
SGPOINT SCENEGRAPH::scale |
Definition at line 77 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), SCENEGRAPH(), WriteCache(), and WriteVRML().
double SCENEGRAPH::scale_angle |
Definition at line 79 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), SCENEGRAPH(), WriteCache(), and WriteVRML().
SGVECTOR SCENEGRAPH::scale_axis |
Definition at line 78 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), WriteCache(), and WriteVRML().
SGPOINT SCENEGRAPH::translation |
Definition at line 74 of file scenegraph.h.
Referenced by Prepare(), ReadCache(), WriteCache(), and WriteVRML().