.. meta::
   :description: Using digiKam OpenGL Viewer
   :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, slide, opengl

.. metadata-placeholder

   :authors: - digiKam Team

   :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)

.. _opengl_viewer:

:ref:`OpenGL Viewer <slideshow_tools>`
======================================

This tool previews 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.

.. note::

    This tool does not include an OSD (On Screen Display). Navigating between items is done with the keyboard and mouse.

.. figure:: videos/opengl_viewer.webp
    :width: 600px
    :alt:
    :align: center

    Screencast of the OpenGL Viewer

The keyboard and mouse actions used to navigate between items are:

- Item Access

    Previous Item:
        :kbd:`Up` key
        :kbd:`PgUp` key
        :kbd:`Left` key
        Mouse wheel up

    Next Item:
        :kbd:`Down` key
        :kbd:`PgDown` key
        :kbd:`Right` key
        Mouse wheel down

    Quit:
        :kbd:`Esc` key

- Item Display

    Toggle fullscreen to normal:
        :kbd:`f` key

    Toggle scroll-wheel action:
        :kbd:`c` key (either zoom or change image)

    Rotation:
        :kbd:`r` key

    Reset view:
        double click

    Original size:
        :kbd:`o` key

    Zooming:
        Move mouse in up-down-direction while pressing the right mouse button
        :kbd:`c` key and use the scroll-wheel
        :kbd:`+` and :kbd:`-` keys
        :kbd:`ctrl` + scrollwheel

    Panning:
        Move mouse while pressing the left button

- Others

    Show help dialog:
        :kbd:`F1` key