diff --git a/ChangeLog.md b/ChangeLog.md new file mode 100644 index 00000000..33b27bd2 --- /dev/null +++ b/ChangeLog.md @@ -0,0 +1,184 @@ +## Changes from most recent to oldest + +**06 Jun 2024 - wpferguson** +* fix fujifilm_ratings running on all images +* added string library functions to sanitize windows io.popen and os.execute functions +* added database maintenance script + +**05 Jun 2024 - wpferguson** +* added fix for executable_manager not being visible on windows + +**30 May 2024 - kkotowicz** +* open in explorer now uses applescript on macos to open multiple files + +**20 May 2024 - wpferguson** +* added string variable substitution to the string library + +**16 May 2024 - wpferguson** +* fix crash in script_manager + +**15 May 2024 - wpferguson** +* added metadata to scripts (name, author, purpose, help url) + +**06 May 2024 - christian.sueltrop** +* added passport_guide_germany script + +**08 Apr 2024 - wpferguson** +* made script_manager aware of library modules in other directories besides lib + +**29 Mar 2024 - wpferguson** +* updated examples/gui_action to use NaN instead of nan + +**29 Mar 2024 - dterrahe** +* add lua action script example + +**28 Jan 2024 - wpferguson** +* fix script_manager crash when script existed in top level lua directory + +**24 Jan 2024 - wpferguson** +* don't set lib visibility unless we are in lighttable mode + +**15 Jan 2024 - MStraeten** +* update x-touch.lua with support for primaries slider + +**14 Jan 2024 - wpferguson** +* added cycle_group_leader script +* added hif_group_leader script +* added jpg_group_leader script + +**28 Oct 2023 - ddittmar** +* Added select non existing image script + +**17 Oct 2023 - wpferguson** +* script_manager wrap username in quotes to handle spaces in username + +**20 Sep 2023 - wpferguson** +* script_manager explicitly set stopped scripts to false + +**18 Aug 2023 - wpferguson** +* swap the position of executable_manager and script_manager due to windows gtk bug + +**17 Jul 2023 - wpferguson** +* update check for update instructions +* update flatpak readme + +**16 Jul 2023 - wpferguson** +* added script_data.show function to contrib/gpx_export + +**15 Jul 2023 - wpferguson** +* script_manager updates +* added check_max_api_version for the case where the API no longer supports the required + functions + +**14 Jul 2023 - spaceChRis** +* add tooltip to filter manager + +**25 Mar 2023 - wpferguson** +* Added script_manager darktable shortcut integration +* Moved filename/path/extension string functions to string library + +**06 Mar 2023 - wpferguson - Added option to disable script_manager update check** + +**12 Jan 2022 - wpferguson - Documented contrib/rename_images.lua** + +**28 Dec 2021 - wpferguson - Replaced deprecated _which_ command with _command -v_ in lib/dtutils/file.lua** + +**12 Dec 2021 - wpferguson** +* Added deprecated function to library +* Added deprecation warning to contrib/rename-tags.lua + +**22 Oct 2021 - wpferguson for Volker Bödker - make sure sequence is 4 digits in rename_images.lua** + +**31 Aug 2021 - wpferguson - remove styles hiding from AutoGrouper.lua** + +**02 Jul 2021 - wpferguson - merged API-7.0.0-dev branch to master** +* API-7.0.0 is darktable 3.6 +* breaking changes + * register_event argments changed + * register_action arguments changed + * register_selection arguments changed + * register_event arguments changed +* scripts updated to API-7.0.0 compatibility +* script_manger updated to be API aware and check out the proper branch + based on darktable API version + +**01 Jul 2021 - wpferguson - created branch for API-6.1.0 - darktable 3.4** + +**20 Jun 2021 - wpferguson - created branches for older API versions** +* API-6.0.0 - darktable 3.2.1 +* API-5.0.2 - darktable 3.0 +* API-5.0.1 - darktable 2.6.1 +* API-5.0.0 - darktable 2.4 +* API-4.0.0 - darktable 2.2 +* API-3.0.0 - darktable 2.0 + +**19 Jun 2021 - wpferguson - fix issue 312, image_path_in_ui** + +**02 Jun 2021 - wpferguson - fix contrib/quicktag** +* set new entry field is_password to false so entry +is visible to user while typing. + +**19 Mar 2021 - wpferguson - fixed crash in contrib/HDRmerge.lua** +* Made generated filename routine gracefully handle names that +are not in the expected format. + +**15 Mar 2021 - scheckmedia - updated contrib/photils.lua** +* refactor print method +* add option to apply selected tags from a single image to multiple images +* add setting parameter to enable/disable the export of an image before tag suggestion + +**25 Feb 2021 - wpferguson - added detached mode to contrib/gimp.lua** + +* Added run_detached checkbox to the exporter GUI. Selecting run_detached +let's GIMP keep running and accepting additional images. It does not return +the edited images to darktable. + +**24 Feb 2021 - Mark64 - make ext_editor lib visible in darkroom view** + +**17 Feb 2021 - wpferguson - API 6.2.3 register_action changes** + +* Added check for API version and supplied a name argument if the +API version was greater than or equal to 6.2.3 + +**10 Feb 2021 - wpferguson - bugfix select_untagged** + +* Fixed callback to return a list of images as expected instead of +doing the selection in the callback + +**10 Feb 2021 - wpferguson - bugfix API 6.2.1 compatibility** + +* The inline check for API version didn't handle argument return +correctly so added a transition library with a register_event function +override to check the API version and process the arguments correctly. + +**9 Feb 2021 - wpferguson - bugfix API 6.2.2 compatibility** + +* The inline check for API version didn't handle argument return +correctly so changed it to a full if/else block + +**4 Reb 2021 - wpferguson - API 6.2.2 compatibililty** + +* Added check for API version and supplied a name argument to register_selection +if the API version was greater than or eqal to 6.2.2 + +**1 Feb 2021 - wpferguson - API 6.2.1 compatibility** + +* Added check for API version and supplied a name argument to register_event +if the API version was greater than or eqal to 6.2.1 + +**21 Jan 2021 - wpferguson - Modified dtutils function find_image_by_id** + +* For users with API 6.2.0 or greater - Enabled use of new API function +darktable.database_get_image() in find_image_by_id(). + +**19 Jan 2021 - schwerdf - Added dtutils library function find_image_by_id()** + +* Added new library function to retrieve an image from the library based on it's ID instead +of it's row number in the database + +**10 Jan 2021 - chrisaga - copy_attach_detach_tags localization** + +**7 Jan 2021 - dtorop - add contrib/fujifilm_dynamic_range** + +* add a new contrib script, fujifilm_dynamic_range to adjust exposure +based on the exposure bias camera setting diff --git a/README.md b/README.md index 75770267..8caa5c2e 100644 --- a/README.md +++ b/README.md @@ -7,23 +7,25 @@ efforts of the darktable developers, maintainers, contributors and community. Th contained in the repository, whether they can be run by themselves (Standalone - Yes) or depend on other scripts (Standalone - No), what operating systems they are known to work on (L - Linux, M - MacOS, W - Windows), and their purpose. +For the latest changes, see the [ChangeLog](ChangeLog.md) + ### Official Scripts These scripts are written primarily by the darktable developers and maintained by the authors and/or repository maintainers. They are located in the official/ directory. Name|Standalone|OS |Purpose ----|:--------:|:---:|------- -check_for_updates|Yes|LMW|Check for updates to darktable -copy_paste_metadata|Yes|LMW|Copy and paste metadata, tags, ratings, and color labels between images -delete_long_tags|Yes|LMW|Delete all tags longer than a specified length -delete_unused_tags|Yes|LMW|Delete tags that have no associated images -enfuse|No|L|Exposure blend several images (HDR) -generate_image_txt|No|L|Generate txt sidecar files to be overlaid on zoomed images -image_path_in_ui|Yes|LMW|Plugin to display selected image path -import_filter_manager|Yes|LMW|Manager for import filters -import_filters|No|LMW|Two import filters for use with import_filter_manager -save_selection|Yes|LMW|Provide save and restore from multiple selection buffers -selection_to_pdf|No|L|Generate a PDF file from the selected images +[check_for_updates](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/check_for_updates)|Yes|LMW|Check for updates to darktable +[copy_paste_metadata](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/copy_paste_metadata)|Yes|LMW|Copy and paste metadata, tags, ratings, and color labels between images +[delete_long_tags](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/delete_long_tags)|Yes|LMW|Delete all tags longer than a specified length +[delete_unused_tags](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/delete_unused_tags)|Yes|LMW|Delete tags that have no associated images +[enfuse](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/enfuse)|No|L|Exposure blend several images (HDR) +[generate_image_txt](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/generate_image_txt)|No|L|Generate txt sidecar files to be overlaid on zoomed images +[image_path_in_ui](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/image_path_in_ui)|Yes|LMW|Plugin to display selected image path +[import_filter_manager](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/import_filter_manager)|Yes|LMW|Manager for import filters +[import_filters](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/import_filters)|No|LMW|Two import filters for use with import_filter_manager +[save_selection](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/save_selection)|Yes|LMW|Provide save and restore from multiple selection buffers +[selection_to_pdf](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/selection_to_pdf)|No|L|Generate a PDF file from the selected images ### Contributed Scripts @@ -32,34 +34,50 @@ These scripts are contributed by users. They are meant to have an "owner", i.e. Name|Standalone|OS |Purpose ----|:--------:|:---:|------- -AutoGrouper|Yes|LMW|Group images together by time -autostyle|Yes|LMW|Automatically apply styles on import -clear_GPS|Yes|LMW|Reset GPS information for selected images -CollectHelper|Yes|LMW|Add buttons to selected images module to manipulate the collection -copy_attach_detach_tags|Yes|LMW|Copy and paste tags from/to images -cr2hdr|Yes|L|Process image created with Magic Lantern Dual ISO -enfuseAdvanced|No|LMW|Merge multiple images into Dynamic Range Increase (DRI) or Depth From Focus (DFF) images -ext_editor|No|LW|Export pictures to collection and edit them with up to nine user-defined external editors -face_recognition|No|LM|Identify and tag images using facial recognition -fujifilm_ratings|No|LM|Support importing Fujifilm ratings -geoJSON_export|No|L|Create a geo JSON script with thumbnails for use in ... -geoToolbox|No|LMW|A toolbox of geo functions -gimp|No|LMW|Open an image in GIMP for editing and return the result -gpx_export|No|LMW|Export a GPX track file from selected images GPS data -HDRMerge|No|LMW|Combind the selected images into an HDR DNG and return the result -hugin|No|LMW|Combine selected images into a panorama and return the result -image_stack|No|LMW|Combine a stack of images to remove noise or transient objects -kml_export|No|L|Export photos with a KML file for usage in Google Earth -LabelsToTags|Yes|LMW|Apply tags based on color labels and ratings -OpenInExplorer|No|LMW|Open the selected images in the system file manager -passport_guide|Yes|LMW|Add passport cropping guide to darkroom crop tool -pdf_slideshow|No|LM|Export images to a PDF slideshow -quicktag|Yes|LMW|Create shortcuts for quickly applying tags -rate_group|Yes|LMW|Apply or remove a star rating from grouped images -rename-tags|Yes|LMW|Change a tag name -select_untagged|Yes|LMW|Enable selection of untagged images -slideshowMusic|No|L|Play music during a slideshow -video_ffmpeg|No|LMW|Export video from darktable +[AutoGrouper](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/autogrouper)|Yes|LMW|Group images together by time +[autostyle](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/autostyle)|Yes|LMW|Automatically apply styles on import +change_group_leader|Yes|LMW|Change which image leads group +[clear_GPS](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/clear_gps)|Yes|LMW|Reset GPS information for selected images +[CollectHelper](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/collecthelper)|Yes|LMW|Add buttons to selected images module to manipulate the collection +color_profile_manager|Yes|LMW|Manage darktable input and output color profiles +[copy_attach_detach_tags](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags)|Yes|LMW|Copy and paste tags from/to images +[cr2hdr](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/cr2hdr)|Yes|L|Process image created with Magic Lantern Dual ISO +cycle_group_leader|Yes|LMW|cycle through images of a group making each the group leader in turn +dbmaint|Yes|LMW|find and remove database entries for missing film rolls and images +[enfuseAdvanced](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/enfuseadvanced)|No|LMW|Merge multiple images into Dynamic Range Increase (DRI) or Depth From Focus (DFF) images +[exportLUT](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/exportlut)|Yes|LMW|Create a LUT from a style and export it +[ext_editor](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/ext_editor)|No|LW|Export pictures to collection and edit them with up to nine user-defined external editors +[face_recognition](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/face_recognition)|No|LM|Identify and tag images using facial recognition +[fujifilm_dynamic_range](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range)|No|LMW|Correct fujifilm exposure based on exposure bias camera setting +[fujifilm_ratings](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/fujifilm_ratings)|No|LM|Support importing Fujifilm ratings +[geoJSON_export](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/geojson_export)|No|L|Create a geo JSON script with thumbnails for use in ... +[geoToolbox](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/geotoolbox)|No|LMW|A toolbox of geo functions +[gimp](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/gimp)|No|LMW|Open an image in GIMP for editing and return the result +[gpx_export](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/gpx_export)|No|LMW|Export a GPX track file from selected images GPS data +harmonic_armature|Yes|LMW|provide a harmonic armature guide +hif_group_leader|Yes|LMW|change the group leader in a raw+heif image pair to the heif image +[HDRMerge](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/hdrmerge)|No|LMW|Combine the selected images into an HDR DNG and return the result +[hugin](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/hugin)|No|LMW|Combine selected images into a panorama and return the result +[image_stack](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/image_stack)|No|LMW|Combine a stack of images to remove noise or transient objects +[image_time](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/image_time)|Yes|LMW|Adjust the EXIF image time +jpg_group_leader|Yes|LMW|change the group leader for a raw+jpg pair to the jpg image +[kml_export](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/kml_export)|No|L|Export photos with a KML file for usage in Google Earth +[LabelsToTags](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/labelstotags)|Yes|LMW|Apply tags based on color labels and ratings +[OpenInExplorer](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/openinexplorer)|No|LMW|Open the selected images in the system file manager +[passport_guide](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/passport_guide)|Yes|LMW|Add passport cropping guide to darkroom crop tool +passport_guide_germany|Yes|LMW|Add passport cropping guide for German passports to darkroom crop tool +[pdf_slideshow](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/pdf_slideshow)|No|LM|Export images to a PDF slideshow +[photils](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/photils)|No|LM|Automatic tag suggestions for your images +[quicktag](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/quicktag)|Yes|LMW|Create shortcuts for quickly applying tags +[rate_group](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rate_group)|Yes|LMW|Apply or remove a star rating from grouped images +[rename_images](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rename_images)|Yes|LMW|Rename single or multiple images +[rename-tags](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rename-tags)|Yes|LMW|Change a tag name +[RL_out_sharp](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rl_out_sharp)|No|LW|Output sharpening using GMic (Richardson-Lucy algorithm) +[select_non_existing](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/select_non_existing)|Yes|LMW|Enable selection of non-existing images in the the currently worked on images +[select_untagged](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/select_untagged)|Yes|LMW|Enable selection of untagged images +[slideshowMusic](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/slideshowMusic)|No|L|Play music during a slideshow +[transfer_hierarchy](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/transfer_hierarchy)|Yes|LMW|Image move/copy preserving directory hierarchy +[video_ffmpeg](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/video_ffmpeg)|No|LMW|Export video from darktable ### Example Scripts @@ -67,17 +85,19 @@ These scripts provide examples of how to use specific portions of the API. They Name|Standalone|OS |Purpose ----|:--------:|:---:|------- -api_version|Yes|LMW|Print the current API version -darkroom_demo|Yes|LMW|Demonstrate changing images in darkoom -gettextExample|Yes|LM|How to use translation -hello_world|Yes|LMW|Prints hello world when darktable starts -lighttable_demo|Yes|LMW|Demonstrate controlling lighttable mode, zoom, sorting and filtering -moduleExample|Yes|LMW|How to create a lighttable module -multi_os|No|LMW|How to create a cross platform script that calls an external executable -panels_demo|Yes|LMW|Demonstrate hiding and showing darktable panels -preferenceExamples|Yes|LMW|How to use preferences in a script -printExamples|Yes|LMW|How to use various print functions from a script -running_os|Yes|LMW|Print out the running operating system +[api_version](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/api_version)|Yes|LMW|Print the current API version +[darkroom_demo](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/darkroom_demo)|Yes|LMW|Demonstrate changing images in darkoom +[gettextExample](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/gettextexample)|Yes|LM|How to use translation +gui_actions|Yes|LMW|demonstrate controlling the GUI using darktable.gui.action calls +[hello_world](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/hello_world)|Yes|LMW|Prints hello world when darktable starts +[lighttable_demo](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/lighttable_demo)|Yes|LMW|Demonstrate controlling lighttable mode, zoom, sorting and filtering +[moduleExample](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/moduleexample)|Yes|LMW|How to create a lighttable module +[multi_os](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/multi_os)|No|LMW|How to create a cross platform script that calls an external executable +[panels_demo](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/panels_demo)|Yes|LMW|Demonstrate hiding and showing darktable panels +[preferenceExamples](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/preferenceexamples)|Yes|LMW|How to use preferences in a script +[printExamples](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/printexamples)|Yes|LMW|How to use various print functions from a script +[running_os](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/running_os)|Yes|LMW|Print out the running operating system +x-touch|Yes|LMW|demonstrate how to use an x-touch mini MIDI controller to control the darktable GUI ### Tools @@ -85,11 +105,11 @@ Tool scripts perform functions relating to the repository, such as generating do Name|Standalone|OS |Purpose ----|:--------:|:---:|------- -executable_manager|Yes|LMW|Manage the external executables used by the lua scripts -gen_i18n_mo|No|LMW|Generate compiled translation files (.mo) from source files (.po) -get_lib_manpages|No|LM|Retrieve the library documentation and output it in man page and PDF format -get_libdoc|No|LMW|Retrieve the library documentation and output it as text -script_manager|No|LMW|Manage (install, update, enable, disable) the lua scripts +[executable_manager](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/executable_manager)|Yes|LMW|Manage the external executables used by the lua scripts +[gen_i18n_mo](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/gen_i18n_mo)|No|LMW|Generate compiled translation files (.mo) from source files (.po) +[get_lib_manpages](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/get_lib_manpages)|No|LM|Retrieve the library documentation and output it in man page and PDF format +[get_libdoc](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/get_libdoc)|No|LMW|Retrieve the library documentation and output it as text +[script_manager](https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/script_manager)|No|LMW|Manage (install, update, enable, disable) the lua scripts ### Related third-party projects @@ -105,6 +125,10 @@ The following third-party projects are listed for information only. Think of thi * [johnnyrun/darktable_lua_gimp](https://github.com/johnnyrun/darktable_lua_gimp) – GIMP export * [arru/darktable-scripts](https://github.com/arru/darktable-scripts) * [nbremond77/darktable](https://github.com/nbremond77/darktable/tree/master/scripts) +* [s5k6/dtscripts](https://github.com/s5k6/dtscripts) +* [ChristianBirzer/darktable_extra_scripts](https://github.com/ChristianBirzer/darktable_extra_scripts) +* [fjb2020/darktable-scripts](https://github.com//fjb2020/darktable-scripts) +* [bastibe/Darktable-Film-Simulation-Panel](https://github.com/bastibe/Darktable-Film-Simulation-Panel) ## Download and Install @@ -113,14 +137,24 @@ are met as well as providing an easy update path. Single scripts listed as stand ### snap packages -The snap version of darktable comes with lua included starting with version 2.4.3snap2. It is currently in the edge channel, but should reach the stable channel soon. +The snap version of darktable comes with lua included starting with version 2.4.3snap2. Ensure git is installed on your system. If it isn't, use the package manager to install it. Then open a terminal and: cd ~/snap/darktable/current git clone https://github.com/darktable-org/lua-scripts.git lua -### flatpak and appimage packages +### flatpak packages + +Flatpak packages now use the internal lua interpreter. + + +Ensure git is installed on your system. If it isn't, use the package manager to install it. Then open a terminal and: + + cd ~/.var/app/org.darktable.Darktable/config/darktable + git clone https://github.com/darktable-org/lua-scripts.git lua + +### appimage packages These packages run in their own environment and don't have access to a lua interpreter, therefore the scripts can't run. The packagers could enable the internal interpreter, or allow the package to link the interpreter from the operating system, or bundle a copy of lua with the package. If you use one of these packages and wish to use the lua scripts, please contact the package maintainer and suggest the above fixes. @@ -135,8 +169,6 @@ Ensure git is installed on your system. If it isn't, use the package manager to Ensure git is installed on your system. Git can be obtained from https://gitforwindows.org/, as well as other places. If you use the gitforwindows.org distribution, install the Git Bash Shell also as it will aid in debugging the scripts if necessary. Then open a command prompt and run: -Open a command prompt. - cd %LOCALAPPDATA%\darktable git clone https://github.com/darktable-org/lua-scripts.git lua @@ -146,6 +178,24 @@ If you don't have %LOCALAPPDATA%\darktable you have to start dartable at least o When darktable starts it looks for a file name `~/.config/darktable/luarc` (`%LOCALAPPDATA%\darktable\luarc` for windows) and reads it to see which scripts to include. The file is a plain text file with entries of the form `require "/"` where directory is the directory containing the scripts, from the above list, and name is the name from the above list. To include GIMP the line would be `require "contrib/gimp"`. +The recommended way to enable and disable specific scripts is using the script manager module. To use script manager do the following: + +### Linux or MacOS + + echo 'require "tools/script_manager"' > ~/.config/darktable/luarc + +### Windows + + echo require "tools/script_manager" > %LOCALAPPDATA%\darktable\luarc + +### Snap + + echo 'require "tools/script_manager"' > ~/snap/darktable/current/luarc + +### Flatpak + + echo 'require "tools/script_manager"' > ~/.var/app/org.darktable.Darktable/config/darktable/luarc + You can also create or add lines to the luarc file from the command line: `echo 'require "contrib/gimp"' > ~/.config/darktable/luarc` to create the file with a gimp entry\ @@ -169,6 +219,12 @@ To update the script repository, open a terminal or command prompt and do the fo cd ~/snap/darktable/current/lua git pull + +### Flatpak + + cd ~/.var/app/org.darktable.Darktable/config/darktable/lua + git pull + ### Linux and MacOS cd ~/.config/darktable/lua/ @@ -181,15 +237,19 @@ To update the script repository, open a terminal or command prompt and do the fo ## Documentation -Each script includes its own documentation and usage in its header, please refer to them. +The [Lua Scripts Manual](https://docs.darktable.org/lua/stable/lua.scripts.manual/) provides documentation +for the scripts transcribed from the header comments. Each script also contains comments and usage instructions +in the header comments. -Lua-script libraries documentation may be generated using the tools in the tools/ directory. +The [Lua Scripts Library API Manual](https://docs.darktable.org/lua/stable/lua.scripts.api.manual/) provides +documentation of the libraries and functions. Lua-script libraries documentation may also be generated using +the tools in the tools/ directory. More information about the scripting with Lua can be found in the darktable user manual: -https://www.darktable.org/usermanual/en/lua_chapter.html +[Scripting with Lua](https://darktable.org.github.io/dtdocs/lua/) -The darktable Lua API documentation is here: -https://www.darktable.org/lua-api/ +The [Lua API Manual](https://docs.darktable.org/lua/stable/lua.api.manual/) provides docuemntation of the +darktable Lua API. ## Troubleshooting @@ -199,13 +259,17 @@ Running darktable with Lua debugging enabled provides more information about wha Open a terminal and start darktable with the command `snap run darktable -d lua`. This provides debugging information to give you insight into what is happening. -### Linux and MacOS +### Linux Open a terminal and start darktable with the command `darktable -d lua`. This provides debugging information to give you insight into what is happening. +### MacOS + +Open a terminal and start darktable with the command `/Applications/darktable.app/Contents/MacOS/darktable -d lua`. This provides debugging information to give you insight into what is happening. + ### Windows -Open the Git Bash Shell. Start darktable with the command `/c/Program\ Files/darktable/bin/darktable -d lua`. This provides debugging information to give you insight into what is happening. +Open a command prompt. Start darktable with the command "C:\Program Files\darktable\bin\darktable" -d lua > log.txt. This provides debugging information to give you insight into what is happening. ## Contributing diff --git a/contrib/AutoGrouper.lua b/contrib/AutoGrouper.lua index 0d929150..889c9af1 100644 --- a/contrib/AutoGrouper.lua +++ b/contrib/AutoGrouper.lua @@ -1,158 +1,225 @@ ---[[AutoGrouper plugin for darktable - - copyright (c) 2019 Kevin Ertel - - 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 . -]] - ---[[About this Plugin -This plugin adds the module "Auto Group" to darktable's lighttable view - -----REQUIRED SOFTWARE---- -None - -----USAGE---- -Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) - 1) Copy this file in to your "lua/contrib" folder where all other scripts reside. - 2) Require this file in your luarc file, as with any other dt plug-in - -Set a gap amount in second which will be used to determine when images should no -longer be added to a group. If an image is more then the specified amount of time -from the last image in the group it will not be added. Images without timestamps -in exif data will be ignored. - -There are two buttons. One allows the grouping to be performed only on the currently -selected images, the other button performs grouping on the entire active collection -]] - -local dt = require "darktable" -local MOD = 'autogrouper' -local gettext = dt.gettext --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("AutoGrouper",dt.configuration.config_dir.."/lua/locale/") -local function _(msgid) - return gettext.dgettext("AutoGrouper", msgid) -end - -local function InRange(test, low, high) --tests if test value is within range of low and high (inclusive) - if test >= low and test <= high then - return true - else - return false - end -end - -local function CompTime(first, second) --compares the timestamps and returns true if first was taken before second - first_time = first.exif_datetime_taken - if string.match(first_time, '[0-9]') == nil then first_time = '9999:99:99 99:99:99' end - first_time = tonumber(string.gsub(first_time, '[^0-9]*','')) - second_time = second.exif_datetime_taken - if string.match(second_time, '[0-9]') == nil then second_time = '9999:99:99 99:99:99' end - second_time = tonumber(string.gsub(second_time, '[^0-9]*','')) - return first_time < second_time -end - -local function SeperateTime(str) --seperates the timestamp into individual components for used with OS.time operations - local cleaned = string.gsub(str, '[^%d]',':') - cleaned = string.gsub(cleaned, '::*',':') --YYYY:MM:DD:hh:mm:ss - local year = string.sub(cleaned,1,4) - local month = string.sub(cleaned,6,7) - local day = string.sub(cleaned,9,10) - local hour = string.sub(cleaned,12,13) - local min = string.sub(cleaned,15,16) - local sec = string.sub(cleaned,18,19) - return {year = year, month = month, day = day, hour = hour, min = min, sec = sec} -end - -local function GetTimeDiff(curr_image, prev_image) --returns the time difference (in sec.) from current image and the previous image - local curr_time = SeperateTime(curr_image.exif_datetime_taken) - local prev_time = SeperateTime(prev_image.exif_datetime_taken) - return os.time(curr_time)-os.time(prev_time) -end - -local function main(on_collection) - local images = {} - if on_collection then - local col_images = dt.collection - for i,image in ipairs(col_images) do --copy images to a standard table, table.sort barfs on type dt_lua_singleton_image_collection - table.insert(images,i,image) - end - else - images = dt.gui.selection() - end - dt.preferences.write(MOD, 'active_gap', 'integer', GUI.gap.value) - if #images < 2 then - dt.print('please select at least 2 images') - return - end - table.sort(images, function(first, second) return CompTime(first,second) end) --sort images by timestamp - - for i, image in ipairs(images) do - if i == 1 then - prev_image = image - elseif string.match(image.exif_datetime_taken, '[%d]') ~= nil then --make sure current image has a timestamp, if so check if it is within the user specified gap value and add to group - local curr_image = image - if GetTimeDiff(curr_image, prev_image) <= GUI.gap.value then - images[i]:group_with(images[i-1]) - end - prev_image = curr_image - end - end -end - --- GUI -- -GUI = { - gap = {}, - selected = {}, - collection = {} -} -temp = dt.preferences.read(MOD, 'active_gap', 'integer') -if not InRange(temp, 1, 86400) then temp = 3 end -GUI.gap = dt.new_widget('slider'){ - label = _('group gap [sec.]'), - tooltip = _('minimum gap, in seconds, between groups'), - soft_min = 1, - soft_max = 60, - hard_min = 1, - hard_max = 86400, - step = 1, - digits = 0, - value = temp, - reset_callback = function(self) - self.value = 3 - end -} -GUI.selected = dt.new_widget("button"){ - label = _('auto group: selected'), - tooltip =_('auto group selected images'), - clicked_callback = function() main(false) end -} -GUI.collection = dt.new_widget("button"){ - label = _('auto group: collection'), - tooltip =_('auto group the entire collection'), - clicked_callback = function() main(true) end -} -dt.register_lib( - 'AutoGroup_Lib', -- Module name - _('auto group'), -- name - true, -- expandable - true, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 99}}, -- containers - dt.new_widget("box"){ - orientation = "vertical", - GUI.gap, - GUI.selected, - GUI.collection - } -) +--[[AutoGrouper plugin for darktable + + copyright (c) 2019 Kevin Ertel + + 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 . +]] + +--[[About this Plugin +This plugin adds the module "Auto Group" to darktable's lighttable view + +----REQUIRED SOFTWARE---- +None + +----USAGE---- +Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) + 1) Copy this file in to your "lua/contrib" folder where all other scripts reside. + 2) Require this file in your luarc file, as with any other dt plug-in + +Set a gap amount in second which will be used to determine when images should no +longer be added to a group. If an image is more then the specified amount of time +from the last image in the group it will not be added. Images without timestamps +in exif data will be ignored. + +There are two buttons. One allows the grouping to be performed only on the currently +selected images, the other button performs grouping on the entire active collection +]] + +local dt = require "darktable" +local du = require "lib/dtutils" + +du.check_min_api_version("7.0.0", "AutoGrouper") + +local MOD = 'autogrouper' + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("auto group"), + purpose = _("automatically group images by time interval"), + author = "Kevin Ertel", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/AutoGrouper/" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local Ag = {} +Ag.module_installed = false +Ag.event_registered = false + +local GUI = { + gap = {}, + selected = {}, + collection = {} +} + + +local function InRange(test, low, high) --tests if test value is within range of low and high (inclusive) + if test >= low and test <= high then + return true + else + return false + end +end + +local function CompTime(first, second) --compares the timestamps and returns true if first was taken before second + first_time = first.exif_datetime_taken + if string.match(first_time, '[0-9]') == nil then first_time = '9999:99:99 99:99:99' end + first_time = tonumber(string.gsub(first_time, '[^0-9]*','')) + second_time = second.exif_datetime_taken + if string.match(second_time, '[0-9]') == nil then second_time = '9999:99:99 99:99:99' end + second_time = tonumber(string.gsub(second_time, '[^0-9]*','')) + return first_time < second_time +end + +local function SeperateTime(str) --seperates the timestamp into individual components for used with OS.time operations + local cleaned = string.gsub(str, '[^%d]',':') + cleaned = string.gsub(cleaned, '::*',':') --YYYY:MM:DD:hh:mm:ss + local year = string.sub(cleaned,1,4) + local month = string.sub(cleaned,6,7) + local day = string.sub(cleaned,9,10) + local hour = string.sub(cleaned,12,13) + local min = string.sub(cleaned,15,16) + local sec = string.sub(cleaned,18,19) + return {year = year, month = month, day = day, hour = hour, min = min, sec = sec} +end + +local function GetTimeDiff(curr_image, prev_image) --returns the time difference (in sec.) from current image and the previous image + local curr_time = SeperateTime(curr_image.exif_datetime_taken) + local prev_time = SeperateTime(prev_image.exif_datetime_taken) + return os.time(curr_time)-os.time(prev_time) +end + +local function main(on_collection) + local images = {} + if on_collection then + local col_images = dt.collection + for i,image in ipairs(col_images) do --copy images to a standard table, table.sort barfs on type dt_lua_singleton_image_collection + table.insert(images,i,image) + end + else + images = dt.gui.selection() + end + dt.preferences.write(MOD, 'active_gap', 'integer', GUI.gap.value) + if #images < 2 then + dt.print('please select at least 2 images') + return + end + table.sort(images, function(first, second) return CompTime(first,second) end) --sort images by timestamp + + for i, image in ipairs(images) do + if i == 1 then + prev_image = image + image:make_group_leader() + elseif string.match(image.exif_datetime_taken, '[%d]') ~= nil then --make sure current image has a timestamp, if so check if it is within the user specified gap value and add to group + local curr_image = image + if GetTimeDiff(curr_image, prev_image) <= GUI.gap.value then + images[i]:group_with(images[i-1].group_leader) + end + prev_image = curr_image + end + end +end + +local function install_module() + if not Ag.module_installed then + dt.print_log("installing module") + dt.register_lib( + MOD, -- Module name + _('auto group'), -- name + true, -- expandable + true, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 99}}, -- containers + dt.new_widget("box"){ + orientation = "vertical", + GUI.gap, + GUI.selected, + GUI.collection + } + ) + Ag.module_installed = true + dt.print_log("module installed") + dt.print_log("styles module visibility is " .. tostring(dt.gui.libs["styles"].visible)) + end +end + +local function destroy() + dt.gui.libs[MOD].visible = false +end + +local function restart() + dt.gui.libs[MOD].visible = true +end + +-- GUI -- +temp = dt.preferences.read(MOD, 'active_gap', 'integer') +if not InRange(temp, 1, 86400) then temp = 3 end +GUI.gap = dt.new_widget('slider'){ + label = _('group gap [sec.]'), + tooltip = _('minimum gap, in seconds, between groups'), + soft_min = 1, + soft_max = 60, + hard_min = 1, + hard_max = 86400, + step = 1, + digits = 0, + value = temp, + reset_callback = function(self) + self.value = 3 + end +} +GUI.selected = dt.new_widget("button"){ + label = _('auto group: selected'), + tooltip =_('auto group selected images'), + clicked_callback = function() main(false) end +} +GUI.collection = dt.new_widget("button"){ + label = _('auto group: collection'), + tooltip =_('auto group the entire collection'), + clicked_callback = function() main(true) end +} + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not Ag.event_registered then + dt.register_event( + "AutoGrouper", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + Ag.event_registered = true + end +end + +script_data.destroy = destroy +script_data.destroy_method = "hide" +script_data.restart = restart +script_data.show = restart + +return script_data diff --git a/contrib/CollectHelper.lua b/contrib/CollectHelper.lua index 5996592d..978aa309 100644 --- a/contrib/CollectHelper.lua +++ b/contrib/CollectHelper.lua @@ -1,221 +1,258 @@ ---[[Collect Helper plugin for darktable - - copyright (c) 2019 Kevin Ertel - - 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 . -]] - ---[[About this plugin -This plugin adds the button(s) to the "Selected Images" module: -1) Return to Previous Collection -2) Collect on image's Folder -3) Collect on image's Color Label(s) -4) Collect on All (AND) - -It also adds 3 preferences to the lua options dialog box which allow the user to activate/deactivate the 3 "Collect on" buttons. - -Button Behavior: -1) Return to Previous Collection - Will reset the collect parameters to the previously active settings -2) Collect on image's Folder - Will change the collect parameters to be "Folder" with a value of the selected image's folder location -3) Collect on image's Color Label(s) - Will change the collect parameter to be "Color" with a value of the selected images color labels, will apply multiple parameters with AND logic if multiple exist -4) Collect on All (AND) - Will collect on all parameters activated by the preferences dialog, as such this button is redundant if you only have one of the two other options enabled - -----REQUIRED SOFTWARE---- -NA - -----USAGE---- -Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) - 1) Copy this file in to your "lua/contrib" folder where all other scripts reside. - 2) Require this file in your luarc file, as with any other dt plug-in - -Select the photo you wish to change you collection based on. -In the "Selected Images" module click on "Collect on this Image" - -----KNOWN ISSUES---- -]] - -local dt = require "darktable" -local gettext = dt.gettext -local previous = nil -local all_active = false - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("CollectHelper",dt.configuration.config_dir.."/lua/locale/") - -local function _(msgid) - return gettext.dgettext("CollectHelper", msgid) -end - --- FUNCTION -- -local function CheckSingleImage(selection) - if #selection ~= 1 then - dt.print(_("Please select a single image")) - return true - end - return false -end -local function CheckHasColorLabel(selection) - local ret = false - for _,image in pairs(selection) do - if image.red then ret = true end - if image.blue then ret = true end - if image.green then ret = true end - if image.yellow then ret = true end - if image.purple then ret = true end - end - return ret -end -local function PreviousCollection() - if previous ~= nil then - previous = dt.gui.libs.collect.filter(previous) - end -end -local function CollectOnFolder(all_rules, all_active) - local images = dt.gui.selection() - if CheckSingleImage(images) then - return - end - local rules = {} - local rule = dt.gui.libs.collect.new_rule() - rule.mode = "DT_LIB_COLLECT_MODE_AND" - rule.data = images[1].path - rule.item = "DT_COLLECTION_PROP_FOLDERS" - table.insert(rules, rule) - if all_active then - for _,active_rule in pairs(rules) do - table.insert(all_rules, active_rule) - end - return all_rules - else - previous = dt.gui.libs.collect.filter(rules) - end -end -local function CollectOnColors(all_rules, all_active) - local images = dt.gui.selection() - if CheckSingleImage(images) then - return - end - if not CheckHasColorLabel(images) then - dt.print(_('select an image with an active color label')) - return - end - for _,image in pairs(images) do - local rules = {} - if image.red then - local red_rule = dt.gui.libs.collect.new_rule() - red_rule.mode = "DT_LIB_COLLECT_MODE_AND" - red_rule.data = "red" - red_rule.item = "DT_COLLECTION_PROP_COLORLABEL" - table.insert(rules, red_rule) - end - if image.blue then - local blue_rule = dt.gui.libs.collect.new_rule() - blue_rule.mode = "DT_LIB_COLLECT_MODE_AND" - blue_rule.data = "blue" - blue_rule.item = "DT_COLLECTION_PROP_COLORLABEL" - table.insert(rules, blue_rule) - end - if image.green then - local green_rule = dt.gui.libs.collect.new_rule() - green_rule.mode = "DT_LIB_COLLECT_MODE_AND" - green_rule.data = "green" - green_rule.item = "DT_COLLECTION_PROP_COLORLABEL" - table.insert(rules, green_rule) - end - if image.yellow then - local yellow_rule = dt.gui.libs.collect.new_rule() - yellow_rule.mode = "DT_LIB_COLLECT_MODE_AND" - yellow_rule.data = "yellow" - yellow_rule.item = "DT_COLLECTION_PROP_COLORLABEL" - table.insert(rules, yellow_rule) - end - if image.purple then - local purple_rule = dt.gui.libs.collect.new_rule() - purple_rule.mode = "DT_LIB_COLLECT_MODE_AND" - purple_rule.data = "purple" - purple_rule.item = "DT_COLLECTION_PROP_COLORLABEL" - table.insert(rules, purple_rule) - end - if all_active then - for _,active_rule in pairs(rules) do - table.insert(all_rules, active_rule) - end - return all_rules - else - previous = dt.gui.libs.collect.filter(rules) - end - end -end -local function CollectOnAll_AND() - local images = dt.gui.selection() - if CheckSingleImage(images) then - return - end - local rules = {} - if dt.preferences.read('module_CollectHelper','folder','bool') then - rules = CollectOnFolder(rules, true) - end - if dt.preferences.read('module_CollectHelper','colors','bool') then - rules = CollectOnColors(rules, true) - end - previous = dt.gui.libs.collect.filter(rules) -end - --- GUI -- -dt.gui.libs.image.register_action( - _("collect: previous"), - function() PreviousCollection() end, - _("Sets the Collect parameters to be the previously active parameters") -) -if dt.preferences.read('module_CollectHelper','folder','bool') then - dt.gui.libs.image.register_action( - _("collect: folder"), - function() CollectOnFolder(_ , false) end, - _("Sets the Collect parameters to be the selected images's folder") - ) -end -if dt.preferences.read('module_CollectHelper','colors','bool') then - dt.gui.libs.image.register_action( - _("collect: color label(s)"), - function() CollectOnColors(_ , false) end, - _("Sets the Collect parameters to be the selected images's color label(s)") - ) -end -if dt.preferences.read('module_CollectHelper','all_and','bool') then - dt.gui.libs.image.register_action( - _("collect: all (AND)"), - function() CollectOnAll_AND() end, - _("Sets the Collect parameters based on all activated CollectHelper options") - ) -end - --- PREFERENCES -- -dt.preferences.register("module_CollectHelper", "all_and", -- name - "bool", -- type - _('CollectHelper: All'), -- label - _('Will create a collect parameter set that utelizes all enabled CollectHelper types (AND)'), -- tooltip - true -- default -) -dt.preferences.register("module_CollectHelper", "colors", -- name - "bool", -- type - _('CollectHelper: Color Label(s)'), -- label - _('Enable the button that allows you to swap to a collection based on selected image\'s COLOR LABEL(S)'), -- tooltip - true -- default -) -dt.preferences.register("module_CollectHelper", "folder", -- name - "bool", -- type - _('CollectHelper: Folder'), -- label - _('Enable the button that allows you to swap to a collection based on selected image\'s FOLDER location'), -- tooltip - true -- default -) +--[[Collect Helper plugin for darktable + + copyright (c) 2019 Kevin Ertel + + 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 . +]] + +--[[About this plugin +This plugin adds the button(s) to the "Selected Images" module: +1) Return to Previous Collection +2) Collect on image's Folder +3) Collect on image's Color Label(s) +4) Collect on All (AND) + +It also adds 3 preferences to the lua options dialog box which allow the user to activate/deactivate the 3 "Collect on" buttons. + +Button Behavior: +1) Return to Previous Collection - Will reset the collect parameters to the previously active settings +2) Collect on image's Folder - Will change the collect parameters to be "Folder" with a value of the selected image's folder location +3) Collect on image's Color Label(s) - Will change the collect parameter to be "Color" with a value of the selected images color labels, will apply multiple parameters with AND logic if multiple exist +4) Collect on All (AND) - Will collect on all parameters activated by the preferences dialog, as such this button is redundant if you only have one of the two other options enabled + +----REQUIRED SOFTWARE---- +NA + +----USAGE---- +Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) + 1) Copy this file in to your "lua/contrib" folder where all other scripts reside. + 2) Require this file in your luarc file, as with any other dt plug-in + +Select the photo you wish to change you collection based on. +In the "Selected Images" module click on "Collect on this Image" + +----KNOWN ISSUES---- +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local gettext = dt.gettext.gettext +local previous = nil +local all_active = false + +du.check_min_api_version("7.0.0", "CollectHelper") + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("collection helper"), + purpose = _("add collection helper buttons"), + author = "Kevin Ertel", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/CollectHelper/" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- FUNCTION -- +local function CheckSingleImage(selection) + if #selection ~= 1 then + dt.print(_("please select a single image")) + return true + end + return false +end + +local function CheckHasColorLabel(selection) + local ret = false + for _,image in pairs(selection) do + if image.red then ret = true end + if image.blue then ret = true end + if image.green then ret = true end + if image.yellow then ret = true end + if image.purple then ret = true end + end + return ret +end +local function PreviousCollection() + if previous ~= nil then + previous = dt.gui.libs.collect.filter(previous) + end +end + +local function CollectOnFolder(all_rules, all_active) + local images = dt.gui.selection() + if CheckSingleImage(images) then + return + end + local rules = {} + local rule = dt.gui.libs.collect.new_rule() + rule.mode = "DT_LIB_COLLECT_MODE_AND" + rule.data = images[1].path + rule.item = "DT_COLLECTION_PROP_FOLDERS" + table.insert(rules, rule) + if all_active then + for _,active_rule in pairs(rules) do + table.insert(all_rules, active_rule) + end + return all_rules + else + previous = dt.gui.libs.collect.filter(rules) + end +end + +local function CollectOnColors(all_rules, all_active) + local images = dt.gui.selection() + if CheckSingleImage(images) then + return + end + if not CheckHasColorLabel(images) then + dt.print(_('select an image with an active color label')) + return + end + for _,image in pairs(images) do + local rules = {} + if image.red then + local red_rule = dt.gui.libs.collect.new_rule() + red_rule.mode = "DT_LIB_COLLECT_MODE_AND" + red_rule.data = "red" + red_rule.item = "DT_COLLECTION_PROP_COLORLABEL" + table.insert(rules, red_rule) + end + if image.blue then + local blue_rule = dt.gui.libs.collect.new_rule() + blue_rule.mode = "DT_LIB_COLLECT_MODE_AND" + blue_rule.data = "blue" + blue_rule.item = "DT_COLLECTION_PROP_COLORLABEL" + table.insert(rules, blue_rule) + end + if image.green then + local green_rule = dt.gui.libs.collect.new_rule() + green_rule.mode = "DT_LIB_COLLECT_MODE_AND" + green_rule.data = "green" + green_rule.item = "DT_COLLECTION_PROP_COLORLABEL" + table.insert(rules, green_rule) + end + if image.yellow then + local yellow_rule = dt.gui.libs.collect.new_rule() + yellow_rule.mode = "DT_LIB_COLLECT_MODE_AND" + yellow_rule.data = "yellow" + yellow_rule.item = "DT_COLLECTION_PROP_COLORLABEL" + table.insert(rules, yellow_rule) + end + if image.purple then + local purple_rule = dt.gui.libs.collect.new_rule() + purple_rule.mode = "DT_LIB_COLLECT_MODE_AND" + purple_rule.data = "purple" + purple_rule.item = "DT_COLLECTION_PROP_COLORLABEL" + table.insert(rules, purple_rule) + end + if all_active then + for _,active_rule in pairs(rules) do + table.insert(all_rules, active_rule) + end + return all_rules + else + previous = dt.gui.libs.collect.filter(rules) + end + end +end + +local function CollectOnAll_AND() + local images = dt.gui.selection() + if CheckSingleImage(images) then + return + end + local rules = {} + if dt.preferences.read('module_CollectHelper','folder','bool') then + rules = CollectOnFolder(rules, true) + end + if dt.preferences.read('module_CollectHelper','colors','bool') then + rules = CollectOnColors(rules, true) + end + previous = dt.gui.libs.collect.filter(rules) +end + +local function destroy() + dt.gui.libs.image.destroy_action("CollectHelper_prev") + if dt.preferences.read('module_CollectHelper','folder','bool') then + dt.gui.libs.image.destroy_action("CollectHelper_folder") + end + if dt.preferences.read('module_CollectHelper','colors','bool') then + dt.gui.libs.image.destroy_action("CollectHelper_labels") + end + if dt.preferences.read('module_CollectHelper','all_and','bool') then + dt.gui.libs.image.destroy_action("CollectHelper_and") + end +end + +-- GUI -- +dt.gui.libs.image.register_action( + "CollectHelper_prev", _("collect: previous"), + function() PreviousCollection() end, + _("sets the collect parameters to be the previously active parameters") +) +if dt.preferences.read('module_CollectHelper','folder','bool') then + dt.gui.libs.image.register_action( + "CollectHelper_folder", _("collect: folder"), + function() CollectOnFolder(_ , false) end, + _("sets the collect parameters to be the selected images's folder") + ) +end +if dt.preferences.read('module_CollectHelper','colors','bool') then + dt.gui.libs.image.register_action( + "CollectHelper_labels", _("collect: color label(s)"), + function() CollectOnColors(_ , false) end, + _("sets the collect parameters to be the selected images's color label(s)") + ) +end +if dt.preferences.read('module_CollectHelper','all_and','bool') then + dt.gui.libs.image.register_action( + "CollectHelper_and", _("collect: all (AND)"), + function() CollectOnAll_AND() end, + _("sets the collect parameters based on all activated CollectHelper options") + ) +end + +-- PREFERENCES -- +dt.preferences.register("module_CollectHelper", "all_and", -- name + "bool", -- type + _('CollectHelper: all'), -- label + _('creates a collect parameter set that utilizes all enabled CollectHelper types (and)'), -- tooltip + true -- default +) +dt.preferences.register("module_CollectHelper", "colors", -- name + "bool", -- type + _('CollectHelper: color label(s)'), -- label + _('enable the button that allows you to swap to a collection based on selected image\'s color label(s)'), -- tooltip + true -- default +) +dt.preferences.register("module_CollectHelper", "folder", -- name + "bool", -- type + _('CollectHelper: folder'), -- label + _('enable the button that allows you to swap to a collection based on selected image\'s folder location'), -- tooltip + true -- default +) + +script_data.destroy = destroy + +return script_data diff --git a/contrib/HDRMerge.lua b/contrib/HDRMerge.lua index ad7dd3a8..9d7a951d 100644 --- a/contrib/HDRMerge.lua +++ b/contrib/HDRMerge.lua @@ -1,424 +1,486 @@ ---[[HDRMerge plugin for darktable - - copyright (c) 2018 Kevin Ertel - - 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 . -]] - ---[[About this Plugin -This plugin adds the module 'HDRMerge' to darktable's lighttable view - -----REQUIRED SOFTWARE---- -HDRMerge ver. 4.5 or greater - -----USAGE---- -Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) - 1) Copy this file in to your 'lua/contrib' folder where all other scripts reside. - 2) Require this file in your luarc file, as with any other dt plug-in -On the initial startup go to darktable settings > lua options and set your executable paths and other preferences, then restart darktable - -Select bracketed images and press the Run HDRMerge button. The resulting DNG will be auto-imported into darktable. -Additional tags or style can be applied on auto import as well, if you desire. - -Base Options: -Select your desired BPS (bits per sample and Embedded Preview Size. - -Batch Options: -Select if you want to run in batch mode or not -Select the gap, in seconds, between images for auto grouping in batch mode - -See HDRMerge manual for further detail: http://jcelaya.github.io/hdrmerge/documentation/2014/07/11/user-manual.html - -Auto-import Options: -Select a style, whether you want tags to be copied from the original, and any additional tags you desire added when the new image is auto-imported -]] - -local dt = require 'darktable' -local df = require 'lib/dtutils.file' -local dsys = require 'lib/dtutils.system' -local mod = 'module_HDRMerge' -local os_path_seperator = '/' -if dt.configuration.running_os == 'windows' then os_path_seperator = '\\' end - --- Tell gettext where to find the .mo file translating messages for a particular domain -local gettext = dt.gettext -gettext.bindtextdomain('HDRMerge',dt.configuration.config_dir..'/lua/locale/') -local function _(msgid) - return gettext.dgettext('HDRMerge', msgid) -end - -local temp -local HDRM = { --HDRMerge Program Table - name = 'HDRMerge', - bin = '', - first_run = true, - install_error = false, - arg_string = '', - images_string = '', - args = { - bps ={text = '-b ', style = 'integer'}, - size ={text = '-p ', style = 'string'}, - batch ={text = '-B ', style = 'bool'}, - gap ={text = '-g ', style = 'integer'} - } -} -local GUI = { --GUI Elements Table - HDR = { - bps ={}, - size ={}, - batch ={}, - gap ={} - }, - Target = { - style ={}, - copy_tags ={}, - add_tags ={} - }, - run = {}, - stack = {}, - options = {}, - exes = { - HDRMerge = {}, - update = {}, - } -} - ---Detect User Styles-- -local styles = dt.styles -local styles_count = 1 -- 'none' = 1 -for _,i in pairs(dt.styles) do - if type(i) == 'userdata' then styles_count = styles_count + 1 end -end - -local function InRange(test, low, high) --tests if test value is within range of low and high (inclusive) - if test >= low and test <= high then - return true - else - return false - end -end - -local function GetFileName(full_path) --Parses a full path (path/filename_identifier.extension) into individual parts ---[[Input: Folder1/Folder2/Folder3/Img_0001.CR2 - - Returns: - path: Folder1/Folder2/Folder3/ - filename: Img_0001 - identifier: 0001 - extension: .CR2 - - EX: - path_1, file_1, id_1, ext_1 = GetFileName(full_path_1) - ]] - local path = string.match(full_path, '.*[\\/]') - local filename = string.gsub(string.match(full_path, '[%w-_]*%.') , '%.' , '' ) - local identifier = string.match(filename, '%d*$') - local extension = string.match(full_path, '%.%w*') - return path, filename, identifier, extension -end - -local function CleanSpaces(text) --removes spaces from the front and back of passed in text - text = string.gsub(text,'^%s*','') - text = string.gsub(text,'%s*$','') - return text -end - -local function BuildExecuteCmd(prog_table) --creates a program command using elements of the passed in program table - local result = CleanSpaces(prog_table.bin)..' '..CleanSpaces(prog_table.arg_string)..' '..CleanSpaces(prog_table.images_string) - return result -end - -local function PreCall(prog_tbl) --looks to see if this is the first call, if so checks to see if program is installed properly - for _,prog in pairs(prog_tbl) do - if prog.first_run then - prog.bin = df.check_if_bin_exists(prog.name) - if not prog.bin then - prog.install_error = true - dt.preferences.write(mod, 'bin_exists', 'bool', false) - else - prog.bin = CleanSpaces(prog.bin) - end - prog.first_run = false - end - end - if not dt.preferences.read(mod, 'bin_exists', 'bool') then - GUI.stack.active = 2 - dt.print(_('please update you binary locatoin')) - end -end - -local function ExeUpdate(prog_tbl) - dt.preferences.write(mod, 'bin_exists', 'bool', true) - for _,prog in pairs(prog_tbl) do - dt.preferences.write('executable_paths', prog.name, 'string', GUI.exes[prog.name].value) - prog.bin = df.check_if_bin_exists(prog.name) - if not prog.bin then - prog.install_error = true - dt.preferences.write(mod, 'bin_exists', 'bool', false) - else - prog.bin = CleanSpaces(prog.bin) - end - prog.first_run = false - end - if dt.preferences.read(mod, 'bin_exists', 'bool') then - GUI.stack.active = 1 - dt.print(_('update successful')) - else - dt.print(_('update unsuccessful, please try again')) - end -end - -local function UpdateActivePreference() --sliders & entry boxes do not have a click/changed callback, so their values must be saved to the active preference - temp = GUI.HDR.gap.value - dt.preferences.write(mod, 'active_gap', 'integer', temp) - temp = GUI.Target.add_tags.text - dt.preferences.write(mod, 'active_add_tags', 'string', temp) -end - -local function main() - PreCall({HDRM}) --check if furst run then check if install OK - if HDRM.install_error then - dt.print_error(_('HDRMerge install issue')) - dt.print(_('HDRMerge install issue, please ensure the binary path is proper')) - return - end - images = dt.gui.selection() --get selected images - if #images < 2 then --ensure enough images selected - dt.print(_('not enough images selected, select at least 2 images to merge')) - return - end - - UpdateActivePreference() --save current gui elements to active preference so those values will be pre-loaded at next startup - - --create image string and output path - HDRM.images_string = '' - local out_path = '' - local smallest_id = math.huge - local smallest_name = '' - local largest_id = 0 - local source_raw = {} - for _,image in pairs(images) do --loop to concat the images string, also track the image indexes for use in creating the final image name (eg; IMG_1034-1037.dng) - local curr_image = image.path..os_path_seperator..image.filename - HDRM.images_string = HDRM.images_string..df.sanitize_filename(curr_image)..' ' - out_path = image.path - _, source_name, source_id = GetFileName(image.filename) - source_id = tonumber(source_id) - if source_id < smallest_id then - smallest_id = source_id - smallest_name = source_name - source_raw = image - end - if source_id > largest_id then largest_id = source_id end - end - out_path = out_path..os_path_seperator..smallest_name..'-'..largest_id..'.dng' - out_path = df.create_unique_filename(out_path) - - --create argument string - HDRM.arg_string = HDRM.args.bps.text..GUI.HDR.bps.value..' '..HDRM.args.size.text..GUI.HDR.size.value..' ' - if GUI.HDR.batch.value then - HDRM.arg_string = HDRM.arg_string..HDRM.args.batch.text..HDRM.args.gap.text..math.floor(GUI.HDR.gap.value)..' -a' - else - HDRM.arg_string = HDRM.arg_string..'-o '..df.sanitize_filename(out_path) - end - - -- create run command and execute - local run_cmd = BuildExecuteCmd(HDRM) - resp = dsys.external_command(run_cmd) - - if resp == 0 and not GUI.HDR.batch.value then - local imported = dt.database.import(out_path) -- import the new file - if GUI.Target.style.selected > 1 then -- apply selected style - local set_style = styles[GUI.Target.style.selected - 1] - dt.styles.apply(set_style , imported) - end - if GUI.Target.copy_tags.value then -- copy tags from the original file (ignore 'darktable' generated tags) - local all_tags = dt.tags.get_tags(source_raw) - for _,tag in pairs(all_tags) do - if string.match(tag.name, 'darktable|') == nil then dt.tags.attach(tag, imported) end - end - end - local set_tag = GUI.Target.add_tags.text - if set_tag ~= nil then -- add additional user-specified tags - for tag in string.gmatch(set_tag, '[^,]+') do - tag = CleanSpaces(tag) - tag = dt.tags.create(tag) - dt.tags.attach(tag, imported) - end - end - dt.print(_('HDRMerge completed successfully')) - else - dt.print_error(_('HDRMerge failed')) - dt.print(_('HDRMerge failed')) - end - -end - --- GUI Elements -- -local lbl_hdr = dt.new_widget('section_label'){ - label = _('HDRMerge options') -} -temp = dt.preferences.read(mod, 'active_bps_ind', 'integer') -if not InRange(temp, 1, 3) then temp = 3 end -GUI.HDR.bps = dt.new_widget('combobox'){ - label = _('bits per sample'), - tooltip =_('number of bits per sample in the output image'), - selected = temp, - '16','24','32', - changed_callback = function(self) - dt.preferences.write(mod, 'active_bps', 'integer', self.value) - dt.preferences.write(mod, 'active_bps_ind', 'integer', self.selected) - end, - reset_callback = function(self) - self.selected = 3 - dt.preferences.write(mod, 'active_bps', 'integer', self.value) - dt.preferences.write(mod, 'active_bps_ind', 'integer', self.selected) - end -} -temp = dt.preferences.read(mod, 'active_size_ind', 'integer') -if not InRange(temp, 1, 3) then temp = 2 end -GUI.HDR.size = dt.new_widget('combobox'){ - label = _('embedded preview size'), - tooltip =_('size of the embedded preview in output image'), - selected = temp, - _('none'),_('half'),_('full'), - changed_callback = function(self) - dt.preferences.write(mod, 'active_size', 'string', self.value) - dt.preferences.write(mod, 'active_size_ind', 'integer', self.selected) - end, - reset_callback = function(self) - self.selected = 2 - dt.preferences.write(mod, 'active_size', 'string', self.value) - dt.preferences.write(mod, 'active_size_ind', 'integer', self.selected) - end -} -GUI.HDR.batch = dt.new_widget('check_button'){ - label = _('batch mode'), - value = dt.preferences.read(mod, 'active_batch', 'bool'), - tooltip = _('enable batch mode operation \nNOTE: resultant files will NOT be auto-imported'), - clicked_callback = function(self) - dt.preferences.write(mod, 'active_batch', 'bool', self.value) - GUI.HDR.gap.sensitive = self.value - end, - reset_callback = function(self) self.value = false end -} -temp = dt.preferences.read(mod, 'active_gap', 'integer') -if not InRange(temp, 1, 3600) then temp = 3 end -GUI.HDR.gap = dt.new_widget('slider'){ - label = _('batch gap [sec.]'), - tooltip = _('gap, in seconds, between batch mode groups'), - soft_min = 1, - soft_max = 30, - hard_min = 1, - hard_max = 3600, - step = 1, - digits = 0, - value = temp, - sensitive = GUI.HDR.batch.value, - reset_callback = function(self) - self.value = 3 - end -} -local lbl_import = dt.new_widget('section_label'){ - label = _('import options') -} -GUI.Target.style = dt.new_widget('combobox'){ - label = _('apply style on import'), - tooltip = _('Apply selected style on auto-import to newly created image'), - selected = 1, - _('none'), - changed_callback = function(self) - dt.preferences.write(mod, 'active_style', 'string', self.value) - dt.preferences.write(mod, 'active_style_ind', 'integer', self.selected) - end, - reset_callback = function(self) - self.selected = 1 - dt.preferences.write(mod, 'active_style', 'string', self.value) - dt.preferences.write(mod, 'active_style_ind', 'integer', self.selected) - end -} -for k=1, (styles_count-1) do - GUI.Target.style[k+1] = styles[k].name -end -temp = dt.preferences.read(mod, 'active_style_ind', 'integer') -if not InRange(temp, 1, styles_count) then temp = 1 end -GUI.Target.style.selected = temp -GUI.Target.copy_tags = dt.new_widget('check_button'){ - label = _('copy tags'), - value = dt.preferences.read(mod, 'active_copy_tags', 'bool'), - tooltip = _('copy tags from first source image'), - clicked_callback = function(self) dt.preferences.write(mod, 'active_copy_tags', 'bool', self.value) end, - reset_callback = function(self) self.value = true end -} -temp = dt.preferences.read(mod, 'active_add_tags', 'string') -if temp == '' then temp = nil end -GUI.Target.add_tags = dt.new_widget('entry'){ - tooltip = _('Additional tags to be added on import. Seperate with commas, all spaces will be removed'), - text = temp, - placeholder = _('Enter tags, seperated by commas'), - editable = true -} -GUI.run = dt.new_widget('button'){ - label = _('merge'), - tooltip =_('run HDRMerge with the above specified settings'), - clicked_callback = function() main() end -} -GUI.exes.HDRMerge = dt.new_widget('file_chooser_button'){ - title = _('Select HDRmerge executable'), - value = df.get_executable_path_preference(HDRM.name), - is_directory = false -} -GUI.exes.update = dt.new_widget('button'){ - label = _('update'), - tooltip =_('update the binary path with current value'), - clicked_callback = function() ExeUpdate({HDRM}) end -} -GUI.options = dt.new_widget('box'){ - orientation = 'vertical', - lbl_hdr, - GUI.HDR.bps, - GUI.HDR.size, - GUI.HDR.batch, - GUI.HDR.gap, - lbl_import, - GUI.Target.style, - GUI.Target.copy_tags, - GUI.Target.add_tags, - GUI.run -} -local exes_box = dt.new_widget('box'){ - orientation = 'vertical', - GUI.exes.HDRMerge, - GUI.exes.update -} -GUI.stack = dt.new_widget('stack'){ - GUI.options, - exes_box -} -if dt.preferences.read(mod, 'bin_exists', 'bool') then - GUI.stack.active = 1 -else - GUI.stack.active = 2 -end - -dt.register_lib( -- register HDRMerge module - 'HDRMerge_Lib', -- Module name - _('HDRMerge'), -- name - true, -- expandable - true, -- resetable - {[dt.gui.views.lighttable] = {'DT_UI_CONTAINER_PANEL_RIGHT_CENTER', 99}}, -- containers - dt.new_widget('box'){ - orientation = 'vertical', - GUI.stack - } -) +--[[HDRMerge plugin for darktable + + copyright (c) 2018 Kevin Ertel + + 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 . +]] + +--[[About this Plugin +This plugin adds the module 'HDRMerge' to darktable's lighttable view + +----REQUIRED SOFTWARE---- +HDRMerge ver. 4.5 or greater + +----USAGE---- +Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) + 1) Copy this file in to your 'lua/contrib' folder where all other scripts reside. + 2) Require this file in your luarc file, as with any other dt plug-in +On the initial startup go to darktable settings > lua options and set your executable paths and other preferences, then restart darktable + +Select bracketed images and press the Run HDRMerge button. The resulting DNG will be auto-imported into darktable. +Additional tags or style can be applied on auto import as well, if you desire. + +Base Options: +Select your desired BPS (bits per sample and Embedded Preview Size. + +Batch Options: +Select if you want to run in batch mode or not +Select the gap, in seconds, between images for auto grouping in batch mode + +See HDRMerge manual for further detail: http://jcelaya.github.io/hdrmerge/documentation/2014/07/11/user-manual.html + +Auto-import Options: +Select a style, whether you want tags to be copied from the original, and any additional tags you desire added when the new image is auto-imported +]] + +local dt = require 'darktable' +local du = require "lib/dtutils" +local df = require 'lib/dtutils.file' +local dsys = require 'lib/dtutils.system' + +du.check_min_api_version("7.0.0", "HDRmerge") + +-- Tell gettext where to find the .mo file translating messages for a particular domain +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("HDR merge"), + purpose = _("merge bracketed images into an HDR DNG image"), + author = "Kevin Ertel", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/HDRmerge" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + +local mod = 'module_HDRMerge' +local os_path_seperator = '/' +if dt.configuration.running_os == 'windows' then os_path_seperator = '\\' end +local CURR_API_STRING = dt.configuration.api_version_string + +local temp +local HDRM = { --HDRMerge Program Table + name = 'HDRMerge', + bin = '', + first_run = true, + install_error = false, + arg_string = '', + images_string = '', + args = { + bps = {text = '-b ', style = 'integer'}, + size = {text = '-p ', style = 'string'}, + batch = {text = '-B ', style = 'bool'}, + gap = {text = '-g ', style = 'integer'} + } +} +local GUI = { --GUI Elements Table + HDR = { + bps ={}, + size ={}, + batch ={}, + gap ={} + }, + Target = { + style ={}, + copy_tags ={}, + add_tags ={} + }, + run = {}, + stack = {}, + options = {}, + exes = { + HDRMerge = {}, + update = {}, + } +} + +HDRM.module_installed = false +HDRM.event_registered = false + + +--Detect User Styles-- +local styles = dt.styles +local styles_count = 1 -- 'none' = 1 +for _,i in pairs(dt.styles) do + if type(i) == 'userdata' then styles_count = styles_count + 1 end +end + +local function InRange(test, low, high) --tests if test value is within range of low and high (inclusive) + if test >= low and test <= high then + return true + else + return false + end +end + +local function GetFileName(full_path) --Parses a full path (path/filename_identifier.extension) into individual parts +--[[Input: Folder1/Folder2/Folder3/Img_0001.CR2 + + Returns: + path: Folder1/Folder2/Folder3/ + filename: Img_0001 + identifier: 0001 + extension: .CR2 + + EX: + path_1, file_1, id_1, ext_1 = GetFileName(full_path_1) + ]] + local path = string.match(full_path, '.*[\\/]') + local filename = string.gsub(string.match(full_path, '[%w-_]*%.') , '%.' , '' ) + local identifier = string.match(filename, '%d*$') + local extension = string.match(full_path, '%.%w*') + return path, filename, identifier, extension +end + +local function CleanSpaces(text) --removes spaces from the front and back of passed in text + text = string.gsub(text,'^%s*','') + text = string.gsub(text,'%s*$','') + return text +end + +local function BuildExecuteCmd(prog_table) --creates a program command using elements of the passed in program table + local result = CleanSpaces(prog_table.bin)..' '..CleanSpaces(prog_table.arg_string)..' '..CleanSpaces(prog_table.images_string) + return result +end + +local function PreCall(prog_tbl) --looks to see if this is the first call, if so checks to see if program is installed properly + for _,prog in pairs(prog_tbl) do + if prog.first_run then + prog.bin = df.check_if_bin_exists(prog.name) + if not prog.bin then + prog.install_error = true + dt.preferences.write(mod, 'bin_exists', 'bool', false) + else + prog.bin = CleanSpaces(prog.bin) + end + prog.first_run = false + end + end + if not dt.preferences.read(mod, 'bin_exists', 'bool') then + GUI.stack.active = 2 + dt.print(_('please update you binary location')) + end +end + +local function ExeUpdate(prog_tbl) + dt.preferences.write(mod, 'bin_exists', 'bool', true) + for _,prog in pairs(prog_tbl) do + dt.preferences.write('executable_paths', prog.name, 'string', GUI.exes[prog.name].value) + prog.bin = df.check_if_bin_exists(prog.name) + if not prog.bin then + prog.install_error = true + dt.preferences.write(mod, 'bin_exists', 'bool', false) + else + prog.bin = CleanSpaces(prog.bin) + end + prog.first_run = false + end + if dt.preferences.read(mod, 'bin_exists', 'bool') then + GUI.stack.active = 1 + dt.print(_('update successful')) + else + dt.print(_('update unsuccessful, please try again')) + end +end + +local function UpdateActivePreference() --sliders & entry boxes do not have a click/changed callback, so their values must be saved to the active preference + temp = GUI.HDR.gap.value + dt.preferences.write(mod, 'active_gap', 'integer', temp) + temp = GUI.Target.add_tags.text + dt.preferences.write(mod, 'active_add_tags', 'string', temp) +end + +local function main() + PreCall({HDRM}) --check if furst run then check if install OK + if HDRM.install_error then + dt.print_error('HDRMerge install issue') + dt.print(_('HDRMerge install issue, please ensure the binary path is correct')) + return + end + images = dt.gui.selection() --get selected images + if #images < 2 then --ensure enough images selected + dt.print(_('not enough images selected, select at least 2 images to merge')) + return + end + + UpdateActivePreference() --save current gui elements to active preference so those values will be pre-loaded at next startup + + --create image string and output path + HDRM.images_string = '' + local out_path = '' + local smallest_id = math.huge + local smallest_name = '' + local largest_id = 0 + local source_raw = {} + for _,image in pairs(images) do --loop to concat the images string, also track the image indexes for use in creating the final image name (eg; IMG_1034-1037.dng) + local curr_image = image.path..os_path_seperator..image.filename + HDRM.images_string = HDRM.images_string..df.sanitize_filename(curr_image)..' ' + out_path = image.path + _unused, source_name, source_id = GetFileName(image.filename) + source_id = tonumber(source_id) or 0 + if source_id < smallest_id then + smallest_id = source_id + smallest_name = source_name + source_raw = image + end + if source_id > largest_id then largest_id = source_id end + end + out_path = out_path..os_path_seperator..smallest_name..'-'..largest_id..'.dng' + out_path = df.create_unique_filename(out_path) + + --create argument string + HDRM.arg_string = HDRM.args.bps.text..GUI.HDR.bps.value..' '..HDRM.args.size.text..GUI.HDR.size.value..' ' + if GUI.HDR.batch.value then + HDRM.arg_string = HDRM.arg_string..HDRM.args.batch.text..HDRM.args.gap.text..math.floor(GUI.HDR.gap.value)..' -a' + else + HDRM.arg_string = HDRM.arg_string..'-o '..df.sanitize_filename(out_path) + end + + -- create run command and execute + local run_cmd = BuildExecuteCmd(HDRM) + resp = dsys.external_command(run_cmd) + + if resp == 0 and not GUI.HDR.batch.value then + local imported = dt.database.import(out_path) -- import the new file + if GUI.Target.style.selected > 1 then -- apply selected style + local set_style = styles[GUI.Target.style.selected - 1] + dt.styles.apply(set_style , imported) + end + if GUI.Target.copy_tags.value then -- copy tags from the original file (ignore 'darktable' generated tags) + local all_tags = dt.tags.get_tags(source_raw) + for _,tag in pairs(all_tags) do + if string.match(tag.name, 'darktable|') == nil then dt.tags.attach(tag, imported) end + end + end + local set_tag = GUI.Target.add_tags.text + if set_tag ~= nil then -- add additional user-specified tags + for tag in string.gmatch(set_tag, '[^,]+') do + tag = CleanSpaces(tag) + tag = dt.tags.create(tag) + dt.tags.attach(tag, imported) + end + end + dt.print(_('HDRMerge completed successfully')) + else + dt.print_error('HDRMerge failed') + dt.print(_('HDRMerge failed')) + end + +end + +local function install_module() + if not HDRM.module_installed then + dt.register_lib( -- register HDRMerge module + 'HDRMerge_Lib', -- Module name + _('HDRMerge'), -- name + true, -- expandable + true, -- resetable + {[dt.gui.views.lighttable] = {'DT_UI_CONTAINER_PANEL_RIGHT_CENTER', 99}}, -- containers + dt.new_widget('box'){ + orientation = 'vertical', + GUI.stack + } + ) + HDRM.module_installed = true + end +end + +local function destroy() + dt.gui.libs["HDRMerge_Lib"].visible = false +end + +local function restart() + dt.gui.libs["HDRMerge_Lib"].visible = true +end + +-- GUI Elements -- +local lbl_hdr = dt.new_widget('section_label'){ + label = _('HDRMerge options') +} +temp = dt.preferences.read(mod, 'active_bps_ind', 'integer') +if not InRange(temp, 1, 3) then temp = 3 end +GUI.HDR.bps = dt.new_widget('combobox'){ + label = _('bits per sample'), + tooltip =_('number of bits per sample in the output image'), + selected = temp, + '16','24','32', + changed_callback = function(self) + dt.preferences.write(mod, 'active_bps', 'integer', self.value) + dt.preferences.write(mod, 'active_bps_ind', 'integer', self.selected) + end, + reset_callback = function(self) + self.selected = 3 + dt.preferences.write(mod, 'active_bps', 'integer', self.value) + dt.preferences.write(mod, 'active_bps_ind', 'integer', self.selected) + end +} +temp = dt.preferences.read(mod, 'active_size_ind', 'integer') +if not InRange(temp, 1, 3) then temp = 2 end +GUI.HDR.size = dt.new_widget('combobox'){ + label = _('embedded preview size'), + tooltip =_('size of the embedded preview in output image'), + selected = temp, + _('none'),_('half'),_('full'), + changed_callback = function(self) + dt.preferences.write(mod, 'active_size', 'string', self.value) + dt.preferences.write(mod, 'active_size_ind', 'integer', self.selected) + end, + reset_callback = function(self) + self.selected = 2 + dt.preferences.write(mod, 'active_size', 'string', self.value) + dt.preferences.write(mod, 'active_size_ind', 'integer', self.selected) + end +} +GUI.HDR.batch = dt.new_widget('check_button'){ + label = _('batch mode'), + value = dt.preferences.read(mod, 'active_batch', 'bool'), + tooltip = _('enable batch mode operation \nNOTE: resultant files will NOT be auto-imported'), + clicked_callback = function(self) + dt.preferences.write(mod, 'active_batch', 'bool', self.value) + GUI.HDR.gap.sensitive = self.value + end, + reset_callback = function(self) self.value = false end +} +temp = dt.preferences.read(mod, 'active_gap', 'integer') +if not InRange(temp, 1, 3600) then temp = 3 end +GUI.HDR.gap = dt.new_widget('slider'){ + label = _('batch gap [sec.]'), + tooltip = _('gap, in seconds, between batch mode groups'), + soft_min = 1, + soft_max = 30, + hard_min = 1, + hard_max = 3600, + step = 1, + digits = 0, + value = temp, + sensitive = GUI.HDR.batch.value, + reset_callback = function(self) + self.value = 3 + end +} +local lbl_import = dt.new_widget('section_label'){ + label = _('import options') +} +GUI.Target.style = dt.new_widget('combobox'){ + label = _('apply style on import'), + tooltip = _('apply selected style on auto-import to newly created image'), + selected = 1, + _('none'), + changed_callback = function(self) + dt.preferences.write(mod, 'active_style', 'string', self.value) + dt.preferences.write(mod, 'active_style_ind', 'integer', self.selected) + end, + reset_callback = function(self) + self.selected = 1 + dt.preferences.write(mod, 'active_style', 'string', self.value) + dt.preferences.write(mod, 'active_style_ind', 'integer', self.selected) + end +} +for k=1, (styles_count-1) do + GUI.Target.style[k+1] = styles[k].name +end +temp = dt.preferences.read(mod, 'active_style_ind', 'integer') +if not InRange(temp, 1, styles_count) then temp = 1 end +GUI.Target.style.selected = temp +GUI.Target.copy_tags = dt.new_widget('check_button'){ + label = _('copy tags'), + value = dt.preferences.read(mod, 'active_copy_tags', 'bool'), + tooltip = _('copy tags from first source image'), + clicked_callback = function(self) dt.preferences.write(mod, 'active_copy_tags', 'bool', self.value) end, + reset_callback = function(self) self.value = true end +} +temp = dt.preferences.read(mod, 'active_add_tags', 'string') +if temp == '' then temp = nil end +GUI.Target.add_tags = dt.new_widget('entry'){ + tooltip = _('additional tags to be added on import, separate with commas, all spaces will be removed'), + text = temp, + placeholder = _('enter tags, separated by commas'), + editable = true +} +GUI.run = dt.new_widget('button'){ + label = _('merge'), + tooltip =_('run HDRMerge with the above settings'), + clicked_callback = function() main() end +} +GUI.exes.HDRMerge = dt.new_widget('file_chooser_button'){ + title = _('select HDRmerge executable'), + value = df.get_executable_path_preference(HDRM.name), + is_directory = false +} +GUI.exes.update = dt.new_widget('button'){ + label = _('update'), + tooltip =_('update the binary path with current value'), + clicked_callback = function() ExeUpdate({HDRM}) end +} +GUI.options = dt.new_widget('box'){ + orientation = 'vertical', + lbl_hdr, + GUI.HDR.bps, + GUI.HDR.size, + GUI.HDR.batch, + GUI.HDR.gap, + lbl_import, + GUI.Target.style, + GUI.Target.copy_tags, + GUI.Target.add_tags, + GUI.run +} +local exes_box = dt.new_widget('box'){ + orientation = 'vertical', + GUI.exes.HDRMerge, + GUI.exes.update +} +GUI.stack = dt.new_widget('stack'){ + GUI.options, + exes_box +} +if dt.preferences.read(mod, 'bin_exists', 'bool') then + GUI.stack.active = 1 +else + GUI.stack.active = 2 +end + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not HDRM.event_registered then + dt.register_event( + "HDRmerge", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + HDRM.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data \ No newline at end of file diff --git a/contrib/LabelsToTags.lua b/contrib/LabelsToTags.lua index 044e9203..32031a3b 100644 --- a/contrib/LabelsToTags.lua +++ b/contrib/LabelsToTags.lua @@ -50,12 +50,38 @@ local darktable = require("darktable") local du = require "lib/dtutils" -du.check_min_api_version("3.0.0", "LabelsToTags") +du.check_min_api_version("7.0.0", "LabelsToTags") + +local gettext = darktable.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("labels to tags"), + purpose = _("allows the mass-application of tags using color labels and ratings as a guide"), + author = "August Schwerdfeger (august@schwerdfeger.name)", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/LabelsToTags" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them -- Lua 5.3 no longer has "unpack" but "table.unpack" unpack = unpack or table.unpack -local LIB_ID = "LabelsToTags" +local ltt = {} +ltt.module_installed = false +ltt.event_registered = false + +local LIB_ID = _("LabelsToTags") -- Helper functions: BEGIN @@ -96,23 +122,23 @@ end local initialAvailableMappings = { - ["Colors"] = { ["+*****"] = { "Red" }, - ["*+****"] = { "Yellow" }, - ["**+***"] = { "Green" }, - ["***+**"] = { "Blue" }, - ["****+*"] = { "Purple" } }, - ["Single colors"] = { ["+----*"] = { "Red", "Only red" }, - ["-+---*"] = { "Yellow", "Only yellow" }, - ["--+--*"] = { "Green", "Only green" }, - ["---+-*"] = { "Blue", "Only blue" }, - ["----+*"] = { "Purple", "Only purple" } }, - ["Ratings"] = { ["*****0"] = { "No stars", "Not rejected" }, - ["*****1"] = { "One star", "Not rejected" }, - ["*****2"] = { "Two stars", "Not rejected" }, - ["*****3"] = { "Three stars", "Not rejected" }, - ["*****4"] = { "Four stars", "Not rejected" }, - ["*****5"] = { "Five stars", "Not rejected" }, - ["*****R"] = { "Rejected" } } + [_("colors")] = { ["+*****"] = { _("red") }, + ["*+****"] = { _("yellow") }, + ["**+***"] = { _("green") }, + ["***+**"] = { _("blue") }, + ["****+*"] = { _("purple") } }, + [_("single colors")] = { ["+----*"] = { _("red"), _("only red") }, + ["-+---*"] = { _("yellow"), _("only yellow") }, + ["--+--*"] = { _("green"), _("only green") }, + ["---+-*"] = { _("blue"), _("only blue") }, + ["----+*"] = { _("purple"), _("only purple") } }, + [_("ratings")] = { ["*****0"] = { _("no stars"), _("not rejected") }, + ["*****1"] = { _("one star"), _("not rejected") }, + ["*****2"] = { _("two stars"), _("not rejected") }, + ["*****3"] = { _("three stars"), _("not rejected") }, + ["*****4"] = { _("four stars"), _("not rejected") }, + ["*****5"] = { _("five stars"), _("not rejected") }, + ["*****R"] = { _("rejected") } } } local availableMappings = {} @@ -127,28 +153,28 @@ end local function getComboboxTooltip() if availableMappings == nil or next(availableMappings) == nil then - return("No registered mappings -- using defaults") + return(_("no registered mappings -- using defaults")) else - return("Select a label-to-tag mapping") + return(_("select a label-to-tag mapping")) end end local mappingComboBox = darktable.new_widget("combobox"){ - label = "mapping", + label = _("mapping"), value = 1, tooltip = getComboboxTooltip(), reset_callback = function(selfC) if selfC == nil then - return + return end i = 1 for _,m in pairs(keySet(getAvailableMappings())) do - selfC[i] = m - i = i+1 + selfC[i] = m + i = i+1 end n = #selfC for j = i,n do - selfC[i] = nil + selfC[i] = nil end selfC.value = 1 selfC.tooltip = getComboboxTooltip() @@ -157,7 +183,7 @@ local mappingComboBox = darktable.new_widget("combobox"){ } local function doTagging(selfC) - local job = darktable.gui.create_job(string.format("labels to tags (%d image" .. (#(darktable.gui.action_images) == 1 and "" or "s") .. ")",#(darktable.gui.action_images)),true) + local job = darktable.gui.create_job(string.format(_("labels to tags (%d image%s)"), #(darktable.gui.action_images), (#(darktable.gui.action_images) == 1 and "" or "s")), true) job.percent = 0.0 local pctIncrement = 1.0 / #(darktable.gui.action_images) @@ -167,29 +193,29 @@ local function doTagging(selfC) local tagsToApply = {} local hash = generateLabelHash(img) for k,v in pairs(availableMappings[mappingComboBox.value]) do - if hashMatch(hash,k) then - for _,tag in ipairs(v) do - tagsToApply[tag] = true - end - end + if hashMatch(hash,k) then + for _,tag in ipairs(v) do + tagsToApply[tag] = true + end + end end for k,_ in pairs(tagsToApply) do - if memoizedTags[k] == nil then - memoizedTags[k] = darktable.tags.create(k) - end - darktable.tags.attach(memoizedTags[k],img) + if memoizedTags[k] == nil then + memoizedTags[k] = darktable.tags.create(k) + end + darktable.tags.attach(memoizedTags[k],img) end job.percent = job.percent + pctIncrement end job.valid = false end -local my_widget = darktable.new_widget("box") { +ltt.my_widget = darktable.new_widget("box") { orientation = "vertical", mappingComboBox, darktable.new_widget("button") { - label = "start", - tooltip = "Tag all selected images", + label = _("start"), + tooltip = _("tag all selected images"), clicked_callback = doTagging } } @@ -203,20 +229,37 @@ darktable.register_tag_mapping = function(name, mapping) end for pattern,tags in pairs(mapping) do if string.match(pattern,PATTERN_PATTERN) == nil then - darktable.print_error("In tag mapping '" .. name .. "': Pattern '" .. pattern .. "' invalid") - return + darktable.print_error("In tag mapping '" .. name .. "': Pattern '" .. pattern .. "' invalid") + return end for _,tag in ipairs(tags) do - if type(tag) ~= "string" then - darktable.print_error("In tag mapping '" .. name .. "': All tag mappings must be lists of strings") - return - end + if type(tag) ~= "string" then + darktable.print_error("In tag mapping '" .. name .. "': All tag mappings must be lists of strings") + return + end end end availableMappings[name] = mapping mappingComboBox.reset_callback(mappingComboBox) end +local function install_module() + if not ltt.module_installed then + darktable.register_lib(LIB_ID,_("labels to tags"),true,true,{ + [darktable.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER",20}, + },ltt.my_widget,nil,nil) + ltt.module_installed = true + end +end + +local function destroy() + darktable.gui.libs[LIB_ID].visible = false +end + +local function restart() + darktable.gui.libs[LIB_ID].visible = true +end + --[[ darktable.register_tag_mapping("Example", { ["+----*"] = { "Red", "Only red" }, @@ -229,6 +272,25 @@ darktable.register_tag_mapping("Example", ["*****R"] = { "Rejected" } }) ]] -darktable.register_lib(LIB_ID,"labels to tags",true,true,{ - [darktable.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER",20}, - },my_widget,nil,nil) +if darktable.gui.current_view().id == "lighttable" then + install_module() +else + if not ltt.event_registered then + darktable.register_event( + LIB_ID, "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + ltt.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/OpenInExplorer.lua b/contrib/OpenInExplorer.lua index 11f004f4..14f788d7 100644 --- a/contrib/OpenInExplorer.lua +++ b/contrib/OpenInExplorer.lua @@ -1,113 +1,261 @@ ---[[ -OpenInExplorer plugin for darktable - - copyright (c) 2018 Kevin Ertel - - 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 . -]] - ---[[About this plugin -This plugin adds the module "OpenInExplorer" to darktable's lighttable view - -----REQUIRED SOFTWARE---- -Microsoft Windows or Linux with installed Nautilus - -----USAGE---- -Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) - 1) Copy this file in to your "lua/contrib" folder where all other scripts reside. - 2) Require this file in your luarc file, as with any other dt plug-in - -Select the photo(s) you wish to find in explorer and press "Go to Folder". -A file explorer window will be opened for each selected file at the file's location; the file will be highlighted. - -----KNOWN ISSUES---- -]] - -local dt = require "darktable" -local du = require "lib/dtutils" -local df = require "lib/dtutils.file" -local dsys = require "lib/dtutils.system" - ---Check API version -du.check_min_api_version("5.0.0", "OpenInExplorer") - -local PS = dt.configuration.running_os == "windows" and "\\" or "/" - ---Detect OS and modify accordingly-- -local proper_install = false -if dt.configuration.running_os ~= "macos" then - proper_install = true -else - dt.print_error('OpenInExplorer plug-in only supports Windows and Linux at this time') - return -end - - --- FUNCTIONS -- - -local function open_in_explorer() --Open in Explorer - local images = dt.gui.selection() - local curr_image = "" - if #images == 0 then - dt.print('please select an image') - elseif #images <= 15 then - for _,image in pairs(images) do - curr_image = image.path..PS..image.filename - local run_cmd = "explorer.exe /select, "..curr_image - dt.print_log("OpenInExplorer run_cmd = "..run_cmd) - resp = dsys.external_command(run_cmd) - end - else - dt.print('please select fewer images (max 15)') - end -end - -local function open_in_nautilus() --Open in Nautilus - local images = dt.gui.selection() - local curr_image = "" - if #images == 0 then - dt.print('please select an image') - elseif #images <= 15 then - for _,image in pairs(images) do - curr_image = image.path..PS..image.filename - local run_cmd = [[busctl --user call org.freedesktop.FileManager1 /org/freedesktop/FileManager1 org.freedesktop.FileManager1 ShowItems ass 1 ]] .. df.sanitize_filename("file://"..curr_image) .. [[ ""]] - dt.print_log("OpenInExplorer run_cmd = "..run_cmd) - resp = dsys.external_command(run_cmd) - end - else - dt.print('please select fewer images (max 15)') - end -end - -local function open_in_filemanager() --Open - --Inits-- - if not proper_install then - return - end - - if (dt.configuration.running_os == "windows") then - open_in_explorer() - elseif (dt.configuration.running_os == "linux") then - open_in_nautilus() - end -end - --- GUI -- -if proper_install then - dt.gui.libs.image.register_action( - "show in file explorer", - function() open_in_filemanager() end, - "Opens File Explorer at the selected image's location" - ) -end +--[[ +OpenInExplorer plugin for darktable + + copyright (c) 2018 Kevin Ertel + Update 2020 and macOS support by Volker Lenhardt + Linux support 2020 by Bill Ferguson + + 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 . +]] + +--[[About this plugin +This plugin adds the module "OpenInExplorer" to darktable's lighttable view. + +----REQUIRED SOFTWARE---- +Apple macOS, Microsoft Windows or Linux + +----USAGE---- +Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) + 1) Copy this file into your "lua/contrib" folder where all other scripts reside. + 2) Require this file in your luarc file, as with any other dt plug-in + +Select the photo(s) you wish to find in your operating system's file manager and press "show in file explorer" in the "selected images" section. + +- Nautilus (Linux), Explorer (Windows), and Finder (macOS prior to Mojave) will open one window for each selected image at the file's location. The file name will be highlighted. + +- On macOS Mojave and Catalina the Finder will open one window for each different directory. In these windows only the last one of the corresponding files will be highlighted (bug or feature?). + +- Dolphin (Linux) will open one window with tabs for the different directories. All the selected images' file names are highlighted in their respective directories. + +As an alternative option you can choose to show the image file names as symbolic links in an arbitrary directory. Go to preferences|Lua options. This option is not available for Windows users as on Windows solely admins are allowed to create links. + +- Pros: You do not clutter up your display with multiple windows. So there is no need to limit the number of selections. + +- Cons: If you want to work with the files you are one step behind the original data. + +----KNOWN ISSUES---- +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local dsys = require "lib/dtutils.system" +local gettext = dt.gettext.gettext + +--Check API version +du.check_min_api_version("7.0.0", "OpenInExplorer") + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("open in explorer"), + purpose = _("open a selected file in the system file manager"), + author = "Kevin Ertel", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/OpenInExplorer" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local act_os = dt.configuration.running_os +local PS = act_os == "windows" and "\\" or "/" + +--Detect OS and quit if it is not supported. +if act_os ~= "macos" and act_os ~= "windows" and act_os ~= "linux" then + dt.print(_("OpenInExplorer plug-in only supports linux, macos, and windows at this time")) + dt.print_error("OpenInExplorer plug-in only supports Linux, macOS, and Windows at this time") + return +end + +local use_links, links_dir = false, "" +if act_os ~= "windows" then + use_links = dt.preferences.read("OpenInExplorer", "use_links", "bool") + links_dir = dt.preferences.read("OpenInExplorer", "linked_image_files_dir", "string") +end + +--Check if the directory exists that was chosen for the file links. Return boolean. +local function check_if_links_dir_exists() + local dir_exists = true + if not links_dir then + --Just for paranoic reasons. I tried, but I couldn't devise a setting for a nil value. + dt.print(_("no links directory selected\nplease check the dt preferences (lua options)")) + dt.print_error("OpenInExplorer: No links directory selected") + dir_exists = false + elseif not df.check_if_file_exists(links_dir) then + dt.print(string.format(_("links directory '%s' not found\nplease check the dt preferences (lua options)"), links_dir)) + dt.print_error(string.format("OpenInExplorer: Links directory '%s' not found", links_dir)) + dir_exists = false + end + return dir_exists +end + +--Format strings for the commands to open the corresponding OS's file manager. +local open_dir = {} +open_dir.windows = "explorer.exe /n, %s" +open_dir.macos = "open %s" +open_dir.linux = [[busctl --user call org.freedesktop.FileManager1 /org/freedesktop/FileManager1 org.freedesktop.FileManager1 ShowFolders ass 1 %s ""]] + +local open_files = {} +open_files.windows = "explorer.exe /select, %s" +open_files.macos = "osascript -e 'tell application \"Finder\" to (reveal {%s}) activate'" +open_files.linux = [[busctl --user call org.freedesktop.FileManager1 /org/freedesktop/FileManager1 org.freedesktop.FileManager1 ShowItems ass %d %s ""]] + +reveal_file_osx_cmd = "\"%s\" as POSIX file" + +--Call the osx Finder with each selected image selected. +--For images in multiple folders, Finder will open a separate window for each +local function call_list_of_files_osx(selected_images) + local cmds = {} + for _, image in pairs(selected_images) do + current_image = image.path..PS..image.filename + -- AppleScript needs double quoted strings, and the whole command is wrapped in single quotes. + table.insert(cmds, string.format(reveal_file_osx_cmd, string.gsub(string.gsub(current_image, "\"", "\\\""), "'", "'\"'\"'"))) + end + reveal_cmd = table.concat(cmds, ",") + run_cmd = string.format(open_files.macos, reveal_cmd) + dt.print_log("OSX run_cmd = "..run_cmd) + dsys.external_command(run_cmd) +end + +--Call the file mangager for each selected image on Linux. +--There is one call to busctl containing a list of all the image file names. +local function call_list_of_files(selected_images) + local current_image, file_uris, run_cmd = "", "", "" + for _, image in pairs(selected_images) do + current_image = image.path..PS..image.filename + file_uris = file_uris .. df.sanitize_filename("file://" .. current_image) .. " " + dt.print_log("file_uris is " .. file_uris) + end + run_cmd = string.format(open_files.linux, #selected_images, file_uris) + dt.print_log("OpenInExplorer run_cmd = "..run_cmd) + dsys.external_command(run_cmd) +end + +--Call the file manager for each selected image on Windows and macOS. +local function call_file_by_file(selected_images) + local current_image, run_cmd = "", "" + for _, image in pairs(selected_images) do + current_image = image.path..PS..image.filename + run_cmd = string.format(open_files[act_os], df.sanitize_filename(current_image)) + dt.print_log("OpenInExplorer run_cmd = "..run_cmd) + dsys.external_command(run_cmd) + end +end + +--Create a link for each selected image, and finally call the file manager. +local function set_links(selected_images) + local current_image, link_target, run_cmd, k = "", "", "", nil + for k, image in pairs(selected_images) do + current_image = image.path..PS..image.filename + link_target = df.create_unique_filename(links_dir .. PS .. image.filename) + run_cmd = string.format("ln -s %s %s", df.sanitize_filename(current_image), df.sanitize_filename(link_target)) + --[[ + In case Windows will allow normal users to create soft links: + if act_os == "windows" then + run_cmd = string.format("mklink %s %s", df.sanitize_filename(link_target), df.sanitize_filename(current_image)) + end + ]] + if dsys.external_command(run_cmd) ~= 0 then + dt.print(_("failed to create links, missing rights?")) + dt.print_error("OpenInExplorer: Failed to create links") + return + end + end + --The URI format is necessary only for the Linux busctl command. + --But it is accepted by the Windows Explorer and macOS's Finder all the same. + run_cmd = string.format(open_dir[act_os], df.sanitize_filename("file://"..links_dir)) + dt.print_log("OpenInExplorer run_cmd = "..run_cmd) + dsys.external_command(run_cmd) +end + +--The working function that starts the particular task. +local function open_in_fmanager() + local images = dt.gui.selection() + if #images == 0 then + dt.print(_("please select an image")) + else + if use_links and not check_if_links_dir_exists() then + return + end + if #images > 15 and not use_links then + dt.print(_("please select fewer images (max. 15)")) + elseif use_links then + set_links(images) + else + if act_os == "linux" then + call_list_of_files(images) + elseif act_os == "macos" then + call_list_of_files_osx(images) + else + call_file_by_file(images) + end + end + end +end + +local function destroy() + dt.gui.libs.image.destroy_action("OpenInExplorer") + dt.destroy_event("OpenInExplorer", "shortcut") + if act_os ~= "windows" then + dt.preferences.destroy("OpenInExplorer", "linked_image_files_dir") + end + dt.preferences.destroy("OpenInExplorer", "use_links") +end + + +-- GUI -- +dt.gui.libs.image.register_action( + "OpenInExplorer", _("show in file explorer"), + function() open_in_fmanager() end, + _("open the file manager at the selected image's location") +) + + +if act_os ~= "windows" then + dt.preferences.register("OpenInExplorer", "linked_image_files_dir", -- name + "directory", -- type + _("OpenInExplorer: linked files directory"), -- label + _("directory to store the links to the file names, requires restart to take effect"), -- tooltip + "Links to image files", -- default + dt.new_widget("file_chooser_button"){ + title = _("select directory"), + is_directory = true, + } + ) + dt.preferences.register("OpenInExplorer", "use_links", -- name + "bool", -- type + _("OpenInExplorer: use links"), -- label + _("use links instead of multiple windows, requires restart to take effect"), -- tooltip + false, -- default + "" + ) +end + +dt.register_event( + "OpenInExplorer", "shortcut", + function(event, shortcut) open_in_fmanager() end, + "OpenInExplorer" +) + +script_data.destroy = destroy + +return script_data diff --git a/contrib/RL_out_sharp.lua b/contrib/RL_out_sharp.lua new file mode 100644 index 00000000..b65581c9 --- /dev/null +++ b/contrib/RL_out_sharp.lua @@ -0,0 +1,272 @@ +--[[ + Richardson-Lucy output sharpening for darktable using GMic + + 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 . +]] + +--[[ + DESCRIPTION + RL_out_sharp.lua - Richardson-Lucy output sharpening using GMic + + This script provides a new target storage "RL output sharpen". + Images exported will be sharpened using GMic (RL deblur algorithm) + + REQUIRED SOFTWARE + GMic command line interface (CLI) https://gmic.eu/download.shtml + + USAGE + * require this script from main lua file + * in lua preferences, select the GMic cli executable + * from "export selected", choose "RL output sharpen" + * configure output folder + * configure RL parameters with sliders + * configure temp files format and quality, jpg 8bpp (good quality) + and tif 16bpp (best quality) are supported + * configure other export options (size, etc.) + * export, images will be first exported in the temp format, then sharpened + * sharpened images will be stored in jpg format in the output folder + + EXAMPLE + set sigma = 0.7, iterations = 10, jpeg output quality = 95, + to correct blur due to image resize for web usage + + CAVEATS + MAC compatibility not tested + Although Darktable can handle file names containing spaces, GMic cli cannot, + so if you want to use this script please make sure that your images do not + have spaces in the file name and path + + BUGS, COMMENTS, SUGGESTIONS + send to Marco Carrarini, marco.carrarini@gmail.com + + CHANGES + * 20200308 - initial version +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local dtsys = require "lib/dtutils.system" + +-- module name +local MODULE_NAME = "RL_out_sharp" + +-- check API version +du.check_min_api_version("7.0.0", MODULE_NAME) + +-- translation +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) + end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("RL output sharpening"), + purpose = _("Richardson-Lucy output sharpening using GMic"), + author = "Marco Carrarini ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/RL_out_sharp" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- OS compatibility +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +-- initialize module preferences +if not dt.preferences.read(MODULE_NAME, "initialized", "bool") then + dt.preferences.write(MODULE_NAME, "sigma", "string", "0.7") + dt.preferences.write(MODULE_NAME, "iterations", "string", "10") + dt.preferences.write(MODULE_NAME, "jpg_quality", "string", "95") + dt.preferences.write(MODULE_NAME, "initialized", "bool", true) +end + +-- preserve original image metadata in the output image ----------------------- +local function preserve_metadata(original, sharpened) + local exiftool = df.check_if_bin_exists("exiftool") + + if exiftool then + dtsys.external_command("exiftool -overwrite_original_in_place -tagsFromFile " .. original .. " " .. sharpened) + else + dt.print_log(MODULE .. " exiftool not found, metadata not preserved") + end +end + + +-- setup export --------------------------------------------------------------- +local function setup_export(storage, img_format, image_table, high_quality, extra_data) + -- set 16bpp if format is tif + if img_format.extension == "tif" then + img_format.bpp = 16 + end + end + + +-- temp export formats: jpg and tif are supported ----------------------------- +local function supported(storage, img_format) + return (img_format.extension == "jpg") or (img_format.extension == "tif") + end + + +-- export and sharpen images -------------------------------------------------- +local function export2RL(storage, image_table, extra_data) + + local temp_name, new_name, run_cmd, result + local input_file, output_file, options + + -- read parameters + local gmic = dt.preferences.read(MODULE_NAME, "gmic_exe", "string") + if gmic == "" then + dt.print(_("GMic executable not configured")) + return + end + gmic = df.sanitize_filename(gmic) + local output_folder = output_folder_selector.value + local sigma_str = string.gsub(string.format("%.2f", sigma_slider.value), ",", ".") + local iterations_str = string.format("%.0f", iterations_slider.value) + local jpg_quality_str = string.format("%.0f", jpg_quality_slider.value) + + -- save preferences + dt.preferences.write(MODULE_NAME, "sigma", "string", sigma_str) + dt.preferences.write(MODULE_NAME, "iterations", "string", iterations_str) + dt.preferences.write(MODULE_NAME, "jpg_quality", "string", jpg_quality_str) + + local gmic_operation = " -deblur_richardsonlucy "..sigma_str..","..iterations_str..",1" + + local i = 0 + for image, temp_name in pairs(image_table) do + + i = i + 1 + dt.print(string.format(_("sharpening image %d ..."), i)) + -- create unique filename + new_name = output_folder..PS..df.get_basename(temp_name)..".jpg" + new_name = df.create_unique_filename(new_name) + + -- build the GMic command string + input_file = df.sanitize_filename(temp_name) + output_file = df.sanitize_filename(new_name) + options = " cut 0,255 round " + if df.get_filetype(temp_name) == "tif" then options = " -/ 256"..options end + + run_cmd = gmic.." "..input_file..gmic_operation..options.."o "..output_file..","..jpg_quality_str + + result = dtsys.external_command(run_cmd) + if result ~= 0 then + dt.print(_("sharpening error")) + return + end + + -- copy metadata from input_file to output_file + preserve_metadata(input_file, output_file) + + -- delete temp image + os.remove(temp_name) + + end + + dt.print(_("finished exporting")) + end + + -- script_manager integration + + local function destroy() + dt.destroy_storage("exp2RL") + end + +-- new widgets ---------------------------------------------------------------- + +output_folder_selector = dt.new_widget("file_chooser_button"){ + title = _("select output folder"), + tooltip = _("select output folder"), + value = dt.preferences.read(MODULE_NAME, "output_folder", "string"), + is_directory = true, + changed_callback = function(self) + dt.preferences.write(MODULE_NAME, "output_folder", "string", self.value) + end + } + +sigma_slider = dt.new_widget("slider"){ + label = _("sigma"), + tooltip = _("controls the width of the blur that's applied"), + soft_min = 0.3, + soft_max = 2.0, + hard_min = 0.0, + hard_max = 3.0, + step = 0.05, + digits = 2, + value = 1.0 + } + +iterations_slider = dt.new_widget("slider"){ + label = _("iterations"), + tooltip = _("increase for better sharpening, but slower"), + soft_min = 0, + soft_max = 100, + hard_min = 0, + hard_max = 100, + step = 5, + digits = 0, + value = 10.0 + } + +jpg_quality_slider = dt.new_widget("slider"){ + label = _("output jpg quality"), + tooltip = _("quality of the output jpg file"), + soft_min = 70, + soft_max = 100, + hard_min = 70, + hard_max = 100, + step = 2, + digits = 0, + value = 95.0 + } + +local storage_widget = dt.new_widget("box"){ + orientation = "vertical", + output_folder_selector, + sigma_slider, + iterations_slider, + jpg_quality_slider + } + +-- register new storage ------------------------------------------------------- +dt.register_storage("exp2RL", _("RL output sharpen"), nil, export2RL, supported, save_preferences, storage_widget) + +-- register the new preferences ----------------------------------------------- +dt.preferences.register(MODULE_NAME, "gmic_exe", "file", +_("executable for GMic CLI"), +_("select executable for GMic command line version") , "") + +-- set sliders to the last used value at startup ------------------------------ +sigma_slider.value = dt.preferences.read(MODULE_NAME, "sigma", "float") +iterations_slider.value = dt.preferences.read(MODULE_NAME, "iterations", "float") +jpg_quality_slider.value = dt.preferences.read(MODULE_NAME, "jpg_quality", "float") + +-- script_manager integration + +script_data.destroy = destroy + +return script_data + +-- end of script -------------------------------------------------------------- + +-- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua +-- kate: hl Lua; diff --git a/contrib/auto_snapshot.lua b/contrib/auto_snapshot.lua new file mode 100644 index 00000000..48f99f5b --- /dev/null +++ b/contrib/auto_snapshot.lua @@ -0,0 +1,132 @@ +--[[ + + auto_snapshot.lua - automatically take a snapshot when an image is loaded in darkroom + + Copyright (C) 2024 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + auto_snapshot - + + automatically take a snapshot when an image is loaded in darkroom + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + None + + USAGE + * start the script from script_manager + * open an image in darkroom + + BUGS, COMMENTS, SUGGESTIONS + Bill Ferguson + + CHANGES +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local log = require "lib/dtutils.log" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE = "auto_snapshot" +local DEFAULT_LOG_LEVEL = log.error + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A P I C H E C K +-- - - - - - - - - - - - - - - - - - - - - - - - + +du.check_min_api_version("7.0.0", MODULE) -- choose the minimum version that contains the features you need + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- I 1 8 N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local script_data = {} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +script_data.metadata = { + name = _("auto snapshot"), -- name of script + purpose = _("automatically take a snapshot when an image is loaded in darkroom"), -- purpose of script + author = "Bill Ferguson ", -- your name and optionally e-mail address + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/auto_snapshot/" -- URL to help/documentation +} + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- L O G L E V E L +-- - - - - - - - - - - - - - - - - - - - - - - - + +log.log_level(DEFAULT_LOG_LEVEL) + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- N A M E S P A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +local auto_snapshot = {} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- P R E F E R E N C E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.preferences.register(MODULE, "always_create_snapshot", "bool", "auto_snapshot - " .. _("always automatically create_snapshot"), + _("create a snapshot even if the image is altered"), false) + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + dt.destroy_event(MODULE, "darkroom-image-loaded") +end + +script_data.destroy = destroy + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- E V E N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.register_event(MODULE, "darkroom-image-loaded", + function(event, clean, image) + local always = dt.preferences.read(MODULE, "always_create_snapshot", "bool") + if clean and always then + dt.gui.libs.snapshots.take_snapshot() + elseif clean and not image.is_altered then + dt.gui.libs.snapshots.take_snapshot() + end + + end +) + + +return script_data \ No newline at end of file diff --git a/contrib/autostyle.lua b/contrib/autostyle.lua index 0b3891ff..32add29b 100644 --- a/contrib/autostyle.lua +++ b/contrib/autostyle.lua @@ -39,101 +39,36 @@ GPLv2 local darktable = require "darktable" local du = require "lib/dtutils" local filelib = require "lib/dtutils.file" +local syslib = require "lib/dtutils.system" --- Forward declare the functions -local autostyle_apply_one_image,autostyle_apply_one_image_event,autostyle_apply,exiftool_attribute,capture +du.check_min_api_version("7.0.0", "autostyle") --- Tested it with darktable 1.6.1 and darktable git from 2014-01-25 -du.check_min_api_version("2.0.2", "autostyle") +local gettext = darktable.gettext.gettext --- Receive the event triggered -function autostyle_apply_one_image_event(event,image) - autostyle_apply_one_image(image) +local function _(msgid) + return gettext(msgid) end --- Apply the style to an image, if it matches the tag condition -function autostyle_apply_one_image (image) - -- We need the tag, the value and the style_name provided from the configuration string - local tag,value,style_name=string.match(darktable.preferences.read("autostyle","exif_tag","string"),"(%g+)%s*=%s*(%g+)%s*=>%s*(%g+)") - - -- check they all exist (correct syntax) - if (not tag) then - darktable.print("EXIF TAG not found in " .. darktable.preferences.read("autostyle","exif_tag","string")) - return 0 - end - if (not value) then - darktable.print("value to match not found in " .. darktable.preferences.read("autostyle","exif_tag","string")) - return 0 - end - if (not style_name) then - darktable.print("style name not found in " .. darktable.preferences.read("autostyle","exif_tag","string")) - return 0 - end - if not filelib.check_if_bin_exists("exiftool") then - darktable.print("Can't find exiftool") - return 0 - end - - - -- First find the style (we have its name) - local styles= darktable.styles - local style - for _,s in ipairs(styles) do - if s.name == style_name then - style=s - end - end - if (not style) then - darktable.print("style not found for autostyle: " .. style_name) - return 0 - end +-- return data structure for script_manager - -- Apply the style to image, if it is tagged - local ok,auto_dr_attr= pcall(exiftool_attribute,image.path .. '/' .. image.filename,tag) - --darktable.print_error("dr_attr:" .. auto_dr_attr) - -- If the lookup fails, stop here - if (not ok) then - darktable.print("Couldn't get attribute " .. auto_dr_attr .. " from exiftool's output") - return 0 - end - if auto_dr_attr==value then - darktable.print_log("Image " .. image.filename .. ": autostyle automatically applied " .. darktable.preferences.read("autostyle","exif_tag","string") ) - darktable.styles.apply(style,image) - return 1 - else - darktable.print_log("Image " .. image.filename .. ": autostyle not applied, exif tag " .. darktable.preferences.read("autostyle","exif_tag","string") .. " not matched: " .. auto_dr_attr) - return 0 - end -end +local script_data = {} +local have_not_printed_config_message = true -function autostyle_apply( shortcut) - local images = darktable.gui.action_images - local images_processed =0 - local images_submitted =0 - for _,image in pairs(images) do - images_submitted = images_submitted +1 - images_processed = images_processed + autostyle_apply_one_image(image) - end - darktable.print("Applied auto style to " .. images_processed .. " out of " .. images_submitted .. " image(s)") -end +script_data.metadata = { + name = _("auto style"), + purpose = _("automatically apply a style based on image EXIF tag"), + author = "Marc Cousin ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/autostyle/" +} --- Retrieve the attribute through exiftool -function exiftool_attribute(path,attr) - local cmd="exiftool -" .. attr .. " '" .. path .. "'"; - local exifresult=get_stdout(cmd) - local attribute=string.match(exifresult,": (.*)") - if (attribute == nil) then - darktable.print_error( "Could not find the attribute " .. attr .. " using the command: <" .. cmd .. ">") - -- Raise an error to the caller - error( "Could not find the attribute " .. attr .. " using the command: <" .. cmd .. ">"); - end --- darktable.print_error("Returning attribute: " .. attribute) - return attribute -end +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them -- run command and retrieve stdout -function get_stdout(cmd) +local function get_stdout(cmd) -- Open the command, for reading local fd = assert(io.popen(cmd, 'r')) darktable.control.read(fd) @@ -150,12 +85,116 @@ function get_stdout(cmd) return data end +-- Retrieve the attribute through exiftool +local function exiftool_attribute(path, attr) + local cmd = "exiftool -" .. attr .. " '" .. path .. "'"; + local exifresult = get_stdout(cmd) + local attribute = string.match(exifresult, ": (.*)") + if (attribute == nil) then + darktable.print_error( "Could not find the attribute " .. attr .. " using the command: <" .. cmd .. ">") + -- Raise an error to the caller + error( "Could not find the attribute " .. attr .. " using the command: <" .. cmd .. ">"); + end + -- darktable.print_error("Returning attribute: " .. attribute) + return attribute +end + +-- Apply the style to an image, if it matches the tag condition +local function autostyle_apply_one_image (image) + + local pref = darktable.preferences.read("autostyle", "exif_tag", "string") + + if pref and string.len(pref) >= 6 then + -- We need the tag, the value and the style_name provided from the configuration string + local tag, value, style_name = string.match(pref, "(%g+)%s*=%s*([%g ]-)%s*=>%s*(%g+)") + + -- check they all exist (correct syntax) + if (not tag) then + darktable.print(string.format(_("EXIF tag not found in %s"), pref)) + return 0 + end + if (not value) then + darktable.print(string.format(_("value to match not found in %s"), pref)) + return 0 + end + if (not style_name) then + darktable.print(string.format(_("style name not found in %s"), pref)) + return 0 + end + if not filelib.check_if_bin_exists("exiftool") then + darktable.print(_("can't find exiftool")) + return 0 + end + + + -- First find the style (we have its name) + local styles = darktable.styles + local style + for _, s in ipairs(styles) do + if s.name == style_name then + style = s + end + end + if (not style) then + darktable.print(string.format(_("style not found for autostyle: %s"), style_name)) + return 0 + end + + -- Apply the style to image, if it is tagged + local ok, auto_dr_attr = pcall(exiftool_attribute, image.path .. '/' .. image.filename,tag) + --darktable.print_error("dr_attr:" .. auto_dr_attr) + -- If the lookup fails, stop here + if (not ok) then + darktable.print(string.format(_("couldn't get attribute %s from exiftool's output"), auto_dr_attr)) + return 0 + end + if auto_dr_attr == value then + darktable.print_log("Image " .. image.filename .. ": autostyle automatically applied " .. pref) + darktable.styles.apply(style,image) + return 1 + else + darktable.print_log("Image " .. image.filename .. ": autostyle not applied, exif tag " .. pref .. " not matched: " .. auto_dr_attr) + return 0 + end + elseif have_not_printed_config_message then + have_not_printed_config_message = false + darktable.print(string.format(_("%s is not configured, please configure the preference in Lua options"), script_data.metadata.name)) + end +end + + +-- Receive the event triggered +local function autostyle_apply_one_image_event(event,image) + autostyle_apply_one_image(image) +end + +local function autostyle_apply(shortcut) + local images = darktable.gui.action_images + local images_processed = 0 + local images_submitted = 0 + for _,image in pairs(images) do + images_submitted = images_submitted + 1 + images_processed = images_processed + autostyle_apply_one_image(image) + end + darktable.print(string.format(_("applied auto style to %d out of %d image(s)"), images_processed, images_submitted)) +end + +local function destroy() + darktable.destroy_event("autostyle", "shortcut") + darktable.destroy_event("autostyle", "post-import-image") +end + -- Registering events -darktable.register_event("shortcut",autostyle_apply, - "Apply your chosen style from exiftool tags") +darktable.register_event("autostyle", "shortcut", autostyle_apply, + _("apply your chosen style from exiftool tags")) -darktable.preferences.register("autostyle","exif_tag","string","Autostyle: EXIF_tag=value=>style","apply a style automatically if an EXIF_tag matches value. Find the tag with exiftool","") +darktable.preferences.register("autostyle", "exif_tag", "string", + string.format("%s: EXIF_tag=value=>style", script_data.metadata.name), + _("apply a style automatically if an EXIF tag matches value, find the tag with exiftool"), "") -darktable.register_event("post-import-image",autostyle_apply_one_image_event) +darktable.register_event("autostyle", "post-import-image", + autostyle_apply_one_image_event) +script_data.destroy = destroy +return script_data diff --git a/contrib/change_group_leader.lua b/contrib/change_group_leader.lua new file mode 100644 index 00000000..0e6f66e6 --- /dev/null +++ b/contrib/change_group_leader.lua @@ -0,0 +1,205 @@ +--[[ + change group leader + + copyright (c) 2020, 2022 Bill Ferguson + copyright (c) 2021 Angel Angelov + + 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 . +]] + +--[[ +CHANGE GROUP LEADER +automatically change the leader of raw+jpg paired image groups + +INSTALLATION +* copy this file in $CONFIGDIR/lua/ where CONFIGDIR is your darktable configuration directory +* add the following line in the file $CONFIGDIR/luarc + require "change_group_leader" + +USAGE +* in lighttable mode, select the image groups you wish to process, + select whether you want to set the leader to "jpg" or "raw", + and click "Execute" +]] + +local dt = require "darktable" +local du = require "lib/dtutils" + +local gettext = dt.gettext.gettext + +local MODULE = "change_group_leader" + +du.check_min_api_version("3.0.0", MODULE) + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("change group leader"), + purpose = _("automatically change the leader of raw+jpg paired image groups"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/change_group_leader" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- create a namespace to contain persistent data and widgets +local chg_grp_ldr = {} + +local cgl = chg_grp_ldr + +cgl.widgets = {} + +cgl.event_registered = false +cgl.module_installed = false + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function install_module() + if not cgl.module_installed then + dt.register_lib( + MODULE, -- Module name + _("change group leader"), -- Visible name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 700}}, -- containers + cgl.widgets.box, + nil,-- view_enter + nil -- view_leave + ) + cgl.module_installed = true + end +end + +local function find_group_leader(images, mode) + for _, img in ipairs(images) do + dt.print_log("checking image " .. img.id .. " named " .. img.filename) + local found = false + if mode == "jpg" then + if string.match(string.lower(img.filename), "jpg$") then + dt.print_log("jpg matched image " .. img.filename) + found = true + end + elseif mode == "raw" then + if img.is_raw and img.duplicate_index == 0 then + dt.print_log("found raw " .. img.filename) + found = true + end + elseif mode == "non-raw" then + if img.is_ldr then + dt.print_log("found ldr " .. img.filename) + found = true + end + else + dt.print_error(MODULE .. ": unrecognized mode " .. mode) + return + end + if found then + dt.print_log("making " .. img.filename .. " group leader") + img:make_group_leader() + return + end + end +end + +local function process_image_groups(images) + if #images < 1 then + dt.print(_("no images selected")) + dt.print_log(MODULE .. "no images seletected, returning...") + else + local mode = cgl.widgets.mode.value + for _,img in ipairs(images) do + dt.print_log("checking image " .. img.id) + local group_images = img:get_group_members() + if group_images == 1 then + dt.print_log("only one image in group for image " .. image.id) + else + find_group_leader(group_images, mode) + end + end + end +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + dt.gui.libs[MODULE].visible = false +end + +local function restart() + dt.gui.libs[MODULE].visible = true +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- W I D G E T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +cgl.widgets.mode = dt.new_widget("combobox"){ + label = _("select new group leader"), + tooltip = _("select type of image to be group leader"), + selected = 1, + "jpg", "raw", "non-raw", +} + +cgl.widgets.execute = dt.new_widget("button"){ + label = _("execute"), + clicked_callback = function() + process_image_groups(dt.gui.action_images) + end +} + +cgl.widgets.box = dt.new_widget("box"){ + orientation = "vertical", + cgl.widgets.mode, + cgl.widgets.execute, +} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not cgl.event_registered then + dt.register_event( + "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + cgl.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/clear_GPS.lua b/contrib/clear_GPS.lua index 31724952..2663ab4b 100644 --- a/contrib/clear_GPS.lua +++ b/contrib/clear_GPS.lua @@ -1,6 +1,6 @@ --[[ - clear_GPS.lua - export and edit with GIMP + clear_GPS.lua - plugin for Darktable Copyright (C) 2016 Bill Ferguson . @@ -38,20 +38,33 @@ local dt = require "darktable" local du = require "lib/dtutils" -local gettext = dt.gettext --- not a number -local NaN = 0/0 +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "clear_GPS") +local function _(msgid) + return gettext(msgid) +end +-- return data structure for script_manager --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("clear_GPS",dt.configuration.config_dir.."/lua/locale/") +local script_data = {} -local function _(msgid) - return gettext.dgettext("clear_GPS", msgid) -end +script_data.metadata = { + name = _("clear GPS info"), + purpose = _("remove GPS data from selected image(s)"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/clear_gps/" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- not a number +local NaN = 0/0 + +du.check_min_api_version("7.0.0", "clear_GPS") local function clear_GPS(images) for _, image in ipairs(images) do @@ -62,15 +75,23 @@ local function clear_GPS(images) end end +local function destroy() + dt.destroy_event("clear_GPS", "shortcut") + dt.gui.libs.image.destroy_action("clear_GPS") +end + +script_data.destroy = destroy dt.gui.libs.image.register_action( - _("clear GPS data"), + "clear_GPS", _("clear GPS data"), function(event, images) clear_GPS(images) end, - "clear GPS data" + _("clear GPS data from selected images") ) dt.register_event( - "shortcut", + "clear_GPS", "shortcut", function(event, shortcut) clear_GPS(dt.gui.action_images) end, - "clear GPS data" + _("clear GPS data from selected images") ) + +return script_data diff --git a/contrib/color_profile_manager.lua b/contrib/color_profile_manager.lua new file mode 100644 index 00000000..683ae990 --- /dev/null +++ b/contrib/color_profile_manager.lua @@ -0,0 +1,377 @@ +--[[ + + color_profile_manager.lua - manage external darktable color profiles + + Copyright (C) 2021 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + color_profile_manager - manage external darktable color profiles + + This script provides a tool to manage input and output external color + profiles used by darktable. Color profiles can be added or removed + to/from the correct directories so that darktable can find and use + them. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + * None + + USAGE + * require this script from your main lua file + * select the input or output set of color profiles + * a list of profiles is displayed. Click the check box beside the + profile name to select it for removal. Click the "remove profile" + button to remove the profile. + * use the file selector to select a color profile to add to the currently + selected set (input or output) + * click the "add profile" button to add the profile to the selected set + + BUGS, COMMENTS, SUGGESTIONS + * Send to Bill Ferguson, wpferguson@gmail.com or raise an issue on + https://github.com/dakrtable-org/lua-scripts +]] +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local dtsys = require "lib/dtutils.system" + +du.check_min_api_version("7.0.0", "color_profile_manager") + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- L O C A L I Z A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE_NAME = "color_profile_manager" +local PS = dt.configuration.running_os == "windows" and "\\" or "/" +local CS = dt.configuration.running_os == "windows" and "&" or ";" +local DIR_CMD = dt.configuration.running_os == "windows" and "dir /b" or "ls" +local COLOR_IN_DIR = dt.configuration.config_dir .. PS .. "color" .. PS .. "in" +local COLOR_OUT_DIR = dt.configuration.config_dir .. PS .. "color" .. PS .. "out" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- N A M E S P A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +local cpm = {} +cpm.widgets = {} +cpm.widgets.profile_box = dt.new_widget("box"){ + orientation = "vertical", +} +cpm.module_installed = false +cpm.event_registered = false +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function check_for_directories() + if not df.test_file(COLOR_IN_DIR, "d") then + dt.print_log("didn't find " .. COLOR_IN_DIR) + return false + elseif not df.test_file(COLOR_OUT_DIR, "d") then + dt.print_log("didn't find " .. COLOR_OUT_DIR) + return false + else + dt.print_log("both directories exist") + return true + end +end + +local function add_directories() + df.mkdir(COLOR_IN_DIR) + df.mkdir(COLOR_OUT_DIR) +end + +local function list_profiles(dir) + local files = {} + local p = io.popen(DIR_CMD .. " " .. dir) + if p then + for line in p:lines() do + table.insert(files, line) + end + end + p:close() + return files +end + +local function add_profile(file, dir) + df.file_copy(file, dir) + dt.print(string.format(_("added color profile %s to %s"), file, dir)) + dt.print_log("color profile " .. file .. " added to " .. dir) +end + +local function remove_profile(file, dir) + os.remove(dir .. PS .. file) + dt.print(string.format(_("removed color profile %s from %s"), file, dir)) + dt.print_log("color profile " .. file .. " removed from " .. dir) +end + +local function clear_profile_box() + for i = #cpm.widgets.profile_box, 1, -1 do + cpm.widgets.profile_box[i] = nil + end +end + +local function add_profile_callback() + local profile_dir = COLOR_IN_DIR + if cpm.widgets.profile_set.selected == 2 then + profile_dir = COLOR_OUT_DIR + end + + local new_profile = cpm.widgets.profile_selector.value + if string.lower(df.get_filetype(new_profile)) ~= "icm" and string.lower(df.get_filetype(new_profile)) ~= "icc" then + dt.print(_("ERROR: color profile must be an icc or icm file")) + dt.print_error(new_profile .. " selected and isn't an icc or icm file") + return + end + + -- set selector value to directory that new profile came from + -- in case there are more + cpm.widgets.profile_selector.value = df.get_path(cpm.widgets.profile_selector.value) + add_profile(new_profile, profile_dir) + local files = list_profiles(profile_dir) + local widgets = {} + + local profile_ptr = 1 + for i, file in ipairs(files) do + if #cpm.widgets.profile_box == 0 or cpm.widgets.profile_box[profile_ptr].label ~= file then + table.insert(widgets, dt.new_widget("check_button"){value = false, label = file}) + else + table.insert(widgets, cpm.widgets.profile_box[profile_ptr]) + profile_ptr = profile_ptr + 1 + if profile_ptr > #cpm.widgets.profile_box then + profile_ptr = #cpm.widgets.profile_box + end + end + end + clear_profile_box() + for _, widget in ipairs(widgets) do + table.insert(cpm.widgets.profile_box, widget) + end + if not cpm.widgets.remove_box.visible then + cpm.widgets.remove_box.visible = true + end +end + +local function remove_profile_callback() + local widgets_to_keep = {} + local profile_dir = COLOR_IN_DIR + if cpm.widgets.profile_set.selected == 2 then + profile_dir = COLOR_OUT_DIR + end + + for _, widget in ipairs(cpm.widgets.profile_box) do + if widget.value == true then + remove_profile(widget.label, profile_dir) + else + table.insert(widgets_to_keep, widget) + end + end + clear_profile_box() + for _, widget in ipairs(widgets_to_keep) do + table.insert(cpm.widgets.profile_box, widget) + end + if #cpm.widgets.profile_box == 0 then + cpm.widgets.remove_box.visible = false + else + cpm.widgets.remove_box.visible = true + end +end + +local function list_profile_callback(choice) + local list_dir = COLOR_IN_DIR + if choice == 2 then + list_dir = COLOR_OUT_DIR + end + + local files = list_profiles(list_dir) + + if #files == 0 then + cpm.widgets.remove_box.visible = false + else + cpm.widgets.remove_box.visible = true + end + + clear_profile_box() + + for i, file in ipairs(files) do + cpm.widgets.profile_box[i] = dt.new_widget("check_button"){value = false, label = file} + end +end + +local function install_module() + if not cpm.module_installed then + dt.register_lib( + MODULE_NAME, -- Module name + _("color profile manager"), -- Visible name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER", 0}}, -- containers + cpm.widgets.main_widget, + nil,-- view_enter + nil -- view_leave + ) + cpm.module_installed = true + dt.control.sleep(500) + if not cpm.initialized then + cpm.widgets.profile_set.visible = false + cpm.widgets.add_box.visible = false + cpm.widgets.remove_box.visible = false + else + cpm.widgets.profile_set.selected = 1 + end + end +end + +local function destroy() + dt.gui.libs[MODULE_NAME].visible = false + return +end + +local function restart() + dt.gui.libs[MODULE_NAME].visible = true + return +end +-- - - - - - - - - - - - - - - - - - - - - - - - +-- W I D G E T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +cpm.initialized = check_for_directories() +dt.print_log("cpm.initialized is " .. tostring(cpm.initialized)) + +if not cpm.initialized then + dt.print_log("creating init_box") + cpm.widgets.init_box = dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("button"){ + label = _("initialize color profiles"), + tooltip = _("create the directory structure to contain the color profiles"), + clicked_callback = function(this) + add_directories() + cpm.initialized = true + cpm.widgets.profile_set.visible = true + cpm.widgets.add_box.visible = true + cpm.widgets.remove_box.visible = false + cpm.widgets.init_box.visible = false + cpm.widgets.profile_set.selected = 1 + end + } + } +end + +cpm.widgets.profile_set = dt.new_widget("combobox"){ + label = _("select profile set"), + tooltip = _("select input or output profiles"), + visible = cpm.initialized and false or true, + changed_callback = function(this) + if cpm.initialized then + list_profile_callback(this.selected) + end + end, + _("input"), _("output"), +} + +cpm.widgets.profile_selector = dt.new_widget("file_chooser_button"){ + title = _("select color profile to add"), + tooltip = _("select the .icc or .icm file to add"), + is_directory = false +} + +cpm.widgets.add_box = dt.new_widget("box"){ + orientation = "vertical", + visible = cpm.initialized and true or false, + dt.new_widget("section_label"){label = _("add profile")}, + cpm.widgets.profile_selector, + dt.new_widget("button"){ + label = _("add selected color profile"), + tooltip = _("add selected file to profiles"), + clicked_callback = function(this) + add_profile_callback() + end + } +} + +cpm.widgets.remove_box = dt.new_widget("box"){ + orientation = "vertical", + visible = cpm.initialized and true or false, + dt.new_widget("section_label"){label = _("remove profile")}, + cpm.widgets.profile_box, + dt.new_widget("button"){ + label = _("remove selected profile(s)"), + tooltip = _("remove the checked profile(s)"), + clicked_callback = function(this) + remove_profile_callback() + end + } +} + +local main_widgets = {} + +if not cpm.initialized then + table.insert(main_widgets, cpm.widgets.init_box) +end +table.insert(main_widgets, cpm.widgets.profile_set) +table.insert(main_widgets, cpm.widgets.remove_box) +table.insert(main_widgets, cpm.widgets.add_box) + +cpm.widgets.main_widget = dt.new_widget("box"){ + orientation = "vertical", + table.unpack(main_widgets) +} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- M A I N +-- - - - - - - - - - - - - - - - - - - - - - - - + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not cpm.event_registered then + dt.register_event( + MODULE_NAME, "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + cpm.event_registered = true + end +end + +local script_data = {} + +script_data.metadata = { + name = _("color profile manager"), + purpose = _("manage external darktable color profiles"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/color_profile_manager" +} + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data \ No newline at end of file diff --git a/contrib/copy_attach_detach_tags.lua b/contrib/copy_attach_detach_tags.lua index 2fb83301..3f1f6d34 100644 --- a/contrib/copy_attach_detach_tags.lua +++ b/contrib/copy_attach_detach_tags.lua @@ -40,17 +40,35 @@ local dt = require "darktable" local du = require "lib/dtutils" local debug = require "darktable.debug" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "copy_attach_detach_tags") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("copy_attach_detach_tags",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "copy_attach_detach_tags") local function _(msgid) - return gettext.dgettext("copy_attach_detach_tags", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("copy attach detach tags"), + purpose = _("shortcuts to copy, paste, replace, or remove tags from images"), + author = "Christian Kanzian", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local cadt = {} +cadt.module_installed = false +cadt.event_registered = false +cadt.widget_table = {} + local image_tags = {} @@ -85,7 +103,7 @@ local function mcopy_tags() end end - dt.print(_('Image tags copied ...')) + dt.print(_('image tags copied ...')) --create UI tag list local taglist = "" @@ -107,7 +125,7 @@ local function mcopy_tags() local function attach_tags() if next(image_tags) == nil then - dt.print(_('No tags to attached, please copy tags first.')) + dt.print(_('no tag to attach, please copy tags first.')) return true end @@ -131,7 +149,7 @@ local function attach_tags() end end end - dt.print(_('Tags attached ...')) + dt.print(_('tags attached ...')) end local function detach_tags() @@ -147,13 +165,68 @@ local function detach_tags() end end end - dt.print(_('Tags removed from image(s).')) + dt.print(_('tags removed from image(s).')) end local function replace_tags() detach_tags() attach_tags() - dt.print(_('Tags replaced')) + dt.print(_('tags replaced')) +end + +local function install_module() + if not cadt.module_installed then + dt.register_lib("tagging_addon",_('tagging addon'),true,true,{ + [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER",500} + }, + dt.new_widget("box") { + -- orientation = "vertical", + reset_callback = function() + taglist_label.label = "" + image_tags = {} + end, + table.unpack(cadt.widget_table), + }, + nil, + nil + ) + cadt.module_installed = true + end +end + +local function destroy() + dt.destroy_event("cadt_ct", "shortcut") + dt.destroy_event("cadt_at", "shortcut") + dt.destroy_event("cadt_dt", "shortcut") + dt.destroy_event("cadt_rt", "shortcut") + dt.gui.libs["tagging_addon"].visible = false +end + +local function restart() + -- shortcut for copy + dt.register_event("cadt_ct", "shortcut", + mcopy_tags, + _('copy tags from selected image(s)')) + + -- shortcut for attach + dt.register_event("cadt_at", "shortcut", + attach_tags, + _('paste tags to selected image(s)')) + + -- shortcut for detaching tags + dt.register_event("cadt_dt", "shortcut", + detach_tags, + _('remove tags from selected image(s)')) + + -- shortcut for replace tags + dt.register_event("cadt_rt", "shortcut", + replace_tags, + _('replace tags from selected image(s)')) + dt.gui.libs["tagging_addon"].visible = true +end + +local function show() + dt.gui.libs["tagging_addon"].visible = true end -- create modul Tagging addons @@ -169,73 +242,82 @@ local taglabel = dt.new_widget("label") { local box1 = dt.new_widget("box"){ orientation = "horizontal", dt.new_widget("button") { - label = _('multi copy tags'), - clicked_callback = mcopy_tags}, + label = _('multi copy tags'), + tooltip = _('copy tags from selected image(s)'), + clicked_callback = mcopy_tags}, dt.new_widget("button") { - label = _('paste tags'), - clicked_callback = attach_tags} - + tooltip = _('paste tags to selected image(s)'), + label = _('paste tags'), + clicked_callback = attach_tags} } local box2 = dt.new_widget("box"){ orientation = "horizontal", dt.new_widget("button") { - label = _('replace tags'), - clicked_callback = replace_tags}, + label = _('replace tags'), + tooltip = _('replace tags from selected image(s)'), + clicked_callback = replace_tags}, dt.new_widget("button") { - label = _('remove all tags'), - clicked_callback = detach_tags} + label = _('remove all tags'), + tooltip = _('remove tags from selected image(s)'), + clicked_callback = detach_tags} } local sep = dt.new_widget("separator"){} -- pack elements into widget table for a nicer layout -local widget_table = {} -widget_table[1] = box1 -widget_table[#widget_table+1] = box2 +cadt.widget_table[1] = box1 +cadt.widget_table[#cadt.widget_table+1] = box2 -widget_table[#widget_table+1] = sep -widget_table[#widget_table+1] = taglabel -widget_table[#widget_table+1] = taglist_label +cadt.widget_table[#cadt.widget_table+1] = sep +cadt.widget_table[#cadt.widget_table+1] = taglabel +cadt.widget_table[#cadt.widget_table+1] = taglist_label -- create modul -dt.register_lib("tagging_addon","Tagging addon",true,true,{ - [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER",500} - }, - dt.new_widget("box") { - -- orientation = "vertical", - reset_callback = function() - taglist_label.label = "" - image_tags = {} - end, - table.unpack(widget_table), - }, - nil, - nil - ) +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not cadt.event_registered then + dt.register_event( + "cadt", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + cadt.event_registered = true + end +end -- shortcut for copy -dt.register_event("shortcut", +dt.register_event("cadt_ct", "shortcut", mcopy_tags, _('copy tags from selected image(s)')) -- shortcut for attach -dt.register_event("shortcut", +dt.register_event("cadt_at", "shortcut", attach_tags, _('paste tags to selected image(s)')) -- shortcut for detaching tags -dt.register_event("shortcut", +dt.register_event("cadt_dt", "shortcut", detach_tags, _('remove tags from selected image(s)')) -- shortcut for replace tags -dt.register_event("shortcut", +dt.register_event("cadt_rt", "shortcut", replace_tags, _('replace tags from selected image(s)')) +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = show + +return script_data -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; diff --git a/contrib/cr2hdr.lua b/contrib/cr2hdr.lua index 7f7a5bca..36f325f2 100644 --- a/contrib/cr2hdr.lua +++ b/contrib/cr2hdr.lua @@ -35,8 +35,29 @@ USAGE local darktable = require "darktable" local du = require "lib/dtutils" --- Tested with darktable 2.0.1 -du.check_min_api_version("2.0.0", "cr2hdr") +du.check_min_api_version("7.0.0", "cr2hdr") + +local gettext = darktable.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("cr2hdr"), + purpose = _("process Magic Lantern dual ISO images"), + author = "Till Theato ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/cr2hdr" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them local queue = {} local processed_files = {} @@ -79,7 +100,7 @@ end local function convert_images() if next(queue) == nil then return end - job = darktable.gui.create_job("Dual ISO conversion", true, stop_conversion) + job = darktable.gui.create_job(_("dual ISO conversion"), true, stop_conversion) for key,image in pairs(queue) do if job.valid then job.percent = (key-1)/#queue @@ -90,7 +111,7 @@ local function convert_images() end local success_count = 0 for _ in pairs(processed_files) do success_count = success_count + 1 end - darktable.print("Dual ISO conversion successful on " .. success_count .. "/" .. #queue .. " images.") + darktable.print(string.format(_("dual ISO conversion successful on %d/%d images."), success_count, #queue)) job.valid = false processed_files = {} queue = {} @@ -107,8 +128,21 @@ local function convert_action_images(shortcut) convert_images() end -darktable.register_event("shortcut", convert_action_images, "Run cr2hdr (Magic Lantern DualISO converter) on selected images") -darktable.register_event("post-import-image", file_imported) -darktable.register_event("post-import-film", film_imported) +local function destroy() + darktable.destroy_event("cr2hdr", "shortcut") + darktable.destroy_event("cr2hdr", "post-import-image") + darktable.destroy_event("cr2hdr", "post-import-film") +end + +darktable.register_event("cr2hdr", "shortcut", + convert_action_images, _("run cr2hdr (Magic Lantern DualISO converter) on selected images")) +darktable.register_event("cr2hdr", "post-import-image", + file_imported) +darktable.register_event("cr2hdr", "post-import-film", + film_imported) + +darktable.preferences.register("cr2hdr", "onimport", "bool", _("invoke on import"), _("if true then cr2hdr will try to proccess every file during importing\nwarning: cr2hdr is quite slow even in figuring out on whether the file is dual ISO or not."), false) + +script_data.destroy = destroy -darktable.preferences.register("cr2hdr", "onimport", "bool", "Invoke on import", "If true then cr2hdr will try to proccess every file during importing. Warning: cr2hdr is quite slow even in figuring out on whether the file is Dual ISO or not.", false) +return script_data diff --git a/contrib/cycle_group_leader.lua b/contrib/cycle_group_leader.lua new file mode 100644 index 00000000..e168e93b --- /dev/null +++ b/contrib/cycle_group_leader.lua @@ -0,0 +1,162 @@ +--[[ + + cycle_group_leader.lua - change image group leader + + Copyright (C) 2024 Bill Ferguson + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + cycle_group_leader - change image grouip leader + + cycle_group_leader changes the group leader to the next + image in the group. If the end of the group is reached + then the next image is wrapped around to the first image. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + None + + USAGE + * enable with script_manager + * assign a key to the shortcut + + BUGS, COMMENTS, SUGGESTIONS + Bill Ferguson + + CHANGES +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE = "cycle_group_leader" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A P I C H E C K +-- - - - - - - - - - - - - - - - - - - - - - - - + +du.check_min_api_version("7.0.0", MODULE) + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- I 1 8 N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local script_data = {} + +script_data.metadata = { + name = _("cycle group leader"), + purpose = _("change image group leader"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/cycle_group_leader" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function toggle_global_toolbox_grouping() + dt.gui.libs.global_toolbox.grouping = false + dt.gui.libs.global_toolbox.grouping = true +end + +local function hinter_msg(msg) + dt.print_hinter(msg) + dt.control.sleep(1500) + dt.print_hinter(" ") +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- M A I N P R O G R A M +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function cycle_group_leader(image) + local group_images = image:get_group_members() + if #group_images < 2 then + hinter_msg(_("no images to cycle through in group")) + return + else + local position = nil + for i, img in ipairs(group_images) do + if image == img then + position = i + end + end + + if position == #group_images then + position = 1 + else + position = position + 1 + end + + new_leader = group_images[position] + new_leader:make_group_leader() + dt.gui.selection({new_leader}) + + if dt.gui.libs.global_toolbox.grouping then + -- toggle the grouping to make the new leader show + toggle_global_toolbox_grouping() + end + end +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + -- put things to destroy (events, storages, etc) here + dt.destroy_event(MODULE, "shortcut") +end + +script_data.destroy = destroy + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- E V E N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.register_event(MODULE, "shortcut", + function(event, shortcut) + -- ignore the film roll, it contains all the images, not just the imported + local images = dt.gui.selection() + if #images < 1 then + dt.print(_("no image selected, please select an image and try again")) + else + cycle_group_leader(images[1]) + end + end, + _("cycle group leader") +) + +return script_data diff --git a/contrib/dbmaint.lua b/contrib/dbmaint.lua new file mode 100644 index 00000000..c08309a2 --- /dev/null +++ b/contrib/dbmaint.lua @@ -0,0 +1,334 @@ +--[[ + + dbmaint.lua - perform database maintenance + + Copyright (C) 2024 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + dbmaint - perform database maintenance + + Perform database maintenance to clean up missing images and filmstrips. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + None + + USAGE + * start dbmaint from script_manager + * scan for missing film rolls or missing images + * look at the results and choose to delete or not + + BUGS, COMMENTS, SUGGESTIONS + Bill Ferguson + + CHANGES +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local log = require "lib/dtutils.log" + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE = "dbmaint" +local DEFAULT_LOG_LEVEL = log.error +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A P I C H E C K +-- - - - - - - - - - - - - - - - - - - - - - - - + +du.check_min_api_version("7.0.0", MODULE) -- choose the minimum version that contains the features you need + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- I 1 8 N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local script_data = {} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +script_data.metadata = { + name = _("db maintenance"), + purpose = _("perform database maintenance"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/dbmaint/" +} + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- L O G L E V E L +-- - - - - - - - - - - - - - - - - - - - - - - - + +log.log_level(DEFAULT_LOG_LEVEL) + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- N A M E S P A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +local dbmaint = {} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- G L O B A L V A R I A B L E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dbmaint.main_widget = nil + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A L I A S E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local namespace = dbmaint + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +------------------- +-- helper functions +------------------- + +local function set_log_level(level) + local old_log_level = log.log_level() + log.log_level(level) + return old_log_level +end + +local function restore_log_level(level) + log.log_level(level) +end + +local function scan_film_rolls() + local missing_films = {} + + for _, filmroll in ipairs(dt.films) do + if not df.check_if_file_exists(filmroll.path) then + table.insert(missing_films, filmroll) + end + end + + return missing_films +end + +local function scan_images(film) + local old_log_level = set_log_level(DEFAULT_LOG_LEVEL) + local missing_images = {} + + if film then + for i = 1, #film do + local image = film[i] + log.msg(log.debug, "checking " .. image.filename) + if not df.check_if_file_exists(image.path .. PS .. image.filename) then + log.msg(log.info, image.filename .. " not found") + table.insert(missing_images, image) + end + end + end + + restore_log_level(old_log_level) + return missing_images +end + +local function remove_missing_film_rolls(list) + for _, filmroll in ipairs(list) do + filmroll:delete(true) + end +end + +-- force the lighttable to reload + +local function refresh_lighttable(film) + local rules = dt.gui.libs.collect.filter() + dt.gui.libs.collect.filter(rules) +end + +local function remove_missing_images(list) + local film = list[1].film + for _, image in ipairs(list) do + image:delete() + end + refresh_lighttable(film) +end + +local function install_module() + if not namespace.module_installed then + dt.register_lib( + MODULE, -- Module name + _("DB maintenance"), -- Visible name + true, -- expandable + true, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER", 0}}, -- containers + namespace.main_widget, + nil,-- view_enter + nil -- view_leave + ) + namespace.module_installed = true + end +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- U S E R I N T E R F A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +dbmaint.list_widget = dt.new_widget("text_view"){ + editable = false, + reset_callback = function(this) + this.text = "" + end +} + +dbmaint.chooser = dt.new_widget("combobox"){ + label = _("scan for"), + selected = 1, + _("film rolls"), _("images"), + reset_callback = function(this) + this.selected = 1 + end +} + +dbmaint.scan_button = dt.new_widget("button"){ + label = _("scan"), + tooltip = _("click to scan for missing film rolls/files"), + clicked_callback = function(this) + local found = nil + local found_text = "" + local old_log_level = set_log_level(DEFAULT_LOG_LEVEL) + log.msg(log.debug, "Button clicked") + if dbmaint.chooser.selected == 1 then -- film rolls + found = scan_film_rolls() + if #found > 0 then + for _, film in ipairs(found) do + local dir_name = du.split(film.path, PS) + found_text = found_text .. dir_name[#dir_name] .. "\n" + end + end + else + log.msg(log.debug, "checking path " .. dt.collection[1].path .. " for missing files") + found = scan_images(dt.collection[1].film) + if #found > 0 then + for _, image in ipairs(found) do + found_text = found_text .. image.filename .. "\n" + end + end + end + if #found > 0 then + log.msg(log.debug, "found " .. #found .. " missing items") + dbmaint.list_widget.text = found_text + dbmaint.found = found + dbmaint.remove_button.sensitive = true + else + log.msg(log.debug, "no missing items found") + end + restore_log_level(old_log_level) + end, + reset_callback = function(this) + dbmaint.found = nil + end +} + +dbmaint.remove_button = dt.new_widget("button"){ + label = _("remove"), + tooltip = _("remove missing film rolls/images"), + sensitive = false, + clicked_callback = function(this) + if dbmaint.chooser.selected == 1 then -- film rolls + remove_missing_film_rolls(dbmaint.found) + else + remove_missing_images(dbmaint.found) + end + dbmaint.found = nil + dbmaint.list_widget.text = "" + this.sensitive = false + end, + reset_callback = function(this) + this.sensitive = false + end +} + +dbmaint.main_widget = dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("section_label"){label = _("missing items")}, + dbmaint.list_widget, + dt.new_widget("label"){label = ""}, + dbmaint.chooser, + dt.new_widget("label"){label = ""}, + dbmaint.scan_button, + dbmaint.remove_button +} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + dt.gui.libs[MODULE].visible = false + + if namespace.event_registered then + dt.destroy_event(MODULE, "view-changed") + end + + return +end + +local function restart() + dt.gui.libs[MODULE].visible = true + + return +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- E V E N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not namespace.event_registered then + dt.register_event(MODULE, "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + namespace.event_registered = true + end +end + +return script_data \ No newline at end of file diff --git a/contrib/enfuseAdvanced.lua b/contrib/enfuseAdvanced.lua index 9fb49c0a..5027c564 100644 --- a/contrib/enfuseAdvanced.lua +++ b/contrib/enfuseAdvanced.lua @@ -26,10 +26,11 @@ enfuse ver. 4.2 or greater exiftool ----USAGE---- -Install: (see here for more detail: https://github.com/darktable-org/lua-scripts ) - 1) Copy this file in to your 'lua/contrib' folder where all other scripts reside. - 2) Require this file in your luarc file, as with any other dt plug-in -On the initial startup go to darktable settings > lua options and set your executable paths and other preferences, then restart darktable +Install: + 1) Get the Lua scripts: https://github.com/darktable-org/lua-scripts#download-and-install + 2) Require this file in your luarc file, as with any other dt plug-in: require "contrib/enfuseAdvanced" + 3) Then select "DRI or DFF image" as storage option + 4) On the initial startup set your executable paths DRI = Dynamic Range Increase (Blend multiple bracket images into a single LDR file) DFF = Depth From Focus ('Focus Stacking' - Blend multiple images with different focus into a single image) @@ -64,15 +65,31 @@ local mod = 'module_enfuseAdvanced' local os_path_seperator = '/' if dt.configuration.running_os == 'windows' then os_path_seperator = '\\' end -du.check_min_api_version('5.0.0', 'enfuseAdvanced') +du.check_min_api_version("7.0.0", "enfuseAdvanced") -- Tell gettext where to find the .mo file translating messages for a particular domain -local gettext = dt.gettext -gettext.bindtextdomain('enfuseAdvanced',dt.configuration.config_dir..'/lua/locale/') +local gettext = dt.gettext.gettext + local function _(msgid) - return gettext.dgettext('enfuseAdvanced', msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("enfuse advanced"), + purpose = _("focus stack or exposure blend images"), + author = "Kevin Ertel", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/enfuseAdvanced" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + -- INITS -- local AIS = { name = 'align_image_stack', @@ -179,6 +196,11 @@ for _,i in pairs(dt.styles) do end -- FUNCTION -- + +local function sanitize_decimals(cmd) -- make sure decimal separator is a '.' + return string.gsub(cmd, '(%d),(%d)', "%1.%2") +end + local function InRange(test, low, high) -- tests if test value is within range of low and high (inclusive) if test >= low and test <= high then return true @@ -239,13 +261,13 @@ end local function ExeUpdate(prog_tbl) --updates executable paths and verifies them dt.preferences.write(mod, 'bin_exists', 'bool', true) - for _,prog in pairs(prog_tbl) do + for x,prog in pairs(prog_tbl) do dt.preferences.write('executable_paths', prog.name, 'string', GUI.exes[prog.name].value) prog.bin = df.check_if_bin_exists(prog.name) if not prog.bin then prog.install_error = true dt.preferences.write(mod, 'bin_exists', 'bool', false) - dt.print(_('issue with ')..prog.name.._(' executable')) + dt.print(string.format(_("issue with %s executable"), prog.name)) else prog.bin = CleanSpaces(prog.bin) end @@ -310,7 +332,7 @@ local function UpdateENFargs(image_table, prefix) --updates the Enfuse arguments local largest_id = 0 local first_raw = {} for raw, temp_image in pairs(image_table) do - _, source_name, source_id = GetFileName(raw.filename) + local _, source_name, source_id = GetFileName(raw.filename) source_id = tonumber(source_id) if source_id < smallest_id then smallest_id = source_id @@ -362,7 +384,7 @@ local function SaveToPreference(preset) --save the present values of enfuse GUI dt.preferences.write(mod, preset..argument, arg_data.style, temp) end end - dt.print(_('saved to ')..preset) + dt.print(string.format(_("saved to %s"), preset)) end local function LoadFromPreference(preset) --load values from the specified 'preset' into the GUI elements @@ -378,7 +400,7 @@ local function LoadFromPreference(preset) --load values from the specified 'pres dt.preferences.write(mod, 'active_'..argument, arg_data.style, temp) end end - dt.print(_('loaded from ')..preset) + dt.print(string.format(_("loaded from %s"), preset)) end local function remove_temp_files(images_to_remove) --deletes all files specified by the input string @@ -413,7 +435,7 @@ local function support_format(storage, format) --tells dt we only support TIFF e end local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) --outputs message to user showing script export status - dt.print(_('export for image fusion ')..tostring(math.floor(number))..' / '..tostring(math.floor(total))) + dt.print(string.format(_("export for image fusion %d / %d"), math.floor(number), math.floor(total))) end local function main(storage, image_table, extra_data) @@ -421,7 +443,7 @@ local function main(storage, image_table, extra_data) dt.print(_('too few images selected, please select at least 2 images')) return elseif extra_data[1] == 2 then - dt.print(_('installation error, please verify binary paths are proper')) + dt.print(_('installation error, please verify binary paths are correct')) return end local images_to_remove = '' @@ -434,12 +456,15 @@ local function main(storage, image_table, extra_data) local job = dt.gui.create_job('aligning images') image_table, images_to_remove, AIS.images_string = UpdateAISargs(image_table, images_to_remove) local run_cmd = BuildExecuteCmd(AIS) + dt.print_log("AIS run command is " .. run_cmd) + run_cmd = sanitize_decimals(run_cmd) + dt.print_log("AIS decimaal sanitized command is " .. run_cmd) local resp = dsys.external_command(run_cmd) job.valid = false if resp ~= 0 then remove_temp_files(images_to_remove) - dt.print_error(AIS.name.._(' failed')) - dt.print(AIS.name.._(' failed')) + dt.print(string.format(_("%s failed"), AIS.name)) + dt.print_error(AIS.name .. ' failed') return end end @@ -454,26 +479,34 @@ local function main(storage, image_table, extra_data) local image_num = 0 local job = dt.gui.create_job('blending '..#variants..' image(s)', true) --create a GUI job bar to display enfuse progress UpdateActivePreference() --load current GUI values into active preference (only applies to elements without a clicked/changed callback) - for _,prefix in pairs(variants) do --for each image to be created load in the preference values, build arguments string, output image, and run command then execute. + for x,prefix in pairs(variants) do --for each image to be created load in the preference values, build arguments string, output image, and run command then execute. job.percent = image_num /(#variants) image_num = image_num+1 ENF.images_string, final_image, source_raw = UpdateENFargs(image_table, prefix) local run_cmd = BuildExecuteCmd(ENF) + dt.print_log("ENF run command is " .. run_cmd) + run_cmd = sanitize_decimals(run_cmd) + dt.print_log("ENF decimaal sanitized command is " .. run_cmd) local resp = dsys.external_command(run_cmd) if resp ~= 0 then remove_temp_files(images_to_remove) - dt.print_error(ENF.name.._(' failed')) - dt.print(ENF.name.._(' failed')) + dt.print_error(ENF.name..' failed') + dt.print(string.format(_("%s failed"), ENF.name)) return end --copy exif data from original file run_cmd = EXF.bin..' -TagsFromFile '..df.sanitize_filename(source_raw.path..os_path_seperator..source_raw.filename)..' -exif:all --subifd:all -overwrite_original '..df.sanitize_filename(final_image) + -- replace comma decimal separator with period + dt.print_log("EXF run command is " .. run_cmd) + run_cmd = sanitize_decimals(run_cmd) + dt.print_log("EXF decimaal sanitized command is " .. run_cmd) resp = dsys.external_command(run_cmd) if GUI.Target.auto_import.value then --import image into dt if specified local imported = dt.database.import(final_image) + dt.print_log("image imported") if GUI.Target.apply_style.selected > 1 then --apply specified style to imported image local set_style = styles[GUI.Target.apply_style.selected - 1] dt.styles.apply(set_style , imported) @@ -499,6 +532,10 @@ local function main(storage, image_table, extra_data) dt.print('image fusion process complete') end +local function destroy() + dt.destroy_storage('module_enfuseAdvanced') +end + --GUI-- stack_compression = dt.new_widget('stack'){} local label_AIS_options= dt.new_widget('section_label'){ @@ -699,7 +736,7 @@ GUI.ENF.hard_masks = dt.new_widget('check_button'){ GUI.ENF.save_masks = dt.new_widget('check_button'){ label = _('save masks'), value = dt.preferences.read(mod, 'active_save_masks', 'bool'), - tooltip = _('Save the generated weight masks to your home directory,\nenblend saves masks as 8 bit grayscale, \ni.e. single channel images. \nfor accuracy we recommend to choose a lossless format.'), + tooltip = _('save the generated weight masks to your home directory,\nenblend saves masks as 8 bit grayscale, \ni.e. single channel images. \nfor accuracy we recommend to choose a lossless format.'), clicked_callback = function(self) dt.preferences.write(mod, 'active_save_masks', 'bool', self.value) end, reset_callback = function(self) self.value = false end } @@ -852,7 +889,7 @@ GUI.Target.output_directory = dt.new_widget('file_chooser_button'){ GUI.Target.source_location = dt.new_widget('check_button'){ label = _('save to source image location'), value = dt.preferences.read(mod, 'active_source_location', 'bool'), - tooltip = _('If checked ignores the location above and saves output image(s) to the same location as the source images.'), + tooltip = _('if checked ignores the location above and saves output image(s) to the same location as the source images.'), clicked_callback = function(self) dt.preferences.write(mod, 'active_source_location', 'bool', self.value) end, reset_callback = function(self) self.value = true end } @@ -886,8 +923,8 @@ GUI.Target.auto_import = dt.new_widget('check_button'){ } temp = dt.preferences.read(mod, 'active_apply_style_ind', 'integer') GUI.Target.apply_style = dt.new_widget('combobox'){ - label = _('Apply Style on Import'), - tooltip = _('Apply selected style on auto-import to newly created blended image'), + label = _('apply style on Import'), + tooltip = _('apply selected style on auto-import to newly created blended image'), selected = 1, 'none', changed_callback = function(self) @@ -908,16 +945,16 @@ GUI.Target.apply_style.selected = temp GUI.Target.copy_tags = dt.new_widget('check_button'){ label = _('copy tags'), value = dt.preferences.read(mod, 'active_copy_tags', 'bool'), - tooltip = _('Copy tags from first image.'), + tooltip = _('copy tags from first image.'), clicked_callback = function(self) dt.preferences.write(mod, 'active_copy_tags', 'bool', self.value) end, reset_callback = function(self) self.value = true end } temp = dt.preferences.read(mod, 'active_add_tags', 'string') if temp == '' then temp = nil end GUI.Target.add_tags = dt.new_widget('entry'){ - tooltip = _('Additional tags to be added on import. Seperate with commas, all spaces will be removed'), + tooltip = _('additional tags to be added on import, seperate with commas, all spaces will be removed'), text = temp, - placeholder = 'Enter tags, seperated by commas', + placeholder = _('enter tags, separated by commas'), editable = true } temp = dt.preferences.read(mod, 'active_current_preset_ind', 'integer') @@ -938,7 +975,7 @@ GUI.Presets.current_preset = dt.new_widget('combobox'){ end } GUI.Presets.load = dt.new_widget('button'){ - label = _('laod fusion preset'), + label = _('load fusion preset'), tooltip = _('load current fusion parameters from selected preset'), clicked_callback = function() LoadFromPreference(GUI.Presets.current_preset.value) end } @@ -984,7 +1021,7 @@ GUI.Presets.variants_type = dt.new_widget('combobox'){ GUI.Presets.variants_type.sensitive = GUI.Presets.variants.value temp = df.get_executable_path_preference(AIS.name) GUI.exes.align_image_stack = dt.new_widget('file_chooser_button'){ - title = 'AIS binary path', + title = 'align_image_stack ' .. _('binary path'), value = temp, tooltip = temp, is_directory = false, @@ -992,7 +1029,7 @@ GUI.exes.align_image_stack = dt.new_widget('file_chooser_button'){ } temp = df.get_executable_path_preference(ENF.name) GUI.exes.enfuse = dt.new_widget('file_chooser_button'){ - title = 'enfuse binary path', + title = 'enfuse ' .. _('binary path'), value = temp, tooltip = temp, is_directory = false, @@ -1000,7 +1037,7 @@ GUI.exes.enfuse = dt.new_widget('file_chooser_button'){ } temp = df.get_executable_path_preference(EXF.name) GUI.exes.exiftool = dt.new_widget('file_chooser_button'){ - title = 'Exiftool binary path', + title = 'exiftool ' .. _('binary path'), value = temp, tooltip = temp, is_directory = false, @@ -1125,3 +1162,7 @@ else GUI.options_contain.active = 4 GUI.show_options.sensitive = false end + +script_data.destroy = destroy + +return script_data \ No newline at end of file diff --git a/contrib/exportLUT.lua b/contrib/exportLUT.lua new file mode 100644 index 00000000..9ec29544 --- /dev/null +++ b/contrib/exportLUT.lua @@ -0,0 +1,204 @@ +--[[ + This file is part of darktable, + copyright (c) 2020 Noah Clarke + + 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 . +]] +--[[ +Add the following line to .config/darktable/luarc to enable this lightable module: + require "contrib/exportLut" + +Given a haldCLUT identity file this script generates haldCLUTS from all the user's +styles and exports them to a location of their choosing. + +Warning: during export if a naming collision occurs the older file is automatically +overwritten silently. +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require("lib/dtutils.file") +local ds = require("lib/dtutils.system") + +du.check_min_api_version("7.0.0", "exportLUT") + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("export LUT"), + purpose = _("export a style as a LUT"), + author = "Noah Clarke", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/exportLUT" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +du.check_min_api_version("5.0.0", "exportLUT") + +local eL = {} +eL.module_installed = false +eL.event_registered = false +eL.widgets = {} + +-- Thanks Kevin Ertel for this bit +local os_path_seperator = '/' +if dt.configuration.running_os == 'windows' then os_path_seperator = '\\' end +local mkdir_command = 'mkdir -p ' +if dt.configuration.running_os == 'windows' then mkdir_command = 'mkdir ' end + +local file_chooser_button = dt.new_widget("file_chooser_button"){ + title = _("choose the identity file"), + value = "", + is_directory = false +} + +local export_chooser_button = dt.new_widget("file_chooser_button"){ + title = _("choose the export location"), + value = "", + is_directory = true +} + +local identity_label = dt.new_widget("label"){ + label = _("choose the identity haldclut file") +} + +local output_label = dt.new_widget("label"){ + label = _("choose the output location") +} + +local warning_label = dt.new_widget("label"){ + label = _("WARNING: files may be silently overwritten") +} + +local function end_job(job) + job.valid = false +end + +local function output_path(style_name, job) + local output_location = export_chooser_button.value .. os_path_seperator .. style_name .. ".png" + output_location = string.gsub(output_location, "|", os_path_seperator) + local output_dir = string.reverse(output_location) + output_dir = string.gsub(output_dir, ".-" .. os_path_seperator, os_path_seperator, 1) + output_dir = string.reverse(output_dir) + if(output_dir ~= "") then + df.mkdir(df.sanitize_filename(output_dir)) + end + return output_location +end + +local function export_luts() + local identity = dt.database.import(file_chooser_button.value) + if(type(identity) ~= "userdata") then + dt.print(_("invalid identity lut file")) + else + local job = dt.gui.create_job(_('exporting styles as haldCLUTs'), true, end_job) + + local size = 1 + + for style_num, style in ipairs(dt.styles) do + size = size + 1 + end + + local count = 0 + for style_num, style in ipairs(dt.styles) do + + identity:reset() + dt.styles.apply(style, identity) + local io_lut = dt.new_format("png") + io_lut.bpp = 8 + + io_lut:write_image(identity, output_path(style.name, job)) + count = count + 1 + job.percent = count / size + dt.print(string.format(_("exported: %s"), output_path(style.name, job))) + end + dt.print(_("done exporting haldCLUTs")) + job.valid = false + identity:reset() + end +end + +local function install_module() + if not eL.module_installed then + dt.register_lib( + "export haldclut", + _("export haldclut"), + true, + false, + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, + dt.new_widget("box") + { + orientation = "vertical", + table.unpack(eL.widgets), + }, + nil, + nil + ) + eL.module_installed = true + end +end + +local function destroy() + dt.gui.libs["export haldclut"].visible = false +end + +local function restart() + dt.gui.libs["export haldclut"].visible = true +end + +local export_button = dt.new_widget("button"){ + label = _("export"), + clicked_callback = export_luts +} + +table.insert(eL.widgets, identity_label) +table.insert(eL.widgets, file_chooser_button) +table.insert(eL.widgets, output_label) +table.insert(eL.widgets, export_chooser_button) +table.insert(eL.widgets, warning_label) +table.insert(eL.widgets, export_button) + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not eL.event_registered then + dt.register_event( + "exportLUT", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + eL.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/ext_editor.lua b/contrib/ext_editor.lua index b5e8eb23..be371e92 100644 --- a/contrib/ext_editor.lua +++ b/contrib/ext_editor.lua @@ -1,64 +1,67 @@ --[[ + ext_editor.lua - edit images with external editors + + 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 . +]] - DESCRIPTION +--[[ ext_editor.lua - edit images with external editors - This script provides helpers to edit image files with programs external to darktable. - It adds: - - a new target storage "collection". Image exported will be reimported to collection for - further edit with external programs - - a new lighttable module "external editors", to select a program from a list of up to - - 9 external editors and run it on a selected image - - a set of lua preferences in order to configure name and path of up to 9 external editors - - a set of lua shortcuts in order to quick launch the external editors - - USAGE + This script provides helpers to edit image files with programs external to darktable. It adds: + - a new target storage "collection". Image exported will be reimported to collection for further edit with external programs + - a new module "external editors", visible in lightable and darkroom, to select a program from a list + - of up to 9 external editors and run it on a selected image (adjust this limit by changing MAX_EDITORS) + - a set of lua preferences in order to configure name and path of up to 9 external editors + - a set of lua shortcuts in order to quick launch the external editors + + USAGE * require this script from main lua file - - -- setup -- - * in "preferences/lua options" configure name and path/command of external programs - * note that if a program name is left empty, that and all following entries will be ignored - * in "preferences/shortcuts/lua" configure shortcuts for external programs (optional) - * whenever programs preferences are changed, in lighttable/external editors, press "update list" - - -- use -- - * in the export dialog choose "collection" and select the format and bit depth for the - exported image - * press "export" - * the exported image will be imported into collection and grouped with the original image + + -- setup -- + * in "preferences/lua options" configure name and path/command of external programs + * note that if a program name is left empty, that and all following entries will be ignored + * in "preferences/shortcuts/lua" configure shortcuts for external programs (optional) + * whenever programs preferences are changed, in external editors GUI, press "update list" + + -- use -- + * in the export dialog choose "collection" and select the format and bit depth for the + exported image + * press "export" + * the exported image will be imported into collection and grouped with the original image + + * in lighttable, select an image for editing with en external program + * (or in darkroom for the image being edited): + * in external editors GUI, select program and press "edit" + * edit the image with the external editor, overwite the file, quit the external program + * the selected image will be updated + or + * in external editors GUI, select program and press "edit a copy" + * edit the image with the external editor, overwite the file, quit the external program + * a copy of the selected image will be created and updated + or + * use the shortcut to edit the current image with the corresponding external editor + * overwite the file, quit the external program + * the image will be updated - * select an image for editing with en external program, and: - * in lighttable/external editors, select program and press "edit" - * edit the image with the external editor, overwite the file, quit the external program - * the selected image will be updated - or - * in lighttable/external editors, select program and press "edit a copy" - * edit the image with the external editor, overwite the file, quit the external program - * a copy of the selected image will be created and updated - or - * in lighttable select target storage "collection" - * enter in darkroom - * to create an export or a copy press CRTL+E - * use the shortcut to edit the current image with the corresponding external editor - * overwite the file, quit the external program - * the darkroom view will be updated - - * warning: mouseover on lighttable/filmstrip will prevail on current image - * this is the default DT behavior, not a bug of this script - - CAVEATS - * MAC compatibility not tested - - TODO - * send multiple images to the same program, maybe - - BUGS, COMMENTS, SUGGESTIONS - * send to Marco Carrarini, marco.carrarini@gmail.com + * warning: mouseover on lighttable/filmstrip will prevail on current image + * this is the default DT behavior, not a bug of this script - CHANGES - * 20191224 - initial version - * 20191227 - added button "update list", better error handling, fixed bug with groups/tags in "edit" - + CAVEATS + * MAC compatibility not tested + + BUGS, COMMENTS, SUGGESTIONS + * send to Marco Carrarini, marco.carrarini@gmail.com ]] @@ -70,382 +73,443 @@ local dtsys = require "lib/dtutils.system" -- module name local MODULE_NAME = "ext_editor" +du.check_min_api_version("7.0.0", MODULE_NAME) + +-- translation +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end +-- return data structure for script_manager --- check API version -du.check_min_api_version("5.0.2", MODULE_NAME) -- darktable 3.0 +local script_data = {} +script_data.metadata = { + name = _("external editors"), + purpose = _("edit images with external editors"), + author = "Marco Carrarini, marco.carrarini@gmail.com", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/ext_editor" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them -- OS compatibility local PS = dt.configuration.running_os == "windows" and "\\" or "/" +-- namespace +local ee = {} +ee.module_installed = false +ee.event_registered = false +ee.widgets = {} --- translation -local gettext = dt.gettext -gettext.bindtextdomain(MODULE_NAME, dt.configuration.config_dir..PS.."lua"..PS.."locale"..PS) -local function _(msgid) - return gettext.dgettext(MODULE_NAME, msgid) -end +-- maximum number of external programs, can be increased to necessity +local MAX_EDITORS = 9 -- number of valid entries in the list of external programs local n_entries --- allowed file extensions, to exclude RAW, which cannot be edited externally -local allowed_file_types = {"JPG", "jpg", "JPEG", "jpeg", "TIF", "tif", "TIFF", "tiff", "EXR", "exr"} +-- allowed file extensions for external editors +local allowed_file_types = {"JPG", "jpg", "JPEG", "jpeg", "TIF", "tif", "TIFF", "tiff", "EXR", "exr", "PNG", "png"} -- last used editor initialization -if not dt.preferences.read(MODULE_NAME,"initialized", "bool") then - dt.preferences.write(MODULE_NAME,"lastchoice", "integer", 0) - dt.preferences.write(MODULE_NAME,"initialized", "bool", true) - end +if not dt.preferences.read(MODULE_NAME, "initialized", "bool") then + dt.preferences.write(MODULE_NAME, "lastchoice", "integer", 0) + dt.preferences.write(MODULE_NAME, "initialized", "bool", true) +end local lastchoice = 0 -- update lists of program names and paths, as well as combobox --------------- local function UpdateProgramList(combobox, button_edit, button_edit_copy, update_button_pressed) - -- initialize lists - program_names = {} - program_paths = {} - - -- build lists from preferences - local name - local last = false - n_entries = 0 - for i = 1, 9 do - name = dt.preferences.read(MODULE_NAME,"program_name_"..i, "string") - if (name == "" or name == nil) then last = true end - if last then - if combobox[n_entries + 1] then combobox[n_entries + 1] = nil end -- remove extra combobox entries - else - combobox[i] = i..": "..name - program_names[i] = name - program_paths[i] = df.sanitize_filename(dt.preferences.read(MODULE_NAME, "program_path_"..i, "string")) - n_entries = i - end - end - - lastchoice = dt.preferences.read(MODULE_NAME, "lastchoice", "integer") - if lastchoice == 0 and n_entries > 0 then lastchoice = 1 end - if lastchoice > n_entries then lastchoice = n_entries end - dt.preferences.write(MODULE_NAME, "lastchoice", "integer", lastchoice) - - -- widgets enabled if there is at least one program configured - combobox.selected = lastchoice - local active = n_entries > 0 - combobox.sensitive = active - button_edit.sensitive = active - button_edit_copy.sensitive = active - - if update_button_pressed then dt.print(n_entries.._(" editors configured")) end - end - - --- shows export progress ------------------------------------------------------ -local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) - - dt.print(_("exporting image ").. number.." / "..total.." ...") - end + -- initialize lists + program_names = {} + program_paths = {} + + -- build lists from preferences + local name + local last = false + n_entries = 0 + for i = 1, MAX_EDITORS do + name = dt.preferences.read(MODULE_NAME, "program_name_"..i, "string") + if (name == "" or name == nil) then last = true end + if last then + if combobox[n_entries + 1] then combobox[n_entries + 1] = nil end -- remove extra combobox entries + else + combobox[i] = i..": "..name + program_names[i] = name + program_paths[i] = df.sanitize_filename(dt.preferences.read(MODULE_NAME, "program_path_"..i, "string")) + n_entries = i + end + end + + lastchoice = dt.preferences.read(MODULE_NAME, "lastchoice", "integer") + if lastchoice == 0 and n_entries > 0 then lastchoice = 1 end + if lastchoice > n_entries then lastchoice = n_entries end + dt.preferences.write(MODULE_NAME, "lastchoice", "integer", lastchoice) + + -- widgets enabled if there is at least one program configured + combobox.selected = lastchoice + local active = n_entries > 0 + combobox.sensitive = active + button_edit.sensitive = active + button_edit_copy.sensitive = active + + if update_button_pressed then dt.print(string.format(_("%d editors configured"), n_entries)) end +end -- callback for buttons "edit" and "edit a copy" ------------------------------ local function OpenWith(images, choice, copy) - - -- check choice is valid, return if not - if choice > n_entries then - dt.print(_("not a valid choice")) - return - end - - -- check if one image is selected, return if not - if #images ~= 1 then - dt.print(_("please select one image")) - return - end - - local bin = program_paths[choice] - local friendly_name = program_names[choice] - - -- check if external program executable exists, return if not - if not df.check_if_bin_exists(bin) then - dt.print(friendly_name.._(" not found")) - return - end - - -- image to be edited - local image - i, image = next(images) - local name = image.path..PS..image.filename - - -- check if image is raw, return if it is - -- please note that the image property image.is_raw fails when filepath contains spaces - -- so as a workaround we allow only TIF, JPG and EXR - local file_ext = df.get_filetype (image.filename) - local allowed = false - for i,v in pairs(allowed_file_types) do - if v == file_ext then - allowed = true - break - end - end - if not allowed then - dt.print(_("file type not allowed")) - return - end - - -- save image tags, rating and color - local tags = {} - for i, tag in ipairs(dt.tags.get_tags(image)) do - if not (string.sub(tag.name, 1, 9) == "darktable") then table.insert(tags, tag) end - end - local rating = image.rating - local red = image.red - local blue = image.blue - local green = image.green - local yellow = image.yellow - local purple = image.purple - - -- new image - local new_name = name - local new_image = image - if copy then - - -- create unique filename - while true do -- dirty solution to workaround issue in lib function check_if_file_exists() - if dt.configuration.running_os == "windows" then - if not df.check_if_file_exists(df.sanitize_filename(new_name)) then break end - else - if not df.check_if_file_exists(new_name) then break end - end - new_name = df.filename_increment(new_name) - -- limit to 50 more exports of the original export - if string.match(df.get_basename(new_name), "_%d%d$") == "_50" then break end - end - - -- physical copy, check result, return if error - local copy_success = df.file_copy(name, new_name) - if not copy_success then - dt.print(_("error copying file ")..name) - return - end + -- check choice is valid, return if not + if choice > n_entries then + dt.print(_("not a valid choice")) + return + end + + -- check if one image is selected, return if not + if #images ~= 1 then + dt.print(_("please select one image")) + return + end + + local bin = program_paths[choice] + local friendly_name = program_names[choice] + + if dt.configuration.running_os == "macos" then bin = "open -W -a "..bin end + + -- image to be edited + local image + i, image = next(images) + local name = image.path..PS..image.filename + + -- check if image format is allowed + local file_ext = df.get_filetype(image.filename) + local allowed = false + for i,v in pairs(allowed_file_types) do + if v == file_ext then + allowed = true + break + end + end + if not allowed then + dt.print(_("file type not allowed")) + return + end + + -- save image tags, rating and color + local tags = {} + for i, tag in ipairs(dt.tags.get_tags(image)) do + if not (string.sub(tag.name, 1, 9) == "darktable") then table.insert(tags, tag) end + end + local rating = image.rating + local red = image.red + local blue = image.blue + local green = image.green + local yellow = image.yellow + local purple = image.purple + + -- new image + local new_name = name + local new_image = image + + if copy then + + -- create unique filename + new_name = df.create_unique_filename(new_name) + + -- physical copy, check result, return if error + local copy_success = df.file_copy(name, new_name) + if not copy_success then + dt.print(string.format(_("error copying file %s"), name)) + return + end + end + + -- launch the external editor, check result, return if error + local run_cmd = bin.." "..df.sanitize_filename(new_name) + dt.print(string.format(_("launching %s..."), friendly_name)) + local result = dtsys.external_command(run_cmd) + if result ~= 0 then + dt.print(string.format(_("error launching %s"), friendly_name)) + return + end + + if copy then + -- import in database and group + new_image = dt.database.import(new_name) + new_image:group_with(image) + else + -- refresh the image view + -- note that only image:drop_cache() is not enough to refresh view in darkroom mode + -- therefore image must be deleted and reimported to force refresh + + -- find the grouping status + local image_leader = image.group_leader + local group_members = image:get_group_members() + local new_leader + local index = nil + local found = false + + -- membership status, three different cases + if image_leader == image then + if #group_members > 1 then + -- case 1: image is leader in a group with more members + while not found do + index, new_leader = next(group_members, index) + if new_leader ~= image_leader then found = true end end - - -- launch the external editor, check result, return if error - local run_cmd = bin.." "..df.sanitize_filename(new_name) - dt.print(_("launching ")..friendly_name.."...") - local result = dtsys.external_command(run_cmd) - if result ~= 0 then - dt.print(_("error launching ")..friendly_name) - return - end - - if copy then - -- import in database and group - new_image = dt.database.import(new_name) - new_image:group_with(image) + new_leader:make_group_leader() + image:delete() + if image.local_copy then image:drop_cache() end -- to fix fail to allocate cache error + new_image = dt.database.import(name) + new_image:group_with(new_leader) + new_image:make_group_leader() + else + -- case 2: image is the only member in group + image:delete() + if image.local_copy then image:drop_cache() end -- to fix fail to allocate cache error + new_image = dt.database.import(name) + new_image:group_with() + end else - -- refresh the image view - -- note that only image:drop_cache() is not enough to refresh view in darkroom mode - -- therefore image must be deleted and reimported to force refresh - - -- find the grouping status - local image_leader = image.group_leader - local group_members = image:get_group_members() - local new_leader - local index = nil - local found = false - - -- membership status, three different cases - if image_leader == image then - if #group_members > 1 then - -- case 1: image is leader in a group with more members - while not found do - index, new_leader = next(group_members, index) - if new_leader ~= image_leader then found = true end - end - new_leader:make_group_leader() - image:delete() - new_image = dt.database.import(name) - new_image:group_with(new_leader) - new_image:make_group_leader() - else - -- case 2: image is the only member in group - image:delete() - new_image = dt.database.import(name) - new_image:group_with() - end - else - -- case 3: image is in a group but is not leader - image:delete() - new_image = dt.database.import(name) - new_image:group_with(image_leader) - end - -- refresh darkroom view - if dt.gui.current_view() == dt.gui.views.darkroom then - dt.gui.views.darkroom.display_image(new_image) - end - end - - -- restore image tags, rating and color, must be put after refresh darkroom view - for i, tag in ipairs(tags) do dt.tags.attach(tag, new_image) end - new_image.rating = rating - new_image.red = red - new_image.blue = blue - new_image.green = green - new_image.yellow = yellow - new_image.purple = purple + -- case 3: image is in a group but is not leader + image:delete() + if image.local_copy then image:drop_cache() end -- to fix fail to allocate cache error + new_image = dt.database.import(name) + new_image:group_with(image_leader) + end + end + + -- restore image tags, rating and color + for i, tag in ipairs(tags) do dt.tags.attach(tag, new_image) end + new_image.rating = rating + new_image.red = red + new_image.blue = blue + new_image.green = green + new_image.yellow = yellow + new_image.purple = purple -- select the new image - local selection = {} - table.insert(selection, new_image) - dt.gui.selection (selection) - - end + local selection = {} + table.insert(selection, new_image) + dt.gui.selection(selection) + + -- refresh darkroom view + if dt.gui.current_view().id == "darkroom" then + dt.gui.views.darkroom.display_image(new_image) + end +end -- callback function for shortcuts -------------------------------------------- local function program_shortcut(event, shortcut) - OpenWith(dt.gui.action_images, tonumber(string.sub(shortcut, -1)), false) - end + OpenWith(dt.gui.action_images, tonumber(string.sub(shortcut, -2)), false) +end -- export images and reimport in collection ----------------------------------- local function export2collection(storage, image_table, extra_data) - local new_name, new_image, result + local temp_name, new_name, new_image, move_success - for image, temp_name in pairs(image_table) do + for image, temp_name in pairs(image_table) do - -- images are first exported in temp folder then moved to collection folder + -- images are first exported in temp folder then moved to collection folder - -- create unique filename - new_name = image.path..PS..df.get_filename(temp_name) - while true do -- dirty solution to workaround issue in lib function check_if_file_exists() - if dt.configuration.running_os == "windows" then - if not df.check_if_file_exists(df.sanitize_filename(new_name)) then break end - else - if not df.check_if_file_exists(new_name) then break end - end - new_name = df.filename_increment(new_name) - -- limit to 50 more exports of the original export - if string.match(df.get_basename(new_name), "_%d%d$") == "_50" then break end - end + -- create unique filename + new_name = image.path..PS..df.get_filename(temp_name) + new_name = df.create_unique_filename(new_name) - -- move image to collection folder, check result, return if error - move_success = df.file_move(temp_name, new_name) - if not move_success then - dt.print(_("error moving file ")..temp_name) - return - end + -- move image to collection folder, check result, return if error + move_success = df.file_move(temp_name, new_name) + if not move_success then + dt.print(string.format(_("error moving file %s"), temp_name)) + return + end - -- import in database and group - new_image = dt.database.import(new_name) - new_image:group_with(image.group_leader) - end - end + -- import in database and group + new_image = dt.database.import(new_name) + new_image:group_with(image.group_leader) + end + + dt.print(_("finished exporting")) +end --- register new storage ------------------------------------------------------- --- note that placing this declaration later makes the export selected module --- not to remember the choice "collection" when restarting DT, don't know why -dt.register_storage("exp2coll", _("collection"), show_status, export2collection) +-- install the module in the UI ----------------------------------------------- +local function install_module(dr) + + local views = {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 90}} + if dr then + views = {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 90}, + [dt.gui.views.darkroom] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER", 100}} + end + + if not ee.module_installed then + -- register new module "external editors" in lighttable and darkroom ---- + dt.register_lib( + MODULE_NAME, + _("external editors"), + true, -- expandable + false, -- resetable + views, + dt.new_widget("box") { + orientation = "vertical", + table.unpack(ee.widgets), + }, + nil, -- view_enter + nil -- view_leave + ) + ee.module_installed = true + end +end + +local function destroy() + for i = 1, MAX_EDITORS do + dt.destroy_event(MODULE_NAME .. i, "shortcut") + end + dt.destroy_storage("exp2coll") + dt.gui.libs[MODULE_NAME].visible = false +end + +local function restart() + for i = 1, MAX_EDITORS do + dt.register_event(MODULE_NAME .. i, "shortcut", + program_shortcut, string.format(_("edit with program %02d"), i)) + end + dt.register_storage("exp2coll", _("collection"), nil, export2collection) + dt.gui.libs[MODULE_NAME].visible = true +end + +local function show() + dt.gui.libs[MODULE_NAME].visible = true +end -- combobox, with variable number of entries ---------------------------------- local combobox = dt.new_widget("combobox") { - label = _("choose program"), - tooltip = _("select the external editor from the list"), - changed_callback = function(self) - dt.preferences.write(MODULE_NAME, "lastchoice", "integer", self.selected) - end, - "" - } + label = _("choose program"), + tooltip = _("select the external editor from the list"), + changed_callback = function(self) + dt.preferences.write(MODULE_NAME, "lastchoice", "integer", self.selected) + end, + "" +} -- button edit ---------------------------------------------------------------- local button_edit = dt.new_widget("button") { - label = _("edit"), - tooltip = _("open the selected image in external editor"), - --sensitive = false, - clicked_callback = function() - OpenWith(dt.gui.action_images, combobox.selected, false) - end - } + label = _("edit"), + tooltip = _("open the selected image in external editor"), + --sensitive = false, + clicked_callback = function() + OpenWith(dt.gui.action_images, combobox.selected, false) + end +} -- button edit a copy --------------------------------------------------------- local button_edit_copy = dt.new_widget("button") { - label = _("edit a copy"), - tooltip = _("create a copy of the selected image and open it in external editor"), - clicked_callback = function() - OpenWith(dt.gui.action_images, combobox.selected, true) - end - } + label = _("edit a copy"), + tooltip = _("create a copy of the selected image and open it in external editor"), + clicked_callback = function() + OpenWith(dt.gui.action_images, combobox.selected, true) + end +} -- button update list --------------------------------------------------------- local button_update_list = dt.new_widget("button") { - label = _("update list"), - tooltip = _("update list of programs if lua preferences are changed"), - clicked_callback = function() - UpdateProgramList(combobox, button_edit, button_edit_copy, true) - end - } + label = _("update list"), + tooltip = _("update list of programs if lua preferences are changed"), + clicked_callback = function() + UpdateProgramList(combobox, button_edit, button_edit_copy, true) + end +} -- box for the buttons -------------------------------------------------------- -- it doesn't seem there is a way to make the buttons equal in size local box1 = dt.new_widget("box") { - orientation = "horizontal", - button_edit, - button_edit_copy, - button_update_list - } - - --- register new module "external editors" in lighttable ------------------------ -dt.register_lib( - MODULE_NAME, - _("external editors"), - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, - dt.new_widget("box") { - orientation = "vertical", - combobox, - box1 - }, - nil, -- view_enter - nil -- view_leave - ) + orientation = "horizontal", + button_edit, + button_edit_copy, + button_update_list +} + + +-- table with all the widgets -------------------------------------------------- +table.insert(ee.widgets, combobox) +table.insert(ee.widgets, box1) + + +-- register new module, but only when in lighttable ---------------------------- +local show_dr = dt.preferences.read(MODULE_NAME, "show_in_darkrooom", "bool") +if dt.gui.current_view().id == "lighttable" then + install_module(show_dr) +else + if not ee.event_registered then + dt.register_event( + MODULE_NAME, "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module(show_dr) + end + end + ) + ee.event_registered = true + end +end -- initialize list of programs and widgets ------------------------------------ UpdateProgramList(combobox, button_edit, button_edit_copy, false) +-- register new storage ------------------------------------------------------- +dt.register_storage("exp2coll", _("collection"), nil, export2collection) + + -- register the new preferences ----------------------------------------------- -for i = 9, 1, -1 do - dt.preferences.register(MODULE_NAME, "program_path_"..i, "file", - _("executable for external editor ")..i, - _("select executable for external editor") , _("(None)")) - dt.preferences.register(MODULE_NAME, "program_name_"..i, "string", - _("name of external editor ")..i, - _("friendly name of external editor"), "") - end +for i = MAX_EDITORS, 1, -1 do + dt.preferences.register(MODULE_NAME, "program_path_"..i, "file", + string.format(_("executable for external editor %d"), i), + _("select executable for external editor") , _("(none)")) + + dt.preferences.register(MODULE_NAME, "program_name_"..i, "string", + string.format(_("name of external editor %d"), i), + _("friendly name of external editor"), "") +end +dt.preferences.register(MODULE_NAME, "show_in_darkrooom", "bool", + _("show external editors in darkroom"), + _("check to show external editors module also in darkroom (requires restart)"), false) + + +-- register the new shortcuts ------------------------------------------------- +for i = 1, MAX_EDITORS do + dt.register_event(MODULE_NAME .. i, "shortcut", + program_shortcut, string.format(_("edit with program %02d"), i)) +end --- register the new shortcuts ------------------------------------------------- -for i = 1, 9 do - dt.register_event("shortcut", program_shortcut, _("edit with program ")..i) - end +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = show +return script_data -- end of script -------------------------------------------------------------- --- vim: shiftwidth=4 expandtab tabstop=4 cindent syntax=lua +-- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: hl Lua; diff --git a/contrib/face_recognition.lua b/contrib/face_recognition.lua index 45229b6a..0c60a5c1 100644 --- a/contrib/face_recognition.lua +++ b/contrib/face_recognition.lua @@ -44,7 +44,7 @@ local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" local dtsys = require "lib/dtutils.system" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -- constants @@ -52,33 +52,33 @@ local MODULE = "face_recognition" local PS = dt.configuration.running_os == "windows" and '\\' or '/' local OUTPUT = dt.configuration.tmp_dir .. PS .. "facerecognition.txt" --- namespace +du.check_min_api_version("7.0.0", MODULE) -local fc = {} +local function _(msgid) + return gettext(msgid) +end --- ensure we meet the minimum api -du.check_min_api_version("5.0.0", "face_recognition") +-- return data structure for script_manager --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("face_recognition", dt.configuration.config_dir.."/lua/locale/") +local script_data = {} -local function _(msgid) - return gettext.dgettext("face_recognition", msgid) -end +script_data.metadata = { + name = _("face recognition"), + purpose = _("use facial recognition to tag images"), + author = "Sebastian Witt", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/face_recognition" +} --- preferences +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them -if not dt.preferences.read(MODULE, "initialized", "bool") then - dt.preferences.write(MODULE, "unknown_tag", "string", "unknown_person") - dt.preferences.write(MODULE, "ignore_tags", "string", "") - dt.preferences.write(MODULE, "tolerance", "float", 0.6) - dt.preferences.write(MODULE, "num_cores", "integer", 0) - dt.preferences.write(MODULE, "known_image_path", "directory", dt.configuration.config_dir .. "/face_recognition") - dt.preferences.write(MODULE, "export_format", "integer", 1) - dt.preferences.write(MODULE, "max_width", "integer", 1000) - dt.preferences.write(MODULE, "max_height", "integer", 1000) - dt.preferences.write(MODULE, "initialized", "bool", true) -end +-- namespace + +local fc = {} +fc.module_installed = false +fc.event_registered = false local function build_image_table(images) local image_table = {} @@ -98,8 +98,10 @@ local function build_image_table(images) end for _,img in ipairs(images) do - image_table[img] = tmp_dir .. df.get_basename(img.filename) .. file_extension - cnt = cnt + 1 + if img ~= nil then + image_table[tmp_dir .. df.get_basename(img.filename) .. file_extension] = img + cnt = cnt + 1 + end end return image_table, cnt @@ -109,17 +111,12 @@ local function stop_job(job) job.valid = false end -local function do_export(img_tbl) +local function do_export(img_tbl, images) local exporter = nil local upsize = false - local upscale = false local ff = fc.export_format.value local height = dt.preferences.read(MODULE, "max_height", "integer") local width = dt.preferences.read(MODULE, "max_width", "integer") - local images = 0 - for k,v in pairs(img_tbl) do - images = images + 1 - end -- get the export format parameters if string.match(ff, "JPEG") then @@ -140,9 +137,9 @@ local function do_export(img_tbl) local exp_cnt = 0 local percent_step = 1.0 / images job.percent = 0.0 - for img,export in pairs(img_tbl) do + for export,img in pairs(img_tbl) do exp_cnt = exp_cnt + 1 - dt.print(string.format(_("Exporting image %i of %i images"), exp_cnt, images)) + dt.print(string.format(_("exporting image %i of %i images"), exp_cnt, images)) exporter:write_image(img, export, upsize) job.percent = job.percent + percent_step end @@ -154,13 +151,31 @@ end local function save_preferences() dt.preferences.write(MODULE, "unknown_tag", "string", fc.unknown_tag.text) + dt.preferences.write(MODULE, "no_persons_found_tag", "string", fc.no_persons_found_tag.text) dt.preferences.write(MODULE, "ignore_tags", "string", fc.ignore_tags.text) - dt.preferences.write(MODULE, "max_width", "integer", tonumber(fc.width.text)) - dt.preferences.write(MODULE, "max_height", "integer", tonumber(fc.height.text)) - dt.preferences.write(MODULE, "num_cores", "integer", fc.num_cores.value) + dt.preferences.write(MODULE, "category_tags", "string", fc.category_tags.text) + dt.preferences.write(MODULE, "known_image_path", "directory", fc.known_image_path.value) local val = fc.tolerance.value val = string.gsub(tostring(val), ",", ".") dt.preferences.write(MODULE, "tolerance", "float", tonumber(val)) + dt.preferences.write(MODULE, "num_cores", "integer", fc.num_cores.value) + dt.preferences.write(MODULE, "export_format", "integer", fc.export_format.selected) + dt.preferences.write(MODULE, "max_width", "integer", tonumber(fc.width.text)) + dt.preferences.write(MODULE, "max_height", "integer", tonumber(fc.height.text)) +end + +local function reset_preferences() + fc.unknown_tag.text = "unknown_person" + fc.no_persons_found_tag.text = "no_persons_found" + fc.ignore_tags.text = "" + fc.category_tags.text = "" + fc.known_image_path.value = dt.configuration.config_dir .. "/face_recognition" + fc.tolerance.value = 0.6 + fc.num_cores.value = -1 + fc.export_format.selected = 1 + fc.width.text = 1000 + fc.height.text = 1000 + save_preferences() end -- Check if image has ignored tag attached @@ -178,7 +193,7 @@ local function ignoreByTag (image, ignoreTags) end end end - + return ignoreImage end @@ -194,7 +209,7 @@ local function face_recognition () local bin_path = df.check_if_bin_exists("face_recognition") if not bin_path then - dt.print(_("Face recognition not found")) + dt.print(_("face recognition not found")) return end @@ -204,96 +219,128 @@ local function face_recognition () local knownPath = dt.preferences.read(MODULE, "known_image_path", "directory") local nrCores = dt.preferences.read(MODULE, "num_cores", "integer") local ignoreTagString = dt.preferences.read(MODULE, "ignore_tags", "string") + local categoryTagString = dt.preferences.read(MODULE, "category_tags", "string") local unknownTag = dt.preferences.read(MODULE, "unknown_tag", "string") + local nonpersonsfoundTag = dt.preferences.read(MODULE, "no_persons_found_tag", "string") -- face_recognition uses -1 for all cores, we use 0 in preferences if nrCores < 1 then nrCores = -1 end - + -- Split ignore tags (if any) ignoreTags = {} for tag in string.gmatch(ignoreTagString, '([^,]+)') do table.insert (ignoreTags, tag) dt.print_log ("Face recognition: Ignore tag: " .. tag) end - + -- list of exported images local image_table, cnt = build_image_table(dt.gui.action_images) if cnt > 0 then - local success = do_export(image_table) + local success = do_export(image_table, cnt) if success then -- do the face recognition local img_list = {} - for img,v in pairs(image_table) do + for v,_ in pairs(image_table) do table.insert (img_list, v) end -- Get path of exported images local path = df.get_path (img_list[1]) + dt.print_log ("Face recognition: Path to known faces: " .. knownPath) dt.print_log ("Face recognition: Path to unknown images: " .. path) + dt.print_log ("Face recognition: Tag used for unknown faces: " .. unknownTag) + dt.print_log ("Face recognition: Tag used if non person is found: " .. nonpersonsfoundTag) os.setlocale("C") local tolerance = dt.preferences.read(MODULE, "tolerance", "float") - + local command = bin_path .. " --cpus " .. nrCores .. " --tolerance " .. tolerance .. " " .. knownPath .. " " .. path .. " > " .. OUTPUT os.setlocale() dt.print_log("Face recognition: Running command: " .. command) - dt.print(_("Starting face recognition...")) + dt.print(_("starting face recognition...")) dtsys.external_command(command) -- Open output file local f = io.open(OUTPUT, "rb") - + if not f then - dt.print(_("Face recognition failed")) + dt.print(_("face recognition failed")) else - dt.print(_("Face recognition finished")) + dt.print(_("face recognition finished")) f:close () end - + -- Read output dt.print(_("processing results...")) local result = {} - for line in io.lines(OUTPUT) do - local file, tag = string.match (line, "(.*),(.*)$") - tag = string.gsub (tag, "%d*$", "") - dt.print_log ("File:"..file .." Tag:".. tag) - if result[file] ~= nil then - table.insert (result[file], tag) - else - result[file] = {tag} + local tags_list = {} + local tag_object = {} + for line in io.lines(OUTPUT) do + if not string.match(line, "^WARNING:") and line ~= "" and line ~= nil then + local file, tag = string.match (line, "(.*),(.*)$") + tag = string.gsub (tag, "%d*$", "") + dt.print_log ("File:"..file .." Tag:".. tag) + tag_object = {} + if result[file] == nil then + tag_object[tag] = true + result[file] = tag_object + else + tag_object = result[file] + tag_object[tag] = true + result[file] = tag_object + end end end - + -- Attach tags + local result_index = 0 for file,tags in pairs(result) do + result_index = result_index +1 -- Find image in table - for img,file2 in pairs(image_table) do - if file == file2 then - for _,t in ipairs (tags) do - -- Check if image is ignored - if ignoreByTag (img, ignoreTags) then - dt.print_log("Face recognition: Ignoring image with ID " .. img.id) - else - -- Check of unrecognized unknown_person - if t == "unknown_person" then - t = unknownTag - end + img = image_table[file] + if img == nil then + dt.print_log("Face recognition: Ignoring face recognition entry: " .. file) + else + for t,_ in pairs (tags) do + -- Check if image is ignored + if ignoreByTag (img, ignoreTags) then + dt.print_log("Face recognition: Ignoring image with ID " .. img.id) + else + -- Check of unrecognized unknown_person + if t == "unknown_person" then + t = unknownTag + end + -- Check of unrecognized no_persons_found + if t == "no_persons_found" then + t = nonpersonsfoundTag + end + if t ~= "" and t ~= nil then + if categoryTagString ~= "" and t ~= nonpersonsfoundTag then + t = categoryTagString .. "|" .. t + end dt.print_log ("ImgId:" .. img.id .. " Tag:".. t) - -- Create tag if it does not exists - local tag = dt.tags.create (t) + -- Create tag if it does not exist + if tags_list[t] == nil then + tag = dt.tags.create (t) + tags_list[t] = tag + else + tag = tags_list[t] + end img:attach_tag (tag) end end end end end - dt.print(_("face recognition complete")) cleanup(img_list) + dt.print_log("img_list cleaned-up") + dt.print_log("face recognition complete") + dt.print(_("face recognition complete")) else dt.print(_("image export failed")) return @@ -302,8 +349,30 @@ local function face_recognition () dt.print(_("no images selected")) return end +end + +local function install_module() + if not fc.module_installed then + dt.register_lib( + MODULE, -- Module name + _("face recognition"), -- Visible name + true, -- expandable + true, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 300}}, -- containers + fc.widget, + nil,-- view_enter + nil -- view_leave + ) + fc.module_installed = true + end +end +local function destroy() + dt.gui.libs[MODULE].visible = false +end +local function restart() + dt.gui.libs[MODULE].visible = true end -- build the interface @@ -314,15 +383,27 @@ fc.unknown_tag = dt.new_widget("entry"){ editable = true, } +fc.no_persons_found_tag = dt.new_widget("entry"){ + text = dt.preferences.read(MODULE, "no_persons_found_tag", "string"), + tooltip = _("tag to be used when no persons are found"), + editable = true, +} + fc.ignore_tags = dt.new_widget("entry"){ text = dt.preferences.read(MODULE, "ignore_tags", "string"), tooltip = _("tags of images to ignore"), editable = true, } +fc.category_tags = dt.new_widget("entry"){ + text = dt.preferences.read(MODULE, "category_tags", "string"), + tooltip = _("tag category"), + editable = true, +} + fc.tolerance = dt.new_widget("slider"){ label = _("tolerance"), - tooltip = ("detection tolerance - 0.6 default - lower if too many faces detected"), + tooltip = _("detection tolerance - 0.6 default - lower if too many faces detected"), soft_min = 0.0, hard_min = 0.0, soft_max = 1.0, @@ -386,8 +467,12 @@ fc.execute = dt.new_widget("button"){ local widgets = { dt.new_widget("label"){ label = _("unknown person tag")}, fc.unknown_tag, - dt.new_widget("label"){ label = _("togs of images to ignore")}, + dt.new_widget("label"){ label = _("no persons found tag")}, + fc.no_persons_found_tag, + dt.new_widget("label"){ label = _("tags of images to ignore")}, fc.ignore_tags, + dt.new_widget("label"){ label = _("tag category")}, + fc.category_tags, dt.new_widget("label"){ label = _("face data directory")}, fc.known_image_path, } @@ -401,38 +486,55 @@ table.insert(widgets, fc.num_cores) table.insert(widgets, fc.export_format) table.insert(widgets, dt.new_widget("box"){ orientation = "horizontal", - dt.new_widget("label"){ label = _("width ")}, + dt.new_widget("label"){ label = _("width")}, fc.width, }) table.insert(widgets, dt.new_widget("box"){ orientation = "horizontal", - dt.new_widget("label"){ label = _("height ")}, + dt.new_widget("label"){ label = _("height")}, fc.height, }) table.insert(widgets, fc.execute) fc.widget = dt.new_widget("box"){ orientation = vertical, - table.unpack(widgets) + reset_callback = function(this) + reset_preferences() + end, + table.unpack(widgets), } ---fc.tolerance.value = dt.preferences.read(MODULE, "tolerance", "float") +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not fc.event_registered then + dt.register_event( + MODULE, "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + fc.event_registered = true + end +end + +fc.tolerance.value = dt.preferences.read(MODULE, "tolerance", "float") --- Register ---dt.register_storage("module_face_recognition", _("Face recognition"), show_status, face_recognition) +-- preferences -dt.register_lib( - "face_recognition", -- Module name - _("face recognition"), -- Visible name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 300}}, -- containers - fc.widget, - nil,-- view_enter - nil -- view_leave -) +if not dt.preferences.read(MODULE, "initialized", "bool") then + reset_preferences() + save_preferences() + dt.preferences.write(MODULE, "initialized", "bool", true) +end -fc.tolerance.value = dt.preferences.read(MODULE, "tolerance", "float") +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/contrib/fujifilm_dynamic_range.lua b/contrib/fujifilm_dynamic_range.lua new file mode 100644 index 00000000..37f79511 --- /dev/null +++ b/contrib/fujifilm_dynamic_range.lua @@ -0,0 +1,156 @@ +--[[ fujifilm_dynamic_range-0.1 + +Compensate for Fujifilm raw files made using "dynamic range". + +Copyright (C) 2021, 2022 Dan Torop + +This program 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 2 of the License, or +(at your option) any later version. + +This program 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 this program; if not, write to the Free Software Foundation, Inc., +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. +]] + +--[[About this Plugin +Support for adjusting darktable exposure by Fujifilm raw exposure +bias. This corrects for a DR100/DR200/DR400 "dynamic range" setting. + +Dependencies: +- exiftool (https://www.sno.phy.queensu.ca/~phil/exiftool/) + +Based upon fujifilm_ratings by Ben Mendis + +The relevant tag is RawExposureBias (0x9650). This appears to +represent the shift in EV for the chosen DR setting (whether manual or +automatic). Note that even at 100DR ("standard") there is an EV shift: + +100 DR -> -0.72 EV +200 DR -> -1.72 EV +400 DR -> -2.72 EV + +The ideal would be to use exiv2 to read this tag, as this is the same +code which darktable import uses. Unfortunately, exiv2 as of v0.27.3 +can't read this tag. As it is encoded as a 4-byte ratio of two signed +shorts -- a novel data type -- it will require some attention to fix +this. + +There is an exiv2-readable DevelopmentDynamicRange tag which maps to +RawExposureBias as above. DevelopmentDynamicRange is only present +when tag DynamicRangeSetting (0x1402) is Manual/Raw (0x0001). When it +is Auto (0x0000), the equivalent data is tag AutoDynamicRange +(0x140b). But exiv2 currently can't read that tag either. + +Hence for now this code uses exiftool to read RawExposureBias, as a +more general solution. As exiftool is approx. 10x slower than exiv2 +(Perl vs. C++), this may slow large imports. + +These tags have been checked on a Fujifilm X100S and X100V. Other +cameras may behave in other ways. + +--]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local dtsys = require "lib/dtutils.system" +local gettext = dt.gettext.gettext + +du.check_min_api_version("7.0.0", "fujifilm_dynamic_range") + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("fujifilm dynamic range"), + purpose = _("compensate for Fujifilm raw files made using \"dynamic range\""), + author = "Dan Torop ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local function detect_dynamic_range(event, image) + if image.exif_maker ~= "FUJIFILM" then + dt.print_log("[fujifilm_dynamic_range] ignoring non-Fujifilm image") + return + end + -- it would be nice to check image.is_raw but this appears to not yet be set + if not string.match(image.filename, "%.RAF$") then + dt.print_log("[fujifilm_dynamic_range] ignoring non-raw image") + return + end + local command = df.check_if_bin_exists("exiftool") + if not command then + dt.print_error("[fujifilm_dynamic_range] exiftool not found") + return + end + local RAF_filename = df.sanitize_filename(tostring(image)) + -- without -n flag, exiftool will round to the nearest tenth + command = command .. " -RawExposureBias -n -t " .. RAF_filename + dt.print_log(command) + output = io.popen(command) + local raf_result = output:read("*all") + output:close() + if #raf_result == 0 then + dt.print_error("[fujifilm_dynamic_range] no output returned by exiftool") + return + end + raf_result = string.match(raf_result, "\t(.*)") + if not raf_result then + dt.print_error("[fujifilm_dynamic_range] could not parse exiftool output") + return + end + if image.exif_exposure_bias ~= image.exif_exposure_bias then + -- is NAN (this is unlikely as RAFs should have ExposureBiasValue set) + image.exif_exposure_bias = 0 + end + -- this should be auto-applied if plugins/darkroom/workflow is scene-referred + -- note that scene-referred workflow exposure preset also pushes exposure up by 0.5 EV + image.exif_exposure_bias = image.exif_exposure_bias + tonumber(raf_result) + dt.print_log("[fujifilm_dynamic_range] raw exposure bias " .. tostring(raf_result)) + -- handle any duplicates + if #image:get_group_members() > 1 then + local basename = df.get_basename(image.filename) + local grouped_images = image:get_group_members() + for _, img in ipairs(grouped_images) do + if string.match(img.filename, basename) and img.duplicate_index > 0 then + -- its a duplicate + img.exif_exposure_bias = img.exif_exposure_bias + tonumber(raf_result) + end + end + end +end + +local function destroy() + dt.destroy_event("fujifilm_dr", "post-import-image") +end + +if not df.check_if_bin_exists("exiftool") then + dt.print_log("Please install exiftool to use fujifilm_dynamic_range") + error "[fujifilm_dynamic_range] exiftool not found" +end + +dt.register_event("fujifilm_dr", "post-import-image", + detect_dynamic_range) + +dt.print_log("[fujifilm_dynamic_range] loaded") + +script_data.destroy = destroy + +return script_data diff --git a/contrib/fujifilm_ratings.lua b/contrib/fujifilm_ratings.lua index 6cf92c97..b29996d9 100644 --- a/contrib/fujifilm_ratings.lua +++ b/contrib/fujifilm_ratings.lua @@ -26,46 +26,70 @@ Dependencies: local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" -local gettext = dt.gettext +local dtsys = require "lib/dtutils.system" +local gettext = dt.gettext.gettext -du.check_min_api_version("4.0.0", "fujifilm_ratings") - -gettext.bindtextdomain("fujifilm_ratings", dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "fujifilm_ratings") local function _(msgid) - return gettext.dgettext("fujifilm_ratings", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("fujifilm ratings"), + purpose = _("import Fujifilm in-camera ratings"), + author = "Ben Mendis ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/fujifilm_ratings" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local function detect_rating(event, image) + if not string.match(image.filename, "%.RAF$") and not string.match(image.filename, "%.raf$") then + return + end if not df.check_if_bin_exists("exiftool") then - dt.print_error(_("exiftool not found")) + dt.print_error("exiftool not found") return end - local RAF_filename = tostring(image) + local RAF_filename = df.sanitize_filename(tostring(image)) local JPEG_filename = string.gsub(RAF_filename, "%.RAF$", ".JPG") local command = "exiftool -Rating " .. JPEG_filename - dt.print_error(command) + dt.print_log(command) local output = io.popen(command) local jpeg_result = output:read("*all") output:close() if string.len(jpeg_result) > 0 then jpeg_result = string.gsub(jpeg_result, "^Rating.*(%d)", "%1") image.rating = tonumber(jpeg_result) - dt.print_error(_("Using JPEG Rating: ") .. tostring(jpeg_result)) + dt.print_log("using JPEG rating: " .. jpeg_result) return end command = "exiftool -Rating " .. RAF_filename - dt.print_error(command) + dt.print_log(command) output = io.popen(command) local raf_result = output:read("*all") output:close() if string.len(raf_result) > 0 then raf_result = string.gsub(raf_result, "^Rating.*(%d)", "%1") image.rating = tonumber(raf_result) - dt.print_error(_("Using RAF Rating: ") .. tostring(raf_result)) + dt.print_log("using RAF rating: " .. raf_result) end end -dt.register_event("post-import-image", detect_rating) +local function destroy() + dt.destroy_event("fujifilm_rat", "post-import-image") +end + +dt.register_event("fujifilm_rat", "post-import-image", + detect_rating) -print(_("fujifilm_ratings loaded.")) +script_data.destroy = destroy +return script_data diff --git a/contrib/geoJSON_export.lua b/contrib/geoJSON_export.lua index 4834bb01..93e77289 100644 --- a/contrib/geoJSON_export.lua +++ b/contrib/geoJSON_export.lua @@ -35,18 +35,31 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" -require "official/yield" -local gettext = dt.gettext +local dtsys = require "lib/dtutils.system" +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "geoJSON_export") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("geoJSON_export",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "geoJSON_export") local function _(msgid) - return gettext.dgettext("geoJSON_export", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("geoJSON export"), + purpose = _("export a geoJSON file from geo data"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/geoJSON_export" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + -- Sort a table local function spairs(_table, order) -- Code copied from http://stackoverflow.com/questions/15706270/sort-a-table-in-lua -- collect the keys @@ -72,24 +85,24 @@ local function spairs(_table, order) -- Code copied from http://stackoverflow.co end local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) - dt.print(string.format(_("Export Image %i/%i"), number, total)) + dt.print(string.format(_("export image %i/%i"), number, total)) end local function create_geoJSON_file(storage, image_table, extra_data) if not df.check_if_bin_exists("mkdir") then - dt.print_error(_("mkdir not found")) + dt.print_error("mkdir not found") return end if not df.check_if_bin_exists("convert") then - dt.print_error(_("convert not found")) + dt.print_error("convert not found") return end if not df.check_if_bin_exists("xdg-open") then - dt.print_error(_("xdg-open not found")) + dt.print_error("xdg-open not found") return end if not df.check_if_bin_exists("xdg-user-dir") then - dt.print_error(_("xdg-user-dir not found")) + dt.print_error("xdg-user-dir not found") return end @@ -280,7 +293,7 @@ local function create_geoJSON_file(storage, image_table, extra_data) file:write(geoJSON_file) file:close() - dt.print("geoJSON file created in "..exportDirectory) + dt.print(string.format(_("%s file created in %s"), "geoJSON", exportDirectory)) -- Open the file with the standard programm if ( dt.preferences.read("geoJSON_export","OpengeoJSONFile","bool") == true ) then @@ -292,24 +305,28 @@ local function create_geoJSON_file(storage, image_table, extra_data) end +local function destroy() + dt.destroy_storage("geoJSON_export") +end + -- Preferences dt.preferences.register("geoJSON_export", "CreateMapBoxHTMLFile", "bool", - _("geoJSON export: Create an additional HTML file"), - _("Creates a HTML file, that loads the geoJASON file. (Needs a MapBox key"), + "geoJSON export: ".._("Create an additional HTML file"), + _("creates an HTML file that loads the geoJSON file. (needs a MapBox key"), false ) dt.preferences.register("geoJSON_export", "mapBoxKey", "string", - _("geoJSON export: MapBox Key"), - _("https://www.mapbox.com/studio/account/tokens"), + "geoJSON export: MapBox " .. _("key"), + "https://www.mapbox.com/studio/account/tokens", '' ) dt.preferences.register("geoJSON_export", "OpengeoJSONFile", "bool", - _("geoJSON export: Open geoJSON file after export"), - _("Opens the geoJSON file after the export with the standard program for geoJSON files"), + "geoJSON export: " .. _("open geoJSON file after export"), + _("opens the geoJSON file after the export with the standard program for geoJSON files"), false ) local handle = io.popen("xdg-user-dir DESKTOP") @@ -321,9 +338,13 @@ end dt.preferences.register("geoJSON_export", "ExportDirectory", "directory", - _("geoJSON export: Export directory"), - _("A directory that will be used to export the geoJSON files"), + _("geoJSON export: export directory"), + _("a directory that will be used to export the geoJSON files"), result ) -- Register dt.register_storage("geoJSON_export", "geoJSON Export", nil, create_geoJSON_file) + +script_data.destroy = destroy + +return script_data diff --git a/contrib/geoToolbox.lua b/contrib/geoToolbox.lua index 19e3c7cd..01a14eea 100644 --- a/contrib/geoToolbox.lua +++ b/contrib/geoToolbox.lua @@ -28,35 +28,54 @@ require "geoToolbox" local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" -require "official/yield" -local gettext = dt.gettext +local dtsys = require "lib/dtutils.system" +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "geoToolbox") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("geoToolbox",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "geoToolbox") local function _(msgid) - return gettext.dgettext("geoToolbox", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("geo toolbox"), + purpose = _("geodata tools"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/geoToolbox" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + +local gT = {} +gT.module_installed = false +gT.event_registered = false + + -- local labelDistance = dt.new_widget("label") -labelDistance.label = _("Distance:") +labelDistance.label = _("distance:") local label_copy_gps_lat = dt.new_widget("check_button") { - label = _("latitude:"), + label = _("latitude: "), value = true } local label_copy_gps_lon = dt.new_widget("check_button") { - label = _("longitude:"), + label = _("longitude: "), value = true } local label_copy_gps_ele = dt.new_widget("check_button") { - label = _("elevation:"), + label = _("elevation: "), value = true } -- @@ -148,7 +167,7 @@ local function get_first_coordinate() first_elevation = '' first_image_date = 0 - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if not image then first_have_data = false else @@ -187,7 +206,7 @@ local function get_second_coordinate() second_elevation = '' second_image_date = 0 - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if not image then second_have_data = false else @@ -223,7 +242,7 @@ local calc_in_between_slider = dt.new_widget("slider") --ToDo: this needs more love local function calc_in_between() local sel_images = dt.gui.action_images - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if image then image_date = make_time_stamp(image.exif_datetime_taken) if (first_have_data and second_have_data) then @@ -270,7 +289,7 @@ local function copy_gps() copy_gps_longitude = '' copy_gps_elevation = '' - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if not image then copy_gps_have_data = false else @@ -287,7 +306,7 @@ local function copy_gps() end label_copy_gps_lat.label = _("latitude: ") .. copy_gps_latitude - label_copy_gps_lon.label = _("longitude: ") ..copy_gps_longitude + label_copy_gps_lon.label = _("longitude: ") .. copy_gps_longitude label_copy_gps_ele.label = _("elevation: ") .. copy_gps_elevation return @@ -297,7 +316,7 @@ end local function paste_gps(image) local sel_images = dt.gui.action_images - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if (label_copy_gps_lat.value) then image.latitude = copy_gps_latitude end @@ -324,7 +343,7 @@ local function open_location_in_gnome_maps() local i = 0; -- Use the first image with geo information - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if ((image.longitude and image.latitude) and (image.longitude ~= 0 and image.latitude ~= 90) -- Sometimes the north-pole but most likely just wrong data ) then @@ -351,12 +370,12 @@ end local function reverse_geocode() if not df.check_if_bin_exists("curl") then - dt.print_error(_("curl not found")) + dt.print_error("curl not found") return end if not df.check_if_bin_exists("jq") then - dt.print_error(_("jq not found")) + dt.print_error("jq not found") return end @@ -367,7 +386,7 @@ local function reverse_geocode() local i = 0; -- Use the first image with geo information - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if ((image.longitude and image.latitude) and (image.longitude ~= 0 and image.latitude ~= 90) -- Sometimes the north-pole but most likely just wrong data ) then @@ -417,7 +436,7 @@ local function get_distance(lat1, lon1, ele1, lat2, lon2, ele2) math.cos(math.rad(lat1)) * math.cos(math.rad(lat2)) * math.sin(dLon/2) * math.sin(dLon/2) ; - local angle = 2 * math.atan2(math.sqrt(a), math.sqrt(1-a)); + local angle = 2 * math.atan(math.sqrt(a), math.sqrt(1-a)); local distance = earthRadius * angle; -- Distance in km -- Add the elevation to the calculation @@ -442,7 +461,7 @@ local function calc_distance() local sel_images = dt.gui.selection() - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if ((image.longitude and image.latitude) and (image.longitude ~= 0 and image.latitude ~= 90) -- Sometimes the north-pole but most likely just wrong data ) then @@ -474,12 +493,12 @@ local function calc_distance() if (distance < 1) then distance = distance * 1000 - distanceUnit = _("m") + distanceUnit = "m" else - distanceUnit = _("km") + distanceUnit = "km" end - return string.format(_("Distance: %.2f %s"), distance, distanceUnit) + return string.format(_("distance: %.2f %s"), distance, distanceUnit) end local function print_calc_distance() @@ -502,12 +521,12 @@ local altitude_filename = dt.new_widget("entry") text = "altitude.csv", placeholder = "altitude.csv", editable = true, - tooltip = _("Name of the exported file"), + tooltip = _("name of the exported file"), reset_callback = function(self) self.text = "text" end } local function altitude_profile() - dt.print(_("Start export")) + dt.print(_("start export")) local sel_images = dt.gui.action_images local lat1 = 0; @@ -526,7 +545,7 @@ local function altitude_profile() local elevationAdd = 0; local sel_images = dt.gui.action_images - for _,image in ipairs(sel_images) do + for jj,image in ipairs(sel_images) do if ((not isnan(image.longitude) and not isnan(image.latitude) and not isnan(image.elevation) and image.elevation) and (image.longitude ~= 0 and image.latitude ~= 90) -- Sometimes the north-pole but most likely just wrong data ) then @@ -568,10 +587,53 @@ local function altitude_profile() file = io.open(exportDirectory.."/"..exportFilename, "w") file:write(csv_file) file:close() - dt.print(_("File created in ")..exportDirectory) + dt.print(string.format(_("file created in %s"), exportDirectory)) + +end +local function install_module() + if not gT.module_installed then + dt.register_lib( + "geoToolbox", -- Module name + _("geo toolbox"), -- name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers + gT.widget, + nil,-- view_enter + nil -- view_leave + ) + gT.module_installed = true + end end +local function destroy() + dt.gui.libs["geoToolbox"].visible = false + dt.destroy_event("geoToolbox_cd", "shortcut") + dt.destroy_event("geoToolbox", "mouse-over-image-changed") + dt.destroy_event("geoToolbox_wg", "shortcut") + dt.destroy_event("geoToolbox_ng", "shortcut") +end + +local function restart() + dt.register_event("geoToolbox_cd", "shortcut", + print_calc_distance, _("calculate the distance from latitude and longitude in km")) + dt.register_event("geoToolbox", "mouse-over-image-changed", + toolbox_calc_distance) + + dt.register_event("geoToolbox_wg", "shortcut", + select_with_gps, _("select all images with GPS information")) + dt.register_event("geoToolbox_ng", "shortcut", + select_without_gps, _("select all images without GPS information")) + + dt.gui.libs["geoToolbox"].visible = true +end + +local function show() + dt.gui.libs["geoToolbox"].visible = true +end + + local separator = dt.new_widget("separator"){} local separator2 = dt.new_widget("separator"){} @@ -579,32 +641,26 @@ local separator3 = dt.new_widget("separator"){} local separator4 = dt.new_widget("separator"){} local separator5 = dt.new_widget("separator"){} -dt.register_lib( - "geoToolbox", -- Module name - "geo toolbox", -- name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers - dt.new_widget("box") +gT.widget = dt.new_widget("box") { orientation = "vertical", dt.new_widget("button") { label = _("select geo images"), - tooltip = _("Select all images with GPS information"), + tooltip = _("select all images with GPS information"), clicked_callback = select_with_gps }, dt.new_widget("button") { label = _("select non-geo images"), - tooltip = _("Select all images without GPS information"), + tooltip = _("select all images without GPS information"), clicked_callback = select_without_gps }, separator,-------------------------------------------------------- dt.new_widget("button") { label = _("copy GPS data"), - tooltip = _("Copy GPS data"), + tooltip = _("copy GPS data"), clicked_callback = copy_gps }, label_copy_gps_lat, @@ -613,7 +669,7 @@ dt.register_lib( dt.new_widget("button") { label = _("paste GPS data"), - tooltip = _("Paste GPS data"), + tooltip = _("paste GPS data"), clicked_callback = paste_gps }, separator2,-------------------------------------------------------- @@ -643,14 +699,14 @@ dt.register_lib( dt.new_widget("button") { label = _("open in Gnome Maps"), - tooltip = _("Open location in Gnome Maps"), + tooltip = _("open location in Gnome Maps"), clicked_callback = open_location_in_gnome_maps }, separator4,-------------------------------------------------------- dt.new_widget("button") { label = _("reverse geocode"), - tooltip = _("This just shows the name of the location, but doesn't add it as tag"), + tooltip = _("this just shows the name of the location, but doesn't add it as tag"), clicked_callback = reverse_geocode }, separator5,-------------------------------------------------------- @@ -660,29 +716,53 @@ dt.register_lib( dt.new_widget("button") { label = _("export altitude CSV file"), - tooltip = _("Create an altitude profile using the GPS data in the metadata"), + tooltip = _("create an altitude profile using the GPS data in the metadata"), clicked_callback = altitude_profile }, labelDistance - }, - nil,-- view_enter - nil -- view_leave -) + } + + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not gT.event_registered then + dt.register_event( + "geoToolbox", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + gT.event_registered = true + end +end -- Preferences dt.preferences.register("geoToolbox", "mapBoxKey", "string", _("geoToolbox export: MapBox Key"), - _("https://www.mapbox.com/studio/account/tokens"), + "https://www.mapbox.com/studio/account/tokens", '' ) -- Register -dt.register_event("shortcut", print_calc_distance, _("Calculate the distance from latitude and longitude in km")) -dt.register_event("mouse-over-image-changed", toolbox_calc_distance) - -dt.register_event("shortcut", select_with_gps, _("Select all images with GPS information")) -dt.register_event("shortcut", select_without_gps, _("Select all images without GPS information")) - +dt.register_event("geoToolbox_cd", "shortcut", + print_calc_distance, _("calculate the distance from latitude and longitude in km")) +dt.register_event("geoToolbox", "mouse-over-image-changed", + toolbox_calc_distance) + +dt.register_event("geoToolbox_wg", "shortcut", + select_with_gps, _("select all images with GPS information")) +dt.register_event("geoToolbox_ng", "shortcut", + select_without_gps, _("select all images without GPS information")) + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = show + +return script_data -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: hl Lua; diff --git a/contrib/gimp.lua b/contrib/gimp.lua index d7528d1b..92c6d0ce 100644 --- a/contrib/gimp.lua +++ b/contrib/gimp.lua @@ -41,7 +41,9 @@ * require this script from your main lua file * select an image or images for editing with GIMP * in the export dialog select "Edit with GIMP" and select the format and bit depth for the - exported image + exported image. Check the "run_detached" button to run GIMP in detached mode. Images + will not be returned to darktable in this mode, but additional images can be sent to + GIMP without stopping it. * Press "export" * Edit the image with GIMP then save the changes with File->Overwrite.... * Exit GIMP @@ -67,18 +69,31 @@ local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" local dtsys = require "lib/dtutils.system" -local gettext = dt.gettext +local gettext = dt.gettext.gettext local gimp_widget = nil -du.check_min_api_version("5.0.0", "gimp") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("gimp",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "gimp") local function _(msgid) - return gettext.dgettext("gimp", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("edit with GIMP"), + purpose = _("export and edit with GIMP"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/gimp" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local function group_if_not_member(img, new_img) local image_table = img:get_group_members() local is_member = false @@ -98,20 +113,26 @@ end local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) - dt.print(string.format(_("Export Image %i/%i"), number, total)) + dt.print(string.format(_("export image %i/%i"), number, total)) end local function gimp_edit(storage, image_table, extra_data) --finalize + local run_detached = dt.preferences.read("gimp", "run_detached", "bool") + local gimp_executable = df.check_if_bin_exists("gimp") if not gimp_executable then - dt.print_error(_("GIMP not found")) + dt.print_error("GIMP not found") return end if dt.configuration.running_os == "macos" then - gimp_executable = "open -W -a " .. gimp_executable + if run_detached then + gimp_executable = "open -a " .. gimp_executable + else + gimp_executable = "open -W -a " .. gimp_executable + end end -- list of exported images @@ -125,60 +146,80 @@ local function gimp_edit(storage, image_table, extra_data) --finalize img_list = img_list ..exp_img.. " " end - dt.print(_("Launching GIMP...")) + dt.print(_("launching GIMP...")) local gimpStartCommand gimpStartCommand = gimp_executable .. " " .. img_list + if run_detached then + if dt.configuration.running_os == "windows" then + gimpStartCommand = "start /b \"\" " .. gimpStartCommand + else + gimpStartCommand = gimpStartCommand .. " &" + end + end + dt.print_log(gimpStartCommand) dtsys.external_command(gimpStartCommand) - -- for each of the image, exported image pairs - -- move the exported image into the directory with the original - -- then import the image into the database which will group it with the original - -- and then copy over any tags other than darktable tags + if not run_detached then + + -- for each of the image, exported image pairs + -- move the exported image into the directory with the original + -- then import the image into the database which will group it with the original + -- and then copy over any tags other than darktable tags - for image,exported_image in pairs(image_table) do + for image,exported_image in pairs(image_table) do - local myimage_name = image.path .. "/" .. df.get_filename(exported_image) + local myimage_name = image.path .. "/" .. df.get_filename(exported_image) - while df.check_if_file_exists(myimage_name) do - myimage_name = df.filename_increment(myimage_name) - -- limit to 99 more exports of the original export - if string.match(df.get_basename(myimage_name), "_(d-)$") == "99" then - break + while df.check_if_file_exists(myimage_name) do + myimage_name = df.filename_increment(myimage_name) + -- limit to 99 more exports of the original export + if string.match(df.get_basename(myimage_name), "_(d-)$") == "99" then + break + end end - end - dt.print_log("moving " .. exported_image .. " to " .. myimage_name) - local result = df.file_move(exported_image, myimage_name) + dt.print_log("moving " .. exported_image .. " to " .. myimage_name) + local result = df.file_move(exported_image, myimage_name) - if result then - dt.print_log("importing file") - local myimage = dt.database.import(myimage_name) + if result then + dt.print_log("importing file") + local myimage = dt.database.import(myimage_name) - group_if_not_member(image, myimage) + group_if_not_member(image, myimage) - for _,tag in pairs(dt.tags.get_tags(image)) do - if not (string.sub(tag.name,1,9) == "darktable") then - dt.print_log("attaching tag") - dt.tags.attach(tag,myimage) + for _,tag in pairs(dt.tags.get_tags(image)) do + if not (string.sub(tag.name,1,9) == "darktable") then + dt.print_log("attaching tag") + dt.tags.attach(tag,myimage) + end end end end end +end +local function destroy() + dt.destroy_storage("module_gimp") end -- Register -local executables = {"gimp"} - -if dt.configuration.running_os ~= "linux" then - gimp_widget = df.executable_path_widget(executables) -end +gimp_widget = dt.new_widget("check_button"){ + label = _("run detached"), + tooltip = _("don't import resulting image back into darktable"), + value = dt.preferences.read("gimp", "run_detached", "bool"), + clicked_callback = function(this) + dt.preferences.write("gimp", "run_detached", "bool", this.value) + end +} -dt.register_storage("module_gimp", _("Edit with GIMP"), show_status, gimp_edit, nil, nil, gimp_widget) +dt.register_storage("module_gimp", _("edit with GIMP"), show_status, gimp_edit, nil, nil, gimp_widget) -- +script_data.destroy = destroy + +return script_data diff --git a/contrib/gpx_export.lua b/contrib/gpx_export.lua index b6fed82e..b310f3a9 100644 --- a/contrib/gpx_export.lua +++ b/contrib/gpx_export.lua @@ -25,17 +25,34 @@ For each source folder, a separate is generated in the gpx file. local dt = require "darktable" local df = require "lib/dtutils.file" local dl = require "lib/dtutils" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -dl.check_min_api_version("3.0.0", "gpx-export") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("gpx_export",dt.configuration.config_dir.."/lua/locale/") +dl.check_min_api_version("7.0.0", "gpx_export") local function _(msgid) - return gettext.dgettext("gpx_export", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("gpx export"), + purpose = _("export gpx information to a file"), + author = "Jannis_V", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/gpx_export" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local gpx = {} +gpx.module_installed = false +gpx.event_registered = false + local path_entry = dt.new_widget("entry") { text = dt.preferences.read("gpx_exporter", "gpxExportPath", "string"), @@ -119,39 +136,78 @@ local function create_gpx_file() local file = io.open(path, "w") if (file == nil) then - dt.print(_("invalid path: ")..path) + dt.print(string.format(_("invalid path: %s"), path)) else file:write(gpx_file) file:close() - dt.print(_("gpx file created: ")..path) + dt.print(string.format(_("gpx file created: "), path)) end end -dt.register_lib( - "gpx_exporter", - "gpx export", - true, -- expandable - true, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers +local function install_module() + if not gpx.module_installed then + dt.register_lib( + "gpx_exporter", + _("gpx export"), + true, -- expandable + true, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers + gpx.widget, + nil,-- view_enter + nil -- view_leave + ) + gpx.module_installed = true + end +end + +local function destroy() + dt.gui.libs["gpx_exporter"].visible = false +end + +local function restart() + dt.gui.libs["gpx_exporter"].visible = true +end + +gpx.widget = dt.new_widget("box") +{ + orientation = "vertical", + dt.new_widget("button") + { + label = _("export"), + tooltip = _("export gpx file"), + clicked_callback = create_gpx_file + }, dt.new_widget("box") { - orientation = "vertical", - dt.new_widget("button") + orientation = "horizontal", + dt.new_widget("label") { - label = _("export"), - tooltip = _("export gpx file"), - clicked_callback = create_gpx_file - }, - dt.new_widget("box") - { - orientation = "horizontal", - dt.new_widget("label") - { - label = _("file:"), - }, - path_entry + label = _("file:"), }, + path_entry }, - nil,-- view_enter - nil -- view_leave -) +} + + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not gpx.event_registered then + dt.register_event( + "gpx_export", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + gpx.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/harmonic_armature_guide.lua b/contrib/harmonic_armature_guide.lua new file mode 100644 index 00000000..ffe03a29 --- /dev/null +++ b/contrib/harmonic_armature_guide.lua @@ -0,0 +1,97 @@ +--[[ + harmonic artmature guide for darktable + + copyright (c) 2021 Hubert Kowalski + + 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 . +]] + +--[[ +HARMONIC ARMATURE GUIDE +Harmonic Armature (also known as 14 line armature) + +INSTALLATION +* copy this file in $CONFIGDIR/lua/contrib where CONFIGDIR is your darktable configuration directory +* add the following line in the file $CONFIGDIR/luarc + require "contrib/harmonic_armature_guide" + +USAGE +* when using guides, select "harmonic armature" as guide +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local gettext = dt.gettext.gettext + +du.check_min_api_version("2.0.0", "harmonic_armature_guide") + +local function _(msgid) + return gettext(msgid) +end + +local script_data = {} + +script_data.metadata = { + name = _("harmonic armature guide"), + purpose = _("harmonic artmature guide"), + author = "Hubert Kowalski", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/harmonic_armature_guide" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +dt.guides.register_guide("harmonic armature", +-- draw +function(cairo, x, y, width, height, zoom_scale) + cairo:save() + + cairo:translate(x, y) + cairo:scale(width, height) + + cairo:move_to(0,0) + cairo:line_to(1, 0.5) + cairo:line_to(0.5, 1) + cairo:line_to(0,0) + cairo:line_to(1, 1) + cairo:line_to(0.5, 0) + cairo:line_to(0, 0.5) + cairo:line_to(1, 1) + + cairo:move_to(1, 0) + cairo:line_to(0, 0.5) + cairo:line_to(0.5, 1) + cairo:line_to(1, 0) + cairo:line_to(0, 1) + cairo:line_to(0.5, 0) + cairo:line_to(1, 0.5) + cairo:line_to(0, 1) + + cairo:restore() +end, +-- gui +function() + return dt.new_widget("label"){label = _("harmonic armature"), halign = "start"} +end +) + +local function destroy() + -- nothing to destroy +end + +script_data.destroy = destroy + +return script_data diff --git a/contrib/hif_group_leader.lua b/contrib/hif_group_leader.lua new file mode 100644 index 00000000..412eea07 --- /dev/null +++ b/contrib/hif_group_leader.lua @@ -0,0 +1,200 @@ +--[[ + + hif_group_leader.lua - Make hif image group leader + + Copyright (C) 2024 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + hif_group_leader - Make hif image group leader + + After a film roll is imported, check for RAW-JPG image groups + and make the JPG image the group leader. This is on by default + but can be disabled in preferences. + + Shortcuts are included to filter existing collections or + selections of images and make the hif the group leader. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + None + + USAGE + Start script from script_manager + Assign keys to the shortcuts + + BUGS, COMMENTS, SUGGESTIONS + Bill Ferguson + + CHANGES +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE = "hif_group_leader" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A P I C H E C K +-- - - - - - - - - - - - - - - - - - - - - - - - + +du.check_min_api_version("7.0.0", MODULE) + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- I 1 8 N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local script_data = {} + +script_data.metadata = { + name = _("HIF group leader"), + purpose = _("make hif image group leader"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/hif_group_leader" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- P R E F E R E N C E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.preferences.register(MODULE, "on_import", "bool", _("make hif group leader on import"), _("automatically make the hif file the group leader when raw + hif are imported"), true) + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- N A M E S P A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +local jgloi = {} +jgloi.images = {} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function toggle_global_toolbox_grouping() + dt.gui.libs.global_toolbox.grouping = false + dt.gui.libs.global_toolbox.grouping = true +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- M A I N P R O G R A M +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function make_hif_group_leader(images) + -- if the image is part of a group, make it the leader + for _, image in ipairs(images) do + if #image:get_group_members() > 1 then + image:make_group_leader() + end + end + if dt.gui.libs.global_toolbox.grouping then + -- toggle the grouping to make the new leader show + toggle_global_toolbox_grouping() + end +end + +local function make_existing_hif_group_leader(images) + for _, image in ipairs(images) do + if string.lower(df.get_filetype(image.filename)) == "hif" then + if #image:get_group_members() > 1 then + image:make_group_leader() + end + end + end + if dt.gui.libs.global_toolbox.grouping then + -- toggle the grouping to make the new leader show + toggle_global_toolbox_grouping() + end +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + if dt.preferences.read(MODULE, "on_import", "bool") then + dt.destroy_event(MODULE, "post-import-film") + dt.destroy_event(MODULE, "post-import-image") + end + dt.destroy_event(MODULE .. "_collect", "shortcut") + dt.destroy_event(MODULE .. "_select", "shortcut") +end + +script_data.destroy = destroy + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- E V E N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +if dt.preferences.read(MODULE, "on_import", "bool") then + dt.register_event(MODULE, "post-import-film", + function(event, film_roll) + -- ignore the film roll, it contains all the images, not just the imported + local images = jgloi.images + if #images > 0 then + jgloi.images = {} + make_hif_group_leader(images) + end + end + ) + + dt.register_event(MODULE, "post-import-image", + function(event, image) + if string.lower(df.get_filetype(image.filename)) == "hif" then + table.insert(jgloi.images, image) + end + end + ) +end + +dt.register_event(MODULE .. "_collect", "shortcut", + function(event, shortcut) + -- ignore the film roll, it contains all the images, not just the imported + local images = dt.collection + make_existing_hif_group_leader(images) + end, + _("make hif group leader for collection") +) + +dt.register_event(MODULE .. "_select", "shortcut", + function(event, shortcut) + local images = dt.gui.selection() + make_existing_hif_group_leader(images) + end, + _("make hif group leader for selection") +) + +return script_data \ No newline at end of file diff --git a/contrib/hugin.lua b/contrib/hugin.lua index 83ec3be4..46fbd90c 100644 --- a/contrib/hugin.lua +++ b/contrib/hugin.lua @@ -40,8 +40,7 @@ local du = require "lib/dtutils" local df = require "lib/dtutils.file" local log = require "lib/dtutils.log" local dtsys = require "lib/dtutils.system" -require "official/yield" -local gettext = dt.gettext +local gettext = dt.gettext.gettext local namespace = 'module_hugin' local user_pref_str = 'prefer_gui' @@ -55,15 +54,28 @@ local executable_table = {"hugin", "hugin_executor", "pto_gen"} local PQ = dt.configuration.running_os == "windows" and '"' or "'" -- works with darktable API version from 5.0.0 on -du.check_min_api_version("5.0.0", "hugin") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("hugin",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "hugin") local function _(msgid) - return gettext.dgettext("hugin", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("hugin"), + purpose = _("stitch images into a panorama"), + author = "Wolfgang Goetz", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/hugin" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local function user_preference_changed(widget) user_prefer_gui = widget.value dt.preferences.write(namespace, user_pref_str, "bool", user_prefer_gui) @@ -71,7 +83,7 @@ end local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) - dt.print("exporting to hugin: "..tostring(number).."/"..tostring(total)) + dt.print(string.format(_("exporting to hugin: %d / %d"), number, total)) end local function create_panorama(storage, image_table, extra_data) --finalize @@ -132,7 +144,7 @@ local function create_panorama(storage, image_table, extra_data) --finalize end if first_file == nil then - dt.print("no file selected") + dt.print(_("no file selected")) return end @@ -193,7 +205,7 @@ local function create_panorama(storage, image_table, extra_data) --finalize if df.check_if_file_exists(src_path) then log.msg(log.debug, "found ", src_path, " importing to ", dst_path) df.file_move(src_path, dst_path) - dt.print(_("importing file "..dst_path)) + dt.print(string.format(_("importing file %s"), dst_path)) dt.database.import(dst_path) end end @@ -206,6 +218,10 @@ local function create_panorama(storage, image_table, extra_data) --finalize end end +local function destroy() + dt.destroy_storage(namespace) +end + -- Register if dt.configuration.running_os ~= "linux" then exec_widget = df.executable_path_widget(executable_table) @@ -215,7 +231,7 @@ hugin_widget = dt.new_widget("box") { orientation = "vertical", dt.new_widget("check_button") { - label = _(" launch hugin gui"), + label = _("launch hugin gui"), value = user_prefer_gui, tooltip = _('launch hugin in gui mode'), clicked_callback = user_preference_changed @@ -225,6 +241,8 @@ hugin_widget = dt.new_widget("box") { dt.register_storage(namespace, _("hugin panorama"), show_status, create_panorama, nil, nil, hugin_widget) +script_data.destroy = destroy +return script_data -- --- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua \ No newline at end of file +-- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/contrib/image_stack.lua b/contrib/image_stack.lua index de3e0c04..661b28d3 100644 --- a/contrib/image_stack.lua +++ b/contrib/image_stack.lua @@ -64,22 +64,35 @@ local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" local dtsys = require "lib/dtutils.system" -local gettext = dt.gettext +local gettext = dt.gettext.gettext local job = nil -- path separator constant local PS = dt.configuration.running_os == "windows" and "\\" or "/" -- works with LUA API version 5.0.0 -du.check_min_api_version("5.0.0", "image_stack") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("image_stack",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "image_stack") local function _(msgid) - return gettext.dgettext("image_stack", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("image stack"), + purpose = _("process a stack of images"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/image_stack" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- GUI definitions -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -126,19 +139,19 @@ local chkbtn_will_align = dt.new_widget("check_button"){ local chkbtn_radial_distortion = dt.new_widget("check_button"){ label = _('optimize radial distortion for all images'), value = dt.preferences.read("align_image_stack", "def_radial_distortion", "bool"), - tooltip = _('optimize radial distortion for all images, \nexcept for first'), + tooltip = _('optimize radial distortion for all images, \nexcept the first'), } local chkbtn_optimize_field = dt.new_widget("check_button"){ label = _('optimize field of view for all images'), value = dt.preferences.read("align_image_stack", "def_optimize_field", "bool"), - tooltip =_('optimize field of view for all images, except for first. \nUseful for aligning focus stacks (DFF) with slightly \ndifferent magnification.'), + tooltip =_('optimize field of view for all images, except the first. \nUseful for aligning focus stacks (DFF) with slightly \ndifferent magnification.'), } local chkbtn_optimize_image_center = dt.new_widget("check_button"){ label = _('optimize image center shift for all images'), value = dt.preferences.read("align_image_stack", "def_optimize_image_center", "bool"), - tooltip =_('optimize image center shift for all images, \nexcept for first.'), + tooltip =_('optimize image center shift for all images, \nexcept the first.'), } local chkbtn_auto_crop = dt.new_widget("check_button"){ @@ -250,7 +263,7 @@ end -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) - dt.print(string.format(_("Export Image %i/%i"), number, total)) + dt.print(string.format(_("export image %i/%i"), number, total)) end -- read the gui and populate the align_image_stack arguments @@ -443,7 +456,7 @@ local function copy_image_attributes(from, to, ...) to.rights = from.rights to.description = from.description else - dt.print_error(_("Unrecognized option to copy_image_attributes: " .. arg)) + dt.print_error("Unrecognized option to copy_image_attributes: " .. arg) end end end @@ -452,6 +465,10 @@ local function stop_job() job.valid = false end +local function destroy() + dt.destroy_storage("module_image_stack") +end + -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- main program -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -483,11 +500,11 @@ local function image_stack(storage, image_table, extra_data) if image_count < 2 then dt.print(_("ERROR: at least 2 images required for image stacking, exiting...")) - dt.print_error(_(image_count .. " image(s) selected, at least 2 required")) + dt.print_error(image_count .. " image(s) selected, at least 2 required") return end - job = dt.gui.create_job("image stack", true, stop_job) + job = dt.gui.create_job(_("image stack"), true, stop_job) job.percent = job.percent + percent_step -- align images if requested @@ -507,13 +524,13 @@ local function image_stack(storage, image_table, extra_data) job.percent = job.percent + percent_step else dt.print(_("ERROR: image alignment failed")) - dt.print_error(_("image alignment failed")) + dt.print_error("image alignment failed") cleanup(img_list) return end else dt.print(_("ERROR: align_image_stack not found")) - dt.print_error(_("align_image_stack not found")) + dt.print_error("align_image_stack not found") cleanup(img_list) return end @@ -527,7 +544,7 @@ local function image_stack(storage, image_table, extra_data) local ignore_tif_tags = " -quiet -define tiff:ignore-tags=40965,42032,42033,42034,42036,18246,18249,36867,34864,34866 " if convert_executable then local convert_command = convert_executable .. ignore_tif_tags .. convert_arguments - dt.print_log(_("convert command is " .. convert_command)) + dt.print_log("convert command is " .. convert_command) dt.print(_("processing image stack")) local result = dtsys.external_command(convert_command) if result == 0 then @@ -541,7 +558,7 @@ local function image_stack(storage, image_table, extra_data) local import_filename = df.create_unique_filename(film_roll_path .. PS .. df.get_filename(output_filename)) df.file_move(output_filename, import_filename) imported_image = dt.database.import(import_filename) - local created_tag = dt.tags.create(_("Created with|image_stack")) + local created_tag = dt.tags.create(_("created with|image_stack")) dt.tags.attach(created_tag, imported_image) -- all the images are the same except for time, so just copy the attributes -- from the first @@ -555,7 +572,7 @@ local function image_stack(storage, image_table, extra_data) if tag_source then dt.print(_("tagging source images")) - local source_tag = dt.tags.create(_("Source file|" .. imported_image.filename)) + local source_tag = dt.tags.create(_("source file|" .. imported_image.filename)) for img, _ in pairs(image_table) do dt.tags.attach(source_tag, img) end @@ -567,7 +584,7 @@ local function image_stack(storage, image_table, extra_data) end else dt.print(_("ERROR: convert executable not found")) - dt.print_error(_("convert executable not found")) + dt.print_error("convert executable not found") cleanup(img_list) end job.valid = false @@ -579,9 +596,12 @@ end dt.preferences.register("align_image_stack", "align_use_gpu", -- name "bool", -- type - _('align image stack: use GPU for remaping'), -- label + _('align image stack: use GPU for remapping'), -- label _('set the GPU remapping for image align'), -- tooltip false) dt.register_storage("module_image_stack", _("image stack"), show_status, image_stack, nil, nil, image_stack_widget) +script_data.destroy = destroy + +return script_data diff --git a/contrib/image_time.lua b/contrib/image_time.lua new file mode 100644 index 00000000..c0971306 --- /dev/null +++ b/contrib/image_time.lua @@ -0,0 +1,593 @@ +--[[ + + image_time.lua - synchronize image time for images shot with different cameras + + Copyright (C) 2019, 2020 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + image_time - non-destructively modify the image time + + DESCRIPTION + + image_time non destructively adjusts image times by modifying the + database image exif_datetime_taken field. There are 4 modes: adjust time, + set time, synchronize time, and reset time. + + ADJUST TIME + + adjust time mode lets you chose an offset in terms of years, months, + days, hours, minutes, and seconds. The adjustment can be added or + subtracted. + + WARNING: When adding and subtracting months the result will usually + be what is expected unless the time being adjusted is at the end of + the month. This is because a month is a variable amount of time that + can be 28, 29, 30 or 31 days depending on the month. Example: It's + March 31st and I subtract a month which not sets the time to February + 31st. When that gets set to a valid time, then the date changes to + March 3rd. + + SET TIME + + set time mode allows you to pick a date and time and set the image + time accordingly. Fields may be left out. This is useful when + importing scanned images that don't have an embedded date. + + SYNCHRONIZE TIME + + I recently purchased a 7DmkII to replace my aging 7D. My 7D was still + serviceable, so I bought a remote control and figured I'd try shooting + events from 2 different perspectives. I didn't think to synchonize the + time between the 2 cameras, so when I loaded the images and sorted by + time it was a disaster. I hacked a script together with hard coded values + to adjust the exif_datetime_taken value in the database for the 7D images + so that everything sorted properly. I've tried shooting with 2 cameras + several times since that first attempt. I've gotten better at getting the + camera times close, but still haven't managed to get them to sync. So I + decided to think the problem through and write a proper script to take + care of the problem. + + RESET TIME + + Select the images and click reset. + + USAGE + + ADJUST TIME + + Change the year, month, day, hour, minute, second dropdowns to the amount + of change desired. Select add or subtract. Select the images. Click + adjust. + + SET TIME + + Set the time fields to the desired time. Select the images to change. Click + set. + + SYNCHRONIZE TIME + + Select 2 images, one from each camera, of the same moment in time. Click + the Calculate button to calculate the time difference. The difference is + displayed in the difference entry. You can manually adjust it by changing + the value if necessary. + + Select the images that need their time adjusted. Determine which way to adjust + adjust the time (add or subtract) and select the appropriate choice. + + If the image times get messed up and you just want to start over, select reset time + from the mode and reset the image times. + + RESET TIME + + Select the images and click reset. + + ADDITIONAL SOFTWARE REQUIRED + * exiv2 + + BUGS, COMMENTS, SUGGESTIONS + * Send to Bill Ferguson, wpferguson@gmail.com + + CHANGES + +]] +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local ds = require "lib/dtutils.string" +local dtsys = require "lib/dtutils.system" +local gettext = dt.gettext.gettext + +local img_time = {} +img_time.module_installed = false +img_time.event_registered = false + +du.check_min_api_version("7.0.0", "image_time") + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("image time"), + purpose = _("synchronize image time for images shot with different cameras or adjust or set image time"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/image_time" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + + +local PS = dt.configuration.runnin_os == "windows" and "\\" or "/" +local ERROR = -1 + +-- function to convert from exif time to system time +local function exiftime2systime(exiftime) + local yr,mo,dy,h,m,s = string.match(exiftime, "(%d-):(%d-):(%d-) (%d-):(%d-):(%d+)") + return(os.time{year=yr, month=mo, day=dy, hour=h, min=m, sec=s}) +end + +-- function to convert from systime to exif time +local function systime2exiftime(systime) + local t = os.date("*t", systime) + return(string.format("%4d:%02d:%02d %02d:%02d:%02d", t.year, t.month, t.day, t.hour, t.min, t.sec)) +end + +local function vars2exiftime(year, month, day, hour, min, sec) + local y = tonumber(year) and string.format("%4d", year) or "0000" + local mo = tonumber(month) and string.format("%02d", month) or "00" + local d = tonumber(day) and string.format("%02d", day) or "00" + local h = tonumber(hour) and string.format("%02d", hour) or "00" + local m = tonumber(min) and string.format("%02d", min) or "00" + local s = tonumber(sec) and string.format("%02d", sec) or "00" + return(y .. ":" .. mo .. ":" .. d .. " " .. h .. ":" .. m .. ":" .. s) +end + +local function exiftime2vars(exiftime) + return string.match(exiftime, "(%d+):(%d+):(%d+) (%d+):(%d+):(%d+)") +end + +local function calc_time_difference(image1, image2) + return math.abs(exiftime2systime(image1.exif_datetime_taken) - exiftime2systime(image2.exif_datetime_taken)) +end + +local function adjust_image_time(image, difference) + image.exif_datetime_taken = systime2exiftime(exiftime2systime(image.exif_datetime_taken) + difference) + return +end + +local function calculate_difference(images) + if #images == 2 then + img_time.diff_entry.text = calc_time_difference(images[1], images[2]) + img_time.btn.sensitive = true + else + dt.print(_("ERROR: 2 images must be selected")) + end +end + +local function synchronize_times(images, difference) + for _, image in ipairs(images) do + adjust_image_time(image, difference) + end +end + +local function synchronize_time(images) + local sign = 1 + if img_time.sdir.value == _("subtract") then + sign = -1 + end + synchronize_times(images, tonumber(img_time.diff_entry.text) * sign) +end + +local function add_time(images) + synchronize_times(images, tonumber(img_time.diff_entry.text)) +end + +local function year_month2months(year, month) + year_months = tonumber(year) and year * 12 or 0 + local months = tonumber(month) and tonumber(month) or 0 + + return year_months + months +end + +local function months2year_month(months) + dt.print_log("months is " .. months) + local year = math.floor(months / 12) + local month = months - (year * 12) + + return year, month +end + +local function get_image_taken_time(image) + -- get original image time + local datetime = nil + + local exiv2 = df.check_if_bin_exists("exiv2") + if exiv2 then + p = io.popen(exiv2 .. " -K Exif.Image.DateTime " .. image.path .. PS .. image.filename) + if p then + for line in p:lines() do + if string.match(line, "Exif.Image.DateTime") then + datetime = string.match(line, "(%d-:%d-:%d- %d-:%d-:%d+)") + end + end + p:close() + end + else + dt.print(_("unable to detect exiv2")) + datetime = ERROR + end + return datetime +end + +local function _get_windows_image_file_creation_time(image) + local datetime = nil + local p = io.popen("dir " .. image.path .. PS .. image.filename) + if p then + for line in p:lines() do + if string.match(line, ds.sanitize_lua(image.filename)) then + local mo, day, yr, hr, min, apm = string.match(line, "(%d+)/(%d+)/(%d+) (%d-):(%d+) (%S+)") + if apm == "PM" then + hr = hr + 12 + end + datetime = vars2exiftime(yr, mo, day, hr, min, 0) + end + end + p:close() + else + dt.print(string.format(_("unable to get information for %s"), image.filename)) + datetime = ERROR + end + return datetime +end + +local function _get_nix_image_file_creation_time(image) + local datetime = nil + local p = io.popen("ls -lL --time-style=full-iso " .. image.path .. PS .. image.filename) + if p then + for line in p:lines() do + if string.match(line, ds.sanitize_lua(image.filename)) then + datetime = vars2exiftime(string.match(line, "(%d+)%-(%d-)%-(%d-) (%d-):(%d-):(%d+).")) + end + end + p:close() + else + dt.print(string.format(_("unable to get information for %s"), image.filename)) + datetime = ERROR + end + return datetime +end + +local function get_image_file_creation_time(image) + -- no exif time in the image file so get the creation time + local datetime = nil + if dt.configuration.running_os == "windows" then + datetime = _get_windows_image_file_creation_time(image) + else + datetime = _get_nix_image_file_creation_time(image) + end + return datetime +end + +local function get_original_image_time(image) + local image_time = image.exif_datetime_taken + local reset_time = nil + + reset_time = get_image_taken_time(image) + + if reset_time then + if reset_time == ERROR then + return image_time + else + return reset_time + end + else + reset_time = get_image_file_creation_time(image) + + if reset_time then + if reset_time == ERROR then + return image_time + else + return reset_time + end + end + end +end + +local function reset_time(images) + if #images > 0 then + for _, image in ipairs(images) do + image.exif_datetime_taken = get_original_image_time(image) + end + else + dt.print_error("reset time: no images selected") + dt.print(_("please select the images that need their time reset")) + end +end + +local function adjust_time(images) + local SEC_MIN = 60 + local SEC_HR = SEC_MIN * 60 + local SEC_DY = SEC_HR * 24 + + local offset = nil + local sign = 1 + + if #images < 1 then + dt.print(_("please select some images and try again")) + return + end + + if img_time.adir.value == _("subtract") then + sign = -1 + end + + for _, image in ipairs(images) do + local y, mo, d, h, m, s = exiftime2vars(image.exif_datetime_taken) + local image_months = year_month2months(y, mo) + local months_diff = year_month2months(img_time.ayr.value, img_time.amo.value) + y, mo = months2year_month(image_months + (months_diff * sign)) + local exif_new = vars2exiftime(y, mo, d, h, m, s) + offset = img_time.ady.value * SEC_DY + offset = offset + img_time.ahr.value * SEC_HR + offset = offset + img_time.amn.value * SEC_MIN + offset = offset + img_time.asc.value + offset = offset * sign + image.exif_datetime_taken = systime2exiftime(exiftime2systime(exif_new) + offset) + end +end + +local function set_time(images) + if #images < 1 then + dt.print(_("please select some images and try again")) + return + end + + local y = img_time.syr.value + local mo = img_time.smo.value + local d = img_time.sdy.value + local h = img_time.shr.value + local m = img_time.smn.value + local s = img_time.ssc.value + + for _, image in ipairs(images) do + image.exif_datetime_taken = vars2exiftime(y, mo, d, h, m, s) + end +end + +local function seq(first, last) + local result = {} + + local num = first + + while num <= last do + table.insert(result, num) + num = num + 1 + end + + return table.unpack(result) +end + +local function reset_widgets() + dt.print_log("took the reset function") + img_time.ayr.selected = 1 + img_time.amo.selected = 1 + img_time.ady.selected = 1 + img_time.ahr.selected = 1 + img_time.ayr.selected = 1 + img_time.amn.selected = 1 + img_time.asc.selected = 1 + img_time.adir.selected = 1 + img_time.syr.selected = #img_time.syr + img_time.smo.selected = 1 + img_time.sdy.selected = 1 + img_time.shr.selected = 1 + img_time.smn.selected = 1 + img_time.ssc.selected = 1 + img_time.adir.selected = 1 +end + +local function install_module() + if not img_time.module_installed then + dt.register_lib( + "image_time", -- Module name + _("image time"), -- Visible name + true, -- expandable + true, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers + img_time.widget, + nil,-- view_enter + nil -- view_leave + ) + img_time.module_installed = true + end +end + +local function destroy() + dt.gui.libs["image_time"].visible = false +end + +local function restart() + dt.gui.libs["image_time"].visible = true +end + +-- widgets + +img_time.widgets = { + -- name, type, tooltip, placeholder, + {"ayr", "combobox", _("years"), _("years to adjust by, 0 - ?"), {seq(0,20)}, 1}, + {"amo", "combobox", _("months"), _("months to adjust by, 0-12"), {seq(0,12)}, 1}, + {"ady", "combobox", _("days"), _("days to adjust by, 0-31"), {seq(0,31)}, 1}, + {"ahr", "combobox", _("hours"), _("hours to adjust by, 0-23"), {seq(0,23)}, 1}, + {"amn", "combobox", _("minutes"), _("minutes to adjust by, 0-59"), {seq(0,59)}, 1}, + {"asc", "combobox", _("seconds"), _("seconds to adjust by, 0-59"), {seq(0,59)}, 1}, + {"adir", "combobox", _("add/subtract"), _("add or subtract time"), {_("add"), _("subtract")}, 1}, + {"syr", "combobox", _("year"), _("year to set, 1900 - now"), {" ", seq(1900,os.date("*t", os.time()).year)}, 1}, + {"smo", "combobox", _("month"), _("month to set, 1-12"), {" ", seq(1,12)}, 1}, + {"sdy", "combobox", _("day"), _("day to set, 1-31"), {" ", seq(1,31)}, 1}, + {"shr", "combobox", _("hour"), _("hour to set, 0-23"), {" ", seq(0,23)}, 1}, + {"smn", "combobox", _("minute"), _("minutes to set, 0-59"), {" ", seq(0, 59)}, 1}, + {"ssc", "combobox", _("seconds"), _("seconds to set, 0-59"), {" ", seq(0,59)}, 1}, + {"sdir", "combobox", _("add/subtract"), _("add or subtract time"), {_("add"), _("subtract")}, 1}, +} + +for _, widget in ipairs(img_time.widgets) do + img_time[widget[1]] = dt.new_widget(widget[2]){ + label = widget[3], + tooltip = widget[4], + selected = widget[6], + table.unpack(widget[5]) + } +end + +img_time.syr.selected = #img_time.syr + +img_time.diff_entry = dt.new_widget("entry"){ + tooltip = _("time difference between images in seconds"), + placeholder = _("select 2 images and use the calculate button"), + text = "", +} + +img_time.calc_btn = dt.new_widget("button"){ + label = _("calculate"), + tooltip = _("calculate time difference between 2 images"), + clicked_callback = function() + calculate_difference(dt.gui.action_images) + end +} + +img_time.btn = dt.new_widget("button"){ + label = _("synchronize image times"), + tooltip = _("apply the time difference from selected images"), + sensitive = false, + clicked_callback = function() + synchronize_time(dt.gui.action_images) + end +} + +img_time.stack = dt.new_widget("stack"){ + dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("label"){label = _("adjust time")}, + dt.new_widget("section_label"){label = _("days, months, years")}, + img_time.ady, + img_time.amo, + img_time.ayr, + dt.new_widget("section_label"){label = _("hours, minutes, seconds")}, + img_time.ahr, + img_time.amn, + img_time.asc, + dt.new_widget("section_label"){label = _("adjustment direction")}, + img_time.adir, + dt.new_widget("button"){ + label = _("adjust"), + clicked_callback = function() + adjust_time(dt.gui.action_images) + end + } + }, + dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("label"){label = _("set time")}, + dt.new_widget("section_label"){label = _("date:")}, + img_time.sdy, + img_time.smo, + img_time.syr, + dt.new_widget("section_label"){label = _("time:")}, + img_time.shr, + img_time.smn, + img_time.ssc, + dt.new_widget("button"){ + label = _("set"), + clicked_callback = function() + set_time(dt.gui.action_images) + end + } + }, + dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("label"){label = _("synchronize image time")}, + dt.new_widget("section_label"){label = _("calculate difference between images")}, + img_time.diff_entry, + img_time.calc_btn, + dt.new_widget("section_label"){label = _("apply difference")}, + img_time.sdir, + img_time.btn, + }, + dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("label"){label = _("reset to original time")}, + dt.new_widget("separator"){}, + dt.new_widget("button"){ + label = _("reset"), + clicked_callback = function() + reset_time(dt.gui.action_images) + end + } + }, +} + +img_time.mode = dt.new_widget("combobox"){ + label = _("mode"), + tooltip = _("select mode"), + selected = 1, + changed_callback = function(this) + img_time.stack.active = this.selected + end, + _("adjust time"), + _("set time"), + _("synchronize time"), + _("reset time") +} + +img_time.widget = dt.new_widget("box"){ + orientation = "vertical", + reset_callback = function(this) + reset_widgets() + end, + img_time.mode, + img_time.stack, +} + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not img_time.event_registered then + dt.register_event( + "image_time", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + img_time.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/jpg_group_leader.lua b/contrib/jpg_group_leader.lua new file mode 100644 index 00000000..733071ed --- /dev/null +++ b/contrib/jpg_group_leader.lua @@ -0,0 +1,200 @@ +--[[ + + jpg_group_leader.lua - Make jpg image group leader + + Copyright (C) 2024 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + jpg_group_leader - Make jpg image group leader + + After a film roll is imported, check for RAW-JPG image groups + and make the JPG image the group leader. This is on by default + but can be disabled in preferences. + + Shortcuts are included to filter existing collections or + selections of images and make the jpg the group leader. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + None + + USAGE + Start script from script_manager + Assign keys to the shortcuts + + BUGS, COMMENTS, SUGGESTIONS + Bill Ferguson + + CHANGES +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE = "jpg_group_leader" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A P I C H E C K +-- - - - - - - - - - - - - - - - - - - - - - - - + +du.check_min_api_version("7.0.0", MODULE) + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- I 1 8 N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local script_data = {} + +script_data.metadata = { + name = _("JPG group leader"), + purpose = _("make jpg image group leader"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/jpg_group_leader" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- P R E F E R E N C E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.preferences.register(MODULE, "on_import", "bool", _("make jpg group leader on import"), _("automatically make the jpg file the group leader when raw + jpg are imported"), true) + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- N A M E S P A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +local jgloi = {} +jgloi.images = {} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function toggle_global_toolbox_grouping() + dt.gui.libs.global_toolbox.grouping = false + dt.gui.libs.global_toolbox.grouping = true +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- M A I N P R O G R A M +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function make_jpg_group_leader(images) + -- if the image is part of a group, make it the leader + for _, image in ipairs(images) do + if #image:get_group_members() > 1 then + image:make_group_leader() + end + end + if dt.gui.libs.global_toolbox.grouping then + -- toggle the grouping to make the new leader show + toggle_global_toolbox_grouping() + end +end + +local function make_existing_jpg_group_leader(images) + for _, image in ipairs(images) do + if string.lower(df.get_filetype(image.filename)) == "jpg" then + if #image:get_group_members() > 1 then + image:make_group_leader() + end + end + end + if dt.gui.libs.global_toolbox.grouping then + -- toggle the grouping to make the new leader show + toggle_global_toolbox_grouping() + end +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + if dt.preferences.read(MODULE, "on_import", "bool") then + dt.destroy_event(MODULE, "post-import-film") + dt.destroy_event(MODULE, "post-import-image") + end + dt.destroy_event(MODULE .. "_collect", "shortcut") + dt.destroy_event(MODULE .. "_select", "shortcut") +end + +script_data.destroy = destroy + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- E V E N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +if dt.preferences.read(MODULE, "on_import", "bool") then + dt.register_event(MODULE, "post-import-film", + function(event, film_roll) + -- ignore the film roll, it contains all the images, not just the imported + local images = jgloi.images + if #images > 0 then + jgloi.images = {} + make_jpg_group_leader(images) + end + end + ) + + dt.register_event(MODULE, "post-import-image", + function(event, image) + if string.lower(df.get_filetype(image.filename)) == "jpg" then + table.insert(jgloi.images, image) + end + end + ) +end + +dt.register_event(MODULE .. "_collect", "shortcut", + function(event, shortcut) + -- ignore the film roll, it contains all the images, not just the imported + local images = dt.collection + make_existing_jpg_group_leader(images) + end, + _("make jpg group leader for collection") +) + +dt.register_event(MODULE .. "_select", "shortcut", + function(event, shortcut) + local images = dt.gui.selection() + make_existing_jpg_group_leader(images) + end, + _("make jpg group leader for selection") +) + +return script_data \ No newline at end of file diff --git a/contrib/kml_export.lua b/contrib/kml_export.lua index 279ad769..561724fa 100644 --- a/contrib/kml_export.lua +++ b/contrib/kml_export.lua @@ -39,21 +39,34 @@ local df = require "lib/dtutils.file" local ds = require "lib/dtutils.string" local dsys = require "lib/dtutils.system" -local gettext = dt.gettext +local gettext = dt.gettext.gettext local PS = dt.configuration.running_os == "windows" and "\\" or "/" -du.check_min_api_version("5.0.0", kml_export) - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("kml_export",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "kml_export") local function _(msgid) - return gettext.dgettext("kml_export", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("kml export"), + purpose = _("export KML/KMZ data to a file"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/kml_export" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local function show_status(storage, image, format, filename, number, total, high_quality, extra_data) - dt.print(string.format(_("Export Image %i/%i"), number, total)) + dt.print(string.format(_("export image %i/%i"), number, total)) end -- Add duplicate index to filename @@ -80,12 +93,12 @@ local function create_kml_file(storage, image_table, extra_data) end if not df.check_if_bin_exists(magickPath) then - dt.print_error(_("magick not found")) + dt.print_error("magick not found") return end if dt.configuration.running_os == "linux" then if not df.check_if_bin_exists("xdg-user-dir") then - dt.print_error(_("xdg-user-dir not found")) + dt.print_error("xdg-user-dir not found") return end end @@ -95,7 +108,7 @@ local function create_kml_file(storage, image_table, extra_data) if ( dt.preferences.read("kml_export","CreateKMZ","bool") == true and dt.configuration.running_os == "linux") then if not df.check_if_bin_exists("zip") then - dt.print_error(_("zip not found")) + dt.print_error("zip not found") return end exportDirectory = dt.configuration.tmp_dir @@ -301,20 +314,24 @@ local function create_kml_file(storage, image_table, extra_data) end +local function destroy() + dt.destroy_storage("kml_export") +end + -- Preferences if dt.configuration.running_os == "windows" then dt.preferences.register("kml_export", "OpenKmlFile", "bool", _("KML export: Open KML file after export"), - _("Opens the KML file after the export with the standard program for KML files"), + _("opens the KML file after the export with the standard program for KML files"), false ) else dt.preferences.register("kml_export", "OpenKmlFile", "bool", - _("KML export: Open KML/KMZ file after export"), - _("Opens the KML file after the export with the standard program for KML files"), + _("KML export: open KML/KMZ file after export"), + _("opens the KML file after the export with the standard program for KML files"), false ) end @@ -322,7 +339,7 @@ local defaultDir = '' if dt.configuration.running_os == "windows" then defaultDir = os.getenv("USERPROFILE") elseif dt.configuration.running_os == "macos" then - defaultDir = os.getenv("home") + defaultDir = os.getenv("HOME") else local handle = io.popen("xdg-user-dir DESKTOP") defaultDir = handle:read() @@ -333,23 +350,23 @@ end dt.preferences.register("kml_export", "ExportDirectory", "directory", - _("KML export: Export directory"), - _("A directory that will be used to export the KML/KMZ files"), + _("KML export: export directory"), + _("a directory that will be used to export the KML/KMZ files"), defaultDir ) if dt.configuration.running_os ~= "linux" then dt.preferences.register("kml_export", "magickPath", -- name "file", -- type - _("KML export: ImageMagick binary Location"), -- label - _("Install location of magick[.exe]. Requires restart to take effect."), -- tooltip + _("KML export: ImageMagick binary location"), -- label + _("install location of magick[.exe], requires restart to take effect"), -- tooltip "magick") -- default end dt.preferences.register("kml_export", "CreatePath", "bool", - _("KML export: Connect images with path"), + _("KML export: connect images with path"), _("connect all images with a path"), false ) @@ -357,17 +374,21 @@ if dt.configuration.running_os == "linux" then dt.preferences.register("kml_export", "CreateKMZ", "bool", - _("KML export: Create KMZ file"), - _("Compress all imeges to one KMZ file"), + _("KML export: create KMZ file"), + _("compress all imeges to one KMZ file"), true ) end -- Register if dt.configuration.running_os == "windows" then - dt.register_storage("kml_export", _("KML Export"), nil, create_kml_file) + dt.register_storage("kml_export", _("KML export"), nil, create_kml_file) else - dt.register_storage("kml_export", _("KML/KMZ Export"), nil, create_kml_file) + dt.register_storage("kml_export", _("KML/KMZ export"), nil, create_kml_file) end +script_data.destroy = destroy + +return script_data + -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: hl Lua; diff --git a/contrib/passport_guide.lua b/contrib/passport_guide.lua index 72611ebd..34e9fc79 100644 --- a/contrib/passport_guide.lua +++ b/contrib/passport_guide.lua @@ -20,7 +20,7 @@ --[[ PASSPORT CROPPING GUIDE guides for cropping passport photos based on documents from the Finnish police -(https://www.poliisi.fi/instancedata/prime_product_julkaisu/intermin/embeds/poliisiwwwstructure/38462_Passikuvaohje_EN.pdf) describing passport photo dimensions of 47x36 mm and 500x653 px for digital biometric data stored in passports. They use ISO 19794-5 standard based on ICAO 9303 regulations which should also be compliant for all of Europe. +(https://poliisi.fi/documents/25235045/31329600/Passport-photograph-instructions-by-the-police-2020-EN-fixed.pdf/1eec2f4c-aed7-68e0-c112-0a8f25e0328d/Passport-photograph-instructions-by-the-police-2020-EN-fixed.pdf) describing passport photo dimensions of 47x36 mm and 500x653 px for digital biometric data stored in passports. They use ISO 19794-5 standard based on ICAO 9303 regulations which should also be compliant for all of Europe. INSTALLATION * copy this file in $CONFIGDIR/lua/ where CONFIGDIR is your darktable configuration directory @@ -37,17 +37,28 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" -local gettext = dt.gettext +local gettext = dt.gettext.gettext du.check_min_api_version("2.0.0", "passport_guide") --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("passport_guide",dt.configuration.config_dir.."/lua/locale/") - local function _(msgid) - return gettext.dgettext("passport_guide", msgid) + return gettext(msgid) end +local script_data = {} + +script_data.metadata = { + name = _("passport guide"), + purpose = _("guides for cropping passport photos"), + author = "Kåre Hampf", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/passport_guide" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + dt.guides.register_guide("passport", -- draw function(cairo, x, y, width, height, zoom_scale) @@ -91,5 +102,13 @@ function() end ) +local function destroy() + -- nothing to destroy +end + +script_data.destroy = destroy + +return script_data + -- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; hl Lua; -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/contrib/passport_guide_germany.lua b/contrib/passport_guide_germany.lua new file mode 100644 index 00000000..a1b9f618 --- /dev/null +++ b/contrib/passport_guide_germany.lua @@ -0,0 +1,125 @@ +--[[ + German passport photo cropping guide for darktable. + Derived from the passport cropping guide by Kåre Hampf. + + copyright (c) 2017 Kåre Hampf + copyright (c) 2024 Christian Sültrop + + 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 . +]] + +--[[ +PASSPORT CROPPING GUIDE +Guides for cropping passport and ID card ("Personalausweis") photos based on the "Passbild-Schablone" +from the German Federal Ministry of the Interior and Community. +(https://www.bmi.bund.de/SharedDocs/downloads/DE/veroeffentlichungen/themen/moderne-verwaltung/ausweise/passbild-schablone-erwachsene.pdf?__blob=publicationFile&v=3) + +INSTALLATION +* copy this file in $CONFIGDIR/lua/ where CONFIGDIR is your darktable configuration directory +* add the following line in the file $CONFIGDIR/luarc + require "passport_guide_germany" +* (optional) add the line: + "plugins/darkroom/clipping/extra_aspect_ratios/passport 35x45mm=45:35" + to $CONFIGDIR/darktablerc + +USAGE +* when using the cropping tool, select "Passport Photo Germany" as guide and if you added the line in yout rc + select "passport 35x45mm" as aspect +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local gettext = dt.gettext.gettext + +du.check_min_api_version("2.0.0", "passport_guide_germany") + +-- Tell gettext where to find the .mo file translating messages for a particular domain +local function _(msgid) + return gettext(msgid) +end + +local script_data = {} + +script_data.metadata = { + name = _("passport guide Germany"), + purpose = _("guides for cropping passport and ID card (\"Personalausweis\") photos based on the \"Passbild-Schablone\" from the German Federal Ministry of the Interior and Community"), + author = "menschmachine", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/passport_guide_germany" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +dt.guides.register_guide("Passport Photo Germany", +-- draw +function(cairo, x, y, width, height, zoom_scale) + local _width, _height + + -- get the max 35x45 rectangle + local aspect_ratio = 45 / 35 + if width * aspect_ratio > height then + _width = height / aspect_ratio + _height = height + else + _width = width + _height = width * aspect_ratio + end + + cairo:save() + + cairo:translate(x + (width - _width) / 2, y + (height - _height) / 2) + cairo:scale(_width / 35, _height / 45) + + -- the outer rectangle + cairo:rectangle( 0, 0, 35, 45) + + -- Nose position: The nose tip must be between these lines + cairo:draw_line(15.5, 45, 15.5, 13) + cairo:draw_line(35-15.5, 45, 35-15.5, 13) + + -- Face height + -- optimum face height: The upper end of the head should be between these lines + cairo:draw_line(0, 4, 35, 4) + cairo:draw_line(0, 8, 35, 8) + + -- tolerated face height: The upper end of the head must not be below this line + cairo:draw_line(6, 13, 30, 13) + + -- Eye area: The eyes must be between these lines + cairo:draw_line(0, 13, 35, 13) + cairo:draw_line(0, 23, 35, 23) + + -- Cheek line: The cheek must lie on this line + cairo:draw_line(9, 45-5, 27, 45-5) + + cairo:restore() +end, +-- gui +function() + return dt.new_widget("label"){label = _("Passport Photo Germany"), halign = "start"} +end +) + +local function destroy() + -- noting to destroy +end + +script_data.destroy = destroy + +return script_data + +-- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; hl Lua; +-- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/contrib/pdf_slideshow.lua b/contrib/pdf_slideshow.lua index f01b014b..b93ae978 100644 --- a/contrib/pdf_slideshow.lua +++ b/contrib/pdf_slideshow.lua @@ -41,23 +41,35 @@ format (all fields can be the empty string): local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" -require "official/yield" -local gettext = dt.gettext - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("pdf_slideshow",dt.configuration.config_dir.."/lua/locale/") +local gettext = dt.gettext.gettext local function _(msgid) - return gettext.dgettext("pdf_slideshow", msgid) + return gettext(msgid) end if not df.check_if_bin_exists("pdflatex") then - dt.print_error(_("pdflatex not found")) + dt.print_error("pdflatex not found") return end -du.check_min_api_version("4.0.0", "pdf_slideshow") +du.check_min_api_version("7.0.0", "pdf_slideshow") + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("PDF slideshow"), + purpose = _("generates a PDF slideshow (via Latex) containing all selected images one per slide"), + author = "Pascal Obry", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/pdf_slideshow" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them dt.preferences.register ("pdf_slideshow","open with","string", @@ -165,6 +177,10 @@ local function slide(latexfile,i,image,file) my_write(latexfile,"\\end{figure}\n") end +local function destroy() + dt.destroy_storage("pdf_slideshow") +end + dt.register_storage("pdf_slideshow",_("pdf slideshow"), nil, function(storage,image_table) @@ -219,7 +235,7 @@ dt.register_storage("pdf_slideshow",_("pdf slideshow"), local result = dt.control.execute(command) if result ~= 0 then dt.print(_("problem running pdflatex")) -- this one is probably usefull to the user - error(_("problem running ")..command) + error("problem running "..command) end -- open the PDF @@ -229,7 +245,7 @@ dt.register_storage("pdf_slideshow",_("pdf slideshow"), local result = dt.control.execute(command) if result ~= 0 then dt.print(_("problem running pdf viewer")) -- this one is probably usefull to the user - error(_("problem running ")..command) + error("problem running "..command) end -- finally do some clean-up @@ -244,5 +260,8 @@ dt.register_storage("pdf_slideshow",_("pdf slideshow"), nil, widget) +script_data.destroy = destroy + +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/contrib/photils.lua b/contrib/photils.lua new file mode 100644 index 00000000..7bb39c6f --- /dev/null +++ b/contrib/photils.lua @@ -0,0 +1,511 @@ +--[[ photils Auto Tagging plugin + copyright (c) 2020 Tobias Scheck + + 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 . +--]] + +--[[ + A darktable plugin that tries to predict keywords based on the selected image. + This plugin uses photils-cli to handle this task. Photils-cli is an application + that passes the image through a neural network, classifies it, and extracts the + suggested tags. Everything happens offline without the need that your data are + sent over the internet. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + * photils-cli - https://github.com/scheckmedia/photils-cli at the moment only + available for Linux and MacOS + + USAGE + * require this script from your main lua file + To do this add this line to the file .config/darktable/luarc: + require "contrib/photils" + * Select an image + * Press "get tags" + * Select the tags you want from a list of suggestions + * Press "Attach .. Tags" to add the selected tags to your image +--]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local dtsys = require "lib/dtutils.system" + +local MODULE_NAME = "photils" +du.check_min_api_version("7.0.0", MODULE_NAME) + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("photils"), + purpose = _("suggest tags based on image classification"), + author = "Tobias Scheck", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/photils" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +local exporter = dt.new_format("jpeg") +exporter.quality = 80 +exporter.max_height = 224 +exporter.max_width = 224 + +-- helper functions + +local function num_keys(tbl) + local num = 0 + for _ in pairs(tbl) do num = num + 1 end + return num +end + +local function has_key(tbl, value) + for k, _ in pairs(tbl) do + if k == value then + return true + end + end + + return false +end + +local photils_installed = df.check_if_bin_exists("photils-cli") + +--[[ + local state object + + maybe per_page is a preference variable but I think 10 + is a good value for the ui +]] +local PHOTILS = { + tags = {}, + confidences = {}, + page = 1, + per_page = 10, + selected_tags = {}, + in_pagination = false, + tagged_image = "", + module_installed = false, + event_registered = false, + plugin_display_views = { + [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}, + [dt.gui.views.darkroom] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER", 100} + }, +} + +local GUI = { + container = dt.new_widget("box") { + orientation = "vertical", + sensitive = true, + dt.new_widget("button") { + label = _("get tags"), + sensitive = photils_installed, + clicked_callback = function() PHOTILS.on_tags_clicked() end + }, + reset_callback = function() PHOTILS.on_reset(true) end + }, + stack = dt.new_widget("stack"), + prev_button = dt.new_widget("button") { + label = "<", + sensitive = false, + clicked_callback = function() + PHOTILS.page = PHOTILS.page - 1 + PHOTILS.paginate() + end + }, + next_button = dt.new_widget("button") { + label = ">", + sensitive = false, + clicked_callback = function() + PHOTILS.page = PHOTILS.page + 1 + PHOTILS.paginate() + end + }, + tag_box = dt.new_widget("box") {orientation = "vertical"}, + tag_view = dt.new_widget("box") {orientation = "vertical"}, + page_label = dt.new_widget("label") {label = ""}, + error_view = dt.new_widget("box") {orientation = "vertical"}, + warning_label = dt.new_widget("label") { + label = "" + }, + restart_required_label = dt.new_widget("label") { + label = _("requires a restart to be applied") + }, + attach_button = dt.new_widget("button") { + label = "", + sensitive = false, + clicked_callback = function(self) PHOTILS.attach_tags() end + }, + confidence_slider = dt.new_widget("slider") { + step = 1, + digits = 0, + value = 90, + hard_max = 100, + hard_min = 0, + soft_max = 100, + soft_min = 0, + label = _("min confidence value") + }, + warning = dt.new_widget("label") +} + +function PHOTILS.image_changed() + local current_image = tostring(dt.gui.selection()[1]) + if current_image ~= PHOTILS.tagged_image then + if PHOTILS.tagged_image ~= "" then + PHOTILS.tagged_image_has_changed() + end + + PHOTILS.tagged_image = tostring(current_image) + end +end + +function PHOTILS.tagged_image_has_changed() + GUI.warning.label = _("the suggested tags were not generated\n for the currently selected image!") +end + +function PHOTILS.paginate() + PHOTILS.in_pagination = true + local num_pages = math.ceil(#PHOTILS.tags / PHOTILS.per_page) + GUI.page_label.label = string.format(_(" page %s of %s "), PHOTILS.page, + num_pages) + + if PHOTILS.page <= 1 then + PHOTILS.page = 1 + GUI.prev_button.sensitive = false + else + GUI.prev_button.sensitive = true + end + + if PHOTILS.page > num_pages - 1 then + PHOTILS.page = num_pages + GUI.next_button.sensitive = false + else + GUI.next_button.sensitive = true + end + + --[[ + calculates the start positon in the tag array based on the current page + and takes N tags from that array to show these in darktable + e.g. page 1 goes from 1 to 10, page 2 from 11 to 20 a.s.o. + the paginaton approach is related to a problem with the dynamic addition + of mutliple widgets https://github.com/darktable-org/darktable/issues/4934#event-3318100463 + ]]-- + local offset = ((PHOTILS.page - 1) * PHOTILS.per_page) + 1 + local tag_index = 1 + for i = offset, offset + PHOTILS.per_page - 1, 1 do + local tag = PHOTILS.tags[i] + local conf = PHOTILS.confidences[i] + + GUI.tag_box[tag_index].value = has_key(PHOTILS.selected_tags, tag) + + if tag then + if dt.preferences.read(MODULE_NAME, "show_confidence", "bool") then + tag = tag .. string.format(" (%.3f)", conf) + end + + GUI.tag_box[tag_index].label = tag + GUI.tag_box[tag_index].sensitive = true + else + GUI.tag_box[tag_index].label = "" + GUI.tag_box[tag_index].sensitive = false + end + tag_index = tag_index + 1 + end + + PHOTILS.in_pagination = false +end + +function PHOTILS.attach_tags() + local num_selected = #dt.gui.selection() + local job = dt.gui.create_job(_("apply tag to image"), true) + + for i = 1, num_selected, 1 do + local image = dt.gui.selection()[i] + for tag, _ in pairs(PHOTILS.selected_tags) do + local dt_tag = dt.tags.create(tag) + dt.tags.attach(dt_tag, image) + end + + job.percent = i / num_selected + end + + dt.print(_("tags successfully attached to image")) + job.valid = false +end + +function PHOTILS.get_tags(image, with_export) + + local tmp_file = df.create_tmp_file() + local in_arg = df.sanitize_filename(tostring(image)) + local out_arg = df.sanitize_filename(tmp_file) + local executable = photils_installed + + if dt.configuration.running_os == "macos" then + executable = executable .. "/Contents/MacOS/photils-cli" + end + + if with_export then + dt.print_log("use export to for prediction") + local export_file = df.create_tmp_file() + exporter:write_image(image, export_file) + in_arg = df.sanitize_filename(tostring(export_file)) + end + + local command = executable .. " -c " .. " -i " .. in_arg .. " -o " .. out_arg + + local ret = dtsys.external_command(command) + if ret > 0 then + dt.print_error(string.format("command %s returned error code %d", command, ret)) + os.remove(tmp_file) + + -- try to export the image and run tagging + if not with_export then + return PHOTILS.get_tags(image, true) + end + + return false + end + + for i = #PHOTILS.tags, 1, -1 do + PHOTILS.tags[i] = nil + PHOTILS.confidences[i] = nil + end + + for tag in io.lines(tmp_file) do + local splitted = du.split(tag, ":") + if 100 * tonumber(splitted[2]) >= GUI.confidence_slider.value then + PHOTILS.tags[#PHOTILS.tags + 1] = splitted[1] + PHOTILS.confidences[#PHOTILS.confidences+1] = splitted[2] + end + end + + dt.print(string.format(_("%s found %d tags for your image"), MODULE_NAME, + #PHOTILS.tags)) + os.remove(tmp_file) + + return true +end + +function PHOTILS.on_tags_clicked() + PHOTILS.page = 1 + GUI.warning.label = "" + + PHOTILS.on_reset(false) + + local images = dt.gui.selection() + + if #images == 0 then + dt.print(_("no image selected.")) + dt.control.sleep(2000) + else + if #images > 1 then + dt.print(_("this plugin can only handle a single image.")) + dt.gui.selection({images[1]}) + dt.control.sleep(2000) + end + + with_export = dt.preferences.read(MODULE_NAME, "export_image_before_for_tags", "bool") + if not PHOTILS.get_tags(images[1], with_export) then + local msg = string.format(_("%s failed, see terminal output for details"), MODULE_NAME) + GUI.warning_label.label = msg + GUI.stack.active = GUI.error_view + dt.print(msg) + return + end + + if #PHOTILS.tags == 0 then + local msg = string.format(_("no tags were found"), MODULE_NAME) + GUI.warning_label.label = msg + GUI.stack.active = GUI.error_view + return + end + + GUI.stack.active = GUI.tag_view + PHOTILS.paginate() + end +end + +function PHOTILS.tag_selected(tag_button) + if PHOTILS.in_pagination then return end + + if tag_button.value then + local tag = tag_button.label + if dt.preferences.read(MODULE_NAME, "show_confidence", "bool") then + local idx = string.find(tag, "%(") - 2 + tag = string.sub(tag, 0, idx) + end + + PHOTILS.selected_tags[tag] = tag + else + PHOTILS.selected_tags[tag_button.label] = nil + end + + local num_selected = num_keys(PHOTILS.selected_tags) + if num_selected == 0 then + GUI.attach_button.label = "" + GUI.attach_button.sensitive = false + else + GUI.attach_button.label = string.format(_("attach %d tags"), + num_selected) + GUI.attach_button.sensitive = true + end +end + +function PHOTILS.on_reset(with_view) + if with_view then GUI.stack.active = 1 end + + for k, _ in pairs(PHOTILS.selected_tags) do + PHOTILS.selected_tags[k] = nil + end + + for _, v in ipairs(GUI.tag_box) do + v.value = false + end + + GUI.attach_button.label = "" + GUI.attach_button.sensitive = false +end + +local function install_module() + if not PHOTILS.module_installed then + dt.register_lib(MODULE_NAME, + _("photils auto-tagger"), + true, + true, + PHOTILS.plugin_display_views, + GUI.container, + nil, + nil + ) + PHOTILS.module_installed = true + end +end + +local function destroy() + dt.gui.libs[MODULE_NAME].visible = false + dt.destroy_event("photils", "mouse-over-image-changed") +end + +local function restart() + dt.gui.libs[MODULE_NAME].visible = true + dt.register_event("photils", "mouse-over-image-changed", + PHOTILS.image_changed) +end + +local function show() + dt.gui.libs[MODULE_NAME].visible = true +end + + +-- add a fix number of buttons +for _ = 1, PHOTILS.per_page, 1 do + local btn_tag = dt.new_widget("check_button") { + label = "", + sensitive = false, + clicked_callback = PHOTILS.tag_selected + } + + table.insert(GUI.tag_box, btn_tag) +end + +if not photils_installed then + GUI.warning_label.label = _("photils-cli not found") + dt.print_log("photils-cli not found") +else + GUI.warning_label.label = _("select an image, click \"get tags\" and get \nsuggestions for tags.") +end + +GUI.pagination = dt.new_widget("box") { + orientation = "horizontal", + GUI.prev_button, + GUI.page_label, + GUI.next_button +} + + +table.insert(GUI.error_view, GUI.warning_label) +if not photils_installed then + table.insert(GUI.error_view, df.executable_path_widget({"photils-cli"})) + table.insert(GUI.error_view, GUI.restart_required_label) +end +table.insert(GUI.stack, GUI.error_view) +table.insert(GUI.stack, GUI.tag_view) + +table.insert(GUI.tag_view, GUI.pagination) +table.insert(GUI.tag_view, GUI.tag_box) +table.insert(GUI.tag_view, GUI.attach_button) +table.insert(GUI.tag_view, GUI.warning) + +table.insert(GUI.container, GUI.confidence_slider) +table.insert(GUI.container, GUI.stack) + +GUI.stack.active = 1 + + + +-- uses photils: prefix because script settings are all together and not seperated by script +dt.preferences.register(MODULE_NAME, + "show_confidence", + "bool", + _("photils: show confidence value"), + _("if enabled, the confidence value for each tag is displayed"), + true) + +dt.preferences.register(MODULE_NAME, + "export_image_before_for_tags", + "bool", + _("photils: use exported image for tag request"), + _("if enabled, the image passed to photils for tag suggestion is based on the exported, already edited image. " .. + "otherwise, the embedded thumbnail of the RAW file will be used for tag suggestion." .. + "the embedded thumbnail could speedup the tag suggestion but can fail if the RAW file is not supported."), + true) + +dt.register_event("photils", "mouse-over-image-changed", + PHOTILS.image_changed) + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not PHOTILS.event_registered then + dt.register_event( + "photils", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + PHOTILS.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = show + +return script_data diff --git a/contrib/quicktag.lua b/contrib/quicktag.lua index 31a4b790..c218f09c 100644 --- a/contrib/quicktag.lua +++ b/contrib/quicktag.lua @@ -47,18 +47,34 @@ local dt = require "darktable" local du = require "lib/dtutils" local debug = require "darktable.debug" +du.check_min_api_version("7.0.0", "quicktag") -local gettext = dt.gettext - -du.check_min_api_version("3.0.0", "quicktag") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("quicktag",dt.configuration.config_dir.."/lua/locale/") +local gettext = dt.gettext.gettext local function _(msgid) - return gettext.dgettext("quicktag", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("quick tag"), + purpose = _("use buttons to quickly apply tags assigned to them"), + author = "Christian Kanzian", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/quicktag" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again + +local qt = {} +qt.module_installed = false +qt.event_registered = false +qt.widget_table = {} + -- maximum length of button labels dt.preferences.register("quickTag", "labellength", @@ -156,7 +172,7 @@ abbrevate_tags(quicktag_table) local button = {} -- function to create buttons with tags as labels -for j=1,qnr do +for j = 1, qnr do button[#button+1] = dt.new_widget("button") { label = j..": "..quicktag_table[j], clicked_callback = function() tagattach(tostring(quicktag_table[j]),j) end} @@ -177,12 +193,56 @@ local function update_quicktag_list() end end +local function install_module() + if not qt.module_installed then + dt.register_lib( + "quicktag", -- Module name + _("quick tag"), -- name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 490}}, + + dt.new_widget("box"){ + orientation = "vertical", + table.unpack(qt.widget_table), + + }, + nil,-- view_enter + nil -- view_leave + ) + qt.module_installed = true + end +end + +local function destroy() + dt.gui.libs["quicktag"].visible = false + for i=1,qnr do + dt.destroy_event("quicktag " .. tostring(i), "shortcut") + end +end + +local function restart() + dt.gui.libs["quicktag"].visible = true + for i = 1 ,qnr do + dt.register_event("quicktag", "shortcut", + function(event, shortcut) tagattach(tostring(quicktag_table[i])) end, + string.format(_("quicktag %i"),i)) + end +end + +local function show() + dt.gui.libs["quicktag"].visible = true +end + + + + update_quicktag_list() local new_quicktag = dt.new_widget("entry"){ text = "", placeholder = _("new tag"), - is_password = true, + is_password = false, editable = true, tooltip = _("enter your tag here") } @@ -213,40 +273,46 @@ local new_qt_widget = dt.new_widget ("box") { -- back UI elements in a table -- thanks to wpferguson for the hint -local widget_table = {} for i=1,qnr do - widget_table[#widget_table + 1] = button[i] + qt.widget_table[#qt.widget_table + 1] = button[i] end -widget_table[#widget_table + 1] = dt.new_widget("separator"){} -widget_table[#widget_table + 1] = old_quicktag -widget_table[#widget_table + 1] = new_qt_widget +qt.widget_table[#qt.widget_table + 1] = dt.new_widget("separator"){} +qt.widget_table[#qt.widget_table + 1] = old_quicktag +qt.widget_table[#qt.widget_table + 1] = new_qt_widget --create module -dt.register_lib( - "quicktag", -- Module name - "quicktag", -- name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 490}}, - - dt.new_widget("box"){ - orientation = "vertical", - table.unpack(widget_table), - - }, - nil,-- view_enter - nil -- view_leave -) +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not qt.event_registered then + dt.register_event( + "quicktag", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + qt.event_registered = true + end +end -- create shortcuts for i=1,qnr do - dt.register_event("shortcut", + dt.register_event("quicktag " .. tostring(i), "shortcut", function(event, shortcut) tagattach(tostring(quicktag_table[i])) end, - string.format(_("quicktag %i"),i)) + string.format(_("quick tag %i"),i)) end +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = show + +return script_data + -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; diff --git a/contrib/rate_group.lua b/contrib/rate_group.lua index d820d94a..0e9ddb29 100644 --- a/contrib/rate_group.lua +++ b/contrib/rate_group.lua @@ -42,7 +42,29 @@ local dt = require "darktable" local du = require "lib/dtutils" -- added version check -du.check_min_api_version("3.0.0", "rate_group") +du.check_min_api_version("7.0.0", "rate_group") + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("rate group"), + purpose = _("rate all images in a group"), + author = "Dom H (dom@hxy.io)", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rate_group" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them local function apply_rating(rating) local images = dt.gui.action_images @@ -53,36 +75,58 @@ local function apply_rating(rating) end end if rating < 0 then - dt.print("rejecting group(s)") + dt.print(_("rejecting group(s)")) else - dt.print("applying rating " ..rating.. " to group(s)") + dt.print(string.format(_("applying rating %d to group(s)"), rating)) end end -dt.register_event("shortcut",function(event, shortcut) +local function destroy() + dt.destroy_event("rg_reject", "shortcut") + dt.destroy_event("rg0", "shortcut") + dt.destroy_event("rg1", "shortcut") + dt.destroy_event("rg2", "shortcut") + dt.destroy_event("rg3", "shortcut") + dt.destroy_event("rg4", "shortcut") + dt.destroy_event("rg5", "shortcut") +end + +dt.register_event("rg_reject", "shortcut", + function(event, shortcut) apply_rating(-1) -end, "Reject group") +end, _("reject group")) -dt.register_event("shortcut",function(event, shortcut) +dt.register_event("rg0", "shortcut", + function(event, shortcut) apply_rating(0) -end, "Rate group 0") + end, string.format(_("rate group %d"), 0) +) -dt.register_event("shortcut",function(event, shortcut) +dt.register_event("rg1", "shortcut", + function(event, shortcut) apply_rating(1) -end, "Rate group 1") +end, string.format(_("rate group %d"), 1)) -dt.register_event("shortcut",function(event, shortcut) +dt.register_event("rg2", "shortcut", + function(event, shortcut) apply_rating(2) -end, "Rate group 2") +end, string.format(_("rate group %d"), 2)) -dt.register_event("shortcut",function(event, shortcut) +dt.register_event("rg3", "shortcut", + function(event, shortcut) apply_rating(3) -end, "Rate group 3") +end, string.format(_("rate group %d"), 3)) -dt.register_event("shortcut",function(event, shortcut) +dt.register_event("rg4", "shortcut", + function(event, shortcut) apply_rating(4) -end, "Rate group 4") +end, string.format(_("rate group %d"), 4)) -dt.register_event("shortcut",function(event, shortcut) +dt.register_event("rg5", "shortcut", + function(event, shortcut) apply_rating(5) -end, "Rate group 5") +end, string.format(_("rate group %d"), 5)) + +script_data.destroy = destroy + +return script_data diff --git a/contrib/rename-tags.lua b/contrib/rename-tags.lua index a0c70be4..ae77056a 100644 --- a/contrib/rename-tags.lua +++ b/contrib/rename-tags.lua @@ -33,11 +33,38 @@ local du = require "lib/dtutils" local debug = require "darktable.debug" -- check API version -du.check_min_api_version("3.0.0", "rename-tags") +du.check_min_api_version("7.0.0", "rename-tags") +du.deprecated("contrib/rename-tags.lua","darktable release 4.0") + +local gettext = darktable.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("rename tags"), + purpose = _("rename an existing tag"), + author = "Sebastian Witt (se.witt@gmx.net)", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rename-tags" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local rt = {} +rt.module_installed = false +rt.event_registered = false -- GUI entries -local old_tag = darktable.new_widget("entry") { tooltip = "Enter old tag" } -local new_tag = darktable.new_widget("entry") { tooltip = "Enter new tag" } +local old_tag = darktable.new_widget("entry") { tooltip = _("enter old tag") } +local new_tag = darktable.new_widget("entry") { tooltip = _("enter new tag") } local function rename_reset() old_tag.text = '' @@ -48,11 +75,11 @@ end local function rename_tags() -- If entries are empty, return if old_tag.text == '' then - darktable.print ("Old tag can't be empty") + darktable.print (_("old tag can't be empty")) return end if new_tag.text == '' then - darktable.print ("New tag can't be empty") + darktable.print (_("new tag can't be empty")) return end @@ -62,12 +89,12 @@ local function rename_tags() local ot = darktable.tags.find (old_tag.text) if not ot then - darktable.print ("Old tag does not exist") + darktable.print (_("old tag does not exist")) return end -- Show job - local job = darktable.gui.create_job ("Renaming tag", true) + local job = darktable.gui.create_job (_("renaming tag"), true) old_tag.editable = false new_tag.editable = false @@ -90,7 +117,7 @@ local function rename_tags() darktable.tags.delete (ot) job.valid = false - darktable.print ("Renamed tags for " .. count .. " images") + darktable.print (string.format(_("renamed tags for %d images"), count)) old_tag.editable = true new_tag.editable = true @@ -99,27 +126,63 @@ local function rename_tags() rename_reset() end +local function install_module() + if not rt.module_installed then + darktable.register_lib ("rename_tags", _("rename tag"), true, true, {[darktable.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 20},}, rt.rename_widget, nil, nil) + rt.module_installed = true + end +end + +local function destroy() + darktable.gui.libs["rename_tags"].visible = false +end + +local function restart() + darktable.gui.libs["rename_tags"].visible = true +end + -- GUI local old_widget = darktable.new_widget ("box") { orientation = "horizontal", - darktable.new_widget("label") { label = "Old tag" }, + darktable.new_widget("label") { label = _("old tag") }, old_tag } local new_widget = darktable.new_widget ("box") { orientation = "horizontal", - darktable.new_widget("label") { label = "New tag" }, + darktable.new_widget("label") { label = _("new tag") }, new_tag } -local rename_widget = darktable.new_widget ("box") { +rt.rename_widget = darktable.new_widget ("box") { orientation = "vertical", reset_callback = rename_reset, old_widget, new_widget, - darktable.new_widget("button") { label = "Go", clicked_callback = rename_tags } + darktable.new_widget("button") { label = _("go"), clicked_callback = rename_tags } } +if darktable.gui.current_view().id == "lighttable" then + install_module() +else + if not rt.event_registered then + darktable.register_event( + "rename_tags", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + rt.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data -darktable.register_lib ("rename_tags", "rename tag", true, true, {[darktable.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 20},}, rename_widget, nil, nil) diff --git a/contrib/rename_images.lua b/contrib/rename_images.lua new file mode 100644 index 00000000..0093c540 --- /dev/null +++ b/contrib/rename_images.lua @@ -0,0 +1,235 @@ +--[[ + + rename.lua - rename image file(s) + + Copyright (C) 2020, 2021 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + rename - rename an image file or files + + This shortcut resets the GPS information to that contained within + the image file. If no GPS info is in the image file, the GPS data + is cleared. + + USAGE + * require this script from your luarc file or start it from script_manager + * select an image or images + * enter a renaming pattern + * click the button to rename the files + + BUGS, COMMENTS, SUGGESTIONS + * Send to Bill Ferguson, wpferguson@gmail.com + + CHANGES + + TODO + * Add pattern builder + * Add new name preview +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local ds = require "lib/dtutils.string" + +du.check_min_api_version("7.0.0", "rename_images") + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- namespace variable +local rename = { + presets = {}, + widgets = {}, +} +rename.module_installed = false +rename.event_registered = false + +-- script_manager integration +local script_data = {} + +script_data.metadata = { + name = _("rename images"), + purpose = _("rename an image file or files"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/rename_images" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE_NAME = "rename_images" +local PS = dt.configuration.running_os == "windows" and "\\" or "/" +local USER = os.getenv("USERNAME") +local HOME = os.getenv(dt.configuration.running_os == "windows" and "HOMEPATH" or "HOME") +local PICTURES = HOME .. PS .. dt.configuration.running_os == "windows" and _("My Pictures") or _("Pictures") +local DESKTOP = HOME .. PS .. "Desktop" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function stop_job(job) + job.valid = false +end + +local function install_module() + if not rename.module_installed then + dt.register_lib( + MODULE_NAME, + _("rename images"), + true, + true, + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER",700}}, + dt.new_widget("box"){ + orientation = "vertical", + rename.widgets.pattern, + rename.widgets.button, + }, + nil, + nil + ) + rename.module_installed = true + end +end + +local function destroy() + dt.gui.libs[MODULE_NAME].visible = false +end + +local function restart() + dt.gui.libs[MODULE_NAME].visible = true +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- M A I N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function do_rename(images) + if #images > 0 then + local first_image = images[1] + local pattern = rename.widgets.pattern.text + dt.preferences.write(MODULE_NAME, "pattern", "string", pattern) + dt.print_log("pattern is " .. pattern) + if string.len(pattern) > 0 then + local datetime = os.date("*t") + + local job = dt.gui.create_job(_("renaming images"), true, stop_job) + for i, image in ipairs(images) do + if job.valid then + job.percent = i / #images + ds.build_substitute_list(image, i, pattern, USER, PICTURES, HOME, DESKTOP) + local new_name = ds.substitute_list(pattern) + if new_name == -1 then + dt.print(_("unable to do variable substitution, exiting...")) + stop_job(job) + return + end + ds.clear_substitute_list() + local args = {} + local path = string.sub(df.get_path(new_name), 1, -2) + if string.len(path) == 0 then + path = image.path + end + local filename = df.get_filename(new_name) + local filmname = image.path + if path ~= image.path then + if not df.check_if_file_exists(df.sanitize_filename(path)) then + df.mkdir(df.sanitize_filename(path)) + end + filmname = path + end + args[1] = dt.films.new(filmname) + args[2] = image + if filename ~= image.filename then + args[3] = filename + end + dt.database.move_image(table.unpack(args)) + end + end + stop_job(job) + local collect_rules = dt.gui.libs.collect.filter() + dt.gui.libs.collect.filter(collect_rules) + dt.gui.views.lighttable.set_image_visible(first_image) + dt.print(string.format(_("renamed %d images"), #images)) + else -- pattern length + dt.print_error("no pattern supplied, returning...") + dt.print(_("please enter the new name or pattern")) + end + else -- image count + dt.print_error("no images selected, returning...") + dt.print(_("please select some images and try again")) + end +end + +local function reset_callback() + rename.widgets.pattern.text = "" +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- W I D G E T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +rename.widgets.pattern = dt.new_widget("entry"){ + tooltip = ds.get_substitution_tooltip(), + placeholder = _("enter pattern") .. "$(FILE_FOLDER)/$(FILE_NAME)", + text = "" +} + +local pattern_pref = dt.preferences.read(MODULE_NAME, "pattern", "string") +if pattern_pref then + rename.widgets.pattern.text = pattern_pref +end + +rename.widgets.button = dt.new_widget("button"){ + label = _("rename"), + clicked_callback = function(this) + do_rename(dt.gui.action_images) + end +} + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not rename.event_registered then + dt.register_event( + "rename_images", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + rename.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/select_non_existing.lua b/contrib/select_non_existing.lua new file mode 100644 index 00000000..b47c7cf6 --- /dev/null +++ b/contrib/select_non_existing.lua @@ -0,0 +1,84 @@ +--[[ + This file is part of darktable, + copyright (c) 2023 Dirk Dittmar + + 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 . +]] +--[[ +Enable selection of non-existing images in the the currently worked on images, e.g. the ones selected by the collection module. +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" + +-- module name +local MODULE = "select_non_existing" + +du.check_min_api_version("9.1.0", MODULE) + +-- figure out the path separator +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +local function stop_job(job) + job.valid = false +end + +local function select_nonexisting_images(event, images) + local selection = {} + + local job = dt.gui.create_job(_("select non existing images"), true, stop_job) + for key,image in ipairs(images) do + if(job.valid) then + job.percent = (key - 1)/#images + local filepath = image.path..PS..image.filename + local file_exists = df.test_file(filepath, "e") + dt.print_log(filepath.." exists? => "..tostring(file_exists)) + if (not file_exists) then + table.insert(selection, image) + end + else + break + end + end + stop_job(job) + + return selection +end + +local function destroy() + dt.gui.libs.select.destroy_selection(MODULE) +end + +dt.gui.libs.select.register_selection( + MODULE, + _("select non existing"), + select_nonexisting_images, + _("select all non-existing images in the current images")) + +local script_data = {} + +script_data.metadata = { + name = _("select non existing"), + purpose = _("enable selection of non-existing images"), + author = "Dirk Dittmar", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/select_non_existing" +} + +script_data.destroy = destroy +return script_data \ No newline at end of file diff --git a/contrib/select_untagged.lua b/contrib/select_untagged.lua index 2db6dae6..0ca4b5d2 100644 --- a/contrib/select_untagged.lua +++ b/contrib/select_untagged.lua @@ -20,38 +20,51 @@ Enable selection of untagged images (darktable|* tags are ignored) local dt = require "darktable" local du = require "lib/dtutils" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "select_untagged") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("select_untagged",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "select_untagged") local function _(msgid) - return gettext.dgettext("select_untagged", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("select untagged"), + purpose = _("enable selection of untagged images"), + author = "Jannis_V", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/select_untagged" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local function stop_job(job) job.valid = false end -local function select_untagged_images() +local function select_untagged_images(event, images) job = dt.gui.create_job(_("select untagged images"), true, stop_job) local selection = {} - for key,image in ipairs(dt.collection) do + for key,image in ipairs(images) do if(job.valid) then - job.percent = (key-1)/#dt.collection + job.percent = (key - 1)/#images local tags = dt.tags.get_tags(image) local hasTags = false for _,tag in ipairs(tags) do - if not string.match(tag.name,"darktable|") then + if not string.match(tag.name, "darktable|") then hasTags = true end end if hasTags == false then - table.insert(selection,image) + table.insert(selection, image) end else break @@ -59,7 +72,19 @@ local function select_untagged_images() end job.valid = false - dt.gui.selection(selection) + -- return table of images to set the selection to + return selection end -dt.gui.libs.select.register_selection(_("select untagged"),select_untagged_images,_("select all images containing no tags or only tags added by darktable")) +local function destroy() + dt.gui.libs.select.destroy_selection("select_untagged") +end + +dt.gui.libs.select.register_selection( + "select_untagged", _("select untagged"), + select_untagged_images, + _("select all images containing no tags or only tags added by darktable")) + +script_data.destroy = destroy + +return script_data diff --git a/contrib/slideshowMusic.lua b/contrib/slideshowMusic.lua index 90d6bc34..bed3da6f 100644 --- a/contrib/slideshowMusic.lua +++ b/contrib/slideshowMusic.lua @@ -27,18 +27,30 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" -require "official/yield" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -du.check_min_api_version("2.0.2", "slideshowMusic") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("slideshowMusic",dt.configuration.config_dir.."/lua/locale/") +du.check_min_api_version("7.0.0", "slideshowMusic") local function _(msgid) - return gettext.dgettext("slideshowMusic", msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("slideshow music"), + purpose = _("play music during a slideshow"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/slideshowMusic" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local function playSlideshowMusic(_, old_view, new_view) local filename, playMusic @@ -46,7 +58,7 @@ local function playSlideshowMusic(_, old_view, new_view) playMusic = dt.preferences.read("slideshowMusic","PlaySlideshowMusic","bool") if not df.check_if_bin_exists("rhythmbox-client") then - dt.print_error(_("rhythmbox-client not found")) + dt.print_error("rhythmbox-client not found") return end @@ -62,19 +74,30 @@ local function playSlideshowMusic(_, old_view, new_view) if (old_view and old_view.id == "slideshow") then stopCommand = "rhythmbox-client --pause" --dt.print_error(stopCommand) - dt.control.execute( stopCommand) + dt.control.execute(stopCommand) end end end end +function destroy() + dt.destroy_event("slideshow_music", "view-changed") + dt.preferences.destroy("slideshowMusic", "SlideshowMusic") + dt.preferences.destroy("slideshowMusic", "PlaySlideshowMusic") +end + -- Preferences -dt.preferences.register("slideshowMusic", "SlideshowMusic", "file", _("Slideshow background music file"), "", "") +dt.preferences.register("slideshowMusic", "SlideshowMusic", "file", _("slideshow background music file"), "", "") dt.preferences.register("slideshowMusic", "PlaySlideshowMusic", "bool", - _("Play slideshow background music"), - _("Plays music with rhythmbox if a slideshow starts"), + _("play slideshow background music"), + _("plays music with rhythmbox if a slideshow starts"), true) -- Register -dt.register_event("view-changed",playSlideshowMusic) +dt.register_event("slideshow_music", "view-changed", + playSlideshowMusic) + +script_data.destroy = destroy + +return script_data diff --git a/contrib/transfer_hierarchy.lua b/contrib/transfer_hierarchy.lua new file mode 100755 index 00000000..dd9c2708 --- /dev/null +++ b/contrib/transfer_hierarchy.lua @@ -0,0 +1,408 @@ +--[[ + TRANSFER HIERARCHY + Allows the moving or copying of images from one directory + tree to another, while preserving the existing hierarchy. + + AUTHOR + August Schwerdfeger (august@schwerdfeger.name) + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + None. + + USAGE + darktable's native operations for moving and copying images in + batches allow only one directory to be specified as the destination + for each batch. Those wanting to move or copy images from a _hierarchy_ + of directories within darktable while preserving the directory structure, + must take the laborious step of performing the operation one individual + directory at a time. + + This module allows the intact moving and copying of whole directory trees. + It was designed for the specific use case of rapidly transferring images + from a customary source (e.g., a staging directory on the local disk) + to a customary destination (e.g., a directory on a NAS device). + + Instructions for operation: + + 1. Select the set of images you want to copy. + + 2. Click the "calculate" button. This will calculate the + lowest directory in the hierarchy that contains every selected + file (i.e., the common prefix of all the images' pathnames), and + write its path into the "existing root" text box. + + 3. If (a) you have specified the "customary source root" and "customary + destination root" preferences, and (b) the selected images are all + contained under the directory specified as the customary source + root, then the "root of destination" text box will also be + automatically filled out. + + For example, suppose that you have specified '/home/user/Staging' + as your customary source root and '/mnt/storage' as your customary + destination root. If all selected images fell under the directory + '/home/user/Staging/2020/Roll0001', the "root of destination" would + be automatically filled out with '/mnt/storage/2020/Roll0001'. + + But if all selected images fall under a directory outside the + specified customary source root (e.g., '/opt/other'), the "root + of destination" text box must be filled out manually. + + It is also possible to edit the "root of destination" further once + it has been automatically filled out. + + 4. Click the "move" or "copy" button. + + Before moving or copying any images, the module will first + replicate the necessary directory hierarchy by creating all + destination directories that do not already exist; should a + directory creation attempt fail, the operation will be + aborted, but any directories already created will not be + removed. + + During the actual move/copy operation, the module transfers an + image by taking its path and replacing the string in the "existing + root" text box with that in the "root of destination" text box + (e.g., '/home/user/Staging/2020/Roll0001/DSC_0001.jpg' would be + transferred to '/mnt/storage/2020/Roll0001/DSC_0001.jpg'). + + LICENSE + LGPLv2+ +]] + + +-- Header material: BEGIN + +local darktable = require("darktable") +local dtutils = require("lib/dtutils") +local dtutils_file = require("lib/dtutils.file") +local dtutils_system = require("lib/dtutils.system") +local gettext = darktable.gettext.gettext + +local LIB_ID = "transfer_hierarchy" +dtutils.check_min_api_version("7.0.0", LIB_ID) + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("transfer hierarchy"), + purpose = _("allows the moving or copying of images from one directory tree to another, while preserving the existing hierarchy"), + author = "August Schwerdfeger (august@schwerdfeger.name)", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contrib/transfer_hierarchy" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local MKDIR_COMMAND = darktable.configuration.running_os == "windows" and "mkdir " or "mkdir -p " +local PATH_SEPARATOR = darktable.configuration.running_os == "windows" and "\\\\" or "/" +local PATH_SEGMENT_REGEX = "(" .. PATH_SEPARATOR .. "?)([^" .. PATH_SEPARATOR .. "]+)" + +unpack = unpack or table.unpack +gmatch = string.gfind or string.gmatch + +-- Header material: END + + + +-- Helper functions: BEGIN + +local th = {} +th.module_installed = false +th.event_registered = false + +local function pathExists(path) + local success, err, errno = os.rename(path, path) + if not success then + if errno == 13 then + return true + end + end + return success, err +end + +local function pathIsDirectory(path) + return pathExists(path..PATH_SEPARATOR) +end + +local function createDirectory(path) + local errorlevel = dtutils_system.external_command(MKDIR_COMMAND .. dtutils_file.sanitize_filename(path)) + if errorlevel == 0 and pathIsDirectory(path) then + return path + else + return nil + end +end + +local function install_module() + if not th.module_installed then + darktable.register_lib(LIB_ID, + _("transfer hierarchy"), true, true, { + [darktable.gui.views.lighttable] = { "DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 700 } + }, th.transfer_widget, nil, nil) + th.module_installed = true + end +end + +-- Helper functions: END + + +-- Widgets and business logic: BEGIN + +local sourceTextBox = darktable.new_widget("entry") { + tooltip = _("lowest directory containing all selected images"), + editable = false + } +sourceTextBox.reset_callback = function() sourceTextBox.text = "" end + +local destinationTextBox = darktable.new_widget("entry") { + text = "" +} +destinationTextBox.reset_callback = function() destinationTextBox.text = "" end + + + + + + + + + +local function findRootPath(films) + local commonSegments = nil + local prefix = "" + for film, _ in pairs(films) do + local path = film.path + if commonSegments == nil then + commonSegments = {} + local firstMatchIndex = string.find(path, PATH_SEGMENT_REGEX) + if firstMatchIndex ~= nil then + prefix = string.sub(path, 1, firstMatchIndex-1) + end + string.gsub(path, PATH_SEGMENT_REGEX, function(w, x) + if w ~= "" then table.insert(commonSegments, w) end + table.insert(commonSegments, x) + end) + else + local matcher = gmatch(path, PATH_SEGMENT_REGEX) + local i = 1 + while i < #commonSegments do + match, match2 = matcher() + if match == nil then + while i <= #commonSegments do + table.remove(commonSegments, #commonSegments) + end + break + elseif match ~= "" then + if commonSegments[i] ~= match then + while i <= #commonSegments do + table.remove(commonSegments, #commonSegments) + end + break + else + i = i+1 + end + end + if match2 == nil or commonSegments[i] ~= match2 then + while i <= #commonSegments do + table.remove(commonSegments, #commonSegments) + end + break + else + i = i+1 + end + end + end + end + if commonSegments == nil then + return prefix + end + if commonSegments[#commonSegments] == PATH_SEPARATOR then + table.remove(commonSegments, #commonSegments) + end + rv = prefix .. table.concat(commonSegments) + return rv +end + +local function calculateRoot() + films = {} + for _,img in ipairs(darktable.gui.action_images) do + films[img.film] = true + end + return findRootPath(films), films +end + +local function doCalculate() + local rootPath = calculateRoot() + if rootPath ~= nil then + sourceTextBox.text = rootPath + local sourceBase = darktable.preferences.read(LIB_ID, "source_base", "directory") + local destBase = darktable.preferences.read(LIB_ID, "destination_base", "directory") + if sourceBase ~= nil and sourceBase ~= "" and + destBase ~= nil and destBase ~= "" and + string.sub(rootPath, 1, #sourceBase) == sourceBase then + destinationTextBox.text = destBase .. string.sub(rootPath, #sourceBase+1) + end + end +end + +local function stopTransfer(transferJob) + transferJob.valid = false +end + +local function doTransfer(transferFunc) + rootPath, films = calculateRoot() + if rootPath ~= sourceTextBox.text then + darktable.print(_("transfer hierarchy: ERROR: existing root is out of sync -- click 'calculate' to update")) + return + end + if destinationTextBox.text == "" then + darktable.print(_("transfer hierarchy: ERROR: destination not specified")) + return + end + local sourceBase = sourceTextBox.text + local destBase = destinationTextBox.text + local destFilms = {} + for film, _ in pairs(films) do + films[film] = destBase .. string.sub(film.path, #sourceBase+1) + if not pathExists(films[film]) then + if createDirectory(films[film]) == nil then + darktable.print(string.format(_("transfer hierarchy: ERROR: could not create directory: %s"), films[film])) + return + end + end + if not pathIsDirectory(films[film]) then + darktable.print(string.format(_("transfer hierarchy: ERROR: not a directory: %s"), films[film])) + return + end + destFilms[film] = darktable.films.new(films[film]) + if destFilms[film] == nil then + darktable.print(string.format(_("transfer hierarchy: ERROR: could not create film: %s"), film.path)) + end + end + + local srcFilms = {} + for _,img in ipairs(darktable.gui.action_images) do + srcFilms[img] = img.film + end + + local job = darktable.gui.create_job(string.format(_("transfer hierarchy (%d image%s)"), #(darktable.gui.action_images), (#(darktable.gui.action_images) == 1 and "" or "s")), true, stopTransfer) + job.percent = 0.0 + local pctIncrement = 1.0 / #(darktable.gui.action_images) + for _,img in ipairs(darktable.gui.action_images) do + if job.valid and img.film == srcFilms[img] then + destFilm = destFilms[img.film] + transferFunc(img, destFilm) + job.percent = job.percent + pctIncrement + end + end + job.valid = false + local filterRules = darktable.gui.libs.collect.filter() + darktable.gui.libs.collect.filter(filterRules) +end + +local function doMove() + doTransfer(darktable.database.move_image) +end + +local function doCopy() + doTransfer(darktable.database.copy_image) +end + +local function destroy() + darktable.gui.libs[LIB_ID].visible = false +end + +local function restart() + darktable.gui.libs[LIB_ID].visible = true +end + + + + + +th.transfer_widget = darktable.new_widget("box") { + orientation = "vertical", + darktable.new_widget("button") { + label = _("calculate"), + clicked_callback = doCalculate + }, + darktable.new_widget("label") { + label = _("existing root"), + halign = "start" + }, + sourceTextBox, + darktable.new_widget("label") { + label = _("root of destination"), + halign = "start" + }, + destinationTextBox, + darktable.new_widget("button") { + label = _("move"), + tooltip = "Move all selected images", + clicked_callback = doMove + }, + darktable.new_widget("button") { + label = _("copy"), + tooltip = _("copy all selected images"), + clicked_callback = doCopy + } +} + +-- Widgets and business logic: END + + + + + + +-- Preferences: BEGIN + +darktable.preferences.register( + LIB_ID, + "source_base", + "string", + "[transfer hierarchy] Customary source root", + "", + "") + +darktable.preferences.register( + LIB_ID, + "destination_base", + "string", + "[transfer hierarchy] Customary destination root", + "", + "") + +-- Preferences: END + +if darktable.gui.current_view().id == "lighttable" then + install_module() +else + if not th.event_registered then + darktable.register_event( + LIB_ID, "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + th.event_registered = true + end +end + + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/ultrahdr.lua b/contrib/ultrahdr.lua new file mode 100644 index 00000000..e5562324 --- /dev/null +++ b/contrib/ultrahdr.lua @@ -0,0 +1,1066 @@ +--[[ + + UltraHDR image generation for darktable + + copyright (c) 2024 Krzysztof Kotowicz + + 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 . + +]] --[[ + +ULTRAHDR +Generate UltraHDR JPEG images from various combinations of source files (SDR, HDR, gain map). + +https://developer.android.com/media/platform/hdr-image-format + +The images are merged using libultrahdr example application (ultrahdr_app). + +ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT +* ultrahdr_app (built using https://github.com/google/libultrahdr/blob/main/docs/building.md instructions) +* exiftool +* ffmpeg + +USAGE +* require this file from your main luarc config file +* set binary tool paths +* Use UltraHDR module to generate UltraHDR images from selection + +]] local dt = require "darktable" +local du = require "lib/dtutils" +local df = require "lib/dtutils.file" +local ds = require "lib/dtutils.string" +local log = require "lib/dtutils.log" +local dtsys = require "lib/dtutils.system" +local dd = require "lib/dtutils.debug" +local gettext = dt.gettext.gettext + +local namespace = "ultrahdr" + +local LOG_LEVEL = log.info + +-- works with darktable API version from 4.8.0 on +du.check_min_api_version("9.3.0", "ultrahdr") + +local function _(msgid) + return gettext(msgid) +end + +local job + +local GUI = { + optionwidgets = { + settings_label = {}, + encoding_variant_combo = {}, + selection_type_combo = {}, + encoding_settings_box = {}, + output_settings_label = {}, + output_settings_box = {}, + output_filepath_label = {}, + output_filepath_widget = {}, + overwrite_on_conflict = {}, + copy_exif = {}, + import_to_darktable = {}, + min_content_boost = {}, + max_content_boost = {}, + hdr_capacity_min = {}, + hdr_capacity_max = {}, + metadata_label = {}, + metadata_box = {}, + edit_executables_button = {}, + executable_path_widget = {}, + quality_widget = {}, + gainmap_downsampling_widget = {}, + target_display_peak_nits_widget = {} + }, + options = {}, + run = {} +} + +local flags = {} +flags.event_registered = false -- keep track of whether we've added an event callback or not +flags.module_installed = false -- keep track of whether the module is module_installed + +local script_data = {} + +script_data.metadata = { + name = _("UltraHDR"), + purpose = _("generate UltraHDR images"), + author = "Krzysztof Kotowicz" +} + +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +local ENCODING_VARIANT_SDR_AND_GAINMAP = 1 +local ENCODING_VARIANT_SDR_AND_HDR = 2 +local ENCODING_VARIANT_SDR_AUTO_GAINMAP = 3 +local ENCODING_VARIANT_HDR_ONLY = 4 + +local SELECTION_TYPE_ONE_STACK = 1 +local SELECTION_TYPE_GROUP_BY_FNAME = 2 + +-- Values are defined in darktable/src/common/colorspaces.h +local DT_COLORSPACE_PQ_P3 = 24 +local DT_COLORSPACE_DISPLAY_P3 = 26 + +-- 1-based position of a colorspace in export profile combobox. +local COLORSPACE_TO_GUI_ACTION = { + [DT_COLORSPACE_PQ_P3] = 9, + [DT_COLORSPACE_DISPLAY_P3] = 11 +} + +local UI_SLEEP_MS = 50 -- How many ms to sleep after UI action. + +local function set_log_level(level) + local old_log_level = log.log_level() + log.log_level(level) + return old_log_level +end + +local function restore_log_level(level) + log.log_level(level) +end + +local function generate_metadata_file(settings) + local old_log_level = set_log_level(LOG_LEVEL) + local metadata_file_fmt = [[--maxContentBoost %f +--minContentBoost %f +--gamma 1.0 +--offsetSdr 0.0 +--offsetHdr 0.0 +--hdrCapacityMin %f +--hdrCapacityMax %f]] + + local filename = df.create_unique_filename(settings.tmpdir .. PS .. "metadata.cfg") + local f, err = io.open(filename, "w+") + if not f then + dt.print(err) + return nil + end + local content = string.format(metadata_file_fmt, settings.metadata.max_content_boost, + settings.metadata.min_content_boost, settings.metadata.hdr_capacity_min, settings.metadata.hdr_capacity_max) + f:write(content) + f:close() + restore_log_level(old_log_level) + return filename +end + +local function save_preferences() + local old_log_level = set_log_level(LOG_LEVEL) + dt.preferences.write(namespace, "encoding_variant", "integer", GUI.optionwidgets.encoding_variant_combo.selected) + dt.preferences.write(namespace, "selection_type", "integer", GUI.optionwidgets.selection_type_combo.selected) + dt.preferences.write(namespace, "output_filepath_pattern", "string", GUI.optionwidgets.output_filepath_widget.text) + dt.preferences.write(namespace, "overwrite_on_conflict", "bool", GUI.optionwidgets.overwrite_on_conflict.value) + dt.preferences.write(namespace, "import_to_darktable", "bool", GUI.optionwidgets.import_to_darktable.value) + dt.preferences.write(namespace, "copy_exif", "bool", GUI.optionwidgets.copy_exif.value) + if GUI.optionwidgets.min_content_boost.value then + dt.preferences.write(namespace, "min_content_boost", "float", GUI.optionwidgets.min_content_boost.value) + dt.preferences.write(namespace, "max_content_boost", "float", GUI.optionwidgets.max_content_boost.value) + dt.preferences.write(namespace, "hdr_capacity_min", "float", GUI.optionwidgets.hdr_capacity_min.value) + dt.preferences.write(namespace, "hdr_capacity_max", "float", GUI.optionwidgets.hdr_capacity_max.value) + end + dt.preferences.write(namespace, "quality", "integer", GUI.optionwidgets.quality_widget.value) + dt.preferences.write(namespace, "gainmap_downsampling", "integer", + GUI.optionwidgets.gainmap_downsampling_widget.value) + dt.preferences.write(namespace, "target_display_peak_nits", "integer", + (GUI.optionwidgets.target_display_peak_nits_widget.value + 0.5) // 1) + restore_log_level(old_log_level) +end + +local function default_to(value, default) + if value == 0 or value == "" then + return default + end + return value +end + +local function load_preferences() + local old_log_level = set_log_level(LOG_LEVEL) + -- Since the option #1 is the default, and empty numeric prefs are 0, we can use math.max + GUI.optionwidgets.encoding_variant_combo.selected = math.max( + dt.preferences.read(namespace, "encoding_variant", "integer"), ENCODING_VARIANT_SDR_AND_GAINMAP) + GUI.optionwidgets.selection_type_combo.selected = math.max( + dt.preferences.read(namespace, "selection_type", "integer"), SELECTION_TYPE_ONE_STACK) + + GUI.optionwidgets.output_filepath_widget.text = default_to(dt.preferences.read(namespace, "output_filepath_pattern", "string"), + "$(FILE_FOLDER)/$(FILE_NAME)_ultrahdr") + GUI.optionwidgets.overwrite_on_conflict.value = dt.preferences.read(namespace, "overwrite_on_conflict", "bool") + GUI.optionwidgets.import_to_darktable.value = dt.preferences.read(namespace, "import_to_darktable", "bool") + GUI.optionwidgets.copy_exif.value = dt.preferences.read(namespace, "copy_exif", "bool") + GUI.optionwidgets.min_content_boost.value = default_to(dt.preferences.read(namespace, "min_content_boost", "float"), + 1.0) + GUI.optionwidgets.max_content_boost.value = default_to(dt.preferences.read(namespace, "max_content_boost", "float"), + 6.0) + GUI.optionwidgets.hdr_capacity_min.value = default_to(dt.preferences.read(namespace, "hdr_capacity_min", "float"), + 1.0) + GUI.optionwidgets.hdr_capacity_max.value = default_to(dt.preferences.read(namespace, "hdr_capacity_max", "float"), + 6.0) + GUI.optionwidgets.quality_widget.value = default_to(dt.preferences.read(namespace, "quality", "integer"), 95) + GUI.optionwidgets.target_display_peak_nits_widget.value = default_to( + dt.preferences.read(namespace, "target_display_peak_nits", "integer"), 10000) + GUI.optionwidgets.gainmap_downsampling_widget.value = default_to( + dt.preferences.read(namespace, "gainmap_downsampling", "integer"), 0) + restore_log_level(old_log_level) +end + +local function set_profile(colorspace) + local set_directly = true + + if set_directly then + -- New method, with hardcoded export profile values. + local old = dt.gui.action("lib/export/profile", 0, "selection", "", "") * -1 + local new = COLORSPACE_TO_GUI_ACTION[colorspace] or colorspace + log.msg(log.debug, string.format("Changing export profile from %d to %d", old, new)) + dt.gui.action("lib/export/profile", 0, "selection", "next", new - old) + dt.control.sleep(UI_SLEEP_MS) + return old + else + -- Old method + return set_combobox("lib/export/profile", 0, "plugins/lighttable/export/icctype", colorspace) + end +end + +-- Changes the combobox selection blindly until a paired config value is set. +-- Workaround for https://github.com/darktable-org/lua-scripts/issues/522 +local function set_combobox(path, instance, config_name, new_config_value) + local old_log_level = set_log_level(LOG_LEVEL) + local pref = dt.preferences.read("darktable", config_name, "integer") + if pref == new_config_value then + return new_config_value + end + + dt.gui.action(path, 0, "selection", "first", 1.0) + dt.control.sleep(UI_SLEEP_MS) + local limit, i = 30, 0 -- in case there is no matching config value in the first n entries of a combobox. + while i < limit do + i = i + 1 + dt.gui.action(path, 0, "selection", "next", 1.0) + dt.control.sleep(UI_SLEEP_MS) + if dt.preferences.read("darktable", config_name, "integer") == new_config_value then + log.msg(log.debug, string.format("Changed %s from %d to %d", config_name, pref, new_config_value)) + return pref + end + end + log.msg(log.error, string.format("Could not change %s from %d to %d", config_name, pref, new_config_value)) + restore_log_level(old_log_level) +end + +local function assert_settings_correct(encoding_variant) + local old_log_level = set_log_level(LOG_LEVEL) + local errors = {} + local settings = { + bin = { + ultrahdr_app = df.check_if_bin_exists("ultrahdr_app"), + exiftool = df.check_if_bin_exists("exiftool"), + ffmpeg = df.check_if_bin_exists("ffmpeg") + }, + overwrite_on_conflict = GUI.optionwidgets.overwrite_on_conflict.value, + output_filepath_pattern = GUI.optionwidgets.output_filepath_widget.text, + import_to_darktable = GUI.optionwidgets.import_to_darktable.value, + copy_exif = GUI.optionwidgets.copy_exif.value, + metadata = { + min_content_boost = GUI.optionwidgets.min_content_boost.value, + max_content_boost = GUI.optionwidgets.max_content_boost.value, + hdr_capacity_min = GUI.optionwidgets.hdr_capacity_min.value, + hdr_capacity_max = GUI.optionwidgets.hdr_capacity_max.value + }, + quality = GUI.optionwidgets.quality_widget.value, + target_display_peak_nits = (GUI.optionwidgets.target_display_peak_nits_widget.value + 0.5) // 1, + downsample = 2 ^ GUI.optionwidgets.gainmap_downsampling_widget.value, + tmpdir = dt.configuration.tmp_dir, + skip_cleanup = false, -- keep temporary files around, for debugging. + force_export = true -- if false, will copy source files instead of exporting if the file extension matches the format expectation. + } + + for k, v in pairs(settings.bin) do + if not v then + table.insert(errors, string.format(_("%s binary not found"), k)) + end + end + + if encoding_variant == ENCODING_VARIANT_SDR_AND_GAINMAP or encoding_variant == ENCODING_VARIANT_SDR_AUTO_GAINMAP then + if settings.metadata.min_content_boost >= settings.metadata.max_content_boost then + table.insert(errors, _("min_content_boost should not be greater than max_content_boost")) + end + if settings.metadata.hdr_capacity_min >= settings.metadata.hdr_capacity_max then + table.insert(errors, _("hdr_capacity_min should not be greater than hdr_capacity_max")) + end + end + restore_log_level(old_log_level) + if #errors > 0 then + return nil, errors + end + return settings, nil +end + +local function get_dimensions(image) + if image.final_width > 0 then + return image.final_width, image.final_height + end + return image.width, image.height +end + +local function get_stacks(images, encoding_variant, selection_type) + local old_log_level = set_log_level(LOG_LEVEL) + local stacks = {} + local primary = "sdr" + local extra + if encoding_variant == ENCODING_VARIANT_SDR_AND_GAINMAP then + extra = "gainmap" + elseif encoding_variant == ENCODING_VARIANT_SDR_AND_HDR then + extra = "hdr" + elseif encoding_variant == ENCODING_VARIANT_SDR_AUTO_GAINMAP then + extra = nil + elseif encoding_variant == ENCODING_VARIANT_HDR_ONLY then + extra = nil + primary = "hdr" + end + + local tags = nil + -- Group images into (primary [,extra]) stacks + -- Assume that the first encountered image from each stack is a primary one, unless it has a tag matching the expected extra_image_type, or has the expected extension + for k, v in pairs(images) do + local is_extra = false + tags = dt.tags.get_tags(v) + for ignore, tag in pairs(tags) do + if extra and tag.name == extra then + is_extra = true + end + end + if extra_image_extension and df.get_filetype(v.filename) == extra_image_extension then + is_extra = true + end + -- We assume every image in the stack is generated from the same source image file + local key + if selection_type == SELECTION_TYPE_GROUP_BY_FNAME then + key = df.chop_filetype(v.path .. PS .. v.filename) + elseif selection_type == SELECTION_TYPE_ONE_STACK then + key = "the_one_and_only" + end + if stacks[key] == nil then + stacks[key] = {} + end + if extra and (is_extra or stacks[key][primary]) then + -- Don't overwrite existing entries + if not stacks[key][extra] then + stacks[key][extra] = v + end + elseif not is_extra then + -- Don't overwrite existing entries + if not stacks[key][primary] then + stacks[key][primary] = v + end + end + end + -- remove invalid stacks + local count = 0 + for k, v in pairs(stacks) do + if extra then + if not v[primary] or not v[extra] then + stacks[k] = nil + else + local sdr_w, sdr_h = get_dimensions(v[primary]) + local extra_w, extra_h = get_dimensions(v[extra]) + if (sdr_w ~= extra_w) or (sdr_h ~= extra_h) then + stacks[k] = nil + end + end + end + if stacks[k] then + count = count + 1 + end + end + restore_log_level(old_log_level) + return stacks, count +end + +local function stop_job(job) + job.valid = false +end + +local function file_size(path) + local f, err = io.open(path, "r") + if not f then + return 0 + end + local size = f:seek("end") + f:close() + return size +end + +local function generate_ultrahdr(encoding_variant, images, settings, step, total_steps) + local old_log_level = set_log_level(LOG_LEVEL) + local total_substeps + local substep = 0 + local best_source_image + local uhdr + local errors = {} + local remove_files = {} + local ok + local cmd + + local function execute_cmd(cmd, errormsg) + log.msg(log.debug, cmd) + local code = dtsys.external_command(cmd) + if errormsg and code > 0 then + table.insert(errors, errormsg) + end + return code == 0 + end + + function update_job_progress() + substep = substep + 1 + if substep > total_substeps then + log.msg(log.debug, + string.format("total_substeps count is too low for encoding_variant %d", encoding_variant)) + end + job.percent = (total_substeps * step + substep) / (total_steps * total_substeps) + end + + function copy_or_export(src_image, dest, format, colorspace, props) + -- Workaround for https://github.com/darktable-org/darktable/issues/17528 + local needs_workaround = dt.configuration.api_version_string == "9.3.0" + if not settings.force_export and df.get_filetype(src_image.filename) == df.get_filetype(dest) and + not src_image.is_altered then + return df.file_copy(src_image.path .. PS .. src_image.filename, dest) + else + local prev = set_profile(colorspace) + if not prev then + return false + end + local exporter = dt.new_format(format) + for k, v in pairs(props) do + exporter[k] = v + end + local ok = exporter:write_image(src_image, dest) + if needs_workaround then + ok = not ok + end + log.msg(log.info, string.format("Exporting %s to %s (format: %s): %s", src_image.filename, dest, format, ok)) + if prev then + set_profile(prev) + end + return ok + end + return true + end + + function cleanup() + if settings.skip_cleanup then + return false + end + for _, v in pairs(remove_files) do + os.remove(v) + end + return false + end + + if encoding_variant == ENCODING_VARIANT_SDR_AND_GAINMAP or encoding_variant == ENCODING_VARIANT_SDR_AUTO_GAINMAP then + total_substeps = 5 + best_source_image = images["sdr"] + -- Export/copy both SDR and gainmap to JPEGs + local sdr = df.create_unique_filename(settings.tmpdir .. PS .. df.chop_filetype(images["sdr"].filename) .. + ".jpg") + table.insert(remove_files, sdr) + ok = copy_or_export(images["sdr"], sdr, "jpeg", DT_COLORSPACE_DISPLAY_P3, { + quality = settings.quality + }) + if not ok then + table.insert(errors, string.format(_("Error exporting %s to %s"), images["sdr"].filename, "jpeg")) + return cleanup(), errors + end + + local gainmap + if encoding_variant == ENCODING_VARIANT_SDR_AUTO_GAINMAP then -- SDR is also a gainmap + gainmap = sdr + else + gainmap = df.create_unique_filename(settings.tmpdir .. PS .. images["gainmap"].filename .. "_gainmap.jpg") + table.insert(remove_files, gainmap) + ok = copy_or_export(images["gainmap"], gainmap, "jpeg", DT_COLORSPACE_DISPLAY_P3, { + quality = settings.quality + }) + if not ok then + table.insert(errors, string.format(_("Error exporting %s to %s"), images["gainmap"].filename, "jpeg")) + return cleanup(), errors + end + end + log.msg(log.debug, string.format("Exported files: %s, %s", sdr, gainmap)) + update_job_progress() + -- Strip EXIFs + table.insert(remove_files, sdr .. ".noexif") + cmd = settings.bin.exiftool .. " -all= " .. df.sanitize_filename(sdr) .. " -o " .. + df.sanitize_filename(sdr .. ".noexif") + if not execute_cmd(cmd, string.format(_("Error stripping EXIF from %s"), sdr)) then + return cleanup(), errors + end + if sdr ~= gainmap then + if not execute_cmd(settings.bin.exiftool .. " -all= " .. df.sanitize_filename(gainmap) .. + " -overwrite_original", string.format(_("Error stripping EXIF from %s"), gainmap)) then + return cleanup(), errors + end + end + update_job_progress() + -- Generate metadata.cfg file + local metadata_file = generate_metadata_file(settings) + table.insert(remove_files, metadata_file) + -- Merge files + uhdr = df.chop_filetype(sdr) .. "_ultrahdr.jpg" + table.insert(remove_files, uhdr) + cmd = settings.bin.ultrahdr_app .. + string.format(" -m 0 -i %s -g %s -L %d -f %s -z %s", df.sanitize_filename(sdr .. ".noexif"), -- -i + df.sanitize_filename(gainmap), -- -g + settings.target_display_peak_nits, -- -L + df.sanitize_filename(metadata_file), -- -f + df.sanitize_filename(uhdr) -- -z + ) + if not execute_cmd(cmd, string.format(_("Error merging UltraHDR to %s"), uhdr)) then + return cleanup(), errors + end + update_job_progress() + -- Copy SDR's EXIF to UltraHDR file + if settings.copy_exif then + -- Restricting tags to EXIF only, to make sure we won't mess up XMP tags (-all>all). + -- This might hapen e.g. when the source files are Adobe gainmap HDRs. + cmd = settings.bin.exiftool .. " -tagsfromfile " .. df.sanitize_filename(sdr) .. " -exif " .. + df.sanitize_filename(uhdr) .. " -overwrite_original -preserve" + if not execute_cmd(cmd, string.format(_("Error adding EXIF to %s"), uhdr)) then + return cleanup(), errors + end + end + update_job_progress() + elseif encoding_variant == ENCODING_VARIANT_SDR_AND_HDR then + total_substeps = 6 + best_source_image = images["sdr"] + -- https://discuss.pixls.us/t/manual-creation-of-ultrahdr-images/45004/20 + -- Step 1: Export HDR to JPEG-XL with DT_COLORSPACE_PQ_P3 + local hdr = df.create_unique_filename(settings.tmpdir .. PS .. df.chop_filetype(images["hdr"].filename) .. + ".jxl") + table.insert(remove_files, hdr) + ok = copy_or_export(images["hdr"], hdr, "jpegxl", DT_COLORSPACE_PQ_P3, { + bpp = 10, + quality = 100, -- lossless + effort = 1 -- we don't care about the size, the file is temporary. + }) + if not ok then + table.insert(errors, string.format(_("Error exporting %s to %s"), images["hdr"].filename, "jxl")) + return cleanup(), errors + end + update_job_progress() + -- Step 2: Export SDR to PNG + local sdr = df.create_unique_filename(settings.tmpdir .. PS .. df.chop_filetype(images["sdr"].filename) .. + ".png") + table.insert(remove_files, sdr) + ok = copy_or_export(images["sdr"], sdr, "png", DT_COLORSPACE_DISPLAY_P3, { + bpp = 8 + }) + if not ok then + table.insert(errors, string.format(_("Error exporting %s to %s"), images["sdr"].filename, "png")) + return cleanup(), errors + end + uhdr = df.chop_filetype(sdr) .. "_ultrahdr.jpg" + table.insert(remove_files, uhdr) + update_job_progress() + -- Step 3: Generate libultrahdr RAW images + local sdr_raw, hdr_raw = sdr .. ".raw", hdr .. ".raw" + table.insert(remove_files, sdr_raw) + table.insert(remove_files, hdr_raw) + local sdr_w, sdr_h = get_dimensions(images["sdr"]) + local resize_cmd = "" + if sdr_h % 2 + sdr_w % 2 > 0 then -- needs resizing to even dimensions. + resize_cmd = string.format(" -vf 'crop=%d:%d:0:0' ", sdr_w - sdr_w % 2, sdr_h - sdr_h % 2) + end + local size_in_px = (sdr_w - sdr_w % 2) * (sdr_h - sdr_h % 2) + cmd = + settings.bin.ffmpeg .. " -i " .. df.sanitize_filename(sdr) .. resize_cmd .. " -pix_fmt rgba -f rawvideo " .. + df.sanitize_filename(sdr_raw) + if not execute_cmd(cmd, string.format(_("Error generating %s"), sdr_raw)) then + return cleanup(), errors + end + cmd = settings.bin.ffmpeg .. " -i " .. df.sanitize_filename(hdr) .. resize_cmd .. + " -pix_fmt p010le -f rawvideo " .. df.sanitize_filename(hdr_raw) + if not execute_cmd(cmd, string.format(_("Error generating %s"), hdr_raw)) then + return cleanup(), errors + end + -- sanity check for file sizes (sometimes dt exports different size images if the files were never opened in darktable view) + if file_size(sdr_raw) ~= size_in_px * 4 or file_size(hdr_raw) ~= size_in_px * 3 then + table.insert(errors, + string.format( + _("Wrong raw image resolution: %s, expected %dx%d. Try opening the image in darktable mode first."), + images["sdr"].filename, sdr_w, sdr_h)) + return cleanup(), errors + end + update_job_progress() + cmd = settings.bin.ultrahdr_app .. + string.format( + " -m 0 -y %s -p %s -a 0 -b 3 -c 1 -C 1 -t 2 -M 0 -q %d -Q %d -L %d -D 1 -s %d -w %d -h %d -z %s", + df.sanitize_filename(sdr_raw), -- -y + df.sanitize_filename(hdr_raw), -- -p + settings.quality, -- -q + settings.quality, -- -Q + settings.target_display_peak_nits, -- -L + settings.downsample, -- -s + sdr_w - sdr_w % 2, -- w + sdr_h - sdr_h % 2, -- h + df.sanitize_filename(uhdr) -- z + ) + if not execute_cmd(cmd, string.format(_("Error merging %s"), uhdr)) then + return cleanup(), errors + end + update_job_progress() + if settings.copy_exif then + -- Restricting tags to EXIF only, to make sure we won't mess up XMP tags (-all>all). + -- This might hapen e.g. when the source files are Adobe gainmap HDRs. + cmd = settings.bin.exiftool .. " -tagsfromfile " .. df.sanitize_filename(sdr) .. " -exif " .. + df.sanitize_filename(uhdr) .. " -overwrite_original -preserve" + if not execute_cmd(cmd, string.format(_("Error adding EXIF to %s"), uhdr)) then + return cleanup(), errors + end + end + update_job_progress() + elseif encoding_variant == ENCODING_VARIANT_HDR_ONLY then + total_substeps = 5 + best_source_image = images["hdr"] + -- TODO: Check if exporting to JXL would be ok too. + -- Step 1: Export HDR to JPEG-XL with DT_COLORSPACE_PQ_P3 + local hdr = df.create_unique_filename(settings.tmpdir .. PS .. df.chop_filetype(images["hdr"].filename) .. + ".jxl") + table.insert(remove_files, hdr) + ok = copy_or_export(images["hdr"], hdr, "jpegxl", DT_COLORSPACE_PQ_P3, { + bpp = 10, + quality = 100, -- lossless + effort = 1 -- we don't care about the size, the file is temporary. + }) + if not ok then + table.insert(errors, string.format(_("Error exporting %s to %s"), images["hdr"].filename, "jxl")) + return cleanup(), errors + end + update_job_progress() + -- Step 1: Generate raw HDR image + local hdr_raw = df.create_unique_filename(settings.tmpdir .. PS .. df.chop_filetype(images["hdr"].filename) .. + ".raw") + table.insert(remove_files, hdr_raw) + local hdr_w, hdr_h = get_dimensions(images["hdr"]) + local resize_cmd = "" + if hdr_h % 2 + hdr_w % 2 > 0 then -- needs resizing to even dimensions. + resize_cmd = string.format(" -vf 'crop=%d:%d:0:0' ", hdr_w - hdr_w % 2, hdr_h - hdr_h % 2) + end + local size_in_px = (hdr_w - hdr_w % 2) * (hdr_h - hdr_h % 2) + cmd = settings.bin.ffmpeg .. " -i " .. df.sanitize_filename(hdr) .. resize_cmd .. + " -pix_fmt p010le -f rawvideo " .. df.sanitize_filename(hdr_raw) + if not execute_cmd(cmd, string.format(_("Error generating %s"), hdr_raw)) then + return cleanup(), errors + end + if file_size(hdr_raw) ~= size_in_px * 3 then + table.insert(errors, + string.format( + _("Wrong raw image resolution: %s, expected %dx%d. Try opening the image in darktable mode first."), + images["hdr"].filename, hdr_w, hdr_h)) + return cleanup(), errors + end + update_job_progress() + uhdr = df.chop_filetype(hdr_raw) .. "_ultrahdr.jpg" + table.insert(remove_files, uhdr) + cmd = settings.bin.ultrahdr_app .. + string.format( + " -m 0 -p %s -a 0 -b 3 -c 1 -C 1 -t 2 -M 0 -q %d -Q %d -D 1 -L %d -s %d -w %d -h %d -z %s", + df.sanitize_filename(hdr_raw), -- -p + settings.quality, -- -q + settings.quality, -- -Q + settings.target_display_peak_nits, -- -L + settings.downsample, -- s + hdr_w - hdr_w % 2, -- -w + hdr_h - hdr_h % 2, -- -h + df.sanitize_filename(uhdr) -- -z + ) + if not execute_cmd(cmd, string.format(_("Error merging %s"), uhdr)) then + return cleanup(), errors + end + update_job_progress() + if settings.copy_exif then + -- Restricting tags to EXIF only, to make sure we won't mess up XMP tags (-all>all). + -- This might hapen e.g. when the source files are Adobe gainmap HDRs. + cmd = settings.bin.exiftool .. " -tagsfromfile " .. df.sanitize_filename(hdr) .. " -exif " .. + df.sanitize_filename(uhdr) .. " -overwrite_original -preserve" + if not execute_cmd(cmd, string.format(_("Error adding EXIF to %s"), uhdr)) then + return cleanup(), errors + end + end + update_job_progress() + end + + local output_file = ds.substitute(best_source_image, step + 1, settings.output_filepath_pattern) .. ".jpg" + if not settings.overwrite_on_conflict then + output_file = df.create_unique_filename(output_file) + end + local output_path = ds.get_path(output_file) + df.mkdir(output_path) + ok = df.file_move(uhdr, output_file) + if not ok then + table.insert(errors, string.format(_("Error generating UltraHDR for %s"), best_source_image.filename)) + return cleanup(), errors + end + if settings.import_to_darktable then + local img = dt.database.import(output_file) + -- Add "ultrahdr" tag to the imported image + local tagnr = dt.tags.find("ultrahdr") + if tagnr == nil then + dt.tags.create("ultrahdr") + tagnr = dt.tags.find("ultrahdr") + end + dt.tags.attach(tagnr, img) + end + cleanup() + update_job_progress() + log.msg(log.info, string.format("Generated %s.", df.get_filename(output_file))) + dt.print(string.format(_("Generated %s."), df.get_filename(output_file))) + restore_log_level(old_log_level) + return true, nil +end + +local function main() + local old_log_level = set_log_level(LOG_LEVEL) + save_preferences() + + local selection_type = GUI.optionwidgets.selection_type_combo.selected + local encoding_variant = GUI.optionwidgets.encoding_variant_combo.selected + log.msg(log.info, string.format("using selection type %d, encoding variant %d", selection_type, encoding_variant)) + + local settings, errors = assert_settings_correct(encoding_variant) + if not settings then + dt.print(string.format(_("Export settings are incorrect, exiting:\n\n- %s"), table.concat(errors, "\n- "))) + return + end + + local stacks, stack_count = get_stacks(dt.gui.selection(), encoding_variant, selection_type) + if stack_count == 0 then + dt.print(string.format(_( + "No image stacks detected.\n\nMake sure that the image pairs have the same widths and heights."), + stack_count)) + return + end + dt.print(string.format(_("Detected %d image stack(s)"), stack_count)) + job = dt.gui.create_job(_("Generating UltraHDR images"), true, stop_job) + local count = 0 + local msg + for i, v in pairs(stacks) do + local ok, errors = generate_ultrahdr(encoding_variant, v, settings, count, stack_count) + if not ok then + dt.print(string.format(_("Generating UltraHDR images failed:\n\n- %s"), table.concat(errors, "\n- "))) + job.valid = false + return + end + count = count + 1 + -- sleep for a short moment to give stop_job callback function a chance to run + dt.control.sleep(10) + end + -- stop job and remove progress_bar from ui, but only if not alreay canceled + if (job.valid) then + job.valid = false + end + + log.msg(log.info, string.format("Generated %d UltraHDR image(s).", count)) + dt.print(string.format(_("Generated %d UltraHDR image(s)."), count)) + restore_log_level(old_log_level) +end + +GUI.optionwidgets.settings_label = dt.new_widget("section_label") { + label = _("UltraHDR settings") +} + +GUI.optionwidgets.output_settings_label = dt.new_widget("section_label") { + label = _("output") +} + +GUI.optionwidgets.output_filepath_label = dt.new_widget("label") { + label = _("file path pattern"), + tooltip = ds.get_substitution_tooltip() +} + +GUI.optionwidgets.output_filepath_widget = dt.new_widget("entry") { + tooltip = ds.get_substitution_tooltip(), + placeholder = _("e.g. $(FILE_FOLDER)/$(FILE_NAME)_ultrahdr") +} + +GUI.optionwidgets.overwrite_on_conflict = dt.new_widget("check_button") { + label = _("overwrite if exists"), + tooltip = _( + "If the output file already exists, overwrite it. If unchecked, a unique filename will be created instead.") +} + +GUI.optionwidgets.import_to_darktable = dt.new_widget("check_button") { + label = _("import UltraHDRs to library"), + tooltip = _("Import UltraHDR images to darktable library after generating, with an 'ultrahdr' tag attached.") +} + +GUI.optionwidgets.copy_exif = dt.new_widget("check_button") { + label = _("copy EXIF data"), + tooltip = _("Copy EXIF data into UltraHDR file(s) from their SDR sources.") +} + +GUI.optionwidgets.output_settings_box = dt.new_widget("box") { + orientation = "vertical", + GUI.optionwidgets.output_settings_label, + GUI.optionwidgets.output_filepath_label, + GUI.optionwidgets.output_filepath_widget, + GUI.optionwidgets.overwrite_on_conflict, + GUI.optionwidgets.import_to_darktable, + GUI.optionwidgets.copy_exif +} + +GUI.optionwidgets.metadata_label = dt.new_widget("label") { + label = _("gain map metadata") +} + +GUI.optionwidgets.min_content_boost = dt.new_widget("slider") { + label = _('min content boost'), + tooltip = _( + 'How much darker an image can get, when shown on an HDR display, relative to the SDR rendition (linear, SDR = 1.0). Also called "GainMapMin". '), + hard_min = 0.9, + hard_max = 10, + soft_min = 0.9, + soft_max = 2, + step = 1, + digits = 1, + reset_callback = function(self) + self.value = 1.0 + end +} +GUI.optionwidgets.max_content_boost = dt.new_widget("slider") { + label = _('max content boost'), + tooltip = _( + 'How much brighter an image can get, when shown on an HDR display, relative to the SDR rendition (linear, SDR = 1.0). Also called "GainMapMax". \n\nMust not be lower than Min content boost'), + hard_min = 1, + hard_max = 10, + soft_min = 2, + soft_max = 10, + step = 1, + digits = 1, + reset_callback = function(self) + self.value = 6.0 + end +} +GUI.optionwidgets.hdr_capacity_min = dt.new_widget("slider") { + label = _('min HDR capacity'), + tooltip = _('Minimum display boost value for which the gain map is applied at all (linear, SDR = 1.0).'), + hard_min = 0.9, + hard_max = 10, + soft_min = 1, + soft_max = 2, + step = 1, + digits = 1, + reset_callback = function(self) + self.value = 1.0 + end +} +GUI.optionwidgets.hdr_capacity_max = dt.new_widget("slider") { + label = _('max HDR capacity'), + tooltip = _('Maximum display boost value for which the gain map is applied completely (linear, SDR = 1.0).'), + hard_min = 1, + hard_max = 10, + soft_min = 2, + soft_max = 10, + digits = 1, + step = 1, + reset_callback = function(self) + self.value = 6.0 + end +} + +GUI.optionwidgets.metadata_box = dt.new_widget("box") { + orientation = "vertical", + GUI.optionwidgets.metadata_label, + GUI.optionwidgets.min_content_boost, + GUI.optionwidgets.max_content_boost, + GUI.optionwidgets.hdr_capacity_min, + GUI.optionwidgets.hdr_capacity_max +} + +GUI.optionwidgets.encoding_variant_combo = dt.new_widget("combobox") { + label = _("each stack contains"), + tooltip = string.format(_([[Select the types of images in each stack. +This will determine the method used to generate UltraHDR. + +- %s: SDR image paired with a gain map image. +- %s: SDR image paired with an HDR image. +- %s: Each stack consists of a single SDR image. Gain maps will be copies of SDR images. +- %s: Each stack consists of a single HDR image. HDR will be tone mapped to SDR. + +By default, the first image in a stack is treated as SDR, and the second one is a gain map/HDR. +You can force the image into a specific stack slot by attaching "hdr" / "gainmap" tags to it. + +For HDR source images, apply a log2(203 nits/10000 nits) = -5.62 EV exposure correction +before generating UltraHDR.]]), _("SDR + gain map"), _("SDR + HDR"), _("SDR only"), _("HDR only")), + selected = 0, + changed_callback = function(self) + GUI.run.sensitive = self.selected and self.selected > 0 + if self.selected == ENCODING_VARIANT_SDR_AND_GAINMAP or self.selected == ENCODING_VARIANT_SDR_AUTO_GAINMAP then + GUI.optionwidgets.metadata_box.visible = true + GUI.optionwidgets.gainmap_downsampling_widget.visible = false + else + GUI.optionwidgets.metadata_box.visible = false + GUI.optionwidgets.gainmap_downsampling_widget.visible = true + end + end, + _("SDR + gain map"), -- ENCODING_VARIANT_SDR_AND_GAINMAP + _("SDR + HDR"), -- ENCODING_VARIANT_SDR_AND_HDR + _("SDR only"), -- ENCODING_VARIANT_SDR_AUTO_GAINMAP + _("HDR only") -- ENCODING_VARIANT_HDR_ONLY +} + +GUI.optionwidgets.selection_type_combo = dt.new_widget("combobox") { + label = _("selection contains"), + tooltip = string.format(_([[Select types of images selected in darktable. +This determines how the plugin groups images into separate stacks (each stack will produce a single UltraHDR image). + +- %s: All selected image(s) belong to one stack. There will be 1 output UltraHDR image. +- %s: Group images into stacks, using the source image path + filename (ignoring extension). + Use this method if the source images for a given stack are darktable duplicates. + +As an added precaution, each image in a stack needs to have the same resolution. +]]), _("one stack"), _("multiple stacks (use filename)")), + selected = 0, + _("one stack"), -- SELECTION_TYPE_ONE_STACK + _("multiple stacks (use filename)") -- SELECTION_TYPE_GROUP_BY_FNAME +} + +GUI.optionwidgets.quality_widget = dt.new_widget("slider") { + label = _('quality'), + tooltip = _('Quality of the output UltraHDR JPEG file'), + hard_min = 0, + hard_max = 100, + soft_min = 0, + soft_max = 100, + step = 1, + digits = 0, + reset_callback = function(self) + self.value = 95 + end +} + +GUI.optionwidgets.target_display_peak_nits_widget = dt.new_widget("slider") { + label = _('target display peak brightness (nits)'), + tooltip = _('Peak brightness of target display in nits (defaults to 10000)'), + hard_min = 203, + hard_max = 10000, + soft_min = 1000, + soft_max = 10000, + step = 10, + digits = 0, + reset_callback = function(self) + self.value = 10000 + end +} + +GUI.optionwidgets.gainmap_downsampling_widget = dt.new_widget("slider") { + label = _('gain map downsampling steps'), + tooltip = _( + 'Exponent (2^x) of the gain map downsampling factor.\nDownsampling reduces the gain map resolution.\n\n0 = don\'t downsample the gain map, 7 = maximum downsampling (128x)'), + hard_min = 0, + hard_max = 7, + soft_min = 0, + soft_max = 7, + step = 1, + digits = 0, + reset_callback = function(self) + self.value = 0 + end +} + +GUI.optionwidgets.encoding_settings_box = dt.new_widget("box") { + orientation = "vertical", + GUI.optionwidgets.selection_type_combo, + GUI.optionwidgets.encoding_variant_combo, + GUI.optionwidgets.quality_widget, + GUI.optionwidgets.gainmap_downsampling_widget, + GUI.optionwidgets.target_display_peak_nits_widget, + GUI.optionwidgets.metadata_box +} + +GUI.optionwidgets.executable_path_widget = df.executable_path_widget({"ultrahdr_app", "exiftool", "ffmpeg"}) +GUI.optionwidgets.executable_path_widget.visible = false + +GUI.optionwidgets.edit_executables_button = dt.new_widget("button") { + label = _("show / hide executables"), + tooltip = _("Show / hide settings for executable files required for the plugin functionality"), + clicked_callback = function() + GUI.optionwidgets.executable_path_widget.visible = not GUI.optionwidgets.executable_path_widget.visible + end +} + +GUI.options = dt.new_widget("box") { + orientation = "vertical", + GUI.optionwidgets.settings_label, + GUI.optionwidgets.encoding_settings_box, + GUI.optionwidgets.edit_executables_button, + GUI.optionwidgets.executable_path_widget, + GUI.optionwidgets.output_settings_box +} + +GUI.run = dt.new_widget("button") { + label = _("generate UltraHDR"), + tooltip = _("Generate UltraHDR image(s) from selection"), + clicked_callback = main +} + +load_preferences() + +local function install_module() + if flags.module_installed then + return + end + dt.register_lib( -- register module + namespace, -- Module name + _("UltraHDR"), -- name + true, -- expandable + true, -- resetable + { + [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 99} + }, -- containers + dt.new_widget("box") { + orientation = "vertical", + GUI.options, + GUI.run + }, nil, -- view_enter + nil -- view_leave + ) +end + +local function destroy() + dt.gui.libs[namespace].visible = false +end + +local function restart() + dt.gui.libs[namespace].visible = true +end + +if dt.gui.current_view().id == "lighttable" then -- make sure we are in lighttable view + install_module() -- register the lib +else + if not flags.event_registered then -- if we are not in lighttable view then register an event to signal when we might be + -- https://www.darktable.org/lua-api/index.html#darktable_register_event + dt.register_event(namespace, "view-changed", -- we want to be informed when the view changes + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then -- if the view changes from darkroom to lighttable + install_module() -- register the lib + end + end) + flags.event_registered = true -- keep track of whether we have an event handler installed + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data diff --git a/contrib/video_ffmpeg.lua b/contrib/video_ffmpeg.lua index 6755e5c9..f0713fa6 100644 --- a/contrib/video_ffmpeg.lua +++ b/contrib/video_ffmpeg.lua @@ -37,19 +37,33 @@ local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" local dsys = require "lib/dtutils.system" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -du.check_min_api_version("5.0.0") - -local MODULE_NAME = "video_ffmpeg" - -local PS = dt.configuration.running_os == "windows" and "\\" or "/" -gettext.bindtextdomain(MODULE_NAME, dt.configuration.config_dir..PS.."lua"..PS.."locale"..PS) +du.check_min_api_version("7.0.0", "video_ffmpeg") local function _(msgid) - return gettext.dgettext(MODULE_NAME, msgid) + return gettext(msgid) end +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("video ffmpeg"), + purpose = _("timelapse video plugin based on ffmpeg"), + author = "Dominik Markiewicz", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/contib/video_ffmpeg" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local MODULE_NAME = "video_ffmpeg" + +local PS = dt.configuration.running_os == "windows" and "\\" or "/" ---- DECLARATIONS @@ -96,7 +110,7 @@ local resolutions = { } } -local framerates = {"15", "16", "23.98", "24", "25", "29,97", "30", "48", "50", "59.94", "60"} +local framerates = {"1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "15", "16", "23.98", "24", "25", "29,97", "30", "48", "50", "59.94", "60", "120", "240", "300"} local formats = { ["AVI"] = { @@ -232,8 +246,8 @@ local function string_pref_write(name, widget_attribute) end local framerates_selector = dt.new_widget("combobox"){ - label = _("framerate"), - tooltip = _("select framerate of output video"), + label = _("frame rate"), + tooltip = _("select frame rate of output video"), value = combobox_pref_read("framerate", framerates), changed_callback = combobox_pref_write("framerate"), table.unpack(framerates) @@ -277,7 +291,7 @@ local defaultVideoDir = '' if dt.configuration.running_os == "windows" then defaultVideoDir = os.getenv("USERPROFILE")..PS .."videos" elseif dt.configuration.running_os == "macos" then - defaultVideoDir = os.getenv("home")..PS.."Videos" + defaultVideoDir = os.getenv("HOME")..PS.."Videos" else local handle = io.popen("xdg-user-dir VIDEOS") defaultVideoDir = handle:read() @@ -285,7 +299,7 @@ else end local output_directory_chooser = dt.new_widget("file_chooser_button"){ - title = _("Select export path"), + title = _("select export path"), is_directory = true, tooltip =_("select the target directory for the timelapse. \nthe filename is created automatically."), value = string_pref_read("export_path", defaultVideoDir), @@ -366,7 +380,7 @@ local module_widget = dt.new_widget("box") { ---- EXPORT & REGISTRATION local function show_status(enf_storage, image, format, filename, number, total, high_quality, extra_data) - dt.print(_("export ")..tostring(number).." / "..tostring(total)) + dt.print(string.format(_("export %d / %d", number), total)) end local function init_export(storage, img_format, images, high_quality, extra_data) @@ -402,7 +416,7 @@ local function export(extra_data) local ffmpeg_path = df.check_if_bin_exists("ffmpeg") if not ffmpeg_path then dt.print_error("ffmpeg not found") - dt.print("ERROR - ffmpeg not found") + dt.print(_("ERROR - ffmpeg not found")) return end local dir = extra_data["tmp_dir"] @@ -434,7 +448,7 @@ local function finalize_export(storage, images_table, extra_data) dt.print_error(filename, file.filename) df.file_move(filename, tmp_dir .. PS .. i .. extra_data["img_ext"]) end - dt.print("Start video building...") + dt.print(_("start video building...")) local result, path = export(extra_data) if result ~= 0 then dt.print(_("ERROR: cannot build image, see console for more info")) @@ -448,9 +462,15 @@ local function finalize_export(storage, images_table, extra_data) df.rmdir(df.sanitize_filename(tmp_dir)) end +-- script_manager integration + +local function destroy() + dt.destroy_storage("module_video_ffmpeg") +end + dt.register_storage( "module_video_ffmpeg", - _(MODULE_NAME), + _("video ffmpeg"), show_status, finalize_export, nil, @@ -458,3 +478,8 @@ dt.register_storage( module_widget ) +-- script_manager integration + +script_data.destroy = destroy + +return script_data diff --git a/data/icons/blank20.png b/data/icons/blank20.png new file mode 100644 index 00000000..81ed5157 Binary files /dev/null and b/data/icons/blank20.png differ diff --git a/data/icons/path20.png b/data/icons/path20.png new file mode 100644 index 00000000..1021d864 Binary files /dev/null and b/data/icons/path20.png differ diff --git a/examples/api_version.lua b/examples/api_version.lua index 971f14c0..bf8a1c17 100644 --- a/examples/api_version.lua +++ b/examples/api_version.lua @@ -23,5 +23,36 @@ USAGE ]] local dt = require "darktable" +-- translation facilities + +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end + local result = dt.configuration.api_version_string -dt.print_error("API Version: "..result) +dt.print_log("API Version: " .. result) +dt.print("API " .. _("version") .. ": " .. result) + +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("APIversion"), + purpose = _("display api_version example"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/api_version" +} + +script_data.destroy = destroy + +return script_data diff --git a/examples/darkroom_demo.lua b/examples/darkroom_demo.lua index e0e40526..b76b552e 100644 --- a/examples/darkroom_demo.lua +++ b/examples/darkroom_demo.lua @@ -40,23 +40,28 @@ local du = require "lib/dtutils" -- V E R S I O N C H E C K -- - - - - - - - - - - - - - - - - - - - - - - - -du.check_min_api_version("5.0.2", "darkroom_mode") -- darktable 3.0 +du.check_min_api_version("5.0.2", "darkroom_demo") -- darktable 3.0 + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end -- - - - - - - - - - - - - - - - - - - - - - - - -- C O N S T A N T S -- - - - - - - - - - - - - - - - - - - - - - - - -local MODULE_NAME = "darkroom" +local MODULE_NAME = "darkroom_demo" local PS = dt.configuration.running_os == "windows" and "\\" or "/" -- - - - - - - - - - - - - - - - - - - - - - - - -- T R A N S L A T I O N S -- - - - - - - - - - - - - - - - - - - - - - - - -local gettext = dt.gettext -gettext.bindtextdomain(MODULE_NAME, dt.configuration.config_dir..PS.."lua"..PS.."locale"..PS) +local gettext = dt.gettext.gettext local function _(msgid) - return gettext.dgettext(MODULE_NAME, msgid) + return gettext(msgid) end -- - - - - - - - - - - - - - - - - - - - - - - - @@ -70,19 +75,29 @@ local sleep = dt.control.sleep local current_view = dt.gui.current_view() +-- check that there is an image selected, otherwise we can't activate darkroom viewe + +local images = dt.gui.action_images +dt.print_log(#images .. " images selected") +if not images or #images == 0 then + dt.print_log("no images selected, creating selection") + dt.print_log("using image " .. dt.collection[1].filename) + dt.gui.selection({dt.collection[1]}) +end + -- enter darkroom view dt.gui.current_view(dt.gui.views.darkroom) local max_images = 10 -dt.print(_("Showing images, with a pause in between each")) +dt.print(_("showing images, with a pause between each")) sleep(1500) -- display first 10 images of collection pausing for a second between each for i, img in ipairs(dt.collection) do - dt.print(_("Displaying image " .. i)) + dt.print(string.format(_("displaying image "), i)) dt.gui.views.darkroom.display_image(img) sleep(1500) if i == max_images then @@ -92,7 +107,22 @@ end -- return to lighttable view -dt.print(_("Restoring view")) +dt.print(_("restoring view")) sleep(1500) dt.gui.current_view(current_view) +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("darkroom demo"), + purpose = _("example demonstrating how to control image display in darkroom mode"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/darkroom_demo" +} + +script_data.destroy = destroy + +return script_data diff --git a/examples/gettextExample.lua b/examples/gettextExample.lua index c6eda49e..42e1a479 100644 --- a/examples/gettextExample.lua +++ b/examples/gettextExample.lua @@ -58,22 +58,40 @@ local du = require "lib/dtutils" --check API version du.check_min_api_version("3.0.0", "gettextExample") +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end + -- Not translated Text dt.print_error("Hello World!") -local gettext = dt.gettext --- Translate a string using the darktable textdomain -dt.print_error(gettext.gettext("image")) +local gettext = dt.gettext.gettext --- Tell gettext where to find the .mo file translating messages for a particular domain - -gettext.bindtextdomain("gettextExample",dt.configuration.config_dir.."/lua/locale/") --- Translate a string using the specified textdomain -dt.print_error(gettext.dgettext("gettextExample", 'Hello World!')) +-- Translate a string using the darktable textdomain +dt.print_error(gettext("image")) -- Define a local function called _ to make the code more readable and have it call dgettext -- with the proper domain. local function _(msgid) - return gettext.dgettext("gettextExample", msgid) + return gettext(msgid) end -dt.print_error(_('Hello World!')) + +dt.print_error(_("hello world!")) + +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("gettext example"), + purpose = _("example of how translations works"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/gettextExample" +} + +script_data.destroy = destroy + +return script_data diff --git a/examples/gui_action.lua b/examples/gui_action.lua new file mode 100644 index 00000000..9fee3619 --- /dev/null +++ b/examples/gui_action.lua @@ -0,0 +1,142 @@ +local dt = require "darktable" + +local NaN = 0/0 + +local wg = {} + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("gui action"), + purpose = _("example of how to use darktable.gui.action() calls"), + author = "Diederik ter Rahe", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/gui_action" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +wg.action = dt.new_widget("entry"){ + text = "lib/filter/view", + placeholder = _("action path"), + tooltip = _("enter the full path of an action, for example 'lib/filter/view'") + } + +wg.instance = dt.new_widget("combobox"){ + label = _("instance"), + tooltip = _("the instance of an image processing module to execute action on"), + "0", "+1", "-1", "+2", "-2", "+3", "-3", "+4", "-4", "+5", "-5", "+6", "-6", "+7", "-7", "+8", "-8", "+9", "-9" +} + +wg.element = dt.new_widget("entry"){ + text = "", + placeholder = _("action element"), + tooltip = _("enter the element of an action, for example 'selection', or leave empty for default") +} + +wg.effect = dt.new_widget("entry"){ + text = "next", + placeholder = _("action effect"), + tooltip = _("enter the effect of an action, for example 'next', or leave empty for default") +} + +wg.speed = dt.new_widget("entry"){ + text = "1", + placeholder = _("action speed"), + tooltip = _("enter the speed to use in action execution, or leave empty to only read state") +} + +wg.check = dt.new_widget("check_button"){ + label = _('perform action'), + tooltip = _('perform action or only read return'), + clicked_callback = function() + wg.speed.sensitive = wg.check.value + end, + value = true +} + +wg.return_value = dt.new_widget("entry"){ + text = "", + sensitive = false +} + +dt.register_lib( + "execute_action", -- Module name + _("execute gui actions"), -- name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER", 100}, + [dt.gui.views.darkroom] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER", 100}}, + dt.new_widget("box") + { + orientation = "vertical", + + dt.new_widget("box") + { + orientation = "horizontal", + dt.new_widget("label"){label = _("action path"), halign = "start"}, + wg.action + }, + wg.instance, + dt.new_widget("box") + { + orientation = "horizontal", + dt.new_widget("label"){label = _("element"), halign = "start"}, + wg.element + }, + dt.new_widget("box") + { + orientation = "horizontal", + dt.new_widget("label"){label = _("effect"), halign = "start"}, + wg.effect + }, + wg.check, + dt.new_widget("box") + { + orientation = "horizontal", + dt.new_widget("label"){label = _("speed"), halign = "start"}, + wg.speed + }, + dt.new_widget("button") + { + label = _("execute action"), + tooltip = _("execute the action specified in the fields above"), + clicked_callback = function(_) + local sp = NaN + if wg.check.value then sp = wg.speed.text end + wg.return_value.text = dt.gui.action(wg.action.text, tonumber(wg.instance.value), wg.element.text, wg.effect.text, tonumber(sp)) + end + }, + dt.new_widget("box") + { + orientation = "horizontal", + dt.new_widget("label"){label = "return value:", halign = "start"}, + wg.return_value + }, + } + ) + +local function restart() + dt.gui.libs["execute_action"].visible = true +end + +local function destroy() + dt.gui.libs["execute_action"].visible = false +end + +script_data.destroy = destroy +script_data.destroy_method = "hide" +script_data.restart = restart +script_data.show = restart + +return script_data diff --git a/examples/hello_world.lua b/examples/hello_world.lua index 11a287e2..6e04efc4 100644 --- a/examples/hello_world.lua +++ b/examples/hello_world.lua @@ -29,9 +29,38 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" +-- translation facilities + du.check_min_api_version("2.0.0", "hello_world") -dt.print("hello, world") +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end + +dt.print(_("hello, world")) + +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("hello world"), + purpose = _("example of how to print a message to the screen"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/hello_world" +} + +script_data.destroy = destroy +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/examples/lighttable_demo.lua b/examples/lighttable_demo.lua index c3629bad..e28454cd 100644 --- a/examples/lighttable_demo.lua +++ b/examples/lighttable_demo.lua @@ -50,14 +50,21 @@ du.check_min_api_version("5.0.2", "lighttable_demo") -- darktable 3.0 local MODULE_NAME = "lighttable" local PS = dt.configuration.running_os == "windows" and "\\" or "/" +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end + -- - - - - - - - - - - - - - - - - - - - - - - - -- T R A N S L A T I O N S -- - - - - - - - - - - - - - - - - - - - - - - - -local gettext = dt.gettext -gettext.bindtextdomain(MODULE_NAME, dt.configuration.config_dir..PS.."lua"..PS.."locale"..PS) +local gettext = dt.gettext.gettext + +dt.gettext.bindtextdomain("lighttable_demo", dt.configuration.config_dir .."/lua/locale/") local function _(msgid) - return gettext.dgettext(MODULE_NAME, msgid) + return gettext(msgid) end -- - - - - - - - - - - - - - - - - - - - - - - - @@ -75,6 +82,7 @@ local layouts = { "DT_LIGHTTABLE_LAYOUT_ZOOMABLE", "DT_LIGHTTABLE_LAYOUT_FILEMANAGER", "DT_LIGHTTABLE_LAYOUT_CULLING", + "DT_LIGHTTABLE_LAYOUT_CULLING_DYNAMIC", } local sorts = { @@ -138,34 +146,41 @@ sleep(2000) for n, layout in ipairs(layouts) do dt.gui.libs.lighttable_mode.layout(layout) - dt.print(_("set lighttable layout to " .. layout)) + dt.print(string.format(_("set lighttable layout to %s"), layout)) + dt.print_log("set lighttable layout to " .. layout) sleep(1500) for i = 1, 10 do dt.gui.libs.lighttable_mode.zoom_level(i) - dt.print(_("Set zoom level to " .. i)) + dt.print(string.format(_("set zoom level to %d"), i)) sleep(1500) end for i = 9, 1, -1 do dt.gui.libs.lighttable_mode.zoom_level(i) - dt.print(_("Set zoom level to " .. i)) + dt.print(string.format(_("set zoom level to %d"), i)) sleep(1500) end end +dt.print_log("finished layout and zoom level testing") +dt.print_log("starting sort demonstration") -- cycle through sorts dt.print(_("lighttable sorting demonstration")) +dt.print_log("setting lighttable to filemanager mode") dt.gui.libs.lighttable_mode.layout("DT_LIGHTTABLE_LAYOUT_FILEMANAGER") +sleep(500) +dt.print_log("setting lighttable to zoom level 5") dt.gui.libs.lighttable_mode.zoom_level(5) +dt.print_log("starting sorts") for n, sort in ipairs(sorts) do dt.gui.libs.filter.sort(sort) - dt.print(_("set lighttable sort to " .. sort)) + dt.print(string.format(_("set lighttable sort to %s"), sort)) sleep(1500) for m, sort_order in ipairs(sort_orders) do dt.gui.libs.filter.sort_order(sort_order) - dt.print(_("sort order set to " .. sort_order)) + dt.print(string.format(_("sort order set to %s"), sort_order)) sleep(1500) end end @@ -176,12 +191,12 @@ dt.print(_("lighttable filtering demonstration")) for n, rating in ipairs(ratings) do dt.gui.libs.filter.rating(rating) - dt.print(_("set filter to " .. rating)) + dt.print(string.format(_("set filter to %s"), rating)) sleep(1500) for m, rating_comparator in ipairs(rating_comparators) do dt.gui.libs.filter.rating_comparator(rating_comparator) - dt.print(_("set rating comparator to " .. rating_comparator)) + dt.print(string.format(_("set rating comparator to %s"), rating_comparator)) sleep(1500) end end @@ -196,3 +211,19 @@ current_rating = dt.gui.libs.filter.rating(current_rating) current_rating_comparator = dt.gui.libs.filter.rating_comparator(current_rating_comparator) current_sort =dt.gui.libs.filter.sort(current_sort) current_sort_order = dt.gui.libs.filter.sort_order(current_sort_order) + +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("lighttable demo"), + purpose = _("example demonstrating how to control lighttable display modes"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/lighttable_demo" +} + +script_data.destroy = destroy + +return script_data diff --git a/examples/moduleExample.lua b/examples/moduleExample.lua index ecc2ac35..89c56bc2 100644 --- a/examples/moduleExample.lua +++ b/examples/moduleExample.lua @@ -18,9 +18,9 @@ --[[ USAGE -* require this script from your main lua file +* require this script from your luarc file To do this add this line to the file .config/darktable/luarc: -require "moduleExample" +require "examples/moduleExample" * it creates a new example lighttable module @@ -33,37 +33,118 @@ https://www.darktable.org/lua-api/index.html.php#darktable_new_widget local dt = require "darktable" local du = require "lib/dtutils" -du.check_min_api_version("3.0.0", "moduleExample") +du.check_min_api_version("7.0.0", "moduleExample") --- add a new lib -local check_button = dt.new_widget("check_button"){label = "MyCheck_button", value = true} -local combobox = dt.new_widget("combobox"){label = "MyCombobox", value = 2, "8", "16", "32"} +-- https://www.darktable.org/lua-api/index.html#darktable_gettext +local gettext = dt.gettext.gettext ---https://www.darktable.org/lua-api/ar01s02s54.html.php +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = ("module example"), + purpose = _("example of how to create a lighttable module"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/moduleExample" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet, otherwise leave as nil +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- translation + +-- declare a local namespace and a couple of variables we'll need to install the module +local mE = {} +mE.widgets = {} +mE.event_registered = false -- keep track of whether we've added an event callback or not +mE.module_installed = false -- keep track of whether the module is module_installed + +--[[ We have to create the module in one of two ways depending on which view darktable starts + in. In orker to not repeat code, we wrap the darktable.register_lib in a local function. + ]] + +local function install_module() + if not mE.module_installed then + -- https://www.darktable.org/lua-api/index.html#darktable_register_lib + dt.register_lib( + "exampleModule", -- Module name + _("example module"), -- name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers + -- https://www.darktable.org/lua-api/types_lua_box.html + dt.new_widget("box") -- widget + { + orientation = "vertical", + dt.new_widget("button") + { + label = _("my ") .. "button", + clicked_callback = function (_) + dt.print(_("button clicked")) + end + }, + table.unpack(mE.widgets), + }, + nil,-- view_enter + nil -- view_leave + ) + mE.module_installed = true + end +end + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + dt.gui.libs["exampleModule"].visible = false -- we haven't figured out how to destroy it yet, so we hide it for now +end + +local function restart() + dt.gui.libs["exampleModule"].visible = true -- the user wants to use it again, so we just make it visible and it shows up in the UI +end + +-- https://www.darktable.org/lua-api/types_lua_check_button.html +local check_button = dt.new_widget("check_button"){label = _("my ") .. "check_button", value = true} + +-- https://www.darktable.org/lua-api/types_lua_combobox.html +local combobox = dt.new_widget("combobox"){label = _("my ") .. "combobox", value = 2, "8", "16", "32"} + +-- https://www.darktable.org/lua-api/types_lua_entry.html local entry = dt.new_widget("entry") { text = "test", - placeholder = "placeholder", + placeholder = _("placeholder"), is_password = false, editable = true, - tooltip = "Tooltip Text", + tooltip = _("tooltip text"), reset_callback = function(self) self.text = "text" end } +-- https://www.darktable.org/lua-api/types_lua_file_chooser_button.html local file_chooser_button = dt.new_widget("file_chooser_button") { - title = "MyFile_chooser_button", -- The title of the window when choosing a file + title = _("my ") .. "file_chooser_button", -- The title of the window when choosing a file value = "", -- The currently selected file is_directory = false -- True if the file chooser button only allows directories to be selecte } +-- https://www.darktable.org/lua-api/types_lua_label.html local label = dt.new_widget("label") -label.label = "MyLabel" -- This is an alternative way to the "{}" syntax to set a property +label.label = _("my ") .. "label" -- This is an alternative way to the "{}" syntax to set a property +-- https://www.darktable.org/lua-api/types_lua_separator.html local separator = dt.new_widget("separator"){} + +-- https://www.darktable.org/lua-api/types_lua_slider.html local slider = dt.new_widget("slider") { - label = "MySlider", + label = _("my ") .. "slider", soft_min = 10, -- The soft minimum value for the slider, the slider can't go beyond this point soft_max = 100, -- The soft maximum value for the slider, the slider can't go beyond this point hard_min = 0, -- The hard minimum value for the slider, the user can't manually enter a value beyond this point @@ -71,69 +152,44 @@ local slider = dt.new_widget("slider") value = 52 -- The current value of the slider } -if (dt.configuration.api_version_major >= 6) then - local section_label = dt.new_widget("section_label") - { - label = "MySectionLabel" - } - - dt.register_lib( - "exampleModule", -- Module name - "exampleModule", -- name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers - dt.new_widget("box") -- widget - { - orientation = "vertical", - dt.new_widget("button") - { - label = "MyButton", - clicked_callback = function (_) - dt.print("Button clicked") - end - }, - check_button, - combobox, - entry, - file_chooser_button, - label, - separator, - slider, - section_label - }, - nil,-- view_enter - nil -- view_leave - ) +-- pack the widgets in a table for loading in the module + +table.insert(mE.widgets, check_button) +table.insert(mE.widgets, combobox) +table.insert(mE.widgets, entry) +table.insert(mE.widgets, file_chooser_button) +table.insert(mE.widgets, label) +table.insert(mE.widgets, separator) +table.insert(mE.widgets, slider) + +-- ... and tell dt about it all + + +if dt.gui.current_view().id == "lighttable" then -- make sure we are in lighttable view + install_module() -- register the lib else - dt.register_lib( - "exampleModule", -- Module name - "exampleModule", -- name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers - dt.new_widget("box") -- widget - { - orientation = "vertical", - dt.new_widget("button") - { - label = "MyButton", - clicked_callback = function (_) - dt.print("Button clicked") - end - }, - check_button, - combobox, - entry, - file_chooser_button, - label, - separator, - slider - }, - nil,-- view_enter - nil -- view_leave - ) + if not mE.event_registered then -- if we are not in lighttable view then register an event to signal when we might be + -- https://www.darktable.org/lua-api/index.html#darktable_register_event + dt.register_event( + "mdouleExample", "view-changed", -- we want to be informed when the view changes + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then -- if the view changes from darkroom to lighttable + install_module() -- register the lib + end + end + ) + mE.event_registered = true -- keep track of whether we have an event handler installed + end end +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +script_data.destroy = destroy +script_data.restart = restart -- only required for lib modules until we figure out how to destroy them +script_data.destroy_method = "hide" -- tell script_manager that we are hiding the lib so it knows to use the restart function +script_data.show = restart -- if the script was "off" when darktable exited, the module is hidden, so force it to show on start + +return script_data -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: hl Lua; diff --git a/examples/multi_os.lua b/examples/multi_os.lua index 96b60c2b..21dc0cb1 100644 --- a/examples/multi_os.lua +++ b/examples/multi_os.lua @@ -70,13 +70,10 @@ local dtsys = require "lib/dtutils.system" -- system utilities translations, inserting this lays the groundwork for anyone who wants to translate the strings. ]] -local gettext = dt.gettext - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("multi_os",dt.configuration.config_dir.."/lua/locale/") +local gettext = dt.gettext.gettext local function _(msgid) - return gettext.dgettext("multi_os", msgid) + return gettext(msgid) end --[[ @@ -86,7 +83,7 @@ end screen stating that you couldn't load because the minimum api version wasn't met. ]] -du.check_min_api_version("5.0.0", "multi_os") +du.check_min_api_version("7.0.0", "multi_os") --[[ copy_image_attributes is a local subroutine to copy image attributes in the database from the raw image @@ -187,15 +184,24 @@ local function extract_embedded_jpeg(images) end else dt.print_error(image.filename .. " is not a raw file. No image can be extracted") -- print debugging error message - dt.print(image.filename .. " is not a raw file. No image can be extracted") -- print the error to the screen + dt.print(string.format(_("%s is not a raw file, no image can be extracted"), image.filename)) -- print the error to the screen end end else dt.print_error("ufraw-batch not found. Exiting...") -- print debugging error message - dt.print("ufraw-batch not found. Exiting...") -- print the error to the screen + dt.print("ufraw-batch not found, exiting...") -- print the error to the screen end end +--[[ + script_manager integration to allow a script to be removed + without restarting darktable +]] + +local function destroy() + dt.destroy_event("multi_os", "shortcut") -- destroy the event since the callback will no longer be present + dt.gui.libs.image.destroy_action("multi_os") -- remove the button from the selected images module +end --[[ Windows and MacOS don't place executables in the user's path so their location needs to be specified so that the script can find them. An exception to this is packages installed on MacOS with homebrew. Those @@ -204,41 +210,62 @@ end to see if the executable is there. ]] -local executable = "ufraw-batch" -local ufraw_batch_path_widget = dt.new_widget("file_chooser_button"){ - title = _("Select ufraw-batch[.exe] executable"), - value = df.get_executable_path_preference(executable), - is_directory = false, - changed_callback = function(self) - if df.check_if_bin_exists(self.value) then - df.set_executable_path_preference(executable, self.value) +if dt.configuration.running_os ~= "linux" then + local executable = "ufraw-batch" + local ufraw_batch_path_widget = dt.new_widget("file_chooser_button"){ + title = string.format(_("select %s executable"), "ufraw-batch[.exe]"), + value = df.get_executable_path_preference(executable), + is_directory = false, + changed_callback = function(self) + if df.check_if_bin_exists(self.value) then + df.set_executable_path_preference(executable, self.value) + end end - end -} -dt.preferences.register("executable_paths", "ufraw-batch", -- name - "file", -- type - _('multi_os: ufraw-batch location'), -- label - _('Installed location of ufraw-batch. Requires restart to take effect.'), -- tooltip - "ufraw-batch", -- default - ufraw_batch_path_widget -) + } + dt.preferences.register("executable_paths", "ufraw-batch", -- name + "file", -- type + 'multi_os: ufraw-batch ' .. _('location'), -- label + _('installed location of ufraw-batch, requires restart to take effect.'), -- tooltip + "ufraw-batch", -- default + ufraw_batch_path_widget + ) +end --[[ Add a button to the selected images module in lighttable ]] dt.gui.libs.image.register_action( - _("extract embedded jpeg"), + "multi_os", _("extract embedded jpeg"), function(event, images) extract_embedded_jpeg(images) end, - "extract embedded jpeg" + _("extract embedded jpeg") ) - + --[[ Add a shortcut ]] dt.register_event( - "shortcut", + "multi_os", "shortcut", function(event, shortcut) extract_embedded_jpeg(dt.gui.action_images) end, - "extract embedded jpeg" + _("extract embedded jpeg") ) + +--[[ + set the destroy routine so that script_manager can call it when + it's time to destroy the script and then return the data to + script_manager +]] + +local script_data = {} + +script_data.metadata = { + name = _("multi OS"), + purpose = _("example module thet runs on different operating systems"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/multi_os" +} + +script_data.destroy = destroy + +return script_data diff --git a/examples/panels_demo.lua b/examples/panels_demo.lua index edab6ae5..ac9e3de4 100644 --- a/examples/panels_demo.lua +++ b/examples/panels_demo.lua @@ -41,23 +41,28 @@ local du = require "lib/dtutils" -- V E R S I O N C H E C K -- - - - - - - - - - - - - - - - - - - - - - - - -du.check_min_api_version("5.0.2", "panels_demo") -- darktable 3.0 +du.check_min_api_version("7.0.0", "panels_demo") + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end -- - - - - - - - - - - - - - - - - - - - - - - - -- C O N S T A N T S -- - - - - - - - - - - - - - - - - - - - - - - - -local MODULE_NAME = "panels" +local MODULE_NAME = "panels_demo" local PS = dt.configuration.running_os == "windows" and "\\" or "/" -- - - - - - - - - - - - - - - - - - - - - - - - -- T R A N S L A T I O N S -- - - - - - - - - - - - - - - - - - - - - - - - -local gettext = dt.gettext -gettext.bindtextdomain(MODULE_NAME, dt.configuration.config_dir..PS.."lua"..PS.."locale"..PS) +local gettext = dt.gettext.gettext local function _(msgid) - return gettext.dgettext(MODULE_NAME, msgid) + return gettext(msgid) end -- - - - - - - - - - - - - - - - - - - - - - - - @@ -88,29 +93,29 @@ dt.gui.panel_show_all() -- hide center_top, center_bottom, left, top, right, bottom in order -dt.print(_("Hiding all panels, one at a tme")) +dt.print(_("hiding all panels, one at a time")) sleep(1500) for i = 1, #panels do - dt.print(_("Hiding " .. panels[i])) + dt.print(string.format(_("hiding %s"), panels[i])) dt.gui.panel_hide(panels[i]) sleep(1500) end -- display left, then top, then right, then bottom - dt.print(_("Make panels visible, one at a time")) + dt.print(_("make panels visible, one at a time")) sleep(1500) for i = #panels, 1, -1 do - dt.print(_("Showing " .. panels[i])) + dt.print(string.format(_("showing %s"), panels[i])) dt.gui.panel_show(panels[i]) sleep(1500) end -- hide all -dt.print(_("Hiding all panels")) +dt.print(_("hiding all panels")) sleep(1500) dt.gui.panel_hide_all() @@ -118,7 +123,7 @@ sleep(1500) -- show all -dt.print(_("Showing all panels")) +dt.print(_("showing all panels")) sleep(1500) dt.gui.panel_show_all() @@ -126,7 +131,7 @@ sleep(1500) -- restore -dt.print(_("Restoring panels to starting configuration")) +dt.print(_("restoring panels to starting configuration")) for i = 1, #panels do if panel_status[i] then dt.gui.panel_show(panels[i]) @@ -134,3 +139,19 @@ for i = 1, #panels do dt.gui.panel_hide(panels[i]) end end + +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("panels demo"), + purpose = _("example demonstrating how to contol panel visibility"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/panels_demo" +} + +script_data.destroy = destroy + +return script_data diff --git a/examples/preferenceExamples.lua b/examples/preferenceExamples.lua index 9710b95b..84425744 100644 --- a/examples/preferenceExamples.lua +++ b/examples/preferenceExamples.lua @@ -24,60 +24,86 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" +-- translation facilities + +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +local script_data = {} + +script_data.metadata = { + name = _("preference examples"), + purpose = _("example to show the different preference types that are possible"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/preferenceExamples" +} + du.check_min_api_version("2.0.1", "preferenceExamples") + dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. "preferenceExamplesString", -- name "string", -- type - "Example String", -- label - "Example String Tooltip", -- tooltip + _("example") .. " string", -- label + _("example") .. " string " .. _("tooltip"), -- tooltip "String") -- default dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. - "preferenceExamplesString", -- name + "preferenceExamplesBool", -- name "bool", -- type - "Example Boolean", -- label - "Example Boolean Tooltip", -- tooltip + _("example") .. " boolean", -- label + _("example") .. " boolean " .. _("tooltip"), -- tooltip true) -- default dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. - "preferenceExamplesString", -- name + "preferenceExamplesInteger", -- name "integer", -- type - "Example Integer", -- label - "Example Integer Tooltip", -- tooltip + _("example") .. " integer", -- label + _("example") .. " integer " .. _("tooltip"), -- tooltip 2, -- default 1, -- min 99) -- max dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. - "preferenceExamplesString", -- name + "preferenceExamplesFloat", -- name "float", -- type - "Example Float", -- label - "Example Float Tooltip", -- tooltip + _("example") .. " float", -- label + _("example") .. " float " .. _("tooltip"), -- tooltip 1.3, -- default 1, -- min 99, -- max 0.5) -- step dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. - "preferenceExamplesString", -- name + "preferenceExamplesFile", -- name "file", -- type - "Example File", -- label - "Example File Tooltip", -- tooltip + _("example") .. " file", -- label + _("example") .. " file " .. _("tooltip"), -- tooltip "") -- default dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. - "preferenceExamplesString", -- name + "preferenceExamplesDirectory", -- name "directory", -- type - "Example Directory", -- label - "Example Directory Tooltip", -- tooltip + _("example") .. " directory", -- label + _("example") .. " directory " .. _("tooltip"), -- tooltip "") -- default dt.preferences.register("preferenceExamples", -- script: This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. - "preferenceExamplesString", -- name + "preferenceExamplesEnum", -- name "enum", -- type - "Example Enum", -- label - "Example Enum Tooltip", -- tooltip + _("example") .. " enum", -- label + _("example") .. " enum " .. _("tooltip"), -- tooltip "Enum 1", -- default "Enum 1", "Enum 2") -- values + +local function destroy() + -- nothing to destroy +end + +script_data.destroy = destroy + +return script_data diff --git a/examples/printExamples.lua b/examples/printExamples.lua index 074a5db1..721138cd 100644 --- a/examples/printExamples.lua +++ b/examples/printExamples.lua @@ -24,9 +24,23 @@ local du = require "lib/dtutils" du.check_min_api_version("5.0.0", "printExamples") +-- translation facilities + +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end + -- Will print a string to the darktable control log (the long -- overlayed window that appears over the main panel). -dt.print("print") +dt.print(_("print")) -- This function will print its parameter if the Lua logdomain is -- activated. Start darktable with the "-d lua" command line option @@ -38,5 +52,20 @@ dt.print_error("print error") -- to enable the Lua logdomain. dt.print_log("print log") +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("print examples"), + purpose = _("example showing the different types of printing messages"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/printExamples" +} + +script_data.destroy = destroy + +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/examples/running_os.lua b/examples/running_os.lua index 632c033a..69741288 100644 --- a/examples/running_os.lua +++ b/examples/running_os.lua @@ -30,7 +30,37 @@ local du = require "lib/dtutils" du.check_min_api_version("5.0.0", "running_os") -dt.print("You are running: "..dt.configuration.running_os) +-- translation facilities + +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- script_manager integration to allow a script to be removed +-- without restarting darktable +local function destroy() + -- nothing to destroy +end + +dt.print(string.format(_("you are running: %s"), dt.configuration.running_os)) + +-- set the destroy routine so that script_manager can call it when +-- it's time to destroy the script and then return the data to +-- script_manager +local script_data = {} + +script_data.metadata = { + name = _("running OS"), + purpose = _("example of how to determine the operating system being used"), + author = "Tobias Jakobs", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/running_os" +} + +script_data.destroy = destroy + +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/examples/x-touch.lua b/examples/x-touch.lua new file mode 100644 index 00000000..7da3d54c --- /dev/null +++ b/examples/x-touch.lua @@ -0,0 +1,208 @@ +--[[ + This file is part of darktable, + copyright (c) 2023 Diederik ter Rahe + + 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 . +]] +--[[ +X-Touch Mini flexible encoder shortcuts + +This script will create virtual sliders that are mapped dynamically to +the most relevant sliders for the currently focused processing module. +Tailored modules are color zones, tone equalizer, color calibration and +mask manager properties. The script can easily be amended for other +devices or personal preferences. Virtual "toggle" buttons can be created +as well, that dynamically change meaning depending on current status. + +USAGE +* require this script from your main lua file +* restart darktable +* create shortcuts for each of the encoders on the x-touch mini + to a virtual slider under lua/x-touch + or import the following shortcutsrc file in the shortcuts dialog/preferences tab: + +None;midi:CC1=lua/x-touch/knob 1 +None;midi:CC2=lua/x-touch/knob 2 +None;midi:CC3=lua/x-touch/knob 3 +None;midi:CC4=lua/x-touch/knob 4 +None;midi:CC5=lua/x-touch/knob 5 +None;midi:CC6=lua/x-touch/knob 6 +None;midi:CC7=lua/x-touch/knob 7 +None;midi:CC8=lua/x-touch/knob 8 +midi:E0=global/modifiers +midi:F0=global/modifiers;ctrl +midi:F#0=global/modifiers;alt +midi:G#-1=iop/blend/tools/show and edit mask elements +midi:A-1=iop/colorzones;focus +midi:A#-1=iop/toneequal;focus +midi:B-1=iop/colorbalancergb;focus +midi:C0=iop/channelmixerrgb;focus +midi:C#0=iop/colorequal;focus +midi:D0=iop/colorequal/page;previous +midi:D#0=iop/colorequal/page;next +]] + +local dt = require "darktable" +local du = require "lib/dtutils" + +du.check_min_api_version("9.2.0", "x-touch") + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("x-touch"), + purpose = _("example of how to control an x-touch midi device"), + author = "Diederik ter Rahe", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/examples/x-touch" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +-- set up 8 mimic sliders with the same function +for k = 1,8 do + dt.gui.mimic("slider", "knob ".. k, + function(action, element, effect, size) + -- take the number from the mimic name + local k = tonumber(action:sub(-1)) + + -- only operate in darkroom; return NAN otherwise + if dt.gui.current_view() ~= dt.gui.views.darkroom then + return 0/0 + end + + local maskval = 0/0 + if k < 8 then + -- first try if the mask slider at that position is active + local s = { "opacity", + "size", + "feather", + "hardness", + "rotation", + "curvature", + "compression" } + maskval = dt.gui.action("lib/masks/properties/" .. s[k], + element, effect, size) + end + -- if a value different from NAN is returned, the slider was active + if maskval == maskval then + return maskval + + -- try if colorzones module is focused; if so select element of graph + elseif dt.gui.action("iop/colorzones", "focus") ~= 0 then + which = "iop/colorzones/graph" + local e = { "red", + "orange", + "yellow", + "green", + "aqua", + "blue", + "purple", + "magenta" } + element = e[k] + + -- try if colorequalizer module is focused; if so select element of graph + elseif dt.gui.action("iop/colorequal", "focus") ~= 0 then + local e = { "red", + "orange", + "yellow", + "green", + "cyan", + "blue", + "lavender", + "magenta" } + which = "iop/colorequal/graph" + element = e[k] + + -- if the sigmoid rgb primaries is focused, + -- check sliders + elseif dt.gui.action("iop/sigmoid", "focus") ~= 0 and k <8 then + local e = { "red attenuation", "red rotation", "green attenuation", "green rotation", "blue attenuation", "blue rotation", "recover purity" } + which = "iop/sigmoid/primaries/"..e[k] + + -- if the rgb primaries is focused, + -- check sliders + elseif dt.gui.action("iop/primaries", "focus") ~= 0 and k >=1 then + local e = { "red hue", "red purity", "green hue", "green purity", "blue hue", "blue purity", "tint hue", "tint purity" } + which = "iop/primaries/" ..e[k] + + -- if the tone equalizer is focused, + -- select one of the sliders in the "simple" tab + elseif dt.gui.action("iop/toneequal", "focus") ~= 0 then + which ="iop/toneequal/simple/"..(k-9).." EV" + + -- if color calibration is focused, + -- the last 4 knobs are sent there + elseif dt.gui.action("iop/channelmixerrgb", "focus") ~= 0 + and k >= 5 then + -- knob 5 selects the active tab; pressing it resets to CAT + if k == 5 then + which = "iop/channelmixerrgb/page" + element = "CAT" + -- since the tab action is not a slider, + -- the effects need to be translated + if effect == "up" then effect = "next" + elseif effect == "down" then effect = "previous" + else effect = "activate" + end + else + -- knobs 6, 7 and 8 are for the three color sliders on each tab + which = "iop/focus/sliders" + local e = { "1st", + "2nd", + "3rd" } + element = e[k - 5] + end + + -- the 4th knob is contrast; + -- either colorbalance if it is focused, or filmic + elseif dt.gui.action("iop/colorbalancergb", "focus") ~= 0 + and k == 4 then + which = "iop/colorbalancergb/contrast" + + -- in all other cases use a default selection + else + local s = { "iop/exposure/exposure", + "iop/filmicrgb/white relative exposure", + "iop/filmicrgb/black relative exposure", + "iop/filmicrgb/contrast", + "iop/crop/left", + "iop/crop/right", + "iop/crop/top", + "iop/crop/bottom" } + which = s[k] + end + + -- now pass the element/effect/size to the selected slider + return dt.gui.action(which, element, effect, size) + end) +end + +local function destroy() + -- nothing to destroy +end + +script_data.destroy = destroy + +return script_data diff --git a/include_all.lua b/include_all.lua deleted file mode 100644 index c25dd54d..00000000 --- a/include_all.lua +++ /dev/null @@ -1,61 +0,0 @@ ---[[ - This file is part of darktable, - copyright (c) 2014 Jérémy Rosen - copyright (c) 2018 Bill Ferguson - - 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 . -]] ---[[ -INCLUDE ALL -Automatically include all scripts in the script repository - -This is intended for debugging purpose - - -USAGE -* require this file from your main lua config file: -* go to configuration => preferences -* Enable the scripts you want to use -* restart darktable - -Note that you need to restart DT for your changes to enabled scripts to take effect - -]] -local dt = require "darktable" -local io = require "io" - --- must be loaded for scripts using darktable.control_execute to work -require "official/yield" - -dt.configuration.check_version(...,{3,0,0},{4,0,0},{5,0,0}) - --- find all scripts, but skip the lib and tools directories -local output = io.popen("cd "..dt.configuration.config_dir.."/lua ;find . -name lib -prune -o -name tools -prune -o -name \\*.lua -print") - -local my_name={...} -my_name = my_name[1] -for line in output:lines() do - local req_name = line:sub(3,-5) - if req_name ~= my_name and not string.match(req_name, "yield") then - dt.preferences.register(my_name,req_name,"bool","enable "..req_name, - "Should the script "..req_name.." be enabled at next startup",false) - - if dt.preferences.read(my_name,req_name,"bool") then - require(req_name) - end - end -end - --- --- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/lib/dtutils.lua b/lib/dtutils.lua index e1d403e7..e6595865 100644 --- a/lib/dtutils.lua +++ b/lib/dtutils.lua @@ -61,14 +61,50 @@ dtutils.libdoc.functions["check_min_api_version"] = { function dtutils.check_min_api_version(min_api, script_name) local current_api = dt.configuration.api_version_string - if min_api > current_api then + if dtutils.compare_api_versions(min_api, current_api) > 0 then dt.print_error("This application is written for lua api version " .. min_api .. " or later.") dt.print_error("The current lua api version is " .. current_api) dt.print("ERROR: " .. script_name .. " failed to load. Lua API version " .. min_api .. " or later required.") + dt.control.sleep(2000) -- allow time for the error to display before script_manager writes it's error message error("Minimum API " .. min_api .. " not met for " .. script_name .. ".", 0) end end +dtutils.libdoc.functions["check_max_api_version"] = { + Name = [[check_max_api_version]], + Synopsis = [[check the maximum required api version against the current api version]], + Usage = [[local du = require "lib/dtutils" + + local result = du.check_max_api_version(max_api, script_name) + max_api - string - the api version that the application was written for (example: "5.0.0") + script_name - string - the name of the script]], + Description = [[check_max_api_version compares the maximum api required for the appllication to + run against the current api version. This function is used when a part of the Lua API that + the script relies on is removed. If the maximum api version is not met, then an + error message is printed saying the script_name failed to load, then an error is thrown causing the + program to stop executing.]], + Return_Value = [[result - true if the maximum api version is available, false if not.]], + Limitations = [[When using the default handler on a script being executed from the luarc file, the error thrown + will stop the luarc file from executing any remaining statements. This limitation does not apply to script_manger.]], + Example = [[check_max_api_version("9.0.0") does nothing if the api is less than or equal to 9.0.0 otherwise an + error message is printed and an error is thrown stopping execution of the script.]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils.check_max_api_version(max_api, script_name) + local current_api = dt.configuration.api_version_string + if dtutils.compare_api_versions(current_api, max_api) > 0 then + dt.print_error("This application is written for lua api version " .. max_api .. " or earlier.") + dt.print_error("The current lua api version is " .. current_api) + dt.print("ERROR: " .. script_name .. " failed to load. Lua API version " .. max_api .. " or earlier required.") + dt.control.sleep(2000) -- allow time for the error to display before script_manager writes it's error message + error("Maximum API " .. max_api .. " not met for " .. script_name .. ".", 0) + end +end + dtutils.libdoc.functions["split"] = { Name = [[split]], Synopsis = [[split a string on a specified separator]], @@ -184,7 +220,8 @@ function dtutils.prequire(req_name) if status then log.msg(log.info, "Loaded " .. req_name) else - log.msg(log.info, "Error loading " .. req_name) + log.msg(log.error, "Error loading " .. req_name) + log.msg(log.error, "Error returned is " .. lib) end return status, lib end @@ -283,4 +320,148 @@ function dtutils.check_os(operating_systems) return false end +dtutils.libdoc.functions["find_image_by_id"] = { + Name = [[find_image_by_id]], + Synopsis = [[look up an image by ID in the database]], + Usage = [[local du = require "lib/dtutils" + local img = du.find_image_by_id(imgid) + id - int - the ID to look up + ]], + Description = [[find_image_by_id looks up an image by ID in the database.]], + Return_Value = [[result - dt_lua_image_t - image with the given ID if found, nil if not]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils.find_image_by_id(imgid) + if #dt.database == 0 or imgid > dt.database[#dt.database].id then + return nil + end + if dt.configuration.api_version_string >= "6.2.0" then + return dt.database.get_image(imgid) + else + local min = 1 + local max = #dt.database + while (max-min)//2 > 0 do + local mid = min + (max-min)//2 + local midID = dt.database[mid].id + if imgid == midID then + return dt.database[mid] + elseif imgid < midID then + max = mid-1 + else + min = mid+1 + end + end + if dt.database[min].id == imgid then + return dt.database[min] + elseif dt.database[max].id == imgid then + return dt.database[max] + else + return nil + end + end +end + +dtutils.libdoc.functions["deprecated"] = { + Name = [[deprecated]], + Synopsis = [[print deprecation warning]], + Usage = [[local du = require "lib/dtutils" + + du.deprecated(script_name, removal_string) + script_name - name of the script being deprecated + removal_string - a string explaining when the script will be removed]], + Description = [[deprecated prints an error message saying the script is deprecated and when it will be removed]], + Return_Value = [[]], + Limitations = [[]], + Example = [[local du = require "lib/dtutils" + du.deprecated("contrib/rename-tags.lua", "darktable release 4.0")]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils.deprecated(script_name, removal_string) + dt.print_toast("WARNING: " .. script_name .. " is deprecated and will be removed in " .. removal_string) + dt.print_error("WARNING: " .. script_name .. " is deprecated and will be removed in " .. removal_string) +end + +dtutils.libdoc.functions["gen_uuid"] = { + Name = [[gen_uuid]], + Synopsis = [[generate a UUID string]], + Usage = [[local du = require "lib/dtutils" + + uuid = du.gen_uuid(case) + case - "upper" or "lower" to specify the case of the UUID string]], + Description = [[gen_uuid prints an error message saying the script is gen_uuid and when it will be removed]], + Return_Value = [[uuid - string - a hexidecimal string representing the UUID in the requested case]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[https://gist.github.com/jrus/3197011]], + License = [[]], + Copyright = [[]], +} + +function dtutils.gen_uuid(case) + local template = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx' + + -- seed with os.time in seconds and add an extra degree of random for multiple calls in the same second + math.randomseed(os.time(), math.random(0, 65536)) + + local uuid = string.gsub(template, '[xy]', function (c) + local v = (c == 'x') and math.random(0, 0xf) or math.random(8, 0xb) + return string.format('%x', v) + end + ) + + if case and case == "upper" then + uuid = string.upper(uuid) + end + + return uuid +end + +dtutils.libdoc.functions["compare_api_versions"] = { + Name = [[compare_api_versions]], + Synopsis = [[compare two API version strings]], + Usage = [[local du = require "lib/dtutils" + + local result = du.compare_api_versions(version1, version2) + version1 - string - the first version string to compare (example: "5.0.0") + version2 - string - the second version string to compare (example: "5.1.0")]], + Description = [[compare_api_versions compares two version strings and returns 1 if version1 is greater, + -1 if version2 is greater, and 0 if they are equal.]], + Return_Value = [[result - 1 if version1 is greater, -1 if version2 is greater, 0 if they are equal.]], + Limitations = [[]], + Example = [[compare_api_versions("5.0.0", "5.1.0") returns -1]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils.compare_api_versions(version1, version2) + local v1 = {} + for num in version1:gmatch("%d+") do table.insert(v1, tonumber(num)) end + local v2 = {} + for num in version2:gmatch("%d+") do table.insert(v2, tonumber(num)) end + + for i = 1, math.max(#v1, #v2) do + local num1 = v1[i] or 0 + local num2 = v2[i] or 0 + if num1 > num2 then + return 1 + elseif num1 < num2 then + return -1 + end + end + return 0 +end + return dtutils diff --git a/lib/dtutils/file.lua b/lib/dtutils/file.lua index 1d9fa5bc..fc2ee9ef 100644 --- a/lib/dtutils/file.lua +++ b/lib/dtutils/file.lua @@ -24,31 +24,63 @@ dtutils_file.libdoc = { functions = {} } -local gettext = dt.gettext +local gettext = dt.gettext.gettext du.check_min_api_version("5.0.0", "dtutils.file") --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("dtutils.file",dt.configuration.config_dir.."/lua/locale/") - local function _(msgid) - return gettext.dgettext("dtutils.file", msgid) + return gettext(msgid) end -dtutils_file.libdoc.functions["check_if_bin_exists"] = { - Name = [[check_if_bin_exists]], - Synopsis = [[check if an executable exists]], +--[[ + local function to run a test command on windows and return a true if it succeeds + instead of returning true if it runs +]] + +local function _win_os_execute(cmd) + local result = nil + local p = io.popen(cmd) + local output = p:read("*a") + p:close() + if string.match(output, "true") then + result = true + else + result = false + end + return result +end + +--[[ + local function to determine if a path name is a windows executable +]] + +local function _is_windows_executable(path) + local result = false + if dtutils_file.test_file(path, "f") then + if string.match(path, ".exe$") or string.match(path, ".EXE$") or + string.match(path, ".com$") or string.match(path, ".COM$") or + string.match(path, ".bat$") or string.match(path, ".BAT$") or + string.match(path, ".cmd$") or string.match(path, ".CMD$") then + result = true + end + end + return result +end + +dtutils_file.libdoc.functions["test_file"] = { + Name = [[test_file]], + Synopsis = [[test a file to see what it is]], Usage = [[local df = require "lib/dtutils.file" - local result = df.check_if_bin_exists(bin) - bin - string - the binary to check for]], - Description = [[check_if_bin_exists checks to see if the specified binary exists. - check_if_bin_exists first checks to see if a preference for the binary has been - registered and uses that if found. The presence of the file is verified, then - quoted and returned. If no preference is specified and the operating system is - linux then the which command is used to check for a binary in the path. If found - that path is returned. If no binary is found, false is returned.]], - Return_Value = [[result - string - the sanitized path of the binary, false if not found]], + local result = df.test_file(path, test) + path - string - the path to check + test - one of d, e, f, x where + d - directory + e - exists + f - file + x - executable]], + Description = [[test_file checks a path to see if it is a directory]], + Return_Value = [[result - boolean - true if path is a directory, nil if not]], Limitations = [[]], Example = [[]], See_Also = [[]], @@ -57,11 +89,244 @@ dtutils_file.libdoc.functions["check_if_bin_exists"] = { Copyright = [[]], } -function dtutils_file.check_if_bin_exists(bin) +function dtutils_file.test_file(path, test) + local cmd = "test -" + local engine = os.execute + local cmdstring = "" + + if dt.configuration.running_os == "windows" then + cmd = "if exist " + engine = _win_os_execute + end + + if test == "d" then + -- test if directory + if dt.configuration.running_os == "windows" then + cmdstring = cmd .. dtutils_file.sanitize_filename(path .. "\\*") .. " echo true" + else + cmdstring = cmd .. test .. " " .. dtutils_file.sanitize_filename(path) + end + elseif test == "e" then + -- test exists + if dt.configuration.running_os == "windows" then + cmdstring = cmd .. dtutils_file.sanitize_filename(path) .. " echo true" + else + cmdstring = cmd .. test .. " " .. dtutils_file.sanitize_filename(path) + end + elseif test == "f" then + -- test if file + if dt.configuration.running_os == "windows" then + if not dtutils_file.test_file(path, "d") then -- make sure it's not a directory + cmdstring = cmd .. dtutils_file.sanitize_filename(path) .. " echo true" + else + return false + end + else + cmdstring = cmd .. test .. " " .. dtutils_file.sanitize_filename(path) + end + elseif test == "x" then + -- test executable + if dt.configuration.running_os == "windows" then + return _is_windows_executable(path) + else + cmdstring = cmd .. test .. " " .. dtutils_file.sanitize_filename(path) + end + else + dt.print_error("[test_file] unknown test " .. test) + return false + end + + return engine(cmdstring) +end + +--[[ + local function to return a case insensitive pattern for matching + i.e. gimp becomes [Gg][Ii][Mm][Pp] which should match any capitalization + of gimp. +]] + +local function _case_insensitive_pattern(pattern) + return pattern:gsub("(.)", function(letter) + return string.format("[%s$s]", letter:lower(), letter:upper()) + end) +end + +--[[ + local function to search windows for an executable +]] + +local function _search_for_bin_windows(bin) + local result = false + -- use where on path + -- use where on program files + -- use where on program files (x86) + local args = {"", '/R "C:\\Program Files"', '/R "C:\\Program Files (x86)"'} + + for _,arg in ipairs(args) do + local cmd = "where " .. arg .. " " .. ds.sanitize(bin) + local p = io.popen(cmd) + local output = p:read("*a") + p:close() + local lines = du.split(output, "\n") + local cibin = _case_insensitive_pattern(bin) + for _,line in ipairs(lines) do + if string.match(line, cibin) then + dt.print_log("found win search match " .. line) + if dtutils_file.test_file(line, "f") and dtutils_file.test_file(line, "x") then + dtutils_file.set_executable_path_preference(bin, line) -- save it so we don't have to search again + return line + end + end + end + end + return result +end + +--[[ + local function to search *nix systems for an executable +]] + +local function _search_for_bin_nix(bin) + local result = false + local p = io.popen("command -v " .. bin) + local output = p:read("*a") + p:close() + if string.len(output) > 0 then + local spath = dtutils_file.sanitize_filename(output:sub(1, -2)) + if dtutils_file.test_file(spath, "f") and dtutils_file.test_file(spath, "x") then + dtutils_file.set_executable_path_preference(bin, spath) + result = spath + end + end + return result +end + +--[[ + local function to search macos systems for an executable +]] + +local function _search_for_bin_macos(bin) + local result = false + + result = _search_for_bin_nix(bin) -- see if it's in the path + + if not result then + local search_start = "/Applications" + + if dtutils_file.check_if_file_exists("/Applications/" .. bin .. ".app") then + search_start = "/Applications/" .. bin .. ".app" + end + + local p = io.popen("find " .. search_start .. " -type f -name " .. bin .. " -print") + local output = p:read("*a") + p:close() + local lines = du.split(output, "\n") + + for _,line in ipairs(lines) do + local spath = dtutils_file.sanitize_filename(line:sub(1, -1)) + if dtutils_file.test_file(spath, "x") then + dtutils_file.set_executable_path_preference(bin, spath) -- save it so we don't have to search again + result = spath + end + end + end + + return result +end + +--[[ + local function to provide a generic search call that can be + split into operating system specific calls +]] + +local function _search_for_bin(bin) + local result = false + + if dt.configuration.running_os == "windows" then + result = _search_for_bin_windows(bin) + if result then + result = dtutils_file.sanitize_filename(result) + end + elseif dt.configuration.running_os == "macos" then + result = _search_for_bin_macos(bin) + else + result = _search_for_bin_nix(bin) + end + + return result +end + +--[[ + local function to check if an executable path is + a windows executable on linux or macos, thus requiring wine to run +]] + +local function _check_path_for_wine_bin(path) + local result = false + + if string.len(path) > 0 then + -- check for windows executable to run under wine + if _is_windows_executable(path) then + if dtutils_file.check_if_file_exists(path) then + result = "wine " .. dtutils_file.sanitize_filename(path) + end + end + end + return result +end + +--[[ + local function to check if an executable path is + a valid executable. Some generic checks are done before + system specific checks are done. +]] + +local function _check_path_for_bin(bin) local result = false local path = nil - if string.match(bin, "/") or string.match(bin, "\\") then + local PS = dt.configuration.running_os == "windows" and "\\" or "/" + + if string.match(bin, PS) then + path = bin + else + path = dtutils_file.get_executable_path_preference(bin) + -- reset path preference is the returned preference is a directory + if dtutils_file.test_file(path, "d") then + dtutils_file.set_executable_path_preference(bin, "") + path = nil + end + end + + if path and dtutils_file.test_file(path, "d") then + path = nil + end + + if path and dt.configuration.running_os ~= "windows" then + result = _check_path_for_wine_bin(path) + end + + if path and not result then + if dtutils_file.test_file(path, "x") then + result = dtutils_file.sanitize_filename(path) + end + end + + return result +end + +--[[ + local function to the old check_if_bin_exists functionality + on windows in order to decrease the amount of windows being + created and destroyed by system calls. +]] + +local function _old_check_if_bin_exists(bin) -- only run on windows if preference checked + local result = false + local path = nil + + if string.match(bin, "\\") then + path = bin else path = dtutils_file.get_executable_path_preference(bin) @@ -69,142 +334,89 @@ function dtutils_file.check_if_bin_exists(bin) if string.len(path) > 0 then if dtutils_file.check_if_file_exists(path) then - if (string.match(path, ".exe$") or string.match(path, ".EXE$")) and dt.configuration.running_os ~= "windows" then - result = dtutils_file.sanitize_filename("wine " .. path) - else + if (string.match(path, ".exe$") or string.match(path, ".EXE$")) then result = dtutils_file.sanitize_filename(path) end end - elseif dt.configuration.running_os == "linux" then - local p = io.popen("which " .. bin) - local output = p:read("*a") - p:close() - if string.len(output) > 0 then - result = dtutils_file.sanitize_filename(output:sub(1,-2)) - end end return result end -dtutils_file.libdoc.functions["split_filepath"] = { - Name = [[split_filepath]], - Synopsis = [[split a filepath into parts]], +dtutils_file.libdoc.functions["check_if_bin_exists"] = { + Name = [[check_if_bin_exists]], + Synopsis = [[check if an executable exists]], Usage = [[local df = require "lib/dtutils.file" - local result = df.split_filepath(filepath) - filepath - string - path and filename]], - Description = [[split_filepath splits a filepath into the path, filename, basename and filetype and puts - that in a table]], - Return_Value = [[result - table - a table containing the path, filename, basename, and filetype]], - Limitations = [[]], + local result = df.check_if_bin_exists(bin) + bin - string - the binary to check for]], + Description = [[check_if_bin_exists checks to see if the specified binary exists. + check_if_bin_exists first checks to see if a preference for the binary has been + registered and uses that if found, after it's verified to be an executable and + exist. If no preference exissts, the user's path is checked for the executable. + If the executable is not found in the users path, then a search of the operating + system is conducted to see if the executable can be found. + + If an executalble is found, it's verified to exist and be an executable. Once + the executable is verified, the path is saved as a preference to speed up + subsequent checks. The executable path is sanitized and returned. + + If no executable is found, false is returned.]], + Return_Value = [[result - string - the sanitized path of the binary, false if not found]], + Limitations = [[If more than one executable that satisfies the search results is found, the + wrong one may be returned. If the wrong value is returned, the user can still specify the + correct execuable using tools/executable_manager. Most packages are well behaved with the + notiable exception being GIMP on windows. Depending on the packager there are multiple + gimp executables, often with version numbers. In this case, the user needs to specify + the location of the correct executable using executable_manager.]], Example = [[]], - See_Also = [[]], + See_Also = [[executable_manager]], Reference = [[]], License = [[]], Copyright = [[]], } -function dtutils_file.split_filepath(str) - -- strip out single quotes from quoted pathnames - str = string.gsub(str, "'", "") - str = string.gsub(str, '"', '') - local result = {} - -- Thank you Tobias Jakobs for the awesome regular expression, which I tweaked a little - result["path"], result["filename"], result["basename"], result["filetype"] = string.match(str, "(.-)(([^\\/]-)%.?([^%.\\/]*))$") - if result["basename"] == "" and result["filetype"]:len() > 1 then - result["basename"] = result["filetype"] - result["filetype"] = "" +function dtutils_file.check_if_bin_exists(bin) + local result = false + + if dt.configuration.running_os == "windows" and dt.preferences.read("dtutils.file", "use_old_check_if_bin_exists", "bool") then + result = _old_check_if_bin_exists(bin) + else + + result = _check_path_for_bin(bin) + + if not result then + result = _search_for_bin(bin) + end end return result end -dtutils_file.libdoc.functions["get_path"] = { - Name = [[get_path]], - Synopsis = [[get the path from a file path]], - Usage = [[local df = require "lib/dtutils.file" +-- the following path, filename, etc functions have +-- moved to the string library since they are string +-- manipulation functions, and to prevent circular +-- library inclusiion. - local result = df.get_path(filepath) - filepath - string - path and filename]], - Description = [[get_path strips the filename and filetype from a path and returns the path]], - Return_Value = [[result - string - the path]], - Limitations = [[]], - Example = [[]], - See_Also = [[]], - Reference = [[]], - License = [[]], - Copyright = [[]], -} +-- these functions are left here for compatibility +-- with older scripts -function dtutils_file.get_path(str) - local parts = dtutils_file.split_filepath(str) - return parts["path"] +function dtutils_file.split_filepath(str) + return ds.split_filepath(str) end -dtutils_file.libdoc.functions["get_filename"] = { - Name = [[get_filename]], - Synopsis = [[get the filename and extension from a file path]], - Usage = [[local df = require "lib/dtutils.file" - - local result = df.get_filename(filepath) - filepath - string - path and filename]], - Description = [[get_filename strips the path from a filepath and returns the filename]], - Return_Value = [[result - string - the file name and type]], - Limitations = [[]], - Example = [[]], - See_Also = [[]], - Reference = [[]], - License = [[]], - Copyright = [[]], -} +function dtutils_file.get_path(str) + return ds.get_path(str) +end function dtutils_file.get_filename(str) - local parts = dtutils_file.split_filepath(str) - return parts["filename"] + return ds.get_filename(str) end -dtutils_file.libdoc.functions["get_basename"] = { - Name = [[get_basename]], - Synopsis = [[get the filename without the path or extension]], - Usage = [[local df = require "lib/dtutils.file" - - local result = df.get_basename(filepath) - filepath - string - path and filename]], - Description = [[get_basename returns the name of the file without the path or filetype -]], - Return_Value = [[result - string - the basename of the file]], - Limitations = [[]], - Example = [[]], - See_Also = [[]], - Reference = [[]], - License = [[]], - Copyright = [[]], -} - function dtutils_file.get_basename(str) - local parts = dtutils_file.split_filepath(str) - return parts["basename"] + return ds.get_basename(str) end -dtutils_file.libdoc.functions["get_filetype"] = { - Name = [[get_filetype]], - Synopsis = [[get the filetype from a filename]], - Usage = [[local df = require "lib/dtutils.file" - - local result = df.get_filetype(filepath) - filepath - string - path and filename]], - Description = [[get_filetype returns the filetype from the supplied filepath]], - Return_Value = [[result - string - the filetype]], - Limitations = [[]], - Example = [[]], - See_Also = [[]], - Reference = [[]], - License = [[]], - Copyright = [[]], -} - function dtutils_file.get_filetype(str) - local parts = dtutils_file.split_filepath(str) - return parts["filetype"] + return ds.get_filetype(str) end @@ -230,10 +442,10 @@ function dtutils_file.check_if_file_exists(filepath) local result = false if (dt.configuration.running_os == 'windows') then filepath = string.gsub(filepath, '[\\/]+', '\\') - local p = io.popen("if exist " .. filepath .. " (echo 'yes') else (echo 'no')") + local p = io.popen("if exist " .. dtutils_file.sanitize_filename(filepath) .. " (echo 'yes') else (echo 'no')") local ans = p:read("*all") p:close() - if string.match(ans, "yes") then + if string.match(ans, "yes") then result = true end -- result = os.execute('if exist "'..filepath..'" (cmd /c exit 0) else (cmd /c exit 1)') @@ -307,9 +519,9 @@ function dtutils_file.file_copy(fromFile, toFile) local result = nil -- if cp exists, use it if dt.configuration.running_os == "windows" then - result = os.execute('copy "' .. fromFile .. '" "' .. toFile .. '"') + result = os.execute('copy ' .. dtutils_file.sanitize_filename(fromFile) .. ' ' .. dtutils_file.sanitize_filename(toFile)) elseif dtutils_file.check_if_bin_exists("cp") then - result = os.execute("cp '" .. fromFile .. "' '" .. toFile .. "'") + result = os.execute("cp " .. dtutils_file.sanitize_filename(fromFile) .. ' ' .. dtutils_file.sanitize_filename(toFile)) end -- if cp was not present, or if cp failed, then a pure lua solution @@ -360,7 +572,7 @@ function dtutils_file.file_move(fromFile, toFile) if not success then -- an error occurred, so let's try using the operating system function if dtutils_file.check_if_bin_exists("mv") then - success = os.execute("mv '" .. fromFile .. "' '" .. toFile .. "'") + success = os.execute("mv " .. dtutils_file.sanitize_filename(fromFile) .. ' ' .. dtutils_file.sanitize_filename(toFile)) end -- if the mv didn't exist or succeed, then... if not success then @@ -383,8 +595,8 @@ dtutils_file.libdoc.functions["filename_increment"] = { local result = df.filename_increment(filepath) filepath - string - filename to increment]], - Description = [[filename_increment solves the problem of filename confllict by adding an - increment to the filename. If the supplied filename has no increment then + Description = [[filename_increment solves the problem of filename confllict by adding an + increment to the filename. If the supplied filename has no increment then "01" is added to the basename. If the filename already has an increment, then 1 is added to it and the filename returned.]], Return_Value = [[result - string - the incremented filename]], @@ -436,7 +648,7 @@ dtutils_file.libdoc.functions["create_unique_filename"] = { filepath - string - the path and filename requested]], Description = [[create_unique_filename takes a requested filepath and checks to see if it exists. If if doesn't then it's returned intact. If it already exists, then a two - digit increment is added to the filename and it is tested again. The increment keeps + digit increment is added to the filename and it is tested again. The increment keeps increasing until either a unique filename is found or there have been 100 attempts.]], Return_Value = [[result - string - the incremented filename]], Limitations = [[create_unique_filename will only attempt 100 increments.]], @@ -515,7 +727,7 @@ dtutils_file.libdoc.functions["executable_path_widget"] = { local widget = df.executable_path_widget(executables) executables - table - a table of strings that are executable names]], Description = [[executable_path_widget takes a table of executable names - and builds a set of file selector widgets to get the path to the executable. + and builds a set of file selector widgets to get the path to the executable. The resulting widgets are wrapped in a box widget and returned.]], Return_Value = [[widget - widget - a widget containing a file selector widget for each executable.]], @@ -530,10 +742,10 @@ dtutils_file.libdoc.functions["executable_path_widget"] = { function dtutils_file.executable_path_widget(executables) local box_widgets = {} table.insert(box_widgets, dt.new_widget("section_label"){label = "select executable(s)"}) - for _, executable in pairs(executables) do + for _, executable in pairs(executables) do table.insert(box_widgets, dt.new_widget("label"){label = "select " .. executable .. " executable"}) local path = dtutils_file.get_executable_path_preference(executable) - if not path then + if not path then path = "" end table.insert(box_widgets, dt.new_widget("file_chooser_button"){ @@ -544,8 +756,9 @@ function dtutils_file.executable_path_widget(executables) if dtutils_file.check_if_bin_exists(self.value) then dtutils_file.set_executable_path_preference(executable, self.value) end - end} - ) + end + } + ) end local box = dt.new_widget("box"){ orientation = "vertical", @@ -562,7 +775,7 @@ dtutils_file.libdoc.functions["sanitize_filename"] = { local sanitized_filename = df.sanitize_filename(filename) filename - string - a filepath and filename]], Description = [[sanitize_file places quotes around the filename in an - operating system specific manner. The result is safe to pass as + operating system specific manner. The result is safe to pass as an argument to the operating system.]], Return_Value = [[sanitized_filename - string - quoted filename]], Limitations = [[]], @@ -584,7 +797,7 @@ dtutils_file.libdoc.functions["mkdir"] = { df.mkdir(path) path - string - a directory path]], - Description = [[mkdir creates directories if not already exists. It + Description = [[mkdir creates directories if not already exists. It create whole parents subtree if needed ]], Return_Value = [[path - string - a directory path]], @@ -596,10 +809,10 @@ dtutils_file.libdoc.functions["mkdir"] = { Copyright = [[]], } -function dtutils_file.mkdir(path) +function dtutils_file.mkdir(path) if not dtutils_file.check_if_file_exists(path) then local mkdir_cmd = dt.configuration.running_os == "windows" and "mkdir" or "mkdir -p" - return dsys.external_command(mkdir_cmd.." "..path) + return dsys.external_command(mkdir_cmd.." "..dtutils_file.sanitize_filename(path)) else return 0 end @@ -624,7 +837,52 @@ dtutils_file.libdoc.functions["rmdir"] = { function dtutils_file.rmdir(path) local rm_cmd = dt.configuration.running_os == "windows" and "rmdir /S /Q" or "rm -r" - return dsys.external_command(rm_cmd.." "..path) + return dsys.external_command(rm_cmd.." "..dtutils_file.sanitize_filename(path)) +end + +dtutils_file.libdoc.functions["create_tmp_file"] = { + Name = [[create_tmp_file]], + Synopsis = [[creates a temporary file]], + Usage = [[local df = require "lib/dtutils.file + + local result = df.create_tmp_file()]], + Description = [[create_tmp_file can be used to create temporary files]], + Return_Value = [[result - string - path to the created temporary file.]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_file.create_tmp_file() + local tmp_file = os.tmpname() + + local f = io.open(tmp_file, "w") + if not f then + log.msg(log.error, string.format("Error writing to `%s`", tmp_file)) + os.remove(tmp_file) + return nil + end + + return tmp_file +end + +--[[ + The new check_if_bin_exists() does multiple calls to the operating system to check + if the file exists and is an executable. On windows, each call to the operating system + causes a window to open in order to run the command, then the window closes when the + command exits. If the user gets annoyed by the "flickering windows", then they can + enable this preference to use the old check_if_bin_exists() that relys on the + executable path preferences and doesn't do as many checks. +]] + +if dt.configuration.running_os == "windows" then + dt.preferences.register("dtutils.file", "use_old_check_if_bin_exists", "bool", + "lua scripts use old check_if_bin_exists()", + "lessen flickering windows effect when scripts run", + false) end diff --git a/lib/dtutils/log.lua b/lib/dtutils/log.lua index a90fc7c0..28dce69f 100644 --- a/lib/dtutils/log.lua +++ b/lib/dtutils/log.lua @@ -17,11 +17,11 @@ dtutils_log.libdoc = { print out warning, error and success messages as code is running - log.log_level(debug) + log.log_level(log.debug) print out debugging messages too because this isnt working - log.log_level(info) + log.log_level(log.info) I want to make sure this is working ok @@ -51,54 +51,63 @@ local dt_print_error = dt.print_error local dt_print_log = dt.print_log local dt_print = dt.print + -- set the default log levels dtutils_log.debug = { - label = "DEBUG:", + label = "DEBUG: ", enabled = false, engine = dt_print_log, + caller_info = 3, level = 1, } dtutils_log.info = { - label = "INFO:", + label = "INFO: ", enable = false, engine = dt_print_log, + caller_info = 1, level = 2, } dtutils_log.warn = { - label = "WARN:", + label = "WARN: ", enabled = false, engine = dt_print_log, + caller_info = 2, level = 3, } dtutils_log.error = { - label = "ERROR:", + label = "ERROR: ", enabled = true, - engine = dt_print_error, + engine = dt_print_log, + caller_info = 3, level = 4, } dtutils_log.success = { - label = "SUCCESS:", + label = "SUCCESS: ", enabled = true, engine = dt_print_log, + caller_info = 2, level = 5, } dtutils_log.screen = { label = "", enabled = true, engine = dt_print, + caller_info = 0, level = 9, } dtutils_log.always = { label = "", enabled = true, engine = dt_print_log, + caller_info = 3, level = 9, } dtutils_log.critical = { - label = "CRITICAL:", + label = "CRITICAL: ", enabled = true, engine = print, + caller_info = 3, level = 9, } @@ -120,7 +129,7 @@ result = log.caller(level) Copyright = [[]], } -function dtutils_log.caller(level) +function dtutils_log.caller(level, info) local name = debug.getinfo(level).name local lineno = nil local source = nil @@ -131,7 +140,16 @@ function dtutils_log.caller(level) -- we just need the filename, so grab it from the string -- Thanks, Tobias Jakobs :-) source = string.match(source, "@.-([^\\/]-%.?[^%.\\/]*)$") - return name .. ": " .. source .. ": " .. lineno .. ":" + + if info == 0 then + return "" + elseif info == 1 then + return source .. ": " + elseif info == 2 then + return source .. ": " .. name .. ": " + else + return source .. ": " .. name .. ": " .. lineno .. ":" + end else return "callback:" end @@ -181,8 +199,8 @@ function dtutils_log.msg(level, ...) table.remove(args, 1) end local log_msg = level.label - if level.engine ~= dt_screen and call_level ~= 0 then - log_msg = log_msg .. dtutils_log.caller(call_level) .. " " + if level.engine ~= dt_print and call_level ~= 0 then + log_msg = log_msg .. dtutils_log.caller(call_level, level.caller_info) .. " " elseif log_msg:len() > 2 then log_msg = log_msg .. " " end diff --git a/lib/dtutils/string.lua b/lib/dtutils/string.lua index 89af3a7b..48221f19 100644 --- a/lib/dtutils/string.lua +++ b/lib/dtutils/string.lua @@ -1,6 +1,17 @@ local dtutils_string = {} local dt = require "darktable" +local du = require "lib/dtutils" +local log = require "lib/dtutils.log" +local gettext = dt.gettext.gettext + +local DEFAULT_LOG_LEVEL = log.error + +local function _(msg) + return gettext(msg) +end + +dtutils_string.log_level = DEFAULT_LOG_LEVEL dtutils_string.libdoc = { Name = [[dtutils.string]], @@ -48,6 +59,8 @@ dtutils_string.libdoc.functions["strip_accents"] = { } function dtutils_string.strip_accents( str ) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) local tableAccents = {} tableAccents["à"] = "a" tableAccents["á"] = "a" @@ -111,6 +124,7 @@ function dtutils_string.strip_accents( str ) end end + log.log_level(old_log_level) return normalizedString end @@ -136,6 +150,8 @@ dtutils_string.libdoc.functions["escape_xml_characters"] = { -- Keep & first, otherwise it will double escape other characters function dtutils_string.escape_xml_characters( str ) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) str = string.gsub(str,"&", "&") str = string.gsub(str,"\"", """) @@ -143,6 +159,7 @@ function dtutils_string.escape_xml_characters( str ) str = string.gsub(str,"<", "<") str = string.gsub(str,">", ">") + log.log_level(old_log_level) return str end @@ -165,15 +182,85 @@ dtutils_string.libdoc.functions["urlencode"] = { } function dtutils_string.urlencode(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) if (str) then str = string.gsub (str, "\n", "\r\n") str = string.gsub (str, "([^%w ])", function (c) return string.format ("%%%02X", string.byte(c)) end) str = string.gsub (str, " ", "+") end + log.log_level(old_log_level) return str end +dtutils_string.libdoc.functions["is_not_sanitized"] = { + Name = [[is_not_sanitized]], + Synopsis = [[Check if a string has been sanitized]], + Usage = [[local ds = require "lib/dtutils.string" + local result = ds.is_not_sanitized(str) + str - string - the string that needs to be made safe]], + Description = [[is_not_sanitized checks a string to see if it + has been made safe use passing as an argument in a system command.]], + Return_Value = [[result - boolean - true if the string is not sanitized otherwise false]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +local function _is_not_sanitized_posix(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + -- A sanitized string must be quoted. + if not string.match(str, "^'.*'$") then + log.log_level(old_log_level) + return true + -- A quoted string containing no quote characters within is sanitized. + elseif string.match(str, "^'[^']*'$") then + log.log_level(old_log_level) + return false + end + + -- Any quote characters within a sanitized string must be properly + -- escaped. + local quotesStripped = string.sub(str, 2, -2) + local escapedQuotesRemoved = string.gsub(quotesStripped, "'\\''", "") + if string.find(escapedQuotesRemoved, "'") then + log.log_level(old_log_level) + return true + else + log.log_level(old_log_level) + return false + end +end + +local function _is_not_sanitized_windows(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + if not string.match(str, "^\".*\"$") then + log.log_level(old_log_level) + return true + else + log.log_level(old_log_level) + return false + end +end + +function dtutils_string.is_not_sanitized(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + if dt.configuration.running_os == "windows" then + log.log_level(old_log_level) + return _is_not_sanitized_windows(str) + else + log.log_level(old_log_level) + return _is_not_sanitized_posix(str) + end +end + dtutils_string.libdoc.functions["sanitize"] = { Name = [[sanitize]], Synopsis = [[surround a string in quotes making it safe to pass as an argument]], @@ -192,26 +279,76 @@ dtutils_string.libdoc.functions["sanitize"] = { Copyright = [[]], } -function dtutils_string.sanitize(str) - local result = "" - local os_quote = dt.configuration.running_os == "windows" and '"' or "'" +local function _sanitize_posix(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + if _is_not_sanitized_posix(str) then + log.log_level(old_log_level) + return "'" .. string.gsub(str, "'", "'\\''") .. "'" + else + log.log_level(old_log_level) + return str + end +end - if dtutils_string.is_not_sanitized(str) then - result = os_quote .. str .. os_quote +local function _sanitize_windows(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + if _is_not_sanitized_windows(str) then + log.log_level(old_log_level) + return "\"" .. string.gsub(str, "\"", "\"^\"\"") .. "\"" + else + log.log_level(old_log_level) + return str end - +end + +local function _should_be_sanitized(str) + local old_log_level = log.log_level() + local result = false + local UNSAFE_POSIX_FILENAME_CHARS = "[^%w/._%-]+" + local UNSAFE_WIN_FILENAME_CHARS = "[^%w\\._%-:]+" + + local pattern = UNSAFE_POSIX_FILENAME_CHARS + if dt.configuration.running_os == "windows" then + pattern = UNSAFE_WIN_FILENAME_CHARS + end + + log.log_level(dtutils_string.log_level) + if string.match(str, pattern) then + result = true + end + log.log_level(old_log_level) return result end -dtutils_string.libdoc.functions["is_not_sanitized"] = { - Name = [[is_not_sanitized]], - Synopsis = [[Check if a string has been sanitized]], +function dtutils_string.sanitize(str) + local old_log_level = log.log_level() + local sanitized_str = nil + log.log_level(dtutils_string.log_level) + if _should_be_sanitized(str) then + if dt.configuration.running_os == "windows" then + sanitized_str = _sanitize_windows(str) + else + sanitized_str = _sanitize_posix(str) + end + else + sanitized_str = str + end + log.log_level(old_log_level) + return sanitized_str +end + +dtutils_string.libdoc.functions["sanitize_lua"] = { + Name = [[sanitize_lua]], + Synopsis = [[escape lua 'magic' characters from a pattern string]], Usage = [[local ds = require "lib/dtutils.string" - local result = ds.is_not_sanitized(str) + + local result = ds.sanitize_lua(str) str - string - the string that needs to be made safe]], - Description = [[is_not_sanitized checks a string to see if it - has been made safe use passing as an argument in a system command.]], - Return_Value = [[result - boolean - true if the string is not sanitized otherwise false]], + Description = [[sanitize_lua escapes lua 'magic' characters so that + a string may be used in lua string/patten matching.]], + Return_Value = [[result - string - a lua pattern safe string]], Limitations = [[]], Example = [[]], See_Also = [[]], @@ -220,15 +357,875 @@ dtutils_string.libdoc.functions["is_not_sanitized"] = { Copyright = [[]], } -function dtutils_string.is_not_sanitized(str) - local os_quote = dt.configuration.running_os == "windows" and '"' or "'" +function dtutils_string.sanitize_lua(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + str = string.gsub(str, "%%", "%%%%") + str = string.gsub(str, "%-", "%%-") + str = string.gsub(str, "%(", "%%(") + str = string.gsub(str, "%)", "%%)") + str = string.gsub(str, "%[", "%%[") + str = string.gsub(str, "%]", "%%]") + str = string.gsub(str, "+", "%%+") + log.log_level(old_log_level) + return str +end - if string.match(str, os_quote .. ".*" .. os_quote) then - return false +dtutils_string.libdoc.functions["split_filepath"] = { + Name = [[split_filepath]], + Synopsis = [[split a filepath into parts]], + Usage = [[local ds = require "lib/dtutils.string" + + local result = ds.split_filepath(filepath) + filepath - string - path and filename]], + Description = [[split_filepath splits a filepath into the path, filename, basename and filetype and puts + that in a table]], + Return_Value = [[result - table - a table containing the path, filename, basename, and filetype]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.split_filepath(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + -- strip out single quotes from quoted pathnames + str = string.gsub(str, "'", "") + str = string.gsub(str, '"', '') + local result = {} + -- Thank you Tobias Jakobs for the awesome regular expression, which I tweaked a little + result["path"], result["filename"], result["basename"], result["filetype"] = string.match(str, "(.-)(([^\\/]-)%.?([^%.\\/]*))$") + if result["basename"] == "" and result["filetype"]:len() > 1 then + result["basename"] = result["filetype"] + result["filetype"] = "" + end + log.log_level(old_log_level) + return result +end + +dtutils_string.libdoc.functions["get_path"] = { + Name = [[get_path]], + Synopsis = [[get the path from a file path]], + Usage = [[local ds = require "lib/dtutils.string" + + local result = ds.get_path(filepath) + filepath - string - path and filename]], + Description = [[get_path strips the filename and filetype from a path and returns the path]], + Return_Value = [[result - string - the path]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.get_path(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + local parts = dtutils_string.split_filepath(str) + log.log_level(old_log_level) + return parts["path"] +end + +dtutils_string.libdoc.functions["get_filename"] = { + Name = [[get_filename]], + Synopsis = [[get the filename and extension from a file path]], + Usage = [[local ds = require "lib/dtutils.string" + + local result = ds.get_filename(filepath) + filepath - string - path and filename]], + Description = [[get_filename strips the path from a filepath and returns the filename]], + Return_Value = [[result - string - the file name and type]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.get_filename(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + local parts = dtutils_string.split_filepath(str) + log.log_level(old_log_level) + return parts["filename"] +end + +dtutils_string.libdoc.functions["get_basename"] = { + Name = [[get_basename]], + Synopsis = [[get the filename without the path or extension]], + Usage = [[local ds = require "lib/dtutils.string" + + local result = ds.get_basename(filepath) + filepath - string - path and filename]], + Description = [[get_basename returns the name of the file without the path or filetype +]], + Return_Value = [[result - string - the basename of the file]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.get_basename(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + local parts = dtutils_string.split_filepath(str) + log.log_level(old_log_level) + return parts["basename"] +end + +dtutils_string.libdoc.functions["get_filetype"] = { + Name = [[get_filetype]], + Synopsis = [[get the filetype from a filename]], + Usage = [[local ds = require "lib/dtutils.string" + + local result = ds.get_filetype(filepath) + filepath - string - path and filename]], + Description = [[get_filetype returns the filetype from the supplied filepath]], + Return_Value = [[result - string - the filetype]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.get_filetype(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + local parts = dtutils_string.split_filepath(str) + log.log_level(old_log_level) + return parts["filetype"] +end + +dtutils_string.libdoc.functions["build_substitute_list"] = { + Name = [[build_substitute_list]], + Synopsis = [[build a list of variable substitutions]], + Usage = [[local ds = require "lib/dtutils.string" + ds.build_substitute_list(image, sequence, variable_string, [username], [pic_folder], [home], [desktop]) + image - dt_lua_image_t - the image being processed + sequence - integer - the sequence number of the image being processed (exported) + variable_string - string - the substitution variable string + [username] - string - optional - user name. Will be determined if not supplied + [pic_folder] - string - optional - pictures folder name. Will be determined if not supplied + [home] - string - optional - home directory. Will be determined if not supplied + [desktop] - string - optional - desktop directory. Will be determined if not supplied]], + Description = [[build_substitute_list populates variables with values from the arguments + and determined from the system and darktable.]], + Return_Value = [[]], + Limitations = [[If the value for a variable can not be determined, or if it is not supported, + then an empty string is used for the value.]], + Example = [[]], + See_Also = [[https://docs.darktable.org/usermanual/4.6/en/special-topics/variables/]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +local substitutes = {} +local category_substitutes = {} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local PLACEHOLDERS = {"ROLL.NAME", + "FILE.FOLDER", + "FILE.NAME", + "FILE.EXTENSION", + "ID", + "VERSION", + "VERSION.IF.MULTI", + "VERSION.NAME", + "DARKTABLE.VERSION", + "DARKTABLE.NAME", -- Not Implemented + "SEQUENCE", + "WIDTH.SENSOR", + "HEIGHT.SENSOR", + "WIDTH.RAW", + "HEIGHT.RAW", + "WIDTH.CROP", + "HEIGHT.CROP", + "WIDTH.EXPORT", + "HEIGHT.EXPORT", + "WIDTH.MAX", -- Not Implemented + "HEIGHT.MAX", -- Not Implemented + "YEAR", + "YEAR.SHORT", + "MONTH", + "MONTH.LONG", + "MONTH.SHORT", + "DAY", + "HOUR", + "HOUR.AMPM", -- Not Implemented + "MINUTE", + "SECOND", + "MSEC", + "EXIF.YEAR", + "EXIF.YEAR.SHORT", + "EXIF.MONTH", + "EXIF.MONTH.LONG", + "EXIF.MONTH.SHORT", + "EXIF.DAY", + "EXIF.HOUR", + "EXIF.HOUR.AMPM", -- Not Implemented + "EXIF.MINUTE", + "EXIF.SECOND", + "EXIF.MSEC", + "EXIF.DATE.REGIONAL", -- Not Implemented + "EXIF.TIME.REGIONAL", -- Not Implemented + "EXIF.ISO", + "EXIF.EXPOSURE", + "EXIF.EXPOSURE.BIAS", + "EXIF.EXPOSURE.PROGRAM", -- Not Implemented + "EXIF.APERTURE", + "EXIF.CROP.FACTOR", + "EXIF.FOCAL.LENGTH", + "EXIF.FOCAL.LENGTH.EQUIV", -- Not Implemented + "EXIF.FOCUS.DISTANCE", + "EXIF.MAKER", + "EXIF.MODEL", + "EXIF.WHTIEBALANCE", -- Not Implemented + "EXIF.METERING", -- Not Implemented + "EXIF.LENS", + "EXIF.FLASH.ICON", -- Not Implemented + "EXIF.FLASH", -- Not Implemented + "GPS.LONGITUDE", -- Not Implemented + "GPS.LATITUDE", -- Not Implemented + "GPS.ELEVATION", -- Not Implemented + "GPS.LOCATION.ICON", -- Not Implemented + "LONGITUDE", + "LATITUDE", + "ELEVATION", + "GPS.LOCATION", -- Not Implemented + "STARS", + "RATING.ICONS", -- Not Implemented + "LABELS", + "LABELS.ICONS", -- Not Implemented + "TITLE", + "DESCRIPTION", + "CREATOR", + "PUBLISHER", + "RIGHTS", + "TAGS", -- Not Implemented + "SIDECAR.TXT", -- Not Implemented + "FOLDER.PICTURES", + "FOLDER.HOME", + "FOLDER.DESKTOP", + "OPENCL.ACTIVATED", -- Not Implemented + "USERNAME", + "NL", -- Not Implemented + "JOBCODE" -- Not Implemented +} + +local PS = dt.configuration.running_os == "windows" and "\\" or "/" +local USER = os.getenv("USERNAME") +local HOME = dt.configuration.running_os == "windows" and os.getenv("HOMEPATH") or os.getenv("HOME") +local PICTURES = HOME .. PS .. (dt.configuration.running_os == "windows" and "My Pictures" or "Pictures") +local DESKTOP = HOME .. PS .. "Desktop" + +local function get_colorlabels(image) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + local colorlabels = {} + + if image.red then table.insert(colorlabels, "red") end + if image.yellow then table.insert(colorlabels, "yellow") end + if image.green then table.insert(colorlabels, "green") end + if image.blue then table.insert(colorlabels, "blue") end + if image.purple then table.insert(colorlabels, "purple") end + + local labels = #colorlabels == 1 and colorlabels[1] or du.join(colorlabels, "_") + + log.log_level(old_log_level) + + return labels +end + +-- find the $CATEGORYn and $CATEGORY[n,m] requests and add them to the substitute list + +local function build_category_substitution_list(image, variable_string) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + for match in string.gmatch(variable_string, "%$%(.-%)?%)") do -- grab each complete variable + log.msg(log.info, "match is " .. match) + + local var = string.match(match, "%$%((.-%)?)%)") -- strip of the leading $( and trailing ) + log.msg(log.info, "var is " .. var) + + if string.match(var, "CATEGORY%d") or string.match(var, "CATEGORY%[") then + local element + local tag + + if string.match(var, "CATEGORY%d") then + element, tag = string.match(var, "CATEGORY(%d)%((.-)%)") -- get the element number and the tag to match + else + element, tag = string.match(var, "%[(%d),(.-)%]") -- new syntax + end + + element = element + 1 -- add one to element since lua arrays are 1 based + log.msg(log.debug, "element is " .. element .. " and tag is " .. tag) + + local tags = image:get_tags() + log.msg(log.debug, "got " .. #tags .. " from image " .. image.filename) + + for _, image_tag in ipairs(tags) do + log.msg(log.debug, "checking tag " .. image_tag.name) + + if string.match(image_tag.name, tag) then + fields = du.split(image_tag.name, "|") + + if element <= #fields then + substitutes[var] = fields[element] + else + substitutes[var] = "" + log.msg(log.warn, "requested field for tag " .. tag .. " doesn't exist") + end + + log.msg(log.info, "set substitute for " .. var .. " to " .. fields[element]) + + end + end + end + end + log.log_level(old_log_level) +end + +-- convert image.exif_datetime_taken to system time + +local function exiftime2systime(exiftime) + local yr,mo,dy,h,m,s = string.match(exiftime, "(%d-):(%d-):(%d-) (%d-):(%d-):(%d+)") + return(os.time{year=yr, month=mo, day=dy, hour=h, min=m, sec=s}) +end + +-- build the argument substitution list from each image + +function dtutils_string.build_substitute_list(image, sequence, variable_string, username, pic_folder, home, desktop) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + -- is time millisecond aware? Implemented in API 9.1.0 + + local is_api_9_1 = true + if dt.configuration.api_version_string < "9.1.0" then + is_api_9_1 = false + end + + local is_api_9_4 = dt.configuration.api_version_string >= "9.4.0" and true or false + + local datetime = os.date("*t") + local long_month = os.date("%B") + local short_month = os.date("%b") + local user_name = username or USER + local pictures_folder = pic_folder or PICTURES + local home_folder = home or HOME + local desktop_folder = desktop or DESKTOP + + local labels = get_colorlabels(image) + + local eyear, emon, eday, ehour, emin, esec, emsec + if dt.preferences.read("darktable", "lighttable/ui/milliseconds", "bool") and is_api_9_1 then + eyear, emon, eday, ehour, emin, esec, emsec = + string.match(image.exif_datetime_taken, "(%d+):(%d+):(%d+) (%d+):(%d+):(%d+)%.(%d+)$") else - return true + emsec = "0" + eyear, emon, eday, ehour, emin, esec = + string.match(image.exif_datetime_taken, "(%d+):(%d+):(%d+) (%d+):(%d+):(%d+)$") end + + local version_multi = #image:get_group_members() > 1 and image.duplicate_index or "" + + local replacements = {dtutils_string.get_basename(image.film.path),-- ROLL.NAME + image.path, -- FILE.FOLDER + dtutils_string.get_basename(image.filename),-- FILE.NAME + dtutils_string.get_filetype(image.filename),-- FILE.EXTENSION + image.id, -- ID + image.duplicate_index, -- VERSION + version_multi, -- VERSION.IF_MULTI + image.version_name, -- VERSION.NAME + dt.configuration.version, -- DARKTABLE.VERSION + "", -- DARKTABLE.NAME + string.format("%04d", sequence), -- SEQUENCE + image.width, -- WIDTH.SENSOR + image.height, -- HEIGHT.SENSOR + is_api_9_1 and image.p_width or "", -- WIDTH.RAW + is_api_9_1 and image.p_height or "", -- HEIGHT.RAW + is_api_9_1 and image.final_width or "", -- WIDTH.CROP + is_api_9_1 and image.final_height or "", -- HEIGHT.CROP + is_api_9_1 and image.final_width or "", -- WIDTH.EXPORT + is_api_9_1 and image.final_height or "", -- HEIGHT.EXPORT + "", -- WIDTH.MAX -- from export module + "", -- HEIGHT.MAX -- from export module + string.format("%4d", datetime.year), -- YEAR + string.sub(datetime.year, 3), -- YEAR.SHORT + string.format("%02d", datetime.month), -- MONTH + long_month, -- MONTH.LONG + short_month, -- MONTH.SHORT + string.format("%02d", datetime.day), -- DAY + string.format("%02d", datetime.hour), -- HOUR + "", -- HOUR.AMPM + string.format("%02d", datetime.min), -- MINUTE + string.format("%02d", datetime.sec), -- SECOND + 0, -- MSEC + eyear, -- EXIF.YEAR + string.sub(eyear, 3), -- EXIF.YEAR.SHORT + emon, -- EXIF.MONTH + os.date("%B", exiftime2systime(image.exif_datetime_taken)), -- EXIF.MONTH.LONG + os.date("%b", exiftime2systime(image.exif_datetime_taken)), -- EXIF.MONTH.SHORT + eday, -- EXIF.DAY + ehour, -- EXIF.HOUR + "", -- EXIF.HOUR.AMPM + emin, -- EXIF.MINUTE + esec, -- EXIF.SECOND + emsec, -- EXIF.MSEC + "", -- EXIF.DATE.REGIONAL - wont be implemented + "", -- EXIF.TIME.REGIONAL - wont be implemented + string.format("%d", image.exif_iso), -- EXIF.ISO + string.format("%.0f", 1./image.exif_exposure), -- EXIF.EXPOSURE + image.exif_exposure_bias, -- EXIF.EXPOSURE.BIAS + "", -- EXIF.EXPOSURE.PROGRAM + string.format("%.01f", image.exif_aperture), -- EXIF.APERTURE + string.format("%.01f", image.exif_crop),-- EXIF.CROP_FACTOR + string.format("%.0f", image.exif_focal_length), -- EXIF.FOCAL.LENGTH + string.format("%.0f", image.exif_focal_length * image.exif_crop), -- EXIF.FOCAL.LENGTH.EQUIV + image.exif_focus_distance, -- EXIF.FOCUS.DISTANCE + image.exif_maker, -- EXIF.MAKER + image.exif_model, -- EXIF.MODEL + is_api_9_4 and image.exif_whitebalance or "", -- EXIF.WHITEBALANCE + is_api_9_4 and image.exif_metering_mode or "", -- EXIF.METERING + image.exif_lens, -- LENS + "", -- EXIF.FLASH.ICON + is_api_9_4 and image.exif_flash or "", -- EXIF.FLASH + "", -- GPS.LONGITUDE + "", -- GPS.LATITUDE + "", -- GPS.ELEVATION + "", -- GPS.LOCATION.ICON + image.longitude or "", -- LONGITUDE + image.latitude or "", -- LATITUDE + image.elevation or "", -- ELEVATION + "", -- GPS.LOCATION - wont be implemented + image.rating, -- STARS + "", -- RATING.ICONS - wont be implemented + labels, -- LABELS + "", -- LABELS.ICONS - wont be implemented + image.title, -- TITLE + image.description, -- DESCRIPTION + image.creator, -- CREATOR + image.publisher, -- PUBLISHER + image.rights, -- RIGHTS + "", -- TAGS - wont be implemented + "", -- SIDECAR.TXT - wont be implemented + pictures_folder, -- FOLDER.PICTURES + home_folder, -- FOLDER.HOME + desktop_folder, -- FOLDER.DESKTOP + "", -- OPENCL.ACTIVATED - wont be implemented + user_name, -- USERNAME + "", -- NL - wont be implemented + "" -- JOBCODE - wont be implemented + } + + -- populate the substitution list + + for i = 1, #PLACEHOLDERS, 1 do + substitutes[PLACEHOLDERS[i]] = replacements[i] + log.msg(log.info, "setting " .. PLACEHOLDERS[i] .. " to " .. tostring(replacements[i])) + end + + -- do category substitutions separately + + build_category_substitution_list(image, variable_string) + + log.log_level(old_log_level) end +dtutils_string.libdoc.functions["get_substitution_tooltip"] = { + Name = [[get_substitution_tooltip]], + Synopsis = [[get a tooltip that lists the substitution variables]], + Usage = [[local ds = require "lib/dtutils.string" + ds.get_substitution_tooltip() + Description = [[get_substitution_tooltip lists the variables with brief explanations]], + Return_Value = [[string - the tooltip]], + Limitations = [[]], + Example = [[]], + See_Also = [[https://docs.darktable.org/usermanual/4.6/en/special-topics/variables/]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.get_substitution_tooltip() + + return table.concat({ + _("$(ROLL.NAME) - roll of the input image"), + _("$(FILE.FOLDER) - folder containing the input image"), + _("$(FILE.NAME) - basename of the input image"), + _("$(FILE.EXTENSION) - extension of the input image"), + _("$(ID) - image ID"), + _("$(VERSION) - duplicate version"), + _("$(VERSION.IF_MULTI) - same as $(VERSION) but null string if only one version exists"), + _("$(VERSION.NAME) - version name from metadata"), + _("$(DARKTABLE.VERSION) - current darktable version"), + -- _("$(DARKTABLE.NAME) - darktable name"), -- not implemented + _("$(SEQUENCE[n,m]) - sequence number, n: number of digits, m: start number"), + _("$(WIDTH.SENSOR) - image sensor width"), + _("$(HEIGHT.SENSOR) - image sensor height"), + _("$(WIDTH.RAW) - RAW image width"), + _("$(HEIGHT.RAW) - RAW image height"), + _("$(WIDTH.CROP) - image width after crop"), + _("$(HEIGHT.CROP) - image height after crop"), + _("$(WIDTH.EXPORT) - exported image width"), + _("$(HEIGHT.EXPORT) - exported image height"), + -- _("$(WIDTH.MAX) - maximum image export width"), -- not implemented + -- _("$(HEIGHT.MAX) - maximum image export height"), -- not implemented + _("$(YEAR) - year"), + _("$(YEAR.SHORT) - year without century"), + _("$(MONTH) - month"), + _("$(MONTH.LONG) - full month name according to the current locale"), + _("$(MONTH.SHORT) - abbreviated month name according to the current locale"), + _("$(DAY) - day"), + _("$(HOUR) - hour"), + -- _("$(HOUR.AMPM) - hour, 12-hour clock"), -- not implemented + _("$(MINUTE) - minute"), + _("$(SECOND) - second"), + _("$(MSEC) - millisecond"), + _("$(EXIF.YEAR) - EXIF year"), + _("$(EXIF.YEAR.SHORT) - EXIF year without century"), + _("$(EXIF.MONTH) - EXIF month"), + _("$(EXIF.MONTH.LONG) - full EXIF month name according to the current locale"), + _("$(EXIF.MONTH.SHORT) - abbreviated EXIF month name according to the current locale"), + _("$(EXIF.DAY) - EXIF day"), + _("$(EXIF.HOUR) - EXIF hour"), + -- _("$(EXIF.HOUR.AMPM) - EXIF hour, 12-hour clock") .. "\n" .. -- not implemented + _("$(EXIF.MINUTE) - EXIF minute"), + _("$(EXIF.SECOND) - EXIF second"), + _("$(EXIF.MSEC) - EXIF millisecond"), + -- _("$(EXIF.DATE.REGIONAL) - localized EXIF date"), -- not implemented + -- _("$(EXIF.TIME.REGIONAL) - localized EXIF time"), -- not implemented + _("$(EXIF.ISO) - ISO value"), + _("$(EXIF.EXPOSURE) - EXIF exposure"), + _("$(EXIF.EXPOSURE.BIAS) - EXIF exposure bias"), + -- _("$(EXIF.EXPOSURE.PROGRAM) - EXIF exposure program"), -- not implemented + _("$(EXIF.APERTURE) - EXIF aperture"), + _("$(EXIF.CROP_FACTOR) - EXIF crop factor"), + _("$(EXIF.FOCAL.LENGTH) - EXIF focal length"), + _("$(EXIF.FOCAL.LENGTH.EQUIV) - EXIF 35 mm equivalent focal length"), + _("$(EXIF.FOCUS.DISTANCE) - EXIF focal distance"), + _("$(EXIF.MAKER) - camera maker") .. + _("$(EXIF.MODEL) - camera model") .. + _("$(EXIF.WHITEBALANCE) - EXIF selected white balance") .. -- not implemented + _("$(EXIF.METERING) - EXIF exposure metering mode") .. -- not implemented + _("$(EXIF.LENS) - lens") .. + -- _("$(EXIF.FLASH.ICON) - icon indicating whether flash was used") .. -- not implemented + _("$(EXIF.FLASH) - was flash used (yes/no/--)") .. -- not implemented + -- _("$(GPS.LONGITUDE) - longitude"),-- not implemented + -- _("$(GPS.LATITUDE) - latitude"),-- not implemented + -- _("$(GPS.ELEVATION) - elevation"),-- not implemented + -- _("$(GPS.LOCATION.ICON) - icon indicating whether GPS location is known"),-- not implemented + _("$(LONGITUDE) - longitude"), + _("$(LATITUDE) - latitude"), + _("$(ELEVATION) - elevation"), + _("$(STARS) - star rating as number (-1 for rejected)"), + -- _("$(RATING.ICONS) - star/reject rating in icon form"),-- not implemented + _("$(LABELS) - color labels as text"), + -- _("$(LABELS.ICONS) - color labels as icons"),-- not implemented + _("$(TITLE) - title from metadata"), + _("$(DESCRIPTION) - description from metadata"), + _("$(CREATOR) - creator from metadata"), + _("$(PUBLISHER) - publisher from metadata"), + _("$(RIGHTS) - rights from metadata"), + --_("$(TAGS) - tags as set in metadata settings"), + _("$(CATEGORY[n,category]) - subtag of level n in hierarchical tags"), + _("$(SIDECAR_TXT) - contents of .txt sidecar file, if present"), + _("$(FOLDER.PICTURES) - pictures folder"), + _("$(FOLDER.HOME) - home folder"), + _("$(FOLDER.DESKTOP) - desktop folder"), + -- _("$(OPENCL.ACTIVATED) - whether OpenCL is activated"), + _("$(USERNAME) - login name"), + -- _("$(NL) - newline"), + -- _("$(JOBCODE) - job code for import"), + ""}, "\n") +end + +-- handle different versions of names + +local function check_legacy_vars(var_name) + local var = var_name + + if string.match(var, "_") then + var = string.gsub(var, "_", ".") + end + + if string.match(var, "^HOME$") then var = "FOLDER.HOME" end + if string.match(var, "^PICTURES.FOLDER$") then var = "FOLDER.PICTURES" end + if string.match(var, "^DESKTOP$") then var = "FOLDER.DESKTOP" end + + return var +end + +-- get the substitution and do any string manipulations requested + +local function treat(var_string) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + local ret_val = "" + + -- remove the var from the string + local var = string.match(var_string, "[%a%._]+") + + var = check_legacy_vars(var) + log.msg(log.info, "var_string is " .. tostring(var_string) .. " and var is " .. tostring(var)) + + if string.match(var_string, "CATEGORY%d") or string.match(var_string, "CATEGORY%[") then + log.msg(log.info, "substituting for " .. var_string) + ret_val = substitutes[var_string] + if not ret_val then ret_val = "" end + log.msg(log.info, "ret_val is " .. ret_val) + + elseif string.match(var_string, "SEQUENCE%[") then + local width, start = string.match(var_string, "(%d+),(%d)") + local seq_val = tonumber(substitutes[var]) + local pat = "%0" .. width .. "d" + substitutes[var_string] = string.format(pat, start + (seq_val - 1)) + ret_val = substitutes[var_string] + + else + ret_val = substitutes[var] + end + + local valid_var = false + + if ret_val then + valid_var = true + end + + if not valid_var then + log.msg(log.error, "variable " .. var .. " is not an allowed variable, returning empty value") + log.log_level(old_log_level) + return "" + end + + -- string modifications + + local args = string.gsub(var_string, var, "") + log.msg(log.info, "args is " .. tostring(args)) + + if string.len(args) > 0 then + + if string.match(args, '^%^%^') then + ret_val = string.upper(ret_val) + + elseif string.match(args, "^%^") then + ret_val = string.gsub(ret_val, "^%a", string.upper, 1) + + elseif string.match(args, "^,,") then + ret_val = string.lower(ret_val) + + elseif string.match(args, "^,") then + ret_val = string.gsub(ret_val, "^%a", string.lower, 1) + + elseif string.match(args, "^:%-?%d+:%-?%d+") then + + local soffset, slen = string.match(args, ":(%-?%d+):(%-?%d+)") + log.msg(log.info, "soffset is " .. soffset .. " and slen is " .. slen) + + if tonumber(soffset) >= 0 then + soffset = soffset + 1 + end + log.msg(log.info, "soffset is " .. soffset .. " and slen is " .. slen) + + if tonumber(soffset) < 0 and tonumber(slen) < 0 then + local temp = soffset + soffset = slen + slen = temp + end + log.msg(log.info, "soffset is " .. soffset .. " and slen is " .. slen) + + ret_val = string.sub(ret_val, soffset, slen) + log.msg(log.info, "ret_val is " .. ret_val) + + elseif string.match(args, "^:%-?%d+") then + + local soffset= string.match(args, ":(%-?%d+)") + if tonumber(soffset) >= 0 then + soffset = soffset + 1 + end + ret_val = string.sub(ret_val, soffset, -1) + + elseif string.match(args, "^-%$%(.-%)") then + + local replacement = string.match(args, "-%$%(([%a%._]+)%)") + replacement = check_legacy_vars(replacement) + if string.len(ret_val) == 0 then + ret_val = substitutes[replacement] + end + + elseif string.match(args, "^-.+$") then + + local replacement = string.match(args, "-(.+)$") + if string.len(ret_val) == 0 then + ret_val = replacement + end + + elseif string.match(args, "^+.+") then + + local replacement = string.match(args, "+(.+)") + if string.len(ret_val) > 0 then + ret_val = replacement + end + + elseif string.match(args, "^#.+") then + + local pattern = string.match(args, "#(.+)") + log.msg(log.info, "pattern to remove is " .. tostring(pattern)) + ret_val = string.gsub(ret_val, "^" .. dtutils_string.sanitize_lua(pattern), "") + + elseif string.match(args, "^%%.+") then + + local pattern = string.match(args, "%%(.+)") + ret_val = string.gsub(ret_val, pattern .. "$", "") + + elseif string.match(args, "^//.-/.+") then + + local pattern, replacement = string.match(args, "//(.-)/(.+)") + ret_val = string.gsub(ret_val, pattern, replacement) + + elseif string.match(args, "^/#.+/.+") then + + local pattern, replacement = string.match(args, "/#(.+)/(.+)") + ret_val = string.gsub(ret_val, "^" .. pattern, replacement, 1) + + elseif string.match(args, "^/%%.-/.+") then + + local pattern, replacement = string.match(args, "/%%(.-)/(.+)") + ret_val = string.gsub(ret_val, pattern .. "$", replacement) + + elseif string.match(args, "^/.-/.+") then + + log.msg(log.info, "took replacement branch") + local pattern, replacement = string.match(args, "/(.-)/(.+)") + ret_val = string.gsub(ret_val, pattern, replacement, 1) + end + + end + log.log_level(old_log_level) + return ret_val +end + +dtutils_string.libdoc.functions["substitute_list"] = { + Name = [[substitute_list]], + Synopsis = [[Replace variables in a string with their computed values]], + Usage = [[local ds = require "lib/dtutils.string" + local result = ds.substitute_list(str) + str - string - the string containing the variables to be substituted for]], + Description = [[substitute_list replaces the variables in the supplied string with + values computed in build_substitution_list().]], + Return_Value = [[result - string - the input string with values substituted for the variables]], + Limitations = [[]], + Example = [[]], + See_Also = [[https://docs.darktable.org/usermanual/4.6/en/special-topics/variables/]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.substitute_list(str) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + -- replace the substitution variables in a string + for match in string.gmatch(str, "%$%(.-%)?%)") do + + local var = string.match(match, "%$%((.-%)?)%)") + + local treated_var = treat(var) + log.msg(log.info, "var is " .. var .. " and treated var is " .. tostring(treated_var)) + + str = string.gsub(str, "%$%(".. dtutils_string.sanitize_lua(var) .."%)", tostring(treated_var)) + log.msg(log.info, "str after replacement is " .. str) + + end + + log.log_level(old_log_level) + + return str +end + +dtutils_string.libdoc.functions["clear_substitute_list"] = { + Name = [[clear_substitute_list]], + Synopsis = [[Clear the computed list of variable substitution values]], + Usage = [[local ds = require "lib/dtutils.string" + ds.clear_substitute_list()]], + Description = [[clear_substitute_list resets the list of variable replacement values]], + Return_Value = [[]], + Limitations = [[]], + Example = [[]], + See_Also = [[]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.clear_substitute_list() + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + substitutes = {} + category_substitutes = {} + + log.log_level(old_log_level) +end + +dtutils_string.libdoc.functions["substitute"] = { + Name = [[substitute]], + Synopsis = [[Perform all the variable substitution steps with one function call]], + Usage = [[local ds = require "lib/dtutils.string" + ds.substitute(image, sequence, variable_string, [username], [pic_folder], [home], [desktop]) + image - dt_lua_image_t - the image being processed + sequence - integer - the number of the image being processed (exported) + variable_string - string - the substitution variable string + [username] - string - optional - user name. Will be determined if not supplied + [pic_folder] - string - optional - pictures folder name. Will be determined if not supplied + [home] - string - optional - home directory. Will be determined if not supplied + [desktop] - string - optional - desktop directory. Will be determined if not supplied]], + Description = [[substitute initializes the substitution list by calling clear_substitute_list(), + then builds the substitutions by calling build_substitute_list() and finally does the + substitution by calling substitute_list(), then returns the result string.]], + Return_Value = [[result - string - the input string with values substituted for the variables]], + Limitations = [[]], + Example = [[]], + See_Also = [[https://docs.darktable.org/usermanual/4.6/en/special-topics/variables/]], + Reference = [[]], + License = [[]], + Copyright = [[]], +} + +function dtutils_string.substitute(image, sequence, variable_string, username, pic_folder, home, desktop) + local old_log_level = log.log_level() + log.log_level(dtutils_string.log_level) + + dtutils_string.clear_substitute_list() + + dtutils_string.build_substitute_list(image, sequence, variable_string, username, pic_folder, home, desktop) + + local str = dtutils_string.substitute_list(variable_string) + + log.log_level(old_log_level) + + return str +end + + return dtutils_string diff --git a/lib/dtutils/system.lua b/lib/dtutils/system.lua index f202d6d4..10ea29f3 100644 --- a/lib/dtutils/system.lua +++ b/lib/dtutils/system.lua @@ -1,7 +1,7 @@ local dtutils_system = {} local dt = require "darktable" -require "official/yield" -- necessary for dt.control.execute() +local ds = require "lib/dtutils.string" dtutils_system.libdoc = { Name = [[dtutils.system]], @@ -86,8 +86,13 @@ function dtutils_system.windows_command(command) local file = io.open(fname, "w") if file then dt.print_log("opened file") - command = string.gsub(command, "%%", "%%%%") -- escape % from windows shell - file:write(command) + file:write("@echo off\n") + file:write('for /f "tokens=2 delims=:." %%x in (\'chcp\') do set cp=%%x\n') + file:write("chcp 65001>nul\n") -- change the encoding of the terminal to handle non-english characters in path + file:write("\n") + file:write(command .. "\n") + file:write("\n") + file:write("chcp %cp%>nul\n") file:close() result = dt.control.execute(fname) @@ -119,6 +124,7 @@ dtutils_system.libdoc.functions["launch_default_app"] = { License = [[]], Copyright = [[]], } + function dtutils_system.launch_default_app(path) local open_cmd = "xdg-open " if (dt.configuration.running_os == "windows") then @@ -129,5 +135,4 @@ function dtutils_system.launch_default_app(path) return dtutils_system.external_command(open_cmd .. path) end - return dtutils_system diff --git a/locale/de_DE/LC_MESSAGES/OpenInExplorer.po b/locale/de_DE/LC_MESSAGES/OpenInExplorer.po new file mode 100644 index 00000000..f0dc8ef1 --- /dev/null +++ b/locale/de_DE/LC_MESSAGES/OpenInExplorer.po @@ -0,0 +1,78 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# Volker Lenhardt , 2020. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-06-11 19:07+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: de_DE\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: OpenInExplorer.lua:71 +msgid "" +"OpenInExplorer plug-in only supports Linux and macOS, and Windows at this time" +msgstr "OpenInExplorer-Plug-in unterstützt zur Zeit nur Linux, macOS oder Windows" + +#: OpenInExplorer.lua:87 +msgid "" +"No links directory selected.\n" +"Please check the dt preferences (lua options)" +msgstr "Kein Verknüpfungs-Verzeichnis ausgewählt.\nBitte die dt-Voreinstellungen überprüfen (Lua-Optionen)" + +#: OpenInExplorer.lua:91 +#, lua-format +msgid "" +"Links directory '%s' not found.\n" +"Please check the dt preferences (lua options)" +msgstr "Das Verknüpfungs-Verzeichnis '%s' konnte nicht gefunden werden.\nBitte die dt-Voreinstellungen überprüfen (Lua-Optionen)" + +#: OpenInExplorer.lua:148 +msgid "Failed to create links. Missing rights?" +msgstr "Die Verknüpfungen konnten nicht erstellt werden. Fehlende Rechte?" + +#: OpenInExplorer.lua:164 +msgid "Please select an image" +msgstr "Es wurde kein Bild ausgewählt" + +#: OpenInExplorer.lua:170 +msgid "Please select fewer images (max. 15)" +msgstr "Bitte nicht mehr als 15 Bilder auswählen" + +#: OpenInExplorer.lua:186 +msgid "show in file explorer" +msgstr "im Dateimanager anzeigen" + +#: OpenInExplorer.lua:188 +msgid "Open the file manager at the selected image's location" +msgstr "Öffnet den Dateimanager an der Position des ausgewählten Bildes" + +#: OpenInExplorer.lua:193 +msgid "OpenInExplorer: linked files directory" +msgstr "OpenInExplorer: Verknüpfungs-Verzeichnis" + +#: OpenInExplorer.lua:194 +msgid "" +"Directory to store the links to the file names. Requires restart to take " +"effect" +msgstr "Verzeichnis für die Verknüpfungen zu den Dateinamen. Erfordert dt-Neustart" + +#: OpenInExplorer.lua:197 +msgid "Select directory" +msgstr "Verzeichnis auswählen" + +#: OpenInExplorer.lua:203 +msgid "OpenInExplorer: use links" +msgstr "OpenInExplorer: Verknüpfungen nutzen" + +#: OpenInExplorer.lua:204 +msgid "Use links instead of multiple windows. Requires restart to take effect" +msgstr "Verknüpfungen statt einzelner Fenster nutzen. Erfordert dt-Neustart" diff --git a/locale/de_DE/LC_MESSAGES/clear_GPS.po b/locale/de_DE/LC_MESSAGES/clear_GPS.po index ad8960b0..420ec484 100644 --- a/locale/de_DE/LC_MESSAGES/clear_GPS.po +++ b/locale/de_DE/LC_MESSAGES/clear_GPS.po @@ -14,7 +14,7 @@ msgstr "" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=CHARSET\n" +"Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Poedit 1.5.4\n" "Language: de_DE\n" diff --git a/locale/de_DE/LC_MESSAGES/photils.po b/locale/de_DE/LC_MESSAGES/photils.po new file mode 100644 index 00000000..b81dbc70 --- /dev/null +++ b/locale/de_DE/LC_MESSAGES/photils.po @@ -0,0 +1,73 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Lua photils\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-05-12 13:12+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: de\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +msgid "get tags" +msgstr "hole stichwörter" + +msgid "requires a restart to be applied" +msgstr "erfordert einen Neustart um angewendet zu werden" + +msgid "min confidence value" +msgstr "min vertrauenswert" + +msgid "" +"The suggested tags were not generated\n" +" for the currently selected image!" +msgstr "" +"Die vorgeschlagenen Stichwörter wurden für das\n" +"aktuell ausgewählte Bild nicht generiert!" + +#, lua-format +msgid " page %s of %s " +msgstr " seite %s von %s " + +msgid "Tags successfully attached to image" +msgstr "Stichwörter erfolgreich an Bild angefügt" + +#, lua-format +msgid "Error writing to `%s`" +msgstr "Fehler beim Schreiben in `%s`" + +#, lua-format +msgid "%s failed, see terminal output for details" +msgstr "%s fehlgeschlagen, siehe Terminal-Ausgabe für Details" + +#, lua-format +msgid "%s found %d tags for your image" +msgstr "%s gefunden %d-Stichwörter für Ihr Bild" + +msgid "No image selected." +msgstr "Kein Bild ausgewählt." + +msgid "This plugin can only handle a single image." +msgstr "Dieses Plugin kann nur ein einziges Bild verarbeiten." + +#, lua-format +msgid "attach %d tags" +msgstr "%d stichwörter anhängen" + +msgid "photils-cli not found" +msgstr "photils-cli nicht gefunden" + +msgid "" +"Select an image, click \"Get Tags\" and get \n" +"suggestions for tags." +msgstr "" +"Wählen Sie ein Bild aus, drücken Sie \"Hole Stichwörter\"\n" +" und erhalten Sie Vorschläge für Stichwörter." diff --git a/locale/de_DE/LC_MESSAGES/select_non_existing.po b/locale/de_DE/LC_MESSAGES/select_non_existing.po new file mode 100644 index 00000000..c36ff806 --- /dev/null +++ b/locale/de_DE/LC_MESSAGES/select_non_existing.po @@ -0,0 +1,12 @@ +msgid "" +msgstr "" +"Content-Type: text/plain; charset=UTF-8\n" + +msgid "select non existing images" +msgstr "nicht vorhandene Bilder auswählen" + +msgid "select non existing" +msgstr "nicht vorhandene auswählen" + +msgid "select all non-existing images in the current images" +msgstr "alle nicht vorhandenen Bilder in den aktuellen Bildern auswählen" diff --git a/locale/fr_FR/LC_MESSAGES/OpenInExplorer.po b/locale/fr_FR/LC_MESSAGES/OpenInExplorer.po new file mode 100644 index 00000000..02109e06 --- /dev/null +++ b/locale/fr_FR/LC_MESSAGES/OpenInExplorer.po @@ -0,0 +1,85 @@ +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2022-06-27 17:22+0200\n" +"PO-Revision-Date: 2022-06-27 17:36+0200\n" +"Last-Translator: Manuel PINTOR \n" +"Language-Team: \n" +"Language: fr_FR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.3\n" +"X-Poedit-Basepath: ../../../contrib\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Poedit-SearchPath-0: OpenInExplorer.lua\n" + +#: OpenInExplorer.lua:79 +msgid "" +"OpenInExplorer plug-in only supports Linux, macOS, and Windows at this time" +msgstr "" +"Le script OpenInExplorer ne fonctionne que sur Linux, macOS et Windows pour " +"le moment" + +#: OpenInExplorer.lua:95 +msgid "" +"No links directory selected.\n" +"Please check the dt preferences (lua options)" +msgstr "" +"Aucun répertoire de liens sélectionné.\n" +"Voir dans les préférences dt > options lua" + +#: OpenInExplorer.lua:99 +#, lua-format +msgid "" +"Links directory '%s' not found.\n" +"Please check the dt preferences (lua options)" +msgstr "" +"Répertoire de liens '%s' inexistant.\n" +"Voir dans les préférences dt > options lua" + +#: OpenInExplorer.lua:156 +msgid "Failed to create links. Missing rights?" +msgstr "Erreur de création de liens. Droits insuffisants ?" + +#: OpenInExplorer.lua:172 +msgid "Please select an image" +msgstr "Sélectionner une image SVP" + +#: OpenInExplorer.lua:178 +msgid "Please select fewer images (max. 15)" +msgstr "Sélectionner moins d'images SVP (max. 15)" + +#: OpenInExplorer.lua:203 +msgid "show in file explorer" +msgstr "afficher dans le gestionnaire de fichiers" + +#: OpenInExplorer.lua:205 +msgid "Open the file manager at the selected image's location" +msgstr "Ouvre le gestionnaire de fichiers à l'endroit de l'image sélectionnée" + +#: OpenInExplorer.lua:212 +msgid "OpenInExplorer: linked files directory" +msgstr "OpenInExplorer : répertoire des fichiers liés" + +#: OpenInExplorer.lua:213 +msgid "" +"Directory to store the links to the file names. Requires restart to take " +"effect" +msgstr "" +"Répertoire dans lequel enregistrer les liens sur les fichiers. Nécessite un " +"redémarrage de dt" + +#: OpenInExplorer.lua:216 +msgid "Select directory" +msgstr "Sélectionner un répertoire" + +#: OpenInExplorer.lua:222 +msgid "OpenInExplorer: use links" +msgstr "OpenInExplorer : utiliser des liens" + +#: OpenInExplorer.lua:223 +msgid "Use links instead of multiple windows. Requires restart to take effect" +msgstr "" +"Utiliser des liens plutôt que de multiples fenêtres. Nécessite un " +"redémarrage de dt" diff --git a/locale/fr_FR/LC_MESSAGES/clear_GPS.po b/locale/fr_FR/LC_MESSAGES/clear_GPS.po index 9b345c67..a61be082 100644 --- a/locale/fr_FR/LC_MESSAGES/clear_GPS.po +++ b/locale/fr_FR/LC_MESSAGES/clear_GPS.po @@ -7,21 +7,29 @@ msgid "" msgstr "" "Project-Id-Version: \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2016-09-07 22:25-0400\n" -"PO-Revision-Date: 2016-10-03 14:55+0200\n" -"Last-Translator: Pascal Obry \n" +"POT-Creation-Date: 2020-12-27 17:55+0100\n" +"PO-Revision-Date: 2020-12-27 17:55+0100\n" +"Last-Translator: Christophe Agathon \n" +"Language-Team: \n" "Language: fr_FR\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"X-Generator: Poedit 1.8.9\n" -"Language: fr_FR\n" +"X-Generator: Poedit 2.3\n" "X-Poedit-SourceCharset: UTF-8\n" -"X-Poedit-KeywordsList: gettext;dgettext:2;dcgettext:2ngettext:1,2;" +"X-Poedit-KeywordsList: _;gettext;dgettext:2;dcgettext:2ngettext:1,2;" "dngettext:2,3\n" -"X-Poedit-Basepath: .\n" -"Language-Team: \n" +"X-Poedit-Basepath: ../../../contrib\n" +"X-Poedit-SearchPath-0: clear_GPS.lua\n" -#: clear_GPS.lua:62 +#: clear_GPS.lua:67 msgid "clear GPS data" msgstr "effacer données GPS" + +#: clear_GPS.lua:69 +msgid "Clear GPS data from selected images" +msgstr "Effacer les données GPS des images sélectionnées" + +#: clear_GPS.lua:75 +msgid "Clear GPS data" +msgstr "Effacer les données GPS" diff --git a/locale/fr_FR/LC_MESSAGES/copy_attach_detach_tags.po b/locale/fr_FR/LC_MESSAGES/copy_attach_detach_tags.po new file mode 100644 index 00000000..f7ee47e7 --- /dev/null +++ b/locale/fr_FR/LC_MESSAGES/copy_attach_detach_tags.po @@ -0,0 +1,78 @@ +# French messages for copy_attach_detach_tags.lua +# Christophe Agathon , 2021 +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2021-01-10 19:39+0100\n" +"PO-Revision-Date: 2021-01-10 19:43+0100\n" +"Last-Translator: Christophe Agathon \n" +"Language-Team: \n" +"Language: fr_FR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.3\n" +"X-Poedit-Basepath: ../../../contrib\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Poedit-KeywordsList: _\n" +"X-Poedit-SearchPath-0: copy_attach_detach_tags.lua\n" + +#: copy_attach_detach_tags.lua:93 +msgid "Image tags copied ..." +msgstr "Mots-clés de l'image copiés ..." + +#: copy_attach_detach_tags.lua:115 +msgid "No tag to attach, please copy tags first." +msgstr "Pas de mot-clé à attacher, veuillez d'abord copier les mots-clés." + +#: copy_attach_detach_tags.lua:139 +msgid "Tags attached ..." +msgstr "Mots-clés attachés ..." + +#: copy_attach_detach_tags.lua:155 +msgid "Tags removed from image(s)." +msgstr "Mots-clés supprimés des images." + +#: copy_attach_detach_tags.lua:161 +msgid "Tags replaced" +msgstr "Mots-clés remplacés" + +#: copy_attach_detach_tags.lua:166 +msgid "tagging addon" +msgstr "mots-clés extra" + +#: copy_attach_detach_tags.lua:189 +msgid "tag clipboard" +msgstr "presse-papier des mots-clés" + +#: copy_attach_detach_tags.lua:197 +msgid "multi copy tags" +msgstr "copier mots-clés" + +#: copy_attach_detach_tags.lua:198 copy_attach_detach_tags.lua:252 +msgid "copy tags from selected image(s)" +msgstr "copier les mots-clés des images sélectionnnées" + +#: copy_attach_detach_tags.lua:201 copy_attach_detach_tags.lua:257 +msgid "paste tags to selected image(s)" +msgstr "coller les mots clés dans les images sélectionnées" + +#: copy_attach_detach_tags.lua:202 +msgid "paste tags" +msgstr "coller mots-clés" + +#: copy_attach_detach_tags.lua:210 +msgid "replace tags" +msgstr "remplacer mots-clés" + +#: copy_attach_detach_tags.lua:211 copy_attach_detach_tags.lua:267 +msgid "replace tags from selected image(s)" +msgstr "remplacer les mots-clés des images sélectionnées" + +#: copy_attach_detach_tags.lua:214 +msgid "remove all tags" +msgstr "supprimer tous mots-clés" + +#: copy_attach_detach_tags.lua:215 copy_attach_detach_tags.lua:262 +msgid "remove tags from selected image(s)" +msgstr "supprimer les mots-clés des images sélectionnées" diff --git a/locale/fr_FR/LC_MESSAGES/copy_paste_metadata.po b/locale/fr_FR/LC_MESSAGES/copy_paste_metadata.po new file mode 100644 index 00000000..aa6dc112 --- /dev/null +++ b/locale/fr_FR/LC_MESSAGES/copy_paste_metadata.po @@ -0,0 +1,35 @@ +# French messages for copy_paste_metadata.lua +# Christophe Agathon , 2020 +msgid "" +msgstr "" +"Project-Id-Version: copy_paste_metadata\n" +"POT-Creation-Date: 2020-12-26 12:49+0100\n" +"PO-Revision-Date: 2020-12-26 12:52+0100\n" +"Last-Translator: Christophe Agathon \n" +"Language-Team: \n" +"Language: fr_FR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.3\n" +"X-Poedit-Basepath: ../../../official\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Poedit-SourceCharset: UTF-8\n" +"X-Poedit-KeywordsList: _\n" +"X-Poedit-SearchPath-0: copy_paste_metadata.lua\n" + +#: copy_paste_metadata.lua:115 +msgid "copy metadata" +msgstr "copier les métadonnées" + +#: copy_paste_metadata.lua:117 +msgid "copy metadata of the first selected image" +msgstr "copier les métadonnées de la première image sélectionnée" + +#: copy_paste_metadata.lua:121 +msgid "paste metadata" +msgstr "coller les métadonnées" + +#: copy_paste_metadata.lua:123 +msgid "paste metadata to the selected images" +msgstr "coller les métadonnées vers les images sélectionnées" diff --git a/locale/fr_FR/LC_MESSAGES/photils.po b/locale/fr_FR/LC_MESSAGES/photils.po new file mode 100644 index 00000000..ceafc472 --- /dev/null +++ b/locale/fr_FR/LC_MESSAGES/photils.po @@ -0,0 +1,117 @@ +# French messages for photils.lua +# Christophe Agathon , 2021 +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2021-08-13 09:04+0200\n" +"PO-Revision-Date: 2021-08-13 09:49+0200\n" +"Last-Translator: Christophe Agathon \n" +"Language-Team: \n" +"Language: fr_FR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.4.1\n" +"X-Poedit-Basepath: ../../../contrib\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Poedit-SearchPath-0: photils.lua\n" + +#: photils.lua:117 +msgid "get tags" +msgstr "trouver des mots-clés" + +#: photils.lua:148 +msgid "requires a restart to be applied" +msgstr "nécessite un redémarrage pour être pris en compte" + +#: photils.lua:163 +msgid "min confidence value" +msgstr "niveau de confiance minimum" + +#: photils.lua:180 +msgid "" +"The suggested tags were not generated\n" +" for the currently selected image!" +msgstr "" +"La proposition de mots-clés n'a pas été générée\n" +" pour l'image sélectionnée actuellement !" + +#: photils.lua:186 +#, lua-format +msgid " page %s of %s " +msgstr " page %s de %s " + +#: photils.lua:237 +msgid "Apply tag to image" +msgstr "Appliquer les mots-clés à l'image" + +#: photils.lua:249 +msgid "Tags successfully attached to image" +msgstr "Les mots-clés ont bien été ajoutés à l'image" + +#: photils.lua:299 +#, lua-format +msgid "%s found %d tags for your image" +msgstr "%s a trouvé %d mots-clés pour votre image" + +#: photils.lua:315 +msgid "No image selected." +msgstr "Pas d'image sélectionnée." + +#: photils.lua:319 +msgid "This plugin can only handle a single image." +msgstr "Ce plugin ne peut gérer qu'une seule image." + +#: photils.lua:326 +#, lua-format +msgid "%s failed, see terminal output for details" +msgstr "" +"%s a échoué, consultez les messages sur le terminal pour plus de détails" + +#: photils.lua:334 +#, lua-format +msgid "no tags where found" +msgstr "aucun mot-clé n'a été trouvé" + +#: photils.lua:365 +#, lua-format +msgid "attach %d tags" +msgstr "ajouter %d mots-clés" + +#: photils.lua:429 photils.lua:430 +msgid "photils-cli not found" +msgstr "photils-cli non trouvé" + +#: photils.lua:432 +msgid "" +"Select an image, click \"get tags\" and get \n" +"suggestions for tags." +msgstr "" +"Sélectionnez une image, cliquez sur « trouver des mots-clés » \n" +"pour obtenir une proposition de mots-clés." + +#: photils.lua:467 +msgid "photils: show confidence value" +msgstr "photils: afficher le niveau de confiance" + +# Original message should begin with capital I +#: photils.lua:468 +msgid "if enabled, the confidence value for each tag is displayed" +msgstr "Si activé, le niveau de confiance de chaque mot-clé est affiché" + +#: photils.lua:474 +msgid "photils: use exported image for tag request" +msgstr "photils: utiliser l'image exportée pour la recherche de mots-clés" + +#: photils.lua:475 +msgid "" +"If enabled, the image passed to photils for tag suggestion is based on the " +"exported, already edited image. Otherwise, the embedded thumbnail of the RAW " +"file will be used for tag suggestion.The embedded thumbnail could speedup " +"the tag suggestion but can fail if the RAW file is not supported." +msgstr "" +"Si activé, l'image passée à photils pour la proposition de mots-clés est " +"basée sur l'export de l'image déjà éditée. Sinon, c'est la vignette " +"encapsulée dans le fichier RAW qui sera utilisée. La vignette encapsulée " +"pourra accélérer la proposition des mots-clés mais la recherche échouera si " +"le fichier RAW n'est pas supporté." diff --git a/locale/fr_FR/LC_MESSAGES/script_manager.po b/locale/fr_FR/LC_MESSAGES/script_manager.po new file mode 100644 index 00000000..fbfc1064 --- /dev/null +++ b/locale/fr_FR/LC_MESSAGES/script_manager.po @@ -0,0 +1,188 @@ +# French messages for script_manager.lua +# Christophe Agathon , 2020 +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2020-12-28 10:22+0100\n" +"PO-Revision-Date: 2020-12-28 10:24+0100\n" +"Last-Translator: Christophe Agathon \n" +"Language-Team: \n" +"Language: fr_FR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.3\n" +"X-Poedit-Basepath: ../../../tools\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Poedit-KeywordsList: _\n" +"X-Poedit-SearchPath-0: script_manager.lua\n" + +#: script_manager.lua:190 +msgid "Cant read from " +msgstr "Ne peut pas lire " + +#: script_manager.lua:204 +msgid "Loaded " +msgstr "Script chargé : " + +#: script_manager.lua:207 +msgid " failed to load" +msgstr " non chargé" + +#: script_manager.lua:223 +msgid " will not start when darktable is restarted" +msgstr " ne démarrera pas lorsque darktable sera redémarré" + +#: script_manager.lua:281 script_manager.lua:345 +msgid "find command is " +msgstr "la commande find est " + +#: script_manager.lua:321 +msgid "lua scripts successfully updated" +msgstr "mise à jour des scripts lua réussie" + +#: script_manager.lua:381 +msgid "category " +msgstr "la catégorie " + +#: script_manager.lua:381 +msgid " is already in use. Please specify a different category name." +msgstr " est déjà utilisée. Indiquez un autre nom de catégorie SVP." + +#: script_manager.lua:410 +msgid "scripts successfully installed into category " +msgstr "les scripts ont été installés dans la catégorie " + +#: script_manager.lua:426 +msgid "No scripts found to install" +msgstr "Nous n'avons pas trouvé de script à installer" + +#: script_manager.lua:430 +msgid "failed to download scripts" +msgstr "impossible de télécharger les scripts" + +# Peut-être que « activé » serait mieux, mais ce n'est pas la traduction de « started » +#: script_manager.lua:458 +msgid " started" +msgstr " démarré" + +# Peut-être que « désactivé » serait mieux, mais ce n'est pas la traduction de « stopped » +#: script_manager.lua:460 +msgid " stopped" +msgstr " arrêté" + +#: script_manager.lua:545 +msgid "Page " +msgstr "Page " + +#: script_manager.lua:545 +msgid " of " +msgstr " sur " + +#: script_manager.lua:674 +msgid "scripts to update" +msgstr "scripts à mettre à jour" + +#: script_manager.lua:675 +msgid "select the scripts installation to update" +msgstr "sélectionnez les scripts à mettre à jour" + +#: script_manager.lua:684 script_manager.lua:742 +msgid "update scripts" +msgstr "mettre à jour les scripts" + +#: script_manager.lua:685 +msgid "update the lua scripts from the repository" +msgstr "metre à jour les scripts depuis le dépôt" + +#: script_manager.lua:696 +msgid "enter the URL of the git repository containing the scripts you wish to add" +msgstr "indiquez l'URL du dépôt git contenant les scripts que vous souhaitez ajouter" + +#: script_manager.lua:701 +msgid "name of new category" +msgstr "nom de la nouvelle catégorie" + +#: script_manager.lua:702 +msgid "enter a category name for the additional scripts" +msgstr "indiquez un nom de catégorie pour les scripts supplémentaires" + +#: script_manager.lua:707 +msgid "URL to download additional scripts from" +msgstr "URL d'où seront téléchargés les scripts" + +#: script_manager.lua:709 +msgid "new category to place scripts in" +msgstr "nouvelle catégorie où seront placés les scripts" + +#: script_manager.lua:712 +msgid "install additional scripts" +msgstr "installer les scripts supplémentaires" + +#: script_manager.lua:720 +msgid "Enable \"Disable Scripts\" button" +msgstr "Activer le bouton « Désactiver les Scripts »" + +#: script_manager.lua:730 +msgid "Disable Scripts" +msgstr "Désactiver les scripts" + +#: script_manager.lua:736 +msgid "lua scripts will not run the next time darktable is started" +msgstr "les scripts lua ne seront pas lancés au prochain démarrage de darktable" + +#: script_manager.lua:745 +msgid "add more scripts" +msgstr "ajouter des scripts" + +#: script_manager.lua:747 +msgid "disable scripts" +msgstr "désactiver les scripts" + +#: script_manager.lua:755 +msgid "category" +msgstr "catégorie" + +#: script_manager.lua:756 +msgid "select the script category" +msgstr "sélectionner la catégorie" + +#: script_manager.lua:780 +msgid "Page:" +msgstr "Page :" + +#: script_manager.lua:808 +msgid "Scripts" +msgstr "Scripts" + +#: script_manager.lua:817 +msgid "scripts per page" +msgstr "scripts par page" + +#: script_manager.lua:818 +msgid "select number of start/stop buttons to display" +msgstr "sélectionner le nombre de boutons marche/arrêt à afficher" + +#: script_manager.lua:829 +msgid "change number of buttons" +msgstr "changer le nombre de boutons" + +#: script_manager.lua:837 +msgid "Configuration" +msgstr "Configuration" + +#: script_manager.lua:858 +msgid "action" +msgstr "action" + +#: script_manager.lua:864 +msgid "install/update scripts" +msgstr "installer/mettre à jour des scripts" + +#: script_manager.lua:864 +msgid "configure" +msgstr "configurer" + +#: script_manager.lua:864 +msgid "start/stop scripts" +msgstr "démarrer/arrêter des scripts" diff --git a/locale/it_IT/LC_MESSAGES/executable_manager.po b/locale/it_IT/LC_MESSAGES/executable_manager.po new file mode 100644 index 00000000..9e31669d --- /dev/null +++ b/locale/it_IT/LC_MESSAGES/executable_manager.po @@ -0,0 +1,62 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Maurizio Paglia , 2022. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-07-11 22:19+0200\n" +"PO-Revision-Date: 2022-07-11 22:21+0200\n" +"Last-Translator: Maurizio Paglia \n" +"Language-Team: Italian <>\n" +"Language: it\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"X-Generator: Lokalize 21.12.3\n" + +#: executable_manager.lua:144 +msgid "No executable paths found, exiting..." +msgstr "Nessun percorso con eseguibili, esco..." + +#: executable_manager.lua:160 +msgid "select an executable" +msgstr "seleziona un eseguibile" + +#: executable_manager.lua:160 +msgid "search path for executable" +msgstr "cerca il percorso dell'eseguibile" + +#: executable_manager.lua:169 +msgid "select " +msgstr "seleziona" + +#: executable_manager.lua:169 +msgid " executable" +msgstr " eseguibile" + +#: executable_manager.lua:190 +msgid "select executable to modify" +msgstr "Seleziona l'eseguibile da modificare" + +#: executable_manager.lua:205 +msgid "current" +msgstr "Attuale" + +#: executable_manager.lua:207 +msgid "select" +msgstr "Seleziona" + +#: executable_manager.lua:209 +msgid "reset" +msgstr "Cancella" + +#: executable_manager.lua:212 +msgid "Clear path for " +msgstr "Cancella il percorso di " + +#: executable_manager.lua:211 +msgid "clear" +msgstr "Pulisci" diff --git a/locale/it_IT/LC_MESSAGES/script_manager.po b/locale/it_IT/LC_MESSAGES/script_manager.po new file mode 100644 index 00000000..d0f1ac59 --- /dev/null +++ b/locale/it_IT/LC_MESSAGES/script_manager.po @@ -0,0 +1,190 @@ +# French messages for script_manager.lua +# Christophe Agathon , 2020. +# Maurizio Paglia , 2021, 2022. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2020-12-28 10:22+0100\n" +"PO-Revision-Date: 2022-07-11 22:03+0200\n" +"Last-Translator: Maurizio Paglia \n" +"Language-Team: Italian <>\n" +"Language: fr_FR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Lokalize 21.12.3\n" +"X-Poedit-Basepath: ../../../tools\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Poedit-KeywordsList: _\n" +"X-Poedit-SearchPath-0: script_manager.lua\n" + +#: script_manager.lua:190 +msgid "Cant read from " +msgstr "Non posso leggere da " + +#: script_manager.lua:204 +msgid "Loaded " +msgstr "Script caricato " + +#: script_manager.lua:207 +msgid " failed to load" +msgstr "Non riesco a caricare lo script" + +#: script_manager.lua:223 +msgid " will not start when darktable is restarted" +msgstr " non verrà avviato al riavvio di darktable" + +#: script_manager.lua:281 script_manager.lua:345 +msgid "find command is " +msgstr "Il comando find è " + +#: script_manager.lua:321 +msgid "lua scripts successfully updated" +msgstr "Gli script lua sono stati correttamente aggiornati" + +#: script_manager.lua:381 +msgid "category " +msgstr "Categoria" + +#: script_manager.lua:381 +msgid " is already in use. Please specify a different category name." +msgstr " è già utilizzato. Prego specificare un nome differente." + +#: script_manager.lua:410 +msgid "scripts successfully installed into category " +msgstr "Gli script sono stati installati correttamente nella categoria " + +#: script_manager.lua:426 +msgid "No scripts found to install" +msgstr "Non trovo script da installare" + +#: script_manager.lua:430 +msgid "failed to download scripts" +msgstr "Non riesco a scaricare gli script" + +# Peut-être que « activé » serait mieux, mais ce n'est pas la traduction de « started » +#: script_manager.lua:458 +msgid " started" +msgstr " avviato" + +# Peut-être que « désactivé » serait mieux, mais ce n'est pas la traduction de « stopped » +#: script_manager.lua:460 +msgid " stopped" +msgstr " bloccato" + +#: script_manager.lua:545 +msgid "Page " +msgstr "Pag." + +#: script_manager.lua:545 +msgid " of " +msgstr " di " + +#: script_manager.lua:674 +msgid "scripts to update" +msgstr "Script da aggiornare" + +#: script_manager.lua:675 +msgid "select the scripts installation to update" +msgstr "Selezionare l'installazione di script da aggiornare" + +#: script_manager.lua:684 script_manager.lua:742 +msgid "update scripts" +msgstr "Aggiornare gli script" + +#: script_manager.lua:685 +msgid "update the lua scripts from the repository" +msgstr "Aggiornare gli script lua del repo" + +#: script_manager.lua:696 +msgid "" +"enter the URL of the git repository containing the scripts you wish to add" +msgstr "Immettere l'URL del repo git che contiene gli script da aggiungere" + +#: script_manager.lua:701 +msgid "name of new category" +msgstr "Nome della nuova categoria" + +#: script_manager.lua:702 +msgid "enter a category name for the additional scripts" +msgstr "Immettere il nome della categoria per altri script" + +#: script_manager.lua:707 +msgid "URL to download additional scripts from" +msgstr "URL dal quale scaricare ulteriori script" + +#: script_manager.lua:709 +msgid "new category to place scripts in" +msgstr "Nuova categoria che dovrà contenere gli script" + +#: script_manager.lua:712 +msgid "install additional scripts" +msgstr "Installare gli script aggiuntivi" + +#: script_manager.lua:720 +msgid "Enable \"Disable Scripts\" button" +msgstr "Abilita il pulsante \"Disabilita Script\"" + +#: script_manager.lua:730 +msgid "Disable Scripts" +msgstr "Disabilita Script" + +#: script_manager.lua:736 +msgid "lua scripts will not run the next time darktable is started" +msgstr "Gli script lua non verranno avviati al prossimo riavvio di darktable" + +#: script_manager.lua:745 +msgid "add more scripts" +msgstr "Aggiungi altri script" + +#: script_manager.lua:747 +msgid "disable scripts" +msgstr "Disabilita script" + +#: script_manager.lua:755 +msgid "category" +msgstr "categoria" + +#: script_manager.lua:756 +msgid "select the script category" +msgstr "Seleziona la categoria" + +#: script_manager.lua:780 +msgid "Page:" +msgstr "Pag.:" + +#: script_manager.lua:808 +msgid "Scripts" +msgstr "Scripts" + +#: script_manager.lua:817 +msgid "scripts per page" +msgstr "Script per pagina" + +#: script_manager.lua:818 +msgid "select number of start/stop buttons to display" +msgstr "Selezionare il numero di pulsanti da visualizzare" + +#: script_manager.lua:829 +msgid "change number of buttons" +msgstr "Modifica la quantità di pulsanti" + +#: script_manager.lua:837 +msgid "Configuration" +msgstr "Configurazione" + +#: script_manager.lua:858 +msgid "action" +msgstr "Azione" + +#: script_manager.lua:864 +msgid "install/update scripts" +msgstr "Installa/aggiorna script" + +#: script_manager.lua:864 +msgid "configure" +msgstr "Configura" + +#: script_manager.lua:864 +msgid "start/stop scripts" +msgstr "Avvia/blocca script" diff --git a/locale/pt_BR/LC_MESSAGES/AutoGrouper.po b/locale/pt_BR/LC_MESSAGES/AutoGrouper.po new file mode 100644 index 00000000..23681b7f --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/AutoGrouper.po @@ -0,0 +1,46 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 19:54-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/AutoGrouper.lua:144 +msgid "auto group" +msgstr "grupo automático" + +#: ../contrib/AutoGrouper.lua:173 +msgid "group gap [sec.]" +msgstr "intervalo de agrupamento [seg]" + +#: ../contrib/AutoGrouper.lua:174 +msgid "minimum gap, in seconds, between groups" +msgstr "intervalo mínimo, em segundos, entre os grupos" + +#: ../contrib/AutoGrouper.lua:187 +msgid "auto group: selected" +msgstr "grupo automático: selecionado" + +#: ../contrib/AutoGrouper.lua:188 +msgid "auto group selected images" +msgstr "agrupa automaticamente as imagens selecionadas" + +#: ../contrib/AutoGrouper.lua:192 +msgid "auto group: collection" +msgstr "grupo automático: coleção" + +#: ../contrib/AutoGrouper.lua:193 +msgid "auto group the entire collection" +msgstr "agrupa automaticamente toda a coleção" diff --git a/locale/pt_BR/LC_MESSAGES/CollectHelper.po b/locale/pt_BR/LC_MESSAGES/CollectHelper.po new file mode 100644 index 00000000..d9aca975 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/CollectHelper.po @@ -0,0 +1,97 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 20:02-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/CollectHelper.lua:74 +msgid "Please select a single image" +msgstr "Por favor, selecione uma única imagem" + +#: ../contrib/CollectHelper.lua:124 +msgid "select an image with an active color label" +msgstr "selecione uma imagem com uma etiqueta de cor ativa" + +#: ../contrib/CollectHelper.lua:205 +msgid "collect: previous" +msgstr "colecionar: anterior" + +#: ../contrib/CollectHelper.lua:207 +msgid "Sets the Collect parameters to be the previously active parameters" +msgstr "Define os parâmetros da coleção para os ativos anteriormente" + +#: ../contrib/CollectHelper.lua:211 +msgid "collect: folder" +msgstr "colecionar: pasta" + +#: ../contrib/CollectHelper.lua:213 +msgid "Sets the Collect parameters to be the selected images's folder" +msgstr "Define os parâmetros da coleção para a pasta de imagens selecionada" + +#: ../contrib/CollectHelper.lua:218 +msgid "collect: color label(s)" +msgstr "colecionar: etiqueta(s) de cor" + +#: ../contrib/CollectHelper.lua:220 +msgid "Sets the Collect parameters to be the selected images's color label(s)" +msgstr "" +"Define os parâmetros da coleção para a(s) etiqueta(s) de cor das imagens" +" selecionadas" + +#: ../contrib/CollectHelper.lua:225 +msgid "collect: all (AND)" +msgstr "colecionar: tudo (E)" + +#: ../contrib/CollectHelper.lua:227 +msgid "" +"Sets the Collect parameters based on all activated CollectHelper options" +msgstr "Define os parâmetros da coleção baseado em todas as opções do script" + +#: ../contrib/CollectHelper.lua:234 +msgid "CollectHelper: All" +msgstr "CollectHelper: Tudo" + +#: ../contrib/CollectHelper.lua:235 +msgid "" +"Will create a collect parameter set that utilizes all enabled CollectHelper " +"types (AND)" +msgstr "" +"Criará um conjunto de parâmetros de coleção que utilizará todos os tipos " +"habilitados do CollectHelper (E)" + +#: ../contrib/CollectHelper.lua:240 +msgid "CollectHelper: Color Label(s)" +msgstr "CollectHelper: Etiqueta(s) de Cor" + +#: ../contrib/CollectHelper.lua:241 +msgid "" +"Enable the button that allows you to swap to a collection based on selected " +"image's COLOR LABEL(S)" +msgstr "" +"Habilita o botão que permite que você alterna para uma coleção baseada na " +"ETIQUETA(S) DE COR da imagem selecionada" + +#: ../contrib/CollectHelper.lua:246 +msgid "CollectHelper: Folder" +msgstr "CollectHelper: Pasta" + +#: ../contrib/CollectHelper.lua:247 +msgid "" +"Enable the button that allows you to swap to a collection based on selected " +"image's FOLDER location" +msgstr "" +"Habilita o botão que permite que você alterne para uma coleção baseada na " +"PASTA da imagem selecionada" diff --git a/locale/pt_BR/LC_MESSAGES/HDRMerge.po b/locale/pt_BR/LC_MESSAGES/HDRMerge.po new file mode 100644 index 00000000..b60cb139 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/HDRMerge.po @@ -0,0 +1,163 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:40-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/HDRMerge.lua:175 +msgid "please update you binary location" +msgstr "por favor, atualize a localização do binário" + +#: ../contrib/HDRMerge.lua:194 +msgid "update successful" +msgstr "atualização bem sucedida" + +#: ../contrib/HDRMerge.lua:196 +msgid "update unsuccessful, please try again" +msgstr "atualização mau sucedida, tente de novo" + +#: ../contrib/HDRMerge.lua:210 +msgid "HDRMerge install issue" +msgstr "problema com a instalação do HDRMerge" + +#: ../contrib/HDRMerge.lua:211 +msgid "HDRMerge install issue, please ensure the binary path is proper" +msgstr "" +"problema com a instalação do HDRMerge, certifique-se de que o caminho do" +" binário esteja correto" + +#: ../contrib/HDRMerge.lua:216 +msgid "not enough images selected, select at least 2 images to merge" +msgstr "" +"imagens selecionadas insuficientes, selecione apenas 2 imagens para mesclar" + +#: ../contrib/HDRMerge.lua:277 +msgid "HDRMerge completed successfully" +msgstr "HDRMerge completado com sucesso" + +#: ../contrib/HDRMerge.lua:279 ../contrib/HDRMerge.lua:280 +msgid "HDRMerge failed" +msgstr "HDRMerge falhou" + +#: ../contrib/HDRMerge.lua:289 +msgid "HDRMerge" +msgstr "HDRMerge" + +#: ../contrib/HDRMerge.lua:312 +msgid "HDRMerge options" +msgstr "opções do HDRMerge" + +#: ../contrib/HDRMerge.lua:317 +msgid "bits per sample" +msgstr "bits por amostra" + +#: ../contrib/HDRMerge.lua:318 +msgid "number of bits per sample in the output image" +msgstr "número de bits por amostra na imagem de saída" + +#: ../contrib/HDRMerge.lua:334 +msgid "embedded preview size" +msgstr "tamanho da pré-visualização embutida" + +#: ../contrib/HDRMerge.lua:335 +msgid "size of the embedded preview in output image" +msgstr "tamanho da pré-visualização embutida na imagem de saída" + +#: ../contrib/HDRMerge.lua:337 ../contrib/HDRMerge.lua:382 +msgid "none" +msgstr "nenhum" + +#: ../contrib/HDRMerge.lua:337 +msgid "half" +msgstr "metade" + +#: ../contrib/HDRMerge.lua:337 +msgid "full" +msgstr "completo" + +#: ../contrib/HDRMerge.lua:349 +msgid "batch mode" +msgstr "modo em lote" + +#: ../contrib/HDRMerge.lua:351 +msgid "" +"enable batch mode operation \n" +"NOTE: resultant files will NOT be auto-imported" +msgstr "" +"ativar a operação em modo em lote\n" +"NOTA: arquivos resultantes NÃO serão importados automaticamente" + +#: ../contrib/HDRMerge.lua:361 +msgid "batch gap [sec.]" +msgstr "intervalo do lote [seg.]" + +#: ../contrib/HDRMerge.lua:362 +msgid "gap, in seconds, between batch mode groups" +msgstr "intervalo, em segundos, entre os grupos do modo em lote" + +#: ../contrib/HDRMerge.lua:376 +msgid "import options" +msgstr "opções de importação" + +#: ../contrib/HDRMerge.lua:379 +msgid "apply style on import" +msgstr "aplicar estilo ao importar" + +#: ../contrib/HDRMerge.lua:380 +msgid "Apply selected style on auto-import to newly created image" +msgstr "" +"Aplica o estilo selecionado ao importar automaticamente para novas imagens" +" criadas" + +#: ../contrib/HDRMerge.lua:400 +msgid "copy tags" +msgstr "copiar etiquetas" + +#: ../contrib/HDRMerge.lua:402 +msgid "copy tags from first source image" +msgstr "copia etiquetas da primeira imagem fonte" + +#: ../contrib/HDRMerge.lua:409 +msgid "" +"Additional tags to be added on import. Seperate with commas, all spaces will " +"be removed" +msgstr "" +"Etiquetas adicionais a serem anexadas ao importar. Separar com vírgulas," +" todos os espaços serão removidos" + +#: ../contrib/HDRMerge.lua:411 +msgid "Enter tags, seperated by commas" +msgstr "Insira as etiquetas, separadas por vírgulas" + +#: ../contrib/HDRMerge.lua:415 +msgid "merge" +msgstr "mesclar" + +#: ../contrib/HDRMerge.lua:416 +msgid "run HDRMerge with the above specified settings" +msgstr "rodar o HDRMerge com as configurações especificadas acima" + +#: ../contrib/HDRMerge.lua:420 +msgid "Select HDRmerge executable" +msgstr "Selecionar o executável do HDRmerge" + +#: ../contrib/HDRMerge.lua:425 +msgid "update" +msgstr "atualizar" + +#: ../contrib/HDRMerge.lua:426 +msgid "update the binary path with current value" +msgstr "atualiza o caminho do binário com o valor atual" diff --git a/locale/pt_BR/LC_MESSAGES/OpenInExplorer.po b/locale/pt_BR/LC_MESSAGES/OpenInExplorer.po new file mode 100644 index 00000000..9779db96 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/OpenInExplorer.po @@ -0,0 +1,86 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 23:40-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/OpenInExplorer.lua:79 +msgid "" +"OpenInExplorer plug-in only supports Linux, macOS, and Windows at this time" +msgstr "" +"Atualmente, o plugin OpenInExplorer somente suporta Linux, macOS e Windows" + +#: ../contrib/OpenInExplorer.lua:95 +msgid "" +"No links directory selected.\n" +"Please check the dt preferences (lua options)" +msgstr "" +"Nenhum link para pasta selecionado.\n" +"Verifique as preferências do darktable (opções lua)" + +#: ../contrib/OpenInExplorer.lua:99 +#, lua-format +msgid "" +"Links directory '%s' not found.\n" +"Please check the dt preferences (lua options)" +msgstr "" +"Links para pasta '%s' não encontrados.\n" +"Verifique as preferências do darktable (opções lua)" + +#: ../contrib/OpenInExplorer.lua:156 +msgid "Failed to create links. Missing rights?" +msgstr "Falha ao criar links. Possui permissões adequadas?" + +#: ../contrib/OpenInExplorer.lua:172 +msgid "Please select an image" +msgstr "Por favor, selecione uma imagem" + +#: ../contrib/OpenInExplorer.lua:178 +msgid "Please select fewer images (max. 15)" +msgstr "Por favor, selecione menos imagens (máx 15)" + +#: ../contrib/OpenInExplorer.lua:203 +msgid "show in file explorer" +msgstr "mostrar no navegador de arquivos" + +#: ../contrib/OpenInExplorer.lua:205 +msgid "Open the file manager at the selected image's location" +msgstr "Abre o gerenciador de arquivos na localização das imagens selecionadas" + +#: ../contrib/OpenInExplorer.lua:212 +msgid "OpenInExplorer: linked files directory" +msgstr "OpenInExplorer: pasta de arquivos linkada" + +#: ../contrib/OpenInExplorer.lua:213 +msgid "" +"Directory to store the links to the file names. Requires restart to take " +"effect" +msgstr "" +"Pasta para armazenar os links para os nomes de arquivo. Precisa reiniciar" +" para ter efeito" + +#: ../contrib/OpenInExplorer.lua:216 +msgid "Select directory" +msgstr "Selecione a pasta" + +#: ../contrib/OpenInExplorer.lua:222 +msgid "OpenInExplorer: use links" +msgstr "OpenInExplorer: usar links" + +#: ../contrib/OpenInExplorer.lua:223 +msgid "Use links instead of multiple windows. Requires restart to take effect" +msgstr "" +"Usa links ao invés de janelas múltiplas. Precisa reiniciar para ter efeito" diff --git a/locale/pt_BR/LC_MESSAGES/RL_out_sharp.po b/locale/pt_BR/LC_MESSAGES/RL_out_sharp.po new file mode 100644 index 00000000..1b5b3ed6 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/RL_out_sharp.po @@ -0,0 +1,74 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:31-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/RL_out_sharp.lua:119 +msgid "GMic executable not configured" +msgstr "executável GMic não configurado" + +#: ../contrib/RL_out_sharp.lua:139 +msgid "sharpening image " +msgstr "melhorar nitidez da imagem " + +#: ../contrib/RL_out_sharp.lua:154 +msgid "sharpening error" +msgstr "erro ao melhorar nitidez" + +#: ../contrib/RL_out_sharp.lua:163 +msgid "finished exporting" +msgstr "exportação finalizada" + +#: ../contrib/RL_out_sharp.lua:175 ../contrib/RL_out_sharp.lua:176 +msgid "select output folder" +msgstr "selecionar pasta de saída" + +#: ../contrib/RL_out_sharp.lua:185 +msgid "sigma" +msgstr "sigma" + +#: ../contrib/RL_out_sharp.lua:186 +msgid "controls the width of the blur that's applied" +msgstr "controla a largura do desfoque que é aplicada" + +#: ../contrib/RL_out_sharp.lua:197 +msgid "iterations" +msgstr "iterações" + +#: ../contrib/RL_out_sharp.lua:198 +msgid "increase for better sharpening, but slower" +msgstr "aumente para melhor efeito, mas diminui velocidade" + +#: ../contrib/RL_out_sharp.lua:209 +msgid "output jpg quality" +msgstr "qualidade do jpg de saída" + +#: ../contrib/RL_out_sharp.lua:210 +msgid "quality of the output jpg file" +msgstr "qualidade do arquivo jpg de saída" + +#: ../contrib/RL_out_sharp.lua:229 +msgid "RL output sharpen" +msgstr "melhoria de nitidez na saída RL" + +#: ../contrib/RL_out_sharp.lua:233 +msgid "executable for GMic CLI" +msgstr "executável para o GMic CLI" + +#: ../contrib/RL_out_sharp.lua:234 +msgid "select executable for GMic command line version" +msgstr "selecione o executável para a versão de linha de comando do GMic" diff --git a/locale/pt_BR/LC_MESSAGES/clear_GPS.po b/locale/pt_BR/LC_MESSAGES/clear_GPS.po new file mode 100644 index 00000000..d96c0daf --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/clear_GPS.po @@ -0,0 +1,30 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 19:53-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/clear_GPS.lua:81 +msgid "clear GPS data" +msgstr "limpar dados de GPS" + +#: ../contrib/clear_GPS.lua:83 +msgid "Clear GPS data from selected images" +msgstr "Limpa os dados de GPS das imagens selecionadas" + +#: ../contrib/clear_GPS.lua:89 +msgid "Clear GPS data" +msgstr "Limpar dados de GPS" diff --git a/locale/pt_BR/LC_MESSAGES/color_profile_manager.po b/locale/pt_BR/LC_MESSAGES/color_profile_manager.po new file mode 100644 index 00000000..103ce0b4 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/color_profile_manager.po @@ -0,0 +1,90 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-30 19:05-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/color_profile_manager.lua:122 +msgid "added color profile " +msgstr "perfil de cor adicionado " + +#: ../contrib/color_profile_manager.lua:128 +msgid "removed color profile " +msgstr "perfil de cor removido " + +#: ../contrib/color_profile_manager.lua:146 +msgid "ERROR: color profile must be an icc or icm file" +msgstr "ERRO: perfil de cor deve ser um arquivo icm ou icc" + +#: ../contrib/color_profile_manager.lua:229 +msgid "color profile manager" +msgstr "gerenciador de perfil de cor" + +#: ../contrib/color_profile_manager.lua:270 +msgid "initialize color profiles" +msgstr "inicializar perfis de cor" + +#: ../contrib/color_profile_manager.lua:271 +msgid "create the directory structure to contain the color profiles" +msgstr "cria a estrutura de pasta para conter os perfis de cor" + +#: ../contrib/color_profile_manager.lua:286 +msgid "select profile set" +msgstr "selecionar definição de perfil" + +#: ../contrib/color_profile_manager.lua:287 +msgid "select input or output profiles" +msgstr "selecionar perfis de entrada ou saída" + +#: ../contrib/color_profile_manager.lua:294 +msgid "input" +msgstr "entrada" + +#: ../contrib/color_profile_manager.lua:294 +msgid "output" +msgstr "saída" + +#: ../contrib/color_profile_manager.lua:298 +msgid "select color profile to add" +msgstr "selecionar perfil de cor a adicionar" + +#: ../contrib/color_profile_manager.lua:299 +msgid "select the .icc or .icm file to add" +msgstr "selecionar arquivo icc ou icm a adicionar" + +#: ../contrib/color_profile_manager.lua:306 +msgid "add profile" +msgstr "adicionar perfil" + +#: ../contrib/color_profile_manager.lua:309 +msgid "add selected color profile" +msgstr "adicionar perfil de cor selecionado" + +#: ../contrib/color_profile_manager.lua:310 +msgid "add selected file to profiles" +msgstr "adicionar arquivo selecionado aos perfis" + +#: ../contrib/color_profile_manager.lua:320 +msgid "remove profile" +msgstr "remover perfil" + +#: ../contrib/color_profile_manager.lua:323 +msgid "remove selected profile(s)" +msgstr "remover perfil(s) selecionado(s)" + +#: ../contrib/color_profile_manager.lua:324 +msgid "remove the checked profile(s)" +msgstr "remover o(s) perfil(s) marcado(s)" diff --git a/locale/pt_BR/LC_MESSAGES/copy_attach_detach_tags.po b/locale/pt_BR/LC_MESSAGES/copy_attach_detach_tags.po new file mode 100644 index 00000000..f9fcd12e --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/copy_attach_detach_tags.po @@ -0,0 +1,86 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 19:52-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/copy_attach_detach_tags.lua:101 +msgid "Image tags copied ..." +msgstr "Etiquetas de imagem copiadas ..." + +#: ../contrib/copy_attach_detach_tags.lua:123 +msgid "No tag to attach, please copy tags first." +msgstr "Nenhuma etiqueta anexada, por favor copie as etiquetas primeiro." + +#: ../contrib/copy_attach_detach_tags.lua:147 +msgid "Tags attached ..." +msgstr "Etiquetas anexadas ..." + +#: ../contrib/copy_attach_detach_tags.lua:163 +msgid "Tags removed from image(s)." +msgstr "Etiquetas removidas da(s) imagem(ns) " + +#: ../contrib/copy_attach_detach_tags.lua:169 +msgid "Tags replaced" +msgstr "Etiquetas substituídas" + +#: ../contrib/copy_attach_detach_tags.lua:174 +msgid "tagging addon" +msgstr "addon de etiquetas" + +#: ../contrib/copy_attach_detach_tags.lua:204 +#: ../contrib/copy_attach_detach_tags.lua:241 +#: ../contrib/copy_attach_detach_tags.lua:294 +msgid "copy tags from selected image(s)" +msgstr "copiar etiquetas da(s) imagem(ns) selecionada(s)" + +#: ../contrib/copy_attach_detach_tags.lua:209 +#: ../contrib/copy_attach_detach_tags.lua:244 +#: ../contrib/copy_attach_detach_tags.lua:299 +msgid "paste tags to selected image(s)" +msgstr "colar etiquetas para a(s) imagem(ns) selecionada(s)" + +#: ../contrib/copy_attach_detach_tags.lua:214 +#: ../contrib/copy_attach_detach_tags.lua:257 +#: ../contrib/copy_attach_detach_tags.lua:304 +msgid "remove tags from selected image(s)" +msgstr "remover etiquetas da(s) imagem(ns) selecionada(s)" + +#: ../contrib/copy_attach_detach_tags.lua:219 +#: ../contrib/copy_attach_detach_tags.lua:253 +#: ../contrib/copy_attach_detach_tags.lua:309 +msgid "replace tags from selected image(s)" +msgstr "substituir etiquetas a partir da(s) imagem(ns) selecionada(s)" + +#: ../contrib/copy_attach_detach_tags.lua:232 +msgid "tag clipboard" +msgstr "área de transferência de etiqueta" + +#: ../contrib/copy_attach_detach_tags.lua:240 +msgid "multi copy tags" +msgstr "copiar etiquetas múltiplas" + +#: ../contrib/copy_attach_detach_tags.lua:245 +msgid "paste tags" +msgstr "colar etiquetas" + +#: ../contrib/copy_attach_detach_tags.lua:252 +msgid "replace tags" +msgstr "substituir etiquetas" + +#: ../contrib/copy_attach_detach_tags.lua:256 +msgid "remove all tags" +msgstr "remover todas as etiquetas" diff --git a/locale/pt_BR/LC_MESSAGES/copy_paste_metadata.po b/locale/pt_BR/LC_MESSAGES/copy_paste_metadata.po new file mode 100644 index 00000000..572c3774 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/copy_paste_metadata.po @@ -0,0 +1,34 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 14:57-0300\n" +"PO-Revision-Date: 2021-09-28 19:38-0300\n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"X-Generator: Lokalize 21.08.1\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +#: copy_paste_metadata.lua:131 +msgid "copy metadata" +msgstr "copiar metadados" + +#: copy_paste_metadata.lua:133 +msgid "copy metadata of the first selected image" +msgstr "copiar metadados da primeira imagem selecionada" + +#: copy_paste_metadata.lua:139 +msgid "paste metadata" +msgstr "colar metadados" + +#: copy_paste_metadata.lua:141 +msgid "paste metadata to the selected images" +msgstr "colar metadados para as imagens selecionadas" diff --git a/locale/pt_BR/LC_MESSAGES/enfuse.po b/locale/pt_BR/LC_MESSAGES/enfuse.po new file mode 100644 index 00000000..6218f876 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/enfuse.po @@ -0,0 +1,61 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 15:19-0300\n" +"PO-Revision-Date: 2021-09-28 19:39-0300\n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"X-Generator: Lokalize 21.08.1\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +#: enfuse.lua:187 +#, lua-format +msgid "Error writing to `%s`" +msgstr "Erro ao salvar `%s`" + +#: enfuse.lua:210 +#, lua-format +msgid "Converting raw file '%s' to tiff..." +msgstr "Converter arquivo raw `%s` para tiff..." + +#: enfuse.lua:220 +#, lua-format +msgid "Skipping %s..." +msgstr "Pulando %s..." + +#: enfuse.lua:227 +msgid "No suitable images selected, nothing to do for enfuse" +msgstr "Nenhuma imagem adequada selecionado, nada a fazer para o script" + +#: enfuse.lua:233 +#, lua-format +msgid "%d image(s) skipped" +msgstr "%d imagem(ns) pulada(s)" + +#: enfuse.lua:253 +msgid "Enfuse failed, see terminal output for details" +msgstr "Script falhou, veja a saída do terminal para detalhes" + +#: enfuse.lua:265 +msgid "enfuse was successful, resulting image has been imported" +msgstr "script foi bem sucedido, imagem resultante foi importada" + +#: enfuse.lua:267 +#, lua-format +msgid "enfuse: done, resulting image '%s' has been imported with id %d" +msgstr "enfuse: feito, imagem '%s' resultante foi importada com o id %d" + +#: enfuse.lua:301 +msgid "Could not find enfuse executable. Not loading enfuse exporter..." +msgstr "" +"Não foi possível encontrar o executável do enfuse. Exportador do enfuse não" +" carregado..." diff --git a/locale/pt_BR/LC_MESSAGES/enfuseAdvanced.po b/locale/pt_BR/LC_MESSAGES/enfuseAdvanced.po new file mode 100644 index 00000000..f1b785c1 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/enfuseAdvanced.po @@ -0,0 +1,555 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:03-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/enfuseAdvanced.lua:250 +msgid "please update your binary locations" +msgstr "por favor, atualiza suas localizações de binários" + +#: ../contrib/enfuseAdvanced.lua:262 +msgid "issue with " +msgstr "problema com " + +#: ../contrib/enfuseAdvanced.lua:262 +msgid " executable" +msgstr " executável" + +#: ../contrib/enfuseAdvanced.lua:271 +msgid "update successful" +msgstr "atualização bem sucedida" + +#: ../contrib/enfuseAdvanced.lua:273 +msgid "update unsuccessful, please try again" +msgstr "atualização mau sucedida, tente novamente" + +#: ../contrib/enfuseAdvanced.lua:379 +msgid "saved to " +msgstr "salvar para " + +#: ../contrib/enfuseAdvanced.lua:395 +msgid "loaded from " +msgstr "carregado de " + +#: ../contrib/enfuseAdvanced.lua:430 +msgid "export for image fusion " +msgstr "exportar para fusão de imagem " + +#: ../contrib/enfuseAdvanced.lua:435 +msgid "too few images selected, please select at least 2 images" +msgstr "muito poucas imagens selecionadas, selecione pelo menos 2 imagens" + +#: ../contrib/enfuseAdvanced.lua:438 +msgid "installation error, please verify binary paths are proper" +msgstr "" +"erro de instalação, verifique se as localizações dos binários estão corretas" + +#: ../contrib/enfuseAdvanced.lua:458 ../contrib/enfuseAdvanced.lua:459 +#: ../contrib/enfuseAdvanced.lua:485 ../contrib/enfuseAdvanced.lua:486 +msgid " failed" +msgstr " falhou" + +#: ../contrib/enfuseAdvanced.lua:534 +msgid "image align options" +msgstr "opções de alinhamento de imagem" + +#: ../contrib/enfuseAdvanced.lua:537 +msgid "align images" +msgstr "alinhar imagens" + +#: ../contrib/enfuseAdvanced.lua:539 +msgid "automatically align images prior to enfuse" +msgstr "alinha automaticamente as imagens antes de fundir" + +#: ../contrib/enfuseAdvanced.lua:549 +msgid "optimize radial distortion" +msgstr "otimizar distorção radial" + +#: ../contrib/enfuseAdvanced.lua:551 +msgid "" +"optimize radial distortion for all images, \n" +"except for first" +msgstr "" +"otimiza a distorção radial para todas as imagens, \n" +"exceto para a primeira" + +#: ../contrib/enfuseAdvanced.lua:556 +msgid "optimize field of view" +msgstr "otimizar o campo de visão" + +#: ../contrib/enfuseAdvanced.lua:558 +msgid "" +"optimize field of view for all images, except for first. \n" +"Useful for aligning focus stacks (DFF) with slightly \n" +"different magnification." +msgstr "" +"otimizar o campo de visão para todas as imagens, exceto para a primeira. \n" +"Útil para alinhar foco empilhado (DFF, sigla em inglês) com ampliação \n" +"ligeiramente diferente." + +#: ../contrib/enfuseAdvanced.lua:563 +msgid "optimize image center shift" +msgstr "otimizar deslocamento do centro da imagem" + +#: ../contrib/enfuseAdvanced.lua:565 +msgid "" +"optimize image center shift for all images, \n" +"except for first." +msgstr "" +"otimiza o deslocamento do centro da imagem para\n" +"todas as imagens, exceto a primeira." + +#: ../contrib/enfuseAdvanced.lua:570 +msgid "auto crop" +msgstr "recorte automático" + +#: ../contrib/enfuseAdvanced.lua:572 +msgid "auto crop the image to the area covered by all images." +msgstr "" +"recorta automaticamente a imagem para a área coberta por todas\n" +"as imagens." + +#: ../contrib/enfuseAdvanced.lua:577 +msgid "load distortion from lens database" +msgstr "carregar distorção a partir da base de dados de lentes" + +#: ../contrib/enfuseAdvanced.lua:579 +msgid "try to load distortion information from lens database" +msgstr "tenta carregar informações de distorção da base de dados de lentes" + +#: ../contrib/enfuseAdvanced.lua:584 +msgid "use gpu" +msgstr "usar gpu" + +#: ../contrib/enfuseAdvanced.lua:586 +msgid "use gpu during alignment" +msgstr "usa a gpu durante o alinhamento" + +#: ../contrib/enfuseAdvanced.lua:593 +msgid "image grid size" +msgstr "tamanho da grade de imagem" + +#: ../contrib/enfuseAdvanced.lua:594 +msgid "" +"break image into a rectangular grid \n" +"and attempt to find num control points in each section.\n" +"default: (5x5)" +msgstr "" +"quebra a imagem em uma grade retangular e \n" +"tenta encontrar um número de pontos de controle\n" +"em cada seção.\n" +"padrão: (5x5)" + +#: ../contrib/enfuseAdvanced.lua:610 +msgid "control points/grid" +msgstr "pontos de controle/grade" + +#: ../contrib/enfuseAdvanced.lua:611 +msgid "" +"number of control points (per grid, see option -g) \n" +"to create between adjacent images \n" +"default: (8)." +msgstr "" +"número de pontos de controle (por grade, veja a opção -g)\n" +"para criar entre imagens adjacentes \n" +"padrão: (8)" + +#: ../contrib/enfuseAdvanced.lua:627 +msgid "remove control points with error" +msgstr "remover pontos de controle com erro" + +#: ../contrib/enfuseAdvanced.lua:628 +msgid "" +"remove all control points with an error higher \n" +"than num pixels \n" +"default: (3)" +msgstr "" +"remove todos os pontos de controle com um erro superior\n" +"que um número de pixels\n" +"padrão: (3)" + +#: ../contrib/enfuseAdvanced.lua:644 +msgid "correlation threshold for control points" +msgstr "limiar de correlação para pontos de controle" + +#: ../contrib/enfuseAdvanced.lua:645 +msgid "" +"correlation threshold for identifying \n" +"control points \n" +"default: (0.9)." +msgstr "" +"limiar de correlação para identificar pontos\n" +"de controle\n" +"padrão: (0,9)" + +#: ../contrib/enfuseAdvanced.lua:659 +msgid "image fusion options" +msgstr "opções de fusão de imagem" + +#: ../contrib/enfuseAdvanced.lua:664 +msgid "exposure weight" +msgstr "peso da exposição" + +#: ../contrib/enfuseAdvanced.lua:665 +msgid "" +"set the relative weight of the well-exposedness criterion \n" +"as defined by the chosen exposure weight function. \n" +"increasing this weight relative to the others will\n" +" make well-exposed pixels contribute more to\n" +" the final output. \n" +"default: (1.0)" +msgstr "" +"configura o peso relativo do critério de boa exposição como\n" +"definido pela função de peso de exposição.\n" +"aumentar este peso relativo para outros fará com que\n" +"os pixels bem expostos contribuam mais para a saída\n" +"final.\n" +"padrão: (1,0)" + +#: ../contrib/enfuseAdvanced.lua:676 +msgid "saturation weight" +msgstr "peso da saturação" + +#: ../contrib/enfuseAdvanced.lua:677 +msgid "" +"set the relative weight of high-saturation pixels. \n" +"increasing this weight makes pixels with high \n" +"saturation contribute more to the final output. \n" +"default: (0.2)" +msgstr "" +"configura o peso relativo dos pixels altamente saturados.\n" +"aumentar este peso fará com que os pixels com alta saturação\n" +"contribuam mais para a saída final. " +"padrão: (0,2)" + +#: ../contrib/enfuseAdvanced.lua:688 +msgid "contrast weight" +msgstr "peso do contraste" + +#: ../contrib/enfuseAdvanced.lua:689 +msgid "" +"sets the relative weight of high local-contrast pixels. \n" +"default: (0.0)." +msgstr "" +"configura o peso relativo dos pixels com alto contraste local.\n" +"padrão: (0,0)" + +#: ../contrib/enfuseAdvanced.lua:700 +msgid "exposure optimum" +msgstr "exposição ótima" + +#: ../contrib/enfuseAdvanced.lua:701 +msgid "" +"determine at what normalized exposure value\n" +" the optimum exposure of the input images\n" +" is. this is, set the position of the maximum\n" +" of the exposure weight curve. use this \n" +"option to fine-tune exposure weighting. \n" +"default: (0.5)" +msgstr "" +"determina qual valor de exposição normalizado\n" +"é a exposição ótima da imagem de entrada.\n" +"isto é, define a posição do máximo de exposição\n" +"da curva de peso. use esta opção para ajustar o\n" +"peso da exposição.\n" +"padrão: (0,5)" + +#: ../contrib/enfuseAdvanced.lua:712 +msgid "exposure width" +msgstr "largura da exposição" + +#: ../contrib/enfuseAdvanced.lua:713 +msgid "" +"set the characteristic width (FWHM) of the exposure \n" +"weight function. low numbers give less weight to \n" +"pixels that are far from the user-defined \n" +"optimum and vice versa. use this option to \n" +"fine-tune exposure weighting. \n" +"default: (0.2)" +msgstr "" +"configura a largura característica (FWHM) da função de peso\n" +"da exposição. números baixos atribuem menos peso para os\n" +"pixels que estão longe do ótimo definido pelo usuário e vice-\n" +"versa. use esta opção para ajustar o peso da exposição.\n" +"padrão: (0,2)" + +#: ../contrib/enfuseAdvanced.lua:722 +msgid "hard mask" +msgstr "máscara dura" + +#: ../contrib/enfuseAdvanced.lua:724 +msgid "" +"force hard blend masks on the finest scale. this avoids \n" +"averaging of fine details (only), at the expense \n" +"of increasing the noise. this improves the \n" +"sharpness of focus stacks considerably.\n" +"default (soft mask)" +msgstr "" +"força máscaras de mesclagem duras na escala mais fina. isto\n" +"previne aproximação dos detalhes mais finos (somente), ao\n" +"custo de aumentar o ruído. isto melhora a nitidez do empilha-\n" +"mento de foco consideravelmente.\n" +"padrão (máscara suave)" + +#: ../contrib/enfuseAdvanced.lua:729 +msgid "save masks" +msgstr "salvar máscaras" + +#: ../contrib/enfuseAdvanced.lua:731 +msgid "" +"Save the generated weight masks to your home directory,\n" +"enblend saves masks as 8 bit grayscale, \n" +"i.e. single channel images. \n" +"for accuracy we recommend to choose a lossless format." +msgstr "" +"Salva as máscaras de peso geradas para sua pasta pessoal,\n" +"mescla máscaras salvas como tons de cinza de 8 bits, isto é,\n" +"imagens de canal simples.\n" +"para maior precisão, nós recomendamos escolher um formato\n" +"sem perdas." + +#: ../contrib/enfuseAdvanced.lua:738 +msgid "contrast window size" +msgstr "tamanho da janela de contraste" + +#: ../contrib/enfuseAdvanced.lua:739 +msgid "" +"set the window size for local contrast analysis. \n" +"the window will be a square of size × size pixels. \n" +"if given an even size, Enfuse will \n" +"automatically use the next odd number.\n" +"for contrast analysis size values larger \n" +"than 5 pixels might result in a \n" +"blurry composite image. values of 3 and \n" +"5 pixels have given good results on \n" +"focus stacks. \n" +"default: (5) pixels" +msgstr "" +"configura o tamanho da janela para a análise de contraste local.\n" +"a janela será um quadrado de tamanho x tamanho em pixels.\n" +"se fornecido um tamanho par, o script usará automaticamente\n" +"o próximo número ímpar.\n" +"valores de tamanho para análise de contraste maiores que\n" +"5 pixels podem resultar em uma imagem composta borrada.\n" +"valores de 3 e 5 pixels produzem bons resultados para empi-\n" +"lhamento de foco.\n" +"padrão: (5) pixels" + +#: ../contrib/enfuseAdvanced.lua:755 +msgid "contrast edge scale" +msgstr "escala de borda de contraste" + +#: ../contrib/enfuseAdvanced.lua:756 +msgid "" +"a non-zero value for EDGE-SCALE switches on the \n" +"Laplacian-of-Gaussian (LoG) edge detection algorithm.\n" +" edage-scale is the radius of the Gaussian used \n" +"in the search for edges. a positive LCE-SCALE \n" +"turns on local contrast enhancement (LCE) \n" +"before the LoG edge detection. \n" +"Default: (0.0) pixels." +msgstr "" +"um valor diferente de zero para a ESCALA DE BORDA alterna\n" +"o algoritmo de detecção de borda Laplaciano-de-Gaussiano (LoG).\n" +"a escala de borda é o raio do Gaussiano usado na busca por bordas.\n" +"uma escala LCE positiva ativa o melhoramento de contraste local (LCE)\n" +"antes da detecção de borda LoG.\n" +"Padrão: (0,0) pixels" + +#: ../contrib/enfuseAdvanced.lua:772 +msgid "contrast min curvature [%]" +msgstr "curvatura mín de contraste [%]" + +#: ../contrib/enfuseAdvanced.lua:773 +msgid "" +"define the minimum curvature for the LoG edge detection. Append a ‘%’ to " +"specify the minimum curvature relative to maximum pixel value in the source " +"image. Default: (0.0%)" +msgstr "" +"configura a curvatura mínima para a detecção de borda LoG. Adicionar um '%'" +" para " +"definir a curvatura mínima em relação ao valor máximo de pixel na imagem" +" fonte. " +"Padrão: (0,0%)" + +#: ../contrib/enfuseAdvanced.lua:787 +msgid "target file" +msgstr "arquivo alvo" + +#: ../contrib/enfuseAdvanced.lua:792 +msgid "tiff compression" +msgstr "compressão tiff" + +#: ../contrib/enfuseAdvanced.lua:793 +msgid "compression method for tiff files" +msgstr "método de compressão para arquivos tiff" + +#: ../contrib/enfuseAdvanced.lua:809 +msgid "jpeg compression" +msgstr "compressão jpeg" + +#: ../contrib/enfuseAdvanced.lua:810 +msgid "jpeg compression level" +msgstr "nível de compressão jpeg" + +#: ../contrib/enfuseAdvanced.lua:832 +msgid "file format" +msgstr "formato de arquivo" + +#: ../contrib/enfuseAdvanced.lua:833 +msgid "file format of the enfused final image" +msgstr "formato de arquivo da imagem final fundida" + +#: ../contrib/enfuseAdvanced.lua:853 +msgid "bit depth" +msgstr "profundidade de bits" + +#: ../contrib/enfuseAdvanced.lua:854 +msgid "bit depth of the enfused file" +msgstr "profundidade de bits do arquivo fundido" + +#: ../contrib/enfuseAdvanced.lua:868 +msgid "directory" +msgstr "pasta" + +#: ../contrib/enfuseAdvanced.lua:877 +msgid "" +"select the target directory for the fused image. \n" +"the filename is created automatically." +msgstr "" +"seleciona a pasta alvo para a imagem fundida.\n" +"o nome do arquivo é criado automaticamente." + +#: ../contrib/enfuseAdvanced.lua:882 +msgid "save to source image location" +msgstr "salvar para a localização da imagem fonte" + +#: ../contrib/enfuseAdvanced.lua:884 +msgid "" +"If checked ignores the location above and saves output image(s) to the same " +"location as the source images." +msgstr "" +"Se selecionado, ignora a localização acima e salva a(s) imagem(ns) de saída" +" na mesma " +"localização das imagens fonte." + +#: ../contrib/enfuseAdvanced.lua:891 +msgid "on conflict" +msgstr "no caso de conflito" + +#: ../contrib/enfuseAdvanced.lua:905 +msgid "auto import" +msgstr "importar automaticamente" + +#: ../contrib/enfuseAdvanced.lua:907 +msgid "import the image into darktable database when enfuse completes" +msgstr "" +"importa a imagem para a base de dados do darktable quando a fusão for" +" completada" + +#: ../contrib/enfuseAdvanced.lua:918 +msgid "Apply Style on Import" +msgstr "Aplicar estilo ao importar" + +#: ../contrib/enfuseAdvanced.lua:919 +msgid "Apply selected style on auto-import to newly created blended image" +msgstr "" +"Aplica o estilo selecionado ao importar automaticamente para a nova imagem" +" fundida criada" + +#: ../contrib/enfuseAdvanced.lua:938 +msgid "copy tags" +msgstr "copiar etiquetas" + +#: ../contrib/enfuseAdvanced.lua:940 +msgid "Copy tags from first image." +msgstr "Copia as etiquetas da primeira imagem." + +#: ../contrib/enfuseAdvanced.lua:947 +msgid "" +"Additional tags to be added on import. Seperate with commas, all spaces will " +"be removed" +msgstr "" +"Etiquetas adicionais a serem adicionadas ao importar. Separe-as com vírgulas," +" todos " +"os espaços serão removidos" + +#: ../contrib/enfuseAdvanced.lua:955 +msgid "active preset" +msgstr "predefinição ativa" + +#: ../contrib/enfuseAdvanced.lua:956 +msgid "preset to be loaded from or saved to" +msgstr "predefinição a ser carregada de ou salvada para" + +#: ../contrib/enfuseAdvanced.lua:970 +msgid "load fusion preset" +msgstr "carregar predefinição de fusão" + +#: ../contrib/enfuseAdvanced.lua:971 +msgid "load current fusion parameters from selected preset" +msgstr "" +"carrega parâmetros de fusão atuais a partir da predefinição selecionada" + +#: ../contrib/enfuseAdvanced.lua:975 +msgid "save to fusion preset" +msgstr "salvar para predefinição de fusão" + +#: ../contrib/enfuseAdvanced.lua:976 +msgid "save current fusion parameters to selected preset" +msgstr "salva os parâmetros de fusão atuais para a predefinição selecionada" + +#: ../contrib/enfuseAdvanced.lua:980 +msgid "create image variants from presets" +msgstr "criar variantes da imagem a partir das predefinições" + +#: ../contrib/enfuseAdvanced.lua:982 +msgid "" +"create multiple image variants based on the three different presets of the " +"specified type" +msgstr "" +"cria múltiplas variantes da imagem baseadas nas três diferentes predefinições" +" do tipo " +"especificado" + +#: ../contrib/enfuseAdvanced.lua:999 +msgid "create variants type" +msgstr "criar tipos de variantes" + +#: ../contrib/enfuseAdvanced.lua:1000 +msgid "preset type to be used when creating image variants" +msgstr "tipo de predefinição a ser usado ao criar variantes de imagens" + +#: ../contrib/enfuseAdvanced.lua:1039 +msgid "update" +msgstr "atualizar" + +#: ../contrib/enfuseAdvanced.lua:1040 +msgid "update the binary paths with current values" +msgstr "atualiza os caminhos dos binários com os valores atuais" + +#: ../contrib/enfuseAdvanced.lua:1120 +msgid "show options" +msgstr "mostrar opções" + +#: ../contrib/enfuseAdvanced.lua:1121 +msgid "show options for specified aspect of output" +msgstr "mostra as opções para o aspecto de saída especificado" + +#: ../contrib/enfuseAdvanced.lua:1142 +msgid "DRI or DFF image" +msgstr "imagem DRI ou DFF" diff --git a/locale/pt_BR/LC_MESSAGES/executable_manager.po b/locale/pt_BR/LC_MESSAGES/executable_manager.po new file mode 100644 index 00000000..00732548 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/executable_manager.po @@ -0,0 +1,58 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 11:50-0300\n" +"PO-Revision-Date: 2021-09-28 19:39-0300\n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"X-Generator: Lokalize 21.08.1\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +#: executable_manager.lua:144 +msgid "No executable paths found, exiting..." +msgstr "Caminho do executável não encontrado, saindo..." + +#: executable_manager.lua:160 +msgid "select an executable" +msgstr "selecione um executável" + +#: executable_manager.lua:160 +msgid "search path for executable" +msgstr "caminho de pesquisa por executável" + +#: executable_manager.lua:169 +msgid "select " +msgstr "selecionar " + +#: executable_manager.lua:169 +msgid " executable" +msgstr " executável" + +#: executable_manager.lua:190 +msgid "select executable to modify" +msgstr "selecione executável a modificar" + +#: executable_manager.lua:205 +msgid "current" +msgstr "atual" + +#: executable_manager.lua:207 +msgid "select" +msgstr "selecionar" + +#: executable_manager.lua:209 +msgid "reset" +msgstr "reiniciar" + +#: executable_manager.lua:212 +msgid "Clear path for " +msgstr "Limpar caminho para " diff --git a/locale/pt_BR/LC_MESSAGES/exportLUT.po b/locale/pt_BR/LC_MESSAGES/exportLUT.po new file mode 100644 index 00000000..3cac47b2 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/exportLUT.po @@ -0,0 +1,62 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-30 19:25-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/exportLUT.lua:66 +msgid "Identity_file_chooser" +msgstr "Selecionar_arquiv_identidade" + +#: ../contrib/exportLUT.lua:72 +msgid "Export_location_chooser" +msgstr "Selecionar_localização_exportação" + +#: ../contrib/exportLUT.lua:78 +msgid "choose the identity haldclut file" +msgstr "selecione o arquivo halclut de identidade" + +#: ../contrib/exportLUT.lua:82 +msgid "choose the output location" +msgstr "selecione a localização de saída" + +#: ../contrib/exportLUT.lua:86 +msgid "WARNING: files may be silently overwritten" +msgstr "AVISO: os arquivos podem ser sobrescritos sem confirmação" + +#: ../contrib/exportLUT.lua:108 +msgid "Invalid identity lut file" +msgstr "Arquivo lut de identidade inválido" + +#: ../contrib/exportLUT.lua:110 +msgid "Exporting styles as haldCLUTs" +msgstr "Exportar estilos como haldCLUTs" + +#: ../contrib/exportLUT.lua:129 +msgid "Exported: " +msgstr "Exportado: " + +#: ../contrib/exportLUT.lua:131 +msgid "Done exporting haldCLUTs" +msgstr "Exportação de haldCLUTs feita" + +#: ../contrib/exportLUT.lua:141 +msgid "export haldclut" +msgstr "exportar haldclut" + +#: ../contrib/exportLUT.lua:166 +msgid "export" +msgstr "exportar" diff --git a/locale/pt_BR/LC_MESSAGES/ext_editor.po b/locale/pt_BR/LC_MESSAGES/ext_editor.po new file mode 100644 index 00000000..d863a5dd --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/ext_editor.po @@ -0,0 +1,129 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:07-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/ext_editor.lua:158 +msgid " editors configured" +msgstr " editores configurados" + +#: ../contrib/ext_editor.lua:167 +msgid "not a valid choice" +msgstr "não é uma escolha válida" + +#: ../contrib/ext_editor.lua:173 +msgid "please select one image" +msgstr "por favor, selecione uma imagem" + +#: ../contrib/ext_editor.lua:197 +msgid "file type not allowed" +msgstr "tipo de arquivo não permitido" + +#: ../contrib/ext_editor.lua:225 +msgid "error copying file " +msgstr "erro ao copiar arquivo " + +#: ../contrib/ext_editor.lua:232 +msgid "launching " +msgstr "iniciando " + +#: ../contrib/ext_editor.lua:235 +msgid "error launching " +msgstr "erro ao lançar " + +#: ../contrib/ext_editor.lua:328 +msgid "error moving file " +msgstr "erro ao mover arquivo " + +#: ../contrib/ext_editor.lua:337 +msgid "finished exporting" +msgstr "exportação terminada" + +#: ../contrib/ext_editor.lua:354 +msgid "external editors" +msgstr "editores externos" + +#: ../contrib/ext_editor.lua:380 ../contrib/ext_editor.lua:493 +msgid "edit with program " +msgstr "editar com programa " + +#: ../contrib/ext_editor.lua:382 ../contrib/ext_editor.lua:472 +msgid "collection" +msgstr "coleção" + +#: ../contrib/ext_editor.lua:393 +msgid "choose program" +msgstr "selecionar programa" + +#: ../contrib/ext_editor.lua:394 +msgid "select the external editor from the list" +msgstr "selecione o editor externo a partir da lista" + +#: ../contrib/ext_editor.lua:404 +msgid "edit" +msgstr "editar" + +#: ../contrib/ext_editor.lua:405 +msgid "open the selected image in external editor" +msgstr "abre a imagem selecionada no editor externo" + +#: ../contrib/ext_editor.lua:415 +msgid "edit a copy" +msgstr "editar uma cópia" + +#: ../contrib/ext_editor.lua:416 +msgid "create a copy of the selected image and open it in external editor" +msgstr "cria uma cópia da imagem selecionada e abre-a no editor externo" + +#: ../contrib/ext_editor.lua:425 +msgid "update list" +msgstr "atualizar lista" + +#: ../contrib/ext_editor.lua:426 +msgid "update list of programs if lua preferences are changed" +msgstr "atualiza lista de programas se as preferências do lua forem alteradas" + +#: ../contrib/ext_editor.lua:478 +msgid "executable for external editor " +msgstr "executável para o editor externo " + +#: ../contrib/ext_editor.lua:479 +msgid "select executable for external editor" +msgstr "seleciona o executável para o editor externo" + +#: ../contrib/ext_editor.lua:479 +msgid "(None)" +msgstr "(Nenhum)" + +#: ../contrib/ext_editor.lua:482 +msgid "name of external editor " +msgstr "nome do editor externo " + +#: ../contrib/ext_editor.lua:483 +msgid "friendly name of external editor" +msgstr "nome amigável do editor externo" + +#: ../contrib/ext_editor.lua:486 +msgid "show external editors in darkroom" +msgstr "mostrar editores externos na sala escura" + +#: ../contrib/ext_editor.lua:487 +msgid "" +"check to show external editors module also in darkroom (requires restart)" +msgstr "" +"ative para mostrar o módulo de editores externos também na sala escura" +" (precisa reiniciar)" diff --git a/locale/pt_BR/LC_MESSAGES/face_recognition.po b/locale/pt_BR/LC_MESSAGES/face_recognition.po new file mode 100644 index 00000000..242eb2e1 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/face_recognition.po @@ -0,0 +1,135 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:12-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/face_recognition.lua:131 +msgid "export images" +msgstr "exportar imagens" + +#: ../contrib/face_recognition.lua:137 +#, lua-format +msgid "Exporting image %i of %i images" +msgstr "Exportando imagem %i de %i imagens" + +#: ../contrib/face_recognition.lua:207 +msgid "Face recognition not found" +msgstr "Reconhecimento de rosto não encontrado" + +#: ../contrib/face_recognition.lua:259 +msgid "Starting face recognition..." +msgstr "Iniciando reconhecimento de rosto..." + +#: ../contrib/face_recognition.lua:267 +msgid "Face recognition failed" +msgstr "Reconhecimento de rosto falhou" + +#: ../contrib/face_recognition.lua:269 +msgid "Face recognition finished" +msgstr "Reconhecimento de rosto terminado" + +#: ../contrib/face_recognition.lua:274 +msgid "processing results..." +msgstr "processando resultados..." + +#: ../contrib/face_recognition.lua:338 +msgid "face recognition complete" +msgstr "reconhecimento de rosto completo" + +#: ../contrib/face_recognition.lua:340 +msgid "image export failed" +msgstr "exportação da imagem falhou" + +#: ../contrib/face_recognition.lua:344 +msgid "no images selected" +msgstr "nenhuma imagem selecionada" + +#: ../contrib/face_recognition.lua:353 +msgid "face recognition" +msgstr "reconhecimento de rosto" + +#: ../contrib/face_recognition.lua:377 +msgid "tag to be used for unknown person" +msgstr "etiqueta a ser usada para pessoa desconhecida" + +#: ../contrib/face_recognition.lua:383 +msgid "tag to be used when no persons are found" +msgstr "etiqueta a ser usada quando nenhuma pessoa for encontrada" + +#: ../contrib/face_recognition.lua:389 ../contrib/face_recognition.lua:467 +msgid "tags of images to ignore" +msgstr "etiquetas de imagens para ignorar" + +#: ../contrib/face_recognition.lua:395 ../contrib/face_recognition.lua:469 +msgid "tag category" +msgstr "categoria da etiqueta" + +#: ../contrib/face_recognition.lua:400 +msgid "tolerance" +msgstr "tolerância" + +#: ../contrib/face_recognition.lua:412 +msgid "processor cores" +msgstr "núcleos de processador" + +#: ../contrib/face_recognition.lua:413 +msgid "number of processor cores to use, 0 for all" +msgstr "número de núcleos de processador a usar, 0 para todos" + +#: ../contrib/face_recognition.lua:424 +msgid "known image directory" +msgstr "pasta de imagem conhecida" + +#: ../contrib/face_recognition.lua:425 ../contrib/face_recognition.lua:471 +msgid "face data directory" +msgstr "pasta de dados de rosto" + +#: ../contrib/face_recognition.lua:434 +msgid "export image format" +msgstr "formato de exportação da imagem" + +#: ../contrib/face_recognition.lua:435 +msgid "format for exported images" +msgstr "formato para as imagens exportadas" + +#: ../contrib/face_recognition.lua:445 +msgid "maximum exported image width" +msgstr "largura máxima das imagens exportadas" + +#: ../contrib/face_recognition.lua:451 +msgid "maximum exported image height" +msgstr "altura máxima das imagens exportada" + +#: ../contrib/face_recognition.lua:463 +msgid "unknown person tag" +msgstr "etiqueta de pessoa desconhecida" + +#: ../contrib/face_recognition.lua:465 +msgid "no persons found tag" +msgstr "etiqueta de nenhuma pessoa encontrada" + +#: ../contrib/face_recognition.lua:478 +msgid "processing options" +msgstr "opções de processamento" + +#: ../contrib/face_recognition.lua:484 +msgid "width " +msgstr "largura " + +#: ../contrib/face_recognition.lua:489 +msgid "height " +msgstr "altura " diff --git a/locale/pt_BR/LC_MESSAGES/fujifilm_ratings.po b/locale/pt_BR/LC_MESSAGES/fujifilm_ratings.po new file mode 100644 index 00000000..497344d4 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/fujifilm_ratings.po @@ -0,0 +1,30 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-30 19:26-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/fujifilm_ratings.lua:49 +msgid "exiftool not found" +msgstr "exiftool não encontrado" + +#: ../contrib/fujifilm_ratings.lua:62 +msgid "Using JPEG Rating: " +msgstr "Usar classificação JPEG: " + +#: ../contrib/fujifilm_ratings.lua:73 +msgid "Using RAF Rating: " +msgstr "Usar classificação RAF: " diff --git a/locale/pt_BR/LC_MESSAGES/geoJSON_export.po b/locale/pt_BR/LC_MESSAGES/geoJSON_export.po new file mode 100644 index 00000000..8ed5afda --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/geoJSON_export.po @@ -0,0 +1,77 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:16-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/geoJSON_export.lua:82 +#, lua-format +msgid "Export Image %i/%i" +msgstr "Exportar Imagem %i/%i" + +#: ../contrib/geoJSON_export.lua:87 +msgid "mkdir not found" +msgstr "mkdir não encontrado" + +#: ../contrib/geoJSON_export.lua:91 +msgid "convert not found" +msgstr "convert não encontrado" + +#: ../contrib/geoJSON_export.lua:95 +msgid "xdg-open not found" +msgstr "xdg-open não encontrado" + +#: ../contrib/geoJSON_export.lua:99 +msgid "xdg-user-dir not found" +msgstr "xdg-user-dir não encontrado" + +#: ../contrib/geoJSON_export.lua:310 +msgid "geoJSON export: Create an additional HTML file" +msgstr "exportar geoJSON: Criar um arquivo HTML adicional" + +#: ../contrib/geoJSON_export.lua:311 +msgid "Creates a HTML file, that loads the geoJASON file. (Needs a MapBox key" +msgstr "" +"Cria um arquivo HTML que carrega o arquivo geoJSON. (Precisa de uma chave" +" MapBox)" + +#: ../contrib/geoJSON_export.lua:316 +msgid "geoJSON export: MapBox Key" +msgstr "exportar geoJSON : chave MapBox" + +#: ../contrib/geoJSON_export.lua:317 +msgid "https://www.mapbox.com/studio/account/tokens" +msgstr "https://www.mapbox.com/studio/account/tokens" + +#: ../contrib/geoJSON_export.lua:322 +msgid "geoJSON export: Open geoJSON file after export" +msgstr "exportar geoJSON: Abrir o arquivo geoJSON após exportar" + +#: ../contrib/geoJSON_export.lua:323 +msgid "" +"Opens the geoJSON file after the export with the standard program for " +"geoJSON files" +msgstr "" +"Abre o arquivo geoJSON após a exportação com o programa padrão para arquivos" +" geoJSON" + +#: ../contrib/geoJSON_export.lua:335 +msgid "geoJSON export: Export directory" +msgstr "exportar geoJSON: Pasta de exportação" + +#: ../contrib/geoJSON_export.lua:336 +msgid "A directory that will be used to export the geoJSON files" +msgstr "Uma pasta que será usada para exportar os arquivos geoJSON" diff --git a/locale/pt_BR/LC_MESSAGES/geoToolbox.po b/locale/pt_BR/LC_MESSAGES/geoToolbox.po new file mode 100644 index 00000000..e5b28276 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/geoToolbox.po @@ -0,0 +1,166 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:23-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/geoToolbox.lua:58 +msgid "Distance:" +msgstr "Distância:" + +#: ../contrib/geoToolbox.lua:62 +msgid "latitude:" +msgstr "latitude:" + +#: ../contrib/geoToolbox.lua:67 +msgid "longitude:" +msgstr "longitude:" + +#: ../contrib/geoToolbox.lua:72 +msgid "elevation:" +msgstr "elevação:" + +#: ../contrib/geoToolbox.lua:79 ../contrib/geoToolbox.lua:99 +msgid "GPS selection" +msgstr "seleção do GPS" + +#: ../contrib/geoToolbox.lua:302 +msgid "latitude: " +msgstr "latitude: " + +#: ../contrib/geoToolbox.lua:303 +msgid "longitude: " +msgstr "longitude: " + +#: ../contrib/geoToolbox.lua:304 +msgid "elevation: " +msgstr "elevação: " + +#: ../contrib/geoToolbox.lua:329 +msgid "gnome-maps not found" +msgstr "gnome-maps não encontrado" + +#: ../contrib/geoToolbox.lua:367 +msgid "curl not found" +msgstr "curl não encontrado" + +#: ../contrib/geoToolbox.lua:372 +msgid "jq not found" +msgstr "jq não encontrado" + +#: ../contrib/geoToolbox.lua:490 +msgid "m" +msgstr "m" + +#: ../contrib/geoToolbox.lua:492 +msgid "km" +msgstr "km" + +#: ../contrib/geoToolbox.lua:495 +#, lua-format +msgid "Distance: %.2f %s" +msgstr "Distância: %.2f %s" + +#: ../contrib/geoToolbox.lua:508 +msgid "export altitude CSV" +msgstr "exportar altitude para CSV" + +#: ../contrib/geoToolbox.lua:518 +msgid "Name of the exported file" +msgstr "Nome do arquivo exportado" + +#: ../contrib/geoToolbox.lua:523 +msgid "Start export" +msgstr "Iniciar exportação" + +#: ../contrib/geoToolbox.lua:584 +msgid "File created in " +msgstr "Arquivo criado em " + +#: ../contrib/geoToolbox.lua:614 ../contrib/geoToolbox.lua:746 +msgid "Calculate the distance from latitude and longitude in km" +msgstr "Calcula a distância da latitude e longitude em km" + +#: ../contrib/geoToolbox.lua:619 ../contrib/geoToolbox.lua:644 +#: ../contrib/geoToolbox.lua:751 +msgid "Select all images with GPS information" +msgstr "Selecionar todas as imagens com informação de GPS" + +#: ../contrib/geoToolbox.lua:621 ../contrib/geoToolbox.lua:650 +#: ../contrib/geoToolbox.lua:753 +msgid "Select all images without GPS information" +msgstr "Selecionar todas as imagens sem informação de GPS" + +#: ../contrib/geoToolbox.lua:643 +msgid "select geo images" +msgstr "selecionar imagens geoetiquetadas" + +#: ../contrib/geoToolbox.lua:649 +msgid "select non-geo images" +msgstr "selecionar imagens sem geoetiquetas" + +#: ../contrib/geoToolbox.lua:656 +msgid "copy GPS data" +msgstr "copiar dados do GPS" + +#: ../contrib/geoToolbox.lua:657 +msgid "Copy GPS data" +msgstr "Copiar dados do GPS" + +#: ../contrib/geoToolbox.lua:665 +msgid "paste GPS data" +msgstr "colar dados do GPS" + +#: ../contrib/geoToolbox.lua:666 +msgid "Paste GPS data" +msgstr "Colar dados do GPS" + +#: ../contrib/geoToolbox.lua:695 +msgid "open in Gnome Maps" +msgstr "abrir no Gnome Maps" + +#: ../contrib/geoToolbox.lua:696 +msgid "Open location in Gnome Maps" +msgstr "Abrir localização no Gnome Maps" + +#: ../contrib/geoToolbox.lua:702 +msgid "reverse geocode" +msgstr "geocódigo reverso" + +#: ../contrib/geoToolbox.lua:703 +msgid "This just shows the name of the location, but doesn't add it as tag" +msgstr "" +"Isto apenas mostra o nome da localização, mas não adiciona-a como uma etiqueta" + +#: ../contrib/geoToolbox.lua:707 +msgid "altitude CSV export" +msgstr "exportar altitude em CSV" + +#: ../contrib/geoToolbox.lua:712 +msgid "export altitude CSV file" +msgstr "exporta o arquivo CSV de altitude" + +#: ../contrib/geoToolbox.lua:713 +msgid "Create an altitude profile using the GPS data in the metadata" +msgstr "Cria um perfil de altitude usando os dados GPS nos metadados" + +#: ../contrib/geoToolbox.lua:740 +msgid "geoToolbox export: MapBox Key" +msgstr "exportar geoToolbox: chave MapBox" + +#: ../contrib/geoToolbox.lua:741 +msgid "https://www.mapbox.com/studio/account/tokens" +msgstr "https://www.mapbox.com/studio/account/tokens" diff --git a/locale/pt_BR/LC_MESSAGES/gimp.po b/locale/pt_BR/LC_MESSAGES/gimp.po new file mode 100644 index 00000000..3df96f73 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/gimp.po @@ -0,0 +1,43 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:18-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/gimp.lua:111 +#, lua-format +msgid "Export Image %i/%i" +msgstr "Exportar Imagem %i/%i" + +#: ../contrib/gimp.lua:121 +msgid "GIMP not found" +msgstr "GIMP não encontrado" + +#: ../contrib/gimp.lua:144 +msgid "Launching GIMP..." +msgstr "Iniciando GIMP..." + +#: ../contrib/gimp.lua:207 +msgid "run detached" +msgstr "executar desassociado" + +#: ../contrib/gimp.lua:208 +msgid "don't import resulting image back into darktable" +msgstr "não importar a imagem resultante de volta para o darktable" + +#: ../contrib/gimp.lua:215 +msgid "Edit with GIMP" +msgstr "Editar com o GIMP" diff --git a/locale/pt_BR/LC_MESSAGES/gpx_export.po b/locale/pt_BR/LC_MESSAGES/gpx_export.po new file mode 100644 index 00000000..a5d5c78a --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/gpx_export.po @@ -0,0 +1,54 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 19:48-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/gpx_export.lua:59 +msgid "gpx file path" +msgstr "caminho do arquivo gpx" + +#: ../contrib/gpx_export.lua:72 +msgid "exporting gpx file..." +msgstr "exportar arquivo gpx..." + +#: ../contrib/gpx_export.lua:74 +msgid "gpx export" +msgstr "exportar gpx" + +#: ../contrib/gpx_export.lua:93 ../contrib/gpx_export.lua:94 +msgid " does not have date information and won't be processed" +msgstr " não possui informações de data e não será processado" + +#: ../contrib/gpx_export.lua:134 +msgid "invalid path: " +msgstr "caminho inválido: " + +#: ../contrib/gpx_export.lua:138 +msgid "gpx file created: " +msgstr "arquivo gpx criado: " + +#: ../contrib/gpx_export.lua:171 +msgid "export" +msgstr "exportar" + +#: ../contrib/gpx_export.lua:172 +msgid "export gpx file" +msgstr "exportar arquivo gpx" + +#: ../contrib/gpx_export.lua:180 +msgid "file:" +msgstr "arquivo:" diff --git a/locale/pt_BR/LC_MESSAGES/harmonic_armature_guide.po b/locale/pt_BR/LC_MESSAGES/harmonic_armature_guide.po new file mode 100644 index 00000000..c409e880 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/harmonic_armature_guide.po @@ -0,0 +1,22 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-30 19:26-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/harmonic_armature_guide.lua:76 +msgid "harmonic armature" +msgstr "armadura harmônica" diff --git a/locale/pt_BR/LC_MESSAGES/hugin.po b/locale/pt_BR/LC_MESSAGES/hugin.po new file mode 100644 index 00000000..3a7c57cb --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/hugin.po @@ -0,0 +1,67 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:26-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/hugin.lua:109 +msgid "hugin is not found, did you set the path?" +msgstr "hugin não encontrado, você configurou o caminho?" + +#: ../contrib/hugin.lua:165 +msgid "will try to stitch now" +msgstr "tentará pregar agora" + +#: ../contrib/hugin.lua:170 +msgid "creating pto file" +msgstr "criar arquivo pto" + +#: ../contrib/hugin.lua:174 +msgid "running assistant" +msgstr "rodar assistente" + +#: ../contrib/hugin.lua:182 +msgid "launching hugin" +msgstr "iniciar o hugin" + +#: ../contrib/hugin.lua:184 +msgid "unable to find command line tools, launching hugin" +msgstr "" +"não foi possível encontrar as ferramentas de linha de comando, iniciar o hugin" + +#: ../contrib/hugin.lua:192 +msgid "hugin isn't available." +msgstr "hugin não está disponível." + +#: ../contrib/hugin.lua:197 +msgid "hugin failed ..." +msgstr "hugin falhou..." + +#: ../contrib/hugin.lua:203 +msgid "importing file " +msgstr "importar arquivo " + +#: ../contrib/hugin.lua:229 +msgid " launch hugin gui" +msgstr " iniciar interface gráfica do hugin" + +#: ../contrib/hugin.lua:231 +msgid "launch hugin in gui mode" +msgstr "inicia o hugin no modo de interface gráfica" + +#: ../contrib/hugin.lua:237 +msgid "hugin panorama" +msgstr "hugin panorama" diff --git a/locale/pt_BR/LC_MESSAGES/image_stack.po b/locale/pt_BR/LC_MESSAGES/image_stack.po new file mode 100644 index 00000000..2421070c --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/image_stack.po @@ -0,0 +1,273 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 23:35-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/image_stack.lua:96 +msgid "image align options" +msgstr "opções de alinhamento da imagem" + +#: ../contrib/image_stack.lua:100 +msgid "image stack options" +msgstr "opções de empilhamento da imagem" + +#: ../contrib/image_stack.lua:104 +msgid "executable locations" +msgstr "localizações dos executáveis" + +#: ../contrib/image_stack.lua:129 +msgid "perform image alignment" +msgstr "realizar o alinhamento da imagem" + +#: ../contrib/image_stack.lua:131 +msgid "align the image stack before processing" +msgstr "alinha a pilha de imagem antes de processar" + +#: ../contrib/image_stack.lua:135 +msgid "optimize radial distortion for all images" +msgstr "otimizar a distorção radial para todas as imagens" + +#: ../contrib/image_stack.lua:137 +msgid "" +"optimize radial distortion for all images, \n" +"except for first" +msgstr "" +"otimiza a distorção radial para todas as imagens,\n" +"exceto para a primeira" + +#: ../contrib/image_stack.lua:141 +msgid "optimize field of view for all images" +msgstr "otimizar campo de visão para todas as imagens" + +#: ../contrib/image_stack.lua:143 +msgid "" +"optimize field of view for all images, except for first. \n" +"Useful for aligning focus stacks (DFF) with slightly \n" +"different magnification." +msgstr "" +"otimiza o campo de visão para todas as imagens, exceto para a primeira.\n" +"Útil para alinhar o empilhamento de foco (DFF) com uma ampliação \n" +"levemente diferente." + +#: ../contrib/image_stack.lua:147 +msgid "optimize image center shift for all images" +msgstr "otimizar o deslocamento do centro da imagem para todas as imagens" + +#: ../contrib/image_stack.lua:149 +msgid "" +"optimize image center shift for all images, \n" +"except for first." +msgstr "" +"otimiza o deslocamento do centro da imagem para todas as imagens, \n" +"exceto para a primeira." + +#: ../contrib/image_stack.lua:153 +msgid "auto crop the image" +msgstr "cortar automaticamente a imagem" + +#: ../contrib/image_stack.lua:155 +msgid "auto crop the image to the area covered by all images." +msgstr "" +"corta automaticamente a imagem para a área coberta por todas as imagens." + +#: ../contrib/image_stack.lua:159 +msgid "load distortion from lens database" +msgstr "carregar a distorção a partir da base de dados de lentes" + +#: ../contrib/image_stack.lua:161 +msgid "try to load distortion information from lens database" +msgstr "tenta carregar as informações de distorção da base de dados de lentes" + +#: ../contrib/image_stack.lua:165 +msgid "image grid size" +msgstr "tamanho da grade da imagem" + +#: ../contrib/image_stack.lua:166 +msgid "" +"break image into a rectangular grid \n" +"and attempt to find num control points in each section.\n" +"default: (5x5)" +msgstr "" +"quebra a imagem em uma grade retangular \n" +"e tenta encontrar o número de pontos de controle\n" +"em cada seção.\n" +"padrão: (5x5)" + +#: ../contrib/image_stack.lua:175 +msgid "control points/grid" +msgstr "grade/pontos de controle" + +#: ../contrib/image_stack.lua:176 +msgid "" +"number of control points (per grid, see option -g) \n" +"to create between adjacent images \n" +"default: (8)." +msgstr "" +"número de pontos de controle (por grade, veja a opção -g) \n" +"a criar entre imagens adjacentes\n" +"padrão: (8)" + +#: ../contrib/image_stack.lua:185 +msgid "remove control points with error" +msgstr "remover pontos de controle com erro" + +#: ../contrib/image_stack.lua:186 +msgid "" +"remove all control points with an error higher \n" +"than num pixels \n" +"default: (3)" +msgstr "" +"remove todos os pontos de controle com um erro maior \n" +"que um número de pixels \n" +"padrão: (3)" + +#: ../contrib/image_stack.lua:195 +msgid "correlation threshold for control points" +msgstr "limiar de correlação para pontos de controle" + +#: ../contrib/image_stack.lua:196 +msgid "" +"correlation threshold for identifying \n" +"control points \n" +"default: (0.9)." +msgstr "" +"limiar de correlação para identificar pontos\n" +"de controle\n" +"padrão: (0,9)" + +#: ../contrib/image_stack.lua:205 +msgid "select stack function" +msgstr "função de seleção de pilha" + +#: ../contrib/image_stack.lua:206 +msgid "" +"select function to be \n" +"applied to image stack" +msgstr "" +"função de seleção a ser aplicada\n" +"à pilha de imagens" + +#: ../contrib/image_stack.lua:215 +msgid "select output format" +msgstr "selecionar formato de saída" + +#: ../contrib/image_stack.lua:216 +msgid "choose the format for the resulting image" +msgstr "seleciona o formato para a imagem resultante" + +#: ../contrib/image_stack.lua:224 +msgid "tag source images used?" +msgstr "etiquetas das imagens fonte usadas?" + +#: ../contrib/image_stack.lua:226 +msgid "tag the source images used to create the output file?" +msgstr "etiquetas das imagens fonte usadas para criar o arquivo de saída?" + +#: ../contrib/image_stack.lua:261 +#, lua-format +msgid "Export Image %i/%i" +msgstr "Exportar Imagem %i/%i" + +#: ../contrib/image_stack.lua:454 +msgid "Unrecognized option to copy_image_attributes: " +msgstr "Opção não reconhecida para copy_image_attributes: " + +#: ../contrib/image_stack.lua:497 +msgid "ERROR: at least 2 images required for image stacking, exiting..." +msgstr "" +"ERRO: pelo menos 2 imagens são necessárias para empilhamento de imagens," +" saindo..." + +#: ../contrib/image_stack.lua:498 +msgid " image(s) selected, at least 2 required" +msgstr " imagem(ns) selecionada(s), pelo menos 2 necessárias" + +#: ../contrib/image_stack.lua:512 +msgid "aligning images..." +msgstr "alinhar imagens..." + +#: ../contrib/image_stack.lua:515 +msgid "images aligned" +msgstr "imagens alinhadas" + +#: ../contrib/image_stack.lua:521 +msgid "ERROR: image alignment failed" +msgstr "ERRO: alinhamento de imagem falhou" + +#: ../contrib/image_stack.lua:522 +msgid "image alignment failed" +msgstr "alinhamento de imagem falhou" + +#: ../contrib/image_stack.lua:527 +msgid "ERROR: align_image_stack not found" +msgstr "ERRO: align_image_stack não encontrado" + +#: ../contrib/image_stack.lua:528 +msgid "align_image_stack not found" +msgstr "align_image_stack não encontrado" + +#: ../contrib/image_stack.lua:542 +msgid "convert command is " +msgstr "comando convert é " + +#: ../contrib/image_stack.lua:543 +msgid "processing image stack" +msgstr "processar empilhamento de imagem" + +#: ../contrib/image_stack.lua:546 +msgid "image stack processed" +msgstr "empilhamento de imagem processado" + +#: ../contrib/image_stack.lua:551 +msgid "importing result" +msgstr "importar resultado" + +#: ../contrib/image_stack.lua:556 +msgid "Created with|image_stack" +msgstr "Criado com|image_stack" + +#: ../contrib/image_stack.lua:569 +msgid "tagging source images" +msgstr "etiquetando imagens fonte" + +#: ../contrib/image_stack.lua:570 +msgid "Source file|" +msgstr "Arquivo fonte |" + +#: ../contrib/image_stack.lua:577 +msgid "ERROR: image stack processing failed" +msgstr "ERRO: processamento de empilhamento de imagem falhou" + +#: ../contrib/image_stack.lua:581 +msgid "ERROR: convert executable not found" +msgstr "ERRO: executável do convert não encontrado" + +#: ../contrib/image_stack.lua:582 +msgid "convert executable not found" +msgstr "executável do convert não encontrado" + +#: ../contrib/image_stack.lua:594 +msgid "align image stack: use GPU for remaping" +msgstr "alinhar pilha de imagens: usar GPU para remapear" + +#: ../contrib/image_stack.lua:595 +msgid "set the GPU remapping for image align" +msgstr "definir o remapeamento de GPU para alinhamento de imagem" + +#: ../contrib/image_stack.lua:598 +msgid "image stack" +msgstr "empilhamento de imagem" diff --git a/locale/pt_BR/LC_MESSAGES/image_time.po b/locale/pt_BR/LC_MESSAGES/image_time.po new file mode 100644 index 00000000..d99ffb77 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/image_time.po @@ -0,0 +1,244 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:09-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/image_time.lua:177 +msgid "Error: 2 images must be selected" +msgstr "Erro: 2 imagens devem ser selecionadas" + +#: ../contrib/image_time.lua:230 +msgid "unable to detect exiv2" +msgstr "não foi possível detectar exiv2" + +#: ../contrib/image_time.lua:251 ../contrib/image_time.lua:268 +msgid "unable to get information for " +msgstr "não foi possível obter informações para " + +#: ../contrib/image_time.lua:316 +msgid "reset time: no images selected" +msgstr "reiniciar tempo: nenhuma imagem selecionada" + +#: ../contrib/image_time.lua:317 +msgid "please select the images that need their time reset" +msgstr "" +"por favor, selecione as imagens que precisam que seu tempo seja reiniciado" + +#: ../contrib/image_time.lua:330 ../contrib/image_time.lua:355 +msgid "please select some images and try again" +msgstr "por favor, selecione algumas imagens e tente novamente" + +#: ../contrib/image_time.lua:334 ../contrib/image_time.lua:437 +#: ../contrib/image_time.lua:444 +msgid "subtract" +msgstr "subtrair" + +#: ../contrib/image_time.lua:407 +msgid "image time" +msgstr "tempo da imagem" + +#: ../contrib/image_time.lua:431 +msgid "years" +msgstr "anos" + +#: ../contrib/image_time.lua:431 +msgid "years to adjust by, 0 - ?" +msgstr "anos a ajustar, 0 - ?" + +#: ../contrib/image_time.lua:432 +msgid "months" +msgstr "meses" + +#: ../contrib/image_time.lua:433 +msgid "days" +msgstr "dias" + +#: ../contrib/image_time.lua:434 +msgid "hours" +msgstr "horas" + +#: ../contrib/image_time.lua:434 +msgid "hours to adjust by, 0-23" +msgstr "horas a ajustar, 0-23" + +#: ../contrib/image_time.lua:435 +msgid "minutes" +msgstr "minutos" + +#: ../contrib/image_time.lua:435 +msgid "minutes to adjust by, 0-59" +msgstr "minutos a ajustar, 0-59" + +#: ../contrib/image_time.lua:436 ../contrib/image_time.lua:443 +msgid "seconds" +msgstr "segundos" + +#: ../contrib/image_time.lua:436 +msgid "seconds to adjust by, 0-59" +msgstr "segundos a ajustar, 0-59" + +#: ../contrib/image_time.lua:437 ../contrib/image_time.lua:444 +msgid "add/subtract" +msgstr "adicionar/subtrair" + +#: ../contrib/image_time.lua:437 ../contrib/image_time.lua:444 +msgid "add or subtract time" +msgstr "adicionar ou subtrair tempo" + +#: ../contrib/image_time.lua:437 ../contrib/image_time.lua:444 +msgid "add" +msgstr "adicionar" + +#: ../contrib/image_time.lua:438 +msgid "year" +msgstr "ano" + +#: ../contrib/image_time.lua:438 +msgid "year to set, 1900 - now" +msgstr "ano a definir, 1900 - agora" + +#: ../contrib/image_time.lua:439 +msgid "month" +msgstr "mês" + +#: ../contrib/image_time.lua:439 +msgid "month to set, 1-12" +msgstr "mês a definir, 1-12" + +#: ../contrib/image_time.lua:440 +msgid "day" +msgstr "dia" + +#: ../contrib/image_time.lua:440 +msgid "day to set, 1-31" +msgstr "dia a definir, 1-31" + +#: ../contrib/image_time.lua:441 +msgid "hour" +msgstr "hora" + +#: ../contrib/image_time.lua:441 +msgid "hour to set, 0-23" +msgstr "hora a definir, 0-23" + +#: ../contrib/image_time.lua:442 +msgid "minute" +msgstr "minuto" + +#: ../contrib/image_time.lua:442 +msgid "minutes to set, 0-59" +msgstr "minuto a definir, 0-59" + +#: ../contrib/image_time.lua:443 +msgid "seconds to set, 0-59" +msgstr "segundos a definir, 0-59" + +#: ../contrib/image_time.lua:459 +msgid "Time difference between images in seconds" +msgstr "Diferença de tempo entre as imagens em segundos" + +#: ../contrib/image_time.lua:460 +msgid "Select 2 images and use the calculate button" +msgstr "Selecione 2 imagens e use o botão para calcular" + +#: ../contrib/image_time.lua:465 +msgid "Calculate" +msgstr "Calcular" + +#: ../contrib/image_time.lua:466 +msgid "calculate time difference between 2 images" +msgstr "calcula a diferença de tempo entre 2 imagens" + +#: ../contrib/image_time.lua:473 +msgid "synchronize image times" +msgstr "sincronizar tempos da imagem" + +#: ../contrib/image_time.lua:474 +msgid "apply the time difference from selected images" +msgstr "aplica a diferença de tempo a partir das imagens selecionadas" + +#: ../contrib/image_time.lua:484 ../contrib/image_time.lua:550 +msgid "adjust time" +msgstr "ajustar tempo" + +#: ../contrib/image_time.lua:485 +msgid "days, months, years" +msgstr "dias, meses, anos" + +#: ../contrib/image_time.lua:489 +msgid "hours, minutes, seconds" +msgstr "horas, minutos, segundos" + +#: ../contrib/image_time.lua:493 +msgid "adjustment direction" +msgstr "direção de ajuste" + +#: ../contrib/image_time.lua:496 +msgid "adjust" +msgstr "ajustar" + +#: ../contrib/image_time.lua:504 ../contrib/image_time.lua:551 +msgid "set time" +msgstr "definir tempo" + +#: ../contrib/image_time.lua:505 +msgid "date: " +msgstr "data: " + +#: ../contrib/image_time.lua:509 +msgid "time:" +msgstr "tempo: " + +#: ../contrib/image_time.lua:514 +msgid "set" +msgstr "definir" + +#: ../contrib/image_time.lua:522 +msgid "synchronize image time" +msgstr "sincronizar tempo da imagem" + +#: ../contrib/image_time.lua:523 +msgid "calculate difference between images" +msgstr "calcular a diferença entre imagens" + +#: ../contrib/image_time.lua:526 +msgid "apply difference" +msgstr "aplicar diferença" + +#: ../contrib/image_time.lua:532 +msgid "reset to original time" +msgstr "reiniciar para o tempo original" + +#: ../contrib/image_time.lua:535 +msgid "reset" +msgstr "reiniciar" + +#: ../contrib/image_time.lua:544 +msgid "mode" +msgstr "modo" + +#: ../contrib/image_time.lua:545 +msgid "select mode" +msgstr "selecionar modo" + +#: ../contrib/image_time.lua:552 +msgid "synchronize time" +msgstr "sincronizar tempo" + +#: ../contrib/image_time.lua:553 +msgid "reset time" +msgstr "reiniciar tempo" diff --git a/locale/pt_BR/LC_MESSAGES/kml_export.po b/locale/pt_BR/LC_MESSAGES/kml_export.po new file mode 100644 index 00000000..2ff81383 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/kml_export.po @@ -0,0 +1,90 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:14-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/kml_export.lua:64 +#, lua-format +msgid "Export Image %i/%i" +msgstr "Exportar Imagem %i/%i" + +#: ../contrib/kml_export.lua:91 +msgid "magick not found" +msgstr "magick não encontrado" + +#: ../contrib/kml_export.lua:96 +msgid "xdg-user-dir not found" +msgstr "xdg-user-dir não encontrado" + +#: ../contrib/kml_export.lua:106 +msgid "zip not found" +msgstr "zip não encontrado" + +#: ../contrib/kml_export.lua:321 +msgid "KML export: Open KML file after export" +msgstr "exportar KML: Abrir arquivo Open KML após a exportação" + +#: ../contrib/kml_export.lua:322 ../contrib/kml_export.lua:329 +msgid "" +"Opens the KML file after the export with the standard program for KML files" +msgstr "" +"Abre o arquivo KML após a exportação com o programa padrão para arquivos KML" + +#: ../contrib/kml_export.lua:328 +msgid "KML export: Open KML/KMZ file after export" +msgstr "exportar KML: Abre arquivo KML/KMZ após a exportação" + +#: ../contrib/kml_export.lua:348 +msgid "KML export: Export directory" +msgstr "exportar KML: Pasta de exportação" + +#: ../contrib/kml_export.lua:349 +msgid "A directory that will be used to export the KML/KMZ files" +msgstr "Uma pasta que será usada para exportar os arquivos KML/KMZ" + +#: ../contrib/kml_export.lua:356 +msgid "KML export: ImageMagick binary Location" +msgstr "exportar KML: Localização do binário do ImageMagick" + +#: ../contrib/kml_export.lua:357 +msgid "Install location of magick[.exe]. Requires restart to take effect." +msgstr "" +"Localização de instalação do magick[.exe]. Precisa reiniciar para ter efeito." + +#: ../contrib/kml_export.lua:364 +msgid "KML export: Connect images with path" +msgstr "exportar KML: Conectar imagens com caminho" + +#: ../contrib/kml_export.lua:365 +msgid "connect all images with a path" +msgstr "conecta todas as imagens com um caminho" + +#: ../contrib/kml_export.lua:372 +msgid "KML export: Create KMZ file" +msgstr "exportar KML: Criar arquivo KMZ" + +#: ../contrib/kml_export.lua:373 +msgid "Compress all imeges to one KMZ file" +msgstr "Comprime todas as imagens para um arquivo KMZ" + +#: ../contrib/kml_export.lua:379 +msgid "KML Export" +msgstr "Exportar KML" + +#: ../contrib/kml_export.lua:381 +msgid "KML/KMZ Export" +msgstr "Exportar KML/KMZ" diff --git a/locale/pt_BR/LC_MESSAGES/passport_guide.po b/locale/pt_BR/LC_MESSAGES/passport_guide.po new file mode 100644 index 00000000..a69e95a0 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/passport_guide.po @@ -0,0 +1,22 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-01 19:26-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/passport_guide.lua:90 +msgid "ISO 19794-5/ICAO 9309 passport" +msgstr "passaporte ISO 19794-5/ICAO 9309" diff --git a/locale/pt_BR/LC_MESSAGES/pdf_slideshow.po b/locale/pt_BR/LC_MESSAGES/pdf_slideshow.po new file mode 100644 index 00000000..0dab56fa --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/pdf_slideshow.po @@ -0,0 +1,70 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:16-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/pdf_slideshow.lua:55 +msgid "pdflatex not found" +msgstr "pdflatex não encontrado" + +#: ../contrib/pdf_slideshow.lua:71 +msgid "a pdf viewer" +msgstr "um visualizador de pdf" + +#: ../contrib/pdf_slideshow.lua:72 +msgid "can be an absolute pathname or the tool may be in the PATH" +msgstr "pode ser um caminho absoluto ou a ferramenta pode estar no PATH" + +#: ../contrib/pdf_slideshow.lua:76 ../contrib/pdf_slideshow.lua:103 +msgid "slideshow title" +msgstr "título da apresentação" + +#: ../contrib/pdf_slideshow.lua:80 +msgid "transition delay (s)" +msgstr "atraso da transição (s)" + +#: ../contrib/pdf_slideshow.lua:91 +msgid "include image title" +msgstr "incluir título da imagem" + +#: ../contrib/pdf_slideshow.lua:93 +msgid "whether to include the image title (if defined) into the slide" +msgstr "se deve ser incluído o título da imagem (se definido) no slide" + +#: ../contrib/pdf_slideshow.lua:97 +msgid "include image author" +msgstr "incluir autor da imagem" + +#: ../contrib/pdf_slideshow.lua:99 +msgid "whether to include the image author (if defined) into the slide" +msgstr "se deve ser incluído o autor da imagem (se definido) no slide" + +#: ../contrib/pdf_slideshow.lua:179 +msgid "pdf slideshow" +msgstr "apresentação do pdf" + +#: ../contrib/pdf_slideshow.lua:232 +msgid "problem running pdflatex" +msgstr "problema ao executar o pdflatex" + +#: ../contrib/pdf_slideshow.lua:233 ../contrib/pdf_slideshow.lua:243 +msgid "problem running " +msgstr "problema ao executar " + +#: ../contrib/pdf_slideshow.lua:242 +msgid "problem running pdf viewer" +msgstr "problema ao executar o visualizador de pdf" diff --git a/locale/pt_BR/LC_MESSAGES/photils.po b/locale/pt_BR/LC_MESSAGES/photils.po new file mode 100644 index 00000000..01b0e520 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/photils.po @@ -0,0 +1,118 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:22-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/photils.lua:117 +msgid "get tags" +msgstr "obter etiquetas" + +#: ../contrib/photils.lua:148 +msgid "requires a restart to be applied" +msgstr "precisa reiniciar para ser aplicado" + +#: ../contrib/photils.lua:163 +msgid "min confidence value" +msgstr "valor mín de confiança" + +#: ../contrib/photils.lua:180 +msgid "" +"The suggested tags were not generated\n" +" for the currently selected image!" +msgstr "" +"As etiquetas sugeridas não serão geradas\n" +"para a imagem atualmente selecionada!" + +#: ../contrib/photils.lua:186 +#, lua-format +msgid " page %s of %s " +msgstr " página %s de %s " + +#: ../contrib/photils.lua:237 +msgid "Apply tag to image" +msgstr "Aplicar etiqueta à imagem" + +#: ../contrib/photils.lua:249 +msgid "Tags successfully attached to image" +msgstr "Etiquetas anexadas com sucesso à imagem" + +#: ../contrib/photils.lua:299 +#, lua-format +msgid "%s found %d tags for your image" +msgstr "%s encontrado %d etiquetas para sua imagem" + +#: ../contrib/photils.lua:315 +msgid "No image selected." +msgstr "Nenhuma imagem selecionada." + +#: ../contrib/photils.lua:319 +msgid "This plugin can only handle a single image." +msgstr "Este plugin pode manipular somente uma imagem por vez." + +#: ../contrib/photils.lua:326 +#, lua-format +msgid "%s failed, see terminal output for details" +msgstr "%s falhou, veja a saída do terminal para detalhes" + +#: ../contrib/photils.lua:334 +#, lua-format +msgid "no tags where found" +msgstr "nenhuma etiqueta encontrada" + +#: ../contrib/photils.lua:365 +#, lua-format +msgid "attach %d tags" +msgstr "anexar %d etiquetas" + +#: ../contrib/photils.lua:429 ../contrib/photils.lua:430 +msgid "photils-cli not found" +msgstr "photils-cli não encontrado" + +#: ../contrib/photils.lua:432 +msgid "" +"Select an image, click \"get tags\" and get \n" +"suggestions for tags." +msgstr "" +"Selecione uma imagem, clique em \"obter etiquetas\"\n" +"e obtenha sugestões para etiquetas." + +#: ../contrib/photils.lua:467 +msgid "photils: show confidence value" +msgstr "photils: mostrar valor de confiança" + +#: ../contrib/photils.lua:468 +msgid "if enabled, the confidence value for each tag is displayed" +msgstr "se ativo, o valor de confiança para cada etiqueta é exibido" + +#: ../contrib/photils.lua:474 +msgid "photils: use exported image for tag request" +msgstr "photils: usar imagem exportada para pedido de etiqueta" + +#: ../contrib/photils.lua:475 +msgid "" +"If enabled, the image passed to photils for tag suggestion is based on the " +"exported, already edited image. Otherwise, the embedded thumbnail of the RAW " +"file will be used for tag suggestion.The embedded thumbnail could speedup " +"the tag suggestion but can fail if the RAW file is not supported." +msgstr "" +"Se ativo, a imagem passada para o photils para a sugestão de etiquetas é" +" baseada na " +"exportada, a imagem já editada. Caso contrário, a miniatura embutida no" +" arquivo RAW " +"será usada para sugestão de etiquetas. A miniatura embutida pode acelerar a" +" sugestão " +"de etiqueta mas pode falhar se o arquivo RAW não for suportado." diff --git a/locale/pt_BR/LC_MESSAGES/quicktag.po b/locale/pt_BR/LC_MESSAGES/quicktag.po new file mode 100644 index 00000000..ef764259 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/quicktag.po @@ -0,0 +1,82 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:25-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/quicktag.lua:78 +msgid "max. length of button labels" +msgstr "comprimento máximo dos rótulos de botão" + +#: ../contrib/quicktag.lua:79 +msgid "may range from 15 to 60 - needs a restart" +msgstr "pode ir de 16 à 60 - precisa reiniciar" + +#: ../contrib/quicktag.lua:92 +msgid "number of quicktag fields" +msgstr "número de campos de quicktag" + +#: ../contrib/quicktag.lua:93 +msgid "may range from 2 to 20 - needs a restart" +msgstr "pode ir de 2 à 20 - precisa reiniciar" + +#: ../contrib/quicktag.lua:133 +#, lua-format +msgid "quicktag %i is empty, please set a tag" +msgstr "quicktag %i está vazio, por favor defina uma etiqueta" + +#: ../contrib/quicktag.lua:148 +msgid "no images selected" +msgstr "nenhuma imagem selecionada" + +#: ../contrib/quicktag.lua:158 +#, lua-format +msgid "tag \"%s\" attached to %i image(s)" +msgstr "etiqueta \"%s\" anexada a %i imagem(ns)" + +#: ../contrib/quicktag.lua:179 +msgid "old tag" +msgstr "etiqueta antiga" + +#: ../contrib/quicktag.lua:180 +msgid "select the quicktag to replace" +msgstr "selecione a quicktag para substituir" + +#: ../contrib/quicktag.lua:225 ../contrib/quicktag.lua:303 +#, lua-format +msgid "quicktag %i" +msgstr "quicktag %i" + +#: ../contrib/quicktag.lua:240 ../contrib/quicktag.lua:264 +msgid "new tag" +msgstr "nova etiqueta" + +#: ../contrib/quicktag.lua:243 +msgid "enter your tag here" +msgstr "insira sua etiqueta aqui" + +#: ../contrib/quicktag.lua:247 +msgid "set tag" +msgstr "definir etiqueta" + +#: ../contrib/quicktag.lua:251 +msgid "new quicktag is empty!" +msgstr "nova quicktag está vazia!" + +#: ../contrib/quicktag.lua:255 +#, lua-format +msgid "quicktag \"%s\" replaced by \"%s\"" +msgstr "quicktag \"%s\" substituída por \"%s\"" diff --git a/locale/pt_BR/LC_MESSAGES/rename_images.po b/locale/pt_BR/LC_MESSAGES/rename_images.po new file mode 100644 index 00000000..edb543bf --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/rename_images.po @@ -0,0 +1,234 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:45-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/rename_images.lua:123 +msgid "unrecognized variable " +msgstr "variável não reconhecida " + +#: ../contrib/rename_images.lua:124 +msgid "unknown variable " +msgstr "variável desconhecida " + +#: ../contrib/rename_images.lua:143 +msgid "rename images" +msgstr "renomear imagens" + +#: ../contrib/rename_images.lua:175 +msgid "pattern is " +msgstr "padrão é " + +#: ../contrib/rename_images.lua:179 +msgid "renaming images" +msgstr "renomeando images" + +#: ../contrib/rename_images.lua:186 +msgid "unable to do variable substitution, exiting..." +msgstr "não foi possível a substituição de variável, saindo..." + +#: ../contrib/rename_images.lua:215 +msgid "renamed " +msgstr "renomeado " + +#: ../contrib/rename_images.lua:218 +msgid "please enter the new name or pattern" +msgstr "por favor, insira o novo nome ou padrão" + +#: ../contrib/rename_images.lua:222 +msgid "please select some images and try again" +msgstr "por favor, selecione algumas imagens e tente novamente" + +#: ../contrib/rename_images.lua:235 +msgid "$(ROLL_NAME) - film roll name\n" +msgstr "$(ROLL_NAME) - nome do rolo de filme\n" + +#: ../contrib/rename_images.lua:236 +msgid "$(FILE_FOLDER) - image file folder\n" +msgstr "$(FILE_FOLDER) - pasta do arquivo de imagem\n" + +#: ../contrib/rename_images.lua:237 +msgid "$(FILE_NAME) - image file name\n" +msgstr "$(FILE_NAME) - nome do arquivo de imagem\n" + +#: ../contrib/rename_images.lua:238 +msgid "$(FILE_EXTENSION) - image file extension\n" +msgstr "$(FILE_EXTENSION) - extensão do arquivo de imagem\n" + +#: ../contrib/rename_images.lua:239 +msgid "$(ID) - image id\n" +msgstr "$(ID) - id da imagem\n" + +#: ../contrib/rename_images.lua:240 +msgid "$(VERSION) - version number\n" +msgstr "$(VERSION) - número de versão\n" + +#: ../contrib/rename_images.lua:241 +msgid "$(SEQUENCE) - sequence number of selection\n" +msgstr "$(SEQUENCE) - número de sequência da seleção\n" + +#: ../contrib/rename_images.lua:242 +msgid "$(YEAR) - current year\n" +msgstr "$(YEAR) - ano atual\n" + +#: ../contrib/rename_images.lua:243 +msgid "$(MONTH) - current month\n" +msgstr "$(MONTH) - mês atual\n" + +#: ../contrib/rename_images.lua:244 +msgid "$(DAY) - current day\n" +msgstr "$(DAY) - dia atual\n" + +#: ../contrib/rename_images.lua:245 +msgid "$(HOUR) - current hour\n" +msgstr "$(HOUR) - hora atual\n" + +#: ../contrib/rename_images.lua:246 +msgid "$(MINUTE) - current minute\n" +msgstr "$(MINUTE) - minuto atual\n" + +#: ../contrib/rename_images.lua:247 +msgid "$(SECOND) - current second\n" +msgstr "$(SECOND) - segundo atual\n" + +#: ../contrib/rename_images.lua:248 +msgid "$(EXIF_YEAR) - EXIF year\n" +msgstr "$(EXIF_YEAR) - ano EXIF\n" + +#: ../contrib/rename_images.lua:249 +msgid "$(EXIF_MONTH) - EXIF month\n" +msgstr "$(EXIF_MONTH) - mês EXIF\n" + +#: ../contrib/rename_images.lua:250 +msgid "$(EXIF_DAY) - EXIF day\n" +msgstr "$(EXIF_DAY) - dia EXIF\n" + +#: ../contrib/rename_images.lua:251 +msgid "$(EXIF_HOUR) - EXIF hour\n" +msgstr "$(EXIF_HOUR) - hora EXIF\n" + +#: ../contrib/rename_images.lua:252 +msgid "$(EXIF_MINUTE) - EXIF minute\n" +msgstr "$(EXIF_MINUTE) - minuto EXIF\n" + +#: ../contrib/rename_images.lua:253 +msgid "$(EXIF_SECOND) - EXIF seconds\n" +msgstr "$(EXIF_SECOND) - segundo EXIF\n" + +#: ../contrib/rename_images.lua:254 +msgid "$(EXIF_ISO) - EXIF ISO\n" +msgstr "$(EXIF_ISO) - ISO EXIF\n" + +#: ../contrib/rename_images.lua:255 +msgid "$(EXIF_EXPOSURE) - EXIF exposure\n" +msgstr "$(EXIF_EXPOSURE) - exposição EXIF\n" + +#: ../contrib/rename_images.lua:256 +msgid "$(EXIF_EXPOSURE_BIAS) - EXIF exposure bias\n" +msgstr "$(EXIF_EXPOSURE_BIAS) - viés de exposição EXIF\n" + +#: ../contrib/rename_images.lua:257 +msgid "$(EXIF_APERTURE) - EXIF aperture\n" +msgstr "$(EXIF_APERTURE) - abertura EXIF\n" + +#: ../contrib/rename_images.lua:258 +msgid "$(EXIF_FOCAL_LENGTH) - EXIF focal length\n" +msgstr "$(EXIF_FOCAL_LENGTH) - distância focal EXIF\n" + +#: ../contrib/rename_images.lua:259 +msgid "$(EXIF_FOCUS_DISTANCE) - EXIF focus distance\n" +msgstr "$(EXIF_FOCUS_DISTANCE) - distância do foco EXIF\n" + +#: ../contrib/rename_images.lua:260 +msgid "$(EXIF_CROP) - EXIF crop\n" +msgstr "$(EXIF_CROP) - corte EXIF\n" + +#: ../contrib/rename_images.lua:261 +msgid "$(LONGITUDE) - longitude\n" +msgstr "$(LONGITUDE) - longitude\n" + +#: ../contrib/rename_images.lua:262 +msgid "$(LATITUDE) - latitude\n" +msgstr "$(LATITUDE) - latitude\n" + +#: ../contrib/rename_images.lua:263 +msgid "$(ELEVATION) - elevation\n" +msgstr "$(ELEVATION) - elevação\n" + +#: ../contrib/rename_images.lua:264 +msgid "$(STARS) - star rating\n" +msgstr "$(STARS) - classificação de estrelas\n" + +#: ../contrib/rename_images.lua:265 +msgid "$(LABELS) - color labels\n" +msgstr "$(LABELS) - etiquetas de cor\n" + +#: ../contrib/rename_images.lua:266 +msgid "$(MAKER) - camera maker\n" +msgstr "$(MAKER) - fabricante da câmera\n" + +#: ../contrib/rename_images.lua:267 +msgid "$(MODEL) - camera model\n" +msgstr "$(MODEL) - modelo da câmera\n" + +#: ../contrib/rename_images.lua:268 +msgid "$(LENS) - lens\n" +msgstr "$(LENS) - lente\n" + +#: ../contrib/rename_images.lua:269 +msgid "$(TITLE) - title from metadata\n" +msgstr "$(TITLE) - título a partir dos metadados\n" + +#: ../contrib/rename_images.lua:270 +msgid "$(DESCRIPTION) - description from metadata\n" +msgstr "$(DESCRIPTION) - descrição a partir dos metadados\n" + +#: ../contrib/rename_images.lua:271 +msgid "$(CREATOR) - creator from metadata\n" +msgstr "$(CREATOR) - autor a partir dos metadados\n" + +#: ../contrib/rename_images.lua:272 +msgid "$(PUBLISHER) - publisher from metadata\n" +msgstr "$(PUBLISHER) - editor a partir dos metadados\n" + +#: ../contrib/rename_images.lua:273 +msgid "$(RIGHTS) - rights from metadata\n" +msgstr "$(RIGHTS) - direitos autorais a partir dos metadados\n" + +#: ../contrib/rename_images.lua:274 +msgid "$(USERNAME) - username\n" +msgstr "$(USERNAME) - nome do usuário\n" + +#: ../contrib/rename_images.lua:275 +msgid "$(PICTURES_FOLDER) - pictures folder\n" +msgstr "$(PICTURES_FOLDER) - pasta de imagens\n" + +#: ../contrib/rename_images.lua:276 +msgid "$(HOME) - user's home directory\n" +msgstr "$(HOME) - pasta pessoal do usuário\n" + +#: ../contrib/rename_images.lua:277 +msgid "$(DESKTOP) - desktop directory" +msgstr "$(DESKTOP) - pasta da área de trabalho" + +#: ../contrib/rename_images.lua:278 +msgid "enter pattern $(FILE_FOLDER)/$(FILE_NAME)" +msgstr "insira o padrão $(FILE_FOLDER)/$(FILE_NAME)" + +#: ../contrib/rename_images.lua:288 +msgid "rename" +msgstr "renomear" diff --git a/locale/pt_BR/LC_MESSAGES/script_manager.po b/locale/pt_BR/LC_MESSAGES/script_manager.po new file mode 100644 index 00000000..626ec843 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/script_manager.po @@ -0,0 +1,199 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 11:49-0300\n" +"PO-Revision-Date: 2021-09-28 19:41-0300\n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"X-Generator: Lokalize 21.08.1\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +#: script_manager.lua:314 +msgid "Cant read from " +msgstr "Não foi possível ler de " + +#: script_manager.lua:332 +msgid "Loaded " +msgstr "Carregado " + +#: script_manager.lua:344 +msgid " failed to load" +msgstr " falhou ao carregar" + +#: script_manager.lua:379 script_manager.lua:634 script_manager.lua:657 +msgid " stopped" +msgstr " parado" + +#: script_manager.lua:383 +msgid " will not start when darktable is restarted" +msgstr " não iniciará quando o darktable for reiniciado" + +#: script_manager.lua:443 script_manager.lua:507 +msgid "find command is " +msgstr "encontrar comando é " + +#: script_manager.lua:469 script_manager.lua:553 +msgid "" +"ERROR: git not found. Install or specify the location of the git executable." +msgstr "" +"ERRO: git não encontrado. Instale ou defina a localização do executável do" +" git." + +#: script_manager.lua:483 +msgid "lua scripts successfully updated" +msgstr "scripts lua atualizados com sucesso" + +#: script_manager.lua:543 +msgid "category " +msgstr "categoria " + +#: script_manager.lua:543 +msgid " is already in use. Please specify a different category name." +msgstr " já está em uso. Por favor, defina um nome de categoria diferente." + +#: script_manager.lua:572 +msgid "scripts successfully installed into category " +msgstr "scripts instalados com sucesso na categoria " + +#: script_manager.lua:588 +msgid "No scripts found to install" +msgstr "Nenhum script para instalação encontrado" + +#: script_manager.lua:592 +msgid "failed to download scripts" +msgstr "falha ao baixar scripts" + +#: script_manager.lua:627 +msgid " started" +msgstr " iniciado" + +#: script_manager.lua:732 +msgid "Page " +msgstr "Página " + +#: script_manager.lua:732 +msgid " of " +msgstr " de " + +#: script_manager.lua:934 +msgid "scripts to update" +msgstr "scripts a atualizar" + +#: script_manager.lua:935 +msgid "select the scripts installation to update" +msgstr "selecione as instalações de scripts a atualizar" + +#: script_manager.lua:944 script_manager.lua:1002 +msgid "update scripts" +msgstr "atualizar scripts" + +#: script_manager.lua:945 +msgid "update the lua scripts from the repository" +msgstr "atualizar os scripts lua a partir do repositório" + +#: script_manager.lua:956 +msgid "" +"enter the URL of the git repository containing the scripts you wish to add" +msgstr "" +"insira a URL do repositório git contendo os scripts que deseja adicionar" + +#: script_manager.lua:961 +msgid "name of new category" +msgstr "nome da nova categoria" + +#: script_manager.lua:962 +msgid "enter a category name for the additional scripts" +msgstr "insira um nome de categoria para os scripts adicionais" + +#: script_manager.lua:967 +msgid "URL to download additional scripts from" +msgstr "URL da qual baixar os scripts adicionais" + +#: script_manager.lua:969 +msgid "new category to place scripts in" +msgstr "nova categoria para colocar os scripts" + +#: script_manager.lua:972 +msgid "install additional scripts" +msgstr "instalar scripts adicionais" + +#: script_manager.lua:980 +msgid "Enable \"Disable Scripts\" button" +msgstr "Ativar botão \"Desabilitar Scripts\"" + +#: script_manager.lua:990 +msgid "Disable Scripts" +msgstr "Desabilitar Scripts" + +#: script_manager.lua:996 +msgid "lua scripts will not run the next time darktable is started" +msgstr "scripts lua não rodarão na próxima vez que o darktable for iniciado" + +#: script_manager.lua:1005 +msgid "add more scripts" +msgstr "adicionar mais scripts" + +#: script_manager.lua:1007 +msgid "disable scripts" +msgstr "desabilitar scripts" + +#: script_manager.lua:1015 +msgid "category" +msgstr "categoria" + +#: script_manager.lua:1016 +msgid "select the script category" +msgstr "selecione a categoria do script" + +#: script_manager.lua:1036 +msgid "Page:" +msgstr "Página:" + +#: script_manager.lua:1064 +msgid "Scripts" +msgstr "Scripts" + +#: script_manager.lua:1073 +msgid "scripts per page" +msgstr "scripts por página" + +#: script_manager.lua:1074 +msgid "select number of start/stop buttons to display" +msgstr "selecione o número de botões de iniciar/parar a exibir" + +#: script_manager.lua:1085 +msgid "change number of buttons" +msgstr "mudar o número de botões" + +#: script_manager.lua:1093 +msgid "Configuration" +msgstr "Configuração" + +#: script_manager.lua:1099 +msgid "use color interface?" +msgstr "usar interface colorida?" + +#: script_manager.lua:1122 +msgid "action" +msgstr "ação" + +#: script_manager.lua:1128 +msgid "install/update scripts" +msgstr "instalar/atualizar scripts" + +#: script_manager.lua:1128 +msgid "configure" +msgstr "configurar" + +#: script_manager.lua:1128 +msgid "start/stop scripts" +msgstr "iniciar/parar scripts" diff --git a/locale/pt_BR/LC_MESSAGES/select_untagged.po b/locale/pt_BR/LC_MESSAGES/select_untagged.po new file mode 100644 index 00000000..5408fafa --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/select_untagged.po @@ -0,0 +1,32 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 19:47-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/select_untagged.lua:47 +msgid "select untagged images" +msgstr "selecionar imagens sem etiqueta" + +#: ../contrib/select_untagged.lua:79 +msgid "select untagged" +msgstr "selecionar sem etiqueta" + +#: ../contrib/select_untagged.lua:81 +msgid "select all images containing no tags or only tags added by darktable" +msgstr "" +"seleciona todas as imagens que não possuam etiqueta ou somente etiquetas" +" adicionadas pelo darktable" diff --git a/locale/pt_BR/LC_MESSAGES/slideshowMusic.po b/locale/pt_BR/LC_MESSAGES/slideshowMusic.po new file mode 100644 index 00000000..c6fe4b5f --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/slideshowMusic.po @@ -0,0 +1,34 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-09-28 19:50-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/slideshowMusic.lua:56 +msgid "rhythmbox-client not found" +msgstr "cliente rhythmbox não encontrado" + +#: ../contrib/slideshowMusic.lua:85 +msgid "Slideshow background music file" +msgstr "Arquivo de música de fundo da apresentação" + +#: ../contrib/slideshowMusic.lua:89 +msgid "Play slideshow background music" +msgstr "Exibe uma apresentação com música de fundo" + +#: ../contrib/slideshowMusic.lua:90 +msgid "Plays music with rhythmbox if a slideshow starts" +msgstr "Toca música com o rhytmbox se uma apresentação inicia" diff --git a/locale/pt_BR/LC_MESSAGES/transfer_hierarchy.po b/locale/pt_BR/LC_MESSAGES/transfer_hierarchy.po new file mode 100644 index 00000000..b05fa153 --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/transfer_hierarchy.po @@ -0,0 +1,75 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:28-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/transfer_hierarchy.lua:153 +msgid "Lowest directory containing all selected images" +msgstr "Pasta de nível mais baixa contendo todas as imagens selecionadas" + +#: ../contrib/transfer_hierarchy.lua:256 +msgid "" +"transfer hierarchy: ERROR: existing root is out of sync -- click 'calculate' " +"to update" +msgstr "" +"transferir hierarquia: ERRO: raiz existente está fora de sincronia -- clique" +" 'calcular' para atualizar" + +#: ../contrib/transfer_hierarchy.lua:260 +msgid "transfer hierarchy: ERROR: destination not specified" +msgstr "transferir hierarquia: ERRO: destino não especificado" + +#: ../contrib/transfer_hierarchy.lua:270 +msgid "transfer hierarchy: ERROR: could not create directory: " +msgstr "transferir hierarquia: ERRO: não foi possível criar a pasta: " + +#: ../contrib/transfer_hierarchy.lua:275 +msgid "transfer hierarchy: ERROR: not a directory: " +msgstr "transferir hierarquia: ERRO: não é uma pasta: " + +#: ../contrib/transfer_hierarchy.lua:280 +msgid "transfer hierarchy: ERROR: could not create film: " +msgstr "transferir hierarquia: ERRO: não foi possível criar um filme: " + +#: ../contrib/transfer_hierarchy.lua:289 +#, lua-format +msgid "transfer hierarchy" +msgstr "transferir hierarquia" + +#: ../contrib/transfer_hierarchy.lua:327 +msgid "calculate" +msgstr "calcular" + +#: ../contrib/transfer_hierarchy.lua:331 +msgid "existing root" +msgstr "raiz existente" + +#: ../contrib/transfer_hierarchy.lua:336 +msgid "root of destination" +msgstr "raiz do destino" + +#: ../contrib/transfer_hierarchy.lua:341 +msgid "move" +msgstr "mover" + +#: ../contrib/transfer_hierarchy.lua:346 +msgid "copy" +msgstr "copiar" + +#: ../contrib/transfer_hierarchy.lua:347 +msgid "Copy all selected images" +msgstr "Copia todas as imagens selecionadas" diff --git a/locale/pt_BR/LC_MESSAGES/video_ffmpeg.po b/locale/pt_BR/LC_MESSAGES/video_ffmpeg.po new file mode 100644 index 00000000..9abc3cbc --- /dev/null +++ b/locale/pt_BR/LC_MESSAGES/video_ffmpeg.po @@ -0,0 +1,135 @@ +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER +# This file is distributed under the same license as the PACKAGE package. +# +# Marcus Gama , 2021. +msgid "" +msgstr "" +"Project-Id-Version: \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2021-09-28 19:37-0300\n" +"PO-Revision-Date: 2021-10-02 05:38-0300\n" +"Last-Translator: Marcus Gama \n" +"Language-Team: Portuguese \n" +"Language: pt_BR\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" +"X-Generator: Lokalize 21.08.1\n" + +#: ../contrib/video_ffmpeg.lua:243 +msgid "framerate" +msgstr "taxa de quadros" + +#: ../contrib/video_ffmpeg.lua:244 +msgid "select framerate of output video" +msgstr "seleciona a taxa de quadros da saída de vídeo" + +#: ../contrib/video_ffmpeg.lua:251 +msgid "resolution" +msgstr "resolução" + +#: ../contrib/video_ffmpeg.lua:252 +msgid "select resolution of output video" +msgstr "seleciona a resolução da saída de vídeo" + +#: ../contrib/video_ffmpeg.lua:259 +msgid "codec" +msgstr "codec" + +#: ../contrib/video_ffmpeg.lua:260 +msgid "select codec" +msgstr "seleciona o codec" + +#: ../contrib/video_ffmpeg.lua:267 +msgid "format container" +msgstr "formato" + +#: ../contrib/video_ffmpeg.lua:268 +msgid "select format of output video" +msgstr "seleciona o formato da saída de vídeo" + +#: ../contrib/video_ffmpeg.lua:280 +msgid "output file destination" +msgstr "destino do arquivo de saída" + +#: ../contrib/video_ffmpeg.lua:281 +msgid "settings of output file destination and name" +msgstr "configurações do destino e nome do arquivo de saída" + +#: ../contrib/video_ffmpeg.lua:296 +msgid "Select export path" +msgstr "Selecionar caminho de exportação" + +#: ../contrib/video_ffmpeg.lua:298 +msgid "" +"select the target directory for the timelapse. \n" +"the filename is created automatically." +msgstr "" +"selecione a pasta alvo para o timelapse.\n" +"o nome do arquivo é criado automaticamente." + +#: ../contrib/video_ffmpeg.lua:305 +msgid "" +"if selected, output video will be placed in the same directory as first of " +"selected images" +msgstr "" +"se selecionado, o vídeo de saída será colocado na mesma pasta da primeira das" +" imagens " +"selecionadas" + +#: ../contrib/video_ffmpeg.lua:320 +msgid "override output file on conflict" +msgstr "sobrescrever arquivo de saída em caso de conflito" + +#: ../contrib/video_ffmpeg.lua:321 +msgid "if checked, in case of file name conflict, the file will be overwritten" +msgstr "se ativo, em caso de conflito de nome, o arquivo será sobrescrito" + +#: ../contrib/video_ffmpeg.lua:329 +msgid "" +"enter output file name without extension.\n" +"\n" +"You can use some placeholders:\n" +"- {time} - time in format HH-mm-ss\n" +"- {date} - date in foramt YYYY-mm-dd\n" +"- {first_file} - name of first input file\n" +"- {last_file} - name of last last_file" +msgstr "" +"insira o nome do arquivo de saída sem extensão.\n" +"\n" +"Você pode usar alguns coringas:\n" +"- {time} - tempo no formato HH-mm-ss\n" +"- {date} - data no formato AAAA-mm-dd\n" +"- {first_file} - nome do primeiro arquivo de entrada\n" +"- {last_file} - nome do último last_file" + +#: ../contrib/video_ffmpeg.lua:349 +msgid " open after export" +msgstr " abrir após exportar" + +#: ../contrib/video_ffmpeg.lua:350 +msgid "open video file after successful export" +msgstr "abre o arquivo de vídeo após ser exportado com sucesso" + +#: ../contrib/video_ffmpeg.lua:377 +msgid "export " +msgstr "exportar " + +#: ../contrib/video_ffmpeg.lua:433 +msgid "prepare merge process" +msgstr "preparar o processo de mesclagem" + +#: ../contrib/video_ffmpeg.lua:436 +msgid "ERROR: cannot create temp directory" +msgstr "ERRO: não foi possível criar a pasta temporária" + +#: ../contrib/video_ffmpeg.lua:448 +msgid "ERROR: cannot build image, see console for more info" +msgstr "" +"ERRO: não foi possível construir a imagem, veja o console para mais" +" informações" + +#: ../contrib/video_ffmpeg.lua:450 +msgid "SUCCESS" +msgstr "SUCESSO" diff --git a/official/apply_camera_style.lua b/official/apply_camera_style.lua new file mode 100644 index 00000000..fe836c3b --- /dev/null +++ b/official/apply_camera_style.lua @@ -0,0 +1,498 @@ +--[[ + + apply_camera_style.lua - apply camera style to matching images + + Copyright (C) 2024 Bill Ferguson . + + This program 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. + + This program 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 this program. If not, see . +]] +--[[ + apply_camera_style - apply darktable camera style to matching images + + apply a camera style corresponding to the camera used to + take the image to provide a starting point for editing that + is similar to the SOOC jpeg. + + ADDITIONAL SOFTWARE NEEDED FOR THIS SCRIPT + none + + USAGE + start the script from script_manager + + BUGS, COMMENTS, SUGGESTIONS + Bill Ferguson + + CHANGES +]] + +local dt = require "darktable" +local du = require "lib/dtutils" +-- local df = require "lib/dtutils.file" +-- local ds = require "lib/dtutils.string" +-- local dtsys = require "lib/dtutils.system" +local log = require "lib/dtutils.log" +-- local debug = require "darktable.debug" + + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- C O N S T A N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local MODULE = "apply_camera_style" +local DEFAULT_LOG_LEVEL = log.info +local TMP_DIR = dt.configuration.tmp_dir +local STYLE_PREFIX = "_l10n_darktable|_l10n_camera styles|" +local MAKER = 3 +local STYLE = 4 + +-- path separator +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +-- command separator +local CS = dt.configuration.running_os == "windows" and "&" or ";" + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A P I C H E C K +-- - - - - - - - - - - - - - - - - - - - - - - - + +du.check_min_api_version("9.4.0", MODULE) -- camera styles added to darktable 5.0 + + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- I 1 8 N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- - - - - - - - - - - - - - - - - - - - - - - - - - +-- S C R I P T M A N A G E R I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - - - + +local script_data = {} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +script_data.metadata = { + name = _("apply camera style"), -- name of script + purpose = _("apply darktable camera style to matching images"), -- purpose of script + author = "Bill Ferguson ", -- your name and optionally e-mail address + help = "https://docs.darktable.org/lua/development/lua.scripts.manual/scripts/official/apply_camera_style/" -- URL to help/documentation +} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- L O G L E V E L +-- - - - - - - - - - - - - - - - - - - - - - - - + +log.log_level(DEFAULT_LOG_LEVEL) + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- N A M E S P A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +local apply_camera_style = {} + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- G L O B A L V A R I A B L E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +apply_camera_style.imported_images = {} +apply_camera_style.styles = {} +apply_camera_style.log_level = DEFAULT_LOG_LEVEL + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- P R E F E R E N C E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- A L I A S E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +local namespace = apply_camera_style +local acs = apply_camera_style + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- F U N C T I O N S +-- - - - - - - - - - - - - - - - - - - - - - - - + +------------------- +-- helper functions +------------------- + +local function set_log_level(level) + local old_log_level = log.log_level() + log.log_level(level) + return old_log_level +end + +local function restore_log_level(level) + log.log_level(level) +end + +------------------- +-- script functions +------------------- + +local function process_pattern(pattern) + + local log_level = set_log_level(acs.log_level) + + pattern = string.lower(pattern) + -- strip off series + pattern = string.gsub(pattern, " series$", "?") + -- match a character + if string.match(pattern, "?$") then + -- handle EOS R case + pattern = string.gsub(pattern, "?", ".?") + else + pattern = string.gsub(pattern, "?", ".") + end + pattern = string.gsub(pattern, " ", " ?") + -- escape dashes + pattern = string.gsub(pattern, "%-", "%%-") + -- make spaces optional + pattern = string.gsub(pattern, " ", " ?") + -- until we end up with a set, I'll defer set processing, i.e. [...] + -- anchor the pattern to ensure we don't short match + pattern = "^" .. pattern .. "$" + + restore_log_level(log_level) + + return pattern +end + +local function process_set(pattern_set) + + local log_level = set_log_level(acs.log_level) + + local to_process = {} + local processed = {} + + local base, set, tail + + if string.match(pattern_set, "]$") then + base, set = string.match(pattern_set, "(.+)%[(.+)%]") + else + base, set, tail = string.match(pattern_set, "(.+)%[(.+)%](.+)") + end + + log.msg(log.debug, "base is " .. base .. " and set is " .. set) + + to_process = du.split(set, ",") + + for _, item in ipairs(to_process) do + local pat = base .. item + if tail then + pat = pat .. tail + end + table.insert(processed, process_pattern(pat)) + end + + restore_log_level(log_level) + + return processed +end + +local function get_camera_styles() + + local log_level = set_log_level(acs.log_level) + + -- separate the styles into + -- + -- acs.styles - + -- maker - + -- styles {} + -- patterns {} + + for _, style in ipairs(dt.styles) do + + if string.match(style.name, STYLE_PREFIX) then + log.msg(log.debug, "got " .. style.name) + + local parts = du.split(style.name, "|") + parts[MAKER] = string.lower(parts[MAKER]) + log.msg(log.debug, "maker is " .. parts[MAKER]) + + if not acs.styles[parts[MAKER]] then + acs.styles[parts[MAKER]] = {} + acs.styles[parts[MAKER]]["styles"] = {} + acs.styles[parts[MAKER]]["patterns"] = {} + end + if parts[STYLE] then + if not string.match(parts[STYLE], "]") then + table.insert(acs.styles[parts[MAKER]].styles, style) + local processed_pattern = process_pattern(parts[#parts]) + table.insert(acs.styles[parts[MAKER]].patterns, processed_pattern) + log.msg(log.debug, "pattern for " .. style.name .. " is " .. processed_pattern) + else + local processed_patterns = process_set(parts[STYLE]) + for _, pat in ipairs(processed_patterns) do + table.insert(acs.styles[parts[MAKER]].styles, style) + table.insert(acs.styles[parts[MAKER]].patterns, pat) + log.msg(log.debug, "pattern for " .. style.name .. " is " .. pat) + end + end + end + end + end + + restore_log_level(log_level) + +end + +local function normalize_model(maker, model) + + local log_level = set_log_level(acs.log_level) + + model = string.lower(model) + + -- strip off the maker name + if maker == "canon" then + model = string.gsub(model, "canon ", "") + elseif maker == "hasselblad" then + model = string.gsub(model, "hasselblad ", "") + elseif maker == "leica" then + model = string.gsub(model, "leica ", "") + elseif maker == "lg" then + model = string.gsub(model, "lg ", "") + elseif maker == "nikon" then + model = string.gsub(model, "nikon ", "") + elseif maker == "nokia" then + model = string.gsub(model, "nokia ", "") + elseif maker == "oneplus" then + model = string.gsub(model, "oneplus ", "") + elseif maker == "pentax" then + model = string.gsub(model, "pentax ", "") + model = string.gsub(model, "ricoh ", "") + end + + restore_log_level(log_level) + + return model +end + +local function normalize_maker(maker) + + local log_level = set_log_level(acs.log_level) + + maker = string.lower(maker) + + if string.match(maker, "^fujifilm") then + maker = "fujifilm" + elseif string.match(maker, "^hmd ") then + maker = "nokia" + elseif string.match(maker, "^leica") then + maker = "leica" + elseif string.match(maker, "^minolta") then + maker = "minolta" + elseif string.match(maker, "^nikon") then + maker = "nikon" + elseif string.match(maker, "^om ") then + maker = "om system" + elseif string.match(maker, "^olympus") then + maker = "olympus" + elseif string.match(maker, "^pentax") or string.match(maker, "^ricoh") then + maker = "pentax" + end + + restore_log_level(log_level) + + return maker +end + +local function has_style_tag(image, tag_name) + + local log_level = set_log_level(acs.log_level) + + local result = false + + log.msg(log.debug, "looking for tag " .. tag_name) + + for _, tag in ipairs(image:get_tags()) do + log.msg(log.debug, "checking against " .. tag.name) + if tag.name == tag_name then + log.msg(log.debug, "matched tag " .. tag_name) + result = true + end + end + + restore_log_level(log_level) + + return result +end + +local function mangle_model(model) + + local log_level = set_log_level(acs.log_level) + + if string.match(model, "eos") then + log.msg(log.debug, "mangle model got " .. model) + model = string.gsub(model, "r6m2", "r6 mark ii") + model = string.gsub(model, "eos 350d digital", "eos kiss digital n") + model = string.gsub(model, "eos 500d", "eos rebel t1") + model = string.gsub(model, "eos 550d", "eos rebel t2") + model = string.gsub(model, "eos 600d", "eos rebel t3i") + model = string.gsub(model, "eos 650d", "eos rebel t4i") + model = string.gsub(model, "eos 700d", "eos rebel t5") + model = string.gsub(model, "eos 750d", "eos rebel t6i") + model = string.gsub(model, "eos 760d", "eos rebel t6s") + model = string.gsub(model, "eos 100d", "eos rebel t6") + model = string.gsub(model, "eos 1100d", "eos rebel t3") + model = string.gsub(model, "eos 1200d", "eos rebel t5") + model = string.gsub(model, "eos 1300d", "eos rebel t6") + model = string.gsub(model, "eos 2000d", "eos rebel t7") + log.msg(log.debug, "mandle model returning " .. model) + end + + restore_log_level(log_level) + + return model +end + +local function stop_job() + if acs.job then + if acs.job.valid then + acs.job.valid = false + end + end +end + +local function apply_style_to_images(images) + + local log_level = set_log_level(acs.log_level) + + acs.job = dt.gui.create_job(_("applying camera styles to images"), true, stop_job) + + for count, image in ipairs(images) do + local maker = normalize_maker(image.exif_maker) + local model = normalize_model(maker, image.exif_model) + model = mangle_model(model) + log.msg(log.debug, "got maker " .. maker .. " and model " .. model .. " from image " .. image.filename) + + if acs.styles[maker] then + local no_match = true + for i, pattern in ipairs(acs.styles[maker].patterns) do + if string.match(model, pattern) or + (i == #acs.styles[maker].patterns and string.match(pattern, "generic")) then + local tag_name = "darktable|style|" .. acs.styles[maker].styles[i].name + if not has_style_tag(image, tag_name) then + image:apply_style(acs.styles[maker].styles[i]) + no_match = false + log.msg(log.info, "applied style " .. acs.styles[maker].styles[i].name .. " to " .. image.filename) + end + log.log_level(loglevel) + break + end + end + if no_match then + log.msg(log.info, "no style found for " .. maker .. " " .. model) + end + else + log.msg(log.info, "no maker found for " .. image.filename) + end + if count % 10 == 0 then + acs.job.percent = count / #images + end + if dt.control.ending then + stop_job() + end + end + + stop_job() + + restore_log_level(log_level) + +end + +local function apply_camera_style(collection) + + local log_level = set_log_level(acs.log_level) + + local images = nil + + if collection == true then + images = dt.collection + log.msg(log.info, "applying camera styles to collection") + elseif collection == false then + images = dt.gui.selection() + if #images == 0 then + images = dt.gui.action_images + end + log.msg(log.info, "applying camera styles to selection") + end + apply_style_to_images(images) + + restore_log_level(log_level) + +end + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- M A I N P R O G R A M +-- - - - - - - - - - - - - - - - - - - - - - - - + +get_camera_styles() + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- U S E R I N T E R F A C E +-- - - - - - - - - - - - - - - - - - - - - - - - + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +local function destroy() + dt.destroy_event(MODULE, "post-import-image") + dt.destroy_event(MODULE, "post-import-film") +end + +script_data.destroy = destroy + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- E V E N T S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.register_event(MODULE, "shortcut", + function(event, shortcut) + apply_camera_style(true) + end, _("apply darktable camera styles to collection") +) + +dt.register_event(MODULE, "shortcut", + function(event, shortcut) + apply_camera_style(false) + end, _("apply darktable camera styles to selection") +) + +dt.register_event(MODULE, "post-import-image", + function(event, image) + if image.is_raw then + table.insert(acs.imported_images, image) + end + end +) + +dt.register_event(MODULE, "post-import-film", + function(event, film) + apply_style_to_images(acs.imported_images) + acs.imported_images = {} + end +) + +return script_data diff --git a/official/check_for_updates.lua b/official/check_for_updates.lua index 712daab1..aeb45edb 100644 --- a/official/check_for_updates.lua +++ b/official/check_for_updates.lua @@ -21,7 +21,7 @@ a simple script that will automatically look for newer releases on github and in when there is something. it will only check on startup and only once a week. USAGE -* install luasec and cjson for Lua 5.2 on your system +* install luasec and cjson for Lua 5.4 on your system * require this script from your main lua file * restart darktable @@ -34,6 +34,28 @@ local cjson = require "cjson" du.check_min_api_version("2.0.0", "check_for_updates") +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("check for updates"), + purpose = _("check for newer darktable releases"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/check_for_updates" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + -- compare two version strings of the form "major.minor.patch" -- returns -1, 0, 1 if the first version is smaller, equal, greater than the second version, -- or nil if one or both are of the wrong format @@ -80,6 +102,10 @@ local function compare_versions(a, b) end end +local function destroy() + -- nothing to destroy +end + -- local function test(a, b, r) -- local cmp = compare_versions(a, b) @@ -134,3 +160,6 @@ if now > (back_then + 60 * 60 * 24 * 7) then end end + +script_data.destroy = destroy +return script_data diff --git a/official/copy_paste_metadata.lua b/official/copy_paste_metadata.lua index ca7ccae4..00040c9b 100644 --- a/official/copy_paste_metadata.lua +++ b/official/copy_paste_metadata.lua @@ -27,8 +27,29 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "copy_paste_metadata") +du.check_min_api_version("7.0.0", "copy_paste_metadata") + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("copy paste metadata"), + purpose = _("adds keyboard shortcuts and buttons to copy/paste metadata between images"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/copy_paste_metadata" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them -- set this to "false" if you don't want to overwrite metadata fields -- (title, description, creator, publisher and rights) that are already set @@ -104,26 +125,41 @@ local function paste(images) end end +local function destroy() + dt.gui.libs.image.destroy_action("metadata_copy") + dt.gui.libs.image.destroy_action("metadata_paste") + dt.destroy_event("capmd1", "shortcut") + dt.destroy_event("capmd2", "shortcut") +end + dt.gui.libs.image.register_action( - "copy metadata", + "metadata_copy", _("copy metadata"), function(event, images) copy(images[1]) end, - "copy metadata of the first selected image" + _("copy metadata of the first selected image") ) + + dt.gui.libs.image.register_action( - "paste metadata", + "metadata_paste", _("paste metadata"), function(event, images) paste(images) end, - "paste metadata to the selected images" + _("paste metadata to the selected images") ) + + dt.register_event( - "shortcut", + "capmd1", "shortcut", function(event, shortcut) copy(dt.gui.action_images[1]) end, - "copy metadata" + _("copy metadata") ) dt.register_event( - "shortcut", + "capmd2", "shortcut", function(event, shortcut) paste(dt.gui.action_images) end, - "paste metadata" + _("paste metadata") ) + +script_data.destroy = destroy + +return script_data diff --git a/official/delete_long_tags.lua b/official/delete_long_tags.lua index 9ab1a289..c770402b 100644 --- a/official/delete_long_tags.lua +++ b/official/delete_long_tags.lua @@ -33,11 +33,37 @@ local du = require "lib/dtutils" du.check_min_api_version("2.0.0", "delete_long_tags") +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("delete long tags"), + purpose = _("delete all tags longer than a set length"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/delete_long_tags" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + dt.preferences.register("delete_long_tags", "length", "integer", "maximum length of tags to keep", "tags longer than this get deleted on start", 666, 0, 65536) +local function destroy() + -- noting to destroy +end + local max_length = dt.preferences.read("delete_long_tags", "length", "integer") -- deleting while iterating the tags list seems to break the iterator! @@ -46,7 +72,7 @@ local long_tags = {} for _,t in ipairs(dt.tags) do local len = #t.name if len > max_length then - print("deleting tag `"..t.name.."' (length: "..len..")") + dt.print_log("deleting tag `"..t.name.."' (length: "..len..")") table.insert(long_tags, t.name) end end @@ -55,3 +81,7 @@ for _,name in pairs(long_tags) do tag = dt.tags.find(name) tag:delete() end + +script_data.destroy = destroy + +return script_data diff --git a/official/delete_unused_tags.lua b/official/delete_unused_tags.lua index 4c114230..3815aea0 100644 --- a/official/delete_unused_tags.lua +++ b/official/delete_unused_tags.lua @@ -31,6 +31,34 @@ local du = require "lib/dtutils" du.check_min_api_version("5.0.0", "delete_unused_tags") +local script_data = {} + +local function destroy() + -- noting to destroy +end + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("delete unused tags"), + purpose = _("delete unused tags"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/delete_unused_tags" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + -- deleting while iterating the tags list seems to break the iterator! local unused_tags = {} @@ -41,7 +69,10 @@ for _, t in ipairs(dt.tags) do end for _,name in pairs(unused_tags) do - print("deleting tag `" .. name .. "'") + dt.print_log("deleting tag `" .. name .. "'") tag = dt.tags.find(name) tag:delete() end + +script_data.destroy = destroy +return script_data \ No newline at end of file diff --git a/official/enfuse.lua b/official/enfuse.lua index 935f3405..7bda2cf4 100644 --- a/official/enfuse.lua +++ b/official/enfuse.lua @@ -39,15 +39,62 @@ local dtsys = require "lib/dtutils.system" local PS = dt.configuration.running_os == "windows" and "\\" or "/" -local gettext = dt.gettext +local gettext = dt.gettext.gettext -du.check_min_api_version("3.0.0", "enfuse") - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("enfuse",dt.configuration.config_dir..PS .. "lua" .. PS .. "locale" .. PS) +du.check_min_api_version("7.0.0", "enfuse") local function _(msgid) - return gettext.dgettext("enfuse", msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("enfuse"), + purpose = _("exposure blend images"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/enfuse" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local enf = {} +enf.event_registered = false +enf.module_installed = false +enf.lib_widgets = {} + +local function install_module() + if not enf.module_installed then + dt.register_lib( + "enfuse", -- plugin name + _("enfuse"), -- name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers + dt.new_widget("box") -- widget + { + orientation = "vertical", + sensitive = enfuse_installed, + table.unpack(enf.lib_widgets) + }, + nil,-- view_enter + nil -- view_leave + ) + enf.module_installed = true + end +end + +local function destroy() + dt.gui.libs["enfuse"].visible = false +end + +local function restart() + dt.gui.libs["enfuse"].visible = true end -- add a new lib @@ -88,8 +135,8 @@ if enfuse_installed then if version < "4.2" then exposure_mu = dt.new_widget("slider") { - label = "exposure mu", - tooltip = "center also known as MEAN of Gaussian weighting function (0 <= MEAN <= 1); default: 0.5", + label = _("exposure mu"), + tooltip = _("center also known as mean of gaussian weighting function (0 <= mean <= 1); default: 0.5"), hard_min = 0, hard_max = 1, value = dt.preferences.read("enfuse", "exposure_mu", "float") @@ -97,8 +144,8 @@ if enfuse_installed then else exposure_mu = dt.new_widget("slider") { - label = "exposure optimum", - tooltip = "optimum exposure value, usually the maximum of the weighting function (0 <= OPTIMUM <=1); default 0.5", + label = _("exposure optimum"), + tooltip = _("optimum exposure value, usually the maximum of the weighting function (0 <= optimum <=1); default 0.5"), hard_min = 0, hard_max = 1, value = dt.preferences.read("enfuse", "exposure_optimum", "float") @@ -107,16 +154,24 @@ if enfuse_installed then local depth = dt.new_widget("combobox") { - label = "depth", - tooltip = "the number of bits per channel of the output image", + label = _("depth"), + tooltip = _("the number of bits per channel of the output image"), value = dt.preferences.read("enfuse", "depth", "integer"), changed_callback = function(w) dt.preferences.write("enfuse", "depth", "integer", w.selected) end, "8", "16", "32" } + local blend_colorspace = dt.new_widget("combobox") + { + label = _("blend colorspace"), + tooltip = _("force blending in selected colorspace"), + changed_callback = function(w) dt.preferences.write("enfuse", "blend_colorspace", "string", w.selected) end, + "", "identity", "ciecam" + } + local enfuse_button = dt.new_widget("button") { - label = enfuse_installed and "run enfuse" or "enfuse not installed", + label = enfuse_installed and _("run enfuse") or _("enfuse not installed"), clicked_callback = function () -- remember exposure_mu -- TODO: find a way to save it whenever the value changes @@ -134,7 +189,7 @@ if enfuse_installed then end local f = io.open(response_file, "w") if not f then - dt.print(string.format(_("Error writing to `%s`"), response_file)) + dt.print(string.format(_("error writing to '%s'"), response_file)) os.remove(response_file) return end @@ -157,9 +212,9 @@ if enfuse_installed then if dt.configuration.running_os == "windows" then tmp_exported = dt.configuration.tmp_dir .. tmp_exported -- windows os.tmpname() defaults to root directory end - dt.print(string.format(_("Converting raw file '%s' to tiff..."), i.filename)) + dt.print(string.format(_("converting raw file '%s' to tiff..."), i.filename)) tiff_exporter:write_image(i, tmp_exported, false) - dt.print_log(string.format("Raw file '%s' converted to '%s'", i.filename, tmp_exported)) + dt.print_log(string.format("raw file '%s' converted to '%s'", i.filename, tmp_exported)) cnt = cnt + 1 f:write(tmp_exported.."\n") @@ -167,14 +222,14 @@ if enfuse_installed then -- other images will be skipped else - dt.print(string.format(_("Skipping %s..."), i.filename)) + dt.print(string.format(_("skipping %s..."), i.filename)) n_skipped = n_skipped + 1 end end f:close() -- bail out if there is nothing to do if cnt == 0 then - dt.print(_("No suitable images selected, nothing to do for enfuse")) + dt.print(_("no suitable images selected, nothing to do for enfuse")) os.remove(response_file) return end @@ -186,16 +241,21 @@ if enfuse_installed then -- call enfuse on the response file -- TODO: find something nicer local ugly_decimal_point_hack = string.gsub(string.format("%.04f", mu), ",", ".") - -- TODO: make filename unique - local output_image = target_dir.. PS .. "enfuse.tif" + local output_image_date = os.date("%Y%m%d%H%M%S") + local output_image = target_dir.. PS .. "enfuse-"..output_image_date..".tif" local exposure_option = " --exposure-optimum " + local blend_colorspace_option = "" + if #blend_colorspace.value > 1 then + blend_colorspace_option = " --blend-colorspace="..blend_colorspace.value + end if version < "4.2" then exposure_option = " --exposure-mu " end local command = enfuse_installed.." --depth "..depth.value..exposure_option..ugly_decimal_point_hack + ..blend_colorspace_option .." -o \""..output_image.."\" \"@"..response_file.."\"" if dtsys.external_command( command) > 0 then - dt.print(_("Enfuse failed, see terminal output for details")) + dt.print(_("enfuse failed, see terminal output for details")) os.remove(response_file) return end @@ -216,34 +276,41 @@ if enfuse_installed then local lib_widgets = {} if not enfuse_installed then - table.insert(lib_widgets, df.executable_path_widget({"ffmpeg"})) + table.insert(enf.lib_widgets, df.executable_path_widget({"ffmpeg"})) end - table.insert(lib_widgets, exposure_mu) - table.insert(lib_widgets, depth) - table.insert(lib_widgets, enfuse_button) + table.insert(enf.lib_widgets, exposure_mu) + table.insert(enf.lib_widgets, depth) + table.insert(enf.lib_widgets, blend_colorspace) + table.insert(enf.lib_widgets, enfuse_button) -- ... and tell dt about it all - dt.register_lib( - "enfuse", -- plugin name - "enfuse", -- name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_RIGHT_CENTER", 100}}, -- containers - dt.new_widget("box") -- widget - { - orientation = "vertical", - sensitive = enfuse_installed, - table.unpack(lib_widgets) - }, - nil,-- view_enter - nil -- view_leave - ) + if dt.gui.current_view().id == "lighttable" then + install_module() + else + if not enf.event_registered then + dt.register_event( + "enfuse", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + enf.event_registered = true + end + end else dt.print_error("enfuse executable not found") error("enfuse executable not found") - dt.print(_("Could not find enfuse executable. Not loading enfuse exporter...")) + dt.print(_("could not find enfuse executable, not loading enfuse exporter...")) end +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart + +return script_data -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua -- kate: hl Lua; diff --git a/official/generate_image_txt.lua b/official/generate_image_txt.lua index a214a2ae..c786aabf 100644 --- a/official/generate_image_txt.lua +++ b/official/generate_image_txt.lua @@ -37,36 +37,62 @@ USAGE local dt = require "darktable" local du = require "lib/dtutils" require "darktable.debug" -require "official/yield" -du.check_min_api_version("2.1.0", "generate_image_txt") +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +du.check_min_api_version("7.0.0", "generate_image_txt") + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("generate image text"), + purpose = _("overlay metadata on the selected image(s)"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/generate_image_txt" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them dt.preferences.register("generate_image_txt", "enabled", "bool", - "create txt sidecars to display with images", - "the txt files created get shown when the lighttable is zoomed in to one image. also enable the txt overlay setting in the gui tab", + _("create txt sidecars to display with images"), + _("the txt files created get shown when the lighttable is zoomed in to one image. also enable the txt overlay setting in the gui tab"), false) dt.preferences.register("generate_image_txt", "command", "string", - "command to generate the txt sidecar", - "the output of this command gets written to the txt file. use $(FILE_NAME) for the image file", + _("command to generate the txt sidecar"), + _("the output of this command gets written to the txt file. use $(FILE_NAME) for the image file"), "exiv2 $(FILE_NAME)") local check_command = function(command) if not command:find("$(FILE_NAME)", 1, true) then - dt.print("the command for txt sidecars looks bad. better check the preferences") + dt.print(_("the command for txt sidecars looks bad. better check the preferences")) end end +local function destroy() + dt.destroy_event("gen_img_txt", "mouse-over-image-changed") +end + local command_setting = dt.preferences.read("generate_image_txt", "command", "string") check_command(command_setting) -dt.register_event("mouse-over-image-changed", function(event, img) +dt.register_event("gen_img_txt", "mouse-over-image-changed", + function(event, img) -- no need to waste processing time if the image has a txt file already if not img or img.has_txt or not dt.preferences.read("generate_image_txt", "enabled", "bool") then return @@ -104,6 +130,9 @@ dt.register_event("mouse-over-image-changed", function(event, img) end ) +script_data.destroy = destroy + +return script_data -- vim: shiftwidth=2 expandtab tabstop=2 cindent -- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; diff --git a/official/image_path_in_ui.lua b/official/image_path_in_ui.lua index 18e57cae..2f23184a 100644 --- a/official/image_path_in_ui.lua +++ b/official/image_path_in_ui.lua @@ -31,10 +31,46 @@ This plugin will add a widget at the bottom of the left column in lighttable mod local dt = require "darktable" local du = require "lib/dtutils" -du.check_min_api_version("2.0.0", "image_path_in_ui") +du.check_min_api_version("7.0.0", "image_path_in_ui") + +local gettext = dt.gettext.gettext + +local function _(msgid) + return gettext(msgid) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("image path in UI"), + purpose = _("print the image path in the UI"), + author = "Jérémy Rosen", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/image_path_in_ui" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local ipiu = {} +ipiu.module_installed = false +ipiu.event_registered = false local main_label = dt.new_widget("label"){selectable = true, ellipsize = "middle", halign = "start"} +local function install_module() + if not ipiu.module_installed then + dt.register_lib("image_path_no_ui",_("selected images path"),true,false,{ + [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER",300} + }, main_label + ) + ipiu.module_installed = true + end +end + local function reset_widget() local selection = dt.gui.selection() local result = "" @@ -52,14 +88,45 @@ local function reset_widget() main_label.label = result end +local function destroy() + dt.gui.libs["image_path_no_ui"].visible = false + dt.destroy_event("ipiu", "mouse-over-image-changed") +end + +local function restart() + dt.register_event("ipiu", "mouse-over-image-changed", reset_widget); + dt.gui.libs["image_path_no_ui"].visible = true +end + +local function show() + dt.gui.libs["image_path_no_ui"].visible = true +end + main_label.reset_callback = reset_widget -dt.register_lib("image_path_no_ui","Selected Images path",true,false,{ - [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER",300} - }, main_label - ); +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not ipiu.event_registered then + dt.register_event( + "ipiu", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + ipiu.event_registered = true + end +end + +dt.register_event("ipiu", "mouse-over-image-changed", reset_widget); -dt.register_event("mouse-over-image-changed",reset_widget); +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = show +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/official/import_filter_manager.lua b/official/import_filter_manager.lua index fafb2fe4..adf83620 100644 --- a/official/import_filter_manager.lua +++ b/official/import_filter_manager.lua @@ -32,19 +32,40 @@ USAGE local dt = require "darktable" +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +local script_data = {} + +script_data.metadata = { + name = _("import filter manager"), + purpose = _("manage import filters"), + author = "Tobias Ellinghaus", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/import_filter_manager" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + local import_filter_list = {} local n_import_filters = 1 -- allow changing the filter from the preferences dt.preferences.register("import_filter_manager", "active_filter", "string", - "import filter", "the name of the filter used for importing images", "") + _("import filter"), _("the name of the filter used for importing images"), "") -- the dropdown to select the active filter from the import dialog local filter_dropdown = dt.new_widget("combobox") { - label = "import filter", + label = _("import filter"), editable = false, + tooltip = _("import filters are applied after completion of the import dialog"), changed_callback = function(widget) dt.preferences.write("import_filter_manager", "active_filter", "string", widget.value) @@ -56,7 +77,7 @@ dt.gui.libs.import.register_widget(filter_dropdown) -- this is just a wrapper which calls the active import filter -dt.register_event("pre-import", function(event, images) +dt.register_event("ifm", "pre-import", function(event, images) local active_filter = dt.preferences.read("import_filter_manager", "active_filter", "string") if active_filter == "" then return end local callback = import_filter_list[active_filter] @@ -74,6 +95,12 @@ dt.register_import_filter = function(name, callback) if name == active_filter then filter_dropdown.value = n_import_filters end end +local function destroy() + --noting to destroy +end + +script_data.destroy = destroy +return script_data -- vim: shiftwidth=2 expandtab tabstop=2 cindent -- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; diff --git a/official/import_filters.lua b/official/import_filters.lua index 584a2718..87d8b0ef 100644 --- a/official/import_filters.lua +++ b/official/import_filters.lua @@ -30,11 +30,31 @@ USAGE local dt = require "darktable" +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +local script_data = {} + +script_data.metadata = { + name = _("import filters"), + purpose = _("import filtering"), + author = "Tobias Ellinghaus & Christian Mandel", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/import_filters" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + -- we get fed a sorted list of filenames. just setting images to ignore to nil is enough -- ignore jpeg dt.register_import_filter("ignore jpegs", function(event, images) - dt.print_error("ignoring all jpegs") + dt.print_log("ignoring all jpegs") for i, img in ipairs(images) do local extension = img:match("[^.]*$"):upper() if (extension == "JPG") or (extension == "JPEG") then @@ -88,5 +108,13 @@ dt.register_import_filter("prefer raw over jpeg", function(event, images) end) +local function destroy() + -- nothing to destroy +end + +script_data.destroy = destroy + +return script_data + -- vim: shiftwidth=2 expandtab tabstop=2 cindent -- kate: tab-indents: off; indent-width 2; replace-tabs on; remove-trailing-space on; diff --git a/official/save_selection.lua b/official/save_selection.lua index 1d71ea97..64d33b4e 100644 --- a/official/save_selection.lua +++ b/official/save_selection.lua @@ -36,24 +36,57 @@ increase it if you need more temporary selection buffers local dt = require "darktable" local du = require "lib/dtutils" -du.check_min_api_version("2.0.0", "save_selection") +du.check_min_api_version("7.0.0", "save_selection") + +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("save selection"), + purpose = _("shortcuts providing multiple selection buffers"), + author = "Jérémy Rosen", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/save_selection" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them local buffer_count = 5 -for i=1,buffer_count do +local function destroy() + for i = 1, buffer_count do + dt.destroy_event("save_selection save " .. i, "shortcut") + dt.destroy_event("save_selection restore " .. i, "shortcut") + end + dt.destroy_event("save_selection switch", "shortcut") +end + +for i = 1, buffer_count do local saved_selection - dt.register_event("shortcut",function() + dt.register_event("save_selection save " .. i, "shortcut", function() saved_selection = dt.gui.selection() - end,"save to buffer "..i) - dt.register_event("shortcut",function() + end, string.format(_("save to buffer %d"), i)) + dt.register_event("save_selection restore " .. i, "shortcut", function() dt.gui.selection(saved_selection) - end,"restore from buffer "..i) + end, string.format(_("restore from buffer %d"), i)) end local bounce_buffer = {} -dt.register_event("shortcut",function() +dt.register_event("save_selection switch", "shortcut", function() bounce_buffer = dt.gui.selection(bounce_buffer) -end,"switch selection with temporary buffer") +end, _("switch selection with temporary buffer")) + +script_data.destroy = destroy +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/official/selection_to_pdf.lua b/official/selection_to_pdf.lua index f6fbfe85..64b9c8be 100644 --- a/official/selection_to_pdf.lua +++ b/official/selection_to_pdf.lua @@ -35,22 +35,43 @@ Plugin allows you to choose how many thumbnails you need per row ]] local dt = require "darktable" local du = require "lib/dtutils" -require "official/yield" -du.check_min_api_version("2.0.0", "selection_to_pdf") +du.check_min_api_version("7.0.0", "selection_to_pdf") + +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +-- return data structure for script_manager + +local script_data = {} + +script_data.metadata = { + name = _("selection to PDF"), + purpose = _("generate a pdf file of selected images"), + author = "Jérémy Rosen & Pascal Obry", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/official/selection_to_pdf" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them dt.preferences.register ("selection_to_pdf","Open with","string", - "a pdf viewer", - "Can be an absolute pathname or the tool may be in the PATH", + _("a pdf viewer"), + _("can be an absolute pathname or the tool may be in the PATH"), "xdg-open") local title_widget = dt.new_widget("entry") { - placeholder="Title" + placeholder = _("title") } local no_of_thumbs_widget = dt.new_widget("slider") { - label = "Thumbs per Line", + label = _("thumbs per line"), soft_min = 1, -- The soft minimum value for the slider, the slider can't go beyond this point soft_max = 10, -- The soft maximum value for the slider, the slider can't go beyond this point hard_min = 1, -- The hard minimum value for the slider, the user can't manually enter a value beyond this point @@ -58,10 +79,10 @@ local no_of_thumbs_widget = dt.new_widget("slider") value = 4 -- The current value of the slider } local widget = dt.new_widget("box") { - orientation=horizontal, - dt.new_widget("label"){label = "Title:"}, + orientation = horizontal, + dt.new_widget("label"){label = _("title:")}, title_widget, - dt.new_widget("label"){label = "Thumbnails per row:"}, + dt.new_widget("label"){label = _("thumbnails per row:")}, no_of_thumbs_widget } @@ -102,7 +123,13 @@ local function thumbnail(latexfile,i,image,file) my_write(latexfile,"\\end{minipage}\\quad\n") end -dt.register_storage("export_pdf","Export thumbnails to pdf", +local function destroy() + dt.print_log("destroying storage") + dt.destroy_storage("export_pdf") + dt.print_log("done destroying") +end + +dt.register_storage("export_pdf", _("export thumbnails to pdf"), nil, function(storage,image_table) local my_title = title_widget.text @@ -149,7 +176,7 @@ dt.register_storage("export_pdf","Export thumbnails to pdf", local command = "pdflatex -halt-on-error -output-directory "..dir.." "..locfile local result = dt.control.execute(command) if result ~= 0 then - dt.print("Problem running pdflatex") -- this one is probably usefull to the user + dt.print(_("problem running pdflatex")) -- this one is probably usefull to the user error("Problem running "..command) end @@ -159,7 +186,7 @@ dt.register_storage("export_pdf","Export thumbnails to pdf", command = command.." "..pdffile local result = dt.control.execute(command) if result ~= 0 then - dt.print("Problem running pdf viewer") -- this one is probably usefull to the user + dt.print(_("problem running pdf viewer")) -- this one is probably usefull to the user error("Problem running "..command) end @@ -169,5 +196,8 @@ dt.register_storage("export_pdf","Export thumbnails to pdf", end end,nil,nil,widget) +script_data.destroy = destroy + +return script_data -- -- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua diff --git a/official/yield.lua b/official/yield.lua deleted file mode 100644 index 3e5cb9b9..00000000 --- a/official/yield.lua +++ /dev/null @@ -1,42 +0,0 @@ ---[[ - This file is part of darktable, - Copyright 2016 by Tobias Jakobs. - - This program 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. - - This program 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 this program. If not, see . -]] ---[[ -darktable yield compatibility script - -USAGE -* require this script from your main Lua file in the first line - -]] -local dt = require "darktable" -local yield_orig = coroutine.yield - -if (dt.configuration.api_version_major < 4) then - dt.control = {} - dt.control.execute = function(command) - yield_orig("RUN_COMMAND", command) - end - dt.control.read = function(command) - yield_orig("FILE_READABLE", command) - end - dt.control.sleep = function(command) - yield_orig("WAIT_MS", command) - end -end - --- vim: shiftwidth=2 expandtab tabstop=2 cindent syntax=lua --- kate: hl Lua; diff --git a/tools/executable_manager.lua b/tools/executable_manager.lua index 03e35f66..4d03be28 100644 --- a/tools/executable_manager.lua +++ b/tools/executable_manager.lua @@ -31,23 +31,42 @@ local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" +local dtsys = require "lib/dtutils.system" -du.check_min_api_version("5.0.0", "executable_manager") +du.check_min_api_version("7.0.0", "executable_manager") -local PS = dt.configuration.running_os == "windows" and "\\" or "/" +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end -local gettext = dt.gettext +-- return data structure for script_manager -gettext.bindtextdomain("executable_manager",dt.configuration.config_dir.."/lua/locale/") +local script_data = {} + +script_data.metadata = { + name = _("executable manager"), + purpose = _("manage the list of external executables used by the lua scripts"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/executable_manager" +} + +script_data.destroy = nil -- function to destory the script +script_data.destroy_method = nil -- set to hide for libs since we can't destroy them commpletely yet +script_data.restart = nil -- how to restart the (lib) script after it's been hidden - i.e. make it visible again +script_data.show = nil -- only required for libs since the destroy_method only hides them + +local PS = dt.configuration.running_os == "windows" and "\\" or "/" + +local exec_man = {} -- our own namespace +exec_man.module_installed = false +exec_man.event_registered = false -- - - - - - - - - - - - - - - - - - - - - - - - - - - - -- F U N C T I O N S -- - - - - - - - - - - - - - - - - - - - - - - - - - - - -local function _(msg) - return gettext.dgettext("executable_manager", msg) -end - local function grep(file, pattern) local result = {} @@ -86,12 +105,45 @@ local function update_combobox_choices(combobox, choice_table, selected) combobox.value = selected end +local function install_module() + local panel = "DT_UI_CONTAINER_PANEL_LEFT_BOTTOM" + local panel_pos = 600 + if dt.configuration.running_os == "windows" then + panel = "DT_UI_CONTAINER_PANEL_LEFT_CENTER" + panel_pos = 100 + end + if not exec_man.module_installed then + dt.register_lib( + "executable_manager", -- Module name + _("executables"), -- Visible name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {panel, panel_pos}}, -- containers + dt.new_widget("box") -- widget + { + orientation = "vertical", + exec_man.selector, + exec_man.stack, + }, + nil,-- view_enter + nil -- view_leave + ) + exec_man.module_installed = true + end +end + +local function destroy() + dt.gui.libs["executable_manager"].visible = false +end + +local function restart() + dt.gui.libs["executable_manager"].visible = true +end + -- - - - - - - - - - - - - - - - - - - - - - - - - - - - -- M A I N P R O G R A M -- - - - - - - - - - - - - - - - - - - - - - - - - - - - -local exec_man = {} -- our own namespace - local DARKTABLERC = dt.configuration.config_dir .. PS .. "darktablerc" @@ -102,7 +154,7 @@ local matches = grep(DARKTABLERC, "executable_paths") -- check if we have something to manage and exit if not if #matches == 0 then - dt.print(_("No executable paths found, exiting...")) + dt.print(_("no executable paths found, exiting...")) return end @@ -117,15 +169,23 @@ for _,pref in ipairs(matches) do end local executable_path_widgets = {} +local executable_path_values = {} +local placeholder_text = dt.configuration.running_os == windows and _("select an executable") or _("search path for executable") for i,exec in ipairs(exec_table) do + executable_path_values[exec] = dt.new_widget("entry"){ + text = df.get_executable_path_preference(exec), + placeholder = placeholder_text, + editable = false + } executable_path_widgets[exec] = dt.new_widget("file_chooser_button"){ - title = _("select ") .. exec .. _(" executable"), + title = _(string.format("select %s executable", exec)), value = df.get_executable_path_preference(exec), is_directory = false, changed_callback = function(self) if df.check_if_bin_exists(self.value) then df.set_executable_path_preference(exec, self.value) + executable_path_values[exec].text = df.get_executable_path_preference(exec) end end } @@ -139,7 +199,7 @@ exec_man.stack = dt.new_widget("stack"){} -- create a combobox to for indexing into the stack of widgets exec_man.selector = dt.new_widget("combobox"){ - label = "executable", + label = _("executable"), tooltip = _("select executable to modify"), value = 1, "placeholder", changed_callback = function(self) @@ -155,13 +215,18 @@ exec_man.selector = dt.new_widget("combobox"){ for i,exec in ipairs(exec_table) do exec_man.stack[i] = dt.new_widget("box"){ + dt.new_widget("section_label"){label = _("current")}, + executable_path_values[exec], + dt.new_widget("section_label"){label = _("select")}, executable_path_widgets[exec], + dt.new_widget("section_label"){label = _("reset")}, dt.new_widget("button"){ - label = "clear", - tooltip = _("Clear path for ") .. exec, + label = _("clear"), + tooltip = string.format(_("clear path for %s"), exec), clicked_callback = function() df.set_executable_path_preference(exec, "") executable_path_widgets[exec].value = "" + executable_path_values[exec].text = "" end } @@ -174,19 +239,25 @@ update_combobox_choices(exec_man.selector, exec_table, 1) -- register the lib -dt.register_lib( - "executable_manager", -- Module name - "executable manager", -- Visible name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_BOTTOM", 100}}, -- containers - dt.new_widget("box") -- widget - { - orientation = "vertical", - exec_man.selector, - exec_man.stack, - }, - nil,-- view_enter - nil -- view_leave -) +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not exec_man.event_registered then + dt.register_event( + "executable_manager", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + exec_man.event_registered = true + end +end + +script_data.destroy = destroy +script_data.restart = restart +script_data.destroy_method = "hide" +script_data.show = restart +return script_data diff --git a/tools/gen_i18n_mo.lua b/tools/gen_i18n_mo.lua deleted file mode 100644 index d032484b..00000000 --- a/tools/gen_i18n_mo.lua +++ /dev/null @@ -1,99 +0,0 @@ ---[[ - gen_18n_mo.lua - generate .mo files from .po files and put them in the correct place - - Copyright (C) 2016,2018 Bill Ferguson - - This program 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. - - This program 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 this program. If not, see . -]] ---[[ - gen_i18n_mo - generate translation files from the source and place them in the appropriate locale directory - - gen_i18n_mo finds all the .po files scattered throughout the script tree, compiles them into - .mo files and places them in the correct locale directory for use by the gettext tools. - -]] - -local dt = require "darktable" -local du = require "lib/dtutils" -local df = require "lib/dtutils.file" -local log = require "lib/dtutils.log" -local dtsys = require "lib/dtutils.system" - -du.check_min_api_version("5.0.0", "gen_I18n_mo") - --- figure out the path separator - -local PS = dt.configuration.running_os == "windows" and "\\" or "/" - -local LUA_DIR = dt.configuration.config_dir .. PS .. "lua" .. PS -local LOCALE_DIR = dt.configuration.config_dir .. PS .. "lua" .. PS .. "locale" .. PS - --- check if we have msgfmt - -local msgfmt_executable = df.check_if_bin_exists("msgfmt") - -if msgfmt_executable then - - -- find the .po files - - local find_cmd = "find -L " .. LUA_DIR .. " -name \\*.po -print" - if dt.configuration.running_os == "windows" then - find_cmd = "dir /b/s " .. LUA_DIR .. "\\*.po" - end - - local output = io.popen(find_cmd) - - -- for each .po file.... - - for line in output:lines() do - local fname = df.get_filename(line) - - -- get the language used... this depends on the file being named using - -- the convention /..../lang/LC_MESSAGES/file.po where lang is de_DE, fr_FR, etc. - - local path_parts = du.split(line, PS) - local lang = path_parts[#path_parts - 2] - - -- ensure there is a destination directory for them - - local mkdir_cmd = "mkdir -p " - if dt.configuration.running_os == "windows" then - mkdir_cmd = "mkdir " - end - - if not df.check_if_file_exists(LOCALE_DIR .. lang .. PS .. "LC_MESSAGES") then - log.msg(log.info, "Creating locale", lang) - os.execute(mkdir_cmd .. LOCALE_DIR .. lang .. PS .. "LC_MESSAGES") - end - - -- generate the mo file - - fname = string.gsub(fname, ".po$", ".mo") - log.msg(log.info, "Compiling translation to", fname) - local result = os.execute(msgfmt_executable .. " -o " .. LOCALE_DIR .. lang .. PS .. "LC_MESSAGES" .. PS .. fname .. " " .. line) - end -else - log.msg(log.screen, "ERROR: msgfmt executable not found. Please install or specifiy location in preferences.") -end -dt.preferences.register("executable_paths", "msgfmt", -- name - "file", -- type - 'gen_i18n_mo: msgfmt location', -- label - 'Install location of msgfmt. Requires restart to take effect.', -- tooltip - "msgfmt", -- default - dt.new_widget("file_chooser_button"){ - title = "Select msgfmt[.exe] file", - value = "", - is_directory = false, - } -) diff --git a/tools/get_lib_manpages.lua b/tools/get_lib_manpages.lua index 9ea2f699..0e641104 100644 --- a/tools/get_lib_manpages.lua +++ b/tools/get_lib_manpages.lua @@ -7,11 +7,22 @@ local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" +local dtsys = require "lib/dtutils.system" local log = require "lib/dtutils.log" local libname = nil du.check_min_api_version("3.0.0", "get_lib_manpages") +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +local function destroy() + -- nothing to destroy +end + local keys = {"Name", "Synopsis", "Usage", "Description", "Return_Value", "Limitations", "Example", "See_Also", "Reference", "License", "Copyright"} @@ -74,3 +85,15 @@ for line in output:lines() do libname = nil end +local script_data = {} + +script_data.metadata = { + name = _("get library man pages"), + purpose = _("output the internal library documentation as man pages"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/get_lib_manpages" +} + +script_data.destroy = destroy + +return script_data diff --git a/tools/get_libdoc.lua b/tools/get_libdoc.lua index ed0813ac..2c4458d0 100644 --- a/tools/get_libdoc.lua +++ b/tools/get_libdoc.lua @@ -6,9 +6,20 @@ local dt = require "darktable" local du = require "lib/dtutils" +local dtsys = require "lib/dtutils.system" du.check_min_api_version("3.0.0", "get_libdoc") +local gettext = dt.gettext.gettext + +local function _(msg) + return gettext(msg) +end + +local function destroy() + -- nothing to destroy +end + local keys = {"Name", "Synopsis", "Usage", "Description", "Return_Value", "Limitations", "Example", "See_Also", "Reference", "License", "Copyright"} @@ -48,3 +59,15 @@ for line in output:lines() do end end +local script_data = {} + +script_data.metadata = { + name = _("get library docs"), + purpose = _("retrieve and print the documentation to the console"), + author = "Bill Ferguson ", + help = "https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/tools/get_libdoc" +} + +script_data.destroy = destroy + +return script_data diff --git a/tools/script_manager.lua b/tools/script_manager.lua index e16b0cca..becb3d05 100644 --- a/tools/script_manager.lua +++ b/tools/script_manager.lua @@ -1,6 +1,6 @@ --[[ This file is part of darktable, - copyright (c) 2018 Bill Ferguson + copyright (c) 2018, 2020, 2023, 2024 Bill Ferguson darktable is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -18,54 +18,102 @@ --[[ script_manager.lua - a tool for managing the darktable lua scripts - script_manager is designed to run as a standalone script so that it - may be used as a drop in luarc file in the user's $HOME/.config/darktable - ($HOME/AppData/Local/darktable on windows) directory. It may also be - required from a luarc file. + script_manager is designed to be called from the users luarc file and used to + manage the lua scripts. - On startup script_manager checks to see if there is an existing scripts directory. - If there is an existing lua scripts directory then it is read to see what scripts are present. - Scripts are sorted by "category" based on what subdirectory they are found in, thus with a lua - scripts directory that matched the current repository the categories would be contrib, examples, - offical, and tools. Each script has an Enable/Disable button to enable or disable the script. + On startup script_manager scans the lua scripts directory to see what scripts are present. + Scripts are sorted by 'folder' based on what sub-directory they are in. With no + additional script repositories iinstalled, the folders are contrib, examples, official + and tools. When a folder is selected the buttons show the script name and whether the + script is started or stopped. The button is a toggle, so if the script is stopped click + the button to start it and vice versa. - A link is created to the user's Downloads directory on linux, unix and MacOS. Windows users must create the - link manually using mklink.exe. Additional "un-official" scripts may be downloaded - from other sources and placed in the users Downloads directory. These scripts all fall in a downloads category. - They also each have an Enable/Disable button. + Features + + * the number of script buttons shown can be changed to any number between 5 and 20. The + default is 10 buttons. This can be changed in the configuration action. + + * additional repositories of scripts may be installed using from the install/update action. + + * installed scripts can be updated from the install/update action. This includes extra + repositories that have been installed. + + * the scripts can be disabled if desired from the install/update action. This can only + be reversed manually. To enable the "Disable Scripts" button, check the checkbox to + endable it. This is to prevent accidentally disabling the scripts. Click the + "Disable Scripts" button and the luarc file is renamed to luarc.disable. If at + a later time you want to enable the scripts again, simply rename the luarc.disabled + file to luarc and the scripts will run. ]] + local dt = require "darktable" local du = require "lib/dtutils" local df = require "lib/dtutils.file" +local ds = require "lib/dtutils.string" local dtsys = require "lib/dtutils.system" +local log = require "lib/dtutils.log" +local debug = require "darktable.debug" -local gettext = dt.gettext - - --- Tell gettext where to find the .mo file translating messages for a particular domain -gettext.bindtextdomain("script_manager",dt.configuration.config_dir.."/lua/locale/") +local gettext = dt.gettext.gettext local function _(msgid) - return gettext.dgettext("script_manager", msgid) + return gettext(msgid) end -collectgarbage("stop") +-- api check + +-- du.check_min_api_version("9.3.0", "script_manager") -- - - - - - - - - - - - - - - - - - - - - - - - -- C O N S T A N T S -- - - - - - - - - - - - - - - - - - - - - - - - + +-- script_manager required API version +local SM_API_VER_REQD = "9.3.0" + -- path separator -local PS = dt.configuration.running_os == "windows" and "\\" or "/" +local PS = dt.configuration.running_os == "windows" and "\\" or "/" -- command separator -local CS = dt.configuration.running_os == "windows" and "&" or ";" +local CS = dt.configuration.running_os == "windows" and "&" or ";" + +local MODULE = "script_manager" + +local MIN_BUTTONS_PER_PAGE = 5 +local MAX_BUTTONS_PER_PAGE = 20 +local DEFAULT_BUTTONS_PER_PAGE = 10 + +local DEFAULT_LOG_LEVEL = log.warn + +local LUA_DIR = dt.configuration.config_dir .. PS .. "lua" +local LUA_SCRIPT_REPO = "https://github.com/darktable-org/lua-scripts.git" + +local LUA_API_VER = "API-" .. dt.configuration.api_version_string -local LUA_DIR = dt.configuration.config_dir .. PS .. "lua" -local LUA_SCRIPT_REPO = "https://github.com/darktable-org/lua-scripts.git" +-- local POWER_ICON = dt.configuration.config_dir .. "/lua/data/data/icons/power.png" +local POWER_ICON = dt.configuration.config_dir .. "/lua/data/icons/path20.png" +local BLANK_ICON = dt.configuration.config_dir .. "/lua/data/icons/blank20.png" -dt.print_log("LUA_DIR is " .. LUA_DIR) +-- - - - - - - - - - - - - - - - - - - - - - - - +-- P R E F E R E N C E S +-- - - - - - - - - - - - - - - - - - - - - - - - + +dt.preferences.register(MODULE, "check_update", "bool", + _("check for updated scripts on start up"), + _("automatically update scripts to correct version"), + true) + +local check_for_updates = dt.preferences.read(MODULE, "check_update", "bool") + +-- - - - - - - - - - - - - - - - - - - - - - - - +-- L O G L E V E L +-- - - - - - - - - - - - - - - - - - - - - - - - + +local old_log_level = log.log_level() + +log.log_level(DEFAULT_LOG_LEVEL) -- - - - - - - - - - - - - - - - - - - - - - - - -- N A M E S P A C E @@ -74,102 +122,532 @@ dt.print_log("LUA_DIR is " .. LUA_DIR) local script_manager = {} local sm = script_manager +sm.executables = {} +sm.executables.git = df.check_if_bin_exists("git") + +sm.module_installed = false +sm.event_registered = false + +-- set up tables to contain all the widgets and choices + +sm.widgets = {} +sm.folders = {} +sm.translated_folders = {} + +-- set log level for functions + +sm.log_level = DEFAULT_LOG_LEVEL + +--[[ + + sm.scripts is a table of tables for containing the scripts + It is organized as into folder (folder) subtables containing + each script definition, which is a table + + sm.scripts- + | + - folder------------| + | - script + - folder----| | + - script| + | - script + - script| + + and a script table looks like + + name the name of the script file without the lua extension + path folder (folder), path separator, path, name without the lua extension + doc the header comments from the script to be used as a tooltip + script_name the folder, path separator, and name without the lua extension + running true if running, false if not, hidden if running but the + lib/storage/action for the script is hidden + has_lib true if it creates a module + lib_name name of the created lib + has_storage true if it creates a storage (exporter) + storage_name name of the exporter (in the exporter storage menu) + has_action true if it creates an action + action_name name on the button + has_select true if it creates a select + select_name name on the button + has_event true if it creates an event handler + event_type type of event, shortcut, post-xxx, pre-xxx + callback name of the callback routine + initialized all of the above data has been retreived and set. If the + script is unloaded and reloaded we don't have to reparse the file + +]] + +sm.scripts = {} +sm.start_queue = {} +sm.page_status = {} +sm.page_status.num_buttons = DEFAULT_BUTTONS_PER_PAGE +sm.page_status.buttons_created = 0 +sm.page_status.current_page = 0 +sm.page_status.folder = "" + +-- installed script repositories +sm.installed_repositories = { + {name = "lua-scripts", directory = LUA_DIR}, +} + + +-- don't let it run until everything is in place +sm.run = false + -- - - - - - - - - - - - - - - - - - - - - - - - -- F U N C T I O N S -- - - - - - - - - - - - - - - - - - - - - - - - -local function prequire(script) - dt.print_log("Loading " .. script) - local status, lib = pcall(require, script) - if status then - dt.print_log("Loaded " .. script) +------------------- +-- helper functions +------------------- + +local function set_log_level(level) + local old_log_level = log.log_level() + log.log_level(level) + return old_log_level +end + +local function restore_log_level(level) + log.log_level(level) +end + +local function pref_read(name, pref_type) + local old_log_level = set_log_level(sm.log_level) + + log.msg(log.debug, "name is " .. name .. " and type is " .. pref_type) + + local val = dt.preferences.read(MODULE, name, pref_type) + + log.msg(log.debug, "read value " .. tostring(val)) + + restore_log_level(old_log_level) + return val +end + +local function pref_write(name, pref_type, value) + local old_log_level = set_log_level(sm.log_level) + + log.msg(log.debug, "writing value " .. tostring(value) .. " for name " .. name) + + dt.preferences.write(MODULE, name, pref_type, value) + + restore_log_level(old_log_level) +end + +---------------- +-- git interface +---------------- + +local function get_repo_status(repo) + local old_log_level = set_log_level(sm.log_level) + + local p = io.popen("cd " .. repo .. CS .. "git status") + + if p then + local data = p:read("*a") + p:close() + return data + end + + log.msg(log.error, "unable to get status of " .. repo) + restore_log_level(old_log_level) + return nil +end + +local function get_current_repo_branch(repo) + local old_log_level = set_log_level(sm.log_level) + + local branch = nil + + local p = io.popen("cd " .. repo .. CS .. "git branch --all") + + if p then + local data = p:read("*a") + p:close() + local branches = du.split(data, "\n") + for _, b in ipairs(branches) do + log.msg(log.debug, "branch for testing is " .. b) + branch = string.match(b, "^%* (.-)$") + + if branch then + log.msg(log.info, "current repo branch is " .. branch) + return branch + end + + end + end + + if not branch then + log.msg(log.error, "no current branch detected in repo_data") + end + + restore_log_level(old_log_level) + return nil +end + +local function get_repo_branches(repo) + local old_log_level = set_log_level(sm.log_level) + + local branches = {} + local p = io.popen("cd " .. repo .. CS .. "git pull --all" .. CS .. "git branch --all") + + if p then + local data = p:read("*a") + p:close() + log.msg(log.debug, "data is \n" .. data) + local branch_data = du.split(data, "\n") + for _, line in ipairs(branch_data) do + log.msg(log.debug, "line is " .. line) + local branch = string.gsub(line, "%s+remotes/%a+/", "") + if string.match(branch, "API") then + log.msg(log.info, "found branch - " .. branch) + table.insert(branches, branch) + end + end + end + + restore_log_level(old_log_level) + return branches +end + +local function is_repo_clean(repo_data) + local old_log_level = set_log_level(sm.log_level) + + if string.match(repo_data, "\n%s-%a.-%a:%s-%a%g-\n") then + log.msg(log.info, "repo is dirty") + return false else - dt.print_error("Error loading " .. script) - dt.print_error(lib) + log.msg(log.info, "repo is clean") + return true end - return status, lib + + restore_log_level(old_log_level) +end + +local function checkout_repo_branch(repo, branch) + local old_log_level = set_log_level(sm.log_level) + + log.msg(log.info, "checkout out branch " .. branch .. " from repository " .. repo) + + os.execute("cd " .. repo .. CS .. "git checkout " .. branch) + + restore_log_level(old_log_level) end +-------------------- +-- utility functions +-------------------- + local function update_combobox_choices(combobox, choice_table, selected) + local old_log_level = set_log_level(sm.log_level) + local items = #combobox local choices = #choice_table + for i, name in ipairs(choice_table) do combobox[i] = name end + if choices < items then for j = items, choices + 1, -1 do combobox[j] = nil end end + + if not selected then + selected = 1 + end + combobox.value = selected + restore_log_level(old_log_level) end -local function install_scripts() - local result = false +local function string_trim(str) + local old_log_level = set_log_level(sm.log_level) + + local result = string.gsub(str, "^%s+", "") -- trim leading spaces + result = string.gsub(result, "%s+$", "") -- trim trailing spaces + result = string.gsub(result, ",?%s+%-%-.+$", "") -- trim trailing comma and comments + + restore_log_level(old_log_level) + return result +end + +local function string_dequote(str) + return string.gsub(str, "['\"]", "") +end + +local function string_dei18n(str) + return string.match(str, "%_%((.+)%)") +end + +local function string_chop(str) + return str:sub(1, -2) +end + +------------------ +-- script handling +------------------ + +local function is_folder_known(folder_table, name) + local match = false + + for _, folder_name in ipairs(folder_table) do + if name == folder_name then + match = true + end + end + + return match +end + +local function find_translated_name(folder) + local translated_name = nil + + if folder == "contrib" then + translated_name = _("contributed") + elseif folder == "examples" then + translated_name = _("examples") + elseif folder == "official" then + translated_name = _("official") + elseif folder == "tools" then + translated_name = _("tools") + else + translated_name = _(folder) -- in case we get lucky and the string got translated elsewhere + end + + return translated_name +end + +local function add_script_folder(folder) + local old_log_level = set_log_level(sm.log_level) + + if #sm.folders == 0 or not is_folder_known(sm.folders, folder) then + table.insert(sm.folders, folder) + table.insert(sm.translated_folders, find_translated_name(folder)) + sm.scripts[folder] = {} + log.msg(log.debug, "created folder " .. folder) + end + + restore_log_level(old_log_level) +end + +local function get_script_metadata(script) + local old_log_level = set_log_level(sm.log_level) + -- set_log_level(log.debug) - if df.check_if_file_exists(LUA_DIR) then - if df.check_if_file_exists(LUA_DIR .. ".orig") then - if dt.configuration.running_os == "windows" then - os.execute("rmdir /s " .. LUA_DIR .. ".orig") + log.msg(log.debug, "processing metatdata for " .. script) + + local metadata_block = nil + local metadata = {} + + f = io.open(LUA_DIR .. PS .. script .. ".lua") + if f then + -- slurp the file + local content = f:read("*all") + f:close() + -- grab the script_data.metadata table + metadata_block = string.match(content, "script_data%.metadata = %{\r?\n(.-)\r?\n%}") + else + log.msg(log.error, "cant read from " .. script) + end + + if metadata_block then + -- break up the lines into key value pairs + local lines = du.split(metadata_block, "\n") + log.msg(log.debug, "got " .. #lines .. " lines") + for i = 1, #lines do + log.msg(log.debug, "splitting line " .. lines[i]) + local parts = du.split(lines[i], " = ") + parts[1] = string_trim(parts[1]) + parts[2] = string_trim(parts[2]) + log.msg(log.debug, "got value " .. parts[1] .. " and data " .. parts[2]) + if string.match(parts[2], "%_%(") then + parts[2] = _(string_dequote(string_dei18n(parts[2]))) else - os.execute("rm -rf " .. LUA_DIR .. ".orig") + parts[2] = string_dequote(parts[2]) end + if string.match(parts[2], ",$") then + parts[2] = string_chop(parts[2]) + end + log.msg(log.debug, "parts 1 is " .. parts[1] .. " and parts 2 is " .. parts[2]) + metadata[parts[1]] = parts[2] + log.msg(log.debug, "metadata " .. parts[1] .. " is " .. metadata[parts[1]]) end - os.rename(LUA_DIR, LUA_DIR .. ".orig") + log.msg(log.debug, "script data found for " .. metadata["name"]) end - local git = df.check_if_bin_exists("git") + restore_log_level(old_log_level) + return metadata_block and metadata or nil +end - if not git then - dt.print("ERROR: git not found. Install or specify the location of the git executable.") - return +local function get_script_doc(script) + local old_log_level = set_log_level(sm.log_level) + local description = nil + f = io.open(LUA_DIR .. PS .. script .. ".lua") + if f then + -- slurp the file + local content = f:read("*all") + f:close() + -- assume that the second block comment is the documentation + description = string.match(content, "%-%-%[%[.-%]%].-%-%-%[%[(.-)%]%]") + else + log.msg(log.error, "can't read from " .. script) end + if description then + restore_log_level(old_log_level) + return description + else + restore_log_level(old_log_level) + return _("no documentation available") + end +end + +local function activate(script) + local old_log_level = set_log_level(sm.log_level) + + local status = nil -- status of start function + local err = nil -- error message returned if module doesn't start + + log.msg(log.info, "activating " .. script.name) - local git_command = git .. " clone " .. sm.lua_repository .. " " .. LUA_DIR - dt.print_log("install git command is " .. git_command) + if script.running == false then - result = os.execute(git_command) + script_manager_running_script = script.name - if not df.check_if_file_exists(LUA_DIR .. PS .. "downloads") then - os.execute("mkdir " .. LUA_DIR .. PS .. "downloads") + status, err = du.prequire(script.path) + log.msg(log.debug, "prequire returned " .. tostring(status) .. " and for err " .. tostring(err)) + + script_manager_running_script = nil + + if status then + pref_write(script.script_name, "bool", true) + log.msg(log.screen, _(string.format("loaded %s", script.script_name))) + script.running = true + + if err ~= true then + log.msg(log.debug, "got lib data") + script.data = err + if script.data.destroy_method and script.data.destroy_method == "hide" and script.data.show and dt.gui.current_view().id == "lighttable" then + script.data.show() + end + else + script.data = nil + end + + else + log.msg(log.screen, _(string.format("%s failed to load", script.script_name))) + log.msg(log.error, "error loading " .. script.script_name) + log.msg(log.error, "error message: " .. err) + end + + else -- script is a lib and loaded but hidden and the user wants to reload + script.data.restart() + script.running = true + status = true + pref_write(script.script_name, "bool", true) end + script_manager_running_script = "script_manager" - return result + restore_log_level(old_log_level) + return status end -local function update_scripts() - local result = false +local function deactivate(script) + -- presently the lua api doesn't support unloading lib elements however, we + -- can hide libs, so we just mark those as hidden and hide the gui + -- can delete storages + -- can delete actions + -- can delete selects + -- and mark them inactive for the next time darktable starts - local git = df.check_if_bin_exists("git") + -- deactivate it.... + local old_log_level = set_log_level(sm.log_level) - if not git then - dt.print("ERROR: git not found. Install or specify the location of the git executable.") - return - end + pref_write(script.script_name, "bool", false) - local git_command = "cd " .. LUA_DIR .. " " .. CS .. " " .. git .. " pull" - dt.print_log("update git command is " .. git_command) + if script.data then + + script.data.destroy() + + if script.data.destroy_method then + if string.match(script.data.destroy_method, "hide") then + script.running = "hidden" + else + package.loaded[script.script_name] = nil + script.running = false + end + else + package.loaded[script.script_name] = nil + script.running = false + end + + log.msg(log.info, "turned off " .. script.script_name) + log.msg(log.screen, _(string.format("%s stopped", script.name))) - if dt.configuration.running_os == "windows" then - result = dtsys.windows_command(git_command) else - result = os.execute(git_command) + script.running = false + + log.msg(log.info, "setting " .. script.script_name .. " to not start") + log.msg(log.screen, _(string.format("%s will not start when darktable is restarted", script.name))) + end + + restore_log_level(old_log_level) +end + +local function start_scripts() + for _, script in ipairs(sm.start_queue) do + activate(script) + for i = 1, sm.page_status.num_buttons do + local name = script.metadata and script.metadata.name or script.name + if sm.widgets.labels[i].label == name then + sm.widgets.buttons[i].name = "pb_on" + break + end + end end + sm.start_queue = {} +end + +local function queue_script_to_start(script) + table.insert(sm.start_queue, script) +end + +local function add_script_name(name, path, folder) + local old_log_level = set_log_level(sm.log_level) - if dt.preferences.read("script_manager", "use_lua_scripts_version", "bool") and - dt.configuration.running_os == "windows" then - use_lua_scripts_version() + log.msg(log.debug, "folder is " .. folder) + log.msg(log.debug, "name is " .. name) + + local script = { + name = name, + path = folder .. "/" .. path .. name, + running = false, + doc = get_script_doc(folder .. "/" .. path .. name), + metadata = get_script_metadata(folder .. "/" .. path .. name), + script_name = folder .. "/" .. name, + data = nil + } + + table.insert(sm.scripts[folder], script) + + if pref_read(script.script_name, "bool") then + queue_script_to_start(script) + else + pref_write(script.script_name, "bool", false) end - return result + restore_log_level(old_log_level) end -local function add_script_data(script_file) +local function process_script_data(script_file) + local old_log_level = set_log_level(sm.log_level) - -- the script file supplied is category/filename.filetype - -- the following pattern splits the string into category, path, name, fileename, and filetype + -- the script file supplied is folder/filename.filetype + -- the following pattern splits the string into folder, path, name, fileename, and filetype -- for example contrib/gimp.lua becomes - -- category - contrib + -- folder - contrib -- path - -- name - gimp.lua -- filename - gimp @@ -183,592 +661,922 @@ local function add_script_data(script_file) pattern = "(.-)\\(.-)(([^\\]-)%.?([^%.\\]*))$" end - dt.print_log("processing " .. script_file) + log.msg(log.info, "processing " .. script_file) -- add the script data - local category,path,name,filename,filetype = string.match(script_file, pattern) - dt.print_log("category is " .. category) - dt.print_log("name is " .. name) - - if #sm.script_categories == 0 or not string.match(du.join(sm.script_categories, " "), category) then - sm.script_categories[#sm.script_categories + 1] = category - sm.script_names[category] = {} - end - if name then - dt.print_log("category is " .. category) - dt.print_log("name is " .. name) - if not string.match(du.join(sm.script_names[category], " "), name) then - sm.script_names[category][#sm.script_names[category] + 1] = name - sm.script_paths[category .. "/" .. name] = category .. "/" .. path .. name - if category == "downloads" then - sm.have_downloads = true - end - end + local folder,path,name,filename,filetype = string.match(script_file, pattern) + + if folder and name and path then + log.msg(log.debug, "folder is " .. folder) + log.msg(log.debug, "name is " .. name) + + add_script_folder(folder) + add_script_name(name, path, folder) end + + restore_log_level(old_log_level) end -local function scan_scripts() - local find_cmd = "find -L " .. LUA_DIR .. " -name \\*.lua -print | sort" +local function ensure_lib_in_search_path(line) + local old_log_level = set_log_level(sm.log_level) + + log.msg(log.debug, "line is " .. line) + + if string.match(line, ds.sanitize_lua(dt.configuration.config_dir .. PS .. "lua/lib")) then + log.msg(log.debug, line .. " is already in search path, returning...") + return + end + + local pattern = dt.configuration.running_os == "windows" and "(.+)\\lib\\.+lua" or "(.+)/lib/.+lua" + local path = string.match(line, pattern) + + log.msg(log.debug, "extracted path is " .. path) + log.msg(log.debug, "package.path is " .. package.path) + + if not string.match(package.path, ds.sanitize_lua(path)) then + + log.msg(log.debug, "path isn't in package.path, adding...") + + package.path = package.path .. ";" .. path .. "/?.lua" + + log.msg(log.debug, "new package.path is " .. package.path) + end + + restore_log_level(old_log_level) +end + +local function scan_scripts(script_dir) + local old_log_level = set_log_level(sm.log_level) + + local script_count = 0 + local find_cmd = "find -L " .. script_dir .. " -name \\*.lua -print | sort" + if dt.configuration.running_os == "windows" then - find_cmd = "dir /b/s " .. LUA_DIR .. "\\*.lua | sort" + find_cmd = "dir /b/s \"" .. script_dir .. "\\*.lua\" | sort" end + + log.msg(log.debug, "find command is " .. find_cmd) + -- scan the scripts local output = io.popen(find_cmd) for line in output:lines() do - local l = string.gsub(line, LUA_DIR .. PS, "") -- strip the lua dir off - local script_file = l:sub(1,-5) - if not string.match(script_file, "script_manager") then -- let's not include ourself - if not string.match(script_file, "plugins") then -- skip plugins - if not string.match(script_file, "lib" .. PS) then -- let's not try and run libraries - if not string.match(script_file, "include_all") then -- skip include_all.lua - if not string.match(script_file, "yield") then -- special case, because everything needs this - add_script_data(script_file) - else - prequire(script_file) -- load yield.lua - end + log.msg(log.debug, "line is " .. line) + local l = string.gsub(line, ds.sanitize_lua(LUA_DIR) .. PS, "") -- strip the lua dir off + local script_file = l:sub(1,-5) -- strip off .lua\n + if not string.match(script_file, "script_manager") then -- let's not include ourself + if not string.match(script_file, "plugins") then -- skip plugins + if not string.match(script_file, "lib" .. PS) then -- let's not try and run libraries + if not string.match(script_file, "%.git") then -- don't match files in the .git directory + process_script_data(script_file) + script_count = script_count + 1 end + else + ensure_lib_in_search_path(line) -- but let's make sure libraries can be found end end end end - -- work around because we can't dynamically add a new stack child. We create an empty child that will be - -- populated with downloads as they occur. If there are already downloads then this is just ignored - add_script_data("downloads" .. PS) + restore_log_level(old_log_level) + return script_count end --- get the script documentation, with some assumptions -local function get_script_doc(script) - local description = nil - f = io.open(LUA_DIR .. PS .. script .. ".lua") - if f then - -- slurp the file - local content = f:read("*all") - f:close() - -- assume that the second block comment is the documentation - description = string.match(content, "%-%-%[%[.-%]%].-%-%-%[%[(.-)%]%]") - else - dt.print_error("Cant read from " .. script) +local function update_scripts() + local old_log_level = set_log_level(sm.log_level) + local result = false + + local git = sm.executables.git + + if not git then + log.msg(log.screen, _("ERROR: git not found. Install or specify the location of the git executable.")) + return end - if description then - return description + + local git_command = "cd " .. LUA_DIR .. " " .. CS .. " " .. git .. " pull" + log.msg(log.debug, "update git command is " .. git_command) + + if dt.configuration.running_os == "windows" then + result = dtsys.windows_command(git_command) else - return "No documentation available" + result = os.execute(git_command) end + + if result == 0 then + log.msg(log.screen, _("lua scripts successfully updated")) + end + + restore_log_level(old_log_level) + return result end -local function activate(script, scriptname) - dt.print_log("activating " .. scriptname) - local status, err = prequire(sm.script_paths[script]) - if status then - dt.preferences.write("script_manager", script, "bool", true) - dt.print("Loaded " .. scriptname) - else - dt.print(scriptname .. " failed to load") - dt.print_error("Error loading " .. scriptname) - dt.print_error("Error message: " .. err) +-------------- +-- UI handling +-------------- + +local function update_script_update_choices() + local old_log_level = set_log_level(sm.log_level) + + local installs = {} + local pref_string = "" + + for i, repo in ipairs(sm.installed_repositories) do + table.insert(installs, repo.name) + pref_string = pref_string .. i .. "," .. repo.name .. "," .. repo.directory .. "," end - return status + + update_combobox_choices(sm.widgets.update_script_choices, installs, 1) + + log.msg(log.debug, "repo pref string is " .. pref_string) + pref_write("installed_repos", "string", pref_string) + + restore_log_level(old_log_level) end -local function deactivate(script, scriptname) - -- presently the lua api doesn't support unloading gui elements therefore - -- we just mark then inactive for the next time darktable starts +local function scan_repositories() + local old_log_level = set_log_level(sm.log_level) - -- deactivate it.... + local script_count = 0 + local find_cmd = "find -L " .. LUA_DIR .. " -name \\*.git -print | sort" + + if dt.configuration.running_os == "windows" then + find_cmd = "dir /b/s /a:d " .. LUA_DIR .. PS .. "*.git | sort" + end + + log.msg(log.debug, "find command is " .. find_cmd) + + local output = io.popen(find_cmd) + + for line in output:lines() do + local l = string.gsub(line, ds.sanitize_lua(LUA_DIR) .. PS, "") -- strip the lua dir off + local folder = string.match(l, "(.-)" .. PS) -- get everything to the first / + + if folder then -- if we have a folder (.git doesn't) + + log.msg(log.debug, "found folder " .. folder) + + if not string.match(folder, "plugins") and not string.match(folder, "%.git") then -- skip plugins + + if #sm.installed_repositories == 1 then + log.msg(log.debug, "only 1 repo, adding " .. folder) + table.insert(sm.installed_repositories, {name = folder, directory = LUA_DIR .. PS .. folder}) + else + log.msg(log.debug, "more than 1 repo, we have to search the repos to make sure it's not there") + local found = nil + + for _, repo in ipairs(sm.installed_repositories) do + if string.match(repo.name, ds.sanitize_lua(folder)) then + log.msg(log.debug, "matched " .. repo.name) + found = true + break + end + end + + if not found then + table.insert(sm.installed_repositories, {name = folder, directory = LUA_DIR .. PS .. folder}) + end - dt.preferences.write("script_manager", script, "bool", false) - dt.print_log("setting " .. scriptname .. " to not start") - dt.print(scriptname .. " will not be active when darktable is restarted") -end - -local function create_enable_disable_button(btext, sname, req) - return dt.new_widget("button") - { - label = btext .. sname, - tooltip = get_script_doc(req), - clicked_callback = function (self) - -- split the label into action and target - local action, target = string.match(self.label, "(.+) (.+)") - -- load the script if it's not loaded - dt.print_log("Looking for target " .. target) - local scat = sm.category_selector.value - -- check, and fix, the filename for a - since it is a lua magic character in string match - dt.print_log("checking category " .. scat .. " for target " .. target) - local starget = du.join({scat, target}, "/") - dt.print_log("starget to activate is " .. starget) - dt.print_log("target to activate is " .. target) - if action == "Enable" then - local status = activate(starget, target) - if status then - self.label = "Disable " .. target end - else - deactivate(starget, target) - self.label = "Enable " .. target end end - } + end + + update_script_update_choices() + + restore_log_level(old_log_level) end -local function load_script_stack() - -- load the scripts - table.sort(sm.script_categories) - for _,cat in ipairs(sm.script_categories) do - local tmp = {} - table.sort(sm.script_names[cat]) - if not sm.script_widgets[cat] then - for _,sname in ipairs(sm.script_names[cat]) do - local req = du.join({cat, sname}, "/") - local btext = "Enable " - if dt.preferences.read("script_manager", req, "bool") then - local status, err = prequire(sm.script_paths[req]) - if status then - btext = "Disable " - else - dt.print_error("Error loading " .. sname) - dt.print_error("Error message: " .. err) - end - else - dt.preferences.write("script_manager", req, "bool", false) - end - tmp[#tmp + 1] = create_enable_disable_button(btext, sname, req) - end +local function install_scripts() + local old_log_level = set_log_level(sm.log_level) + + local url = sm.widgets.script_url.text + local folder = sm.widgets.new_folder.text + + if string.match(du.join(sm.folders, " "), ds.sanitize_lua(folder)) then + log.msg(log.screen, _(string.format("folder %s is already in use. Please specify a different folder name.", folder))) + log.msg(log.error, "folder " .. folder .. " already exists, returning...") + restore_log_level(old_log_level) + return + end + + local result = false + + local git = sm.executables.git - sm.script_widgets[cat] = dt.new_widget("box") - { - orientation = "vertical", - table.unpack(tmp), - } - elseif #sm.script_widgets[cat] ~= #sm.script_names[cat] then - for index,sname in ipairs(sm.script_names[cat]) do - local req = du.join({cat, sname}, "/") - dt.print_error("script is " .. sname .. " and index is " .. index) - if sm.script_widgets[cat][index] then - sm.script_widgets[cat][index] = nil + if not git then + log.msg(log.screen, _("ERROR: git not found. Install or specify the location of the git executable.")) + restore_log_level(old_log_level) + return + end + + local git_command = "cd " .. LUA_DIR .. " " .. CS .. " " .. git .. " clone " .. url .. " " .. folder + log.msg(log.debug, "update git command is " .. git_command) + + if dt.configuration.running_os == "windows" then + result = dtsys.windows_command(git_command) + else + result = dtsys.external_command(git_command) + end + + log.msg(log.info, "result from import is " .. result) + + if result == 0 then + local count = scan_scripts(LUA_DIR .. PS .. folder) + + if count > 0 then + update_combobox_choices(sm.widgets.folder_selector, sm.folders, sm.widgets.folder_selector.selected) + dt.print(_(string.format("scripts successfully installed into folder %s"), folder)) + table.insert(sm.installed_repositories, {name = folder, directory = LUA_DIR .. PS .. folder}) + update_script_update_choices() + + for i = 1, #sm.widgets.folder_selector do + if string.match(sm.widgets.folder_selector[i], ds.sanitize_lua(folder)) then + log.msg(log.debug, "setting folder selector to " .. i) + sm.widgets.folder_selector.selected = i + break end - sm.script_widgets[cat][index] = create_enable_disable_button("Enable ", sname, req) + i = i + 1 end + + log.msg(log.debug, "clearing text fields") + sm.widgets.script_url.text = "" + sm.widgets.new_folder.text = "" + sm.widgets.main_menu.selected = 3 + else + log.msg(log.screen, _("no scripts found to install")) + log.msg(log.error, "scan_scripts returned " .. count .. " scripts found. Not adding to folder_selector") end + + else + log.msg(log.screen, _("failed to download scripts")) end - if not sm.script_stack then - sm.script_stack = dt.new_widget("stack"){} - for i,cat in ipairs(sm.script_categories) do - sm.script_stack[i] = sm.script_widgets[cat] + + restore_log_level(old_log_level) + return result +end + +local function clear_button(number) + local old_log_level = set_log_level(sm.log_level) + + local button = sm.widgets.buttons[number] + local label = sm.widgets.labels[number] + + button.image = BLANK_ICON + button.tooltip = "" + button.sensitive = false + label.label = "" + button.name = "" + + restore_log_level(old_log_level) +end + +local function find_script(folder, name) + local old_log_level = set_log_level(sm.log_level) + + log.msg(log.debug, "looking for script " .. name .. " in folder " .. folder) + + for _, script in ipairs(sm.scripts[folder]) do + if string.match(script.name, "^" .. ds.sanitize_lua(name) .. "$") then + return script end - sm.script_stack.active = 1 end + + restore_log_level(old_log_level) + return nil end -local function update_stack_choices(combobox, choice_table) - sm.have_downloads = true - local items = #combobox - local choices = #choice_table - if #sm.script_widgets["downloads"] == 0 then - choices = choices - 1 - sm.have_downloads = false - end - cnt = 1 - for i, name in ipairs(choice_table) do - if (name == "downloads" and sm.have_downloads) or name ~= "downloads" then - combobox[cnt] = name - cnt = cnt + 1 +local function populate_buttons(folder, first, last) + local old_log_level = set_log_level(sm.log_level) + + log.msg(log.debug, "folder is " .. folder .. " and first is " .. first .. " and last is " .. last) + + local button_num = 1 + + for i = first, last do + local script = sm.scripts[folder][i] + local button = sm.widgets.buttons[button_num] + local label = sm.widgets.labels[button_num] + + if script.running == true then + button.name = "pb_on" + else + button.name = "pb_off" + end + + button.image = POWER_ICON + label.label = script.metadata and script.metadata.name or script.name + label.name = "pb_label" + button.ellipsize = "end" + button.sensitive = true + label.tooltip = script.metadata and script.metadata.purpose or script.doc + + button.clicked_callback = function (this) + local cb_script = script + local state = nil + if cb_script then + log.msg(log.debug, "found script " .. cb_script.name .. " with path " .. cb_script.path) + if cb_script.running == true then + log.msg(log.debug, "deactivating " .. cb_script.name .. " on " .. cb_script.path) + deactivate(cb_script) + this.name = "pb_off" + else + log.msg(log.debug, "activating " .. cb_script.name .. " on " .. script.path) + local result = activate(cb_script) + if result then + this.name = "pb_on" + end + end + end end + + button_num = button_num + 1 end - if choices < items then - for j = items, choices + 1, -1 do - combobox[j] = nil + + if button_num <= sm.page_status.num_buttons then + for i = button_num, sm.page_status.num_buttons do + clear_button(i) end end - combobox.value = 1 + + restore_log_level(old_log_level) end -local function build_scripts_block() - -- build the whole script block - scan_scripts() +local function paginate(direction) + local old_log_level = set_log_level(sm.log_level) - -- set up the stack for the choices - load_script_stack() + local folder = sm.page_status.folder + log.msg(log.debug, "folder is " .. folder) - if not sm.category_selector then - -- set up the combobox for the categories + local num_scripts = #sm.scripts[folder] + log.msg(log.debug, "num_scripts is " .. num_scripts) - sm.category_selector = dt.new_widget("combobox"){ - label = "Category", - tooltip = "Select the script category", - value = 1, "placeholder", - changed_callback = function(self) - local cnt = 1 - for i,cat in ipairs(sm.script_categories) do - if cat == self.value then - sm.script_stack.active = i - end - end - end - } + local max_pages = math.ceil(num_scripts / sm.page_status.num_buttons) + + local cur_page = sm.page_status.current_page + log.msg(log.debug, "max pages is " .. max_pages) + + local buttons_needed = nil + local first = nil + local last = nil + + if direction == 0 then + cur_page = cur_page - 1 + if cur_page < 1 then + cur_page = 1 + end + elseif direction == 1 then + cur_page = cur_page + 1 + if cur_page > max_pages then + cur_page = max_pages + end + else + log.msg(log.debug, "took path 2") + cur_page = 1 + end + + log.msg(log.debug, "cur_page is " .. cur_page .. " and max_pages is " .. max_pages) + + if cur_page == max_pages and cur_page == 1 then + sm.widgets.page_forward.sensitive = false + sm.widgets.page_back.sensitive = false + elseif cur_page == max_pages then + sm.widgets.page_forward.sensitive = false + sm.widgets.page_back.sensitive = true + elseif cur_page == 1 then + sm.widgets.page_forward.sensitive = true + sm.widgets.page_back.sensitive = false + else + sm.widgets.page_forward.sensitive = true + sm.widgets.page_back.sensitive = true end - update_stack_choices(sm.category_selector, sm.script_categories) + sm.page_status.current_page = cur_page - if not sm.scripts then - sm.scripts = dt.new_widget("box"){ - orientation = "vertical", - dt.new_widget("label"){ label = "Scripts" }, - sm.category_selector, - sm.script_stack, - } + first = (cur_page * sm.page_status.num_buttons) - (sm.page_status.num_buttons - 1) + + if first + sm.page_status.num_buttons > num_scripts then + last = num_scripts + else + last = first + sm.page_status.num_buttons - 1 end -end -local function insert_scripts_block() - table.insert(sm.main_menu_choices, "Enable/Disable Scripts") - update_combobox_choices(sm.main_menu, sm.main_menu_choices, 1) - sm.main_stack[#sm.main_stack + 1] = sm.scripts + sm.widgets.page_status.label = string.format(_("page %d of %d"), cur_page, max_pages) + + populate_buttons(folder, first, last) + + restore_log_level(old_log_level) end -local function use_lua_scripts_version() - if dt.configuration.running_os == "windows" then - -- copy tools\script_manger.lua to luarc - df.file_copy(LUA_DIR .. PS .. "tools\\script_manager.lua", dt.configuration.config_dir .. PS .. "luarc") +local function change_folder(folder) + local old_log_level = set_log_level(sm.log_level) + + if not folder then + log.msg(log.debug "setting folder to selector value " .. sm.widgets.folder_selector.value) + sm.page_status.folder = sm.widgets.folder_selector.value else - -- create a symbolic link from luarc to tools/script_manager.lua - if df.check_if_file_exists(dt.configuration.config_dir .. "/luarc") then - os.remove(dt.configuration.config_dir .. "/luarc") + log.msg(log.debug, "setting catgory to argument " .. folder) + sm.page_status.folder = folder + end + + paginate(2) + + restore_log_level(old_log_level) +end + +local function change_num_buttons() + local old_log_level = set_log_level(sm.log_level) + + cur_buttons = sm.page_status.num_buttons + new_buttons = sm.widgets.num_buttons.value + + pref_write("num_buttons", "integer", new_buttons) + + if new_buttons < cur_buttons then + log.msg(log.debug, "took new is less than current branch") + + for i = 1, cur_buttons - new_buttons do + table.remove(sm.widgets.scripts) end - os.execute("ln -s " .. LUA_DIR .. "/tools/script_manager.lua " .. dt.configuration.config_dir .. "/luarc") + + log.msg(log.debug, "finished removing widgets, now there are " .. #sm.widgets.buttons) + elseif new_buttons > cur_buttons then + log.msg(log.debug, "took new is greater than current branch") + log.msg(log.debug, "number of scripts is " .. #sm.widgets.scripts) + log.msg(log.debug, "number of buttons is " .. #sm.widgets.buttons) + log.msg(log.debug, "number of labels is " .. #sm.widgets.labels) + log.msg(log.debug, "number of boxes is " .. #sm.widgets.boxes) + + if new_buttons > sm.page_status.buttons_created then + + for i = sm.page_status.buttons_created + 1, new_buttons do + log.msg(log.debug, "i is " .. i) + table.insert(sm.widgets.buttons, dt.new_widget("button"){}) + log.msg(log.debug, "inserted new button") + log.msg(log.debug, "number of buttons is " .. #sm.widgets.buttons) + table.insert(sm.widgets.labels, dt.new_widget("label"){}) + log.msg(log.debug, "inserted new label") + log.msg(log.debug, "number of labels is " .. #sm.widgets.labels) + table.insert(sm.widgets.boxes, dt.new_widget("box"){ orientation = "horizontal", expand = false, fill = false, + sm.widgets.buttons[i], sm.widgets.labels[i]}) + log.msg(log.debug, "inserted new box") + sm.page_status.buttons_created = sm.page_status.buttons_created + 1 + end + + end + + log.msg(log.debug, "cur_buttons is " .. cur_buttons .. " and new_buttons is " .. new_buttons) + log.msg(log.debug, #sm.widgets.buttons .. " buttons are available") + + for i = cur_buttons + 1, new_buttons do + log.msg(log.debug, "inserting button " .. i .. " into scripts widget") + table.insert(sm.widgets.scripts, sm.widgets.boxes[i]) + end + + log.msg(log.debug, "finished adding widgets, now there are " .. #sm.widgets.buttons) + else -- no change + log.msg(log.debug, "no change, just returning") + return end + + sm.page_status.num_buttons = new_buttons + log.msg(log.debug, "num_buttons set to " .. sm.page_status.num_buttons) + paginate(2) -- force the buttons to repopulate + sm.widgets.main_menu.selected = 3 -- jump back to start/stop scripts + + restore_log_level(old_log_level) end -local function link_downloads_directory() - if not df.check_if_file_exists("$HOME/Downloads") then - os.execute("mkdir $HOME/Downloads") +local function load_preferences() + local old_log_level = set_log_level(sm.log_level) + + -- load the prefs and update settings + -- update_script_choices + + local pref_string = pref_read("installed_repos", "string") + local entries = du.split(pref_string, ",") + + while #entries > 2 do + local num = table.remove(entries, 1) + local name = table.remove(entries, 1) + local directory = table.remove(entries, 1) + + if not string.match(sm.installed_repositories[1].name, "^" .. ds.sanitize_lua(name) .. "$") then + table.insert(sm.installed_repositories, {name = name, directory = directory}) + end + end - if df.check_if_file_exists(LUA_DIR .. "/downloads") then - os.remove(LUA_DIR .. "/downloads") + + update_script_update_choices() + log.msg(log.debug, "updated installed scripts") + + -- folder selector + local val = pref_read("folder_selector", "integer") + + if val == 0 then + val = 1 + end + + sm.widgets.folder_selector.selected = val + sm.page_status.folder = sm.widgets.folder_selector.value + log.msg(log.debug, "updated folder selector and set it to " .. sm.widgets.folder_selector.value) + + -- num_buttons + local val = pref_read("num_buttons", "integer") + + if val == 0 then + val = DEFAULT_BUTTONS_PER_PAGE + end + + sm.widgets.num_buttons.value = val + log.msg(log.debug, "set page buttons to " .. val) + + change_num_buttons() + log.msg(log.debug, "paginated") + + -- main menu + local val = pref_read("main_menu_action", "integer") + log.msg(log.debug, "read " .. val .. " for main menu") + + if val == 0 then + val = 3 end - os.execute("ln -s " .. "$HOME/Downloads " .. LUA_DIR .. "/downloads") + + sm.widgets.main_menu.selected = val + log.msg(log.debug, "set main menu to val " .. val .. " which is " .. sm.widgets.main_menu.value) + + log.msg(log.debug, "set main menu to " .. sm.widgets.main_menu.value) + + restore_log_level(old_log_level) +end + +local function install_module() + local old_log_level = set_log_level(sm.log_level) + + if not sm.module_installed then + dt.register_lib( + "script_manager", -- Module name + _("scripts"), -- Visible name + true, -- expandable + false, -- resetable + {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_BOTTOM", 100}}, -- containers + sm.widgets.main_box, + nil,-- view_enter + nil -- view_leave + ) + sm.module_installed = true + end + + sm.run = true + sm.use_color = pref_read("use_color", "bool") + log.msg(log.debug, "set run to true, loading preferences") + load_preferences() + scan_repositories() + start_scripts() + + restore_log_level(old_log_level) end -- - - - - - - - - - - - - - - - - - - - - - - - -- M A I N P R O G R A M -- - - - - - - - - - - - - - - - - - - - - - - - --- api check +-- ensure shortcuts module knows widgets belong to script_manager -du.check_min_api_version("5.0.0") +script_manager_running_script = "script_manager" --- set up tables to contain all the widgets and choices +if check_for_updates or SM_API_VER_REQD > dt.configuration.api_version_string then + local repo_data = get_repo_status(LUA_DIR) + local current_branch = get_current_repo_branch(LUA_DIR) + local clean = is_repo_clean(repo_data) + local repo = LUA_DIR -sm.script_widgets = {} -sm.script_categories = {} -sm.script_names = {} -sm.script_paths = {} -sm.main_menu_choices = {} -sm.main_stack_items = {} + if current_branch then --- see if we've run this before + if sm.executables.git and clean and -sm.initialized = dt.preferences.read("script_manager", "initialized", "bool") + (current_branch == "master" or string.match(current_branch, "^API%-")) then -- only make changes to clean branches + local branches = get_repo_branches(LUA_DIR) -if not sm.initialized then - -- write out preferences - dt.preferences.write("script_manager", "lua_repository", "string", LUA_SCRIPT_REPO) - dt.preferences.write("script_manager", "use_distro_version", "bool", false) - dt.preferences.write("script_manager", "link_downloads_directory", "bool", false) - dt.preferences.write("script_manager", "initialized", "bool", true) -end + if current_branch ~= LUA_API_VER and current_branch ~= "master" then + -- probably upgraded from an earlier api version so get back to master + -- to use the latest version of script_manager to get the proper API + checkout_repo_branch(repo, "master") + log.msg(log.screen, _("lua API version reset, please restart darktable")) -sm.have_scripts = df.check_if_file_exists(LUA_DIR) + elseif LUA_API_VER == current_branch then + -- do nothing, we are fine + log.msg(log.debug, "took equal branch, doing nothing") -sm.git_managed = df.check_if_file_exists(LUA_DIR .. PS .. ".git") + elseif string.match(LUA_API_VER, "dev") then + -- we are on a dev API version, so checkout the dev + -- api version or checkout/stay on master + log.msg(log.debug, "took the dev branch") + local match = false -if sm.have_scripts then - dt.print_log("found lua scripts directory") -else - dt.print_log("lua scripts directory not found") -end + for _, branch in ipairs(branches) do + log.msg(log.debug, "checking branch " .. branch .. " against API " .. LUA_API_VER) + if LUA_API_VER == branch then + match = true + log.msg(log.info, "checking out repo development branch " .. branch) + checkout_repo_branch(repo, branch) + end + end -if sm.git_managed then - dt.print_log("scripts managed by git") -else - dt.print_log("scripts not managed") -end + if not match then + if current_branch == "master" then + log.msg(log.info, "staying on master, no dev branch yet") + else + log.msg(log.info, "no dev branch available, checking out master") + checkout_repo_branch(repo, "master") + end + end -local git = df.check_if_bin_exists("git") + elseif #branches > 0 and LUA_API_VER > branches[#branches] then + log.msg(log.info, "no newer branches, staying on master") + -- stay on master -if git then - dt.print_log("git found at " .. git) - sm.need_git = false -else - dt.print_log("git not found") - sm.need_git = true -end + else + -- checkout the appropriate branch for API version if it exists + log.msg(log.info, "checking out the appropriate API branch") -sm.repository = dt.new_widget("entry") -{ - text = dt.preferences.read("script_manager", "lua_repository", "string"), - editable = true, -} + local match = false -sm.need_install = false + for _x, branch in ipairs(branches) do + log.msg(log.debug, "checking branch " .. branch .. " against API " .. LUA_API_VER) + + if LUA_API_VER == branch then + match = true + log.msg(log.info, "checking out repo branch " .. branch) + checkout_repo_branch(repo, branch) + log.msg(log.screen, _("you must restart darktable to use the correct version of the lua scripts")) + return + end + + end + + if not match then + log.msg(log.warn, "no matching branch found for " .. LUA_API_VER) + end -local install_update_text = _("install") -if sm.have_scripts and sm.git_managed then - install_update_text = _("update") -else - sm.need_install = true -end - -sm.install_update_button = dt.new_widget("button"){ - label = install_update_text .. _(" scripts"), - clicked_callback = function(self) - sm.lua_repository = sm.repository.text - dt.preferences.write("script_manager", "lua_repository", "string", sm.repository.text) - if sm.need_install then - local result = install_scripts() - if result then - build_scripts_block() - insert_scripts_block() - sm.have_scripts = true - sm.git_managed = true - sm.need_install = false - self.label = _("update scripts") - dt.print(_("installed scripts from " .. sm.repository.text)) - else - dt.print(_("Error installing scripts from " .. sm.repository.text)) - end - else - local result = update_scripts() - if result then - --build_scripts_block() - dt.print(_("updated scripts from " .. sm.repository.text)) - else - dt.print(_("Error updating scripts from " .. sm.repository.text)) end end end -} +end -if not sm.need_install then - sm.reinstall_button = dt.new_widget("button"){ - label = "reinstall scripts", - clicked_callback = function(self) - sm.lua_repository = sm.repository.text - dt.preferences.write("script_manager", "lua_repository", "string", sm.repository.text) - local result = install_scripts() - if result then - build_scripts_block() - insert_scripts_block() - sm.have_scripts = true - sm.git_managed = true - sm.need_install = false - sm.install_update_button.label = "update scripts" - dt.print(_("reinstalled scripts from " .. sm.repository.text)) - dt.print_log(_("scripts reinstalled")) - else - dt.print(_("ERROR: script reinstallation failed")) - dt.print_error(_("script reinstall failed")) - end - end - } +scan_scripts(LUA_DIR) +log.msg(log.debug, "finished processing scripts") - sm.install_update_widgets = { - sm.install_update_button, - sm.reinstall_button, - } -else - sm.install_update_widgets = { - sm.install_update_button, - } -end -sm.install_update_box = dt.new_widget("box"){ - orientation = "vertical", - dt.new_widget("label"){ label = "Install/Update scripts" }, - table.unpack(sm.install_update_widgets), -} +-- - - - - - - - - - - - - - - - - - - - - - - - +-- U S E R I N T E R F A C E +-- - - - - - - - - - - - - - - - - - - - - - - - -table.insert(sm.main_menu_choices, "Install/Update Scripts") -table.insert(sm.main_stack_items, sm.install_update_box) +-- update the scripts --- configuration items +sm.widgets.update_script_choices = dt.new_widget("combobox"){ + label = _("scripts to update"), + tooltip = _("select the scripts installation to update"), + selected = 1, + changed_callback = function(this) + pref_write("update_script_choices", "integer", this.selected) + end, + "placeholder", +} -sm.repository_update = dt.new_widget("button"){ - label = "update", - clicked_callback = function() - dt.preferences.write("script_manager", "lua_repository", "string", sm.repository.text) - sm.install_update_button.label = "install" - sm.install_update_button.sensitive = true - sm.reinstall_button.sensitive = false - sm.need_install = true +sm.widgets.update = dt.new_widget("button"){ + label = _("update scripts"), + tooltip = _("update the lua scripts from the repository"), + clicked_callback = function(this) + update_scripts() end } -sm.repository_reset = dt.new_widget("button"){ - label = "reset", - clicked_callback = function() - sm.repository.text = LUA_SCRIPT_REPO - dt.preferences.write("script_manager", "lua_repository", "string", LUA_SCRIPT_REPO) - sm.install_update_button.label = "install" - sm.install_update_button.sensitive = true - sm.reinstall_button.sensitive = false - sm.need_install = true - end +-- add additional scripts + +sm.widgets.script_url = dt.new_widget("entry"){ + text = "", + placeholder = "https://", + tooltip = _("enter the URL of the git repository containing the scripts you wish to add") } -sm.update_reset = dt.new_widget("box"){ - orientation = "horizontal", - sm.repository_update, - sm.repository_reset, +sm.widgets.new_folder = dt.new_widget("entry"){ + text = "", + placeholder = _("name of new folder"), + tooltip = _("enter a folder name for the additional scripts") } --- replace standalone version of script_manager with distributed version, i.e. tools/script_manager.lua - -- link on linux/MacOS, copy on windows - -- this option won't be active until the repository version of this script is accepted - -sm.use_lua_scripts_version = dt.new_widget("check_button"){ - label = "Use lua scripts distributed version", - tooltip = "Use the standalone version (false) or the distributed version (true)", - value = dt.preferences.read("script_manager", "use_distro_version", "bool"), - clicked_callback = function(self) - if dt.preferences.read("script_manager", "use_distro_version", "bool") == self.value then - -- do nothing - else - sm.apply_configuration.sensitive = true +sm.widgets.add_scripts = dt.new_widget("box"){ + orientation = vertical, + dt.new_widget("label"){label = _("URL to download additional scripts from")}, + sm.widgets.script_url, + dt.new_widget("label"){label = _("new folder to place scripts in")}, + sm.widgets.new_folder, + dt.new_widget("button"){ + label = _("install additional scripts"), + clicked_callback = function(this) + install_scripts() end - end + } } --- link downloads to $HOME/downloads on linux and MacOS - -sm.link_downloads_directory = dt.new_widget("check_button"){ - label = "Link lua/downloads to $HOME/Downloads", - tooltip = "Linking the directories enables dropping a script in $HOME/downloads\nand having it recognized the next time darktable starts", - value = dt.preferences.read("script_manager", "link_downloads_directory", "bool"), - clicked_callback = function(self) - if dt.preferences.read("script_manager", "link_downloads_directory", "bool") == self.value then - -- do nothing +sm.widgets.allow_disable = dt.new_widget("check_button"){ + label = _('enable "disable scripts" button'), + value = false, + clicked_callback = function(this) + if this.value == true then + sm.widgets.disable_scripts.sensitive = true else - sm.apply_configuration.sensitive = true + sm.widgets.disable_scripts.sensitive = false end - end + end, } -sm.apply_configuration = dt.new_widget("button"){ - label = "Apply", +sm.widgets.disable_scripts = dt.new_widget("button"){ + label = _("disable scripts"), sensitive = false, - clicked_callback = function(self) - dt.preferences.write("script_manager", "use_distro_version", "bool", sm.use_lua_scripts_version.value) - if sm.use_lua_scripts_version.value then - use_lua_scripts_version() - end - if dt.configuration.running_os ~= "windows" then - dt.preferences.write("script_manager", "link_downloads_directory", "bool", sm.link_downloads_directory.value) - if sm.link_downloads_directory.value then - link_downloads_directory() - end - end + clicked_callback = function(this) + local LUARC = dt.configuration.config_dir .. PS .. "luarc" + df.file_move(LUARC, LUARC .. ".disabled") + log.msg(log.info, "lua scripts disabled") + log.msg(log.screen, _("lua scripts will not run the next time darktable is started")) end } --- get git location on windows +sm.widgets.install_update = dt.new_widget("box"){ + orientation = "vertical", + dt.new_widget("section_label"){label = " "}, + dt.new_widget("label"){label = " "}, + dt.new_widget("label"){label = _("update scripts")}, + dt.new_widget("label"){label = " "}, + sm.widgets.update_script_choices, + sm.widgets.update, + dt.new_widget("section_label"){label = " "}, + dt.new_widget("label"){label = " "}, + dt.new_widget("label"){label = _("add more scripts")}, + dt.new_widget("label"){label = " "}, + sm.widgets.add_scripts, + dt.new_widget("section_label"){label = " "}, + dt.new_widget("label"){label = " "}, + dt.new_widget("label"){label = _("disable scripts")}, + dt.new_widget("label"){label = " "}, + sm.widgets.allow_disable, + sm.widgets.disable_scripts, + dt.new_widget("label"){label = " "}, +} -sm.git_location = df.executable_path_widget({"git"}) +-- manage the scripts -sm.configuration_widgets = { - sm.repository, - sm.update_reset, - dt.new_widget("separator"){}, - dt.new_widget("separator"){}, +sm.widgets.folder_selector = dt.new_widget("combobox"){ + label = _("folder"), + tooltip = _( "select the script folder"), + selected = 1, + changed_callback = function(self) + if sm.run then + pref_write("folder_selector", "integer", self.selected) + change_folder(sm.folders[self.selected]) + end + end, + table.unpack(sm.translated_folders), } -if dt.configuration.running_os == "windows" or sm.need_git then - sm.configuration_widgets[#sm.configuration_widgets + 1] = sm.git_location +-- a script "button" consists of: +-- a button to start and stop the script +-- a label that contains the name of the script +-- a horizontal box that contains the button and the label + +sm.widgets.buttons ={} +sm.widgets.labels = {} +sm.widgets.boxes = {} + +for i =1, DEFAULT_BUTTONS_PER_PAGE do + table.insert(sm.widgets.buttons, dt.new_widget("button"){}) + table.insert(sm.widgets.labels, dt.new_widget("label"){}) + table.insert(sm.widgets.boxes, dt.new_widget("box"){ orientation = "horizontal", expand = false, fill = false, + sm.widgets.buttons[i], sm.widgets.labels[i]}) + sm.page_status.buttons_created = sm.page_status.buttons_created + 1 end -if dt.configuration.running_os ~= "windows" then - sm.configuration_widgets[#sm.configuration_widgets + 1] = sm.use_lua_scripts_version - sm.configuration_widgets[#sm.configuration_widgets + 1] = sm.link_downloads_directory -end -sm.configuration_widgets[#sm.configuration_widgets + 1] = sm.apply_configuration - -sm.config_box = dt.new_widget("box"){ - orientation = "vertical", - dt.new_widget("label") { label = "Configuration" }, - table.unpack(sm.configuration_widgets), -} +local page_back = "<" +local page_forward = ">" +sm.widgets.page_status = dt.new_widget("label"){label = _("page") .. ":"} -table.insert(sm.main_menu_choices, "Configure") -table.insert(sm.main_stack_items, sm.config_box) +sm.widgets.page_back = dt.new_widget("button"){ + label = page_back, + clicked_callback = function(this) + if sm.run then + paginate(0) + end + end +} --- set up the outside stack for config, install/update, and download +sm.widgets.page_forward = dt.new_widget("button"){ + label = page_forward, + clicked_callback = function(this) + if sm.run then + paginate(1) + end + end +} - -- make a stack for the choices +sm.widgets.page_control = dt.new_widget("box"){ + orientation = "horizontal", + sm.widgets.page_back, + sm.widgets.page_status, + sm.widgets.page_forward, +} -sm.main_stack = dt.new_widget("stack"){ - table.unpack(sm.main_stack_items), +sm.widgets.scripts = dt.new_widget("box"){ + orientation = vertical, + dt.new_widget("section_label"){label = " "}, + dt.new_widget("label"){label = " "}, + dt.new_widget("label"){label = _("scripts")}, + sm.widgets.folder_selector, + sm.widgets.page_control, + table.unpack(sm.widgets.boxes), } - -- make a combobox for the selector +-- configure options + +sm.widgets.num_buttons = dt.new_widget("slider"){ + label = _("scripts per page"), + tooltip = _("select number of start/stop buttons to display"), + soft_min = MIN_BUTTONS_PER_PAGE, + hard_min = MIN_BUTTONS_PER_PAGE, + soft_max = MAX_BUTTONS_PER_PAGE, + hard_max = MAX_BUTTONS_PER_PAGE, + step = 1, + digits = 0, + value = 10 +} -sm.main_menu = dt.new_widget("combobox"){ - label = "Action", - tooltip = "Select the action you want to perform", - value = 1, "No actions available", - changed_callback = function(self) - for pos,str in ipairs(sm.main_menu_choices) do - if self.value == str then - sm.main_stack.active = pos - dt.preferences.write("script_manager", "sm_main_menu_value", "integer", pos) - end - end +sm.widgets.change_buttons = dt.new_widget("button"){ + label = _("change number of buttons"), + clicked_callback = function(this) + change_num_buttons() end } -if #sm.main_menu_choices > 0 then - update_combobox_choices(sm.main_menu, sm.main_menu_choices, 1) -end - -sm.main_box = dt.new_widget("box"){ +sm.widgets.configure = dt.new_widget("box"){ orientation = "vertical", - sm.main_menu, - sm.main_stack, + dt.new_widget("section_label"){label = " "}, + dt.new_widget("label"){label = " "}, + dt.new_widget("label"){label = _("configuration")}, + dt.new_widget("label"){label = " "}, + sm.widgets.num_buttons, + dt.new_widget("label"){label = " "}, + sm.widgets.change_buttons, + dt.new_widget("label"){label = " "}, } +-- stack for the options --- - - - - - - - - - - - - - - - - - - - - - - - --- D A R K T A B L E I N T E G R A T I O N --- - - - - - - - - - - - - - - - - - - - - - - - +sm.widgets.main_stack = dt.new_widget("stack"){ + sm.widgets.install_update, + sm.widgets.configure, + sm.widgets.scripts, +} --- register the module -dt.register_lib( - "script_manager", -- Module name - "script manager", -- Visible name - true, -- expandable - false, -- resetable - {[dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_BOTTOM", 100}}, -- containers - dt.new_widget("box") -- widget - { - orientation = "vertical", - sm.main_box, - }, - nil,-- view_enter - nil -- view_leave -) +sm.widgets.main_stack.h_size_fixed = false +sm.widgets.main_stack.v_size_fixed = false --- set up the scripts block if we have them otherwise we'll wait until we download them +-- main menu -if sm.have_scripts then +sm.widgets.main_menu = dt.new_widget("combobox"){ + label = _("action"), + changed_callback = function(self) + sm.widgets.main_stack.active = self.selected + pref_write("main_menu_action", "integer", self.selected) + log.msg(log.debug, "saved " .. self.selected .. " for main menu") + end, + _("install/update scripts"), _("configure"), _("start/stop scripts") +} - -- scan for scripts and populate the categories - build_scripts_block() +-- widget for module - -- add the widgets to the lib - insert_scripts_block() +sm.widgets.main_box = dt.new_widget("box"){ + sm.widgets.main_menu, + sm.widgets.main_stack +} - sm.main_menu.selected = 3 +script_manager_running_script = nil +-- - - - - - - - - - - - - - - - - - - - - - - - +-- D A R K T A B L E I N T E G R A T I O N +-- - - - - - - - - - - - - - - - - - - - - - - - + +if dt.gui.current_view().id == "lighttable" then + install_module() +else + if not sm.event_registered then + dt.register_event( + "script_manager", "view-changed", + function(event, old_view, new_view) + if new_view.name == "lighttable" and old_view.name == "darkroom" then + install_module() + end + end + ) + sm.event_registered = true + end end -collectgarbage("restart")