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/Cone.hh"
26 #include "sdf/Cylinder.hh"
27 #include "sdf/Element.hh"
28 #include "sdf/Material.hh"
29 #include "sdf/Plane.hh"
30 #include "sdf/Plugin.hh"
31 #include "sdf/SemanticPose.hh"
32 #include "sdf/Sphere.hh"
33 #include "sdf/Types.hh"
34 #include "sdf/sdf_config.h"
35 #include "sdf/system_util.hh"
36 
37 namespace sdf
38 {
39  // Inline bracket to help doxygen filtering.
40  inline namespace SDF_VERSION_NAMESPACE {
41  //
42 
43  // Forward declarations.
44  class Geometry;
45  class ParserConfig;
46  struct PoseRelativeToGraph;
47  template <typename T> class ScopedGraph;
48 
50  {
52  public: Visual();
53 
60  public: Errors Load(ElementPtr _sdf);
61 
69  public: Errors Load(ElementPtr _sdf, const ParserConfig &_config);
70 
74  public: std::string Name() const;
75 
79  public: void SetName(const std::string &_name);
80 
83  public: bool CastShadows() const;
84 
87  public: void SetCastShadows(bool _castShadows);
88 
91  public: float Transparency() const;
92 
95  public: void SetTransparency(float _transparency);
96 
99  public: const Geometry *Geom() const;
100 
103  public: void SetGeom(const Geometry &_geom);
104 
109  public: const gz::math::Pose3d &RawPose() const;
110 
114  public: void SetRawPose(const gz::math::Pose3d &_pose);
115 
120  public: const std::string &PoseRelativeTo() const;
121 
126  public: void SetPoseRelativeTo(const std::string &_frame);
127 
132 
137  public: sdf::ElementPtr Element() const;
138 
143  public: const sdf::Material *Material() const;
144 
147  public: void SetMaterial(const sdf::Material &_material);
148 
151  public: uint32_t VisibilityFlags() const;
152 
155  public: void SetVisibilityFlags(uint32_t _flags);
156 
161  public: void SetHasLaserRetro(bool _laserRetro);
162 
165  public: bool HasLaserRetro() const;
166 
169  public: double LaserRetro() const;
170 
173  public: void SetLaserRetro(double _laserRetro);
174 
180  public: sdf::ElementPtr ToElement() const;
181 
185  public: const sdf::Plugins &Plugins() const;
186 
190  public: sdf::Plugins &Plugins();
191 
193  public: void ClearPlugins();
194 
197  public: void AddPlugin(const Plugin &_plugin);
198 
203  private: void SetXmlParentName(const std::string &_xmlParentName);
204 
209  private: void SetPoseRelativeToGraph(
211 
215  friend class Link;
216 
218  GZ_UTILS_IMPL_PTR(dataPtr)
219  };
220  }
221 }
222 #endif
Geometry provides access to a shape, such as a Box.
Definition: Geometry.hh:93
This class contains visual material properties.
Definition: Material.hh:47
This class contains configuration options for the libsdformat parser.
Definition: ParserConfig.hh:100
Definition: Plugin.hh:46
Definition: Collision.hh:44
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:50
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:245
std::vector< Error > Errors
A vector of Error.
Definition: Types.hh:95
std::shared_ptr< Element > ElementPtr
Definition: Element.hh:55
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