RouteSegmentsVisual.h

Go to the documentation of this file.

/***************************************************************************
 *   Software License Agreement (BSD License)                              *
 *   Copyright (C) 2016 by Markus Bader <markus.bader@tuwien.ac.at>        *
 *                                                                         *
 *   Redistribution and use in source and binary forms, with or without    *
 *   modification, are permitted provided that the following conditions    *
 *   are met:                                                              *
 *                                                                         *
 *   1. Redistributions of source code must retain the above copyright     *
 *      notice, this list of conditions and the following disclaimer.      *
 *   2. 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.                                                      *
 *   3. Neither the name of the copyright holder 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 HOLDER 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.                                           *
 ***************************************************************************/

#ifndef ROUTESEGMENTS_VISUAL_H
#define ROUTESEGMENTS_VISUAL_H

#include <tuw_nav_msgs/RouteSegments.h>
#include <rviz/ogre_helpers/shape.h>
#include <eigen3/unsupported/Eigen/Splines>
#include <rviz/ogre_helpers/arrow.h>
#include <rviz/ogre_helpers/line.h>

namespace Ogre
{
class Vector3;
class Quaternion;
}

namespace rviz
{
class Shape;
}

namespace tuw_nav_rviz
{

// Declare the visual class for this display.
class RouteSegmentsVisual
{
public:
  // Constructor.  Creates the visual stuff and puts it into the
  // scene, but in an unconfigured state.
  RouteSegmentsVisual( Ogre::SceneManager* scene_manager, Ogre::SceneNode* parent_node );

  // Destructor.  Removes the visual stuff from the scene.
  virtual ~RouteSegmentsVisual();

  // Configure the visual to show the data in the message.
  void setMessage( const tuw_nav_msgs::RouteSegments::ConstPtr& msg );

  // Set the pose of the coordinate frame the message refers to.
  // These could be done inside setMessage(), but that would require
  // calls to FrameManager and error handling inside setMessage(),
  // which doesn't seem as clean.  This way RouteSegmentsVisual is
  // only responsible for visualization.
  void setFramePosition( const Ogre::Vector3& position );
  void setFrameOrientation( const Ogre::Quaternion& orientation );

  // Set the color of the visual, which is an user-editable
  // parameter and therefore don't come from the MarkerDetection message.
  void setStartPointColor( Ogre::ColourValue color );
  void setEndPointColor( Ogre::ColourValue color );
  void setCenterPointColor( Ogre::ColourValue color );
  void setLineColor( Ogre::ColourValue color );
  void setArcColor( Ogre::ColourValue color );

  // Set the shape of the visual, which is an user-editable
  // parameter and therefore don't come from the MarkerDetection message.
  void setStartPointShape( rviz::Shape::Type shape_type );
  void setEndPointShape( rviz::Shape::Type shape_type );
  void setCenterPointShape( rviz::Shape::Type shape_type );

  // Set the scale of the visual, which is an user-editable
  // parameter and therefore don't come from the MarkerDetection message.
  void setStartPointScale( float scale );
  void setEndPointScale( float scale );
  void setCenterPointScale( float scale );
  
  void setShowArcs( bool visible );
  void setShowLines ( bool visible );
  void setShowStartPoints( bool visible );
  void setShowEndPoints ( bool visible );
  void setShowCenterPoints ( bool visible );

private:
  // The objects implementing the actual shape
  std::vector<boost::shared_ptr<rviz::Shape> > startPts_;
  std::vector<boost::shared_ptr<rviz::Shape> > endPts_;
  std::vector<boost::shared_ptr<rviz::Shape> > centerPts_;
  std::vector<boost::shared_ptr<rviz::Line> > lines_;
  std::vector<boost::shared_ptr<rviz::Line> > arcs_;
  
  boost::shared_ptr<Eigen::Spline3d> spline_;

  // A SceneNode whose pose is set to match the coordinate frame of
  // the Imu message header.
  Ogre::SceneNode* frame_node_;

  // The SceneManager, kept here only so the destructor can ask it to
  // destroy the ``frame_node_``.
  Ogre::SceneManager* scene_manager_;

  // The Shape object's color
  Ogre::ColourValue color_start_point_;
  Ogre::ColourValue color_end_point_;
  Ogre::ColourValue color_center_point_;
  Ogre::ColourValue color_lines_;
  Ogre::ColourValue color_arcs_;
  
  // The Shape object's shape type
  rviz::Shape::Type shape_start_point_;
  rviz::Shape::Type shape_end_point_;
  rviz::Shape::Type shape_center_point_;
  
  // The Shape object's scale
  float scale_start_point_;
  float scale_end_point_;
  float scale_center_point_;
  bool show_lines_;
  bool show_acrs_;
  bool show_start_points_;
  bool show_end_points_;
  bool show_center_points_;
  
};

} // end namespace tuw_nav_rviz

#endif // ROUTESEGMENTS_VISUAL_H