From 9b284ea4b9d8483b617ba93e21738a682701264d Mon Sep 17 00:00:00 2001
From: Mica Semrick <mica@silentumbrella.com>
Date: Tue, 20 Aug 2024 18:20:52 -0700
Subject: [PATCH] Initial draft for high quality processing button, fron Jens.

---
 content/darkroom/darkroom-view-layout.md      |   3 ++
 .../high-quality-processing-icon.png          | Bin 0 -> 897 bytes
 .../darkroom/high-quality-processing.md       |  29 ++++++++++++++++++
 .../high-quality-processing-icon.png          | Bin 0 -> 897 bytes
 4 files changed, 32 insertions(+)
 create mode 100644 content/darkroom/darkroom-view-layout/high-quality-processing-icon.png
 create mode 100644 content/module-reference/utility-modules/darkroom/high-quality-processing.md
 create mode 100644 content/module-reference/utility-modules/darkroom/high-quality-processing/high-quality-processing-icon.png

diff --git a/content/darkroom/darkroom-view-layout.md b/content/darkroom/darkroom-view-layout.md
index 309b5ac3f6..732af1487e 100644
--- a/content/darkroom/darkroom-view-layout.md
+++ b/content/darkroom/darkroom-view-layout.md
@@ -73,6 +73,9 @@ From left to right:
 ![color-assessment-icon](./darkroom-view-layout/color-assessment-icon.png#icon) [color assessment](../module-reference/utility-modules/darkroom/color-assessment.md)
 : Toggle the ISO12646 color assessment view.
 
+![high-quality-processing-icon](./darkroom-view-layout/high-quality-processing-icon.png#icon) [high quality processing](../module-reference/utility-modules/darkroom/high-quality-processing.md)
+: Toggle high quality processing mode.
+
 ![raw-overexposed-icon](./darkroom-view-layout/raw-overexposed-icon.png#icon) [raw overexposed warning](../module-reference/utility-modules/darkroom/raw-overexposed.md)
 : Toggle raw overexposed indicators (right-click for options).
 
diff --git a/content/darkroom/darkroom-view-layout/high-quality-processing-icon.png b/content/darkroom/darkroom-view-layout/high-quality-processing-icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..59b9aec0092671c3d99cf8551ae108cc84ce89bc
GIT binary patch
literal 897
zcmeAS@N?(olHy`uVBq!ia0vp^o<MBM!3GkUd@Kz}u@pObhHwBu4M$1`kS|%{8c`CQ
zpH@<ySd_|;o|m7Ss#}~~l$x4XoRMGho_W6=P>~i$k#kXMVo7Fxo<c}wZYqOIrh>77
zf>&vdf{}rdiGqQJm8qeXk(q+CYjDWphM2Vs3`}=DT^vI)8sE<H&3@$|(ssYv*Rj)U
z@ub!Tc`+h9t(SHLe*afkx>%v9qkD(onn(`~+0>|2JIkjgy}oWS(^KcnW|_$|r?<~J
z>~m&*+3vsmU7P>(S|7-F@JxcD-<B70%qIG%J@ynfmY0`*QDVjZn0=B^CyUJS#^;rR
zsk=FgcFJf?J$3Oup9&*`B1?<F&7FB&yLa!Nynp4qBMp;|9JpAtyJg+$3#ES_l}-tI
znJVonrsugdi1TUD&o`zm0$+aDt_!&Cpy|3c?C{^ee{a5i_StgTWzFkSL8o*Dw%pB2
z_4&_x|GS|C&xc>Xv~qbLPFf@)q7XeLz_XBpYl5cNj3pMVtS5w2U4#@_CZA;Kbz@!`
z;&o(7%#zEQTcUI=`jkULGCU6oyKpqV-nHWT>x~_kN@cg@9{y}oF;D$VCzopG{v$Q_
z+aFsL#EPFkf8Oa(Y;*4Ih_zu7{l^;~TzY&<{h<p#my7Q7(-#h|OEr;_<=}L=xlJ}J
zPtP+yKfgfcdB)^#wf55ve_W}qCXhNy?fadWNpW#;JH&gK?|*-|OYi&NR}H6uVSp7e
zOjo&VvM}?`@qH&Qn(!V?n)tg;&vR!CpTEDqx@&Berhap9cGj%6s=a+VW~Xh<%Xdn)
z6^2YnjohHqZ7rbR-``(RQSrk}jN?>_(ZXkZS0~qXZPMXxbz(gH&>%!Z?$=*CpUZ!Q
zRJ{aTOx`(!EDUh4n}0mP;6U1DPT4n68cX9B@f;RV<4BC#^)^|8jbXv<x5s|DGb|O^
z8|S}5q2mtIoL7N?N}G;+6WrzB6+A`9al*!#J<d~n94Bmj+!r(@$MHe#o$jMeFN+VR
z7<GQFI=h+0cx4FJ=9_Ook^Ihdhsxbc&zk~M0@-8Orl_#>O^a5WeDL}6^e>r7PhuY1
zPuOz%ZNS>F)bw4R_wL{C@00g<Rkl0u$<NRg;3NYNt^@TK9yzeRU-o_qFncg~y85}S
Ib4q9e02Aw!7XSbN

literal 0
HcmV?d00001

diff --git a/content/module-reference/utility-modules/darkroom/high-quality-processing.md b/content/module-reference/utility-modules/darkroom/high-quality-processing.md
new file mode 100644
index 0000000000..bb1decb2c5
--- /dev/null
+++ b/content/module-reference/utility-modules/darkroom/high-quality-processing.md
@@ -0,0 +1,29 @@
+---
+title: high quality processing
+id: hq-processing
+applicable-version: 4.8
+tags:
+view: darkroom
+---
+
+Click the ![high quality processing icon](./high-quality-processing/high-quality-processing-icon.png#icon) icon to activate high quality processing in the pixelpipe.
+
+Darktable pixelpipes process the modules in slightly different ways, the thumbnail pipe as an example is optimized for speed.
+
+The darkroom pixelpipes for the main canvas and the second monitor try to keep resources within limits by downscaling and by
+restricting the processed data to what is actually displayed - in darktable speak this is the "region of interest" (ROI).
+
+Yet - for exports we have to process the whole image - likely without downscaling - resulting in much larger processing times
+and possibly visible differences compared to what you have seen in darkroom.
+
+These differences are mostly very subtle but in some cases they are likely to be observed.
+Modules like "diffuse or sharpen" using large radii, "profiled denoise" or "local contrast" are more prone to this problem.
+
+For the user this usually means: there will be visible and unexpected differences between "what you see in darkroom" and the exported image.
+Also there might be visible differences if you zoom in or out.
+
+To avoid these problems you might activate the high quality processing mode. If toggled on, the darkroom pixelpipes are processed
+with all available data so the results are as while exporting in high quality mode.
+
+Please note, this takes large resources and requires a good OpenCL card and CPU for a responsive user interface especially if you keep changing
+any module parameters.
diff --git a/content/module-reference/utility-modules/darkroom/high-quality-processing/high-quality-processing-icon.png b/content/module-reference/utility-modules/darkroom/high-quality-processing/high-quality-processing-icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..59b9aec0092671c3d99cf8551ae108cc84ce89bc
GIT binary patch
literal 897
zcmeAS@N?(olHy`uVBq!ia0vp^o<MBM!3GkUd@Kz}u@pObhHwBu4M$1`kS|%{8c`CQ
zpH@<ySd_|;o|m7Ss#}~~l$x4XoRMGho_W6=P>~i$k#kXMVo7Fxo<c}wZYqOIrh>77
zf>&vdf{}rdiGqQJm8qeXk(q+CYjDWphM2Vs3`}=DT^vI)8sE<H&3@$|(ssYv*Rj)U
z@ub!Tc`+h9t(SHLe*afkx>%v9qkD(onn(`~+0>|2JIkjgy}oWS(^KcnW|_$|r?<~J
z>~m&*+3vsmU7P>(S|7-F@JxcD-<B70%qIG%J@ynfmY0`*QDVjZn0=B^CyUJS#^;rR
zsk=FgcFJf?J$3Oup9&*`B1?<F&7FB&yLa!Nynp4qBMp;|9JpAtyJg+$3#ES_l}-tI
znJVonrsugdi1TUD&o`zm0$+aDt_!&Cpy|3c?C{^ee{a5i_StgTWzFkSL8o*Dw%pB2
z_4&_x|GS|C&xc>Xv~qbLPFf@)q7XeLz_XBpYl5cNj3pMVtS5w2U4#@_CZA;Kbz@!`
z;&o(7%#zEQTcUI=`jkULGCU6oyKpqV-nHWT>x~_kN@cg@9{y}oF;D$VCzopG{v$Q_
z+aFsL#EPFkf8Oa(Y;*4Ih_zu7{l^;~TzY&<{h<p#my7Q7(-#h|OEr;_<=}L=xlJ}J
zPtP+yKfgfcdB)^#wf55ve_W}qCXhNy?fadWNpW#;JH&gK?|*-|OYi&NR}H6uVSp7e
zOjo&VvM}?`@qH&Qn(!V?n)tg;&vR!CpTEDqx@&Berhap9cGj%6s=a+VW~Xh<%Xdn)
z6^2YnjohHqZ7rbR-``(RQSrk}jN?>_(ZXkZS0~qXZPMXxbz(gH&>%!Z?$=*CpUZ!Q
zRJ{aTOx`(!EDUh4n}0mP;6U1DPT4n68cX9B@f;RV<4BC#^)^|8jbXv<x5s|DGb|O^
z8|S}5q2mtIoL7N?N}G;+6WrzB6+A`9al*!#J<d~n94Bmj+!r(@$MHe#o$jMeFN+VR
z7<GQFI=h+0cx4FJ=9_Ook^Ihdhsxbc&zk~M0@-8Orl_#>O^a5WeDL}6^e>r7PhuY1
zPuOz%ZNS>F)bw4R_wL{C@00g<Rkl0u$<NRg;3NYNt^@TK9yzeRU-o_qFncg~y85}S
Ib4q9e02Aw!7XSbN

literal 0
HcmV?d00001