Reformat all comments using rustfmt (djeedai#29)

Author: SUPERCILEX

examples/sequence.rs

@@ -118,7 +118,8 @@ fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
                 end: pair[1] - center,
             },
         )
-        .with_completed_event(true, index as u64) // Get an event after each segment
+        // Get an event after each segment
+        .with_completed_event(true, index as u64)
     }));
 
     commands
@@ -133,8 +134,8 @@ fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
         .insert(RedSprite)
         .insert(Animator::new(seq));
 
-    // First move from left to right, then rotate around self 180 degrees while scaling
-    // size at the same time.
+    // First move from left to right, then rotate around self 180 degrees while
+    // scaling size at the same time.
     let tween_move = Tween::new(
         EaseFunction::QuadraticInOut,
         TweeningType::Once,
@@ -163,10 +164,11 @@ fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
             end: Vec3::splat(2.0),
         },
     );
-    // Build parallel tracks executing two tweens at the same time : rotate and scale.
+    // Build parallel tracks executing two tweens at the same time: rotate and
+    // scale.
     let tracks = Tracks::new([tween_rotate, tween_scale]);
-    // Build a sequence from an heterogeneous list of tweenables by casting them manually
-    // to a boxed Tweenable<Transform> : first move, then { rotate + scale }.
+    // Build a sequence from an heterogeneous list of tweenables by casting them
+    // manually to a BoxedTweenable: first move, then { rotate + scale }.
     let seq2 = Sequence::new([Box::new(tween_move) as BoxedTweenable<_>, tracks.into()]);
 
     commands

src/lens.rs

@@ -2,29 +2,30 @@
 //!
 //! # Predefined lenses
 //!
-//! This module contains predefined lenses for common use cases. Those lenses are
-//! entirely optional. They can be used if they fit your use case, to save some time,
-//! but are not treated any differently from a custom user-provided lens.
+//! This module contains predefined lenses for common use cases. Those lenses
+//! are entirely optional. They can be used if they fit your use case, to save
+//! some time, but are not treated any differently from a custom user-provided
+//! lens.
 //!
 //! # Rotations
 //!
 //! Several rotation lenses are provided, with different properties.
 //!
 //! ## Shortest-path rotation
 //!
-//! The [`TransformRotationLens`] animates the [`rotation`] field of a [`Transform`]
-//! component using [`Quat::slerp()`]. It inherits the properties of that method, and
-//! in particular the fact it always finds the "shortest path" from start to end. This
-//! is well suited for animating a rotation between two given directions, but will
-//! provide unexpected results if you try to make an entity rotate around a given axis
-//! for more than half a turn, as [`Quat::slerp()`] will then try to move "the other
-//! way around".
+//! The [`TransformRotationLens`] animates the [`rotation`] field of a
+//! [`Transform`] component using [`Quat::slerp()`]. It inherits the properties
+//! of that method, and in particular the fact it always finds the "shortest
+//! path" from start to end. This is well suited for animating a rotation
+//! between two given directions, but will provide unexpected results if you try
+//! to make an entity rotate around a given axis for more than half a turn, as
+//! [`Quat::slerp()`] will then try to move "the other way around".
 //!
 //! ## Angle-focused rotations
 //!
-//! Conversely, for cases where the rotation direction is important, like when trying
-//! to do a full 360-degree turn, a series of angle-based interpolation lenses is
-//! provided:
+//! Conversely, for cases where the rotation direction is important, like when
+//! trying to do a full 360-degree turn, a series of angle-based interpolation
+//! lenses is provided:
 //! - [`TransformRotateXLens`]
 //! - [`TransformRotateYLens`]
 //! - [`TransformRotateZLens`]
@@ -38,9 +39,10 @@ use bevy::prelude::*;
 
 /// A lens over a subset of a component.
 ///
-/// The lens takes a `target` component or asset from a query, as a mutable reference,
-/// and animates (tweens) a subset of the fields of the component/asset based on the
-/// linear ratio `ratio` in \[0:1\], already sampled from the easing curve.
+/// The lens takes a `target` component or asset from a query, as a mutable
+/// reference, and animates (tweens) a subset of the fields of the
+/// component/asset based on the linear ratio `ratio` in \[0:1\], already
+/// sampled from the easing curve.
 ///
 /// # Example
 ///
