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:

[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:

- OgreRefAppJoint.h
- OgreRefAppJoint.cpp

Copyright © 2002-2003 by The OGRE Team
Last modified Sun Nov 28 19:51:58 2004