#include <vrml2_faceset.h>

Inheritance diagram for WRL2FACESET:

Public Member Functions
	WRL2FACESET ()

	WRL2FACESET (WRL2NODE *aParent)

virtual	~WRL2FACESET ()

bool	Read (WRLPROC &proc, WRL2BASE *aTopNode) override

bool	AddRefNode (WRL2NODE *aNode) override

bool	AddChildNode (WRL2NODE *aNode) override

SGNODE *	TranslateToSG (SGNODE *aParent) override
	Produce a representation of the data using the intermediate scenegraph structures of the kicad_3dsg library. More...

bool	HasColors (void)

bool	isDangling (void) override
	Determine whether an object should be moved to a different parent during the VRML to SG* translation. More...

void	unlinkChildNode (const WRL2NODE *aNode) override
	Remove references to an owned child. More...

void	unlinkRefNode (const WRL2NODE *aNode) override
	Remove pointers to a referenced node. More...

WRL2NODES	GetNodeType (void) const

WRL2NODE *	GetParent (void) const

virtual bool	SetParent (WRL2NODE *aParent, bool doUnlink=true)
	Set the parent WRL2NODE of this object. More...

virtual std::string	GetName (void)

virtual bool	SetName (const std::string &aName)

const char *	GetNodeTypeName (WRL2NODES aNodeType) const

virtual WRL2NODE *	FindNode (const std::string &aNodeName, const WRL2NODE *aCaller)
	Search the tree of linked nodes and returns a reference to the first node found with the given name. More...

std::string	GetError (void)

WRL2NODES	getNodeTypeID (const std::string &aNodeName)

void	addNodeRef (WRL2NODE *aNode)
	Add a pointer to a node which references but does not own this node. More...

void	delNodeRef (WRL2NODE *aNode)
	Remove a pointer to a node which references but does not own this node. More...

Protected Attributes
WRL2NODE *	m_Parent

WRL2NODES	m_Type

std::string	m_Name

std::list< WRL2NODE * >	m_BackPointers

std::list< WRL2NODE * >	m_Children

std::list< WRL2NODE * >	m_Refs

std::string	m_error

SGNODE *	m_sgNode

Private Member Functions
bool	checkNodeType (WRL2NODES aType)

void	setDefaults (void)

Private Attributes
WRL2NODE *	color

WRL2NODE *	coord

WRL2NODE *	normal

WRL2NODE *	texCoord

bool	ccw

bool	colorPerVertex

bool	convex

bool	normalPerVertex

bool	solid

std::vector< int >	colorIndex

std::vector< int >	coordIndex

std::vector< int >	normalIndex

float	creaseAngle

float	creaseLimit

Detailed Description

Definition at line 40 of file vrml2_faceset.h.

Constructor & Destructor Documentation

◆ WRL2FACESET() [1/2]

WRL2FACESET::WRL2FACESET ( )

Definition at line 38 of file vrml2_faceset.cpp.

 : WRL2NODE()
{
 setDefaults();
 m_Type = WRL2NODES::WRL2_INDEXEDFACESET;
}

References WRL2NODE::m_Type, setDefaults(), and WRL2_INDEXEDFACESET.

◆ WRL2FACESET() [2/2]

WRL2FACESET::WRL2FACESET ( WRL2NODE * aParent )

Definition at line 45 of file vrml2_faceset.cpp.

 : WRL2NODE()
{
 setDefaults();
 m_Type = WRL2NODES::WRL2_INDEXEDFACESET;
 m_Parent = aParent;
 
 if( nullptr != m_Parent )
 m_Parent->AddChildNode( this );
}

References WRL2NODE::AddChildNode(), WRL2NODE::m_Parent, WRL2NODE::m_Type, setDefaults(), and WRL2_INDEXEDFACESET.

◆ ~WRL2FACESET()

WRL2FACESET::~WRL2FACESET ( )

virtual

Definition at line 56 of file vrml2_faceset.cpp.

{
 wxLogTrace( traceVrmlPlugin,
 wxT( " * [INFO] Destroying IndexedFaceSet node with %zu children, %zu"
 "references, and %zu back pointers." ),
 m_Children.size(), m_Refs.size(), m_BackPointers.size() );
}

References WRL2NODE::m_BackPointers, WRL2NODE::m_Children, WRL2NODE::m_Refs, and traceVrmlPlugin.

Member Function Documentation

◆ AddChildNode()

bool WRL2FACESET::AddChildNode ( WRL2NODE * aNode )

overridevirtual

Reimplemented from WRL2NODE.

Definition at line 201 of file vrml2_faceset.cpp.

