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
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 .. _lighttable_overview:
0012 
0013 Overview
0014 ========
0015 
0016 .. contents::
0017 
0018 .. figure:: images/light_table_main_view.webp
0019     :alt:
0020     :align: center
0021 
0022     The Light Table Comparing Side By Side Two RAW Files
0023 
0024 digiKam features a light table in a separate window to easily compare images. It works with all supported image formats including RAW files.
0025 
0026 .. figure:: images/light_table_context_menu.webp
0027     :alt:
0028     :align: center
0029 
0030     The Main Icon-View Context Menu To Place Items To Compare On Light Table
0031 
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`.
0033 
0034 .. figure:: videos/light_table_item_selection.webp
0035     :width: 600px
0036     :alt:
0037     :align: center
0038 
0039     Screencast Of The digiKam Light Table Item Selection From the Thumbbar
0040 
0041 Playing With The Stack Contents
0042 ===============================
0043 
0044 Synchronized Mode
0045 -----------------
0046 
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.
0048 
0049 .. figure:: videos/light_table_views_synchronized.webp
0050     :width: 600px
0051     :alt:
0052     :align: center
0053 
0054     Screencast Of The digiKam Light Table Using The **Synchonize** Mode With Side By Side Views
0055 
0056 By Pair Mode
0057 ------------
0058 
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.
0060 
0061 .. figure:: videos/light_table_views_bypair.webp
0062     :width: 600px
0063     :alt:
0064     :align: center
0065 
0066     Screencast of the digiKam Light Table Using The **By-Pair** Mode With Side By Side Views
0067 
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**.
0069 
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.
0071 
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).
0073 
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.
0075 
0076 .. tip::
0077 
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.
0079 
0080 .. note::
0081 
0082     Light Table has a specific configuration page from digiKam setup dialog. For more details, read :ref:`this section <lighttable_settings>` from the manual.