luadocs/content/lua.scripts.manual/scripts/contrib/image_stack.md
Bill Ferguson b69d752221 [lua scripts] created manual from script comments
[lua scripts api] created manual from embedded library documentation

[lua api] created stub to contain lua api manual
2020-12-12 15:14:19 -05:00

1.9 KiB

title id weight draft author
image_stack image_stack 180 false people

Name

image_stack.lua - process a stack of images

Description

This script provides another storage (export target) for darktable. Selected images are exported in the specified format to temporary storage. The images are aligned if the user requests it. When the images are ready, imagemagick is launched and uses the selected evaluate-sequence operator to process the images. The output file is written to a filename representing the imput files in the format specified by the user. The resulting image is imported into the film roll. The source images can be tagged as part of the file creation so that a user can later find the contributing images.

Usage

  • require this script from your main lua file
  • select the images to process with image_stack
  • in the export dialog select "image stack" and select the format and bit depth for the exported image
  • Select whether the images need to be aligned.
  • Select the stack operator
  • Select the output format
  • Select whether to tag the source images used to create the resulting file
  • Specify executable locations if necessary
  • Press "export"
  • The resulting image will be imported

Additional Software Required

Limitations

Mean is a fairly quick operation. On my machine (i7-6800K, 16G) it takes a few seconds. Median, on the other hand takes approximately 10x longer to complete. Processing 10 and 12 image stacks took over a minute. I didn't test all the other functions, but the ones I did fell between Mean and Median performance wise.

Author

Bill Ferguson - wpferguson@gmail.com

See Also