Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Related Pages  

OgreRefApp::Joint Class Reference

Represents a linkage between application objects or between them and the world, enforcing certain constraints. More...

#include <OgreRefAppJoint.h>

Inheritance diagram for OgreRefApp::Joint:

Inheritance graph
[legend]
List of all members.

Public Types

enum  JointType {
  JT_BALL, JT_SLIDER, JT_HINGE, JT_UNIVERSAL,
  JT_HINGE2
}
 The type of joint. More...


Public Methods

 Joint (JointType jtype)
 Constructor, however you should use World::createJoint(type, obj1, obj2).

virtual ~Joint ()
JointType getType (void)
 Returns the type of this joint.

virtual void setAnchorPosition (const Vector3 &point)=0
 Set the anchor point of this joint.

virtual const Vector3 & getAnchorPosition (void)
 Gets the anchor position of this joint.

virtual const std::pair< ApplicationObject *,
ApplicationObject * > & 
getAttachments (void)
 Gets the attached objects, a NULL means no object ie a static attachment.

virtual void setAxes (const Vector3 &primaryAxis, const Vector3 &secondaryAxis=Vector3::ZERO)=0
 Sets the axes for this joint.

virtual const std::pair< Vector3,
Vector3 > & 
getAxes (void)
 Gets the axes of this joint.


Protected Methods

void setAttachments (ApplicationObject *obj1, ApplicationObject *obj2)
 Sets the objects attached to this joint.


Protected Attributes

JointType mType
Vector3 mAnchor
std::pair< ApplicationObject *,
ApplicationObject * > 
mAttachedObjects
std::pair< Vector3, Vector3 > mAxes
dJoint * mOdeJoint

Detailed Description

Represents a linkage between application objects or between them and the world, enforcing certain constraints.

Remarks:
Joints can be used to link application objects together, or to link them to a static point in the world according to certain constraints. You should create joints using World::createJoint. You should then set certain global options, like it's world anchor position, before attaching it to application objects. You application objects should already be positioned how you would like relative to the joint anchor, since once they are attached, they will be constrained by it.

Definition at line 42 of file OgreRefAppJoint.h.


Member Enumeration Documentation

enum OgreRefApp::Joint::JointType
 

The type of joint.

Enumeration values:
JT_BALL  Ball & socket joint, has 3 degrees of freedom.
JT_SLIDER  Sliding joint, 1 degree of freedom (in-out).
JT_HINGE  Hinge joint, 1 degree of freedom.
JT_UNIVERSAL  Universal joint, like a double-hinge, 2 degrees of freedom.
JT_HINGE2  2 hinges in series, like the axel of a car

Definition at line 46 of file OgreRefAppJoint.h.


Constructor & Destructor Documentation

OgreRefApp::Joint::Joint JointType    jtype
 

Constructor, however you should use World::createJoint(type, obj1, obj2).

Definition at line 31 of file OgreRefAppJoint.cpp.

References mAxes.

virtual OgreRefApp::Joint::~Joint   [virtual]
 

Definition at line 60 of file OgreRefAppJoint.h.


Member Function Documentation

const Vector3 & OgreRefApp::Joint::getAnchorPosition void    [virtual]
 

Gets the anchor position of this joint.

Definition at line 46 of file OgreRefAppJoint.cpp.

References mAnchor.

const std::pair< ApplicationObject *, ApplicationObject * > & OgreRefApp::Joint::getAttachments void    [virtual]
 

Gets the attached objects, a NULL means no object ie a static attachment.

Definition at line 73 of file OgreRefAppJoint.cpp.

References mAttachedObjects.

const std::pair< Vector3, Vector3 > & OgreRefApp::Joint::getAxes void    [virtual]
 

Gets the axes of this joint.

Definition at line 79 of file OgreRefAppJoint.cpp.

References mAxes.

Joint::JointType OgreRefApp::Joint::getType void   
 

Returns the type of this joint.

Definition at line 41 of file OgreRefAppJoint.cpp.

References mType.

