Skip to content

Latest commit

 

History

History
145 lines (92 loc) · 3.88 KB

Migration.md

File metadata and controls

145 lines (92 loc) · 3.88 KB

Note on deprecations

A tick-tock release cycle allows easy migration to new software versions. Obsolete code is marked as deprecated for one major release. Deprecated code produces compile-time warnings. These warning serve as notification to users that their code should be upgraded. The next major release will remove the deprecated code.

Ignition Msgs 6.X to 7.X

Removals

  1. bool use_parent_model_frame from axis.proto.

  2. double force from joint_cmd.proto.

  3. double target, double p_gain, double i_gain, double d_gain, double i_max, double i_min, double limit from pid.proto.

Ignition Msgs 4.X to 5.X

Modifications

Deprecations

  1. axis.proto
    • The use_parent_model_frame field is deprecated, use xyz_expressed_in instead. Setting xyz_expressed_in = "__model__" is equivalent touse_parent_model_frame = true and leaving xyz_expressed_in empty is equivalent to use_parent_model_frame = false

Ignition Msgs 3.X to 4.X

Modifications

  1. image.proto

    • Corrected BAYER_RGGR8 to BAYER_BGGR8 in PixelFormatType.

  2. joint.proto

    • The axis.proto message contains joint position, velocity, force, and acceleration information.

  3. serialized.proto

    • SerializedComponent's component field type changed from string to bytes.

  4. sensor.proto

    • Deprecating RaySensor, and replacing with LidarSensor.

Deprecations

  1. joint.proto

    • The angle field is deprecated, use position in the axis.proto message instead.
    • The velocity field is deprecated, use velocity in the axis.proto message instead.

  2. image.proto

    • pixel_format field is deprecated, use pixel_format_type with enum PixelFormatType instead.

Removals

  1. include/ignition/msgs/ign.hh is no longer installed.

Ignition Msgs 2.X to 3.X

Additions

  1. axis_aligned_box.proto

    • New message for axis-aligned bounding boxes.

  2. entity.proto

    • New message to uniquely identify an entity.

  3. entity_factory.proto

    • Add Model field to allow model insertion.

  4. light.proto

    • Add id, parent_id fields.

  5. link.proto

    • Add repeated light field.

  6. twist.proto

    • New message for storing linear and angular velocity.

  7. Utility.hh

    • Conversion functions for axis_aligned_box.proto.

Modifications

  1. Use ignition-cmake2 and ignition-math6.

  2. Use protobuf3 for all messages.

  3. contacts.proto

    • Use Entity instead of string to specify entities in contact.

  4. entity_factory.proto

    • Rename clone_model_name field to clone_name.
    • Remove edit_name field.
    • Use oneof to indicate only one method can be used at a time.

Deprecations

Removals

Ignition Msgs 2.0 to 2.1

Modifications

  1. Use ignition-math6 instead of ignition-math5. This implies an indirect dependency on ignition-cmake2 and cmake 3.10.2, which are not available on Ubuntu Xenial, so migration to Ubuntu Bionic may be required.

Ignition Msgs 1.X to 2.0

Additions

  1. log_control.proto

    • Add record_resources bool to match osrf/gazebo PR 3008.

  2. log_status.proto

    • Add record_resources bool to match osrf/gazebo PR 3008.

  3. sonar.proto

    • Add geometry field.

  4. world_statistics.proto

    • Add real_time_factor field.

Modifications

  1. Use ignition-cmake1 and ignition-math5.

  2. Use inline versioned namespace.

Deprecations

Removals

  1. Generator.hh
    • This file is no longer installed. It served only to make an internal protc plugin that customized the protobuf compiler output.