Allow programatically reading / setting output color profile of an image to be exported
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
Research direction
Start with the Lua API entry points dt.new_format("jpeg") and dt_imageio_module_format_t.write_image, then review the referenced colorspaces.c profile ordering and issue #414. Compare the requested ways to read or set the export profile and define completion as a script being able to select or inspect the output profile without relying on UI ordering.
Written by the indexing model from the issue text.
Description
Forked from pixls.us thread:
In a script, I'm using the following code to export an image to JPG:
local exporter = dt.new_format("jpeg")
exporter.quality = 95
exporter:write_image(src, dest)
That code is dependent on the export module's output color profile currently selected in the UI. I would like to either force a specific profile (let's say Display P3 RGB), or detect when an invalid profile (for my purpose) is used, to be able to warn the user. My options with the current API are:
-
dt.gui.action("lib/export/profile", 0, "selection", "first", 0.0)+dt.gui.action("lib/export/profile", 0, "selection", "next", 10.0)asDisplay P3 RGBis currently the 11th one displayed; that's hardcoded in colorspaces.c.Pro: Unobtrusive.
Con: Depends on DT internals without their proper representation through the API. If DT profile order ever changes, the script forcefully selects a different profile. -
dt.gui.action("lib/export/profile", 0, "selection", "popup", 0.0)Pro: Doesn't depend on DT internals, user could select their own ICC profiles too.
Con: Obtrusive; user is prompted to the action even if the current settings are correct, they are also asked to select the only correct option. -
Export, then check the resulting file metadata, and error out post factum.
Pro: Unobtrusive.
Con: Suboptimal UX, as I cannot prevent the error from happening, or implement input data validation before triggering the action. Possibly the metadata won't be there if export doesn't have the EXIF. -
Export outside of DT
Pro: Total control over the output.
Con: Needs an intermediary export in DT to a format that isn't sensitive to color profile (does it even exist?) to retain changes done to the RAW in DT, like cropping etc.
All of the workarounds above would not be needed if the Lua API allowed for:
- Setting output color profile in
dt_imageio_module_format_t.write_image, or - Reading/setting output color profile of
dt_lua_image_t(this might be through #414). I could then useimage settingsprofile in export, which is the first option in the combobox, or - Reading/setting the combobox options by their name in export's profile combobox (the
item:prefix doesn't seem to work there)
- Dominant language
- Lua
- Stars
- 219
- Forks
- 142
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from darktable-org/lua-scripts
-
dtutils.string: build_substitute_list errors when a metadata field (e.g. rights) has been removed Open
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
darktable-org/lua-scripts#716 · 2 comments ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 63/100
darktable-org/lua-scripts#706 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
darktable-org/lua-scripts#627 · 2 comments ·
-
bug
Difficulty 1/5 Under an hour Newbie friendliness 65/100
darktable-org/lua-scripts#618 · 3 comments ·
-
Difficulty 3/5 1-2 days Newbie friendliness 52/100
darktable-org/lua-scripts#710 · 3 comments ·
All issues in darktable-org/lua-scripts
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
api7/lua-resty-saml#62 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
nvim-tree/nvim-tree.lua#3357 · 1 comment ·
-
Difficulty 1/5 Under an hour Newbie friendliness 94/100
codymikol/multiverse.nvim#320 ·
-
Data Correction tbc
Difficulty 2/5 1-3 hours Newbie friendliness 68/100