Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Transition from darktable #5

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 1 addition & 16 deletions content/modules/processing-modules/color-calibration.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: color calibration
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: color-calibration
applicable-version: 4.0
working-color-space: RGB
Expand Down Expand Up @@ -128,22 +129,6 @@ In all these cases, you **must** enable the "clip negative RGB from gamut" optio

---

### CAT warnings

The chromatic adaptation in this module relies on a number of assumptions about the earlier processing steps in the pipeline in order to work correctly, and it can be easy to inadvertently break those assumptions in subtle ways. To help you to avoid these kinds of mistakes, the _color calibration_ module will show warnings in the following circumstances.

- If the _color calibration_ module is set up to perform chromatic adaptation but the _white balance_ module is not set to "camera reference", warnings will be shown in both modules. These errors can be resolved either by setting the _white balance_ module to "camera reference" or by disabling chromatic adaptation in the _color calibration_ module. Note that some sensors may require minor corrections within the _white balance_ module in which case these warnings can be ignored.

- If two or more instances of _color calibration_ have been created, each attempting to perform chromatic adaptation, an error will be shown on the second instance. This could be a valid use case (for instance where masks have been set up to apply different white balances to different non-overlapping areas of the image) in which case the warnings can be ignored. For most other cases, chromatic adaptation should be disabled in one of the instances to avoid double-corrections.

By default, if an instance of the _color calibration_ module is already performing chromatic adaptation, each new instance you create will automatically have its adaptation set to "none (bypass)" to avoid this "double-correction" error.

The chromatic adaptation modes in _color calibration_ can be disabled by either setting the _adaptation_ to "none (bypass)" or setting the _illuminant_ to "same as pipeline (D50)" in the CAT tab.

These warnings are intended to prevent common and easy mistakes while using the automatic default presets in the module in a typical RAW editing workflow. When using custom presets and some specific workflows, such as editing film scans or JPEGs, these warnings can and should be ignored.

Advanced users can disable module warnings in [preferences > processing > show warning messages](../../preferences-settings/processing.md).

## channel mixing

The remainder of this module is a standard channel mixer, allowing you to adjust the output R, G, B, colorfulness, brightness and gray of the module based on the relative strengths of the R, G and B input channels.
Expand Down
3 changes: 1 addition & 2 deletions content/modules/utility-modules/darkroom/soft-proof.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: soft proof
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: soft-proof
applicable-version: 3.6
tags:
Expand All @@ -16,8 +17,6 @@ Right-click on the icon to open a dialog with the following configuration parame
display profile
: Set the color profile for the display. The option “system display profile” is the preferred setting when working with a calibrated display. The profile is taken either from your system's color manager or from your X display server. The method darktable uses to detect your system display profile can be changed in [preferences > miscellaneous](../../../preferences-settings/miscellaneous.md). For more information see the [display profile](../../../color-management/display-profile.md) section.

preview display profile
: Set the color profile for the preview image if you are using a second window.

intent
: Set the rendering intent for your display -- only available if rendering with LittleCMS2 is activated. See [rendering intent](../../../color-management/rendering-intent.md) for a list of available options. This option appears twice -- once for the "display profile" and once for the "preview display profile".
Expand Down
40 changes: 10 additions & 30 deletions content/modules/utility-modules/lighttable/import.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
---
title: import
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: import
applicable-version: 3.8
tags:
tags:
view: lighttable
---

Expand All @@ -15,24 +16,11 @@ See [supported file formats](../../../overview/supported-file-formats.md) for mo

The following buttons are shown in the module's UI by default:

