Irrlicht 3D Engine
IMeshManipulator.h
Go to the documentation of this file.
1 // Copyright (C) 2002-2012 Nikolaus Gebhardt
2 // This file is part of the "Irrlicht Engine".
3 // For conditions of distribution and use, see copyright notice in irrlicht.h
4 
5 #ifndef __I_MESH_MANIPULATOR_H_INCLUDED__
6 #define __I_MESH_MANIPULATOR_H_INCLUDED__
7 
8 #include "IReferenceCounted.h"
9 #include "vector3d.h"
10 #include "aabbox3d.h"
11 #include "matrix4.h"
12 #include "IAnimatedMesh.h"
13 #include "IMeshBuffer.h"
14 #include "SVertexManipulator.h"
15 
16 namespace irr
17 {
18 namespace scene
19 {
20 
21  struct SMesh;
22 
24 
29  class IMeshManipulator : public virtual IReferenceCounted
30  {
31  public:
32 
34 
37  virtual void flipSurfaces(IMesh* mesh) const = 0;
38 
40 
42  void setVertexColorAlpha(IMesh* mesh, s32 alpha) const
43  {
45  }
46 
48 
50  void setVertexColorAlpha(IMeshBuffer* buffer, s32 alpha) const
51  {
53  }
54 
56 
58  void setVertexColors(IMesh* mesh, video::SColor color) const
59  {
61  }
62 
64 
66  void setVertexColors(IMeshBuffer* buffer, video::SColor color) const
67  {
69  }
70 
72 
75  virtual void recalculateNormals(IMesh* mesh, bool smooth = false,
76  bool angleWeighted = false) const=0;
77 
79 
82  virtual void recalculateNormals(IMeshBuffer* buffer,
83  bool smooth = false, bool angleWeighted = false) const=0;
84 
86 
91  virtual void recalculateTangents(IMesh* mesh,
92  bool recalculateNormals=false, bool smooth=false,
93  bool angleWeighted=false) const=0;
94 
96 
101  virtual void recalculateTangents(IMeshBuffer* buffer,
102  bool recalculateNormals=false, bool smooth=false,
103  bool angleWeighted=false) const=0;
104 
106 
108  void scale(IMesh* mesh, const core::vector3df& factor) const
109  {
110  apply(SVertexPositionScaleManipulator(factor), mesh, true);
111  }
112 
114 
116  void scale(IMeshBuffer* buffer, const core::vector3df& factor) const
117  {
118  apply(SVertexPositionScaleManipulator(factor), buffer, true);
119  }
120 
122 
125  _IRR_DEPRECATED_ void scaleMesh(IMesh* mesh, const core::vector3df& factor) const {return scale(mesh,factor);}
126 
128 
131  void scaleTCoords(scene::IMesh* mesh, const core::vector2df& factor, u32 level=1) const
132  {
133  apply(SVertexTCoordsScaleManipulator(factor, level), mesh);
134  }
135 
137 
140  void scaleTCoords(scene::IMeshBuffer* buffer, const core::vector2df& factor, u32 level=1) const
141  {
142  apply(SVertexTCoordsScaleManipulator(factor, level), buffer);
143  }
144 
146 
148  void transform(IMesh* mesh, const core::matrix4& m) const
149  {
151  }
152 
154 
156  void transform(IMeshBuffer* buffer, const core::matrix4& m) const
157  {
158  apply(SVertexPositionTransformManipulator(m), buffer, true);
159  }
160 
162 
165  _IRR_DEPRECATED_ virtual void transformMesh(IMesh* mesh, const core::matrix4& m) const {return transform(mesh,m);}
166 
168 
172  virtual void makePlanarTextureMapping(IMesh* mesh, f32 resolution=0.001f) const=0;
173 
175 
179  virtual void makePlanarTextureMapping(scene::IMeshBuffer* meshbuffer, f32 resolution=0.001f) const=0;
180 
182 
189  virtual void makePlanarTextureMapping(scene::IMesh* mesh,
190  f32 resolutionS, f32 resolutionT,
191  u8 axis, const core::vector3df& offset) const=0;
192 
194 
201  virtual void makePlanarTextureMapping(scene::IMeshBuffer* buffer,
202  f32 resolutionS, f32 resolutionT,
203  u8 axis, const core::vector3df& offset) const=0;
204 
206 
212  virtual SMesh* createMeshCopy(IMesh* mesh) const = 0;
213 
215 
231  virtual IMesh* createMeshWithTangents(IMesh* mesh,
232  bool recalculateNormals=false, bool smooth=false,
233  bool angleWeighted=false, bool recalculateTangents=true) const=0;
234 
236 
241  virtual IMesh* createMeshWith2TCoords(IMesh* mesh) const = 0;
242 
244 
249  virtual IMesh* createMeshWith1TCoords(IMesh* mesh) const = 0;
250 
252 
257  virtual IMesh* createMeshUniquePrimitives(IMesh* mesh) const = 0;
258 
260 
265  virtual IMesh* createMeshWelded(IMesh* mesh, f32 tolerance=core::ROUNDING_ERROR_f32) const = 0;
266 
268 
270  virtual s32 getPolyCount(IMesh* mesh) const = 0;
271 
273 
275  virtual s32 getPolyCount(IAnimatedMesh* mesh) const = 0;
276 
278 
284  virtual IAnimatedMesh * createAnimatedMesh(IMesh* mesh,
286 
288 
296  virtual IMesh* createForsythOptimizedMesh(const IMesh *mesh) const = 0;
297 
299 
303  template <typename Functor>
304  bool apply(const Functor& func, IMeshBuffer* buffer, bool boundingBoxUpdate=false) const
305  {
306  return apply_(func, buffer, boundingBoxUpdate, func);
307  }
308 
309 
311 
315  template <typename Functor>
316  bool apply(const Functor& func, IMesh* mesh, bool boundingBoxUpdate=false) const
317  {
318  if (!mesh)
319  return true;
320  bool result = true;
321  core::aabbox3df bufferbox;
322  for (u32 i=0; i<mesh->getMeshBufferCount(); ++i)
323  {
324  result &= apply(func, mesh->getMeshBuffer(i), boundingBoxUpdate);
325  if (boundingBoxUpdate)
326  {
327  if (0==i)
328  bufferbox.reset(mesh->getMeshBuffer(i)->getBoundingBox());
329  else
330  bufferbox.addInternalBox(mesh->getMeshBuffer(i)->getBoundingBox());
331  }
332  }
333  if (boundingBoxUpdate)
334  mesh->setBoundingBox(bufferbox);
335  return result;
336  }
337 
338 protected:
340 
345  template <typename Functor>
346  bool apply_(const Functor& func, IMeshBuffer* buffer, bool boundingBoxUpdate, const IVertexManipulator& typeTest) const
347  {
348  if (!buffer)
349  return true;
350 
351  core::aabbox3df bufferbox;
352  for (u32 i=0; i<buffer->getVertexCount(); ++i)
353  {
354  switch (buffer->getVertexType())
355  {
356  case video::EVT_STANDARD:
357  {
358  video::S3DVertex* verts = (video::S3DVertex*)buffer->getVertices();
359  func(verts[i]);
360  }
361  break;
362  case video::EVT_2TCOORDS:
363  {
365  func(verts[i]);
366  }
367  break;
368  case video::EVT_TANGENTS:
369  {
371  func(verts[i]);
372  }
373  break;
374  }
375  if (boundingBoxUpdate)
376  {
377  if (0==i)
378  bufferbox.reset(buffer->getPosition(0));
379  else
380  bufferbox.addInternalPoint(buffer->getPosition(i));
381  }
382  }
383  if (boundingBoxUpdate)
384  buffer->setBoundingBox(bufferbox);
385  return true;
386  }
387 };
388 
389 } // end namespace scene
390 } // end namespace irr
391 
392 
393 #endif
irr::scene::SVertexColorSetAlphaManipulator
Vertex manipulator to set the alpha value of the vertex color to a fixed value.
Definition: SVertexManipulator.h:39
irr::scene::EAMT_UNKNOWN
@ EAMT_UNKNOWN
Unknown animated mesh type.
Definition: IAnimatedMesh.h:19
irr::scene::SMesh
Simple implementation of the IMesh interface.
Definition: SMesh.h:18
irr::scene::IMeshManipulator::createAnimatedMesh
virtual IAnimatedMesh * createAnimatedMesh(IMesh *mesh, scene::E_ANIMATED_MESH_TYPE type=scene::EAMT_UNKNOWN) const =0
Create a new AnimatedMesh and adds the mesh to it.
irr::scene::SVertexTCoordsScaleManipulator
Vertex manipulator which scales the TCoords of the vertex.
Definition: SVertexManipulator.h:266
irr::scene::IMeshManipulator::apply
bool apply(const Functor &func, IMeshBuffer *buffer, bool boundingBoxUpdate=false) const
Apply a manipulator on the Meshbuffer.
Definition: IMeshManipulator.h:304
irr::scene::IMeshManipulator::createMeshWith1TCoords
virtual IMesh * createMeshWith1TCoords(IMesh *mesh) const =0
Creates a copy of the mesh, which will only consist of S3DVertex vertices.
irr::scene::IMeshManipulator::createMeshWith2TCoords
virtual IMesh * createMeshWith2TCoords(IMesh *mesh) const =0
Creates a copy of the mesh, which will only consist of S3DVertex2TCoord vertices.
irr::scene::IMeshManipulator::createMeshWelded
virtual IMesh * createMeshWelded(IMesh *mesh, f32 tolerance=core::ROUNDING_ERROR_f32) const =0
Creates a copy of a mesh with vertices welded.
irr::scene::IMeshManipulator::setVertexColorAlpha
void setVertexColorAlpha(IMesh *mesh, s32 alpha) const
Sets the alpha vertex color value of the whole mesh to a new value.
Definition: IMeshManipulator.h:42
irr::scene::IMesh::getMeshBuffer
virtual IMeshBuffer * getMeshBuffer(u32 nr) const =0
Get pointer to a mesh buffer.
irr::scene::IMeshManipulator::flipSurfaces
virtual void flipSurfaces(IMesh *mesh) const =0
Flips the direction of surfaces.
irr::scene::IMeshManipulator::recalculateTangents
virtual void recalculateTangents(IMesh *mesh, bool recalculateNormals=false, bool smooth=false, bool angleWeighted=false) const =0
Recalculates tangents, requires a tangent mesh.
irr::core::aabbox3d::reset
void reset(T x, T y, T z)
Resets the bounding box to a one-point box.
Definition: aabbox3d.h:50
irr::scene::IMeshBuffer::getVertices
virtual const void * getVertices() const =0
Get access to vertex data. The data is an array of vertices.
irr::scene::IMesh::setBoundingBox
virtual void setBoundingBox(const core::aabbox3df &box)=0
Set user-defined axis aligned bounding box.
irr::video::S3DVertex
standard vertex used by the Irrlicht engine.
Definition: S3DVertex.h:42
irr::scene::IMeshManipulator::setVertexColors
void setVertexColors(IMesh *mesh, video::SColor color) const
Sets the colors of all vertices to one color.
Definition: IMeshManipulator.h:58
irr::video::EVT_STANDARD
@ EVT_STANDARD
Standard vertex type used by the Irrlicht engine, video::S3DVertex.
Definition: S3DVertex.h:21
irr::scene::IMeshManipulator::makePlanarTextureMapping
virtual void makePlanarTextureMapping(IMesh *mesh, f32 resolution=0.001f) const =0
Creates a planar texture mapping on the mesh.
irr::scene::SVertexPositionScaleManipulator
Vertex manipulator which scales the position of the vertex.
Definition: SVertexManipulator.h:221
irr::scene::IMeshManipulator::createMeshCopy
virtual SMesh * createMeshCopy(IMesh *mesh) const =0
Clones a static IMesh into a modifiable SMesh.
IAnimatedMesh.h
irr::video::S3DVertex2TCoords
Vertex with two texture coordinates.
Definition: S3DVertex.h:108
irr::scene::IMeshBuffer::setBoundingBox
virtual void setBoundingBox(const core::aabbox3df &box)=0
Set axis aligned bounding box.
IReferenceCounted.h
irr::scene::IMeshManipulator::transform
void transform(IMesh *mesh, const core::matrix4 &m) const
Applies a transformation to a mesh.
Definition: IMeshManipulator.h:148
matrix4.h
irr::scene::SVertexPositionTransformManipulator
Vertex manipulator which transforms the position of the vertex.
Definition: SVertexManipulator.h:252
irr::scene::IMeshManipulator::scaleTCoords
void scaleTCoords(scene::IMeshBuffer *buffer, const core::vector2df &factor, u32 level=1) const
Scale the texture coords of a meshbuffer.
Definition: IMeshManipulator.h:140
irr::scene::IMeshBuffer::getPosition
virtual const core::vector3df & getPosition(u32 i) const =0
returns position of vertex i
irr::scene::IMeshManipulator::setVertexColors
void setVertexColors(IMeshBuffer *buffer, video::SColor color) const
Sets the colors of all vertices to one color.
Definition: IMeshManipulator.h:66
irr::scene::E_ANIMATED_MESH_TYPE
E_ANIMATED_MESH_TYPE
Possible types of (animated) meshes.
Definition: IAnimatedMesh.h:16
aabbox3d.h
irr::scene::IVertexManipulator
Interface for vertex manipulators.
Definition: SVertexManipulator.h:23
irr::scene::IAnimatedMesh
Interface for an animated mesh.
Definition: IAnimatedMesh.h:62
irr::scene::IMeshManipulator
An interface for easy manipulation of meshes.
Definition: IMeshManipulator.h:29
irr::core::vector2d< f32 >
irr::s32
signed int s32
32 bit signed variable.
Definition: irrTypes.h:66
irr::core::CMatrix4
4x4 matrix. Mostly used as transformation matrix for 3d calculations.
Definition: matrix4.h:45
irr::video::EVT_TANGENTS
@ EVT_TANGENTS
Vertex with a tangent and binormal vector, video::S3DVertexTangents.
Definition: S3DVertex.h:29
irr::scene::IMeshManipulator::transform
void transform(IMeshBuffer *buffer, const core::matrix4 &m) const
Applies a transformation to a meshbuffer.
Definition: IMeshManipulator.h:156
irr::video::EVT_2TCOORDS
@ EVT_2TCOORDS
Vertex with two texture coordinates, video::S3DVertex2TCoords.
Definition: S3DVertex.h:25
vector3d.h
irr::IReferenceCounted
Base class of most objects of the Irrlicht Engine.
Definition: IReferenceCounted.h:41
irr::scene::IMeshManipulator::apply_
bool apply_(const Functor &func, IMeshBuffer *buffer, bool boundingBoxUpdate, const IVertexManipulator &typeTest) const
Apply a manipulator based on the type of the functor.
Definition: IMeshManipulator.h:346
irr::scene::IMeshManipulator::scaleTCoords
void scaleTCoords(scene::IMesh *mesh, const core::vector2df &factor, u32 level=1) const
Scale the texture coords of a mesh.
Definition: IMeshManipulator.h:131
irr::f32
float f32
32 bit floating point variable.
Definition: irrTypes.h:104
irr::scene::IMeshManipulator::apply
bool apply(const Functor &func, IMesh *mesh, bool boundingBoxUpdate=false) const
Apply a manipulator on the Mesh.
Definition: IMeshManipulator.h:316
irr::scene::IMeshManipulator::createForsythOptimizedMesh
virtual IMesh * createForsythOptimizedMesh(const IMesh *mesh) const =0
Vertex cache optimization according to the Forsyth paper.
irr::scene::IMeshManipulator::getPolyCount
virtual s32 getPolyCount(IMesh *mesh) const =0
Get amount of polygons in mesh.
irr::core::aabbox3d::addInternalBox
void addInternalBox(const aabbox3d< T > &b)
Adds another bounding box.
Definition: aabbox3d.h:82
irr::scene::IMeshManipulator::createMeshUniquePrimitives
virtual IMesh * createMeshUniquePrimitives(IMesh *mesh) const =0
Creates a copy of a mesh with all vertices unwelded.
irr::scene::IMeshBuffer::getVertexType
virtual video::E_VERTEX_TYPE getVertexType() const =0
Get type of vertex data which is stored in this meshbuffer.
irr::scene::IMeshManipulator::scaleMesh
_IRR_DEPRECATED_ void scaleMesh(IMesh *mesh, const core::vector3df &factor) const
Scales the actual mesh, not a scene node.
Definition: IMeshManipulator.h:125
irr::scene::IMeshBuffer::getBoundingBox
virtual const core::aabbox3df & getBoundingBox() const =0
Get the axis aligned bounding box of this meshbuffer.
irr::scene::IMesh
Class which holds the geometry of an object.
Definition: IMesh.h:23
irr::core::ROUNDING_ERROR_f32
const f32 ROUNDING_ERROR_f32
Definition: irrMath.h:49
irr::scene::IMeshManipulator::scale
void scale(IMesh *mesh, const core::vector3df &factor) const
Scales the actual mesh, not a scene node.
Definition: IMeshManipulator.h:108
irr
Everything in the Irrlicht Engine can be found in this namespace.
Definition: aabbox3d.h:12
irr::scene::IMeshManipulator::setVertexColorAlpha
void setVertexColorAlpha(IMeshBuffer *buffer, s32 alpha) const
Sets the alpha vertex color value of the whole mesh to a new value.
Definition: IMeshManipulator.h:50
irr::scene::IMeshManipulator::recalculateNormals
virtual void recalculateNormals(IMesh *mesh, bool smooth=false, bool angleWeighted=false) const =0
Recalculates all normals of the mesh.
irr::scene::IMeshManipulator::scale
void scale(IMeshBuffer *buffer, const core::vector3df &factor) const
Scales the actual meshbuffer, not a scene node.
Definition: IMeshManipulator.h:116
irr::u32
unsigned int u32
32 bit unsigned variable.
Definition: irrTypes.h:58
IMeshBuffer.h
irr::core::aabbox3d::addInternalPoint
void addInternalPoint(const vector3d< T > &p)
Adds a point to the bounding box.
Definition: aabbox3d.h:74
irr::scene::IMesh::getMeshBufferCount
virtual u32 getMeshBufferCount() const =0
Get the amount of mesh buffers.
irr::scene::IMeshManipulator::createMeshWithTangents
virtual IMesh * createMeshWithTangents(IMesh *mesh, bool recalculateNormals=false, bool smooth=false, bool angleWeighted=false, bool recalculateTangents=true) const =0
Creates a copy of the mesh, which will only consist of S3DVertexTangents vertices.
irr::scene::IMeshManipulator::transformMesh
virtual _IRR_DEPRECATED_ void transformMesh(IMesh *mesh, const core::matrix4 &m) const
Applies a transformation to a mesh.
Definition: IMeshManipulator.h:165
irr::scene::IMeshBuffer::getVertexCount
virtual u32 getVertexCount() const =0
Get amount of vertices in meshbuffer.
_IRR_DEPRECATED_
#define _IRR_DEPRECATED_
Defines a deprecated macro which generates a warning at compile time.
Definition: irrTypes.h:195
irr::core::aabbox3d< f32 >
irr::scene::IMeshBuffer
Struct for holding a mesh with a single material.
Definition: IMeshBuffer.h:39
irr::video::SColor
Class representing a 32 bit ARGB color.
Definition: SColor.h:201
irr::video::S3DVertexTangents
Vertex with a tangent and binormal vector.
Definition: S3DVertex.h:185
irr::scene::SVertexColorSetManipulator
Vertex manipulator to set color to a fixed color for all vertices.
Definition: SVertexManipulator.h:27
irr::core::vector3d< f32 >
SVertexManipulator.h
irr::u8
unsigned char u8
8 bit unsigned variable.
Definition: irrTypes.h:18