{
 wxCHECK_MSG( aNode, false, wxT( "Invalid node." ) );
 
 WRL2NODES type = aNode->GetNodeType();
 
 if( !checkNodeType( type ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; unexpected child node '%s'." ),
 __FILE__, __FUNCTION__, __LINE__, aNode->GetNodeTypeName( type ) );
 
 return false;
 }
 
 if( WRL2NODES::WRL2_COLOR == type )
 {
 if( nullptr != color )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple color nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 color = aNode;
 return WRL2NODE::AddChildNode( aNode );
 }
 
 if( WRL2NODES::WRL2_COORDINATE == type )
 {
 if( nullptr != coord )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple coord nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 coord = aNode;
 return WRL2NODE::AddChildNode( aNode );
 }
 
 if( WRL2NODES::WRL2_NORMAL == type )
 {
 if( nullptr != normal )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple normal nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 normal = aNode;
 return WRL2NODE::AddChildNode( aNode );
 }
 
 wxCHECK_MSG( WRL2NODES::WRL2_TEXTURECOORDINATE == type, false,
 wxT( "Unexpected code branch." ) );
 
 if( nullptr != texCoord )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple texCoord nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 texCoord = aNode;
 return WRL2NODE::AddChildNode( aNode );
}

References WRL2NODE::AddChildNode(), checkNodeType(), color, coord, WRL2NODE::GetNodeType(), WRL2NODE::GetNodeTypeName(), normal, texCoord, traceVrmlPlugin, WRL2_COLOR, WRL2_COORDINATE, WRL2_NORMAL, and WRL2_TEXTURECOORDINATE.

◆ addNodeRef()

void WRL2NODE::addNodeRef ( WRL2NODE * 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

aNode is the node holding a reference to this object.

Definition at line 171 of file vrml2_node.cpp.

{
 // the parent node must never be added as a backpointer
 if( aNode == m_Parent )
 return;
 
 std::list< WRL2NODE* >::iterator np =
 std::find( m_BackPointers.begin(), m_BackPointers.end(), aNode );
 
 if( np != m_BackPointers.end() )
 return;
 
 m_BackPointers.push_back( aNode );
}

References WRL2NODE::m_BackPointers, and WRL2NODE::m_Parent.

Referenced by WRL2NODE::AddRefNode().

◆ AddRefNode()

bool WRL2FACESET::AddRefNode ( WRL2NODE * aNode )

overridevirtual

Reimplemented from WRL2NODE.

Definition at line 119 of file vrml2_faceset.cpp.

{
 wxCHECK_MSG( aNode, false, wxT( "Invalid node." ) );
 
 WRL2NODES type = aNode->GetNodeType();
 
 if( !checkNodeType( type ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; unexpected child node '%s'." ),
 __FILE__, __FUNCTION__, __LINE__, aNode->GetNodeTypeName( type ) );
 
 return false;
 }
 
 if( WRL2NODES::WRL2_COLOR == type )
 {
 if( nullptr != color )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple color nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 color = aNode;
 return WRL2NODE::AddRefNode( aNode );
 }
 
 if( WRL2NODES::WRL2_COORDINATE == type )
 {
 if( nullptr != coord )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple coord nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 coord = aNode;
 return WRL2NODE::AddRefNode( aNode );
 }
 
 if( WRL2NODES::WRL2_NORMAL == type )
 {
 if( nullptr != normal )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple normal nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 normal = aNode;
 return WRL2NODE::AddRefNode( aNode );
 }
 
 wxCHECK_MSG( WRL2NODES::WRL2_TEXTURECOORDINATE == type, false,
 wxT( "Unexpected code branch." ) );
 
 if( nullptr != texCoord )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; multiple texCoord nodes." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 
 texCoord = aNode;
 return WRL2NODE::AddRefNode( aNode );
}

References WRL2NODE::AddRefNode(), checkNodeType(), color, coord, WRL2NODE::GetNodeType(), WRL2NODE::GetNodeTypeName(), normal, texCoord, traceVrmlPlugin, WRL2_COLOR, WRL2_COORDINATE, WRL2_NORMAL, and WRL2_TEXTURECOORDINATE.

◆ checkNodeType()

bool WRL2FACESET::checkNodeType ( WRL2NODES aType )

private

Returns: true if the node type is a valid subnode of FaceSet.

Definition at line 83 of file vrml2_faceset.cpp.

{
 // nodes must be one of:
 // Color
 // Coordinate
 // Normal
 // TextureCoordinate
 
 switch( aType )
 {
 case WRL2NODES::WRL2_COLOR:
 case WRL2NODES::WRL2_COORDINATE:
 case WRL2NODES::WRL2_NORMAL:
 case WRL2NODES::WRL2_TEXTURECOORDINATE:
 break;
 
 default:
 return false;
 break;
 }
 
 return true;
}

References WRL2_COLOR, WRL2_COORDINATE, WRL2_NORMAL, and WRL2_TEXTURECOORDINATE.

Referenced by AddChildNode(), and AddRefNode().

◆ delNodeRef()

void WRL2NODE::delNodeRef ( WRL2NODE * aNode )

inherited

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

Parameters

aNode is the node holding a reference to this object

Definition at line 187 of file vrml2_node.cpp.

{
 std::list< WRL2NODE* >::iterator np =
 std::find( m_BackPointers.begin(), m_BackPointers.end(), aNode );
 
 if( np != m_BackPointers.end() )
 {
 m_BackPointers.erase( np );
 return;
 }
 
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [BUG] delNodeRef() did not find its target." ),
 __FILE__, __FUNCTION__, __LINE__ );
}