virtual void OgreRefApp::Joint::setAnchorPosition const Vector3 &    point [pure virtual]
 

Set the anchor point of this joint.

Remarks:
Sets the location, in world space, of the anchor point of this joint, which is usually the hinge point or just the origin of joint. It has no meaning for JT_SLIDER and thus you don't need to call it for that.

Implemented in OgreRefApp::BallJoint, OgreRefApp::SliderJoint, OgreRefApp::HingeJoint, OgreRefApp::UniversalJoint, and OgreRefApp::Hinge2Joint.

void OgreRefApp::Joint::setAttachments ApplicationObject   obj1,
ApplicationObject   obj2
[protected]
 

Sets the objects attached to this joint.

Remarks:
It appears that this has to be set before other joint params like anchor etc, otherwise the joint does not behave. Therefore it is internal and is called during construction.

Definition at line 51 of file OgreRefAppJoint.cpp.

References OgreRefApp::ApplicationObject::getOdeBody(), mAttachedObjects, and mOdeJoint.

Referenced by OgreRefApp::BallJoint::BallJoint(), OgreRefApp::Hinge2Joint::Hinge2Joint(), OgreRefApp::HingeJoint::HingeJoint(), OgreRefApp::SliderJoint::SliderJoint(), and OgreRefApp::UniversalJoint::UniversalJoint().

virtual void OgreRefApp::Joint::setAxes const Vector3 &    primaryAxis,
const Vector3 &    secondaryAxis = Vector3::ZERO
[pure virtual]
 

Sets the axes for this joint.

Remarks:
The meaning of axes for a joint depends on it's type:
  • For JT_BALL, it has no meaning and you don't need to call it.
  • For JT_SLIDER, only one is applicable and it's the axis along which the slide occurs.
  • For JT_HINGE, only one is applicable and it's the hinge axis.
  • For JT_UNIVERSAL, and JT_HINGE2 it's the 2 hinge axes.

Implemented in OgreRefApp::BallJoint, OgreRefApp::SliderJoint, OgreRefApp::HingeJoint, OgreRefApp::UniversalJoint, and OgreRefApp::Hinge2Joint.


Member Data Documentation

Vector3 OgreRefApp::Joint::mAnchor [protected]
 

Definition at line 106 of file OgreRefAppJoint.h.

Referenced by getAnchorPosition(), OgreRefApp::Hinge2Joint::setAnchorPosition(), OgreRefApp::UniversalJoint::setAnchorPosition(), OgreRefApp::HingeJoint::setAnchorPosition(), and OgreRefApp::BallJoint::setAnchorPosition().

std::pair<ApplicationObject*, ApplicationObject*> OgreRefApp::Joint::mAttachedObjects [protected]
 

Definition at line 107 of file OgreRefAppJoint.h.

Referenced by getAttachments(), and setAttachments().

std::pair<Vector3, Vector3> OgreRefApp::Joint::mAxes [protected]
 

Definition at line 108 of file OgreRefAppJoint.h.

Referenced by getAxes(), Joint(), OgreRefApp::Hinge2Joint::setAxes(), OgreRefApp::UniversalJoint::setAxes(), OgreRefApp::HingeJoint::setAxes(), and OgreRefApp::SliderJoint::setAxes().

dJoint* OgreRefApp::Joint::mOdeJoint [protected]
 

Definition at line 111 of file OgreRefAppJoint.h.

Referenced by OgreRefApp::BallJoint::BallJoint(), OgreRefApp::Hinge2Joint::Hinge2Joint(), OgreRefApp::HingeJoint::HingeJoint(), setAttachments(), OgreRefApp::SliderJoint::SliderJoint(), and OgreRefApp::UniversalJoint::UniversalJoint().

JointType OgreRefApp::Joint::mType [protected]
 

Definition at line 105 of file OgreRefAppJoint.h.

Referenced by getType().


The documentation for this class was generated from the following files:

Copyright © 2002-2003 by The OGRE Team
Last modified Fri May 14 23:27:47 2004