MPhysicsProperties

API

MPhysicsConstraint* MPhysicsProperties::m_constraintNone

unsigned int MPhysicsProperties::m_shapeIdNone

unsigned int MPhysicsProperties::m_collisionObjectIdNone

M_COLLISION_SHAPE_TYPE MPhysicsProperties::m_collisionShapeNone

bool MPhysicsProperties::m_ghostNone

float MPhysicsProperties::m_massNone

float MPhysicsProperties::m_frictionNone

float MPhysicsProperties::m_restitutionNone

float MPhysicsProperties::m_linearDampingNone

float MPhysicsProperties::m_angularDampingNone

float MPhysicsProperties::m_angularFactorNone

MVector3 MPhysicsProperties::m_linearFactorNone

MPhysicsProperties::MPhysicsProperties(void)

MPhysicsProperties::MPhysicsProperties(const MPhysicsProperties &physicsProperties)

MPhysicsProperties::~MPhysicsProperties(void)

void MPhysicsProperties::deleteConstraint(void)

MPhysicsConstraint* MPhysicsProperties::createConstraint(void)

MPhysicsConstraint* MPhysicsProperties::getConstraint(void)

void MPhysicsProperties::setShapeId(unsigned int shapeId)

unsigned int MPhysicsProperties::getShapeId(void)

void MPhysicsProperties::setCollisionObjectId(unsigned int collisionObjectId)

unsigned int MPhysicsProperties::getCollisionObjectId(void)

void MPhysicsProperties::setCollisionShape(M_COLLISION_SHAPE_TYPE collisionShape)

M_COLLISION_SHAPE_TYPE MPhysicsProperties::getCollisionShape(void)

void MPhysicsProperties::setGhost(bool ghost)

bool MPhysicsProperties::isGhost(void)

void MPhysicsProperties::setMass(float mass)

float MPhysicsProperties::getMass(void)

void MPhysicsProperties::setFriction(float friction)

float MPhysicsProperties::getFriction(void)

void MPhysicsProperties::setRestitution(float restitution)

float MPhysicsProperties::getRestitution(void)

void MPhysicsProperties::setLinearDamping(float linearDamping)

float MPhysicsProperties::getLinearDamping(void)

void MPhysicsProperties::setAngularDamping(float angularDamping)

float MPhysicsProperties::getAngularDamping(void)

void MPhysicsProperties::setAngularFactor(float angularFactor)

float MPhysicsProperties::getAngularFactor(void)

void MPhysicsProperties::setLinearFactor(const MVector3 &linearFactor)

MVector3* MPhysicsProperties::getLinearFactor(void)

For detailed explanations on how to manipulate physics via code see Creating and updating physics objects.

MPhysicsProperties is a class used by MOEntity.

The class is defined in the MOEntity source code itself.

This class has and can set the MPhysicsConstraint.

MPhysicsProperties contains all the properties that will be used by the physics engine.

These properties can also be edited in the Maratis Editor.

The properties are mere value holders for the physics engine. This means that editing them when the game is already started will have no effect at all. The properties take effect only when the scene prepares the physics (MScene::preparePhysics) creating the collision objects for every entity.

However you can apply the new values using these methods of MPhysicsContext:

setObjectMass

setObjectRestitution

setObjectFriction

setObjectLinearFactor

setObjectAngularFactor

setObjectDamping

Another option is to reload all the physics properties of the entity using MScene::prepareCollisionShape and MScene::PrepareCollisionObject.

Source code

MOEntity.h

MOEntity.cpp

API

constraint

deleteConstraint

[...]

createConstraint

[...]

getConstraint

[...]

Shape ID

The ID of the shape used by MPhysicsContext. See Creating and updating physics objects.

setShapeId

[...]

getShapeId

[...]

Collision object ID

The ID of the very collision object used by MPhysicsContext. See the introduction of this page or Creating and updating physics objects.

Collision shape

setCollisionShape

[...]

getCollisionShape

[...]

Ghost

Setting the entity as a ghost disables all the physics properties (e.g. mass, friction) but the collision shape (which you can set, e.g. Box, Sphere). Constraints are also disabled.

The entity will allow you to detect collisions with other objects (because it has a physics shape) but it will not interact with them (it will just pass through, hence the name ghost).

This is generally used as a child object of another entity which is moving, so you can check if there is a collision at specific areas (e.g. feet).

If what you want is to have a static entity, you should set the mass to zero instead. See MPhysicsProperties#Mass.

setGhost

Set the entity as a ghost.

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

phyProps->setGhost(true); //set entity as ghost
phyProps->setGhost(false); //entity is no more a ghost

isGhost

Check if the entity is a ghost.

if(phyProps->isGhost())
  printf("Entity is a ghost");

Mass

The mass of the entity.

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

Setting the mass to zero makes the entity a static mesh, which means that it will be still for the entire game and objects can collide with it. This is generally used for rooms, using the collision shape "Triangle mesh" so you can have precise collisions against walls and other elements of the room.

If you want the entity to pass through other objects but still detect collisions you should use the MPhysicsProperties#Ghost property.

setMass

Set the Mass. Float type.

phyProps->setMass(5.2f);

getMass

Retrieve the Mass. Float type.

float mass = phyProp->getMass();

Friction

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

setFriction

[...]

getFriction

[...]

Restitution

Restitution is basically how much the object bounces against others.

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

setRestitution

[...]

getRestitution

[...]

Linear damping

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

setLinearDamping

[...]

getLinearDamping

[...]

Angular damping

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

setAngularDamping

[...]

getAngularDamping

[...]

Angular factor

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

setAngularFactor

[...]

getAngularFactor

[...]

Linear factor

Notice that the property is not applied until you create/update the real physics object. See Creating and updating physics objects.

setLinearFactor

[...]

getLinearFactor

[...]