[add to library](#add-to-library)
[Open from disk](#open-from-disk)
: Add existing images to the darktable library without copying or moving files. If you only add a single image to the library it will be automatically loaded in the darkroom.

[copy & import](#copy--import)
: Create copies of images from the filesystem and then add those copies to the darktable library.

When a camera is detected, a new section will appear in the module for that device. If you hover your mouse over the camera label, a tooltip will display information about the camera (model, firmware version etc.)

Depending on the capabilities of the camera, the following additional buttons may be displayed:

mount camera
: Mount the camera for exclusive use by darktable. This button only appears if the camera is not currently mounted and is not locked by another process.

[copy & import from camera](#copy--import-from-camera)
: Create copies of images from the connected camera and then add those images to the darktable library. This button only appears if the camera is currently mounted.

unmount camera
: Unmount the camera and release it for use by other applications. This button only appears if the camera is currently mounted.
[Import from camera](#import-from-camera)
: Create copies of images from the filesystem and then add those copies to the Ansel library.

## module parameters

Expand Down Expand Up @@ -61,9 +49,7 @@ tags

## import dialog

Each of the three import buttons (add to library, copy & import, copy & import from camera) uses a similar dialog for the import process, described in this section.

The following example screenshot is taken from the "add to library" button:
The following example screenshot is taken from the "Open from disk" button:

![import-dialog](./import/import-dialog.png#w100)

Expand Down Expand Up @@ -97,22 +83,22 @@ recursive directory
ignore JPEG images
: Check this option if there are `JPEG` images in the same folder that you do not wish to import. This option is usually used where the camera stores `RAW+JPEG` and you only want to work on the `RAW` files, leaving the `JPEG` images untouched.

### add to library
### Open from disk

The "add to library" button allows you to add one or more existing images to the darktable library from the local filesystem. This process does not copy or move images but merely adds their details to the library database and creates XMP sidecar files for them.
The "Open from disk" button allows you to add one or more existing images to the darktable library from the local filesystem. This process does not copy or move images but merely adds their details to the library database and creates XMP sidecar files for them.

select only new pictures
: Tick this box to restrict the _initial_ selection (when the dialog is loaded) to only those images that have not already been loaded into the darktable library. If you attempt to reload existing images into the darktable library, data for those images will be reloaded from the XMP sidecar files. A button is also available at the bottom of the dialog to select only "new" images for the currently-selected folder.

---

**Note:** "Add to library" does not create duplicates of your image files in a separate folder structure but processes them in-situ. The "add to library" process simply adds details of those images to darktable's library database (and creates an XMP sidecar file if applicable) allowing the images to be viewed and developed.
**Note:** "Open from disk" does not create duplicates of your image files in a separate folder structure but processes them in-situ. The "Open from disk" process simply adds details of those images to darktable's library database (and creates an XMP sidecar file if applicable) allowing the images to be viewed and developed.

This means that if you delete images from disk after having added them, darktable cannot access them any more. Moreover, darktable does not watch for changes in the filesystem. Any new images will not be shown until they are explicitly imported.

---

### copy & import
### Import from camera

This option copies images from another location on your filesystem (including mounted storage devices) and then adds the copied images to the darktable library.

Expand All @@ -138,9 +124,3 @@ file naming pattern

keep this window open
: Keep the window open after the import is complete, allowing multiple imports but with different naming options.

Most of these options can also be set in [preferences > import](../../../../preferences-settings/import.md). See this section for more information about the available variables.

### copy & import from camera

This option copies files from a connected camera to the local filesystem and then adds the copied images to the darktable library. It provides the same naming options as the "copy & import" dialog but does not allow places or folders to be selected.
3 changes: 1 addition & 2 deletions content/modules/utility-modules/shared/export.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: export
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: export-selected
applicable-version: 3.6
tags:
Expand All @@ -9,8 +10,6 @@ view: lighttable

Export selected images.

When used in the darkroom view, the currently-edited image will be exported if no other images are selected in the filmstrip.

Files can be exported to a file on disk, email, various online storage locations, a web album, or a book template.

## module controls
Expand Down
13 changes: 1 addition & 12 deletions content/modules/utility-modules/shared/scopes.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: scopes
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: scopes
applicable-version: 3.8
tags:
Expand Down Expand Up @@ -84,18 +85,6 @@ The graph includes a "hue ring" representing the maximum chroma of each hue (in
- The vectorscope does not have a "skin tone line", which is a flawed generalization rather than a universal standard.
- The vectorscope represents a colorimetric encoding of an image, which inevitably diverges from a viewer's perception of the image.

## exposure adjustment

The histogram, waveform, and RGB parade scopes can be used to directly alter the _exposure_ and _black level_ of the [_exposure_](../../processing-modules/exposure.md) module.

For the histogram, click towards the right-hand side of the histogram and then drag right to increase or drag left to decrease the exposure. In a similar manner you can control the black level by clicking and dragging in the left-hand side.

For horizontal waveform and RGB parade, drag the upper portion of the scope up/down to increase/decrease exposure. Drag the lower portion up/down to increase/decrease the black level.

For vertical waveform and RGB parade scopes, the corresponding regions are to the right (exposure) and left (black level).

You can also scroll in the appropriate area -- rather than dragging -- to adjust exposure and black point. Double-click in the scope to reset the exposure module's parameters to their defaults.

## histogram profile

Image data is converted to the _histogram profile_ before the scope data is calculated. You can choose this profile by right-clicking on the [soft-proof](../darkroom/soft-proof.md) or [gamut check](../darkroom/gamut.md) icons in the bottom panel and then selecting the profile of interest. When soft-proof or gamut check is enabled, the scope is shown in the soft proof profile.
Expand Down
5 changes: 2 additions & 3 deletions content/overview/user-interface.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: user interface
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-01-21
lastmod: 2023-10-12
id: user-interface
draft: false
weight: 10
Expand Down Expand Up @@ -55,7 +55,7 @@ Bottom panel
: Provides buttons to access to view-specific settings and shortcuts. Can be hidden and shown by pressing <kbd>Shift + Ctrl + B</kbd>

[Filmstrip](../../modules/utility-modules/shared/filmstrip.md)
: An optional panel that can be enabled at the bottom of the screen to display a timeline (in the lighttable view) or a filmstrip (in other views) of images in the current collection. Can be shown and hidden by pressing <kbd>Shift + Ctrl + F</kbd>.
: An optional panel that can be enabled at the bottom of the screen in Darkroom, Maps and Print view to display a filmstrip of images in the current collection. Can be shown and hidden by pressing <kbd>Shift + Ctrl + F</kbd>.

### Resizing

Expand Down Expand Up @@ -95,7 +95,6 @@ Grouping

Thumbnail overlays
: Define what information is overlaid on to thumbnails in the lighttable/filmstrip.
: You can define different settings depending on the thumbnail size. See [preferences > lighttable](../../preferences-settings/lighttable.md#thumbnails) for details of how size delimiters are set.


### Filmstrip
Expand Down
3 changes: 2 additions & 1 deletion content/preferences-settings/general.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: general
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: general
weight: 20
draft: false
Expand All @@ -12,7 +13,7 @@ interface language
: Set the language of the user interface. The system default is marked with an * (needs a restart)

theme
: Set the theme for the user interface. Aside from any aesthetic considerations, the recommended interface color for color evaluation is middle gray. Visual perception is affected by ambient brightness, and a low user interface brightness causes all kinds of illusions. Using a dark interface to retouch photos can therefore lead to excessive retouching (abuse of contrast and saturation) and to a photo that is too dark when printed. It is therefore highly recommended that you use one of the "grey" themes for retouching work as these are designed so that the user interface approximates middle gray (default "Ansel-elegant-grey").
: Set the theme for the user interface. Aside from any aesthetic considerations, the recommended interface color for color evaluation is middle gray. Visual perception is affected by ambient brightness, and a low user interface brightness causes all kinds of illusions. Using a dark interface to retouch photos can therefore lead to excessive retouching (abuse of contrast and saturation) and to a photo that is too dark when printed. It is therefore highly recommended that you use one of the "grey" themes for retouching work as these are designed so that the user interface approximates middle gray (default "Ansel").

use system font size
: Select this option to use the font size defined by your system. If unchecked, you may enter a custom font size in the box below (default on).
Expand Down
58 changes: 0 additions & 58 deletions content/preferences-settings/import.md

This file was deleted.

9 changes: 1 addition & 8 deletions content/preferences-settings/lighttable.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: lighttable
date: 2022-12-04T02:19:02+01:00
lastmod: 2023-10-12
id: lighttable
weight: 40
draft: false
Expand All @@ -22,8 +23,6 @@ expand a single utility module at a time
scroll to utility modules when expanded/collapsed
: With this option enabled the side panels will scroll a utility module to the top of the panel when it is expanded or collapsed (default off).

rating an image one star twice will not zero out the rating
: Normally clicking a one star rating twice will set a zero star rating to that image. Check this option to disable this functionality (default off).

show scrollbars for center view
: Choose whether to show scrollbars in the center view of the lighttable (default on).
Expand All @@ -41,9 +40,3 @@ high quality processing from size

delimiters for size categories
: Size categories are used to allow different thumbnail overlays to be shown depending on the thumbnail size. A pipe delimited set of values defines at what image sizes the category changes. The default value of "120|400" means that there will be 3 categories of thumbnail: 0-120px, 120-400px and >400px.

pattern for the thumbnail extended overlay text
: If you have chosen to show extended overlay text over thumbnail images, this setting allows you to define what information is displayed. This pattern can use any of the variables defined in the [variables](../special-topics/variables.md) section. You can also include [formatting](../special-topics/variables.md#formatting) (bold, italic, colors etc).

pattern for the thumbnail tooltip (empty to disable)
: Defines what information is displayed in the tooltip when the mouse hovers over image thumbnails. This pattern can also use the same variables and formatting as the extended overlay text.
5 changes: 4 additions & 1 deletion content/preferences-settings/other-views.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,18 @@
---
title: Other views
date: 2023-01-21
lastmod: 2023-10-11
id: processing
weight: 60
draft: false
---

Enable optional views:

* [map](../views/map/),
* [map](../views/map/)
* [slideshow](../views/slideshow/)
* [print](../views/print/)

Once you restart Ansel the enabled view(s) will be available in the Ateliers menu.

These views are all hidden by default to spare some computing resources.
Loading