Browse Source

Switch from single quotes to double quotes for #8

pull/15/head
makeworld 4 years ago
parent
commit
d583a29ce8
  1. 12
      MANPAGE.md
  2. 4
      README.md
  3. 32
      didder.1
  4. 10
      didder.1.md

12
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 <https://colorpeek.com/#11161e,116bcd,63b3ed,e1efff>. 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.

4
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).

32
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.

10
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 <https://colorpeek.com/#11161e,116bcd,63b3ed,e1efff>. 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.

Loading…
Cancel
Save