Visual.hh
Go to the documentation of this file.
1 /*
2  * Copyright 2018 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 SDF_VISUAL_HH_
18 #define SDF_VISUAL_HH_
19 
20 #include <memory>
21 #include <string>
22 #include <gz/math/Pose3.hh>
23 #include <gz/utils/ImplPtr.hh>
24 #include "sdf/Box.hh"
25 #include "sdf/Cylinder.hh"
26 #include "sdf/Element.hh"
27 #include "sdf/Material.hh"
28 #include "sdf/Plane.hh"
29 #include "sdf/Plugin.hh"
30 #include "sdf/SemanticPose.hh"
31 #include "sdf/Sphere.hh"
32 #include "sdf/Types.hh"
33 #include "sdf/sdf_config.h"
34 #include "sdf/system_util.hh"
35 
36 namespace sdf
37 {
38  // Inline bracket to help doxygen filtering.
39  inline namespace SDF_VERSION_NAMESPACE {
40  //
41 
42  // Forward declarations.
43  class Geometry;
44  class ParserConfig;
45  struct PoseRelativeToGraph;
46  template <typename T> class ScopedGraph;
47 
49  {
51  public: Visual();
52 
59  public: Errors Load(ElementPtr _sdf);
60 
68  public: Errors Load(ElementPtr _sdf, const ParserConfig &_config);
69 
73  public: std::string Name() const;
74 
78  public: void SetName(const std::string &_name);
79 
82  public: bool CastShadows() const;
83 
86  public: void SetCastShadows(bool _castShadows);
87 
90  public: float Transparency() const;
91 
94  public: void SetTransparency(float _transparency);
95 
98  public: const Geometry *Geom() const;
99 
102  public: void SetGeom(const Geometry &_geom);
103 
108  public: const gz::math::Pose3d &RawPose() const;
109 
113  public: void SetRawPose(const gz::math::Pose3d &_pose);
114 
119  public: const std::string &PoseRelativeTo() const;
120 
125  public: void SetPoseRelativeTo(const std::string &_frame);
126 
131 
136  public: sdf::ElementPtr Element() const;
137 
142  public: const sdf::Material *Material() const;
143 
146  public: void SetMaterial(const sdf::Material &_material);
147 
150  public: uint32_t VisibilityFlags() const;
151 
154  public: void SetVisibilityFlags(uint32_t _flags);
155 
160  public: void SetHasLaserRetro(bool _laserRetro);
161 
164  public: bool HasLaserRetro() const;
165 
168  public: double LaserRetro() const;
169 
172  public: void SetLaserRetro(double _laserRetro);
173 
179  public: sdf::ElementPtr ToElement() const;
180 
184  public: const sdf::Plugins &Plugins() const;
185 
189  public: sdf::Plugins &Plugins();
190 
192  public: void ClearPlugins();
193 
196  public: void AddPlugin(const Plugin &_plugin);
197 
202  private: void SetXmlParentName(const std::string &_xmlParentName);
203 
208  private: void SetPoseRelativeToGraph(
210 
214  friend class Link;
215 
217  GZ_UTILS_IMPL_PTR(dataPtr)
218  };
219  }
220 }
221 #endif
Geometry provides access to a shape, such as a Box.
Definition: Geometry.hh:85
This class contains visual material properties.
Definition: Material.hh:47
This class contains configuration options for the libsdformat parser.
Definition: ParserConfig.hh:85
Definition: Plugin.hh:46
Definition: Collision.hh:40
SemanticPose is a data structure that can be used by different DOM objects to resolve poses on a Pose...
Definition: SemanticPose.hh:55
Definition: Visual.hh:49
const gz::math::Pose3d & RawPose() const
Get the pose of the visual object.
void SetLaserRetro(double _laserRetro)
Set the lidar reflective intensity.
bool CastShadows() const
Get whether the visual casts shadows.
sdf::Plugins & Plugins()
Get a mutable vector of plugins attached to this object.
std::string Name() const
Get the name of the visual.
void AddPlugin(const Plugin &_plugin)
Add a plugin to this object.
void SetName(const std::string &_name)
Set the name of the visual.
uint32_t VisibilityFlags() const
Get the visibility flags of a visual.
sdf::SemanticPose SemanticPose() const
Get SemanticPose object of this object to aid in resolving poses.
double LaserRetro() const
Get the flidar reflective intensity.
sdf::ElementPtr Element() const
Get a pointer to the SDF element that was used during load.
void SetRawPose(const gz::math::Pose3d &_pose)
Set the pose of the visual object.
void ClearPlugins()
Remove all plugins.
sdf::ElementPtr ToElement() const
Create and return an SDF element filled with data from this visual.
Visual()
Default constructor.
const Geometry * Geom() const
Get a pointer to the visual's geometry.
void SetPoseRelativeTo(const std::string &_frame)
Set the name of the coordinate frame relative to which this object's pose is expressed.
void SetCastShadows(bool _castShadows)
Set whether the visual casts shadows.
Errors Load(ElementPtr _sdf, const ParserConfig &_config)
Load the visual based on a element pointer.
const sdf::Material * Material() const
Get a pointer to the visual's material properties.
Errors Load(ElementPtr _sdf)
Load the visual based on a element pointer.
void SetVisibilityFlags(uint32_t _flags)
Set the visibility flags of a visual.
void SetHasLaserRetro(bool _laserRetro)
Set whether the lidar reflective intensity has been specified.
void SetMaterial(const sdf::Material &_material)
Set the visual's material.
float Transparency() const
Get the transparency value of the visual.
void SetGeom(const Geometry &_geom)
Set the visual's geometry.
const std::string & PoseRelativeTo() const
Get the name of the coordinate frame relative to which this object's pose is expressed.
const sdf::Plugins & Plugins() const
Get the plugins attached to this object.
void SetTransparency(float _transparency)
Set the transparency value for the visual.
bool HasLaserRetro() const
Get whether the lidar reflective intensity was set was set.
std::vector< Plugin > Plugins
A vector of Plugin.
Definition: Plugin.hh:196
std::vector< Error > Errors
A vector of Error.
Definition: Types.hh:80
std::shared_ptr< Element > ElementPtr
Definition: Element.hh:54
namespace for Simulation Description Format parser
Definition: Actor.hh:35
#define SDFORMAT_VISIBLE
Use to represent "symbol visible" if supported.
Definition: system_util.hh:25