1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
/*
* Copyright 2017 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.
*
*/
#ifndef SDF_ROOT_HH_
#define SDF_ROOT_HH_
#include <string>
#include <ignition/utils/ImplPtr.hh>
#include "sdf/SDFImpl.hh"
#include "sdf/Types.hh"
#include "sdf/sdf_config.h"
#include "sdf/system_util.hh"
namespace sdf
{
// Inline bracket to help doxygen filtering.
inline namespace SDF_VERSION_NAMESPACE {
//
// Forward declarations.
class Actor;
class Light;
class Model;
class World;
/// \brief Root class that acts as an entry point to the SDF document
/// model.
///
/// Multiple worlds can exist in a single SDF file. A user of multiple
/// worlds could run parallel instances of simulation, or offer selection
/// of a world at runtime.
///
/// # Usage
///
/// In this example, a root object is loaded from a file specified in
/// the first command line argument to a program.
///
/// \snippet examples/dom.cc rootUsage
///
class SDFORMAT_VISIBLE Root
{
/// \brief Default constructor
public: Root();
/// \brief Parse the given SDF file, and generate objects based on types
/// specified in the SDF file.
/// \param[in] _filename Name of the SDF file to parse.
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors Load(const std::string &_filename);
/// \brief Parse the given SDF file, and generate objects based on types
/// specified in the SDF file.
/// \param[in] _filename Name of the SDF file to parse.
/// \param[in] _config Custom parser configuration
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors Load(
const std::string &_filename, const ParserConfig &_config);
/// \brief Parse the given SDF string, and generate objects based on types
/// specified in the SDF file.
/// \param[in] _sdf SDF string to parse.
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors LoadSdfString(const std::string &_sdf);
/// \brief Parse the given SDF string, and generate objects based on types
/// specified in the SDF file.
/// \param[in] _sdf SDF string to parse.
/// \param[in] _config Custom parser configuration
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors LoadSdfString(
const std::string &_sdf, const ParserConfig &_config);
/// \brief Parse the given SDF pointer, and generate objects based on types
/// specified in the SDF file.
/// \param[in] _sdf SDF pointer to parse.
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors Load(const SDFPtr _sdf);
/// \brief Parse the given SDF pointer, and generate objects based on types
/// specified in the SDF file.
/// \param[in] _sdf SDF pointer to parse.
/// \param[in] _config Custom parser configuration
/// \return Errors, which is a vector of Error objects. Each Error includes
/// an error code and message. An empty vector indicates no error.
public: Errors Load(const SDFPtr _sdf, const ParserConfig &_config);
/// \brief Get the SDF version specified in the parsed file or SDF
/// pointer.
/// \return SDF version string.
/// \sa void SetVersion(const std::string &_version)
public: std::string Version() const;
/// \brief Set the SDF version string.
/// \param[in] _version The new SDF version.
/// \sa std::string Version()
public: void SetVersion(const std::string &_version);
/// \brief Get the number of worlds.
/// \return Number of worlds contained in this Root object.
public: uint64_t WorldCount() const;
/// \brief Get a world based on an index.
/// \param[in] _index Index of the world. The index should be in the
/// range [0..WorldCount()).
/// \return Pointer to the world. Nullptr if the index does not exist.
/// \sa uint64_t WorldCount() const
public: const World *WorldByIndex(const uint64_t _index) const;
/// \brief Get whether a world name exists.
/// \param[in] _name Name of the world to check.
/// \return True if there exists a world with the given name.
public: bool WorldNameExists(const std::string &_name) const;
/// \brief Get a pointer to the model object if it exists.
///
/// \return A pointer to the model, nullptr if it doesn't exist
public: const sdf::Model *Model() const;
/// \brief Get a pointer to the light object if it exists.
///
/// \return A pointer to the light, nullptr if it doesn't exist
public: const sdf::Light *Light() const;
/// \brief Get a pointer to the actor object if it exists.
///
/// \return A pointer to the actor, nullptr if it doesn't exist
public: const sdf::Actor *Actor() const;
/// \brief Get a pointer to the SDF element that was generated during
/// load.
/// \return SDF element pointer. The value will be nullptr if Load has
/// not been called.
public: sdf::ElementPtr Element() const;
/// \brief Private data pointer
IGN_UTILS_UNIQUE_IMPL_PTR(dataPtr)
};
}
}
#endif
|