@@ -63,16 +65,17 @@ use bevy::prelude::*;
 ///   }
 /// }
 /// ```
-///
 pub trait Lens<T> {
-    /// Perform a linear interpolation (lerp) over the subset of fields of a component
-    /// or asset the lens focuses on, based on the linear ratio `ratio`. The `target`
-    /// component or asset is mutated in place. The implementation decides which fields
-    /// are interpolated, and performs the animation in-place, overwriting the target.
+    /// Perform a linear interpolation (lerp) over the subset of fields of a
+    /// component or asset the lens focuses on, based on the linear ratio
+    /// `ratio`. The `target` component or asset is mutated in place. The
+    /// implementation decides which fields are interpolated, and performs
+    /// the animation in-place, overwriting the target.
     fn lerp(&mut self, target: &mut T, ratio: f32);
 }
 
-/// A lens to manipulate the [`color`] field of a section of a [`Text`] component.
+/// A lens to manipulate the [`color`] field of a section of a [`Text`]
+/// component.
 ///
 /// [`color`]: https://docs.rs/bevy/0.7.0/bevy/text/struct.TextStyle.html#structfield.color
 /// [`Text`]: https://docs.rs/bevy/0.7.0/bevy/text/struct.Text.html
@@ -90,7 +93,8 @@ pub struct TextColorLens {
 #[cfg(feature = "bevy_ui")]
 impl Lens<Text> for TextColorLens {
     fn lerp(&mut self, target: &mut Text, ratio: f32) {
-        // Note: Add<f32> for Color affects alpha, but not Mul<f32>. So use Vec4 for consistency.
+        // Note: Add<f32> for Color affects alpha, but not Mul<f32>. So use Vec4 for
+        // consistency.
         let start: Vec4 = self.start.into();
         let end: Vec4 = self.end.into();
         let value = start.lerp(end, ratio);
@@ -120,13 +124,15 @@ impl Lens<Transform> for TransformPositionLens {
 /// A lens to manipulate the [`rotation`] field of a [`Transform`] component.
 ///
 /// This lens interpolates the [`rotation`] field of a [`Transform`] component
-/// from a `start` value to an `end` value using the spherical linear interpolation
-/// provided by [`Quat::slerp()`]. This means the rotation always uses the shortest
-/// path from `start` to `end`. In particular, this means it cannot make entities
-/// do a full 360 degrees turn. Instead use [`TransformRotateXLens`] and similar
-/// to interpolate the rotation angle around a given axis.
+/// from a `start` value to an `end` value using the spherical linear
+/// interpolation provided by [`Quat::slerp()`]. This means the rotation always
+/// uses the shortest path from `start` to `end`. In particular, this means it
+/// cannot make entities do a full 360 degrees turn. Instead use
+/// [`TransformRotateXLens`] and similar to interpolate the rotation angle
+/// around a given axis.
 ///
-/// See the [top-level `lens` module documentation] for a comparison of rotation lenses.
+/// See the [top-level `lens` module documentation] for a comparison of rotation
+/// lenses.
 ///
 /// [`rotation`]: https://docs.rs/bevy/0.7.0/bevy/transform/components/struct.Transform.html#structfield.rotation
 /// [`Transform`]: https://docs.rs/bevy/0.7.0/bevy/transform/components/struct.Transform.html
@@ -150,10 +156,11 @@ impl Lens<Transform> for TransformRotationLens {
 ///
 /// This lens interpolates the rotation angle of a [`Transform`] component from
 /// a `start` value to an `end` value, for a rotation around the X axis. Unlike
-/// [`TransformRotationLens`], it can produce an animation that rotates the entity
-/// any number of turns around its local X axis.
+/// [`TransformRotationLens`], it can produce an animation that rotates the
+/// entity any number of turns around its local X axis.
 ///
-/// See the [top-level `lens` module documentation] for a comparison of rotation lenses.
+/// See the [top-level `lens` module documentation] for a comparison of rotation
+/// lenses.
 ///
 /// [`Transform`]: https://docs.rs/bevy/0.7.0/bevy/transform/components/struct.Transform.html
 /// [top-level `lens` module documentation]: crate::lens
@@ -176,10 +183,11 @@ impl Lens<Transform> for TransformRotateXLens {
 ///
 /// This lens interpolates the rotation angle of a [`Transform`] component from
 /// a `start` value to an `end` value, for a rotation around the Y axis. Unlike
-/// [`TransformRotationLens`], it can produce an animation that rotates the entity
-/// any number of turns around its local Y axis.
+/// [`TransformRotationLens`], it can produce an animation that rotates the
+/// entity any number of turns around its local Y axis.
 ///
-/// See the [top-level `lens` module documentation] for a comparison of rotation lenses.
+/// See the [top-level `lens` module documentation] for a comparison of rotation
+/// lenses.
 ///
 /// [`Transform`]: https://docs.rs/bevy/0.7.0/bevy/transform/components/struct.Transform.html
 /// [top-level `lens` module documentation]: crate::lens
@@ -202,10 +210,11 @@ impl Lens<Transform> for TransformRotateYLens {
 ///
 /// This lens interpolates the rotation angle of a [`Transform`] component from
 /// a `start` value to an `end` value, for a rotation around the Z axis. Unlike
-/// [`TransformRotationLens`], it can produce an animation that rotates the entity
-/// any number of turns around its local Z axis.
+/// [`TransformRotationLens`], it can produce an animation that rotates the
+/// entity any number of turns around its local Z axis.
 ///
-/// See the [top-level `lens` module documentation] for a comparison of rotation lenses.
+/// See the [top-level `lens` module documentation] for a comparison of rotation
+/// lenses.
 ///
 /// [`Transform`]: https://docs.rs/bevy/0.7.0/bevy/transform/components/struct.Transform.html
 /// [top-level `lens` module documentation]: crate::lens
@@ -227,11 +236,12 @@ impl Lens<Transform> for TransformRotateZLens {
 /// A lens to rotate a [`Transform`] component around a given fixed axis.
 ///
 /// This lens interpolates the rotation angle of a [`Transform`] component from
-/// a `start` value to an `end` value, for a rotation around a given axis. Unlike
-/// [`TransformRotationLens`], it can produce an animation that rotates the entity
-/// any number of turns around that axis.
+/// a `start` value to an `end` value, for a rotation around a given axis.
+/// Unlike [`TransformRotationLens`], it can produce an animation that rotates
+/// the entity any number of turns around that axis.
 ///
-/// See the [top-level `lens` module documentation] for a comparison of rotation lenses.
+/// See the [top-level `lens` module documentation] for a comparison of rotation
+/// lenses.
 ///
 /// # Panics
 ///
@@ -327,7 +337,8 @@ pub struct ColorMaterialColorLens {
 #[cfg(feature = "bevy_sprite")]
 impl Lens<ColorMaterial> for ColorMaterialColorLens {
     fn lerp(&mut self, target: &mut ColorMaterial, ratio: f32) {
-        // Note: Add<f32> for Color affects alpha, but not Mul<f32>. So use Vec4 for consistency.
+        // Note: Add<f32> for Color affects alpha, but not Mul<f32>. So use Vec4 for
+        // consistency.
         let start: Vec4 = self.start.into();
         let end: Vec4 = self.end.into();
         let value = start.lerp(end, ratio);
@@ -351,7 +362,8 @@ pub struct SpriteColorLens {
 #[cfg(feature = "bevy_sprite")]
 impl Lens<Sprite> for SpriteColorLens {
     fn lerp(&mut self, target: &mut Sprite, ratio: f32) {
-        // Note: Add<f32> for Color affects alpha, but not Mul<f32>. So use Vec4 for consistency.
+        // Note: Add<f32> for Color affects alpha, but not Mul<f32>. So use Vec4 for
+        // consistency.
         let start: Vec4 = self.start.into();
         let end: Vec4 = self.end.into();
         let value = start.lerp(end, ratio);