2011-02-22 12:42:55 +00:00
|
|
|
/*
|
2002-10-12 11:37:38 +00:00
|
|
|
* $Id$
|
|
|
|
*
|
2008-04-16 22:40:48 +00:00
|
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
2008-04-16 22:40:48 +00:00
|
|
|
* of the License, or (at your option) any later version.
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software Foundation,
|
2010-02-12 13:34:04 +00:00
|
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* The Original Code is: all of this file.
|
|
|
|
*
|
|
|
|
* Contributor(s): none yet.
|
|
|
|
*
|
2008-04-16 22:40:48 +00:00
|
|
|
* ***** END GPL LICENSE BLOCK *****
|
2002-10-12 11:37:38 +00:00
|
|
|
*/
|
|
|
|
|
2011-02-22 12:42:55 +00:00
|
|
|
/** \file RAS_Deformer.h
|
|
|
|
* \ingroup bgerast
|
|
|
|
*/
|
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
#ifndef RAS_DEFORMER
|
|
|
|
#define RAS_DEFORMER
|
|
|
|
|
2010-09-15 16:13:32 +00:00
|
|
|
#if defined(WIN32) && !defined(FREE_WINDOWS)
|
2002-10-12 11:37:38 +00:00
|
|
|
#pragma warning (disable:4786) // get rid of stupid stl-visual compiler debug warning
|
|
|
|
#endif //WIN32
|
|
|
|
|
2009-05-14 13:47:08 +00:00
|
|
|
#include <stdlib.h>
|
2011-05-06 20:18:42 +00:00
|
|
|
#include "CTR_Map.h"
|
2002-10-12 11:37:38 +00:00
|
|
|
|
2009-08-18 15:37:31 +00:00
|
|
|
#ifdef WITH_CXX_GUARDEDALLOC
|
|
|
|
#include "MEM_guardedalloc.h"
|
|
|
|
#endif
|
|
|
|
|
2009-05-14 13:47:08 +00:00
|
|
|
struct DerivedMesh;
|
2009-07-25 22:57:29 +00:00
|
|
|
class RAS_MeshObject;
|
2009-05-14 13:47:08 +00:00
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
class RAS_Deformer
|
|
|
|
{
|
|
|
|
public:
|
2009-05-14 13:47:08 +00:00
|
|
|
RAS_Deformer() : m_pMesh(NULL), m_bDynamic(false) {};
|
2002-10-12 11:37:38 +00:00
|
|
|
virtual ~RAS_Deformer(){};
|
2011-05-06 20:18:42 +00:00
|
|
|
virtual void Relink(CTR_Map<class CTR_HashedPtr, void*>*map)=0;
|
2002-10-12 11:37:38 +00:00
|
|
|
virtual bool Apply(class RAS_IPolyMaterial *polymat)=0;
|
2008-06-18 06:46:49 +00:00
|
|
|
virtual bool Update(void)=0;
|
2009-04-25 12:20:59 +00:00
|
|
|
virtual bool UpdateBuckets(void)=0;
|
2009-04-22 16:26:22 +00:00
|
|
|
virtual RAS_Deformer *GetReplica()=0;
|
|
|
|
virtual void ProcessReplica()=0;
|
2008-09-25 21:04:41 +00:00
|
|
|
virtual bool SkipVertexTransform()
|
|
|
|
{
|
|
|
|
return false;
|
|
|
|
}
|
2009-05-19 06:48:36 +00:00
|
|
|
virtual bool ShareVertexArray()
|
|
|
|
{
|
|
|
|
return true;
|
|
|
|
}
|
BGE: Support mesh modifiers in the game engine.
Realtime modifiers applied on mesh objects will be supported in
the game engine with the following limitations:
- Only real time modifiers are supported (basically all of them!)
- Virtual modifiers resulting from parenting are not supported:
armature, curve, lattice. You can still use these modifiers
(armature is really not recommended) but in non parent mode.
The BGE has it's own parenting capability for armature.
- Modifiers are computed on the host (using blender modifier
stack).
- Modifiers are statically evaluated: any possible time dependency
in the modifiers is not supported (don't know enough about
modifiers to be more specific).
- Modifiers are reevaluated if the underlying mesh is deformed
due to shape action or armature action. Beware that this is
very CPU intensive; modifiers should really be used for static
objects only.
- Physics is still based on the original mesh: if you have a
mirror modifier, the physic shape will be limited to one half
of the resulting object. Therefore, the modifiers should
preferably be used on graphic objects.
- Scripts have no access to the modified mesh.
- Modifiers that are based on objects interaction (boolean,..)
will not be dependent on the objects position in the GE.
What you see in the 3D view is what you get in the GE regardless
on the object position, velocity, etc.
Besides that, the feature is compatible with all the BGE features
that affect meshes: armature action, shape action, relace mesh,
VideoTexture, add object, dupligroup.
Known problems:
- This feature is a bit hacky: the BGE uses the derived mesh draw
functions to display the object. This drawing method is a
bit slow and is not 100% compatible with the BGE. There may
be some problems in multi-texture mode: the multi-texture
coordinates are not sent to the GPU.
Texface and GLSL on the other hand should be fully supported.
- Culling is still based on the extend of the original mesh.
If you have a modifer that extends the size of the mesh,
the object may disappear while still in the view frustrum.
- Derived mesh is not shared between replicas.
The derived mesh is allocated and computed for each object
with modifiers, regardless if they are static replicas.
- Display list are not created on objects with modifiers.
I should be able to fix the above problems before release.
However, the feature is already useful for game development.
Once you are ready to release the game, you can apply the modifiers
to get back display list support and mesh sharing capability.
MSVC, scons, Cmake, makefile updated.
Enjoy
/benoit
2009-04-21 11:01:09 +00:00
|
|
|
virtual bool UseVertexArray()
|
|
|
|
{
|
|
|
|
return true;
|
|
|
|
}
|
2009-05-12 19:48:18 +00:00
|
|
|
// true when deformer produces varying vertex (shape or armature)
|
|
|
|
bool IsDynamic()
|
|
|
|
{
|
|
|
|
return m_bDynamic;
|
|
|
|
}
|
2009-05-14 13:47:08 +00:00
|
|
|
virtual struct DerivedMesh* GetFinalMesh()
|
|
|
|
{
|
|
|
|
return NULL;
|
|
|
|
}
|
2011-01-23 17:17:21 +00:00
|
|
|
virtual struct DerivedMesh* GetPhysicsMesh()
|
|
|
|
{
|
|
|
|
return NULL;
|
|
|
|
}
|
2009-07-25 22:57:29 +00:00
|
|
|
virtual class RAS_MeshObject* GetRasMesh()
|
|
|
|
{
|
|
|
|
/* m_pMesh does not seem to be being used?? */
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
virtual float (* GetTransVerts(int *tot))[3] { *tot= 0; return NULL; }
|
2009-05-14 13:47:08 +00:00
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
protected:
|
|
|
|
class RAS_MeshObject *m_pMesh;
|
2009-05-12 19:48:18 +00:00
|
|
|
bool m_bDynamic;
|
2009-08-18 15:37:31 +00:00
|
|
|
|
|
|
|
#ifdef WITH_CXX_GUARDEDALLOC
|
|
|
|
public:
|
2010-06-06 01:15:44 +00:00
|
|
|
void *operator new(size_t num_bytes) { return MEM_mallocN(num_bytes, "GE:RAS_Deformer"); }
|
2009-08-18 15:37:31 +00:00
|
|
|
void operator delete( void *mem ) { MEM_freeN(mem); }
|
|
|
|
#endif
|
2002-10-12 11:37:38 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|
|
|
|
|