Home

darktable 1.1

Contents

1. 22 3 4 Color picker Within the global color picker panel you can take col y color picker or samples from your image display their values in multiple ways and compare colors from different lo cations Color picker is activated by pressing icon B wi Various parameters control how color picker works a All settings remain in effect until you leave darkroom restrict histogram to selection mode display sample areas on image Besides the global color picker which we describe here there are local color pickers in various modules eg tonecurve Global and local color pickers are different The global color picker works in monitor color space it takes samples after the complete pixelpipe has been processed and colors are transfered into RGB suited for your monitor The local color pickers run in the color space of the individual module which is most often Lab they only see input and or output colors of that specific module within pixelpipe Color picker can be run in point or area mode When in point mode only a small spot under your cursor is taken as a sample In area mode you can draw a rectangle with your mouse darktable samples the area within that rectangle The combobox to switch between point and area mode can also be used to toggle the mode of local color pickers IF samples are taken in area mode darktable will calculate mean min and max color chan nel values A combobox allows you to select which of those are displaye
2. Keywords modules shows a hierarchial tree of your tags You can arrange tags within this tree using drag n drop a tag onto another gt darktable gt places gt uncategori zed 2 5 Recent used collections This panel keeps tracks of your latest collections you have used so you can jump to the latest used with Y recently used collections film roll Bilder September 2012 Fe r film roll eg out remebering what rules was specified in the col film roll Oktober 2012 Rohbilder lection 2 6 Metadata This panel shows embedded metadata of an image read from EXIF data stored in your pictures files image information 2012 Rohbilder w Bild dev IMG_6419 CR2 D Mark Il 50mm f 1 2L 2 7 Select This panel allows to quickly select images according to various criteria select Y select all select none invert selection select film roll select untouched select all Select all images in the current view collection with respect to filters select none Select no image invert selection Select all images that are not currently selected 11 select Film roll Select all images that are in the same filmroll as the currently selected images select untouched Select all images that have not been developed yet 2 8 Selected image s This panel allows to perform some actions on select selected imagels ed images remove Remove the selected images from the darktable database
3. radius soften with bilateral filter 7 contrast 2 50 saturation 0 00 blend mode vividlight opacity A 22 blend uniformly The original image already heavily processed The boat is almost a silhouette Bilateral blur with high radius Desaturated inverted and with high contrast Resulting image from lowpass filter and final image after this was applied with blend mode vividlight 4 9 9 Low light Overview Low light module allows to simulate human lowlight vision thus providing ability to make lowlight pic tures look closer to reality It can also be used to per Form a day to night conversion The idea is to calculate scotopic vision image http en wikipedia org wiki Scotopic_vision which is per ceived by rods rather than than cones in the eye un der low light Scotopic lightness then is mixed with photopic value regular color image pixel using some blending Function Also this module is able to simu late the Purkinje effect by adding some blueness to the dark parts of the image http en wikipedia org wiki Purkinje_effect lowlight vision Y 63 Usage curve The horizontal axis is about pixel lightness from dark left to bright right The vertical axis represents the kind of vision from night vision bottom to day vision top blue Set the blue hint in shadows Purkinje effect Examples This is the original image With low light module on This is
4. In its default color scheme this module will display deep shadows in blue and highlights in red These colors will be easy to identify in most cases In some cases you might want to change that to black amp white or purple amp green eg if you experience overexposed highlights in red blossoms lower threshold Set lower threshold expressed as a percentage of the maximal brightness upper threshold Set upper threshold expressed as a percentage of the maximal brightness 4 5 2 Shadows and Highlights Overview The shadows and highlights module allows to adjust TER shadows and highlights the tonal range of darker parts of an image shad an ows and lighter parts highlights it can bring back soften with details in shadows and highlights by enhancing local congas een Usage shadows This slider controls the effect on shadows positive values will lighten up shadows while negative values will darken them highlights This slider controls the effect on highlights negative values will darken highlights while positive values will lighten them up 32 soften with This combobox choses the underlying blurring filter gaussian or bilateral Try bilateral Filter if you experience halos with gaussian blur radius This slider controls the radius of the involved blurring Filter Higher values give softer tran sitions between shadows and highlights but might introduce halos Lower values will re duce the size of ha
5. Per default OpenCL support is activated in darktable if all the above steps were successful IF you want to de activate it you can do so in core options by unchecking activate opencl support This configuration parameter also tells you if OpenCL initialization failed it is grayed out in that case You can at any time switch OpenCL support off and on this will take immediate action Depending on the type of modules you are using you will notice the effect as a general speed up during interactive work and during export Most modules in darktable can take advantage of OpenCL but not all modules are demanding enough to make a noticeable difference In order to feel a real difference take modules like shadows and highlights sharpen lowpass highpass or as an extreme case equalizer IF you are interested in profiling Figures you can call darktable with command line para meters d opencl d perf After each run of the pixelpipe you will get a detailed allocation of processing time to each module plus an even more fine grained profile for all used OpenCL kernels Besides the speed up you should not see any difference in the results between CPU and GPU processing Except of rounding errors the results are designed to be identical If For some reasons darktable fails to properly Finish a GPU calculation it will normally notice and automatically and transparently Fall back to CPU processing 2 4 Possible Problems and Solution
6. 15 filename template You can define the filenames that darktable generates for export Several pre defined variables can be used as placeholders output directory roll of the input image Folder containing the input image basename of the input image extension of the input image a sequence number within export job year at date of export month at date of export day at date of export hour at time of export minute at time of export second at time of export exif year exif month exif day exif hour exif minute exif second star rating colorlabels pictures folder home folder desktop folder Pressing button will open a dialog to select the parent directory For export file Format darktable knows various file Formats to export to For some of them you need to addition ally define your desired bit depth If you export to a jpeg file you can additionally define an output quality Higher values will lead to larger file sizes max size Set the maximum width and height of your output images in pixels Set both to a value of 0 to export with full resolution darktable currently can only do down scaling the maximum output resolution is defined by the parent image intent This option lets you define the intent e the way darktable will deal with out of gamut colors See module output color profile For a more detailed description of the available 16 profile export options Select image settings i
7. Linux kernels use over committing memory allocation which means you don timmediate ly pay for all of the memory in terms of RSS resident set size the non swapped physical memory but in any case you pay for the address space As explained before this poses a problem for 32 bit systems and will at first sight appear as a regression over the terribly slow but that s another story 0 9 3 style cache In the long run however this is all mem ory that s ever going to be allocated for thumbnails so if we can successfully grab this portion once we are relieving a lot of pressure on fragmentation for long sessions 1 6 darktable on 64 bit systems 94 There s not much to be said here Of course also 64 bit systems require a sufficient amount of main memory So the 4GB plus swap recommendation holds true On the other hand 64 bit architectures do not suffer from the specific 32 bit limitations like small address space and fragmentation madness Most modern Intel or AMD 64 bit CPUs will have an available address space in the range of several Terabytes The word modern is relative in this context all AMD and Intel CPUs introduced since 2003 and 2004 respectively offer a 64 bit mode Linux 64 bit has been available since many years All relevant Linux distributions give you the free choice to install a 32 bit or a 64 bit version with no added costs You can even run old 32 bit binaries on a 64 bit Linux The only thing you need to do invest
8. effects also on image details 4 7 Color group This group contains the modules to work with colors of your image 4 7 1 Velvia Overview The velvia module enhances the saturation in the im J age it increases saturation on lower saturated pixels more than on high saturated pixels blend mode Usage strength This slider controls the strength of saturation for the effect mid tones bias This slider controls saturation preservation in mid tones IE is expressed as the lightness repartition between mid tones and shadows highlights The greater the first number the stronger the effect 4 7 2 Channel mixer Overview This module is a powerful tool to manage channels channel mixer As entry it manipulates red green and blue chan red nels As output it uses red green blue or gray or hue saturation lightness 43 Usage Select your output channel and then set the amount of each channel to feed the output channel Examples This is the original image use it as reference for the changes below Here we use gray as output and the following rgb mix 0 9 0 3 0 3 what this does is to reduce blue col ors in the mix which usally represents some details and we use some more red than green due the skin does contain a very even red tone and the results out of this is a pretty smooth skin of the portrait Due to the images nature i needed to lighten it up with 0 1 EV In this example we use a rgb mix
9. This blend mode acts similar to blend mode Normal only that the role of input and out put of the current module are reversed Can be used together with conditional blending next chapter to get the effect of an inversed blend mask unbounded This blend mode acts similar to blend mode Normal only that input and output data are not clamped to a certain min max value range This already tells you that all other blend modes clamp their input and output In some cases e g highly color saturated extreme highlights it is important to let unbound values traved through the pixelpipe in order to properly deal with them at the right place e g in module output color profile lightness This blend mode mixes lightness from input and output image Color data chroma and hue are taken unaltered from the input image chroma This blend mode mixes chroma saturation from input and output image Lightness and hue are taken unaltered from the input image hue This blend mode mixes hue color tint from input and output image Lightness and chroma are taken unaltered from the input image For modules which drastically modify hue e g generating complementary colors this blend mode can result in strong color noise color This blend mode mixes color chroma and hue from input and output image Lightness is taken unaltered from the input image For modules which drastically modify hue e g generating complementary colors this blend mod
10. Those images will not be shown in lighttable anymore but remain on filesystem delete Physically delete selected images from filesystem See also preference option ask before erasing images from disk if this option is not active darktable will delete the File s with out further question move Physically move selected images parent file plus accompanying xmp sidecar file to an other filesystem folder copy Physically copy selected images parent file plus accompanying xmp sidecar file to an other filesystem folder create hdr Create a high dynamic range image from the selected images and store it as a new source File in DNG format Images need to be properly aligned duplicate Create a virtual copy of selected images within darktable but not physically on your filesys tem It allows to test and try different developments for the same image for example Duplicate images will share the same parent input file but each have their own xmp side car file rotation Perform a counter clock wise clockwise rotation on selected images The third button al lows to reset rotation to EXIF value 12 group Create a new group from selected images ungroup Remove selected images from the group 2 9 History stack This panel allows to manipulate development For history stack each image development is written in a sidecar file xmp and is Fully non destructive copy Copy the history stack development of the Firs
11. below Usally port usb will be enough and therefore used in these examples env LANG C gphoto2 auto detect 2 Verify camera driver abillities Execute the following command and verify that the Capture choices ability supports Image and Configuration support is yes darktable will check these two abilities and decide if tethered shoot button should be shown or not env LANG C gphoto2 port usb abilities 3 Verify camera remote capture This step will verify that your camera can be remotely controlled that it can capture an image and then download it to your computer by software env LANG C gphoto2 port usb capture image and download 4 Verify camera tethered capture And this last step tests if your camera supports events which darktable heavily relies on Running this command will make the gphoto2 process wait for an image capture event which you must manually trigger on your camera On success an event is Fetch and an the image will download env LANG C gphoto2 port usb capture tethered 4 2 Soo now what IF any of the steps above Failed there are problems with your specific camera and driver Please report the issues to gphoto2 mailing list For Further help Add the Following Flags to the command above that failed for better support and attach the log output to your mail debug debug file gphoto2_debug log 15 76 IF you successfully went through all the tests above your camera will likly be
12. color and luminance noise separately 2 3 Exporting images Your changes to an image are not saved as in a regular image editor darktable is a non destructive editor which means all your changes are stored in a database and the original image is untouched and therefore you need to export your images to get an image file to distribute with your special processing Images are exported from lighttable using the export module in the right panel In general export means save my developed RAW image as a JPEG The export is also modularized into storage and Format darktable is shipping several stor age modules such as save on disk picasa and Flickr webalbum and more Format modules are the actual image formats such as JPEG PNG TIFF OpenEXR and more Select images on your lighttable that you want to export then choose your target storage and format to use and set the maximum width and height image restraint this means that none of the images will be bigger than any of the width height restraint Leave the width and height restraint as zero value if you want the original resolution and hit the export button Chapter 2 Lighttable The lighttable is where you manage all your images ratings export and much more 1 Overview 1 1 Lighttable In the central view your images are shown as thumbs each thumb has a frame and while the mouse is over an image the information of rating color labels and iFimage is altered in d
13. every thread will need about 1GB of mem ory setting this to 1 switches on per image parallelization which darktable does very ef Ficiently and which normally obsoletes parallel exports 32bit systems need to set this to 1 default 1 host memory limit in MB for tiling in order to manage large images on systems with limited memory darktable does a tile wise processing this variable controls the maximum amount of memory in MB a mod ule may use during image processing lower values will force memory hungry modules to process image with increasing number of tiles setting this to 0 will omit any limits values below 500 will be treated as 500 on a 32bit system you should set this to 500 needs a restart if changed default 1500 minimum amount of memory in MB for a single buffer in tiling if set to a positive non zero value this variable defines the minimum amount of memory in MB that darktable should take for a single tile on a 32bit system you should set this to 8 64bit systems can live with higher values needs a restart if changed default 16 write sidecar file for each image these redundant XMP files can later be re imported into a different database preserving your changes to the image it s strongly recommended to have this option activated so you don t lose data in case of a database corruption backing up your RAW file plus the accompanying XMP file will allow you to Fully restore your work default on activate
14. live samples from the same location and have one of them locked This way you can keep the locked one as a reference sample for comparison Live sample locations are indicated in your image if you check option display sample areas on image 23 3 5 Histogram Show a histogram of the developed image you can change exposure by left mouse click in the right side of histogram and drag right for increase or left to decrease the exposure The same goes for the black level but you left click in the left part of histogram You can switch between linear and logarithmic his togram view by toggling a corresponding button In its default state histograms for all three color chan nels RGB are displayed toggle one of the colored squares to enable disable a specific color channel 3 6 Modulegroups 24 The modulegroups button bar give you quick access to the set of modules available in darktable each one categorized into groups see the specification below G CG LUE SE Si SE WM o G in in in in in in in in in in in in in G in 0 10 0 10 0 0 10 10 10 10 o 0 splittoning vignetting output color profile highpass sharpen zone system monochrome equalizer shadows and highlights denoise non local means crop and rotate input color profile exposure demosaic highlight reconstruction white balance 4 4 a 4 4 4 Here follows a description of t
15. new preset menu choice Following dialog will be shown to configure the preset edit new preset for module lens correction The first two fields are used for setting a name and a description of the preset In the example i have also checked the auto apply option which brings up the image se lection fields where you can define a filter that is used to decide if the preset should be applied the image or not The example dialog above does set up following rules if lens name matches and aperture is gt 8 and focal length is in range 24 35mm the preset will be automatically applied it will also only show in the preset list if the image does match this rule The data used is the EXIF information so if you want a preset to be applied to all images from a specific camera then leave all Fields at default values lookup model string in meta data panel and enter it into the model field 31 4 5 Basic group The basic group of modules contains the modules for basic develeopment the ones you probably will use the most such as exposure temperature etc 4 5 1 Overexposed Overview This module is a useful feature that displays pixel E outside dynamic range color scheme lower threshold upper threshold Usage Overexposed is used to visualize pixels that are above and or below a user defined thresh old You can activate this module the usual way You can also press icon El in the lower panel as a shortcut color scheme
16. of 0 4 0 75 0 15 the difference with the previous example here is that we use more green than red which brings some fea tures back but we will still reduce the blue channel in the mix to dampen artefacts Table of mixing values for some b w films Select gray as output mixing channel and try out the values descibed below for your like Film Type Red Green Blue AGFA 200X 0 18 0 41 0 41 Agfapan 25 0 25 0 39 0 36 Agfapan 100 0 21 0 40 0 39 Agfapan 400 0 20 0 41 0 39 Ford Delta 100 0 21 0 42 0 37 Ford Delta 400 0 22 0 42 0 36 Ilford Delta 3200 0 31 0 36 0 33 44 Ilford FP4 0 28 0 41 0 31 Ilford HP5 0 23 0 37 0 40 Ilford Pan F 0 33 0 36 0 31 Ford SFX 0 36 0 31 0 33 Ilford XP2 Super 0 21 0 42 0 37 Kodak T Max 100 0 24 0 37 0 39 Kodak T Max 400 0 27 0 36 0 37 Kodak Tri X 400 0 25 0 35 0 40 Normal Contrast 0 43 0 33 0 30 High Contrast 0 40 0 34 0 60 Generic B W 0 24 0 68 0 08 4 7 3 Output color profile Overview This module manages the output profile both for dis EEE output inten perceptual play and for export REN ea E sRGB web safe sRGB web safe Y display profile system display profile Y Usage output intent Sets the rendering intent for output export You can easily override this setting whenever you do exports from lighttable mode perceptual Suited to pictures It scales one gamut to fit into the other while maintaining the relative position of col ors relative colorimetric Out of gamut
17. opencl support darktable can use your GPU to speed up processing significantly interface OpenCL re quires a suited hardware and matching OpenCL drivers on your system if one of those is not found the option is greyed out can be switched on and off at any time and takes immediate effect default on always use littlecms2 during export if this option is activated darktable will use system library littlecms2 instead of its own routines this is about 28x as slow as the default but might give more accurate results in some cases default off 84 do high quality resampling during export the image will First be processed in Full resolution and downscaled at the very end this can result in better quality sometimes but will always be slower default off demosaicing for zoomed out darkroom mode interpolation when not viewing 1 1 in darkroom mode always bilinear fast is Fastest but not as sharp at most ppg reasonable is using ppg interpolation modes specified below Full possibly slow will use exactly the settings For Full size export default at most ppg reasonable pixel interpolator pixel interpolator used in rotation lens correction up and downscaling options are bi linear bicubic lanczos2 lanczos3 default lanczos3 password storage backend to use the storage backend for password storage options none kwallet gnome keyring default none run indexer this will index i
18. our b curve was shifted down to negative values This gives the image its blue tint Resulting image 4 6 4 Zone system Overview This module is another way to change the lightness of your image It is based on the Ansel Adams system It allows to modify the lightness of a zone taking into account the effect on the adjacent zones It divides the lightness in an user defined number of zones Usage The lightness is processed on the L channel from CIELAB The center view shows the image broken down in zones When hovering above a zone on the lightness scale the current zone is highligthed on the preview The number of zones can be changed by mouse scrolling on the lightness scale Left click and drag a handle in the zonebar to modify the zonemapping use right click to remove controlpoint Examples This is the original image use it as reference for the changes below Here i have compressed some darker zones and lighter zones to increase contrast then expanded the upper parts of darker zones 41 4 6 5 Local contrast Overview This module allows to enhance local contrast It uses EX UTE the unnormalized bilateral filter and works on the L 50 channel from Lab Usage Local contrast boosts the details of your image much like the equalizer does but in only one frequency band coarseness Make the details you want to adjust finer or coarser this maps to sigma_s in the algo rithm contrast How str
19. put enormous FPU processing power into their GPUs to meet these demands The result is modern graphics cards with highly parallelized GPUs to quickly cal culate surfaces and textures at high frame rates You are not a gamer and you don t take advantage of that power Well then you should at least use it in darktable For the task of highly parallel Floating point calculations modern GPUs are much faster than CPUs That is especially true when you want to do the same few processing steps over millions of items Typical use case processing of megapixel images 2 2 How OpenCL works As you can imagine hardware architectures of GPUs can vary significantly There are dif ferent producers and even different generations of GPUs from the same producer may differ clearly At the same time GPU manufacturers are normally not willing to disclose many hardware details of their products to the public One of the known consequences is the need to use proprietary drivers under Linux if you want to take Full advantage of your graphics card Fortunately an industry consortium lead by The Khronos Group has developed an open standardized interface called OpenCL It eases the use of your GPU as a numerical pro cessing device OpenCL offers a C99 like programming language with a strong focus on parallel computing An application that wants to use OpenCL will need to bring along a suited OpenCL source code that it then hands over to a hardware specific OpenCL co
20. saturation to add a colorcast to the gradient TIP IF you know you intend to use the GND filter before actually making a shot with your camera you might want to underexpose by one or two thirds of an f stop to make sure de tail remains in the highlights When all detail has truly been blown out the GND filter can not produce a pleasing results this is a limitation that is inherent to digital postprocess ing For instructions on how to intentionally underexpose please consult your camera s manual look for exposure compensation Examples This is the original image with a pretty overexposed sky use it as reference for the changes below And now we have added a neutral ND8 filter which does a pretty good job on the image And at last i added an orange colored filter rotating it 180 degrees for applying it on water trees for a more artistic use of the filter 67 5 Examples 5 1 Converting to Black and White 5 1 1 Overview Black and white conversion can be achieved in several ways with darktable Indeed darktable comes with a lot of modules especially For color manipulation In this manual I will show you 4 ways to perform a black and white conversion 5 1 2 The obvious way monochrome module To perform such conversion just activate the monochrome module You can then simulate a color filter by dragging the circle above the colours you want to filter Filter size can be modified thanks to wheel scro
21. some time into the migration In the end we strongly recommend to move to a 64 bit version of Linux There isn t much good reason not to make this step 2 darktable and OpenCL darktable can use GPU acceleration via OpenCL to improve performance 2 1 The Background Processing high resolution images belongs to the more demanding tasks in modern com puting Both in terms of memory requirements and in terms of CPU power getting the best out of a typical 15 20 or 25 Megapixel image can quickly bring your computer to its limits darktable s requirements are no exception Our decision to not compromise processing quality has led to all calculations being done on 4 x 32bit Floating point numbers This is slower than ordinary 8 or 16bit integer algebra but eliminates all problems of tonal breaks or loss of information A lot of hand optimization has been invested to make darktable as fast as possible IF you run a current version of darktable on a modern computer you might not even notice any slowness However there are conditions and certain modules where you feel or hear from the howling of your CPU fan how much your poor multi core processor has to strug gle That s where OpenCL comes in OpenCL allows us to take advantage of the enormous power of modern graphics cards It has been gamer s demand for more and more high ly detailed 3D worlds in modern ego shooters that has fostered GPU development ATI NVIDIA and Co had to
22. sorry we don t have that yet Some day however Henrik decided to give it a 91 1 darktable and memory darktable s memory requirements are high A simple calculation makes this clear If you have a 20MPx image darktable for precision reasons will store this internally as a 4 x 32 bit Floating point cell For each pixel Each full image of this size will need about 300MB of memory As we want to process the image we will at least need two buffers For each module one for input and one for output IF we have a more complex module its algo rithm might additionally require several intermediate buffers of the same size Without Further optimization anything between 600MB and 3GB would be needed only to store and process image data On top we have darktable s code segment the code and data of all dynamically linked system libraries and not to forget further buffers where darktable stores intermediate images for quick access during interactive work mip map cache All in all darktable would like to see a minimum of about 4GB to run happily 1 1 Total system memory From what said before it is evident that your computer needs a sane memory setup to properly run darktable We suggest that you have a least 4GB of physical RAM plus 4 to 8GB of additional swap space installed The latter is required so that your system can swap out temporarily unneeded data to disk in order to free physical RAM Theoretically you could also run darktable wi
23. tags are currently stored in sidecar files xmp dar ktable for mat or2 and within the darktable database for a Faster ac cess The panel is divided into two parts the upper part contains the tag s currently set for the image either under mouse if mouse is over an image or se lected if mouse is outside the lighttable The lower part contains all tags available those can be filtered thanks to the upper text box Places Virginia Warrenton Bethany Lane cascais attach Attach the selected tag s from the list below to all selected images detach Detach selected tag s from the list above From all selected images new Create a new tag for the list delete Delete a tag from the list 2 14 Export selected Each workflow has to end by this panel the exporta export selected tion of your developed images Currently you can ex target storage port either to a file on your disk or to various on line file on disi c storages TIP you can use ctrl alt e From within dark A oborila a elina E room mode to export file for mat 8 bit jpg quality on 85 global options max size 0 intent image settings profile image settings target storage Where to store your selected images Different back ends are implemented including file on disk a LaTeX book template and various web albums Depending on the selected target you will be asked to give additional information like filenames account name and pass word
24. to control how the demosaic demosaic v is processed method ppg fast edge threshold 0 000 color sm oothing off Y match greens disabled 35 Usage Demosaic is an essential step For any raw image development process A detailed description would be beyond the scope of this manual In a nutshell the sensor cells of a digital camera are only able to record different levels of lightness not color In order to get a color image each cell is covered by a color filter either in red green or blue Due to the color sensitivity of the human vision there are two times more green cells than red or blue Filters are arranged in a certain mosaic called Bayer pattern Therefore each pixel of your image originally only has information about one color channel Demosaic re constructs the missing color channels by interpolation with data of the neighboring pixels As all this is prone to produce artifacts various different demosaic algorithms have been developed in the past Artifacts would typically be visible as Moiree like patterns when you strongly zoom into your image Currently darktable supports PPG and AMAZE Both algorithms produce high quality output with a low tendency for artifacts AMAZE is re ported to sometimes give slightly better results However as AMAZE is significantly slow er darktable uses PPG as a default Some further parameters of this module can activate additional averaging and smoothing steps They might he
25. visit lensfun s home page at http lensfun berlios de and learn how to generate your own set of correction parameters Don t forget to share your profile with the lensfun team corrections This combobox gives you a choice about which corrections out of distortion TCA and vignetting darktable shall apply Change this from its default all if your camera has already done some internal corrections e g of vignetting or if you plan to do certain corrections with a separate program geometry scale mode In addition to correction of lens Flaws this module can change the projection type of your image Set this combobox to the aimed projection type This slider allows you to adjust the scaling Factor of your image Pressing the auto scale button right to the slider will let darktable Find the best Fit to avoid black corners The default behavior of this module is to correct lens Flaws Switch this togglebutton to distort in order to simulate the behavior of a specific lens inverted effect TCA red This slider allows to override the correction parameter for TCA You can also use this slider to manually set the parameter in case the lens profile does not support TCA correction Look out for colored seams at features with high contrast edges and adjust this parameter and the Following one to minimize those seams TCA blue This slider allows to override the correction parameter for TCA You can also use this slider to manual
26. with a side by side comparasion left snapshot right active when you are tuning parameters of a module In the active view history remains usable in order to compare with the snapshot You can control the split view by moving the splitline back and forth and if you hover mouse over the split line a small rotation icon will appear on the center of the line click it to change to a horizontal split view 3 3 History The history stack lists every change of state acti vate de activated For all modules Here you can se lect a point in stack to return to that point of devel opment history IF you then activate anew module all modules above the current point will be discarded Be cautious also activating any action by key accelerators will discard all modules above the current one e g if you press o to see over under exposed areas The same happens if you press the according toggle button It is easy to lose all development work on an image this way Hitting compress history stack generates the shortest historystack that produces the current image i e suppressing all de activated modules This will also discard all modules above the currently selected one The button to the right Bi lets you create a new style by popping up a dialog window Use the first line to name your style the second to add a searchable description The advanced presets allows you chose which modules are to be taken into account for the styles
27. your camera s live view mode Functionality such as focus setting rotation adding guides and overlays are supported 2 3 Camera settings In the camera settings you have access to function ality as setting up a capture job which includes se quences brackets and delays Also this panel in cludes access to camera settings that can be con trolled remotly from within darktable camera settings camera control CO additional properties 13 3 Examples This section contains examples of typical usages of tethering 3 1 Studio setup with screening This is a pretty common use case You have your studio and subject rigged camera is con nected to your computer and tethering view is active in darktable You work behind the camera and take images Whenever you want you can screen the image directly on your computer monitor instead of using the camera LCD for validation This workflow is effective as you don t need to take 20 captures and then later while out of the rigg review them and hope that you got the one Just do it up front If you re shooting a model this is a pretty nice way to pre show the captures to the client instead of Fumbling around with your camera This workflow is kind of out of the box when entering tethering view You just need to set a session name preferable subject name of the shoot then just start to take images They will Fall into the right filmroll For the session For easy review
28. your col lections within the base query or simple tagging by related tags are useful tools in your every day photo workflow Import a variety of standard raw and high dynamic range image formats e g jpg cr2 hdr pfm darktable has a zero latency Fullscreen zoomable user interface through multi level software caches Tethered shooting The powerful export system supports Picasa webalbum flickr upload disk storage 1 1 copy email attachments and can generate a simple html based web gallery darktable allows you to export to low dynamic range JPEG PNG TIFF 16 bit PPM TIFF or linear high dynamic range PFM EXR images darktable uses both XMP sidecar files as well as its Fast database for saving metadata and processing settings All Exif data is read and written using libexiv2 darktable comes with 47 image operation modules which cover everything from basic operations tonal value changes color manipulation correction of common image de Fects to artistic effects Many of darktables modules can be combined with blending operators for even more development options A powerful blend mask feature gives you fine control on module s effect to different parts of an image 1 User interface This section describes the layout of the user inter face You can change darktable s contrast by using F7 and F8 and darktable s lightness by using F9 and F10 1 1 Views darktable consists of several views also menti
29. 7 98
30. B at a time and frees it again that memory should normally be available for one big 1 5GB allocation afterwards This however is often not the case The system s memory allocator might no longer see this area as one contiguous 1 5GB block but as a row of 300MB areas If there is no other free area of 1 5GB available the allocation would fail During a program run this mechanism will take away more and more of the larger memory blocks in favor of smaller ones darktable 1 0 introduces a caching algorithm to address this problem It pre allocates blocks of memory and makes them available on request 1 4 Further Limitations And as if this were not challenging enough there are further things that might limit your access to memory On some older boards you need to activate BIOS option memory remapping in order to have all physically installed memory enabled In addition if you are on a 32 bit OS you will probably need a kernel version that has Physical Address Exten sion PAE enabled This is often but not always the case for Linux Many distributions deliver different kernels some with and some without PAE activated you need to choose the right one A typical sign that one of these topics are not setup correctly is system com mand free 1 not reporting all of your installed physical RAM For example you have 4GB on your board but your kernel is only seeing 3GB or less You need to consult the manual of your BIOS and the information a
31. CID Le nee D ETES 8 125 Filtering and SOLE Order sia eis 8 A nn A NIRO 9 2 1 MDOE A AS est a 9 2 2s Simar Mag eS ia ia drid eii 10 2 31 Collect IMITA N 10 LAO NOTO dla 11 2 5 Recent Used COME ECON aii a a 11 20 Metadata rear 11 O ta 11 2 8 Selec casse eniedeh eaea a aaee 12 LA SEO ad 13 210 SEYIOS a mi ee dede ee are 13 BM We GO E 399 NG A A tn Mn sl 14 2 12 Metadata edito it inde 14 2 12 VAG GUNG A N Sn Eine A 15 2 14 EXBOTE Selected a ee 15 BD EO Mi 19 RS NA ee O bec nec dune 20 A ee Oi et a a Siu A ee 21 Bel EE ET ST eE TES 22 3 1 NMAVIGAUION A ri 22 SP ee ne oi de 22 3 3 ISO E A ads data ne ailes nude 22 3A COLO DICKET ii ae 23 3 5 IS COM A a 24 3 6 MOQUIEGTOUDS iia di ida 24 31 More Module di dia 25 A IA A E 26 4 1 Interactna WIEN Modules rail 26 4 2 Blending Operator Sita iia sisi 26 4 3 Conditional Hending seien 28 AA LOS OCS 2 een een leugnen 31 2 5 BASIC ITUNE oa 32 2 6 TON ORO Dia tiles 38 dt E O 43 40 COPE CtlOn O UD er eine 49 AO ENEE GFOUD area te 55 o r A A ne ee 68 5 1 Converting to Black and White oococoocncnncnccncnnroncncnnroncnncncnncnncnons 68 BZ CFOSS DrOC SSINO seele 69 5 53 Cyan A A Malin 70 A TENEN dni aia 71 MA es lee en ee 72 TS Teen D et a LR 72 2 PA ENT RER NEE ERINNERTE aot EIERN ET E A EE E ET ARTT 73 2 12 SESSION anne aes E ne Shine 73 A O A A 73 23 Camera SekEINgSs urn ee tere 13 SEXA O S a a A E aaa 74 3 1 Studio se
32. Folder always ask the user before any image file is copied default on number of folder levels to show in lists the number of folder levels to show in film roll names starting from the right default 1 ignore jpeg images when importing film rolls when having raw jpeg images together in one directory it makes no sense to import both with this flag one can ignore all jpegs found default off recursive directory traversal when importing filmrolls not only import images from the directory selected but recursively go through all subdi rectories as well default off creator to be applied when importing if given automatically add this string as a creator tag when importing images default none publisher to be applied when importing iF given automatically add this string as a publisher tag when importing images default none rights to be applied when importing if given automatically add this string as a copyrights tag when importing images default none 82 initial import rating initial star rating from 0 to 5 for all images when importing a filmroll default 1 enable filmstrip enable the filmstrip in darkroom tethering and geomapping modes default on maximum width of image drawing area maximum width of the image drawing area in darkroom mode adjust to your screen needs a restart and will invalidate current thumbnail caches default 1300 maximum height of image drawing area maximum height of the i
33. anual is a draft issue It is at an early stage of writing User manual version and applicable darktable version are listed below version date user manual 1 1 1 draft December 2012 darktable 1 1 December 2012 For the course of this documentation the arrow keys on your keyboard are referenced as with arrow symbols Te J vi Chapter 1 Overview darktable is an open source photography workflow application and RAW developer A vir tual lighttable and darkroom for photographers IE manages your digital negatives in a database lets you view them through a zoomable lighttable and enables you to develop raw images and enhance them General Features darktable runs on GNU Linux GNOME Mac OS X macports and Solaris 11 GNOME Fully non destructive editing All darktable core functions operate on 4x32 bit floating point pixel buffers For high accuracy processing preventing banding and color breaks Heavy use of SSE instructions for speedups GPU acceleration via OpenCL runtime detection and enabling Most of the actions on the pixelpipe are done in CIELab color space which is much larger than the gamut of modern displays printers or even human vision Full color managed display and built in ICC profile support for export sRGB Adobe RGB XYZ and linear RGB A collect module allows you to execute flexible database queries search your images by tags image rating stars color labels and many more Filtering and sorting
34. arate panel You can al so get an overview of the metadata of the image un der your mouse cursor in panel image information 2 2 Find location Use this modules to search for a place on map You find location need to be connected to internet to use this Feature To use just name a place and hit enter and a list of results will be shown Click on one of the resulting items and the map will zoom into the place you can then start to drop images into that location For geo tagging 2 3 Map settings In this panel you control the map settings You can se map settings lect the source for map data From different providers and what layers they bring such as satelite view etc map source OpenStreetMap You can also toggle the view of some overlay info 2 4 Tagging This panel gives you access to darktables tagging fea tagging Y tures It is equivalent to the one you reach From with in lighttable mode See chapter 2 for more details Places Virginia Warrenton Bethany Lane cascais 80 Chapter 6 Preferences and Settings darktable comes with a number of settings that can be configured by users You reach the configuration system by clicking El core options shortcuts presets width of the side panels in pixels don t use embedded preview jpeg but half size raw ask before ask before ask before ask before removing images from database erasing images from disk moving images from fi
35. arkroom is shown Also when the mouse hovers over an image frame the specific image metadata is shown in the metadata panel In order to locate where you are in your collection you have read only sliders at the ex treme border of the window left right for your vertical position in the collection top bottom when in zoomable lighttable mode see below for your zoom level While the mouse is over an image frame you can access additional actions from your key board to apply on the image here follows a table of key accelerators and assigned actions 0 5 set the rating of the image if an image has 1 star and you hit the 7 key the image will be unrated Pressing rrejects the image F1 F5 set a color label for the image ctrl c copy the history stack of the image ctrl v paste the copied history stack on the image d open the image in darkroom view for developing Z show a fullscreen view of the image At the bottom you have an option to choose between zoomable lighttable view or file manger view of the thumbnails Using the zoomable lighttable view scroll with your mouse wheel to zoom in and out Moving the mouse while pressing the left mouse button allows you to navigate through your collection While in Filemanager you can use ctrl mouse wheel to change the number of thumbs dis played in a row That action is a key accelerator of the counter that can be found beside the filemanager option Use your mouse wheel to naviga
36. at Form NVIDIA drivers will often give error code 1001 in that case This happens because libOpenCL so is only a wrapper library For the real work further libraries specific to ven dor device and driver need to be loaded This failed For some reason There is a structure of files in etc OpenCL on your system that libOpenCL so consults to find these libraries Check if you find something Fishy in there and try to Fix it Often the needed libraries can not be found by your system s dynamic loader Giving full path names might help darktablele might also tell you that a context could not be created This often indicates a version mismatch between loaded graphics driver and libOpenCL Check if you have left over kernel modules or graphics libraries of an older install and take appropriate action In doubt make a clean reinstall of your graphics driver Sometimes immediately after a dri ver update the loaded kernel driver does not match the newly installed libraries reboot your system in that case darktablele might crash in very rare cases directly during startup This can happen if your OpenCL setup is completely broken or if driver library contains a severe bug IF you can t Fix it you can still use darktable with option disable opencl which will skip the entire OpenCLinitialization step darktablele might on some systems fail to compile its OpenCL source files at run time In that case you will get a number of error messages loo
37. avoid that you create multiple duplicates edit Styles are a collection of history stack items After pressing edit you are prompted with a dialog in which you can deselect specific items Check option duplicate if you want to create a new style instead of overwriting the existing one you need to give a new style name in this case delete This will delete the selected style without further question import You can import a style which has been previously saved by darktable darktable stores its files in xml files with the extension dtstyle export This option saves a selected style to disk as a dtstyle file This allows to share styles among users 2 11 Geotagging Using this panel you can import and apply GPX track geotagging data on selection of images you also have the abili na et 00 00 00 A Er ty to add an time offset to GPX tracks for correction apply gpx track file of time differences between your camera and gps receiver You can also manually geotag your images Within the Map view See chapter 5 for more details 2 12 Metadata editor clear apply 14 Edit some metadata of your image You can define metadata editor your own presets if you want to apply specific set tings Frequently Delete existing metadata from the selected image s Apply new settings as defined in the Fields above to the selected image s 2 13 Tagging This panel allows to manage tags for your images tagging Those
38. blue F4 lt darktable gt film strip color green F3 lt darktable gt film strip color purple F5 lt darktable gt film strip color red F1 lt darktable gt film strip color yellow F2 lt darktable gt film strip history copy lt Control gt c lt darktable gt film strip history paste lt Control gt v lt darktable gt film strip duplicate lt Control gt d lt darktable gt film strip rating 1 1 lt darktable gt film strip rating 2 2 lt darktable gt film strip rating 3 3 lt darktable gt film strip rating 4 4 lt darktable gt film strip rating 5 5 lt darktable gt film strip rating desert 0 lt darktable gt film strip rating reject r lt darktable gt film strip scroll back Left lt darktable gt film strip scroll Forward Right lt darktable gt global capture view t lt darktable gt global darkroom view d lt darktable gt global decrease brightness lt darktable gt global decrease contrast lt darktable gt global increase brightness lt darktable gt global increase contrast lt darktable gt global leave Fullscreen lt darktable gt global lighttable view lt darktable gt global quit lt darktable gt global switch view lt darktable gt global toggle Fullscreen lt darktable gt global toggle side borders lt darktable gt lighttable color blue lt darktable gt lighttable color green lt darktable gt lighttable color purple lt darktable gt lighttable color red lt darktable gt lighttable color yellow lt darktable gt li
39. bout your Linux variant for further help 1 5 Setting up darktable on 32 bit systems As we ve seen 32 bit systems are difficult environments For darktable Still many users are successfully running darktable on them if the basic requirements in terms of total system memory and the topics mentioned in the paragraphs above are addressed properly There are several adjustment parameters to get it running IF you make a fresh install darktable will detect your system and set conservative values by default However if you upgrade darktable from an older version e g coming from 0 9 3 and going to 1 0 chances are you have unfavorable settings in your preferences The consequences might be dark table aborting due to allocation Failures or very typically darktable not being able to properly import a new film roll As a frequent symptom you get skulls displayed instead of thumbs for many of your pictures Take a minute to optimize the preference settings in this case You will Find them under core options in darktable s preference dialog You might also find these parameters as configuration variables in SHOME config darktable darktablerc and edit them there Here is a short explanation of the relevant parameters and their proposed settings number of background threads This parameter defines the maximum number of threads that are allowed in parallel when importing film rolls or doing other background stuff For obvious reasons on 32 bi
40. ch allows to define a color For the border in HSL or RGB color space You can also activate a color picker by pressing and take a color probe from your image frame line color Clicking on the colored field will open a color selector dialog which allows to define a color For the frame in HSL or RGB color space You can also activate a color picker by pressing and take a color probe from your image 57 Examples Example image with a user defined frame 4 9 3 Splittoning Overview darktable s splittoning method creates a two color Ex splittoning Y linear toning effect where the shadows and high ER Usage lights are represented by two different colors In the example image below you can see an original black and white image and one where a splittoning effect highlights are applied with blue in shadows and yellow ish color in highlights darktable splittoning module has more parameters that impacts on the default above be havior We have balance which offsets the 50 gray level in image and compression that does compress toning in the shadows and highlights which leaves a gap which are untouched by the effect Read more and see examples of these additional parameters to splittoning module in usage section The splittoning module does not convert images to black and white and has limited ben efits on color images So if you want to do traditional splittoning use the monochrome module to make the image black and w
41. colors are converted to colors having the same lightness but different saturation Other colors remain unmodified saturation Saturation is kept but lightness is slightly changed absolute colorimetric Keep the white point display intent Sets the rendering intent for your display See above for available options output profile Sets the color profile for output export Profiles to be used are picked up from SDARKTABLE share darktable color out and SHOME config darktable color out where SDARKTABLE is used here as a placeholder for darktable s installation directory and SHOME is your home directory softproof profile Sets the color profile for softproof Profiles to be used are picked up from SDARKTABLE share darktable color out and SHOME config darktable color out where SDARKTABLE is darktables installation directory and SHOME is your home directory 45 Softproof is toggled on off by pressing s this function allows you to preview the image rendered using a printer profile to see how colors will end up on the final print Likewise Gamut Check is toggled on off by pressing g this function marks all pixels which are out of gamut with respect to the selected softproof profile by showing them in cyan Softproof and Gamut Check are mutually exclusive modes Softproof and Gamut Check can be activated at any place in darkroom mode Only if mod ule Output color profile is in Focus you will get the status displayed left below t
42. d For obvious reasons mean min and max are identical in point mode A color swatch representing the sampled point or area is displayed Numerical values are shown as well As said before global color picker works in monitor RGB color space You can also let darktable translate these numerical values into Lab color space Beware that Lab values are approximated here darktable does not take your specific monitor profile into account On activation of checkbox restrict histogram to selection only the values of your select ed area or point are taken into account by the histogram on top of right panel This is a useful tool if you want to know which tonal values are present in a specific area Picked colors in area or point mode can be stored as live samples by pressing the Add button darktable shows a color swatch and numerical values for each stored sample You can once again select which numerical value mean min max is to be displayed and if this is to be done in RGB or Lab color space Newly created live samples are not locked IF you change the parameters of your image these changes will be reflected in your stored samples Use this if you want to get an overview how changing a parameters has effect to different parts of an image IF you click on the color swatch of a stored live sample it gets locked a lock symbol is displayed Fur ther changes of parameters will not affect this live sample any longer You can For example take two
43. darktable 1 1 Henrik Andersson darktable 1 1 Henrik Andersson Copyright 2010 2012 P H Andersson Copyright 2010 2011 Olivier Tribout Copyright 2012 Ulrich Pegelow The owner of the darktable project is Johannes Hanika Main developers are Johannes Hanika Henrik Andersson Tobias Ellinghaus Pascal de Bruijn and Ulrich Pegelow darktable is free software you can redistribute it and or modify it under the terms of the GNU General Public License as published by the Free Software Foundation either version 3 of the License or at your option any later version darktable is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE See the GNU General Public License for more details You should have received a copy of the GNU General Public License along with darktable IF not see http www gnu org licenses The present user manual is under license cc by sa meaning Attribution Share Alike You can visit http creativecommons org about licenses to get more information Table of Contents Preface Lo Enis MANU a V TEOVEIVIEeW ae AAA ie alone A te 1 1T USerin er aC Er laa 2 kls VIEWS 2 a 2 AS FIIS D ernennen e a an 2 13 PrE Sr eN CE RSA nu E 3 2 darktable Dasic WOW 4 2 1 IMPOTEING IMAGES eines 4 2 23 BASIC Coll eek O Micol 4 2 3 EXDOLEING MATES ci A A 5 NA DIE cee een ee E EEE 7 OVER ss io 8 Tl YPN
44. e list of available watermarks to use Here follows a list of available variable strings that is supported for substitution within the svg document S DARKTABLE NAME The application name S DARKTABLE VERSION The version of darktable S IMAGE ID The uniq image id within current library S IMAGE FILENAME The iamge filename S IMAGE EXIF The image exif string S EXIF DATE The image date S EXIF MAKER The maker of camera model S EXIF MODEL The camera model S EXIF LENS The specific lens used S XMP DC CREATOR The creator string S XMP DC PUBLISHER The publisher string S XMP DC TITLE The title of the image S XMP DC DESCRIPTION The description of the image S XMP DC RIGHTS The rights assigned to the image Usage marker Choose the watermark of interest use the reload button next to the combobox to update list with newly added watermarks opacity Set the opacity of the render of watermark scale Scale the watermark pixelindependent alignment Use these controls to align the watermark to any edge or center of the image x offset Pixel independent offset realtive to the choice of alignment on x axis y offset 56 Pixel independent offset relative to the choice of alignment on y axis 4 9 2 Framing Overview This module is an artistic feature to generate a frame framing around your image The frame consists of a border with a user defined color and a frame line inside that aia DOTE border which has another user defin
45. e can result in strong color noise coloradjustment Some modules act predominantly on the tonal values of an image but involve some adjust ment of color saturation as well e g module levels This blend mode takes the lightness 27 only from output data and mixes colors from input and output This way you can control the module s automatic color adjustment opacity This slider controls the amount of blending A value of 100 gives the module s full effect into the pixelpipe a value of 0 means no effect of this module With blend mode Normal and a proper selection of opacity you can therefore control the strength of a module s effect blend Most modules offer additional control on blending by a user defined blend mask In order to activate these controls you need to switch from blend uniformily to blend only if More details on conditional blending are given in a separate chapter 4 2 2 Examples Texturing an image The watermark module supports svg files with embedded images and thanks to it we can easily texture an image using the watermark module in conjunction with a blending oper ator Gritty details When blending operators were introduced into dark table a new module named highpass was added It produces a highpass filter of the image to be implic itly used with blending It allows to produce a gritty detailed image and is a widely used workflow with other imaging softwares highpass This is th
46. e in EV center Set the median lightness being impacted by the fill light A color picker is activated by pressing Al It will show the picked lightness value in the gradient bar and thus helps to find the right center value width Set the width of the Gaussian curve It is expressed in zone the whole dynamic range being 10 zones As the Gaussian is symmetric only even numbers can be entered 38 4 6 2 Levels Overview Usage A level tool that most of you will recognize how to use from other imaging softwares The levels tool shows the histogram of the image and displays three bars with handles for you to drag and correct the tone in the image Those bars represent black middle gray and white This module is especially useful if the histogram of your image does not span the whole horizontal range from pure black to pure white You can adjust the left and right bar to match the left and right border of the histogram which will make the output image span the full available tonal range A previously flat looking image will get more contrast and pop Shifting the middle bar will modify the middle gray tones Shifting it left will make the im age look brighter shifting it right will make it darker This is often referred to as a change of image gamma 4 6 3 Tonecurve Overview Usage This module is a classical tool in digital photography ET tone curve darktable s special Feature is to have this module act di
47. e original image pretty heavy processed First black and white then some blue splittoning but as you see it lacks pop in details and is a bit out of Focus Here we applied the highpass filter with the values shown in the images above of the module userinter Face you can now see that the details are very boost ed and we got a really gritty detailed image 4 3 Conditional blending Conditional blending offers a fine grained control as to what extent blending is applied to different pixels of an image It does so by generating an intermediate blend mask con structed with user defined parameters These parameters act in color coordinates notin geometrical coordinates 28 That said conditional blending is a powerful tool with a certain level of complexity 4 3 1 Working principle For each data channel of a module Lab RGB and additionally For several virtual data chan nels e g hue saturation users can construct a per channel opacity function The function has the form of a trapezoid Depending on the data channel s value this Function deter mines a blending factor between 0 and 1 Each pixel of an image thus has different blending factors for each of its data channels real and virtual All blending factors are finally pixel wise multiplied together with the value of the global opacity slider see chapter Blend Modes to form a blend mask for the image IF For a given pixel the blend mask has a value of 0
48. ed color There are Various options for you to control the geometry of your frame horizontal position vertical position line size line offset r der color frame frame border frame line color Usage border size This slider controls the size of the frame in percent of the underlying full image aspect With this combobox you can choose between different aspect ratios For the final output of this module i e underlying image plus frame orientation IF you select a non square aspect ratio this combobox defines the orientation portrait or landscape Set to auto if you want darktable to select the most reasonable orientation based on the underlying image horizontal position Select from a set of pre defined ratios where you want your underlying image be posi tioned on the horizontal axis You can also right click and enter your own ratio as x y vertical position Select from a set of pre defined ratios where you want your underlying image be posi tioned on the vertical axis You can also right click and enter your own ratio as x y frame line size The percentage of the frame line size relative to the border size at its smallest part frame line offset Where the frame line is positioned relative to the underlying image Select O for a frame line touching the image 100 for a frame line touching the outer border limits border color Clicking on the colored field will open a color selector dialog whi
49. eps a disk cache of already loaded map data You can navigate in your map using the mouse Left click will drag the map using the scroll wheel will zoom in or out Some on screen controls and displays assist you to find your way There is a navigation area on top left Use it as an alternative to mouse dragging and scrolling The scale of your map is displayed on bottom left On bottom right you see the geographical coordinates of the center of the map Images that already have geo location attributes in their metadata are displayed as small icons on the map In order to assign geo coordinates to an image activate the film strip on the lower panel press Ctrl f You can simply assign a geo location to an image by dragging the image icon From the film strip and position it onto the map darktable will record the new geo location longitude and latitude as part of the image metadata Exported images will inherit these settings Left and right to the central map there are panels for additional control 2 Panels This section contains documentation for panels that are specific to the map view 2 1 Left panels The panels on the left side we already know from gt collectimages lighttable mode gt recently used collections image information You can define image collections with the collect im ages panel where you can define sets of selection rules Recently used collections can be reached with their respective names in sep
50. ept the current value and go back to normal control You can also directly type in the desired value with your keyboard there is no cursor you just start typing darktable s innovative way of value input coarse and fine value adjustments in one single control el ement 4 Double click on parameter label Insome modules you can double click on a parameter label to reset ts value to default 4 2 Blending operators 26 Blending operators are a functionality that works on the incoming image information and the output of the current module Not all modules support blending because it would not work and break the use of the module Modules that do support blending inherit additional controls at the bottom of module user interface to control parameters of the blending 4 2 1 Usage blend mode There are several modes implemented and more can be added For now all the common ones are there and you will recognize a few of them from other imaging software A good introduction on many common blend modes is given in The Gimp Manual Chapter 8 2 Layer Modes Therefore we only discuss a few blend modes here in more detail off IF set to off no blending will be done and blending related controls are hidden normal This will probably be the most used blend mode it does just mix input and output and will be used to control the modules effect amount for an example Perfect for better control ling raw denoise result inverse
51. ertures set F as the upper value to match arbitrarily closed apertures focal length only apply the preset if the focal length of your image lies within the given range from O to 1000 89 90 Chapter 7 Special Topics darktable s home page at www darktable org has an extensive blog section It covers many technical details background information as well as tips and tricks We replicate a few of our blog articles here as they might be helpful to get things running news about blog install resources development contact CATEGORY ARCHIVES Process HDR images using darktable Posted on October 6 2012 by dinamic Introduction This blog post will go through a simple workflow when working with high dynamic ranged images using darktable and the modules for processing you need use Darktable 1 1RC for this guide The example image used in the screenshots can be downloaded at following link AtriumMorning How to make an HOR image I m not going into details of the process of making an HDR image there are many guides out there Continue reading Posted in blog Tagged HDR processing workflow 7 Replies Geotagging in darktable Posted on September 23 2012 by houz For quite some time people have asked us for a way to geotag their images from within darktable While that is a nifty feature for sure and really helpful when you take pictures outside of a studio we always had to say something along the lines of
52. esult We also wants to add some blue color cast to the shadows to emphasis them a Enable the splittoning module b Select a blue cyan tone for shadows and set saturation around 50 c Set highlights saturation to zero to remove saturation on highlights d Set compression to zero e Use the balance slider to tune the effect our example uses a balance of 70 30 Chapter 4 Tethering The tethering view is where you remote control and capture images from your connected camera directly into darktable 71 1 Overview To use the tethering feature you need to connect your camera to your PC using an USB cable Your desktop environment might ask a question of what you want to do In that case unmount eject is the answer This is required to unlock the camera so darktable can lock it For usage When your camera is connected head over to the import panel in lighttable IF your cam era is not visible in this panel hit the scan devices button and it will appear with two functions import from camera and tethered shoot the latter button is the one you should press to enter tethering mode darktable uses gphoto2 to interface with your camera If you have problems to find the connected camera as described above do check the troubleshoot section in this chapter in order to verify that your camera is supported for use with tethering 1 1 Tethering 12 In the center view images are shown while you cap ture them You can
53. f you want the settings in module output color profile of the individual images to take precedence This defines the output color profile Select image settings if you want the settings in module output color profile of the individual images to take precedence Pressing this button will start a background job to export all selected images A bar at the bottom of the left side panel will display the progress Whenever a file is successful ly exported a notification message will pop up You may press on the pop up to make it disappear 17 18 Chapter 3 Darkroom The darkroom view is where you develop your image el a 5 AA TE ee tar E FI gt K r 5 aes Tag i ms 7 r 7 7 f A gt a lo VW pt FR r E RTS DU AE 1 Du DE oe RES EN a A a a 19 1 Overview 20 In darkroom you are in develop mode for the specific image here you have a lot of tools named modules to develop you image On the left side you have the navigation snapshots and history panels each of them being described below in the right panel you can see the histogram and then a list of available modules to use when working with your image At the bottom of the right panel you can enable disable view of individual modules Since darktable 0 6 1 modules are grouped into four groups basic color correct effect However you can view all modules by selecting no group For those interes
54. function that selects a A trapezoidal function that excludes a narrow range of values for blending narrow range of values from blending Mask blur The mask blur slider applies a gaussian blur to the final blend mask The higher the radius the stronger the blur set to 0 For an unblurred mask This option is useful to get a softer transitions between blended and unblended parts of an image and avoids artifacts 4 3 3 Examples Colorkey effect 30 To make a colorkey effect For this red poppy blossom we need to apply module monochrome to all parts of the image except of the saturated red petals These settings in hue channel construct a blend mask that excludes the red petals The small white bar in the gradient is generated by color picker taking up a probe from within the petals cae as input ma yo XX mask blur The resulting blend mask The final image after module monochrome is ap plied 4 4 Presets Presets are stored configurations for the module parameters both internal and user de Fined is available through clicking the El icon and a list of available presets are shown for your choice the activated preset is in bold text The preset system does also support automatic preset selection based on image data such as Focal length iso camera model and much more fields 4 4 1 Creating a new preset Configure the specific module of choice as you like then you click the El icon and select store
55. get an exposure by either us ing darktable s userinterface or manually triggering a capture on your camera IF you are using LiveView it will be shown in darktable s center view When entering tethering view a filmroll will be created using the same structure as de Fined when you import from the camera Job code will be predefined as capture IF you want to group your captures into different filmrolls you should use the session panel in right side When entering a new name and hitting enter a new filmroll will be created and captured images will go into this new filmroll darktable provides some nifty tools to setup a capture using the user interface You can setup timelapse captures and brackets for HDR creations The configuration is so dynamic that you can create sequential capture of brackets go figure For more information read the documentation about capture panel and the examples in this chapter 2 Panels This section contains documentation for panels that are specific to the tethering view 2 1 Session A session is a sequence of exposures taken in tether ing mode and going into a single filmroll A new ses sion equals a new filmroll A filmroll is created with the same storage structure that is used when you im port images from camera into darktable It s a bit akward but configuring this storage struc ture is done in the camera import dialog for now 2 2 Live view This panel gives you access to control
56. ghttable navigate down lt darktable gt lighttable navigate page down lt darktable gt lighttable navigate page up lt darktable gt lighttable navigate up lt darktable gt lighttable plugins image delete from disk lt darktable gt lighttable plugins image remove from collection lt darktable gt lighttable preview lt darktable gt lighttable rating 1 lt darktable gt lighttable rating 2 lt darktable gt lighttable rating 3 lt darktable gt lighttable rating 4 lt darktable gt lighttable rating 5 lt darktable gt lighttable rating desert lt darktable gt lighttable rating reject lt darktable gt lighttable scroll center lt darktable gt lighttable scroll down lt darktable gt lighttable scroll left lt darktable gt lighttable scroll right lt darktable gt lighttable scroll up lt darktable gt lighttable zoom in lt darktable gt lighttable zoom max lt darktable gt lighttable zoom min lt darktable gt lighttable zoom out F9 F7 F10 F8 Escape L lt Control gt q period F11 Tab F4 F3 F5 F1 F2 lt Shift gt g Page_Down Page Up g Delete om BR WwW PB N i apostrophe Down Left Right Up lt Alt gt 2 lt Alt gt 1 lt Alt gt 4 lt Alt gt 3 87 4 Presets This menu gives you an overview of the presets that are defined for darktable s modules darktable already comes with a set of pre defined presets for several modules In addition you can define your own presets from within each
57. he cen ter image Especially For Softproof this may raise doubts if this mode is still active or not IF in doubt press g which will switch to Gamut Check and will be clearly discernible by cyan marked pixels Press g again and you are back to normal display without Softproof or Gamut Check display profile Sets the color profile for the display Profiles to be used is picked up from SDARK TABLE share darktable color out and SHOME config darktable color out The addition al option system display profile is taken directly from your system s color manager or From your X Server When working with a calibrated display this is the preferred option to choose 4 7 4 Color contrast Overview Usage Color contrast filter changes the contrast between Er color contrast green versus magent and blue versus yellow green vs m 00 Higher values increase color contrast lower values decrease it The effect of this module is similar to a steepened or flattened a or b curve in module tonecurve green vs magenta Changes color contrast for green versus magenta blue vs yellow Changes color contrast for blue versus yellow 4 7 5 Color correction Overview 46 This module can be used to modify the global satura tion or to give a tint Usage color board You can drag a white dot and a dark dot independently to give global tint to highlights and shadows Set dots to the same color for a homogeneous global tint or to d
58. he module groups available Shows the list of current active modules for the Modules you have marked as favorites using more The basic group of modules that is Frequently used when processing raw such as exposure temperature These modules does only work with the image tone Modules that just affects colors such as color correc Modules that makes corrections to the image de Modules with a more artistic output vignetting soft Active processed image ES Favorites modules will show up here Basic etc Tone like levels tonemap etc Color tion vibrance etc Correction noise ca correction etc Effect ening etc 3 7 More modules More modules at the bottom of right panelis used to more modules hide modules you don t use As a default only stan UG o dard modules are shown to the user so if you are 8 bioom missing anything you should check here and show it L 4 chromatic aberrations N ars color contrast color correction U 6 color transfer ses Each modules is shown as a small icon and the module name Left click with your mouse to toggle a module s status visible hidden or favorite Favorite modules are indicated by a star in Front of the icon and will additionally to their normal module group show up in module group favorites This is a good way to get fast access to modules that you use very frequently Visible modules are indicated in the list by a light grey backgro
59. highlight analyses each pixel having at least one channel clipped Then it sets all chan nels to the minium value found among the channels Reconstruct in LCh analyses each pix el having at least one channel clipped and transforms the information in LCh color space to linearly mix the channels clipping threshold Manually adjust the clipping threshold against magenta highlights It s normally not need ed to touch this 4 5 7 White balance Overview This module is used to set the white balance You white balance v have three ways to interact with it a Set up tint in 1 000 temperature in and temperature out b define the eg to value of each channel or c choose from predefined red 1 574 white balances TE 5 preset i camera white balance Y Usage tint Alter the colour tint of the image from magenta value lt 1 to green value gt 1 The chan nel sliders will be updated when you adjust this parameter temperature in out Set the temperature in and temperature out in Kelvin The channel sliders will be updat ed when you adjust this parameter red green and blue channels Set the channel values on a scale from 0 to 8 preset Select a preset white balance camera white balance default White balance reported by the camera spot white balance Select a square area in your image containing mostly grey pixels The white balance is calculated based on that the selected area only contains grey pixels passthro
60. hite before playing around with splittoning effect shadows and highlights color These controls are used to set the color of the splittoning effect you select the desired color and saturation for both shadows and highlights you can also click the color preview box to bring up a common color picker dialog balance The balance is presented as an ratio bar and default value is 50 50 which means that 50 of lightness range in image are used for shadows toning and the other 50 For highlights toning compression 58 Compression is a percentage of total lightness range that is not affected by color toning Default value is set to 33 this is not the default behaviour of an original splittoning which would be 0 compression The choice of 33 as a default is to invite you expriment ing with these parameters and how it extends the original splittoning method Examples Original black and white image Splittoning with blue shadows and yellow highlights 4 9 4 Vignetting Overview Usage scale This module is an artistic feature which creates vi 0 vignetting gnetting modification of the brightness saturation fall off strength at the bo rders brightness The vignetting module has an extensive set of parameters to precisely tune its effect It also will display graphical controls in center view if the module is in focus Give it a try to get a feeling how it works On screen controls and parameter slider
61. iew for the exposure module This module is responsible for one of the most basic steps in each raw image development An exposure adjustment value allows you within certain limits to correct for under or overexposure A shift by 1EV is equivalent to a change of exposure time by a factor of 2 Positive exposure corrections will make the image brighter As a side effect noise level gets higher Depending on the basic noise level of your camera and the iso value of your image positive exposure compensations with up to 1EV or 2EV still give reasonable re sults Negative exposure corrections will make the image darker Given the nature of digital im ages this can not correct for blown out highlights see also module highlight reconstruc tion A black level adjustment is a basic tool to increase contrast and pop of an image The value defines at what threshold dark gray values will be cut off to pure black Use with care as these dark gray values can not be recovered in other modules Further down the pixelpipe Adjust the black level exposure auto Adjust the exposure correction EV Calculate a correct exposition For the rectangular view appearing in the centre of the im age You can draw your own selection using your mouse An adjustment slider right to the auto exposure checkbox lets you define what percentage of bright values to be clipped out in the calculation 4 5 5 Demosaic Overview This module allows you
62. ifferent colors for split toning saturation Use the saturation slider to correct the global saturation 4 7 6 Monochrome Overview This module is a quick way to convert image in black and white You can simulate a color filter in order to modify you conversion That filter can be changed in size and color center monochrome highlights Usage You can change the filter size by scrolling with your mouse wheel 4 7 7 Color zones Overview This module allows to selectively modify the colors in your image It is highly versatile and allows every transformation possible in the LCh colorspace Usage The horizontal axis represent the different values you can modify The vertical axis shows the changes you can achieve For both horizontal and vertical axises you can work on lightness saturation or hue A color picker is activated by pressing i and will show the picked values in the diagram 47 You can click on any of the six nodes on the curve and drag to adjust it vertically A circle indicates how strong adjacent nodes will be affected Use the scroll wheel of your mouse to change the circle diameter You can also use the six controlpoints triangles which de Fine the vertical value of the nodes at bottom to adjust the curve 4 7 8 Color transfer Overview This module allows to transfer on animage the colors color transfer Found on another acquire Usage number of clusters Set the number of co
63. ight not be fully satisfying Examples Original image exposed for the outer sunlit wall to avoid clipped highlights As a consequence the inte rior of the barn has pitch black shadows 33 Er Ma Shadows get lightened highlights are untouched overall effect toned down a bit by blend mode nor shadows 85 00 A mal and an opacity of 65 highlights gaussian Y soften with radius 100 00 compress h 50 00 shadows color adjustment 100 00 highlights color adjustment 50 00 blend mode normal opacity 554 uniformly blend Resulting image DIR 143 K rir moe a gt One A Ze En gt oy BE Re dn N ii hi l j l i f Al Hi ue 4 5 3 Basecurve Overview darktable comes with general enhanced basecurve presets for several models that is per automatic ap plied to raw images for better colors and contrast Usage The basecurve works in camera linear RGB It is defined by two or more nodes You can click on any node and drag to adjust you can also create additional nodes by clicking on a curve segment between two nodes In order to remove a node drag it outside of the diagram area 34 4 5 4 Exposure Overview Usage black This module is used to tweak the exposure IE is di rectly linked to the histogram panel Indeed if you correct exposure graphically using the histogram you automatically activate the exposure module The histogram simply acts as a v
64. is section will guide you through the basics about developing your image which includes most common changes to an image like noise reduction color temperature exposure etc To begin you need to open an image in darkroom mode which you will do by double click ing an image thumbnail on the lighttable it s in the darkroom mode you do the actual adjustments for an image and you have an arsenal of modules at your hand to help you reach your goal Each change you make on a module when developing your image is turned into a history stack item the history is stored in a database and in an XMP sidecar file For the specific image On the left panel in darkroom mode you have the history stack showing changes starting From bottom and building up with each change you have made to the image You can se lect a point in this history to show how the image looked in that point for comparison of changes The stack can be compressed and will discard changes done during the develop ment but will make it optimized When you think you are done and have a good Feeling of what you have done just compress the history stack darktable ships with a bunch of modules and each of them is arranged into groups named module groups these module groups are accessed via toggle buttons in the right panel just under the histogram There are also two special module groups named active and Favorites where active will only show modules enabled in the history for the currentimage a
65. king like typical compiler errors This could indicate an incompatibility between your OpenCL implementation and our in terpretation of the standard In that case visit us at darktable devel sourceforge net and report the problem Chances are good that we can help you Please also report in case you see significant differences between CPU and GPU processing of an image There also exist a few on CPU implementations of OpenCL These come as drivers provid ed by INTEL or AMD We observed that they do not give us any speed gain versus our hand optimized CPU code Therefore we simply discard these devices 2 5 OpenCL still does not run for me As has been said before OpenCL systems come with a huge variety of setups different gpu manufacturers different gpu models varying amounts of gpu memory different drivers different distributions etc Many of the potential problems will only appear with a very specific combination of those factors As we developers of darktable on our computers only have access to a small Fraction of those variations please understand that we might not be able to fix your specific problem There is not much we can do if there is no way for us to reproduce IF nothing else helps the best option might be to start darktable with darktable disable opencl In the end there is nothing in darktable which only runs on gpu Don t let OpenCL discour age you also darktable s cpu code is highly optimized and performant 9
66. lification of noise 4 8 2 Equalizer Overview This versatile module can be used to achieve vari ety of effects such as bloom denoising and local contrast enhancement It works in the wavelet do main and parameters can be tuned for each frequen cy band separately Usage 50 The parameters can be tweaked for each frequency band In particular you can adjust contrast boost and denoise threshold splines For both lightness and chromaticity as well as the sharpness of the wavelet basis on each frequency scale Each spline can be dragged with a proportional ed it approach use the mouse wheel to adjust the ra dius in which your changes will have an effect The transparent area indicates where you would drag the spline with the current mouse position and radius Al so the little triangles at the bottom can be moved to alter the x position of the spline nodes Drag the upper line bright circles here For the light ness channel to affect local contrast Pulling it up as shown here will result in a contrast boost for that Frequency band Higher Frequencies i e smaller de tails are to the right of the grid Pulling it down works too The bottom spline black circles is used to perform denoising It adjusts the wavelet shrinkage threshold For each frequency band Pull it up to see the effect In this example the noise which has been amplified by local contrast enhancement is removed This screen shows
67. lling 5 1 3 The simple way color correction module To perform such conversion we use the color correction module 1 Activate the color correction module 2 Use the bottom slider to set saturation to zero 5 1 4 The artistic way color zones module To perform such conversion we use the color zone module 1 Activate the colour zones module 2 By default the first radio buttons row is set to colorness whereas the second is set to hue wich means that color are selected according to their hue horizontal scale and you can change for each hue its colorness vertical scale You simply need to set all points to the minimum of the vertical scale to de saturate every hue 3 Butnow if you want you can keep some hues a little bit saturated so your image will be all black and white but some hue A classical use for portrait is to keep red hue saturated in order to make the lips standing out You can also use presets that perform black and white conversion keeping some hues saturated 5 1 5 The sophisticated way channel mixer module To perform such conversion we use the channel mixer module 1 Activate the channel mixer module 2 Select the gray output channel 3 Set the proportion of each color the sum having to equal 1 if you want to keep your global lightness 68 5 2 Cross processing 5 2 1 Overview Cross processing is a analog processing technique where slide Film normally developped thanks to an E6 solution is pr
68. lm roll folder pying images to new film roll folder number of folder levels ta show in lists ignore jpeg images when importing film rolls recursive directory traversal when importing filmrolls creatorto be applied when importing publisher to be applied when importing rights ta be applied when importing comma separated tags ta be applied when importing initial import rating enable filmstrip maximum width of image drawing area 1500 maximum height of image drawing area 1000 compression of thumbnail images off ask before deleting a tag af maximum number of images drawn on map 100 pretty print the image location cl close 81 1 Gui options These options control the look and feel of darktable width of the side panels in pixels this controls the size of size panels in pixels side panels are found left and right to the center view default 300 don t use embedded preview jpeg but half size raw check this option to not use the embedded jpeg from the raw file but process the raw data this is slower but gives you color managed thumbnails default off ask before removing images from database always ask the user before any image is removed from db default on ask before erasing images from disk always ask the user before any image file is deleted default on ask before moving images from film roll Folder always ask the user before any image file is moved default on ask before copying images to new film roll
69. lop by double clicking the thumb in the Filmstrip You can also rate the images as you do in lighttable copy paste history stack etc 1 3 Preferences A button El located at the upper panel allows you to define various parameters The options are quite self explaining In case you need more information just let your mouse hover a text label and or entry box to display more information Furthermore all configuration parameters are explained in a later chapter of this manual 2 darktable basic workflow 2 1 Importing Images To begin with darktable you first need to import images You can either import from your filesystem or from your camera if supported 2 1 1 Importing images from filesystem In the left panel you will Find the import module here you have the choice to import either a single image or a folder darktable will analyse its content detect images that are already imported and only import new images 2 1 2 Importing from camera Connect your camera to your system and if your distribution tries to automount it select the option to abort the mount operation Otherwise the camera will be locked and not accessible From within darktable In the left panel of lighttable view you have the import pane IF you don t see your camera there you need to hit the scan for devices button Your camera will then appear in same pane with additional actions import and tethering 2 2 Basic correction 2 2 1 Introduction Th
70. lor clusters to use acquire Acquire the colors of the current image apply Apply the colors shown above previously acquire on another image on the current im age 4 7 9 Vibrance Overview This modules affects the vibrance in the image Vi Er vibrance brance is a widely used term and the endresult dif 25 Fers From program to program Vibrance in darktable does saturate the most saturated pixels and brings down the lightness of those pixels to make the colors off more vivid Usage Vibrance does only have one parameter which controls the amount of vibrance to apply vibrance The amount of vibrance to apply to the image 4 7 10 Input color profile Overview This module sets up the input color profile input color profile enhanced color matrix 48 Usage profile Choose the profile or color matrix to apply darktable offers many widespread matrices along with an enhanced matrix for various camera models The enhanced matrices were processed by the darktable team in order to provide a look close to the manufacturer one You can also supply your own input ICC profiles and put them into SDARKTABLE share darktable color in or SHOME config darktable color in SDARKTABLE is used here as a placeholder for darktable s installation directory and SHOME is your home directory One common source of ICC profiles is the software that is shipped with your camera it often contains profiles specific to your ca
71. los but may lead to an artifical look As said bilateral Filter is much less prone to halo artifacts compress This slider controls how strong the effect extends to midtones high values reduce the ef Fect to the extreme shadows and highlights low values cause strong adjustments also to midtones You normally only need to touch this parameter if you want to limit the effects to the extreme shadows and highlights increase the value in this case At 100 this mod ule has no visible effect any longer as only absolute black and abolute white are affected shadows color adjustment This slider controls the color saturation adjustment made to shadows high values cause saturation enhancements on lightened shadows low values cause desaturation on light ened shadows It is normally safe to leave this at its default of 100 This gives a quite natural saturation boost on shadows similar to the one you would also expect in nature if shadows would receive more light highlights color adjustment This slider controls the color saturation adjustment made to highlights high values cause saturation enhancements on darkened highlights low values cause desaturation on dark ened highlights Often highlights do not contain enough color information to give con vincing colors when darkened You might need to play a bit with this parameter in order to Find the best fitting value depending on your specific image but be aware that sometimes results still m
72. lp to reduce remaining artifacts in special cases Demosaic is done on monitor display only when zoom is greater than 50 or when the ac cording preference setting demosaicing for zoomed out darkroom mode is set accord ingly Else color channels are taken from neighboring pixels without an expensive inter polation method Set the demosaic method darktable currently supports PPG and AMAZE edge threshold Set the threshold for an additional median pass Defaults to 0 which disables median fil tering color smoothing Activates a number of additional color smoothing passes Defaults to off match greens Insome cameras the green filters have slightly varying properties This parameter adds an aditional equilibration step which suppresses artifacts that otherwise could result Avail able options are diabled local average Full average and full and local average 4 5 6 Highlight reconstruction Overview 36 This module tries to reconstruct color information 0 highlight reconstruction that is usually clipped because of the information be A ing not complete in all channels IF you do nothing your clipped areas are often toned to the not clipped channel For example if your green and blue chan nels are clipped then your image will appear red in the clipped areas clipping threshold A 1 000 Usage method You can choose between two methods clipping highlight or reconstructing in LCh Clip ping
73. lue With the color picker button you can select a probe from your image The corresponding values for the real and virtual data channels are displayed in each color channel slider With the reset button Bl you can put all conditional blending settings back to their default state Color channel sliders With the color channel slider you construct a trapezoidal opacity function For this purpose there are four markers per slider Two triangles above the slider they mark the range of 29 values where opacity is 1 Two triangles below the slider they mark the range values where Opacity is zero The Filled triangles indicated the closed mostly narrower edge of the trapezoidal Func tion The open triangles indicate the open mostly wider edge of the trapezoidal Function In its default settings the markers are at the extreme positions left and right of the slider The sequence of the markers always remains unchanged they can touch but they can not switch position A polarity button right to the slider defines what pair of triangles defines the closed edge of the trapezoid positive for the upper triangles corresponding to opacity 1 negative For the lower triangles opacity 0 This allows for two principle types of trapezoidal Functions which are represented graphically in the Following images input Opacity Opacity 3 0 10 20 30 40 50 60 70 80 90 100 0 10 20 30 40 50 60 70 80 90 100 L value L value A trapezoidal
74. ly set the parameter in case the lens profile does not support TCA correction corrections done You will sometimes observe that for a given camera lens combination only part of the possible corrections distortion TCA vignetting are supported by lensfun s profiles This message box will tell you what corrections have actually been applied 53 4 8 6 Spot removal Overview Spot removal allows you to correct a zone in your im y spot removal age by using another zone as model a spot and diag on cam Usage click on the area to be healed then drag to a clean area The circle with line inside is the clean one use mouse scroll wheel over the stroke to change size right click on a stroke to delete Examples Let s use this portrait as example we want to remove some dirt and unwanted catchlight from camera pop up strobe have marked all the spots that want to remove From the image first start by pressing the spot and drag to an area that should be used as reference to remove the spot The handle circle which has a line that ends in the center of the circle indicates refer ence source And here is the result image of the spotremoval 4 8 7 Raw denoise Overview Raw denoise allows you to perfom denoising on pre demosaic data It is ported from dcraw Usage noise threshold Set the threshold for noise detection 54 4 8 8 hotpixels Overview Hotpixels module do try it best to blend u
75. m piler at run time This way the application can use OpenCL on different GPU architectures even at the same time All hardware secrets are hidden in this compiler and are nor mally not visible to the user or the application The compiled OpenCL code is loaded onto your GPU and with certain API calls it is ready to do calculations For you 2 3 How to activate OpenCL in darktable Using OpenCL in darktable requires that your PC is equipped with a suitable graphics card and that it has the required libraries in place Namely modern graphics cards from 95 NVIDIA and ATI come with full OpenCL support The OpenCL compiler is normally shipped as part of the proprietary graphics driver it is reachable as a dynamic library called libOpenCL so This library must be in a folder where it is found by your system s dynamic linker When darktable starts it will First try to find and load libOpenCL so and on success check if the available graphics card comes with OpenCL support A sufficient amount of graphics memory 1GB needs to be available to take advantage of the GPU If that is OK darktable tries to setup its OpenCL environment a processing context needs to be initialized a calculation pipeline to be started OpenCL source code files extension is cl need to be read and compiled and the included routines called OpenCL kernels need to be prepared for darktablele s modules If all that is done the preparation is finished
76. mage drawing area in darkroom mode adjust to your screen needs a restart and will invalidate current thumbnail caches default 1000 compression of thumbnail images controls the compression of thumbnail images in memory and on disk options off low quality Fast high quality slow default off ask before deleting a tag always ask user before deleting a tag from an image default on maximum number of images drawn on map the maximum number of geotagged images drawn on the map increasing this number can slow drawing of the map down needs a restart if changed default 100 pretty print the image location show a more readable representation of the geo location in the image information module default on 83 2 Core options These options control some of the internals of darktable memory in bytes to use for mipmap cache in order to speed up display of filmrolls darktable stores thumbnails in a cache on disk and loads it into memory at startup this controls the cache size in bytes needs a restart if changed default 536870912 number of background threads this controls how many parallel threads are used to create thumbnails during import on 32bit systems it is strongly recommended to set this to 1 needs a restart if changed de Fault 2 export multiple images in parallel set this variable to the desired number of threads if you want multithreaded export to process multiple images at a time be warned
77. mages in background so you can search them by similarity default off 85 3 Shortcuts 86 darktable has a big set of keyaccelerators that with the work of Robert Bieber now is user configurable through the preference pane When you open the shortcuts menu you are presented with a hierarchical list of all actions that can receive a keyaccelerator Go to the action you want to change and double click You are then prompted to press the new key combination to be mapped to the selected action In order to remove an existing keyaccelerator click on the action and press back Space You can export your mappings to a file or import mappings from a file Press default to reset all keyaccelerators to their default state Here follows a table with the default keybindings of actions available in darktable lt darktable gt capture toggle film strip lt Control gt f lt darktable gt darkroom export lt Control gt e lt darktable gt darkroom image back BackSpace lt darktable gt darkroom image forward space lt darktable gt darkroom plugins clipping commit Return lt darktable gt darkroom plugins clipping undo lt Control gt z lt darktable gt darkroom plugins colorout toggle softproofing S lt darktable gt darkroom toggle film strip lt Control gt f lt darktable gt darkroom zoom close up lt Alt gt 1 lt darktable gt darkroom zoom fill lt Alt gt 2 lt darktable gt darkroom zoom fit lt Alt gt 3 lt darktable gt film strip color
78. mera model IF your input image is a JPEG file it will already contain an embedded ICC profile darktable will use this as a default on those images IF you know what you are doing you can overrule darktable and select a different one Select embedded icc profile to restore the default 4 7 11 Unbreak input profile Overview Usage linear This module allows to correct an input profile 9 unbreak input profile 0 1000 0 4500 Set the linear value gamma Set the gamma value to correct your input profile 4 8 Correction group The correction group contains the modules that will correct typical problems in an photo such as hotpixels spot removal noise lens correction among others 4 8 1 Sharpen Overview Usage radius This is an standard UnSharp Mask tool for sharpening sharpen the details of an image ml 2 000 0 500 0 500 off Y This module works by enhancing the contrast around edges and thereby enhances sharp ness impression of an image In darktable this module is only applied to the L channelin Lab color space USM applies a gaussian blur to your image as part ofits algorithm This controls the blur radius which in turn defines the spatial extent of edge enhancement Too high values will lead to ugly over sharpening 49 amount This controls the strength of sharpening threshold Contrast differences below this threshold are excluded from sharpening Use this to avoid amp
79. module in darkroom mode In this dialog you can select whether a certain user defined preset shall be auto applied to matching images Pre defined presets are shown with a lock symbol Their auto apply properties can not be changed Double clicking on a user defined preset will open a menu aperture 0 Ti focal length D 1000 auto apply this preset to matching images activate this checkbutton to make the preset be auto applied to newly imported images a set of fields is displayed where you can define patterns to be matched against EXIF data only show this preset for matching images model maker lens iso 88 activate this checkbutton to hide the preset in darkroom mode if it does not match the defined patterns a pattern to be matched against the EXIF field that describes your camera model use as wildcard a pattern to be matched against the EXIF Field that describes the maker of your camera use as wildcard a pattern to be matched against the EXIF field that describes your lens use as wild card only apply the preset if the iso value of your image lies within the given range exposure only apply the preset if the exposure time of your image lies within the given range set as the upper value to match arbitrarily long exposures aperture only apply the preset if the aperture of your image lies within the given range set F 0 as the lower value to match arbitrarily open ap
80. nd favorites will only show modules selected as a Favorite by you This is done in the more modules at the bottom of the right panel just click your Favorite module until it gets a star displayed in front of the icon and you have chosen your favorite 2 2 2 White balance This module controls the white balance of the image it s always enabled and reads its default values from metadata embedded in the image which will be set by your camera The most common change here will be fine tuning the white balance and this is done using the temperature in slider Taking it down will make the color balance cooler and steering it up will make it warmer 2 2 3 Exposure This might be the simplest module of them all Fine tune your exposure and use the his togram to guide you if you don t know what you are doing You can also boost the black level by increasing the black but be careful use small amount like 0 005 steps IF you Feel lucky use the auto correction Feature this might Fail For several technical reasons You can also click and drag in the histogram to change exposure blackpoint 2 2 4 Noise reduction You have several options in darktable to reduce noise You ll find them in the correct group There is the hot pixel removal module raw denosie denoising based on bilateral Filter non local means and based on wavelets the equalizer Most convenient to use is probably denoising based on non local means as it allows you to treat
81. nding to limit the effect to only parts of your image contrast boost Usage sharpen Set the sharpen The higher the more details contrast boost Set the contrast boost 4 9 8 Lowpass Overview A lowpass filter eg gaussian blur with additional Er lowpass control of outcome as contrast and saturation The radius 25 00 soften with gaussian primary usage for lowpass filter is in combination te nt with a blending operator try out the preset named ento local contrast mask with a overlay blending opera we tion Usage This module offers enormous artistic potential albeit with difficult to predict results sometimes radius Set the radius of the blur soften with This combobox defines the blur algorithm you can chose between Gaussian blur default and bilateral filter The latter leads to an edge preserving blur Gaussian will blur all image channels L a and b Bilateral will only blur L channel contrast Changes the contrast Negative values result in an inverted negative image Higher ab solute values increase contrast lower absolute values reduce contrast A value of zero leads to a neutral plane saturation Changes the color saturation Negative values result in complementary colors by inverting the a b channels Higher absolute values increase color saturation lower absolute values reduce color saturation A value of zero leads to a desaturated black amp white image 62 Examples
82. nwant ed pixels that is detected by a threshold against its neighbours Usage Control the sensitive with the threshold parameter and the strength of how hard to try to blend the pixel with surroundings threshold The threshold of the detection stregth The strength of blending detect by 3 neighbours Wille extend the decetion to use neighbours mark fixed pixels This options will mark the pixels in the view that is corrected and also display the count of detected pixels that is Fixed 4 8 9 Chromatic aberrations Overview This module allows you to correct chromatic aberra 1 chromatic aberrations v tions l hits Usage This module has no option On activation it will automatically try what it can in order to reduce visible CA s 4 9 Effect group In the effect group you will Find modules with a more artistic touch 4 9 1 Watermark Overview The watermark module provides a way to render an yl watermark Y vector based overlay onto your image Watermarks are standard SVG documents and can be designed using Inkscape The SVG processor of darktable also substitutes strings within the SVG document which gives the oppurtunity to include image dependent in 55 formation in the watermark such as aperture expo sure time and other metadata User designed watermarks are placed into the directory config darktable watermarks once in place use the reload button at the right of the watermark file name to update th
83. ocessed in chemicals used for pro cessing print film C41 The resulting images get skewed colors usually a cyan hue and increased con trast and saturation The standard way for doing digital cross processing is to use a channel curve tool but dark table lacks this tool For the moment and another way to accomodiate the effect is used 5 2 2 Procedure This procedure uses tonecurve channelmixer and splittoning modules 1 Image preparation Prepare the image for the cross process steps by adjusting the base settings such as exposure whitebalance etc for a correctly looking image 2 Boost contrast Select the medium contrast curve preset for tonecurve module to boost the overall contrast in the image You later might get back here to tune the curve for better result 3 Color cast This step does change the colorcast as the base for the effect using the channel mixer You might later get back to this and finetune the colorcast of the final result a Enable the channel mixer module b Select blue channel and set blue color value to 0 8 c Select red channel and change blue color value to 0 1 d Select green channel and change blue color value to 0 1 4 Splittoning We use splittoning to add some more coloring to the result for cyan blue shadows and yellow highlight a Enable the splittoning module b Select a cyan blue tone for shadows and set saturation around 50 c Select a yellow orange tone for highlights and set sa
84. on site 3 2 Capturing a timelapse 74 A timelapse is a video clip composed out of images taken on a interval of X seconds A typical example is to take a timelapse of cityscapes where you capture clouds and traffic etc To setup a timelapse capture you should as always create a new session as descibed be Fore Then you need to decide if you want to shoot in manual or auto mode Only go for auto in situations were the ambient light will strongly change over time of the timelapse Eg shooting a timelapse over 24 hours might give you easier control of lights in that kind of captured sequence Head over to the camera settings panel where you define delay and sequence Sequence will give you the oppertunity to choose how many images you want to capture and delay will set the time in seconds between capture To start the capture just hit the capture button in the same panel and watch the filmstrip Fill up with images The latest captured image is always previewed in center view 4 Troubleshoot 4 1 Verify that your camera is supported This troubleshoting guide will give you steps how to verify that your camera can be used with tethering This is mainly done using the gphoto2 commandline tools as this is what darktable uses to interface with your camera 1 Verify that camera is detected The following command will provide which cameras are detected and connected to the computer 0 Find your camera port name to use it in the following tests
85. oned as modes For the time being there are four available views as described in this section The current view is identified by the label at the top of the right panel Some key accelerators allowing to access the different views are described in the table below l switches to lighttable view d switches to darkroom view t switches to camera tethering view m switches to map view 1 1 1 Lighttable The lighttable view is where you manage your images and filmrolls it s in that view that you rate add tags add colorlabels export images among other actions You can perform some actions on the image under the mouse pointer using key accelera tors see Lighttable chapter 1 1 2 Darkroom In the darkroom view you develop a specific image using the available modules 1 1 3 Tethering This view is where you do camera tethering ie connecting your camera to the computer and remotely capturing images that will be downloaded and shown on your computer screen 1 1 4 Map This view allows to see images that are geo tagged on a map 1 2 Filmstrip The Filmstrip shows the same images as lighttable with respect to filters and sort order it is turned on off with key accelerator ctrl f You can navigate along the filmstrip by wheel scrolling The Filmstrip allows you to interact with images when you are not in lighttable mode For example you can while being in darkroom mode and developing an image switch to another image to deve
86. ongly the algorithm distinguishes between brightness levels maps to sigma_r in the algorithm Increasing the value will result in a more contrasty look detail Add or remove detail higher values will increase local contrast Example before After a little overdone to demonstrate the effect Use this sparingly to avoid a cheap overprocessed look 4 6 6 Global tonemap Overview This modules contains a few implementations of O O global tonemap global tonemap operators used for compressing high dynamic ranged images into lower dynamic range Reinhard Filmic and Drago tonamap operators are available For use 42 4 6 7 Tonemapping Overview This module allows to compress the tonal range of tone mapping HDR images so they fit into the limits of a normal low dynamic range image It uses Durand s 2002 al gorithm darktable can import HDR images if they come in OpenEXR format or as a DNG generated by darktable s HDR creation mechanism see chapter on Lighroom mode Usage The underlying algorithm uses a bilateral filter to decompose your image into a coarse base layer and a detail layer The contrast of the base layer is compressed while the detail layer is preserved then both layers are re combined contrast compression Sets the compression of the contrast to fit dynamic range spatial extent Sets the spatial extent of the bilateral Filter Lower values will cause contrast compression to have stronger often adverse
87. p up Navigate through your filesystem and select the item you want to import On the low er part of the dialog you can define some import options As the name implies checking import directories recursively will recurse from the currently selected directory through all subdirectories and import all images found Checking ignore jpeg files is a good choice if there are jpeg images in the same folder that you do not want to process with darktable eg if your camera stores RAW JPEG you often will only want to work further on your raws and let the jpegs alone You can also apply some metadata already on import see the sec tion on Metadata editor later in this manual for more details Importing a folder does not mean that darktable copies your images in another folder IE just means that the images are visible in lighttable and thus can be developed It means that if you delete an image a folder after having imported them darktable will not be able to access them anymore Importing an image folder in darktable is not a backup of your Filesystem Moreover darktable does not currently watch changes in Filesystem Thus if on your filesystem you add an image after having imported that folder in darktable the new image will not be shown until you explicitely import it 2 1 2 Import from cameras When a camera is detected it will show up in the device panel if you hover your mouse over the camera tab label a tooltip will pop up with some info
88. presents the color channel value of the output image pixels Positive a values correspond to more magenta colors negative a values correspond to more greenish colors Positve b values correspond to more yellowish colors negative b values correspond to more blueish colors A straight line does not change anything Shifting the center of the curve will give the image a color tint upwards shifting a channel gives a magenta tint upwards shifting b channel gives a yellow tint downwards shifting a channel gives a green tint downwards shifting b channel gives a blue tint Increasing decreasing the steepness of the curves without shifting its center will in crease decrease the color saturation of the respective channel With properly defined curves you can excert fine control on color saturation depending on input pixel s colors scale chroma darktable does an automatic adjustment of color saturation if this combobox is set to auto The level of this adjustment is dependent on the pixel s color values and its L value modification by the L channel tonecurve It is designed to give an overall boost in color saturation if the L curve gives a contrast boost Look at blend mode coloradjustment to adjust the strength of this effect Only if this combobox is set to manual you can do your own modification of color saturation by the curves in channels a and b Examples 40 Original image Tonecurve settings Please note how the center node of
89. rmation about the camera such as model firmware version and a lot more Depending of the support of your camera buttons with actions will be available such as import images and tethering Import images This will bring up an import dialog showing the images on camera that can be selected For import into a filmroll in darktable Tethering Tethering is used to integrate darktable with your camera While you take images with your camera they will automatically be imported into darktable so you can review the result of the shoot You can also setup remote capture jobs controlling number of images and time between captures along with camera settings such as exposition time Flength and more IF supported by your camera tethering will take you into capture view For tethered shoot Read more about tethering in chapter 4 2 2 Similar images 2 3 Collect images 10 Similar images will match and collect images with v similar images similar image informations to the selected image and nn show them on lighttable az color map weight Thanks to this panel you can manage your collec tion current view by filtering images with various criteria The left combo box lets you choose from dif ferent filters such a filmroll historystack date camera and much more The table below lists all available data for the selected filter You can then se lect the data of your choice by double clicking 2 4 Keywords
90. s 96 darktable will detect OpenCL run time problems automatically It will then reprocess everything on CPU only speed is affected the Final result should not be endangered There can be various reasons why OpenCL could fail during initialization phase We depend on hardware requirements and on the presence of certain drivers and libraries In addition all these have to fit in terms of maker model and revision number IF anything does not fit e g your graphics driver loaded as a kernel module does not match the version of your libOpenCL so OpenCL support is likely not available In that case the best thing to do is start darktable from a console with darktable d opencl This will give additional debugging output about the initialization and use of OpenCL First see if you find a line that starts with opencl_init FINALLY This should tell you if OpenCL support is available For you or not If initialization Failed look at the messages above for anything that reads like could not be detected or could not be created Check if there is a hint about where it Failed Here are a few cases observed in the past darktablele might tell you that no OpenCL aware graphics card is detected or that the available memory on your GPU is too low and the device is discarded In that case you might need to buy a new card if you really want OpenCL support darktablele might find your libOpenCL so but then tell you that it couldn t get a pl
91. s will stay in sync Set radius of the vignetting area fall off strength Set the progressiveness of the fall off Higher values will cause a steeper transition brightness Sets the intensity of brightening positive values or darkening negative values saturation Controls how strong colors get desaturated or saturated in the darkened or brightened vignetting area 59 horizontal center Shifts the center of the vignetting area horizontally vertical center Shifts the center of the vignetting area vertically shape Influences the shape of the vignetting area The default value of 1 causes a circular or elliptical area Smaller values will Shift the shape into a more square one higher values turn it into a cross like shape automatic ratio Click this button to automatically adjust the width height ratio of the vignetting area to the aspect ratio of the underlying image The vignetting area will typically become ellip tical width height ratio Manually adjust the width height ratio of the vignetting area Examples An image with vignetting and with graphical vi gnetting controls 4 9 5 Soften Overview This module is an artistic feature that creates the Or ton effect also commonly known as softening the im age Michael Orton achieved such result on slide Film by using 2 exposures of the same scene one well exposed and one overexposed then he used a tech nique to blend those into a final image
92. supported by darktable IF you anyway stumble into a problem in darktable please file a bug at http www darktable org redmine Please attach outputs of the steps above and the log file output while running darktable with the following command darktable d camectl 271 gt camcul Log Chapter 5 Map The Map view is were you geotag your images TT 1 Overview Map view will show you a world map and pin images that are geotagged into the map There are several processes to get this happen Some cameras have an internal GPS that tags images with location data such as smartphones Other cameras such as DSLR needs some additional GPS hardware to do this Even if you don t have hardware that supports this darktable is able to apply GPX track data onto images While you are on a walk and you either have a GPS tracker recording your movements or you use the right app on your smartphone with GPS functionality you can record a GPX track When you are taking images with your camera on your walk the timestamps of images are stored in EXIF data They can later be matched with the GPX track data and therefore a location can be estimated Matching image timestamps with GPX track data can be done from within lightable mode 1 1 Center map view 78 In the center of the map view you will see a map Map data are taken from open map sources on the internet New map data are only avail able if you are connected to the internet darktable ke
93. t 4 9 12 Graduated Neutral Density Overview This module aims at simulating a neutral density fil AE ter in order to correct exposure and color in a pro gressive manner Usage The module uses a gradient to modify the exposure and the color cast of the image in a non homogeneously manner density Set the density of the filter in ev A low value underexposes slightly whereas a high value creates a strong filter IE is expressed as ev that is equivalent to f stops Lens filters are often referred as ND2 ND4 ND8 and so on Each time you add an ev you double the ND So ND2 is 1 ev ND4 is 2 ev and so on You can also express it in optical density or transmittance The table below sums up the different approach for the most common filters ND ev or F stop absorbance transmittance ND2 1 0 3 50 ND4 2 0 6 25 ND8 3 0 9 12 5 ND400 9 2 1 0 195 compression Set progressiveness of the gradient A low value creates a smooth transition whereas a high value makes the transition abrupt split Set split to offset the filter i e to move the transition zone above or below the centerline Expressed as a percentage values above 50 set the transition zone above the centerline rotation Set the rotation so the gradient acts along an axis different from the vertical one Ex pressed in degrees negative values turn clockwise 66 hue Set the hue to add a colorcast to the gradient saturation Set the
94. t selected image discard Physically delete the history stack development of the selected images Beware this action can not be undone overwrite append Describes how a new history stack must behave if pasted on an image having already an history stack Overwrite will delete previous history stack whereas append will add the two history stacks paste Paste a previously copied history stack on another image This button is greyed out until a history stack is copied from another image load sidecar file Prompt a dialog box to allow you to select a xmp file thus loading an history stack that you will paste thanks to paste button on images write sidecar files Write xmp sidecar Files For all selected images By default darktable will do this automati cally for you whenever you work on an image and change history stack You can deactivate automatic sidecar File generation in the preferences dialog this is not recommended 2 10 Styles This panel lets you use a powerful Functionality of darktable to store and apply a history stack Styles are created in darkroom mode thanks to a button placed below the history stack Then they are man aged within this panel that allows you to apply and delete a style 13 create duplicate When applying a style on selected images activating this box lets you create a duplicate before applying the styles De activate this option if you want to try various styles this will
95. t sys tems you can only have one thread eating resources at a time So you need set this para meter to 1 anything higher will kill you For the same reason you also must set the number of parallel export threads to 1 host memory limit in MB for tiling This parameter tells darktable how much memory in MB it should assume as available to store image buffers during module operations If an image can not be processed within these limits in one chunk tiling will take over and process the image in several parts one after the other Set this to the lowest possible value of 500 as a starting point You might experiment later whether you can increase it a bit in order to reduce the overhead of tiling minimum amount of memory in MB for a single buffer in tiling This is a second parameter that controls tiling It sets a lower limit For the size of interme diate image buffers in megabytes The parameter is needed to avoid excessive tiling in some cases for some modules Set this parameter to a low value of 8 You might tenta tively increase it to 16 later 93 memory in bytes to use for mipmap cache This controls how many thumbnails or mip maps can be stored in memory at a time As a starting point set this to something like 256MB give the number in bytes To avoid the problem of memory fragmentation during longer runs of darktable the new caching scheme frontloads the memory costs and allocates this cache once at the beginning Some
96. te through your collection While in filemanager mode by pressing f you can scroll not select up and down through your collection In zoomable lighttable _ _ 7 allow you to move left right up down through your collection Pressing g goes to the top shift g to the bottom 1 2 Filtering and sort order The filtering and sort order of images on lighttable are accessed and changed in the top bar where you can select among a few predefined filters and ordering like date color labels or rating among others 2 Panels 2 1 Import In this panel you import your filmrolls You can either import a complete Folder by pressing import filmroll or a single image import single image You can also import directly from a connected camera All your filmrolls are available in a list which can be filtered using the editbox to fast Find the filmroll of interest Double click on a filmroll in the list and it will open You can also click the recent filmroll items to open the latest ones you have worked with 2 1 1 Import from filesystem A filmroll is the same as a folder in the filesystem You can import a single image or a Folder IF a folder is imported the images in that folder will show up in a filmroll whose name becomes the name of the imported folder If single images are imported they will show up in filmroll single images When you click on import single image or import filmroll a file selector dialog will po
97. ted in how it works modules are applied on images following a bot tom to top order That means that if you activated the view of all modules by selecting no groups the first module to be applied will be import a RAW at the bottom of the right panel whereas the last one will be splittoning at the top of the right panel That order can not be changed by user so modules are always applied Following the same order You can use middle click to zoom 1 1 A double middle click takes you to 2 1 You can export directly from the darkroom by using ctrl e shortcut Parameters are those currently selected in lighttable 2 Filmstrip The filmstrip is used to quickly switch between images to develop in darkroom view the images viewed are the same as the ones in the lighttable view The filmstrip can be switched on and off using c rl f shortcut You can scroll with your mouse to quickly navigate through the images The height of the filmstrip panel can be changed by dragging the corresponding marker 21 3 Panels This section contains documentation for panels that are specific to the darkroom view 3 1 Navigation The navigation panels shows a full preview of your image and the current viewport of zoom Drag the rectangle around to pan the zoomed in view 3 2 Snapshots You can take a snapshot of what is displayed in the center view this snapshot can then be selected and is overlayed in the current center view to help you
98. th The strength of the denoise Higher values lead to a stronger effect luma Amount of denoise to apply on luma Select carefully in order not to lose too much struc ture chroma Amount of denoise to apply on chroma You can be much more aggressive with this para meter compared to luma 51 4 8 4 Denoise bilateral Overview Usage radius red green blue This module is used to denoise high iso pictures IE is flagged as a slow module due to its high re sources consumption Depending of your hardware this module can currently slow down darktable or even crash it Quite counter intuitively the greater the values for sliders the lesser resources This module reduces noise in your image but preserves sharp edges This is accomplished by averaging pixels with their neighbors taking into account not only the geometric dis tance but also the distance on the range scale i e differences in color intensities As de noising is a resource hungry process it slows down pixelpipe processing significantly con sider to activate this module late in your workflow Set the spatial extent of the gaussian blur Blur intensity for red channel Blur intensity for green channel Blur intensity for blue channel 4 8 5 Lens correction Overview Usage This module is able to correct certain lens flaws namely distortions transversal chromatic aberra tions TCA and vignetting It relies on the external librar
99. th lower amounts of physical RAM and bal ance this with enough swap space However you should be prepared that your system could then heavily go into thrashing action as all too many memory accesses require your system to read or write data pages from to hard disk We have positive reports that this Functions well for several users but it still might get extremely slow For others 1 2 Available address space Besides the total amount of system memory there is another limiting Factor the available address space of your hardware architecture How much memory can be addressed by a process depends on the number of address bits your CPU offers For a CPU with 32 bit address registers this is 2132 bytes which makes a total of AGB This is the absolute upper limit of memory that can be used by a process and it constitutes a tight situation for darktable as we have seen above darktable s escape route is called tiling Instead of processing an image in one big chunk we split the image into smaller parts for every processing step module This will still re quire one full input and output buffer but intermediate buffers can be made small enough to have everything fit into the hardware limits 1 3 Memory fragmentation 92 Unfortunately this is not the Full story yet There is an effect called memory fragmenta tion which can and will hit software that needs to do extensive memory management IF such a program allocates 5 times 300M
100. the effect of the sharpen para meter It is here pulled down to zero for all bands This is effectively a regular trous wavelet without edge detection and results in the characteristic ha los around sharp edges in the image This image is the other extreme The wavelet basis now oversharpens which results in ugly gradient re versals near the ridge of the rock Note that the sharpness parameter only affects the wavelet basis not the image directly So you have to change some denoise contrast boost parameters to see an effect if Fiddling with the sharpness parameter Also have a look at the presets All parameters are changed in there so these might be a good starting point to gain an intuitive understanding about them Note that the sharp ness of the wavelet basis has been set to zero to achieve the bloom effect 4 8 3 Denoise Non local means Overview This is a denoise algorithm which will work on chro EXC denoise non local means ma and or luma E Usage This module reduces noise in your image but preserves structures This is accomplished by averaging a pixel with other pixels in the image The weight of averaging depends on the similarity of the pixels surroundings with the surrounding of the one pixel to be denoised As denoising is a resource hungry process it slows down pixelpipe processing significantly consider to activate this module late in your workflow patch size The size of the patch streng
101. the input of the module is left un changed If for a pixel the blend mask has its maximum value of 1 or 100 the module has full effect 4 3 2 Usage When conditional blending is activated with option Ro ee blend only if an additional set of controls consist or pen ing of several notebook tabs is shown PIRE en 70 output 0 O 100 100 4 PE ut 0 0 100 10 0 A ME mask blur 0 0 Notebook tabs Each notebook tab represents a data channel real or virtual Modules acting in Lab color space have data channels for L a b C chroma of LCh and h hue of LCh Modules acting in RGB color space have data channels for g grey R G B H hue of HSL S saturation of HSL and L lightness of HSL Consult http en wikipedia org wiki Color_space for a deeper look into different color spaces Within each notebook tab two color channel sliders are given one for the input data that the module receives and one for the output data that the module produces prior to blend Ing Control buttons Control buttons help you when designing a blend mask With the eye button Bl you can temporarily deactivate the blend mask blend mode and global opacity slider remain in effect Switch this button on and off to see if the module is acting on the image as intend ed With the mask button El you can directly see the blend mask as a yellow overlay over a black and white copy of the image the stronger the yellow color the higher the blend mask va
102. the original image With low light module on 4 9 10 Bloom Overview This module boost highlights and softly blooms them over the image hence the name of the effect there are numeros ways to use this module dependent on the image actual scenary lightning 64 Usage Keep the default values and start off by changing the strength value for a pleasent value for your image then change the size to control the spread of light size Reprensents the spatial extent of the bloom effect threshold Set the threshold turning on the increase in brightness strength Set the strength of overlightning For the effect Examples This is the original image use it as reference for the changes below Here have choosen to use the size 10 which is a rather small radie for the soft light spread and also boosted up the strength to 50 for a more exagger ated effect 4 9 11 Colorize Overview This module is an artistic feature that adds a solid lay er of color to your image Usage Several parameters control the effect of this module Much more versatility can be reached if you apply blending or even conditional blending hue Select the hue tone of the color layer saturation Select the color saturation of shadow tones 65 lightness Select the lightness of the color layer source mix This slider controls how the lightness of input image is mixed in If you set this to zero a uniformly colored plane will resul
103. tup WIch Screen an 74 3 2 CAD CURING a imelaps Esen a de an een 74 4 TROUDIESHOOE ousa a a a aa na 75 4 1 Verify that your camera is supported ss 75 42 SOO NOW Whal nn M NT a Rial 75 Dia MaD ve o nn die ce ceci en dia ere dada tot Cases eines 17 g PPE S112 AVA ow En dd te 78 Tele Center Map VIEW LA dat Sous ee oh neat de a Sn tue dites 78 LPS adas 79 A a Oe a Ae he 79 22 Fima doca tioN NE Re aa nas 79 2 3 Map SEINS Ne A steel 79 ZAS TAGOUNG ad E 79 6 Preterences and SENGS canica dde nds coco ta desert 81 AGUDOS o a dre an e antes 82 La CON ODEONS daa cocoa anaes 84 3SSNOLL UES ideas 86 a nds apes te A 88 72 SD CIAL TOD ICS a ee Pan ier e ila Seine tania 91 Tdarktable and Menor 3 a intel aida tee laide tes 92 ATS TOLL System MEMORY sia in RS a NS tn nee 92 122 Available address SP ACO 22 ae dessen ned 1 92 13 M mo fragmentatioM ss ad 92 1s4 2EUEChERLIMIESLIONS era Tente e ne nee 93 1 5 Setting up darktable on 32 bit systems ocoocnccncnncnccncnncnnoncnncanononoss 93 1 6 darktable on 64 bit systems ococcccnccncnncnncncnncnncncnncnncnccncnnconcncnncanononos 94 2 Qarktables and A A 95 ZE The BARON ante 95 2 2 HOW OPenEL WOTKS sois daa eo Ada MARNE AS nus 95 2 3 How to activate OpenCL in darktable o occocncnccncnccncnccncnccnoncnnono 95 2 4 Possible Problems and Solutions Rs 96 2 5 OpenCL still does not run for mel ss 97 Preface to this manual The current user m
104. turation around 70 d Set compression to 10 e Use the balance slider to tune the splittoning effect due this differs on every image due to it s exposure motive etc 69 5 3 Cyan toned image 5 3 1 Overview Cyan is a nice color touchup for black and white im agi ages this example guides you through how to make hir ur Wire Hd me ve a Ba ji this with darktable and how to control the tone You can choose any tone of your like For this tutorial 5 3 2 Procedure 70 This procedure uses tonecurve channelmixer and splittoning modules 1 Image preparation Prepare the image for the cyan toned steps by adjusting the base settings such as exposure black level contrast etc for a correctly looking image 2 Black and white Enable the monochrome module to make the image black and white 3 Add color tone This step selects the basetone of the image using channel mixer we are going for cyan tone but you can choose the tone of your like here a Enable the channel mixer module b Select red channel and set red color value to 0 7 c Select green channel and red color value to 0 150 d Select blue channel and red color value to 0 150 As you notice we mix blue and green color to get a cyan tone we substract 0 3 from red channel and add them to blue and green 4 Splittoning The result of previous step does also add a colorcast on highlight that we actually want to have white for a prettier r
105. ugh Show without adjusting For white balance camera presets Camera specific white balance presets Examples di rect sunlight Flash cloudy shade and a number of in door lighting options 21 Finetune Only available when a camera preset is selected Each camera white balance can be Fine tuned within a camera specific range or steps The adjustments are usually towards yellow value lt 1 or blue value gt 1 4 5 8 Invert Overview The main purpose of this module is to invert scanned negatives Usage color of film material The only control element of this module is a color selector which allows to adjust For dif Ferent colors of your Film material Clicking on the colored Field will open a color selector dialog which allows to define a color in HSL or RGB color space You can also activate a color picker by pressing Ml and take a color probe from your image preferrably from the unexposed border of your negative 4 6 Tone group This group contains the modules to work with the tone in the image this means only changin the lightness and leaving the color intact 4 6 1 Fill light Overview This module allows the local modification of the ex fill light Y position based on pixel lightness exposure 033EV Usage The module pushes exposure by increasing lightness in the form of a Gaussian curve cen tered on a given lightness with a given width in lightness exposure Set the fill light exposur
106. und Hid den modules have a dark grey background they will not display any controls whatsoever 25 4 Modules Each correction enhancement or effect is implemented as modules and this section in cludes documentation of each module and its specific parameters A module consists of an expander bar EE A where the K icon is used to turn the module on or off Then there is the name of the module press this to expand the module to see the parameters user interface Icon Bis the preset icon to access the available presets stored for the module or to create new ones The MM icon is used to reset the module pa rameters to their default values 4 1 Interacting with modules For each slider you can interact in three different ways depending on the level of control you need 1 Triangular marker You left click with your mouse on the triangular marker and move it around 2 Mouse wheel Hover a slider with your mouse then use your mouse wheel to adjust by step the value 3 Right click Your mouse being over a slider right click gives you a multi functional pop up below the slider for fine control with your mouse and for entering numerical values with your keyboard A bent line that extends from the triangular marker moves as you move your mouse The closer your mouse pointer is to the triangular marker the coarser the con trol the further away from the triangular marker the finer is your control Left click with your mouse to acc
107. where the overexposed image was blurred Usage This module is almost a copy of Orton s analogue process into the digital domain and you can control brightnesss and blur with the provided parameters we also add a control for saturation of the overexposured image for more play size 60 Set the size of blur of the overexposed image in the process the bigger the softer saturation Set the saturation of the overexposed image brightness Expressed in EV the brightness slider selects the increase in brightness mix Controls the mix of the overexposed image and the overall effect Examples This is the original image use it as reference for the changes below In this image used the default values and added 0 33EV to brightness for a little more light in the soft layer This version is the same as above but with 25 satu ration 4 9 6 Grain Overview This module is an artistic Feature which simulates the grain of a Film Usage The grain is processed on the L channel from CIELAB coarseness Set the grain size which has been scaled to simulate an ISO number strength Set the strength of the effect 61 4 9 7 Highpass Overview Highpass acts as high pass filter The primary usage ES highpass For this Filter is in combination with a blending op sharpness erator Try out blend mode soft light to get high pass sharpening Use the opacity slider to adjust the strength of the effect or even conditional ble
108. x in Lab color space Thus is offers three independent curves for L a and b channels In its default state curves will be straight lines defined by few anchor nodes You can move the nodes with your mouse to modify the curve You can also generate new nodes by clicking on the curve Up to 20 nodes per curve can be defined In order to remove a node move it out of the diagram area A color picker is activated by pressing MI and will show 39 the picked values in the diagram Numerical Lab values of input and output see below at the selected spot are shown on top left of the diagram L channel curve The tonecurve in L channel works on Lightness For a better overview a lightness his togram is displayed in the diagram On the horizontal line is represented the lightness of the input image pixels The vertical line represents the lightness of the output image pixels A straight line does not change anything A point above the default diagonal increases the lightness whereas a point un der decreasesit Shifting the center of the curve upwards will lighten the image shifting it downwards will darken the image An S like curve will enhance the contrast of the image a b channel curves The curves in a channel and b channel work on color values They are only displayed and active if combobox scale chroma is set to manual On the horizontal line is represented the color channel value of the input image pixels The vertiacal line re
109. y lensfun which comes with correction profiles For many but not all common cameras end lenses Canon EOS 5D Mark Il Canon Canon EF 17 40mm f 4L USM 40 fi 8 0 corrections done only distortion In order to perform lens corrections the module uses EXIF data of your image to identify the specific camera lens combination and collects the needed correction parameters from a profile in lensfun s database camera 52 The camera make and model as determined by EXIF data You can overrride this manually and select your camera from a hierarchical menu lens The lens make and model as determined by EXIF data You can overrride this manually and select your lens from a hierarchical menu This is mainly needed for pure mechanical lenses photometric parameters Corrections additionally depend on certain photometric parameters that are read from EXIF data focal length needed for distortion TCA vignetting aperture needed for TCA vignetting and focal distance needed for vignetting Many cameras do not record focal distance in their EXIF data most likely you need to set this manually You can override all automatically selected values IF no controls for the three photometric parameters are displayed this means that no cor rection profile could be found for the automatically identified camera lens combination You may try to find the right profile yourself by searching for it in the menu If there is no matching profile

Download Pdf Manuals

Related Search

Related Contents

KEYTEC DUO Installation Quick Guide – see user's manual for more  ST-6600 ST-6603  Lantronix xPrintServer Home Edition  12088-55  Harman/Kardon Soho  User Manual - Bezares USA  english mp3 elegance compact user manual  Custom Software & Web Design  Circulaire d'application du 28-3-2011    

Copyright © All rights reserved. Failed to retrieve file