DGtal::MeshWriter< TPoint > Struct Template Reference

Aim: Export a Mesh (Mesh object) in different format as OFF and OBJ). More...

#include <DGtal/io/writers/MeshWriter.h>

Static Public Member Functions
static bool	export2OFF (std::ostream &out, const Mesh< TPoint > &aMesh, bool exportColor=true)
static bool	export2OBJ (std::ostream &out, const Mesh< TPoint > &aMesh)
static bool	export2OBJ_colors (std::ostream &out, std::ostream &outMTL, const std::string nameMTLFile, const Mesh< TPoint > &aMesh)
static bool	export2OBJ_colors (std::ostream &out, const Mesh< TPoint > &aMesh)

Detailed Description

template<typename TPoint>
struct DGtal::MeshWriter< TPoint >

Aim: Export a Mesh (Mesh object) in different format as OFF and OBJ).

Description of template struct 'MeshWriter'

The exportation can be done automatically according the input file extension with the ">>" operator

Example of typical use: First you have to add the following include files:

#include "DGtal/shapes/Mesh.h"
#include "DGtal/io/writers/MeshWriter.h"

Then you create a simple Mesh object:

  // Constructing the mesh to export in OFF format
  Mesh<Point> aMesh(true);  
  vector<Point> vectVertex;
  Point p1(0, 0, 0);
  Point p2(1, 0, 0);
  Point p3(1, 1, 0);
  Point p4(0, 1, 0);  
  Point p11(0, 0, 1);
  Point p21(1, 0, 1);
  Point p31(1, 1, 1);
  Point p41(0, 1, 1);  
  aMesh.addVertex(p1);
  aMesh.addVertex(p2);
  aMesh.addVertex(p3);
  aMesh.addVertex(p4);  
  aMesh.addVertex(p11);
  aMesh.addVertex(p21);
  aMesh.addVertex(p31);
  aMesh.addVertex(p41);  
 
  vector<DGtal::Color> vectColor;
  DGtal::Color col (250,0,0, 200);
  DGtal::Color col2 (250,250,0, 200);
  
  aMesh.addQuadFace(0,1,2,3, col);
  aMesh.addQuadFace(4,5,6,7, col2);
  aMesh.addQuadFace(0,1,5,4, col);
 

Finally you can export directly the Mesh object:

  bool isOK = aMesh >> "test.off";

See also

Mesh MeshWriter

Definition at line 76 of file MeshWriter.h.

Member Function Documentation

export2OBJ()

template<typename TPoint >

static bool DGtal::MeshWriter< TPoint >::export2OBJ ( std::ostream &  out, const Mesh< TPoint > &  aMesh  )

static

Export a Mesh towards a OBJ format (colors are exported).

Parameters

out	the output stream of the exported OBJ object.
aMesh	the Mesh object to be exported.

Returns

true if no errors occur.

export2OBJ_colors() [1/2]

template<typename TPoint >

static bool DGtal::MeshWriter< TPoint >::export2OBJ_colors ( std::ostream &  out, const Mesh< TPoint > &  aMesh  )

static

Export a Mesh towards a OBJ format including face colors. The material containing face colors will be written inside the resulting .obj file.

Parameters

[out]	out	the output stream of the exported OBJ object.
[in]	aMesh	the Mesh object to be exported.

Returns

true if no errors occur.

export2OBJ_colors() [2/2]

template<typename TPoint >

static bool DGtal::MeshWriter< TPoint >::export2OBJ_colors ( std::ostream &  out, std::ostream &  outMTL, const std::string  nameMTLFile, const Mesh< TPoint > &  aMesh  )

static

Export a Mesh towards a OBJ format including face colors.

Parameters

[out]	out	the output stream of the exported OBJ object.
[out]	outMTL	the output stream associated to the material file.
[in]	nameMTLFile	the file name of the material file. If an empty string is given, the material will be written inside the output stream.
[in]	aMesh	the Mesh object to be exported.

Returns

true if no errors occur.

export2OFF()

template<typename TPoint >

static bool DGtal::MeshWriter< TPoint >::export2OFF ( std::ostream &  out, const Mesh< TPoint > &  aMesh, bool  exportColor = true  )

static

Export Mesh towards a OFF format. By default the face colors are exported (if they are stored in the Mesh object).

Parameters

out	the output stream of the exported OFF object.
aMesh	the Mesh object to be exported.
exportColor	true to try to export the face colors if they are stored in the Mesh object (default true).

Returns

true if no errors occur.

Referenced by DGtal::Shortcuts< TKSpace >::saveOFF(), and testMeshGeneration().

---

The documentation for this struct was generated from the following file:

• MeshWriter.h