Improve the portal, tide and dissolve transitions with the depth map

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## Unreleased
+
+### Changed
+
+- `portal` grows like a sphere from the surface under the cursor, so it spreads over that first and wraps round things nearer and further away.
+- `dissolve` grows spheres from random places in the scene, like `portal` does from the cursor, further things tending to go first.
+- `tide-in` and `tide-out` find the ground in the scene, so the water rises level with it in views from above or at an angle, instead of always from the bottom of the picture. Close-ups and scenes without clear ground work as before.
+
 ## 0.4.2 - 2026-10-06
 
 ### Fixed

assets/completions/_shiftpaper

@@ -70,8 +70,8 @@ _arguments "${_arguments_options[@]}" : \
 '::name -- The transition to use:((sweep-in\:"A wave sweeps into the scene\: the new wallpaper'\''s nearest things appear first, in front of the old one, and it fills in towards the distance"
 sweep-out\:"A wave sweeps out of the scene\: the old wallpaper'\''s background gives way to the new one first, and its nearest things go last"
 morph\:"Everything changes together, the shape of the scene a little ahead of its colours"
-dissolve\:"Patches of the new wallpaper appear at random, nearer things tending to go first"
-portal\:"The new wallpaper grows out from the cursor like a bubble in the scene, following it if it moves"
+dissolve\:"The new wallpaper grows like spheres in the scene from random places, further things tending to go first"
+portal\:"The new wallpaper grows out from the cursor like a sphere in the scene, and follows the cursor if it moves"
 tide-in\:"The new wallpaper rises through the old like a tide coming in, lowest places first"
 tide-out\:"The old wallpaper drains away like a tide going out, uncovering the new one from the highest places down"))' \
 && ret=0

assets/man/shiftpaper-transition.1

@@ -31,9 +31,9 @@ sweep\-out: A wave sweeps out of the scene: the old wallpaper\*(Aqs background g
 .IP \(bu 2
 morph: Everything changes together, the shape of the scene a little ahead of its colours
 .IP \(bu 2
-dissolve: Patches of the new wallpaper appear at random, nearer things tending to go first
+dissolve: The new wallpaper grows like spheres in the scene from random places, further things tending to go first
 .IP \(bu 2
-portal: The new wallpaper grows out from the cursor like a bubble in the scene, following it if it moves
+portal: The new wallpaper grows out from the cursor like a sphere in the scene, and follows the cursor if it moves
 .IP \(bu 2
 tide\-in: The new wallpaper rises through the old like a tide coming in, lowest places first
 .IP \(bu 2

crates/config/src/lib.rs

@@ -79,11 +79,11 @@ pub enum Transition {
     /// Everything changes together, the shape of the scene a little ahead
     /// of its colours.
     Morph,
-    /// Patches of the new wallpaper appear at random, nearer things
-    /// tending to go first.
+    /// The new wallpaper grows like spheres in the scene from random
+    /// places, further things tending to go first.
     Dissolve,
-    /// The new wallpaper grows out from the cursor like a bubble in the
-    /// scene, following it if it moves.
+    /// The new wallpaper grows out from the cursor like a sphere in the
+    /// scene, and follows the cursor if it moves.
     Portal,
     /// The new wallpaper rises through the old like a tide coming in,
     /// lowest places first.