Merge branch 'marlam:main' into main

NEWS.md

@@ -1,3 +1,19 @@
+Version 2.3:
+- Added support for slideshow mode.
+- Improved support for image file formats, including MPO.
+- Added new capabilities to `--vr-screen` for easy configuration of two-screen
+  stereo setups.
+- Made `--opengles` the default on ARM platforms.
+- Lowered minimum Qt version to 6.4.
+- Lowered minimum OpenGL ES requirements.
+
+Version 2.2:
+- Added support for capturing windows and screens.
+- Added support for HighDPI output.
+- Added support for 3D HDMI frame-pack output mode.
+- Improved performance in multi-host/multi-GPU Virtual Reality setups.
+- Improved compatibility for various OpenGL implementations.
+
 Version 2.1:
 - Added support for loading/saving/editing play lists, with loop modes
   off/one/all.

doc/bino-manual.md

@@ -131,6 +131,18 @@ Bino is a video player with a focus on 3D and Virtual Reality:
 
   Choose subtitle track via its index. Can be empty.
 
+- `-p`, `--playlist` *file*
+
+  Load playlist.
+
+- `-l`, `--loop` *mode*
+
+  Set loop mode (off, one, all).
+
+- `-w`, `--wait` *mode*
+
+  Set wait mode (off, on).
+
 - `-i`, `--input` *mode*
 
   Set input mode (mono, top-bottom, top-bottom-half, bottom-top,
@@ -180,6 +192,29 @@ Most output modes should be self explanatory, but there are some exceptions:
 - `even-odd-rows`, `even-odd-columns` and `checkerboard` are for (older) 3D
   TVs.
 
+# File Name Conventions
+
+Bino currently cannot detect the stereoscopic layout or the surround video mode
+from metadata because Qt does not provide that information. It therefore has to
+guess.
+
+Bino recognizes the following hints at the last part of the file name, just
+before the file name extension (.ext):
+
+- `*-tb.ext`, `*-ab.ext`: Input mode `top-bottom`
+- `*-tbh.ext`, `*-abq.ext`: Input mode `top-bottom-half`
+- `*-bt.ext`, `*-ba.ext`: Input mode `bottom-top`
+- `*-bth.ext`, `*-baq.ext`: Input mode `bottom-top-half`
+- `*-lr.ext`: Input mode `left-right`
+- `*-lrh.ext`, `*-lrq.ext`: Input mode `left-right-half`
+- `*-rl.ext`: Input mode `right-left`
+- `*-rlh.ext`, `*-rlq.ext`: Input mode `right-left-half`
+- `*-2d.ext`: Input mode `mono`
+
+Additionally, if the number `180` or `360` is part of the file name and separated
+by neighboring digits or letters by other characters, then the corresponding surround
+mode is assumed.
+
 # Scripting
 
 Bino can read commands from a script file and execute them via the option
@@ -216,6 +251,10 @@ The following commands are supported:
 
   Stop playing.
 
+- `playlist-load` *playlist.m3u*
+
+  Load the playlist.
+
 - `playlist-next`
 
   Switch to next playlist entry.
@@ -224,6 +263,10 @@ The following commands are supported:
 
   Switch to previous playlist entry.
 
+- `playlist-wait` *mode*
+
+  Set wait mode (off, on).
+
 - `playlist-loop` *mode*
 
   Set loop mode (off, one, all).
@@ -280,28 +323,31 @@ The following commands are supported:
 
   Toggle fullscreen mode.
 
-# File Name Conventions
-
-Bino currently cannot detect the stereoscopic layout or the surround video mode
-from metadata because Qt does not provide that information. It therefore has to
-guess.
-
-Bino recognizes the following hints at the last part of the file name, just
-before the file name extension (.ext):
-
-- `*-tb.ext`, `*-ab.ext`: Input mode `top-bottom`
-- `*-tbh.ext`, `*-abq.ext`: Input mode `top-bottom-half`
-- `*-bt.ext`, `*-ba.ext`: Input mode `bottom-top`
-- `*-bth.ext`, `*-baq.ext`: Input mode `bottom-top-half`
-- `*-lr.ext`: Input mode `left-right`
-- `*-lrh.ext`, `*-lrq.ext`: Input mode `left-right-half`
-- `*-rl.ext`: Input mode `right-left`
-- `*-rlh.ext`, `*-rlq.ext`: Input mode `right-left-half`
-- `*-2d.ext`: Input mode `mono`
-
-Additionally, if the number `180` or `360` is part of the file name and separated
-by neighboring digits or letters by other characters, then the corresponding surround
-mode is assumed.
+# Slideshows
+
+You can play slideshows of images (or videos) simply by making a playlist and
+switching on its *wait* status. This is the default whenever one or more of the
+files you open are images instead of videos; this works from the command line
+as well as from the GUI.
+
+With *wait* enabled, the next media in the playlist will only be displayed after
+you press the N key, or choose Playlist/Next from the menu.
+
+For automatic media switching based on predefined presentation times, use the
+scripting mode as in the following example:
+```
+set-fullscreen on
+playlist-load my-slideshow.m3u
+playlist-loop on
+playlist-wait on
+playlist-next
+wait 4
+playlist-next
+wait 7
+playlist-next
+wait 5
+quit
+```
 
 # Virtual Reality