UserCamera.hh

Go to the documentation of this file.

/*
 * Copyright (C) 2012-2014 Open Source Robotics Foundation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
*/
/* Desc: Camera for viewing the world
 * Author: Nate Koenig
 * Date: 19 Jun 2008
 */

#ifndef _USERCAMERA_HH_
#define _USERCAMERA_HH_

#include <string>
#include <vector>

#include "gazebo/rendering/Camera.hh"
#include "gazebo/rendering/RenderTypes.hh"
#include "gazebo/common/CommonTypes.hh"
#include "gazebo/util/system.hh"

namespace gazebo
{
  class UserCameraPrivate;

  namespace rendering
  {
    class GUIOverlay;


    class GAZEBO_VISIBLE UserCamera : public Camera
    {
      public: UserCamera(const std::string &_name, ScenePtr _scene);

      public: virtual ~UserCamera();

      public: void Load(sdf::ElementPtr _sdf);

      public: void Load();

      public: void Init();

      public: virtual void Update();

      public: virtual void PostRender();

      public: void Fini();

      public: virtual void SetWorldPose(const math::Pose &_pose);

      public: void HandleMouseEvent(const common::MouseEvent &_evt);

      public: void HandleKeyPressEvent(const std::string &_key);

      public: void HandleKeyReleaseEvent(const std::string &_key);

      public: void SetViewController(const std::string &_type);

      public: void SetViewController(const std::string &_type,
                                     const math::Vector3 &_pos);

      public: std::string GetViewControllerTypeString();

      public: void Resize(unsigned int _w, unsigned int _h);

      public: void SetViewportDimensions(float _x, float _y,
                                         float _w, float _h);

      public: float GetAvgFPS() const;

      public: unsigned int GetTriangleCount() const;

      public: void MoveToVisual(VisualPtr _visual);

      // Doxygen automatically pulls in the correct documentation.
      public: virtual bool MoveToPosition(const math::Pose &_pose,
                                          double _time);

      public: void MoveToVisual(const std::string &_visualName);

      public: virtual void SetRenderTarget(Ogre::RenderTarget *_target);

      public: GUIOverlay *GetGUIOverlay();

      public: void EnableViewController(bool _value) const;

      public: VisualPtr GetVisual(const math::Vector2i &_mousePos,
                                  std::string &_mod);

      public: VisualPtr GetVisual(const math::Vector2i &_mousePos) const;

      public: void SetFocalPoint(const math::Vector3 &_pt);

      // Documentation inherited
      public: virtual unsigned int GetImageWidth() const;

      // Documentation inherited
      public: virtual unsigned int GetImageHeight() const;

      public: bool IsCameraSetInWorldFile();

      public: void SetUseSDFPose(bool _value);

      protected: virtual bool AttachToVisualImpl(VisualPtr _visual,
                     bool _inheritOrientation, double _minDist = 0,
                     double _maxDist = 0);

      // Documentation inherited.
      protected: virtual void AnimationComplete();

      protected: virtual bool TrackVisualImpl(VisualPtr _visual);


      private: void ToggleShowVisual();

      private: void ShowVisual(bool _show);

      private: void OnMoveToVisualComplete();

      private: UserCameraPrivate *dataPtr;
    };
  }
}
#endif