digikam-doc/slideshow_tools/slide_tool.rst

0001 .. meta::
0002    :description: Using digiKam Basic Slide Tool
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, slide
0004
0005 .. metadata-placeholder
0006
0007    :authors: - digiKam Team
0008
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0010
0011 .. _slide_tool:
0012
0013 Basic Slide Show
0014 ================
0015
0016 .. contents::
0017
0018 This tool render a series of items as a basic slide-show. To run this tool you can use the menu entry :menuselection:`View --> Slideshow` sub-menus or simply press the **Show FullScreen** button on top of Icon-View item.
0019
0020 .. figure:: images/slide_button.webp
0021     :alt:
0022     :align: center
0023
0024     The Icon-View Item Show FullScreen Overlay Button
0025
0026 .. note::
0027
0028     The **Show FullScreen** button will be visible only if you turn on the right option from :menuselection:`Settings --> Configure digiKam...` and **Icons** tab from **Views** panel.
0029
0030 The basic slideshow tool will render items on full screen without visual effects and without zooming support. It is powerful to review quickly album items. This tool can play album contents in recursive mode with children albums if any.
0031
0032 .. figure:: images/slide_view.webp
0033     :alt:
0034     :align: center
0035
0036     The Basic Slide-Show View Displaying Item and Properties
0037
0038 A lots of items properties can be displayed as overlay while displaying contents. These ones are shown on the bottom left side as an **OSD (On Screen Display)**.
0039
0040 .. figure:: images/slide_osd.webp
0041     :alt:
0042     :align: center
0043
0044     The Basic Slide-Show Provides an OSD to Show Details and Control the Contents
0045
0046 The basic slide show configuration should be easy to understand. The upper slider adjusts the time between image transitions; usually a time of 4-5 seconds is good. The other check boxes enable/disable the metadata to be shown on the bottom of the slide show images during display.
0047
0048 .. note::
0049
0050     The **Shuffle Images** mode is only available in automatic playback, i.e. when you start the slide show via the menu or toolbar button. It does not work in **Preview** mode when you start on the **Play** button icon in the thumbnail or image preview.
0051
0052 .. figure:: images/slide_config.webp
0053     :alt:
0054     :align: center
0055
0056     The Basic Slide-Show Configuration Dialog
0057
0058 The Usage from Keyboard and mouse to quickly navigate between items is listen below:
0059
0060 - Item Access
0061
0062     Previous Item:
0063         :kbd:`Up` key
0064         :kbd:`PgUp` key
0065         :kbd:`Left` key
0066         Mouse wheel up
0067         Left mouse button
0068
0069     Next Item:
0070         :kbd:`Down` key
0071         :kbd:`PgDown` key
0072         :kbd:`Right` key
0073         Mouse wheel down
0074         Right mouse button
0075
0076     Pause/Start:
0077         :kbd:`Space` key
0078
0079     Slideshow Settings:
0080         :kbd:`F2` key
0081
0082     Hide/Show Properties:
0083         :kbd:`F4` key
0084
0085     Quit:
0086         :kbd:`Esc` key
0087
0088 - Item Properties
0089
0090     Change Tags:
0091         Use Tags keyboard shortcuts
0092
0093     Change Rating:
0094         Use Rating keyboard shortcuts
0095
0096     Change Color Label:
0097         Use Color label keyboard shortcuts
0098
0099     Change Pick Label:
0100         Use Pick label keyboard shortcuts
0101
0102 - Others
0103
0104     Show help dialog:
0105         :kbd:`F1` key