References WRL2NODE::m_BackPointers, and traceVrmlPlugin.

◆ FindNode()

WRL2NODE * WRL2NODE::FindNode	(	const std::string &	aNodeName,
		const WRL2NODE *	aCaller
	)

virtualinherited

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

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

Parameters

aNodeName	is the name of the node to search for.
aCaller	is a pointer to the node invoking this function.

Returns: is a valid node pointer on success or NULL.

Definition at line 305 of file vrml2_node.cpp.

{
 if( aNodeName.empty() )
 return nullptr;
 
 if( !m_Name.compare( aNodeName ) )
 return this;
 
 std::list< WRL2NODE* >::iterator sLA = m_Children.begin();
 std::list< WRL2NODE* >::iterator eLA = m_Children.end();
 
 WRL2NODE* psg = nullptr;
 
 while( sLA != eLA )
 {
 if( *sLA != aCaller )
 {
 psg = (*sLA)->FindNode( aNodeName, this );
 
 if( nullptr != psg )
 return psg;
 
 }
 
 ++sLA;
 }
 
 if( nullptr != m_Parent && aCaller != m_Parent )
 return m_Parent->FindNode( aNodeName, this );
 
 return nullptr;
}

References WRL2NODE::FindNode(), WRL2NODE::m_Children, WRL2NODE::m_Name, and WRL2NODE::m_Parent.

Referenced by WRL2NODE::FindNode(), and WRL2BASE::implementUse().

◆ GetError()

std::string WRL2NODE::GetError ( void )

inherited

Definition at line 299 of file vrml2_node.cpp.

{
 return m_error;
}

References WRL2NODE::m_error.

◆ GetName()

std::string WRL2NODE::GetName ( void )

virtualinherited

Reimplemented in WRL2BASE.

Definition at line 216 of file vrml2_node.cpp.

{
 return m_Name;
}

References WRL2NODE::m_Name.

◆ GetNodeType()

WRL2NODES WRL2NODE::GetNodeType ( void ) const

inherited

Returns: the type of this node instance.

Definition at line 204 of file vrml2_node.cpp.

{
 return m_Type;
}

References WRL2NODE::m_Type.

◆ getNodeTypeID()

WRL2NODES WRL2NODE::getNodeTypeID ( const std::string & aNodeName )

inherited

Returns: The ID based on the given aNodeName or WRL2_INVALID (WRL2_END) if no such node name exists.

Definition at line 288 of file vrml2_node.cpp.

{
 NODEMAP::iterator it = nodenames.find( aNodeName );
 
 if( nodenames.end() != it )
 return it->second;
 
 return WRL2NODES::WRL2_INVALID;
}

References nodenames, and WRL2_INVALID.

Referenced by WRL2BASE::ReadNode().

◆ GetNodeTypeName()

const char * WRL2NODE::GetNodeTypeName ( WRL2NODES aNodeType ) const

inherited

Definition at line 273 of file vrml2_node.cpp.

{
 if( aNodeType < WRL2NODES::WRL2_BASE || aNodeType >= WRL2NODES::WRL2_END )
 return "*INVALID_TYPE*";
 
 if( aNodeType == WRL2NODES::WRL2_BASE )
 return "*VIRTUAL_BASE*";
 
 NODEMAP::iterator it = nodenames.begin();
 advance( it, (static_cast<int>( aNodeType ) - static_cast<int>( WRL2NODES::WRL2_BEGIN ) ) );
 
 return it->first.c_str();
}

References nodenames, WRL2_BASE, WRL2_BEGIN, and WRL2_END.

Referenced by WRL2APPEARANCE::AddChildNode(), AddChildNode(), WRL2LINESET::AddChildNode(), WRL2POINTSET::AddChildNode(), WRL2SHAPE::AddChildNode(), WRL2APPEARANCE::AddRefNode(), AddRefNode(), WRL2LINESET::AddRefNode(), WRL2POINTSET::AddRefNode(), and WRL2SHAPE::AddRefNode().

◆ GetParent()

WRL2NODE * WRL2NODE::GetParent ( void ) const

inherited

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 210 of file vrml2_node.cpp.

{
 return m_Parent;
}

References WRL2NODE::m_Parent.

Referenced by WRL2NODE::AddChildNode(), WRL2SWITCH::AddRefNode(), WRL2TRANSFORM::AddRefNode(), WRL2APPEARANCE::unlinkChildNode(), unlinkChildNode(), WRL2LINESET::unlinkChildNode(), WRL2POINTSET::unlinkChildNode(), WRL2APPEARANCE::unlinkRefNode(), unlinkRefNode(), WRL2LINESET::unlinkRefNode(), and WRL2POINTSET::unlinkRefNode().

◆ HasColors()

bool WRL2FACESET::HasColors ( void )

