From d583a29ce81450f4f3c558e9c11ee31db9dee926 Mon Sep 17 00:00:00 2001 From: makeworld Date: Tue, 24 May 2022 16:42:03 -0400 Subject: [PATCH] Switch from single quotes to double quotes for #8 --- MANPAGE.md | 12 ++++++------ README.md | 4 ++-- didder.1 | 32 +++++++++++++++++++++++--------- didder.1.md | 10 +++++----- 4 files changed, 36 insertions(+), 22 deletions(-) diff --git a/MANPAGE.md b/MANPAGE.md index d18e26a..e7f13bc 100644 --- a/MANPAGE.md +++ b/MANPAGE.md @@ -4,7 +4,7 @@ title: DIDDER section: 1 header: User Manual footer: didder v1.1.0 -date: May 09, 2021 +date: May 24, 2022 --- # NAME @@ -244,27 +244,27 @@ If your palette (original or recolor) is low-spread — meaning it doesn't span # EXAMPLES -**didder \--palette \'black white' -i input.jpg -o test.png bayer 16x16** +**didder \--palette \"black white" -i input.jpg -o test.png bayer 16x16** This command dithers `input.jpg` using only black and white (implicitly converting the image to grayscale first), using a 16x16 Bayer matrix. The result is written to `test.png`. -**didder \--palette \'black white' -i input.jpg -o test.png odm ClusteredDot4x4** +**didder \--palette \"black white" -i input.jpg -o test.png odm ClusteredDot4x4** Same command as above, but dithering with the preprogrammed ordered dithering matrix called ClusteredDot4x4. -**didder -i david.png -o david_dithered.png \--palette \'black white' \--recolor \'black F273FF' \--upscale 2 bayer 4x4** +**didder -i david.png -o david_dithered.png \--palette \"black white" \--recolor \"black F273FF" \--upscale 2 bayer 4x4** This is the command used for the README. It dithers using a 4x4 Bayer matrix, initially to black and white, which is then recolored to black and purple. Dithering to black and purple directly would produce much lower contrast results. The dithered image is upscaled to be two times larger, so that the Bayer dithering artifacts can be seen more clearly. -**didder -i input.png -o output.png -p \'1E1E1E CDCDCD EDEDED FFFFFF' -r \'11161e 116bcd 63b3ed e1efff' \--strength 64% \--brightness 20% bayer 32x32** +**didder -i input.png -o output.png -p \"1E1E1E CDCDCD EDEDED FFFFFF" -r \"11161e 116bcd 63b3ed e1efff" \--strength 64% \--brightness 20% bayer 32x32** This command uses a blue recolor palette, one that is biased to being darker. The palette can be viewed at . The dithering palette is the grayscale version of those colors, to keep luminance accurate. Strength is set to 64%, which although usually recommended for Bayer dithering of color images, works well here. Alternatively, one could try and increase **\--contrast**. Finally, the brightness is increased to compensate for the dark palette. -**didder -p \'black white' \--recolor \'darkgreen white' -i frame_01.png -i frame_02.png -o output.gif \--fps 1 random -0.5,0.5** +**didder -p \"black white" \--recolor \"darkgreen white" -i frame_01.png -i frame_02.png -o output.gif \--fps 1 random -0.5,0.5** This command takes two input images and creates an animated GIF, dithering and recoloring them along the way. The GIF moves at 1 frame per second, and by default loops infinitely. Random dithering is used, with recommended default of -0.5,0.5. diff --git a/README.md b/README.md index 8690aaa..8a768e3 100644 --- a/README.md +++ b/README.md @@ -111,13 +111,13 @@ You can also run `didder` to see the global options and commands. Each command r Here's a fully working command as an example: ```shell -didder --palette 'black white' -i input.jpg -o test.png bayer 16x16 +didder --palette "black white" -i input.jpg -o test.png bayer 16x16 ``` This command dithers `input.jpg` to just use black and white (implicitly converting to grayscale first), using a 16x16 Bayer matrix. The result is written to `test.png`. As another example, here's the command used for the image at the top of the README: ```shell -didder -i david.png -o david_dithered.png --palette 'black white' --recolor 'black F273FF' --upscale 2 bayer 4x4 +didder -i david.png -o david_dithered.png --palette "black white" --recolor "black F273FF" --upscale 2 bayer 4x4 ``` If you'd like the replicate this yourself, the input image is available [here](https://upload.wikimedia.org/wikipedia/commons/7/71/Michelangelo%27s_David_-_63_grijswaarden.png). diff --git a/didder.1 b/didder.1 index f3b7a36..0e52385 100644 --- a/didder.1 +++ b/didder.1 @@ -1,6 +1,20 @@ -.\" Automatically generated by Pandoc 2.13 +.\" Automatically generated by Pandoc 2.18 .\" -.TH "DIDDER" "1" "May 09, 2021" "didder v1.1.0" "User Manual" +.\" Define V font for inline verbatim, using C font in formats +.\" that render this, and otherwise B font. +.ie "\f[CB]x\f[]"x" \{\ +. ftr V B +. ftr VI BI +. ftr VB B +. ftr VBI BI +.\} +.el \{\ +. ftr V CR +. ftr VI CI +. ftr VB CB +. ftr VBI CBI +.\} +.TH "DIDDER" "1" "May 24, 2022" "didder v1.1.0" "User Manual" .hy .SH NAME .PP @@ -515,17 +529,17 @@ As mentioned above, these flags apply their transformations to the original image and will not adjust your selected palette colors. .SH EXAMPLES .TP -\f[B]didder --palette \[aq]black white\[cq] -i input.jpg -o test.png bayer 16x16\f[R] -This command dithers \f[C]input.jpg\f[R] using only black and white +\f[B]didder --palette \[dq]black white\[rq] -i input.jpg -o test.png bayer 16x16\f[R] +This command dithers \f[V]input.jpg\f[R] using only black and white (implicitly converting the image to grayscale first), using a 16x16 Bayer matrix. -The result is written to \f[C]test.png\f[R]. +The result is written to \f[V]test.png\f[R]. .TP -\f[B]didder --palette \[aq]black white\[cq] -i input.jpg -o test.png odm ClusteredDot4x4\f[R] +\f[B]didder --palette \[dq]black white\[rq] -i input.jpg -o test.png odm ClusteredDot4x4\f[R] Same command as above, but dithering with the preprogrammed ordered dithering matrix called ClusteredDot4x4. .TP -\f[B]didder -i david.png -o david_dithered.png --palette \[aq]black white\[cq] --recolor \[aq]black F273FF\[cq] --upscale 2 bayer 4x4\f[R] +\f[B]didder -i david.png -o david_dithered.png --palette \[dq]black white\[rq] --recolor \[dq]black F273FF\[rq] --upscale 2 bayer 4x4\f[R] This is the command used for the README. It dithers using a 4x4 Bayer matrix, initially to black and white, which is then recolored to black and purple. @@ -534,7 +548,7 @@ results. The dithered image is upscaled to be two times larger, so that the Bayer dithering artifacts can be seen more clearly. .TP -\f[B]didder -i input.png -o output.png -p \[aq]1E1E1E CDCDCD EDEDED FFFFFF\[cq] -r \[aq]11161e 116bcd 63b3ed e1efff\[cq] --strength 64% --brightness 20% bayer 32x32\f[R] +\f[B]didder -i input.png -o output.png -p \[dq]1E1E1E CDCDCD EDEDED FFFFFF\[rq] -r \[dq]11161e 116bcd 63b3ed e1efff\[rq] --strength 64% --brightness 20% bayer 32x32\f[R] This command uses a blue recolor palette, one that is biased to being darker. The palette can be viewed at @@ -546,7 +560,7 @@ dithering of color images, works well here. Alternatively, one could try and increase \f[B]--contrast\f[R]. Finally, the brightness is increased to compensate for the dark palette. .TP -\f[B]didder -p \[aq]black white\[cq] --recolor \[aq]darkgreen white\[cq] -i frame_01.png -i frame_02.png -o output.gif --fps 1 random -0.5,0.5\f[R] +\f[B]didder -p \[dq]black white\[rq] --recolor \[dq]darkgreen white\[rq] -i frame_01.png -i frame_02.png -o output.gif --fps 1 random -0.5,0.5\f[R] This command takes two input images and creates an animated GIF, dithering and recoloring them along the way. The GIF moves at 1 frame per second, and by default loops infinitely. diff --git a/didder.1.md b/didder.1.md index a73f12c..17ef1aa 100644 --- a/didder.1.md +++ b/didder.1.md @@ -217,23 +217,23 @@ If your palette (original or recolor) is low-spread — meaning it doesn't span # EXAMPLES -**didder \--palette \'black white' -i input.jpg -o test.png bayer 16x16** +**didder \--palette \"black white" -i input.jpg -o test.png bayer 16x16** : This command dithers `input.jpg` using only black and white (implicitly converting the image to grayscale first), using a 16x16 Bayer matrix. The result is written to `test.png`. -**didder \--palette \'black white' -i input.jpg -o test.png odm ClusteredDot4x4** +**didder \--palette \"black white" -i input.jpg -o test.png odm ClusteredDot4x4** : Same command as above, but dithering with the preprogrammed ordered dithering matrix called ClusteredDot4x4. -**didder -i david.png -o david_dithered.png \--palette \'black white' \--recolor \'black F273FF' \--upscale 2 bayer 4x4** +**didder -i david.png -o david_dithered.png \--palette \"black white" \--recolor \"black F273FF" \--upscale 2 bayer 4x4** : This is the command used for the README. It dithers using a 4x4 Bayer matrix, initially to black and white, which is then recolored to black and purple. Dithering to black and purple directly would produce much lower contrast results. The dithered image is upscaled to be two times larger, so that the Bayer dithering artifacts can be seen more clearly. -**didder -i input.png -o output.png -p \'1E1E1E CDCDCD EDEDED FFFFFF' -r \'11161e 116bcd 63b3ed e1efff' \--strength 64% \--brightness 20% bayer 32x32** +**didder -i input.png -o output.png -p \"1E1E1E CDCDCD EDEDED FFFFFF" -r \"11161e 116bcd 63b3ed e1efff" \--strength 64% \--brightness 20% bayer 32x32** : This command uses a blue recolor palette, one that is biased to being darker. The palette can be viewed at . The dithering palette is the grayscale version of those colors, to keep luminance accurate. Strength is set to 64%, which although usually recommended for Bayer dithering of color images, works well here. Alternatively, one could try and increase **\--contrast**. Finally, the brightness is increased to compensate for the dark palette. -**didder -p \'black white' \--recolor \'darkgreen white' -i frame_01.png -i frame_02.png -o output.gif \--fps 1 random -0.5,0.5** +**didder -p \"black white" \--recolor \"darkgreen white" -i frame_01.png -i frame_02.png -o output.gif \--fps 1 random -0.5,0.5** : This command takes two input images and creates an animated GIF, dithering and recoloring them along the way. The GIF moves at 1 frame per second, and by default loops infinitely. Random dithering is used, with recommended default of -0.5,0.5.