Warning, /documentation/digikam-doc/light_table/lighttable_overview.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: Overview to digiKam Light Table
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, light table, synchronize, by-pair, compare, preview, canvas
0005 .. metadata-placeholder
0007    :authors: - digiKam Team
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0011 .. _lighttable_overview:
0013 Overview
0014 ========
0016 .. contents::
0018 .. figure:: images/light_table_main_view.webp
0019     :alt:
0020     :align: center
0022     The Light Table Comparing Side By Side Two RAW Files
0024 digiKam features a light table in a separate window to easily compare images. It works with all supported image formats including RAW files.
0026 .. figure:: images/light_table_context_menu.webp
0027     :alt:
0028     :align: center
0030     The Main Icon-View Context Menu To Place Items To Compare On Light Table
0032 Select one or several images in any view from the main window, call **Place onto Light Table** :kbd:`Ctrl+L` from the context menu. The selection will be added to the light table, and its separate window will open. When you are back to the digiKam main window you can quickly access the light table with :menuselection:`Tools --> Light Table` :kbd:`L`.
0034 .. figure:: videos/light_table_item_selection.webp
0035     :width: 600px
0036     :alt:
0037     :align: center
0039     Screencast Of The digiKam Light Table Item Selection From the Thumbbar
0041 Playing With The Stack Contents
0042 ===============================
0044 Synchronized Mode
0045 -----------------
0047 From the thumbbar drag & drop images to the left and right comparison pane below. A little arrow will indicate which copy is shown in which pane. The current selected pane will be highlighted by frame. If you choose **Synchronize** from the toolbar, any zoom and panning in one window will be synchronously executed in the other pane, so that you can compare the same areas of two images.
0049 .. figure:: videos/light_table_views_synchronized.webp
0050     :width: 600px
0051     :alt:
0052     :align: center
0054     Screencast Of The digiKam Light Table Using The **Synchonize** Mode With Side By Side Views
0056 By Pair Mode
0057 ------------
0059 Another mode is better suited for quickly culling from a series of images. If you choose **By Pair** from the toolbar, the first two images will be automatically inserted into the comparison panes. Click on any thumbnail to make it the left side preview, the adjacent thumbnail to the right will be inserted into the right pane. That make it easy to sift through a series of similar images.
0061 .. figure:: videos/light_table_views_bypair.webp
0062     :width: 600px
0063     :alt:
0064     :align: center
0066     Screencast of the digiKam Light Table Using The **By-Pair** Mode With Side By Side Views
0068 Of course, the usual edit actions work from the light table directly using :menuselection:`File --> Edit...` :kbd:`F4`. This open current selected preview canvas in **Image Editor**.
0070 All image information from the main window right sidebar is available for each of the two previews in the light table. The Light Table **Left Sidebar** is dedicated to the **Left Pane**, and the **Right Sidebar** for the **Right Pane**. This makes it easy to link visual differences to exposure data for example.
0072 In the lower right corner of each pane there you find a built-in panning action (crossed arrows). Click on it and keep the left mouse button pressed to pan across the image (with **Synchrone** mode, both images will show the same viewing point).
0074 Zooming works the same as in other views: use indifferently the zoom slider below the panes or **Ctrl-scroll wheel** to zoom in and out, with both images when **Synchrone** mode is selected.
0076 .. tip::
0078     If you use muti-screen on your computer, it's a good idea to place **Main Window** on a screen and the **Light Table** on other one to increase your experience.
0080 .. note::
0082     Light Table has a specific configuration page from digiKam setup dialog. For more details, read :ref:`this section <lighttable_settings>` from the manual.