Ignition Gazebo

API Reference

4.2.0
Breadcrumbs.hh
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2019 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 IGNITION_GAZEBO_SYSTEMS_BREADCRUMBS_HH_
18 #define IGNITION_GAZEBO_SYSTEMS_BREADCRUMBS_HH_
19 
20 #include <memory>
21 #include <set>
22 #include <string>
23 #include <unordered_map>
24 #include <vector>
25 
26 #include <sdf/Element.hh>
27 #include <sdf/Geometry.hh>
28 #include <sdf/Root.hh>
29 
31 #include <ignition/math/Pose3.hh>
32 
33 #include "ignition/gazebo/Model.hh"
36 
37 namespace ignition
38 {
39 namespace gazebo
40 {
41 // Inline bracket to help doxygen filtering.
42 inline namespace IGNITION_GAZEBO_VERSION_NAMESPACE {
43 namespace systems
44 {
86  class IGNITION_GAZEBO_VISIBLE Breadcrumbs
87  : public System,
88  public ISystemConfigure,
89  public ISystemPreUpdate
90  {
92  public: Breadcrumbs() = default;
93 
94  // Documentation inherited
95  public: void Configure(const Entity &_entity,
98  EventManager &_eventMgr) override;
99 
100  // Documentation inherited
101  public: void PreUpdate(
102  const ignition::gazebo::UpdateInfo &_info,
104 
106  private: void OnDeploy(const msgs::Empty &_msg);
107 
112  public: bool MakeStatic(Entity _entity, EntityComponentManager &_ecm);
113 
115  private: bool initialized{false};
116 
118  private: transport::Node node;
119 
121  private: Model model{kNullEntity};
122 
124  private: Entity worldEntity{kNullEntity};
125 
127  public: std::unique_ptr<SdfEntityCreator> creator{nullptr};
128 
130  private: int maxDeployments{-1};
131 
133  private: int numDeployments{0};
134 
136  private: sdf::Root modelRoot;
137 
139  private: bool isPerformer{false};
140 
143  private: bool allowRenaming{false};
144 
146  private: std::optional<sdf::Geometry> performerGeometry;
147 
149  private: std::vector<bool> pendingCmds;
150 
152  private: std::set<Entity> pendingGeometryUpdate;
153 
155  private: std::mutex pendingCmdsMutex;
156 
158  private: std::chrono::steady_clock::duration disablePhysicsTime =
159  std::chrono::steady_clock::duration::zero();
160 
163  autoStaticEntities;
164 
166  private: sdf::Model staticModelToSpawn;
167 
170 
172  public: bool topicStatistics{false};
173 
176  };
177  }
178 }
179 }
180 }
181 
182 #endif
183 
This class provides wrappers around entities and components which are more convenient and straight-fo...
Definition: Model.hh:60
A system for creating Breadcrumbs in the form of models that can get deployed/spawned at the location...
Definition: Breadcrumbs.hh:86
std::string topic
Name of the deploy topic.
Definition: Breadcrumbs.hh:175
Information passed to systems on the update callback.
Definition: Types.hh:36
STL class.
The EntityComponentManager constructs, deletes, and returns components and entities. A component can be of any class which inherits from components::BaseComponent.
Definition: EntityComponentManager.hh:64
The EventManager is used to send/receive notifications of simulator events.
Definition: EventManager.hh:50
transport::Node::Publisher remainingPub
Publishes remaining deployments.
Definition: Breadcrumbs.hh:169
Interface for a system that implements optional configuration.
Definition: System.hh:88
Component< NoData, class ModelTag > Model
A component that identifies an entity as being a model.
Definition: components/Model.hh:35
const Entity kNullEntity
Indicates a non-existant or invalid Entity.
Definition: Entity.hh:62
STL class.
Entity worldEntity(const Entity &_entity, const EntityComponentManager &_ecm)
Get the world to which the given entity belongs.
This library is part of the Ignition Robotics project.
uint64_t Entity
An Entity identifies a single object in simulation such as a model, link, or light. At its core, an Entity is just an identifier.
Definition: Entity.hh:59
Interface for a system that uses the PreUpdate phase.
Definition: System.hh:105
Base class for a System.
Definition: System.hh:73