rendering/Light.hh
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2012 Open Source Robotics Foundation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  *
16 */
17 #ifndef GAZEBO_RENDERING_LIGHT_HH_
18 #define GAZEBO_RENDERING_LIGHT_HH_
19 
20 #include <string>
21 #include <iostream>
22 #include <sdf/sdf.hh>
23 #include <ignition/math/Color.hh>
24 #include <ignition/math/Quaternion.hh>
25 #include <ignition/math/Vector3.hh>
26 
27 #include "gazebo/msgs/msgs.hh"
29 #include "gazebo/common/Color.hh"
30 #include "gazebo/util/system.hh"
31 
32 namespace Ogre
33 {
34  class Light;
35 }
36 
37 namespace gazebo
38 {
39  namespace rendering
40  {
41  // Forward declare private data.
42  class LightPrivate;
43 
46 
54  class GZ_RENDERING_VISIBLE Light :
55  public boost::enable_shared_from_this<Light>
56  {
59  public: explicit Light(ScenePtr _scene);
60 
62  public: virtual ~Light();
63 
67  public: void Load(sdf::ElementPtr _sdf);
68 
70  public: void Load();
71 
74  public: void LoadFromMsg(ConstLightPtr &_msg);
75 
78  public: void LoadFromMsg(const msgs::Light &_msg);
79 
82  public: void SetName(const std::string &_name);
83 
86  public: std::string Name() const;
87 
90  public: std::string Type() const;
91 
94  public: void SetPosition(const ignition::math::Vector3d &_p);
95 
98  public: ignition::math::Vector3d Position() const;
99 
102  public: void SetRotation(const ignition::math::Quaterniond &_q);
103 
106  public: ignition::math::Quaterniond Rotation() const;
107 
111  public: virtual bool SetSelected(const bool _s);
112 
113  // \brief Toggle light visual visibility
114  public: void ToggleShowVisual();
115 
118  public: void ShowVisual(const bool _s);
119 
122  public: bool Visible() const;
123 
126  public: void SetLightType(const std::string &_type);
127 
130  public: std::string LightType() const;
131 
135  public: void SetDiffuseColor(const common::Color &_color)
136  GAZEBO_DEPRECATED(9.0);
137 
140  public: void SetDiffuseColor(const ignition::math::Color &_color);
141 
144  public: ignition::math::Color DiffuseColor() const;
145 
149  public: void SetSpecularColor(const common::Color &_color)
150  GAZEBO_DEPRECATED(9.0);
151 
154  public: void SetSpecularColor(const ignition::math::Color &_color);
155 
158  public: ignition::math::Color SpecularColor() const;
159 
163  public: void SetDirection(const ignition::math::Vector3d &_dir);
164 
167  public: ignition::math::Vector3d Direction() const;
168 
173  public: void SetAttenuation(double _constant, double _linear,
174  double _quadratic);
175 
178  public: void SetSpotInnerAngle(const double _angle);
179 
182  public: void SetSpotOuterAngle(const double _angle);
183 
186  public: void SetSpotFalloff(const double _value);
187 
190  public: void SetRange(const double _range);
191 
194  public: void SetCastShadows(const bool _cast);
195 
198  public: bool CastShadows() const;
199 
202  public: void FillMsg(msgs::Light &_msg) const;
203 
206  public: void UpdateFromMsg(ConstLightPtr &_msg);
207 
212  public: LightPtr Clone(const std::string &_name, ScenePtr _scene);
213 
215  protected: virtual void OnPoseChange() {}
216 
218  private: void CreateVisual();
219 
221  private: void Update();
222 
225  private: void UpdateSDFFromMsg(const msgs::Light &_msg);
226 
229  private: std::unique_ptr<LightPrivate> dataPtr;
230  };
232  }
233 }
234 #endif
virtual void OnPoseChange()
On pose change callback.
Definition: rendering/Light.hh:215
boost::shared_ptr< Scene > ScenePtr
Definition: RenderTypes.hh:82
Defines a color.
Definition: Color.hh:36
#define GAZEBO_DEPRECATED(version)
Definition: system.hh:328
A light source.
Definition: rendering/Light.hh:54
boost::shared_ptr< Light > LightPtr
Definition: RenderTypes.hh:86