Warning, /documentation/digikam-doc/light_table/lighttable_advanced.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, focus, points
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_advanced:
0013 Advanced Features
0014 =================
0016 .. contents::
0018 .. _comparing_focuspoints:
0020 Comparing The Focus Points
0021 --------------------------
0023 digiKam Light Table inherits of the **Preview Mode** capabilities as it shares same tools used in background by **Main Window**. One very powerful feature is the Focus Points visualization while comparing images side by side.
0025 Camera can use some points (name auto focus points) on image to make the region around sharper. Besides, it blurs the further region, in order to make an artistic product. These points are named AF points. They can be pre-defined by camera or by user, depend on model of camera. There are only two cases supported by digiKam for AF points: infocused and selected. Infocuses points are the points sharpened by camera, when selected points are the points expected to be clear by user. A point can be both in 2 cases (infocus-selected) or neither both (inactive).
0027 .. figure:: images/light_table_comparing_focus_points.webp
0028     :alt:
0029     :align: center
0031     The digiKam Light Table Comparing Focus Points From a Series Of Shots
0033 Each point is not only a point on the image but a rectangle. Focus Point is used to recognize focus region of image. This is a region where image expected to be clear. Using the focus points visualization while previewing image side by side allows to be sure that the best image was taken with right in-focus shot conditions.
0035 To Show the focus points over the preview canvas, select **Show Focus Points** from context menu.
0037 .. figure:: images/light_table_preview_context_menu.webp
0038     :alt:
0039     :align: center
0041     The digiKam Light Table Preview Canvas Context Menu
0043 Comparing The Sidebars Contents
0044 -------------------------------
0046 One particularity on digiKam Light Table is the sidebar views available on the right and on the left sides. Both visualize provide the same contents as with **Main Window** right sidebar:
0048     - :ref:`Properties <properties_view>`: File and image properties, key shooting parameters.
0050     - :ref:`Metadata <metadata_view>`: Exif, Makernotes, IPTC, XMP, and ExifTool data.
0052     - :ref:`Colors <colors_view>`: Histograms and embedded ICC profiles.
0054     - :ref:`Maps <maps_view>`: View to show GPS location.
0056     - :ref:`Captions <captions_view>`: Comments, Date & Time setting, Labels, Rating, Tags, selected metadata.
0058     - :ref:`Versions <versions_view>`: Image history.
0060 If both left and right sidebar are visible in Light Table, they can be used to compare images information loaded in left and right canvas preview. When you change the item on the right side, right sidebar contents will be updated. In opposite, left side contents will still the same. If both sidebar show the same tab view (as metadata for example), they can be used to compare visually the differences and select the best shot to mark in your workflow.
0062 .. figure:: images/light_table_comparing_sidebars.webp
0063     :alt:
0064     :align: center
0066     The digiKam Light Table Used To Compare Left And Right Metadata Contents
0068 Asset Management In Light Table
0069 -------------------------------
0071 As with the **Main Window** **Preview** Mode, the left and right Light Table preview canvas propose the standard options from the context menu to apply the :ref:`digital asset management <organize_find>` with your images.
0073 Faces Tagging
0074 ~~~~~~~~~~~~~
0076 To manage faces information, the options below are available:
0078 - **Show Face Tags** to highlight face areas over the image.
0079 - **Scan For Faces** to start an automatic faces detection on image.
0080 - **Add a Face Tag** to add manually a face area over the image.
0082 .. figure:: images/light_table_face_management.webp
0083     :alt:
0084     :align: center
0086     The digiKam Light Table Editing A Face Tag From The Preview Canvas
0088 The toolbar on top left corner of preview canvas provide also the same options to manage faces. For more details about the manual face tagging, please consult :ref:`the relevant section <manual_face_tagging>` of this manual.
0090 Assigning Rate Labels and Tags
0091 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0093 To manage Rate, Labels, and Tags, you can use the preview canvas context menu where the relevant entries allows to assign easily these properties. Of course this menu is available to the left and right pane. You can also use the **Caption** tab available on the left sidebar and on the right sidebar. More details about this tab is given in the :ref:`Caption View section <captions_view>` of this manual.
0095 After assigning this kind of properties, you can found the marked items to the **Labels** and **Tags** tabs from the Main Window left sidebar. This will allow you to post-process quickly these items in your workflow, after a triagging with the Light table.
0097 .. figure:: images/light_table_assign_labels.webp
0098     :alt:
0099     :align: center
0101     The digiKam Light Table Assigning A Color Label On The Left Context Menu
0103 Working With Tools From Light Table
0104 -----------------------------------
0106 As **Main Window**, the digiKam Light Table allows to call the tools from the **View**, **Tools**, **Import**, or **Export** menus. Unlike Main Window, Light Table does not have the concept of albums or an icon-view where you can select items to process. Light Table has a thumbbar which is a flat list of items to review with the left and right panes.
0108 For the tools working with pre-selected list of items from Main Window icon-view, the **View**, **Tools**, and **Export** menu options will use the current contents from the thumbbar. For tools working with albums, nothing change, as albums still selectable at tool sessions independently than thumbbar content.
0110 The **Import** tools will simply append to the thumbbar the new contents.
0112 .. figure:: images/light_table_post_processing.webp
0113     :alt:
0114     :align: center
0116     The digiKam Light Table Running Print Creator Tool