Page Comparison

To run this application, it is necessary to specify source and destination CAD file names to the Command Arguments of Debugging page of the project property, i.e.
"$(HEXCHANGE_INSTALL_DIR)\samples\data\step\helloworld.stp" "C:\temp\helloworld.prc"

...
#include <sstream>

#include "visitor/VisitorContainer.h"
#include "visitor/VisitorTree.h"

static MY_CHAR acSrcFileName[_MAX_PATH * 2];
static MY_CHAR acDstFileName[_MAX_PATH * 2];
static MY_CHAR acLogFileName[_MAX_PATH * 2];

void traverseModelFile(A3DAsmModelFile* pModelFile)
{
	// Prepare Visitor container
	A3DVisitorContainer sA3DVisitorContainer(CONNECT_TRANSFO);
	sA3DVisitorContainer.SetTraverseInstance(true);

	// Prepare Tree traverse visitor and set to the container
	A3DTreeVisitor *pA3DTreeVisitor = new A3DTreeVisitor(&sA3DVisitorContainer);
	sA3DVisitorContainer.push(pA3DTreeVisitor);

	// Prepare model file connector and call Traverse
	A3DModelFileConnector sModelFileConnector(pModelFile);
	A3DStatus sStatus = sModelFileConnector.Traverse(&sA3DVisitorContainer);

}

//######################################################################################################################
#ifdef _MSC_VER
int wmain(A3DInt32 iArgc, A3DUniChar** ppcArgv)
...

...
	A3DExport sExport(acDstFileName); // see A3DSDKInternalConvert.hxx for import and export detailed parameters

									  // perform conversion
	CHECK_RET(sHoopsExchangeLoader.Import(sImport));

	traverseModelFile(sHoopsExchangeLoader.m_psModelFile);

	CHECK_RET(sHoopsExchangeLoader.Export(sExport));
...

...
static MY_CHAR acLogFileName[_MAX_PATH * 2];

class myTreeVisitor: public A3DTreeVisitor
{
public:
	myTreeVisitor(A3DVisitorContainer* psContainer = NULL) : A3DTreeVisitor(psContainer) {};
	~myTreeVisitor() {};

public:
	virtual A3DStatus visitEnter(const A3DProductOccurrenceConnector& sConnector) override
	{
		A3DStatus iRet = A3DTreeVisitor::visitEnter(sConnector);

		// My processes

		return iRet;
	}

	virtual A3DStatus visitLeave(const A3DProductOccurrenceConnector& sConnector) override
	{
		A3DStatus iRet = A3D_SUCCESS;

		// My processes

		iRet = A3DTreeVisitor::visitLeave(sConnector);
		return iRet;
	}
};

void traverseModelFile(A3DAsmModelFile* pModelFile)
...

...
	// Prepare Tree traverse visitor and set to the container
	myTreeVisitor *pMyTreeVisitor = new myTreeVisitor(&sA3DVisitorContainer);
	sA3DVisitorContainer.push(pMyTreeVisitor);
...

In A3DTreeVisitor, the model file is traversed recursively from the root (pModelFile) to leaves (Product Occurrence, Part definition, Representation Item, etc.). The visitEnter() method is called at the beginning of each node traversal and the visitLeave() is called at the end of traversal. Due to the nature of the visitor pattern, all model tree nodes use the same methods (visitEnter() and visitLeave()) by changing the connector type argument.

In the above sample, you can implement your own processes when Product Occurrence is traversed by setting as A3DProductOccurrenceConnector in the argument.

...
private:
	int m_iLevel = 0;

