DART
6.10.1
|
The FixedFrame class represents a Frame with zero relative velocity and zero relative acceleration. More...
#include <FixedFrame.hpp>
Public Types | |
using | EntitySignal = common::Signal< void(const Entity *)> |
using | FrameChangedSignal = common::Signal< void(const Entity *, const Frame *_oldFrame, const Frame *_newFrame)> |
using | NameChangedSignal = common::Signal< void(const Entity *, const std::string &_oldName, const std::string &_newName)> |
using | Derived = FixedFrame |
using | Aspect = common::EmbeddedPropertiesAspect< Derived, detail::FixedFrameProperties > |
using | AspectProperties = typename Aspect::Properties |
using | AspectPropertiesData = typename Aspect::PropertiesData |
using | Base = common::RequiresAspect< Aspect > |
Public Member Functions | |
FixedFrame (Frame *refFrame, const Eigen::Isometry3d &relativeTransform=Eigen::Isometry3d::Identity()) | |
Constructor. More... | |
virtual | ~FixedFrame () |
Destructor. More... | |
void | setAspectProperties (const AspectProperties &properties) |
Set the AspectProperties of this FixedFrame. More... | |
virtual void | setRelativeTransform (const Eigen::Isometry3d &transform) |
Set the relative transform of this FixedFrame. More... | |
const Eigen::Isometry3d & | getRelativeTransform () const override |
Get the transform of this Frame with respect to its parent Frame. More... | |
const Eigen::Vector6d & | getRelativeSpatialVelocity () const override |
Always returns a zero vector. More... | |
const Eigen::Vector6d & | getRelativeSpatialAcceleration () const override |
Always returns a zero vector. More... | |
const Eigen::Vector6d & | getPrimaryRelativeAcceleration () const override |
Always returns a zero vector. More... | |
const Eigen::Vector6d & | getPartialAcceleration () const override |
Always returns a zero vector. More... | |
const Eigen::Isometry3d & | getWorldTransform () const |
Get the transform of this Frame with respect to the World Frame. More... | |
Eigen::Isometry3d | getTransform (const Frame *_withRespectTo=Frame::World()) const |
Get the transform of this Frame with respect to some other Frame. More... | |
Eigen::Isometry3d | getTransform (const Frame *withRespectTo, const Frame *inCoordinatesOf) const |
Get the transform of this Frame with respect to some other Frame. More... | |
const Eigen::Vector6d & | getSpatialVelocity () const |
Get the total spatial velocity of this Frame in the coordinates of this Frame. More... | |
Eigen::Vector6d | getSpatialVelocity (const Frame *_relativeTo, const Frame *_inCoordinatesOf) const |
Get the spatial velocity of this Frame relative to some other Frame. More... | |
Eigen::Vector6d | getSpatialVelocity (const Eigen::Vector3d &_offset) const |
Get the spatial velocity of a fixed point in this Frame. More... | |
Eigen::Vector6d | getSpatialVelocity (const Eigen::Vector3d &_offset, const Frame *_relativeTo, const Frame *_inCoordinatesOf) const |
Get the spatial velocity of a fixed point in this Frame. More... | |
Eigen::Vector3d | getLinearVelocity (const Frame *_relativeTo=Frame::World(), const Frame *_inCoordinatesOf=Frame::World()) const |
Get the linear portion of classical velocity of this Frame relative to some other Frame. More... | |
Eigen::Vector3d | getLinearVelocity (const Eigen::Vector3d &_offset, const Frame *_relativeTo=Frame::World(), const Frame *_inCoordinatesOf=Frame::World()) const |
Get the linear velocity of a point that is fixed in this Frame. More... | |
Eigen::Vector3d | getAngularVelocity (const Frame *_relativeTo=Frame::World(), const Frame *_inCoordinatesOf=Frame::World()) const |
Get the angular portion of classical velocity of this Frame relative to some other Frame. More... | |
const Eigen::Vector6d & | getSpatialAcceleration () const |
Get the total spatial acceleration of this Frame in the coordinates of this Frame. More... | |
Eigen::Vector6d | getSpatialAcceleration (const Frame *_relativeTo, const Frame *_inCoordinatesOf) const |
Get the spatial acceleration of this Frame relative to some other Frame. More... | |
Eigen::Vector6d | getSpatialAcceleration (const Eigen::Vector3d &_offset) const |
Get the spatial acceleration of a fixed point in this Frame. More... | |
Eigen::Vector6d | getSpatialAcceleration (const Eigen::Vector3d &_offset, const Frame *_relativeTo, const Frame *_inCoordinatesOf) const |
Get the spatial acceleration of a fixed point in this Frame. More... | |
Eigen::Vector3d | getLinearAcceleration (const Frame *_relativeTo=Frame::World(), const Frame *_inCoordinatesOf=Frame::World()) const |
Get the linear portion of classical acceleration of this Frame relative to some other Frame. More... | |
Eigen::Vector3d | getLinearAcceleration (const Eigen::Vector3d &_offset, const Frame *_relativeTo=Frame::World(), const Frame *_inCoordinatesOf=Frame::World()) const |
Eigen::Vector3d | getAngularAcceleration (const Frame *_relativeTo=Frame::World(), const Frame *_inCoordinatesOf=Frame::World()) const |
Get the angular portion of classical acceleration of this Frame relative to some other Frame. More... | |
const std::set< Entity * > & | getChildEntities () |
Get a container with the Entities that are children of this Frame. More... | |
const std::set< const Entity * > | getChildEntities () const |
Get a container with the Entities that are children of this Frame. More... | |
std::size_t | getNumChildEntities () const |
Get the number of Entities that are currently children of this Frame. More... | |
const std::set< Frame * > & | getChildFrames () |
Get a container with the Frames that are children of this Frame. More... | |
std::set< const Frame * > | getChildFrames () const |
Get a container with the Frames that are children of this Frame. More... | |
std::size_t | getNumChildFrames () const |
Get the number of Frames that are currently children of this Frame. More... | |
bool | isShapeFrame () const |
Returns true if this Frame is a ShapeFrame. More... | |
virtual ShapeFrame * | asShapeFrame () |
Convert 'this' into a ShapeFrame pointer if Frame is a ShapeFrame, otherwise return nullptr. More... | |
virtual const ShapeFrame * | asShapeFrame () const |
Convert 'const this' into a ShapeFrame pointer if Frame is a ShapeFrame, otherwise return nullptr. More... | |
bool | isWorld () const |
Returns true if this Frame is the World Frame. More... | |
virtual void | dirtyTransform () override |
Notify the transformation updates of this Frame and all its children are needed. More... | |
virtual void | dirtyVelocity () override |
Notify the velocity updates of this Frame and all its children are needed. More... | |
virtual void | dirtyAcceleration () override |
Notify the acceleration updates of this Frame and all its children are needed. More... | |
virtual const std::string & | setName (const std::string &_name)=0 |
Set name. More... | |
virtual const std::string & | getName () const =0 |
Return the name of this Entity. More... | |
Frame * | getParentFrame () |
Get the parent (reference) frame of this Entity. More... | |
const Frame * | getParentFrame () const |
Get the parent (reference) frame of this Entity. More... | |
bool | descendsFrom (const Frame *_someFrame) const |
Returns true if and only if this Entity is itself (i.e. More... | |
bool | isFrame () const |
True iff this Entity is also a Frame. More... | |
bool | isQuiet () const |
Returns true if this Entity is set to be quiet. More... | |
virtual void | notifyTransformUpdate () |
Notify the transformation update of this Entity that its parent Frame's pose is needed. More... | |
bool | needsTransformUpdate () const |
Returns true iff a transform update is needed for this Entity. More... | |
virtual void | notifyVelocityUpdate () |
Notify the velocity update of this Entity that its parent Frame's velocity is needed. More... | |
bool | needsVelocityUpdate () const |
Returns true iff a velocity update is needed for this Entity. More... | |
virtual void | notifyAccelerationUpdate () |
Notify the acceleration of this Entity that its parent Frame's acceleration is needed. More... | |
bool | needsAccelerationUpdate () const |
Returns true iff an acceleration update is needed for this Entity. More... | |
virtual std::size_t | incrementVersion () |
Increment the version for this object. More... | |
virtual std::size_t | getVersion () const |
Get the version number of this object. More... | |
const AspectProperties & | getAspectProperties () const |
Static Public Member Functions | |
static Frame * | World () |
static std::shared_ptr< Frame > | WorldShared () |
Protected Types | |
enum | ConstructAbstractTag { ConstructAbstract } |
Used when constructing a pure abstract class, because calling the Frame constructor is just a formality. More... | |
enum | ConstructFrameTag { ConstructFrame } |
Used when constructing a Frame class, because the Frame constructor will take care of setting up the parameters you pass into it. More... | |
Protected Member Functions | |
FixedFrame () | |
Default constructor – calls the Abstract constructor. More... | |
FixedFrame (ConstructAbstractTag) | |
Abstract constructor. More... | |
virtual void | changeParentFrame (Frame *_newParentFrame) override |
Used by derived classes to change their parent frames. More... | |
virtual void | processNewEntity (Entity *_newChildEntity) |
Called during a parent Frame change to allow extensions of the Frame class to handle new children in customized ways. More... | |
virtual void | processRemovedEntity (Entity *_oldChildEntity) |
Called when a child Entity is removed from its parent Frame. More... | |
void | sendDestructionNotification () const |
Send a destruction notification to all Observers. More... | |
void | addObserver (Observer *_observer) const |
Add an Observer to the list of Observers. More... | |
void | removeObserver (Observer *_observer) const |
Remove an Observer from the list of Observers. More... | |
void | setVersionDependentObject (VersionCounter *dependent) |
Protected Attributes | |
Eigen::Isometry3d | mWorldTransform |
World transform of this Frame. More... | |
Eigen::Vector6d | mVelocity |
Total velocity of this Frame, in the coordinates of this Frame. More... | |
Eigen::Vector6d | mAcceleration |
Total acceleration of this Frame, in the coordinates of this Frame. More... | |
std::set< Frame * > | mChildFrames |
Container of this Frame's child Frames. More... | |
std::set< Entity * > | mChildEntities |
Container of this Frame's child Entities. More... | |
Frame * | mParentFrame |
Parent frame of this Entity. More... | |
bool | mNeedTransformUpdate |
Does this Entity need a Transform update. More... | |
bool | mNeedVelocityUpdate |
Does this Entity need a Velocity update. More... | |
bool | mNeedAccelerationUpdate |
Does this Entity need an Acceleration update. More... | |
FrameChangedSignal | mFrameChangedSignal |
Frame changed signal. More... | |
NameChangedSignal | mNameChangedSignal |
Name changed signal. More... | |
EntitySignal | mTransformUpdatedSignal |
Transform changed signal. More... | |
EntitySignal | mVelocityChangedSignal |
Velocity changed signal. More... | |
EntitySignal | mAccelerationChangedSignal |
Acceleration changed signal. More... | |
std::set< Observer * > | mObservers |
List of current Observers. More... | |
std::size_t | mVersion |
AspectProperties | mAspectProperties |
Aspect::Properties data, directly accessible to your derived class. More... | |
Static Protected Attributes | |
static const Eigen::Vector6d | mZero = Eigen::Vector6d::Zero() |
Used for Relative Velocity and Relative Acceleration of this Frame. More... | |
Private Types | |
enum | ConstructWorldTag { ConstructWorld } |
Used when constructing the World. More... | |
Private Attributes | |
const bool | mAmWorld |
Contains whether or not this is the World Frame. More... | |
bool | mAmShapeFrame |
Contains whether or not this is a ShapeFrame. More... | |
VersionCounter * | mDependent |
Slot registers | |
const bool | mAmQuiet |
Whether or not this Entity is set to be quiet. More... | |
bool | mAmFrame |
Whether or not this Entity is a Frame. More... | |
common::SlotRegister< FrameChangedSignal > | onFrameChanged |
Slot register for frame changed signal. More... | |
common::SlotRegister< NameChangedSignal > | onNameChanged |
Slot register for name changed signal. More... | |
common::SlotRegister< EntitySignal > | onTransformUpdated |
Slot register for transform updated signal. More... | |
common::SlotRegister< EntitySignal > | onVelocityChanged |
Slot register for velocity updated signal. More... | |
common::SlotRegister< EntitySignal > | onAccelerationChanged |
Slot register for acceleration updated signal. More... | |
The FixedFrame class represents a Frame with zero relative velocity and zero relative acceleration.
It does not move within its parent Frame after its relative transform is set. However, classes that inherit the FixedFrame class may alter its relative transform or change what its parent Frame is.
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
protectedinherited |
Used when constructing a pure abstract class, because calling the Frame constructor is just a formality.
Enumerator | |
---|---|
ConstructAbstract |
|
protectedinherited |
|
privateinherited |
|
explicit |
Constructor.
|
virtual |
Destructor.
|
protected |
Default constructor – calls the Abstract constructor.
|
explicitprotected |
Abstract constructor.
|
protectedinherited |
Add an Observer to the list of Observers.
|
virtualinherited |
Convert 'this' into a ShapeFrame pointer if Frame is a ShapeFrame, otherwise return nullptr.
Reimplemented in dart::dynamics::ShapeFrame.
|
virtualinherited |
Convert 'const this' into a ShapeFrame pointer if Frame is a ShapeFrame, otherwise return nullptr.
Reimplemented in dart::dynamics::ShapeFrame.
|
overrideprotectedvirtualinherited |
Used by derived classes to change their parent frames.
Reimplemented from dart::dynamics::Entity.
|
inherited |
|
overridevirtualinherited |
Notify the acceleration updates of this Frame and all its children are needed.
Reimplemented from dart::dynamics::Entity.
Reimplemented in dart::dynamics::BodyNode.
|
overridevirtualinherited |
Notify the transformation updates of this Frame and all its children are needed.
Reimplemented from dart::dynamics::Entity.
Reimplemented in dart::dynamics::BodyNode.
|
overridevirtualinherited |
Notify the velocity updates of this Frame and all its children are needed.
Reimplemented from dart::dynamics::Entity.
Reimplemented in dart::dynamics::BodyNode.
|
inherited |
|
inherited |
|
inlineinherited |
|
inherited |
|
inherited |
Get a container with the Entities that are children of this Frame.
Note that this is version is slightly less efficient than the non-const version because it needs to rebuild a set where each pointer is converted to be a const pointer.
|
inherited |
|
inherited |
Get a container with the Frames that are children of this Frame.
Note that this version is less efficient than the non-const version because it needs to rebuild a set so that the entries are const.
|
inherited |
|
inherited |
|
inherited |
|
inherited |
|
pure virtualinherited |
Return the name of this Entity.
Implemented in dart::dynamics::WorldFrame, dart::dynamics::SimpleFrame, dart::dynamics::PointMassNotifier, and dart::dynamics::BodyNode.
|
inherited |
Get the number of Entities that are currently children of this Frame.
|
inherited |
Get the number of Frames that are currently children of this Frame.
|
inherited |
Get the parent (reference) frame of this Entity.
|
inherited |
Get the parent (reference) frame of this Entity.
|
overridevirtual |
Always returns a zero vector.
Implements dart::dynamics::Frame.
|
overridevirtual |
Always returns a zero vector.
Implements dart::dynamics::Frame.
|
overridevirtual |
Always returns a zero vector.
Implements dart::dynamics::Frame.
|
overridevirtual |
Always returns a zero vector.
Implements dart::dynamics::Frame.
|
overridevirtual |
Get the transform of this Frame with respect to its parent Frame.
Implements dart::dynamics::Frame.
|
inherited |
|
inherited |
|
inherited |
Get the spatial acceleration of a fixed point in this Frame.
|
inherited |
|
inherited |
|
inherited |
|
inherited |
Get the spatial velocity of a fixed point in this Frame.
|
inherited |
|
inherited |
|
virtualinherited |
Get the version number of this object.
|
inherited |
|
virtualinherited |
Increment the version for this object.
Reimplemented in dart::dynamics::Shape.
|
inherited |
Returns true if this Entity is set to be quiet.
A quiet entity is unknown to its parent Frame. It will not be tracked by its parent; it will not receive notifications from its parent, and it will not be rendered. The advantage to a quiet Entity is that it has less overhead when constructing and deconstructing, which makes it more suitable for temporary objects.
|
inherited |
Returns true if this Frame is a ShapeFrame.
|
inherited |
|
inherited |
Returns true iff an acceleration update is needed for this Entity.
|
inherited |
Returns true iff a transform update is needed for this Entity.
|
inherited |
Returns true iff a velocity update is needed for this Entity.
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
|
protectedvirtualinherited |
Called during a parent Frame change to allow extensions of the Frame class to handle new children in customized ways.
This function is a no op unless an inheriting class (such as BodyNode) overrides it.
Reimplemented in dart::dynamics::BodyNode.
|
protectedvirtualinherited |
Called when a child Entity is removed from its parent Frame.
This allows special post-processing to be performed for extensions of the Frame class.
Reimplemented in dart::dynamics::BodyNode.
|
protectedinherited |
Remove an Observer from the list of Observers.
|
protectedinherited |
Send a destruction notification to all Observers.
This will cause all Observers to behave as if this Subject has been permanently deleted, so it should only be called when that behavior is desired.
void dart::dynamics::FixedFrame::setAspectProperties | ( | const AspectProperties & | properties | ) |
Set the AspectProperties of this FixedFrame.
|
pure virtualinherited |
Set name.
Some implementations of Entity may make alterations to the name that gets passed in. The final name that this entity will use gets passed back in the return of this function.
Implemented in dart::dynamics::WorldFrame, dart::dynamics::SimpleFrame, dart::dynamics::PointMassNotifier, and dart::dynamics::BodyNode.
|
virtual |
Set the relative transform of this FixedFrame.
|
protectedinherited |
|
staticinherited |
|
staticinherited |
|
mutableprotectedinherited |
Total acceleration of this Frame, in the coordinates of this Frame.
Do not use directly! Use getSpatialAcceleration() to access this quantity
|
protectedinherited |
Acceleration changed signal.
|
privateinherited |
Whether or not this Entity is set to be quiet.
|
privateinherited |
Contains whether or not this is a ShapeFrame.
|
privateinherited |
Contains whether or not this is the World Frame.
|
protectedinherited |
Aspect::Properties data, directly accessible to your derived class.
|
protectedinherited |
Container of this Frame's child Entities.
|
protectedinherited |
Container of this Frame's child Frames.
|
privateinherited |
|
protectedinherited |
Frame changed signal.
|
protectedinherited |
Name changed signal.
|
mutableprotectedinherited |
Does this Entity need an Acceleration update.
|
mutableprotectedinherited |
Does this Entity need a Transform update.
|
mutableprotectedinherited |
Does this Entity need a Velocity update.
|
mutableprotectedinherited |
List of current Observers.
|
protectedinherited |
Transform changed signal.
|
mutableprotectedinherited |
Total velocity of this Frame, in the coordinates of this Frame.
Do not use directly! Use getSpatialVelocity() to access this quantity
|
protectedinherited |
Velocity changed signal.
|
protectedinherited |
|
mutableprotectedinherited |
World transform of this Frame.
This object is mutable to enable auto-updating to happen in the const member getWorldTransform() function
Do not use directly! Use getWorldTransform() to access this quantity
|
staticprotected |
Used for Relative Velocity and Relative Acceleration of this Frame.
|
inherited |
Slot register for acceleration updated signal.
|
inherited |
Slot register for frame changed signal.
|
inherited |
Slot register for name changed signal.
|
inherited |
Slot register for transform updated signal.
|
inherited |
Slot register for velocity updated signal.