/usr/include/tf/transform_listener.h is in libtf-dev 1.11.7-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 | /*
* Copyright (c) 2008, Willow Garage, Inc.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of the Willow Garage, Inc. nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
/** \author Tully Foote */
#ifndef TF_TRANSFORMLISTENER_H
#define TF_TRANSFORMLISTENER_H
#include "sensor_msgs/PointCloud.h"
#include "std_msgs/Empty.h"
#include "tf/tfMessage.h"
#include "tf/tf.h"
#include "ros/ros.h"
#include "ros/callback_queue.h"
#include "tf/FrameGraph.h" //frame graph service
#include "boost/thread.hpp"
#include <tf2_ros/transform_listener.h>
namespace tf{
/** \brief Get the tf_prefix from the parameter server
* \param nh The node handle to use to lookup the parameter.
* \return The tf_prefix value for this NodeHandle
*/
inline std::string getPrefixParam(ros::NodeHandle & nh) {
std::string param;
if (!nh.searchParam("tf_prefix", param))
return "";
std::string return_val;
nh.getParam(param, return_val);
return return_val;
}
/** \brief resolve names
* \deprecated Use TransformListener::remap instead */
std::string remap(const std::string& frame_id) __attribute__((deprecated));
/** \brief This class inherits from Transformer and automatically subscribes to ROS transform messages */
class TransformListener : public Transformer { //subscribes to message and automatically stores incoming data
public:
/**@brief Constructor for transform listener
* \param max_cache_time How long to store transform information */
TransformListener(ros::Duration max_cache_time = ros::Duration(DEFAULT_CACHE_TIME), bool spin_thread = true);
/**
* \brief Alternate constructor for transform listener
* \param nh The NodeHandle to use for any ROS interaction
* \param max_cache_time How long to store transform information
*/
TransformListener(const ros::NodeHandle& nh,
ros::Duration max_cache_time = ros::Duration(DEFAULT_CACHE_TIME), bool spin_thread = true);
~TransformListener();
/* Methods from transformer unhiding them here */
using Transformer::transformQuaternion;
using Transformer::transformVector;
using Transformer::transformPoint;
using Transformer::transformPose;
/** \brief Transform a Stamped Quaternion Message into the target frame
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformQuaternion(const std::string& target_frame, const geometry_msgs::QuaternionStamped& stamped_in, geometry_msgs::QuaternionStamped& stamped_out) const;
/** \brief Transform a Stamped Vector Message into the target frame
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformVector(const std::string& target_frame, const geometry_msgs::Vector3Stamped& stamped_in, geometry_msgs::Vector3Stamped& stamped_out) const;
/** \brief Transform a Stamped Point Message into the target frame
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformPoint(const std::string& target_frame, const geometry_msgs::PointStamped& stamped_in, geometry_msgs::PointStamped& stamped_out) const;
/** \brief Transform a Stamped Pose Message into the target frame
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformPose(const std::string& target_frame, const geometry_msgs::PoseStamped& stamped_in, geometry_msgs::PoseStamped& stamped_out) const;
/** \brief Transform a Stamped Twist Message into the target frame
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
// http://www.ros.org/wiki/tf/Reviews/2010-03-12_API_Review
// void transformTwist(const std::string& target_frame, const geometry_msgs::TwistStamped& stamped_in, geometry_msgs::TwistStamped& stamped_out) const;
/** \brief Transform a Stamped Quaternion Message into the target frame
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformQuaternion(const std::string& target_frame, const ros::Time& target_time,
const geometry_msgs::QuaternionStamped& qin,
const std::string& fixed_frame, geometry_msgs::QuaternionStamped& qout) const;
/** \brief Transform a Stamped Vector Message into the target frame and time
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformVector(const std::string& target_frame, const ros::Time& target_time,
const geometry_msgs::Vector3Stamped& vin,
const std::string& fixed_frame, geometry_msgs::Vector3Stamped& vout) const;
/** \brief Transform a Stamped Point Message into the target frame and time
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformPoint(const std::string& target_frame, const ros::Time& target_time,
const geometry_msgs::PointStamped& pin,
const std::string& fixed_frame, geometry_msgs::PointStamped& pout) const;
/** \brief Transform a Stamped Pose Message into the target frame and time
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformPose(const std::string& target_frame, const ros::Time& target_time,
const geometry_msgs::PoseStamped& pin,
const std::string& fixed_frame, geometry_msgs::PoseStamped& pout) const;
/** \brief Transform a sensor_msgs::PointCloud natively
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformPointCloud(const std::string& target_frame, const sensor_msgs::PointCloud& pcin, sensor_msgs::PointCloud& pcout) const;
/** @brief Transform a sensor_msgs::PointCloud in space and time
* This can throw all that lookupTransform can throw as well as tf::InvalidTransform */
void transformPointCloud(const std::string& target_frame, const ros::Time& target_time,
const sensor_msgs::PointCloud& pcin,
const std::string& fixed_frame, sensor_msgs::PointCloud& pcout) const;
///\todo move to high precision laser projector class void projectAndTransformLaserScan(const sensor_msgs::LaserScan& scan_in, sensor_msgs::PointCloud& pcout);
bool getFrames(tf::FrameGraph::Request& req, tf::FrameGraph::Response& res)
{
res.dot_graph = allFramesAsDot();
return true;
}
/* \brief Resolve frame_name into a frame_id using tf_prefix parameter */
std::string resolve(const std::string& frame_name)
{
ros::NodeHandle n("~");
std::string prefix = tf::getPrefixParam(n);
return tf::resolve(prefix, frame_name);
};
protected:
bool ok() const;
private:
// Must be above the listener
ros::NodeHandle node_;
/// replacing implementation with tf2_ros'
tf2_ros::TransformListener tf2_listener_;
/** @brief a helper function to be used for both transfrom pointCloud methods */
void transformPointCloud(const std::string & target_frame, const Transform& transform, const ros::Time& target_time, const sensor_msgs::PointCloud& pcin, sensor_msgs::PointCloud& pcout) const;
};
}
#endif //TF_TRANSFORMLISTENER_H
|