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
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_advanced:
0012 
0013 Advanced Features
0014 =================
0015 
0016 .. contents::
0017 
0018 .. _comparing_focuspoints:
0019 
0020 Comparing The Focus Points
0021 --------------------------
0022 
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.
0024 
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).
0026 
0027 .. figure:: images/light_table_comparing_focus_points.webp
0028     :alt:
0029     :align: center
0030 
0031     The digiKam Light Table Comparing Focus Points From a Series Of Shots
0032 
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.
0034 
0035 To Show the focus points over the preview canvas, select **Show Focus Points** from context menu.
0036 
0037 .. figure:: images/light_table_preview_context_menu.webp
0038     :alt:
0039     :align: center
0040 
0041     The digiKam Light Table Preview Canvas Context Menu
0042 
0043 Comparing The Sidebars Contents
0044 -------------------------------
0045 
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:
0047 
0048     - :ref:`Properties <properties_view>`: File and image properties, key shooting parameters.
0049 
0050     - :ref:`Metadata <metadata_view>`: Exif, Makernotes, IPTC, XMP, and ExifTool data.
0051 
0052     - :ref:`Colors <colors_view>`: Histograms and embedded ICC profiles.
0053 
0054     - :ref:`Maps <maps_view>`: View to show GPS location.
0055 
0056     - :ref:`Captions <captions_view>`: Comments, Date & Time setting, Labels, Rating, Tags, selected metadata.
0057 
0058     - :ref:`Versions <versions_view>`: Image history.
0059 
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.
0061 
0062 .. figure:: images/light_table_comparing_sidebars.webp
0063     :alt:
0064     :align: center
0065 
0066     The digiKam Light Table Used To Compare Left And Right Metadata Contents
0067 
0068 Asset Management In Light Table
0069 -------------------------------
0070 
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.
0072 
0073 Faces Tagging
0074 ~~~~~~~~~~~~~
0075 
0076 To manage faces information, the options below are available:
0077 
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.
0081 
0082 .. figure:: images/light_table_face_management.webp
0083     :alt:
0084     :align: center
0085 
0086     The digiKam Light Table Editing A Face Tag From The Preview Canvas
0087 
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.
0089 
0090 Assigning Rate Labels and Tags
0091 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0092 
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.
0094 
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.
0096 
0097 .. figure:: images/light_table_assign_labels.webp
0098     :alt:
0099     :align: center
0100 
0101     The digiKam Light Table Assigning A Color Label On The Left Context Menu
0102 
0103 Working With Tools From Light Table
0104 -----------------------------------
0105 
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.
0107 
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.
0109 
0110 The **Import** tools will simply append to the thumbbar the new contents.
0111 
0112 .. figure:: images/light_table_post_processing.webp
0113     :alt:
0114     :align: center
0115 
0116     The digiKam Light Table Running Print Creator Tool