00001 /********************************************************************* 00002 * Software License Agreement (BSD License) 00003 * 00004 * Copyright (c) 2014, SRI International 00005 * All rights reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions 00009 * are met: 00010 * 00011 * * Redistributions of source code must retain the above copyright 00012 * notice, this list of conditions and the following disclaimer. 00013 * * Redistributions in binary form must reproduce the above 00014 * copyright notice, this list of conditions and the following 00015 * disclaimer in the documentation and/or other materials provided 00016 * with the distribution. 00017 * * Neither the name of Willow Garage nor the names of its 00018 * contributors may be used to endorse or promote products derived 00019 * from this software without specific prior written permission. 00020 * 00021 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00022 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00023 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 00024 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 00025 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 00026 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 00027 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 00028 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 00029 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 00030 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 00031 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00032 * POSSIBILITY OF SUCH DAMAGE. 00033 *********************************************************************/ 00034 00035 /* Author: Acorn Pooley */ 00036 00037 #ifndef MOVEIT_ROBOT_INTERACTION_KINEMATIC_OPTIONS_ 00038 #define MOVEIT_ROBOT_INTERACTION_KINEMATIC_OPTIONS_ 00039 00040 #include <moveit/kinematics_base/kinematics_base.h> 00041 #include <moveit/robot_state/robot_state.h> 00042 00043 namespace robot_interaction 00044 { 00045 00046 // Options for inverse kinematics calculations. 00047 // 00048 // This is intended to be lightweight and passable by value. No virtual 00049 // functions and no destructor. 00050 struct KinematicOptions 00051 { 00053 KinematicOptions(); 00054 00058 enum OptionBitmask 00059 { 00060 TIMEOUT = 0x00000001, // timeout_seconds_ 00061 MAX_ATTEMPTS = 0x00000002, // max_attempts_ 00062 STATE_VALIDITY_CALLBACK = 0x00000004, // state_validity_callback_ 00063 LOCK_REDUNDANT_JOINTS = 0x00000008, // options_.lock_redundant_joints 00064 RETURN_APPROXIMATE_SOLUTION = 0x00000010, // options_.return_approximate_solution 00065 00066 ALL_QUERY_OPTIONS = LOCK_REDUNDANT_JOINTS | 00067 RETURN_APPROXIMATE_SOLUTION, 00068 ALL = 0x7fffffff 00069 }; 00070 00071 00078 bool setStateFromIK(robot_state::RobotState& state, 00079 const std::string& group, 00080 const std::string& tip, 00081 const geometry_msgs::Pose& pose) const; 00082 00086 void setOptions(const KinematicOptions& source, 00087 OptionBitmask fields = ALL); 00088 00090 double timeout_seconds_; 00091 00093 unsigned int max_attempts_; 00094 00096 robot_state::GroupStateValidityCallbackFn state_validity_callback_; 00097 00099 kinematics::KinematicsQueryOptions options_; 00100 }; 00101 00102 } 00103 00104 #endif