3DTools.h

#if !defined(AFX_3DTOOLS_H__CA6BC29F_FAC2_11D1_A0DE_000000000000__INCLUDED_)
#define AFX_3DTOOLS_H__CA6BC29F_FAC2_11D1_A0DE_000000000000__INCLUDED_
 
BEGIN_MOOTOOLS_NAMESPACE
 
#define SLICESCENE_VERTCOUNT_MODE 0
#define SLICESCENE_VC_MODE 1
 
#define SLICESCENE_MODE MAKE_CUSTOM_ID('M', 'O', 'D', 'E')
#define SLICESCENE_X    MAKE_CUSTOM_ID('X', ' ', ' ', ' ')
#define SLICESCENE_Y    MAKE_CUSTOM_ID('Y', ' ', ' ', ' ')
#define SLICESCENE_Z    MAKE_CUSTOM_ID('Z', ' ', ' ', ' ')
#define SLICESCENE_MAX_VERTS MAKE_CUSTOM_ID('V' ,'E', 'R', 'T')
 
// Usefuls
// Return a C3DObject providing a list of triangles and quadrangles
DLL_3DFUNCTION C3DObject *CreateObjectFromArrays(const float *coords, unsigned int coordsSizeOf, const int *triangles, unsigned int trianglesSizeOf, const int *quadrangles, unsigned int quadranglesSizeOf);
 
// GetOneUVPerVertex (was called GetUVVertexFromUVFace before)
// Return an int* array that contain the matching UV in the CUVWPointList a given vertex index. The array must be deallocated using xDeallocateArray once used.
// Size is 0, or equal to C3DPointList size.
//
// This helper function is useful when the objet have no UV seams (meaning that there is one and only one UV per point).
// This can be achieved during an import/export using SCENE_....._DISCONNECT_FACES or calling directly bool C3DGeomObject::DisconnectBorderFaces
// For particular mesh, some UV might be missing for a given point. In that case, UV index return in the array is set to -1 and it's important to check that value and use a default UV value of your choice in that case.
// Using that function you can export easily points with corresponding UV like this:
//
// C3DGeomObject* object = node->GetGeomObject();
// CDependentChannels* channels = object->GetChannels();
// C3DPointList* points = object->GetPointList();
// CUVWPointList* uvpts = NULL;
// CUVWFaceList* uvfaces = NULL;
//
// object->DisconnectBorderFaces(); // Remove any seams from the object by duplicating points
// ChannelID globalChannelID = object->GlobalizeChannels(scene, true);
// channels->GetUVWChannelByID(globalChannelID, uvfaces, uvpts);
//
// int i, size;
// int* uvindex = GetOneUVPerVertex(object, globalChannelID, size); // Require
//
// XASSERT(points->GetSize() == size || !size);
//
// float u, v;
// C3DPoint* point;
// CUVWPoint* uvwpoint;
// size = points->GetSize();
// for (i = 0; i < size; i++)
// {
//      point = (*points)[i];
//
//      // Get matching UV
//      if (uvindex && uvindex[i] != -1)
//      {
//          uvwpoint = ((*uvpts)[uvindex[i]]);
//          u = uvwpoint->u;
//          v = uvwpoint->v;
//      }
//      else
//      {
//          XTRACE("undefined UV\n");
//
//          u = 0;
//          v = 0;
//      }
//
//      // Do what you want with UV
//  }
//
// xDeallocateArray((uvindex);
DLL_3DFUNCTION int *GetOneUVPerVertex(C3DGeomObject *object, ChannelID id, int& size);
 
// Create different geometry entities
DLL_3DFUNCTION C3DSceneNode *CreateCapsule(const C3DPoint& center, float radius, float length, unsigned int sides, unsigned int sphereSegments, unsigned int tubeDivisions, AXIS_INFO axis, BOOL createUV = true, MaterialID matid = DEFAULT_MATERIAL_ID, ChannelID chnid = CHANNELID_UNDEFINED);
DLL_3DFUNCTION C3DSceneNode *CreateSphere(const C3DPoint& center, double mRadius, const int mRings = 16, const int mSegments = 16, bool createUV = true, MaterialID matid = DEFAULT_MATERIAL_ID, ChannelID chnid = CHANNELID_UNDEFINED);
DLL_3DFUNCTION C3DSceneNode *CreateCube(const C3DPoint& center, double xLength = 1.0f, double yLength = 1.0f, double zLength = 1.0f, bool createUV = true, MaterialID matid = DEFAULT_MATERIAL_ID, ChannelID chnid = CHANNELID_UNDEFINED);
DLL_3DFUNCTION C3DSceneNode *CreateCone(const C3DPoint& center, double radius = 1.f, double height = 1.f, unsigned int numSegBase = 16, unsigned int numSegHeight = 1, bool createUV = true, MaterialID matid = DEFAULT_MATERIAL_ID, ChannelID chnid = CHANNELID_UNDEFINED);
DLL_3DFUNCTION C3DSceneNode *CreateCylinder(const C3DPoint& center, double radius = 1.f, double height = 1.f, UP_AXIS_MODE axyz = UP_AXIS_Z, unsigned int numSegBase = 16, unsigned int numSegHeight = 8, bool capped = true, bool createUV = true, MaterialID matid = DEFAULT_MATERIAL_ID, ChannelID chnid = CHANNELID_UNDEFINED);
DLL_3DFUNCTION C3DSceneNode* CreatePlane(const C3DPoint& center, const C3DVector& mNormal, double mSizeX, double mSizeY, unsigned int numSegX = 16, unsigned int numSegY = 16, bool createUV = true, MaterialID matid = DEFAULT_MATERIAL_ID, ChannelID chnid = CHANNELID_UNDEFINED);
 
// Divide the whole scene geometry by a grid. The geometry of the mesh is put into cells of the grid (when using SLICESCENE_VERTCOUNT_MODE) or a vertex color channel is assigned and a given color is given to each point depending on the cell in which the point is located (SLICESCENE_VC_MODE)
// Grid size is defined by SLICESCENE_X, SLICESCENE_Y, SLICESCENE_Z and a max number of point for a cell can be defined (SLICESCENE_MAX_VERTS).
DLL_3DFUNCTION bool SliceScene(const CCustomData& settings, C3DScene *scene);
 
END_MOOTOOLS_NAMESPACE
 
#endif // !defined(AFX_3DTOOLS_H__CA6BC29F_FAC2_11D1_A0DE_000000000000__INCLUDED_)