digikam-doc/slideshow_tools/opengl_viewer.rst

0001 .. meta::
0002    :description: Using digiKam OpenGL Viewer
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, slide, opengl
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 .. _opengl_viewer:
0012
0013 OpenGL Viewer
0014 =============
0015
0016 .. contents::
0017
0018 This tool preview a series of items using OpenGL hardware to speed-up rendering. There is no configuration dialog. Calling this tool from :menuselection:`View --> OpenGL Image Viewer` will show items in full-screen mode.
0019
0020 .. note::
0021
0022     This tool does not include an OSD (On Screen Display). Navigating between items is done with keyboard and mouse.
0023
0024 .. figure:: videos/opengl_viewer.webp
0025     :width: 600px
0026     :alt:
0027     :align: center
0028
0029     Screencast of the OpenGL Viewer
0030
0031 The usage from Keyboard and mouse to quickly navigate between items is listen below:
0032
0033 - Item Access
0034
0035     Previous Item:
0036         :kbd:`Up` key
0037         :kbd:`PgUp` key
0038         :kbd:`Left` key
0039         Mouse wheel up
0040
0041     Next Item:
0042         :kbd:`Down` key
0043         :kbd:`PgDown` key
0044         :kbd:`Right` key
0045         Mouse wheel down
0046
0047     Quit:
0048         :kbd:`Esc` key
0049
0050 - Item Display
0051
0052     Toggle fullscreen to normal:
0053         :kbd:`f` key
0054
0055     Toggle scroll-wheel action:
0056         :kbd:`c` key (either zoom or change image)
0057
0058     Rotation:
0059         :kbd:`r` key
0060
0061     Reset view:
0062         double click
0063
0064     Original size:
0065         :kbd:`o` key
0066
0067     Zooming:
0068         Move mouse in up-down-direction while pressing the right mouse button
0069         :kbd:`c` key and use the scroll-wheel
0070         :kbd:`+` and :kbd:`-` keys
0071         :kbd:`ctrl` + scrollwheel
0072
0073     Panning:
0074         Move mouse while pressing the left button
0075
0076 - Others
0077
0078     Show help dialog:
0079         :kbd:`F1` key