orca-robotics


INTRODUCTION
Overview
Download and Install
Quick Start
Documentation
Publications

REPOSITORY
Interfaces
Components
Libraries
Utilities
Software Map

DEVELOPER
Tutorials
Examples
Dev Guide
Dashboard
Wiki
login/pass: orca/orca

PEOPLE
Contributors
Users

SourceForge.net Logo
Project
Download
Mailing lists

 

         

orca::PathFollower2d Interface Reference
[PathFollower2dPathFollower2d]

The Path Follower. More...

Inherited by goalplanner::PathFollower2dI, and orcaifaceimpl::PathFollower2dI [virtual].

List of all members.

Public Member Functions

idempotent PathFollower2dData getData ()
idempotent void setData (PathFollower2dData path, bool activateImmediately) throws MalformedParametersException, OrcaException
idempotent void activateNow ()
idempotent int getWaypointIndex ()
idempotent bool getAbsoluteActivationTime (out Time activationTime)
idempotent bool getRelativeActivationTime (out double secondsSinceActivation)
idempotent void setEnabled (bool enabled)
idempotent bool enabled ()
 Get the enabled/disabled state.
void subscribe (PathFollower2dConsumer *subscriber) throws SubscriptionFailedException
idempotent void unsubscribe (PathFollower2dConsumer *subscriber)


Detailed Description

The Path Follower.

To make the follower follow a path:

  • either (a)
    1. call setData(thePath,false) to load the path, then
    2. call activateNow() to make it go.

  • or (b)
    1. call setData(thePath,true) to load the path and have the follower start following it immediately


Member Function Documentation

idempotent void orca::PathFollower2d::activateNow  ) 
 

Start following the previously-loaded path. alexm: what happens when none is loaded? Silently ignored?

idempotent bool orca::PathFollower2d::getAbsoluteActivationTime out Time  activationTime  ) 
 

If the PathFollower is active (alexm: what does that mean? has path?)

  • returns TRUE and
  • sets the absolute time when the follower started following the current path If the PathFollower is inactive:
  • returns FALSE and
  • does not set the activation time

idempotent PathFollower2dData orca::PathFollower2d::getData  ) 
 

Returns the path currently being followed, or throws DataNotExistException if none has been set.

idempotent bool orca::PathFollower2d::getRelativeActivationTime out double  secondsSinceActivation  ) 
 

If the PathFollower is active:

  • returns true and sets secondsSinceActivation to the number of seconds since the follower started following the current path If the PathFollower is inactive:
  • returns false and does not set secondsSinceActivation

idempotent int orca::PathFollower2d::getWaypointIndex  ) 
 

Returns the index of the waypoint which is currently pursued:

  • '-1' : none (inactive)
  • [0,n-1] : an index into the list of n waypoints.

idempotent void orca::PathFollower2d::setData PathFollower2dData  path,
bool  activateImmediately
throws MalformedParametersException, OrcaException
 

Loads the follower with a path to follow. If activateImmediately is false, the follower won't go anywhere until activateNow() is called.

Loading the follower with a new path while it is active over-writes the old path. The activation status of the follower is set to the value of activateImmediately.

The follower can therefore be stopped by calling setData(emptyPath,false).

idempotent void orca::PathFollower2d::setEnabled bool  enabled  ) 
 

Disabling the PathFollower stops it from sending any commands to the robot. It says, "Take your hands off the wheel!". No commands can be send until it is re-enabled.

void orca::PathFollower2d::subscribe PathFollower2dConsumer subscriber  )  throws SubscriptionFailedException
 

Mimics IceStorm's subscribe(). The implementation may choose to implement the push directly or use IceStorm. This choice is transparent to the subscriber.

Parameters:
subscriber The subscriber's proxy.
See also:
unsubscribe

idempotent void orca::PathFollower2d::unsubscribe PathFollower2dConsumer subscriber  ) 
 

Unsubscribe the given [subscriber].

Parameters:
subscriber The proxy of an existing subscriber.
See also:
subscribe


The documentation for this interface was generated from the following file:
  • pathfollower2d.ice
 

Webmaster: Tobias Kaupp (tobasco at users.sourceforge.net)


Generated for Orca Robotics by  doxygen 1.4.5