00001 /* **-*-c++-*-************************************************************** 00002 Copyright (C)2002 David Jung <opensim@pobox.com> 00003 00004 This program/file is free software; you can redistribute it and/or modify 00005 it under the terms of the GNU General Public License as published by 00006 the Free Software Foundation; either version 2 of the License, or 00007 (at your option) any later version. 00008 00009 This program is distributed in the hope that it will be useful, 00010 but WITHOUT ANY WARRANTY; without even the implied warranty of 00011 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00012 GNU General Public License for more details. (http://www.gnu.org) 00013 00014 You should have received a copy of the GNU General Public License 00015 along with this program; if not, write to the Free Software 00016 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 00017 00018 $Id: Controllable 1039 2004-02-11 20:50:52Z jungd $ 00019 $Revision: 1.5 $ 00020 $Date: 2004-02-11 15:50:52 -0500 (Wed, 11 Feb 2004) $ 00021 $Author: jungd $ 00022 00023 ****************************************************************************/ 00024 00025 #ifndef _ROBOT_CONTROLLABLE_ 00026 #define _ROBOT_CONTROLLABLE_ 00027 00028 #include <robot/robot> 00029 00030 #include <robot/ControlInterface> 00031 00032 00033 namespace robot { 00034 00035 /// Abstract interface for things that can be controlled 00036 /** 00037 * (via the ControlInterfaces they provide) 00038 * e.g. a Robot, a low-level Controller 00039 */ 00040 class Controllable : virtual public base::ReferencedObject 00041 { 00042 public: 00043 00044 /// Provide ControlInterface for named interface (or default/possibly-only interface) 00045 /** @exception std::invalid_argument if the specified interface name is unknown. */ 00046 virtual ref<ControlInterface> getControlInterface(String interfaceName="") throw(std::invalid_argument) = 0; 00047 00048 }; 00049 00050 00051 } // robot 00052 00053 #endif