public:
	virtual A3DStatus visitEnter(const A3DProductOccurrenceConnector& sConnector) override
	{
		A3DStatus iRet = A3DTreeVisitor::visitEnter(sConnector);

		// Increment level
		m_iLevel++;

		// Get the ProductOccurrence (PO)
		const A3DEntity* pEntity = sConnector.GetA3DEntity();
		A3DAsmProductOccurrence* pPO = (A3DAsmProductOccurrence*)pEntity;

		// Get RootBaseData of the PO
		A3DRootBaseData sRootBaseData;
		A3D_INITIALIZE_DATA(A3DRootBaseData, sRootBaseData);
		A3DRootBaseGet(pPO, &sRootBaseData);

		// Get the PO name  
		A3DUniChar acName[256];
		if (sRootBaseData.m_pcName)
			A3DMiscUTF8ToUTF16(sRootBaseData.m_pcName, acName);
		else
			wcscpy_s(acName, _T("NO_NAME"));

		// Show the PO name with level 
		for (int i = 0; i < m_iLevel; i++)
			_tprintf(_T("+ "));

		_tprintf(_T("%s\n"), acName);

		return iRet;
	}

	virtual A3DStatus visitLeave(const A3DProductOccurrenceConnector& sConnector) override
	{
		A3DStatus iRet = A3D_SUCCESS;

		// Decrement level
		m_iLevel--;

		iRet = A3DTreeVisitor::visitLeave(sConnector);
		return iRet;
	}
...

In the above image, we used the Landing Gear model in the sample folder.
"$(HEXCHANGE_INSTALL_DIR)\samples\data\catiaV5\CV5_Landing Gear Model_LandingGear.CATProduct"

...
#include "visitor/VisitorTree.h"
#include "visitor/VisitorCascadedAttribute.h"
#include "visitor/CascadedAttributeConnector.h"
...
void traverseModelFile(A3DAsmModelFile* pModelFile)
{
	// Prepare Visitor container
	A3DVisitorContainer sA3DVisitorContainer(CONNECT_TRANSFO | CONNECT_COLORS);
	sA3DVisitorContainer.SetTraverseInstance(true);
	...

...
	virtual A3DStatus visitEnter(const A3DProductOccurrenceConnector& sConnector) override
	{
...
		_tprintf(_T("%s"), acName);

		A3DVisitorColorMaterials *pA3DCascadedVisitor = static_cast<A3DVisitorColorMaterials*>(m_psContainer->GetVisitorByName("CascadedAttribute"));
		if (pA3DCascadedVisitor)
		{
			ColorMaterialsConnector sColorConnector(nullptr);
			pA3DCascadedVisitor->GetColorMaterialConnector(sColorConnector);

			if (sColorConnector.IsShow())
				_tprintf(_T("\n"));
			else
				_tprintf(_T(" (Hidden)\n"));
		}

		return iRet;
	}
...

The visitor to get a transformation is already assigned to the visitor container.
A3DVisitorContainer sA3DVisitorContainer(CONNECT_TRANSFO | CONNECT_COLORS);

class myTreeVisitor: public A3DTreeVisitor
{
...
	virtual A3DStatus visitEnter(const A3DPartConnector& sConnector) override
	{
		A3DStatus iRet = A3DTreeVisitor::visitEnter(sConnector);
		
		// Get transform connector via transform visitor
		A3DVisitorTransfo* psVisitorTransfo = static_cast<A3DVisitorTransfo*>(m_psContainer->GetVisitorByName("Transformation"));
		A3DTransfoConnector* pConnector = psVisitorTransfo->GetTransfoConnector();
		A3DMatrix4x4 sTransfo;
		pConnector->GetGlobalTransfo(sTransfo);
		delete pConnector;

		for (unsigned int i = 0; i < m_iLevel; i++)
			_tprintf(_T("+ "));

		_tprintf(_T(" (%.3f, %.3f, %.3f)\n"), sTransfo.m_adM[12], sTransfo.m_adM[13], sTransfo.m_adM[14]);

		return iRet;
	}
...

You will see sA3DVisitorContainer.SetTraverseInstance(true) when creating the visitor container. Setting to true causes the visitor to traverse each instance part.

If set to false, just the first part of the instance will be traversed.