Returns: true if the face set has a color node.

Definition at line 766 of file vrml2_faceset.cpp.

{
 if( nullptr == color )
 return false;
 
 return ( (WRL2COLOR*) color )->HasColors();
}

References color.

◆ isDangling()

bool WRL2FACESET::isDangling ( void )

overridevirtual

Determine whether an object should be moved to a different parent during the VRML to SG* translation.

Returns: true if the object does not have a parent which is a logical container for the object for example if a Shape has a parent which is a Base node.

Implements WRL2NODE.

Definition at line 108 of file vrml2_faceset.cpp.

{
 // this node is dangling unless it has a parent of type WRL2_SHAPE
 
 if( nullptr == m_Parent || m_Parent->GetNodeType() != WRL2NODES::WRL2_SHAPE )
 return true;
 
 return false;
}

References WRL2NODE::GetNodeType(), WRL2NODE::m_Parent, and WRL2_SHAPE.

◆ Read()

bool WRL2FACESET::Read	(	WRLPROC &	proc,
		WRL2BASE *	aTopNode
	)

overridevirtual

Implements WRL2NODE.

Definition at line 284 of file vrml2_faceset.cpp.

{
 char tok = proc.Peek();
 
 if( proc.eof() )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; unexpected eof %s." ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition() );
 
 return false;
 }
 
 if( '{' != tok )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] bad file format; expecting '{' but got '%s' %s." ),
 __FILE__, __FUNCTION__, __LINE__, tok, proc.GetFilePosition() );
 
 return false;
 }
 
 proc.Pop();
 std::string glob;
 
 while( true )
 {
 if( proc.Peek() == '}' )
 {
 proc.Pop();
 break;
 }
 
 if( !proc.ReadName( glob ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__ , proc.GetError() );
 
 return false;
 }
 
 // expecting one of:
 // [node]
 // color
 // coord
 // normal
 // texCoord
 // [bool]
 // ccw
 // colorPerVertex
 // convex
 // normalPerVertex
 // solid
 // [ vector<int> ]
 // colorIndex
 // coordIndex
 // normalIndex;
 // [float]
 // creaseAngle
 
 if( !glob.compare( "ccw" ) )
 {
 if( !proc.ReadSFBool( ccw ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid ccw %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "colorPerVertex" ) )
 {
 if( !proc.ReadSFBool( colorPerVertex ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid colorPerVertex %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "convex" ) )
 {
 if( !proc.ReadSFBool( convex ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid convex %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "normalPerVertex" ) )
 {
 if( !proc.ReadSFBool( normalPerVertex ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid normalPerVertex %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "solid" ) )
 {
 if( !proc.ReadSFBool( solid ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid solid %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "creaseAngle" ) )
 {
 if( !proc.ReadSFFloat( creaseAngle ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid creaseAngle %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 
 if( creaseAngle < 0.0 )
 creaseAngle = 0.0f;
 else if( creaseAngle > M_PI_2 )
 creaseAngle = static_cast<float>( M_PI_2 );
 
 creaseLimit = cosf( creaseAngle );
 }
 else if( !glob.compare( "colorIndex" ) )
 {
 if( !proc.ReadMFInt( colorIndex ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid colorIndex %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "coordIndex" ) )
 {
 if( !proc.ReadMFInt( coordIndex ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid coordIndex %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "normalIndex" ) )
 {
 if( !proc.ReadMFInt( normalIndex ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid normalIndex %s\n"
 " * [INFO] file: '%s'\n"
 "%s" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName(), proc.GetError() );
 
 return false;
 }
 }
 else if( !glob.compare( "color" ) )
 {
 if( !aTopNode->ReadNode( proc, this, nullptr ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] could not read color node information." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 }
 else if( !glob.compare( "coord" ) )
 {
 if( !aTopNode->ReadNode( proc, this, nullptr ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] could not read coord node information." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 }
 else if( !glob.compare( "normal" ) )
 {
 if( !aTopNode->ReadNode( proc, this, nullptr ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] could not read normal node information." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 }
 else if( !glob.compare( "texCoord" ) )
 {
 if( !aTopNode->ReadNode( proc, this, nullptr ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] could not read texCoord node information." ),
 __FILE__, __FUNCTION__, __LINE__ );
 
 return false;
 }
 }
 else
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] invalid IndexedFaceSet %s (no closing brace)\n"
 " * [INFO] file: '%s'\n" ),
 __FILE__, __FUNCTION__, __LINE__, proc.GetFilePosition(),
 proc.GetFileName() );
 
 return false;
 }
 } // while( true ) -- reading contents of IndexedFaceSet{}
 
 return true;
}

References ccw, colorIndex, colorPerVertex, convex, coordIndex, creaseAngle, creaseLimit, WRLPROC::eof(), WRLPROC::GetError(), WRLPROC::GetFileName(), WRLPROC::GetFilePosition(), M_PI_2, normalIndex, normalPerVertex, WRLPROC::Peek(), WRLPROC::Pop(), WRLPROC::ReadMFInt(), WRLPROC::ReadName(), WRL2BASE::ReadNode(), WRLPROC::ReadSFBool(), WRLPROC::ReadSFFloat(), solid, and traceVrmlPlugin.

Referenced by WRL2BASE::readFaceSet().

◆ setDefaults()

void WRL2FACESET::setDefaults ( void )

private

Definition at line 65 of file vrml2_faceset.cpp.

{
 color = nullptr;
 coord = nullptr;
 normal = nullptr;
 texCoord = nullptr;
 
 ccw = true;
 colorPerVertex = true;
 convex = true;
 normalPerVertex = true;
 solid = true;
 
 creaseAngle = 0.733f; // approx 42 degrees; this is larger than VRML spec.
 creaseLimit = 0.74317f; // cos( 0.733 )
}

References ccw, color, colorPerVertex, convex, coord, creaseAngle, creaseLimit, normal, normalPerVertex, solid, and texCoord.

Referenced by WRL2FACESET().

◆ SetName()

bool WRL2NODE::SetName ( const std::string & aName )

virtualinherited

Reimplemented in WRL2BASE.

Definition at line 222 of file vrml2_node.cpp.

{
 if( aName.empty() )
 return false;
 
 std::set< std::string >::iterator item = badNames.find( aName );
 
 if( item != badNames.end() )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] invalid node name '%s' (matches restricted word)" ),
 __FILE__, __FUNCTION__, __LINE__, *item );
 
 return false;
 }
 
 
 if( isdigit( aName[0] ) )
 {
 wxLogTrace( traceVrmlPlugin, wxT( "%s:%s:%d\n"
 " * [INFO] invalid node name '%s' (begins with digit)" ),
 __FILE__, __FUNCTION__, __LINE__, aName );
 
 return false;
 }
 
 // The characters '+' and '-' are not allowed in names as per the VRML2 specification;
 // however many parsers accept them and many bad generators use them so the rules
 // have been relaxed here.
 // #define BAD_CHARS1 "\"\'#+,-.\\[]{}\x00\x01\x02\x03\x04\x05\x06\x09\x0A\x0B\x0C\x0D\x0E\x0F"
 #define BAD_CHARS1 "\"\'#,.\\[]{}\x00\x01\x02\x03\x04\x05\x06\x09\x0A\x0B\x0C\x0D\x0E\x0F"
 #define BAD_CHARS2 "\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F"
 
 if( std::string::npos != aName.find_first_of( BAD_CHARS1 )
 || std::string::npos != aName.find_first_of( BAD_CHARS2 ) )
 {
 wxLogTrace( traceVrmlPlugin,
 wxT( "%s:%s:%d\n"
 " * [INFO] invalid node name '%s' (contains invalid character)" ),
 __FILE__, __FUNCTION__, __LINE__, aName );
 
 return false;
 }
 
 m_Name = aName;
 
 return true;
}

References BAD_CHARS1, BAD_CHARS2, badNames, WRL2NODE::m_Name, and traceVrmlPlugin.

Referenced by WRL2BASE::implementDef().

◆ SetParent()

bool WRL2NODE::SetParent	(	WRL2NODE *	aParent,
		bool	doUnlink = `true`
	)

virtualinherited

Set the parent WRL2NODE of this object.

Parameters

aParent	[in] is the desired parent node.
doUnlink	indicates that the child must be unlinked from the parent

Returns: true if the operation succeeds of false if the given node is not allowed to be a parent to the derived object.

Reimplemented in WRL2BASE.

Definition at line 339 of file vrml2_node.cpp.

{
 if( aParent == m_Parent )
 return true;
 
 if( nullptr != m_Parent && doUnlink )
 m_Parent->unlinkChildNode( this );
 
 m_Parent = aParent;
 
 if( nullptr != m_Parent )
 m_Parent->AddChildNode( this );
 
 return true;
}

References WRL2NODE::AddChildNode(), WRL2NODE::m_Parent, and WRL2NODE::unlinkChildNode().

Referenced by WRL2NODE::AddChildNode(), WRL2SWITCH::AddRefNode(), and WRL2TRANSFORM::AddRefNode().

◆ TranslateToSG()

SGNODE * WRL2FACESET::TranslateToSG ( SGNODE * aParent )

overridevirtual

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

Parameters

aParent is a pointer to the parent SG node.

Returns: is non-NULL on success.

Implements WRL2NODE.

Definition at line 544 of file vrml2_faceset.cpp.

{
 S3D::SGTYPES ptype = S3D::GetSGNodeType( aParent );
 
 wxCHECK_MSG( aParent && ( ptype == S3D::SGTYPE_SHAPE ), nullptr,
 wxString::Format( wxT( "IndexedFaceSet does not have a Shape parent (parent "
 "ID: %d)." ), ptype ) );
 
 wxLogTrace( traceVrmlPlugin,
 wxT( " * [INFO] Translating IndexedFaceSet with %zu children, %zu references, "
 "%zu back pointers, and %zu coord indices." ),
 m_Children.size(), m_Refs.size(), m_BackPointers.size(), coordIndex.size() );
 
 if( m_sgNode )
 {
 if( nullptr != aParent )
 {
 if( nullptr == S3D::GetSGNodeParent( m_sgNode )
 && !S3D::AddSGNodeChild( aParent, m_sgNode ) )
 {
 return nullptr;
 }
 else if( aParent != S3D::GetSGNodeParent( m_sgNode )
 && !S3D::AddSGNodeRef( aParent, m_sgNode ) )
 {
 return nullptr;
 }
 }
 
 return m_sgNode;
 }
 
 size_t vsize = coordIndex.size();
 
 if( nullptr == coord || vsize < 3 )
 return nullptr;
 
 WRLVEC3F* pcoords;
 size_t coordsize;
 ((WRL2COORDS*) coord)->GetCoords( pcoords, coordsize );
 
 if( coordsize < 3 )
 return nullptr;
 
 // check that all indices are valid
 for( size_t idx = 0; idx < vsize; ++idx )
 {
 if( coordIndex[idx] < 0 )
 continue;
 
 if( coordIndex[idx] >= (int)coordsize )
 return nullptr;
 }
 
 SHAPE lShape;
 FACET* fp = nullptr;
 size_t iCoord;
 int idx; // coordinate index
 size_t cidx = 0; // color index
 SGCOLOR pc1;
 
 if( nullptr == color )
 {
 // no per-vertex colors; we can save a few CPU cycles
 for( iCoord = 0; iCoord < vsize; ++iCoord )
 {
 idx = coordIndex[iCoord];
 
 if( idx < 0 )
 {
 if( nullptr != fp )
 {
 if( fp->HasMinPoints() )
 fp = nullptr;
 else
 fp->Init();
 }
 
 continue;
 }
 
 // if the coordinate is bad then skip it
 if( idx >= (int)coordsize )
 continue;
 
 if( nullptr == fp )
 fp = lShape.NewFacet();
 
 // push the vertex value and index
 fp->AddVertex( pcoords[idx], idx );
 }
 }
 else
 {
 WRL2COLOR* cn = (WRL2COLOR*) color;
 WRLVEC3F tc;
 
 for( iCoord = 0; iCoord < vsize; ++iCoord )
 {
 idx = coordIndex[iCoord];
 
 if( idx < 0 )
 {
 if( nullptr != fp )
 {
 if( fp->HasMinPoints() )
 fp = nullptr;
 else
 fp->Init();
 }
 
 if( !colorPerVertex )
 ++cidx;
 
 continue;
 }
 
 // if the coordinate is bad then skip it
 if( idx >= (int)coordsize )
 continue;
 
 if( nullptr == fp )
 fp = lShape.NewFacet();
 
 // push the vertex value and index
 fp->AddVertex( pcoords[idx], idx );
 
 // push the color if appropriate
 if( !colorPerVertex )
 {
 if( colorIndex.empty() )
 {
 cn->GetColor( cidx, tc.x, tc.y, tc.z );
 pc1.SetColor( tc.x, tc.y, tc.z );
 fp->AddColor( pc1 );
 }
 else
 {
 if( cidx < colorIndex.size() )
 cn->GetColor( colorIndex[cidx], tc.x, tc.y, tc.z );
 else
 cn->GetColor( colorIndex.back(), tc.x, tc.y, tc.z );
 
 pc1.SetColor( tc.x, tc.y, tc.z );
 fp->AddColor( pc1 );
 }
 }
 else
 {
 if( colorIndex.empty() )
 {
 cn->GetColor( idx, tc.x, tc.y, tc.z );
 pc1.SetColor( tc.x, tc.y, tc.z );
 fp->AddColor( pc1 );
 }
 else
 {
 if( iCoord < colorIndex.size() )
 cn->GetColor( colorIndex[iCoord], tc.x, tc.y, tc.z );
 else
 cn->GetColor( colorIndex.back(), tc.x, tc.y, tc.z );
 
 pc1.SetColor( tc.x, tc.y, tc.z );
 fp->AddColor( pc1 );
 }
 }
 }
 }
 
 SGNODE* np = nullptr;
 
 if( ccw )
 np = lShape.CalcShape( aParent, nullptr, WRL1_ORDER::ORD_CCW, creaseLimit, true );
 else
 np = lShape.CalcShape( aParent, nullptr, WRL1_ORDER::ORD_CLOCKWISE, creaseLimit, true );
 
 return np;
}

References FACET::AddColor(), S3D::AddSGNodeChild(), S3D::AddSGNodeRef(), FACET::AddVertex(), SHAPE::CalcShape(), ccw, color, colorIndex, colorPerVertex, coord, coordIndex, creaseLimit, Format(), WRL2COLOR::GetColor(), S3D::GetSGNodeParent(), S3D::GetSGNodeType(), FACET::HasMinPoints(), FACET::Init(), WRL2NODE::m_BackPointers, WRL2NODE::m_Children, WRL2NODE::m_Refs, WRL2NODE::m_sgNode, SHAPE::NewFacet(), ORD_CCW, ORD_CLOCKWISE, SGCOLOR::SetColor(), S3D::SGTYPE_SHAPE, and traceVrmlPlugin.

◆ unlinkChildNode()

void WRL2FACESET::unlinkChildNode ( const WRL2NODE * aNode )

overridevirtual

Remove references to an owned child.

It is invoked by the child upon destruction to ensure that the parent has no invalid references.

Parameters

aNode is the child which is being deleted.

Reimplemented from WRL2NODE.

Definition at line 724 of file vrml2_faceset.cpp.

{
 if( nullptr == aNode )
 return;
 
 if( aNode->GetParent() == this )
 {
 if( aNode == color )
 color = nullptr;
 else if( aNode == coord )
 coord = nullptr;
 else if( aNode == normal )
 normal = nullptr;
 else if( aNode == texCoord )
 texCoord = nullptr;
 }
 
 WRL2NODE::unlinkChildNode( aNode );
}

References color, coord, WRL2NODE::GetParent(), normal, texCoord, and WRL2NODE::unlinkChildNode().

◆ unlinkRefNode()

void WRL2FACESET::unlinkRefNode ( const WRL2NODE * aNode )

overridevirtual

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

aNode is the node which is being deleted.

Reimplemented from WRL2NODE.

Definition at line 745 of file vrml2_faceset.cpp.

{
 if( nullptr == aNode )
 return;
 
 if( aNode->GetParent() != this )
 {
 if( aNode == color )
 color = nullptr;
 else if( aNode == coord )
 coord = nullptr;
 else if( aNode == normal )
 normal = nullptr;
 else if( aNode == texCoord )
 texCoord = nullptr;
 }
 
 WRL2NODE::unlinkRefNode( aNode );
}

References color, coord, WRL2NODE::GetParent(), normal, texCoord, and WRL2NODE::unlinkRefNode().

Member Data Documentation

◆ ccw

bool WRL2FACESET::ccw

private

Definition at line 75 of file vrml2_faceset.h.

Referenced by Read(), setDefaults(), and TranslateToSG().

◆ color

WRL2NODE* WRL2FACESET::color

private

Definition at line 70 of file vrml2_faceset.h.

Referenced by AddChildNode(), AddRefNode(), HasColors(), setDefaults(), TranslateToSG(), unlinkChildNode(), and unlinkRefNode().

◆ colorIndex

std::vector< int > WRL2FACESET::colorIndex

private

Definition at line 81 of file vrml2_faceset.h.

Referenced by Read(), and TranslateToSG().

◆ colorPerVertex

bool WRL2FACESET::colorPerVertex

private

Definition at line 76 of file vrml2_faceset.h.

Referenced by Read(), setDefaults(), and TranslateToSG().

◆ convex

bool WRL2FACESET::convex

private

Definition at line 77 of file vrml2_faceset.h.

Referenced by Read(), and setDefaults().

◆ coord

WRL2NODE* WRL2FACESET::coord

private

Definition at line 71 of file vrml2_faceset.h.

Referenced by AddChildNode(), AddRefNode(), setDefaults(), TranslateToSG(), unlinkChildNode(), and unlinkRefNode().

◆ coordIndex

std::vector< int > WRL2FACESET::coordIndex

private

Definition at line 82 of file vrml2_faceset.h.

Referenced by Read(), and TranslateToSG().

◆ creaseAngle

float WRL2FACESET::creaseAngle

private

Definition at line 85 of file vrml2_faceset.h.

Referenced by Read(), and setDefaults().

◆ creaseLimit

float WRL2FACESET::creaseLimit

private

Definition at line 86 of file vrml2_faceset.h.

Referenced by Read(), setDefaults(), and TranslateToSG().

◆ m_BackPointers

std::list< WRL2NODE* > WRL2NODE::m_BackPointers

protectedinherited

Definition at line 173 of file vrml2_node.h.

Referenced by WRL2NODE::addNodeRef(), WRL2NODE::delNodeRef(), WRL2APPEARANCE::TranslateToSG(), TranslateToSG(), WRL2MATERIAL::TranslateToSG(), WRL2SHAPE::TranslateToSG(), WRL2SWITCH::TranslateToSG(), WRL2TRANSFORM::TranslateToSG(), WRL2APPEARANCE::~WRL2APPEARANCE(), ~WRL2FACESET(), WRL2LINESET::~WRL2LINESET(), WRL2NODE::~WRL2NODE(), WRL2POINTSET::~WRL2POINTSET(), WRL2SHAPE::~WRL2SHAPE(), WRL2SWITCH::~WRL2SWITCH(), and WRL2TRANSFORM::~WRL2TRANSFORM().

◆ m_Children

std::list< WRL2NODE* > WRL2NODE::m_Children

protectedinherited

◆ m_error

std::string WRL2NODE::m_error

protectedinherited

Definition at line 176 of file vrml2_node.h.

Referenced by WRL2NODE::GetError().

◆ m_Name

std::string WRL2NODE::m_Name

protectedinherited

Definition at line 171 of file vrml2_node.h.

Referenced by WRL2NODE::FindNode(), WRL2NODE::GetName(), and WRL2NODE::SetName().

◆ m_Parent

WRL2NODE* WRL2NODE::m_Parent

protectedinherited

◆ m_Refs

std::list< WRL2NODE* > WRL2NODE::m_Refs

protectedinherited

Definition at line 175 of file vrml2_node.h.

Referenced by WRL2NODE::AddRefNode(), WRL2APPEARANCE::TranslateToSG(), TranslateToSG(), WRL2MATERIAL::TranslateToSG(), WRL2SHAPE::TranslateToSG(), WRL2SWITCH::TranslateToSG(), WRL2TRANSFORM::TranslateToSG(), WRL2NODE::unlinkRefNode(), WRL2APPEARANCE::~WRL2APPEARANCE(), ~WRL2FACESET(), WRL2LINESET::~WRL2LINESET(), WRL2NODE::~WRL2NODE(), WRL2POINTSET::~WRL2POINTSET(), WRL2SHAPE::~WRL2SHAPE(), WRL2SWITCH::~WRL2SWITCH(), and WRL2TRANSFORM::~WRL2TRANSFORM().

◆ m_sgNode

SGNODE* WRL2NODE::m_sgNode

protectedinherited

Definition at line 178 of file vrml2_node.h.

Referenced by WRL2APPEARANCE::TranslateToSG(), WRL2BASE::TranslateToSG(), WRL2BOX::TranslateToSG(), TranslateToSG(), WRL2MATERIAL::TranslateToSG(), WRL2SHAPE::TranslateToSG(), WRL2TRANSFORM::TranslateToSG(), and WRL2NODE::WRL2NODE().

◆ m_Type

WRL2NODES WRL2NODE::m_Type

protectedinherited

Definition at line 170 of file vrml2_node.h.

Referenced by WRL2NODE::GetNodeType(), WRL2APPEARANCE::WRL2APPEARANCE(), WRL2BASE::WRL2BASE(), WRL2BOX::WRL2BOX(), WRL2COLOR::WRL2COLOR(), WRL2COORDS::WRL2COORDS(), WRL2FACESET(), WRL2INLINE::WRL2INLINE(), WRL2LINESET::WRL2LINESET(), WRL2MATERIAL::WRL2MATERIAL(), WRL2NODE::WRL2NODE(), WRL2NORMS::WRL2NORMS(), WRL2POINTSET::WRL2POINTSET(), WRL2SHAPE::WRL2SHAPE(), WRL2SWITCH::WRL2SWITCH(), and WRL2TRANSFORM::WRL2TRANSFORM().

◆ normal

WRL2NODE* WRL2FACESET::normal

private

Definition at line 72 of file vrml2_faceset.h.

Referenced by AddChildNode(), AddRefNode(), setDefaults(), unlinkChildNode(), and unlinkRefNode().

◆ normalIndex

std::vector< int > WRL2FACESET::normalIndex

private

Definition at line 83 of file vrml2_faceset.h.

Referenced by Read().

◆ normalPerVertex

bool WRL2FACESET::normalPerVertex

private

Definition at line 78 of file vrml2_faceset.h.

Referenced by Read(), and setDefaults().

◆ solid

bool WRL2FACESET::solid

private

Definition at line 79 of file vrml2_faceset.h.

Referenced by Read(), and setDefaults().

◆ texCoord

WRL2NODE* WRL2FACESET::texCoord

private

Definition at line 73 of file vrml2_faceset.h.

Referenced by AddChildNode(), AddRefNode(), setDefaults(), unlinkChildNode(), and unlinkRefNode().

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

Public Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ WRL2FACESET() [1/2]

◆ WRL2FACESET() [2/2]

◆ ~WRL2FACESET()

Member Function Documentation

◆ AddChildNode()

◆ addNodeRef()

◆ AddRefNode()

◆ checkNodeType()

◆ delNodeRef()

◆ FindNode()

◆ GetError()

◆ GetName()

◆ GetNodeType()

◆ getNodeTypeID()

◆ GetNodeTypeName()

◆ GetParent()

◆ HasColors()

◆ isDangling()

◆ Read()

◆ setDefaults()

◆ SetName()

◆ SetParent()

◆ TranslateToSG()

◆ unlinkChildNode()

◆ unlinkRefNode()

Member Data Documentation

◆ ccw

◆ color

◆ colorIndex

◆ colorPerVertex

◆ convex

◆ coord

◆ coordIndex

◆ creaseAngle

◆ creaseLimit

◆ m_BackPointers

◆ m_Children

◆ m_error

◆ m_Name

◆ m_Parent

◆ m_Refs

◆ m_sgNode

◆ m_Type

◆ normal

◆ normalIndex

◆ normalPerVertex

◆ solid

◆ texCoord