digikam-doc/slideshow_tools/presentation_tool.rst

0001 .. meta::
0002    :description: Using digiKam Presentation Tool
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, slide, presentation, OpenGL, effects
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 .. _presentation_tool:
0012
0013 Presentation Tool
0014 =================
0015
0016 .. contents::
0017
0018 The **Presentation** tool creates a configurable full screen slide-show of your images using advanced visual effects.
0019
0020 With this tool you can create a perfect slide show with just three mouse clicks. When opening the tool from the :menuselection:`View --> Presentation` menu, the Presentation window **Main** page will appear asking questions as to how you want to stage your slide show. You can choose between the selected images or all images in the same album.
0021
0022 .. figure:: images/presentation_main.webp
0023     :alt:
0024     :align: center
0025
0026     The Presentation Tool Dialog
0027
0028 The **Use OpenGL Transitions** checkbox enables very smooth image transitions using the OpenGL display mode. Be sure you have OpenGL enabled on your graphics card, since otherwise the slideshow will be very slow.
0029
0030 The **Print Filename** checkbox enables displaying the image filename in the lower left corner.
0031
0032 The **Loop** checkbox will enable running the whole show in an endless loop (until manually stopped with :kbd:`Esc`).
0033
0034 The **Shuffle Images** checkbox will enable displaying the images randomly (not using the current images collection order).
0035
0036 The **Delay Between Images** may be set in millisecond steps. 1500 milliseconds correspond to 1.5 seconds and is a good default value. The best timing depends also a bit on your computer power and the transition effect. Try it out before you show it to your friends!
0037
0038 There are more than a dozen **Transition Effects** available to choose from. The **Random** selection will change the transition effect with every image.
0039
0040 The **Caption** page from the tool allows to customize the font properties to render item description over the screen.
0041
0042 .. figure:: images/presentation_caption.webp
0043     :alt:
0044     :align: center
0045
0046     The Caption Settings from Presentation Tool
0047
0048 The **Soundtrack** page from the tool allows to append audio tracks to play while slideshow.
0049
0050 .. figure:: images/presentation_soundtrack.webp
0051     :alt:
0052     :align: center
0053
0054     The Soundtrack Settings from Presentation Tool
0055
0056 The **Advanced** page from the tool allows to customize special slideshow settings to use in particular conditions.
0057
0058 .. figure:: images/presentation_advanced.webp
0059     :alt:
0060     :align: center
0061
0062     The Advanced Settings from Presentation Tool
0063
0064 During the slide-show, you can access a toolbar on the upper left screen corner. Move the mouse cursor to the top left of the screen to access it.
0065
0066 With this tool bar, you can drive the progress of the slide show. You can pause or play the slide-show, go back to the preview image, go to the next image, and stop the slide-show.
0067
0068 In the lower left screen corner you can see the current image file name, the current image index, and the total number of images included in the slide-show.
0069
0070 .. figure:: videos/presentation_view.webp
0071     :width: 600px
0072     :alt:
0073     :align: center
0074
0075     Screencast of the Presentation Tool Running With Cube OpenGL Effect and Showing OSD on the Top of Screen
0076