pxmlw6n2f/Gazebo_Distributed_TCP/gazebo/msgs/factory.proto

40 lines
1.2 KiB
Protocol Buffer

syntax = "proto2";
package gazebo.msgs;
/// \ingroup gazebo_msgs
/// \interface Factory
/// \brief Message to create new entities in gazebo, at a given pose.
/// A model can be created in one of the following ways:
///
/// 1. From an SDF string (sdf field)
/// 2. From an SDF file (sdf_filename)
/// 3. Cloning an existing model (clone_model_name)
///
/// If more than one way is specified, the first field will be parsed and the
/// following ignored.
///
/// The message can also be used to edit an existing entity. The new entity
/// description is pushed into the entity named `edit_name`.
/// See issue #1954 for the current limitations using this method to edit
/// entities.
import "pose.proto";
message Factory
{
/// \brief SDF description in string format.
optional string sdf = 1;
/// \brief Full path to SDF file.
optional string sdf_filename = 2;
/// \brief Pose where the entity will be spawned.
optional Pose pose = 3;
/// \brief Name of the entity which will be updated.
optional string edit_name = 4;
/// \brief Name of model to clone.
optional string clone_model_name = 5;
}