becd467be8
rayCast(to,from,dist,prop,face,xray,poly):
The face paremeter determines the orientation of the normal:
0 or omitted => hit normal is always oriented towards the ray origin (as if you casted the ray from outside)
1 => hit normal is the real face normal (only for mesh object, otherwise face has no effect)
The ray has X-Ray capability if xray parameter is 1, otherwise the first object hit (other than self object) stops the ray.
The prop and xray parameters interact as follow:
prop off, xray off: return closest hit or no hit if there is no object on the full extend of the ray.
prop off, xray on : idem.
prop on, xray off: return closest hit if it matches prop, no hit otherwise.
prop on, xray on : return closest hit matching prop or no hit if there is no object matching prop on the full extend of the ray.
if poly is 0 or omitted, returns a 3-tuple with object reference, hit point and hit normal or (None,None,None) if no hit.
if poly is 1, returns a 4-tuple with in addition a KX_PolyProxy as 4th element.
The KX_PolyProxy object holds information on the polygon hit by the ray: the index of the vertex forming the poylgon, material, etc.
Attributes (read-only):
matname: The name of polygon material, empty if no material.
material: The material of the polygon
texture: The texture name of the polygon.
matid: The material index of the polygon, use this to retrieve vertex proxy from mesh proxy
v1: vertex index of the first vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
v2: vertex index of the second vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
v3: vertex index of the third vertex of the polygon, use this to retrieve vertex proxy from mesh proxy
v4: vertex index of the fourth vertex of the polygon, 0 if polygon has only 3 vertex
use this to retrieve vertex proxy from mesh proxy
visible: visible state of the polygon: 1=visible, 0=invisible
collide: collide state of the polygon: 1=receives collision, 0=collision free.
Methods:
getMaterialName(): Returns the polygon material name with MA prefix
getMaterial(): Returns the polygon material
getTextureName(): Returns the polygon texture name
getMaterialIndex(): Returns the material bucket index of the polygon.
getNumVertex(): Returns the number of vertex of the polygon.
isVisible(): Returns whether the polygon is visible or not
isCollider(): Returns whether the polygon is receives collision or not
getVertexIndex(vertex): Returns the mesh vertex index of a polygon vertex
getMesh(): Returns a mesh proxy
New methods of KX_MeshProxy have been implemented to retrieve KX_PolyProxy objects:
getNumPolygons(): Returns the number of polygon in the mesh.
getPolygon(index): Gets the specified polygon from the mesh.
More details in PyDoc.
94 lines
3.0 KiB
C++
94 lines
3.0 KiB
C++
/**
|
|
* $Id$
|
|
*
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
|
*
|
|
* The contents of this file may be used under the terms of either the GNU
|
|
* General Public License Version 2 or later (the "GPL", see
|
|
* http://www.gnu.org/licenses/gpl.html ), or the Blender License 1.0 or
|
|
* later (the "BL", see http://www.blender.org/BL/ ) which has to be
|
|
* bought from the Blender Foundation to become active, in which case the
|
|
* above mentioned GPL option does not apply.
|
|
*
|
|
* The Original Code is Copyright (C) 2002 by NaN Holding BV.
|
|
* All rights reserved.
|
|
*
|
|
* The Original Code is: all of this file.
|
|
*
|
|
* Contributor(s): none yet.
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
#ifndef _ODEPHYSICSENVIRONMENT
|
|
#define _ODEPHYSICSENVIRONMENT
|
|
|
|
|
|
#include "PHY_IPhysicsEnvironment.h"
|
|
|
|
/**
|
|
* Physics Environment takes care of stepping the simulation and is a container for physics entities (rigidbodies,constraints, materials etc.)
|
|
* A derived class may be able to 'construct' entities by loading and/or converting
|
|
*/
|
|
class ODEPhysicsEnvironment : public PHY_IPhysicsEnvironment
|
|
{
|
|
|
|
bool m_useFixedTimeStep;
|
|
float m_fixedTimeStep;
|
|
float m_currentTime;
|
|
|
|
public:
|
|
ODEPhysicsEnvironment();
|
|
virtual ~ODEPhysicsEnvironment();
|
|
virtual void beginFrame() {}
|
|
virtual void endFrame() {}
|
|
|
|
|
|
// Perform an integration step of duration 'timeStep'.
|
|
virtual bool proceedDeltaTime(double curTime,float timeStep);
|
|
virtual void setFixedTimeStep(bool useFixedTimeStep,float fixedTimeStep);
|
|
virtual float getFixedTimeStep();
|
|
|
|
virtual void setGravity(float x,float y,float z);
|
|
virtual int createConstraint(class PHY_IPhysicsController* ctrl,class PHY_IPhysicsController* ctrl2,PHY_ConstraintType type,
|
|
float pivotX,float pivotY,float pivotZ,
|
|
float axisX,float axisY,float axisZ);
|
|
|
|
virtual void removeConstraint(void * constraintid);
|
|
virtual PHY_IPhysicsController* rayTest(PHY_IRayCastFilterCallback &filterCallback,float fromX,float fromY,float fromZ, float toX,float toY,float toZ);
|
|
|
|
|
|
//gamelogic callbacks
|
|
virtual void addSensor(PHY_IPhysicsController* ctrl) {}
|
|
virtual void removeSensor(PHY_IPhysicsController* ctrl) {}
|
|
virtual void addTouchCallback(int response_class, PHY_ResponseCallback callback, void *user)
|
|
{
|
|
}
|
|
virtual void requestCollisionCallback(PHY_IPhysicsController* ctrl) {}
|
|
virtual void removeCollisionCallback(PHY_IPhysicsController* ctrl) {}
|
|
virtual PHY_IPhysicsController* CreateSphereController(float radius,const PHY__Vector3& position) {return 0;}
|
|
virtual PHY_IPhysicsController* CreateConeController(float coneradius,float coneheight) { return 0;}
|
|
|
|
|
|
|
|
struct dxWorld* GetOdeWorld() { return m_OdeWorld; };
|
|
struct dxSpace* GetOdeSpace() { return m_OdeSpace;};
|
|
|
|
private:
|
|
|
|
|
|
// ODE physics response
|
|
struct dxWorld* m_OdeWorld;
|
|
// ODE collision detection
|
|
struct dxSpace* m_OdeSpace;
|
|
void ClearOdeContactGroup();
|
|
struct dxJointGroup* m_OdeContactGroup;
|
|
struct dxJointGroup* m_JointGroup;
|
|
|
|
static void OdeNearCallback(void *data, struct dxGeom* o1, struct dxGeom* o2);
|
|
int GetNumOdeContacts();
|
|
|
|
};
|
|
|
|
#endif //_ODEPHYSICSENVIRONMENT
|
|
|