-
Notifications
You must be signed in to change notification settings - Fork 94
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Remove network requests for pngquant src
- Loading branch information
1 parent
42091a7
commit 85248f5
Showing
3 changed files
with
131 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,129 @@ | ||
.Dd 2013-02-25 | ||
.Dt pngquant 1 | ||
.Sh NAME | ||
.Nm pngquant | ||
.Nd PNG converter and lossy image compressor | ||
.Sh SYNOPSIS | ||
.Nm | ||
.Aq options | ||
.Op ncolors | ||
.Pa file | ||
.Op Ar | ||
.Nm | ||
.Aq options | ||
.Op ncolors | ||
.Fl | ||
.Cm < Ns Pa file | ||
.Cm > Ns Pa file | ||
.Sh DESCRIPTION | ||
.Nm | ||
converts 32-bit RGBA PNGs to 8-bit (or smaller) RGBA-palette PNGs, optionally using Floyd-Steinberg dithering. | ||
The output filename is the same as the input name except that it ends in | ||
.Ql -fs8.png | ||
or | ||
.Ql -or8.png | ||
(unless the input is stdin, in which case the quantized image will go to stdout). | ||
The default behavior if the output file exists is to skip the conversion; use | ||
.Fl Fl force | ||
to overwrite. | ||
.Sh OPTIONS | ||
.Bl -tag -width -indent | ||
.It Fl o Ar out.png , Fl Fl output Ar out.png | ||
Writes converted file to the given path. When this option is used only single input file is allowed. | ||
.It Fl Fl ext Ar new.png | ||
File extension (suffix) to use for output files instead of the default | ||
.Ql -fs8.png | ||
or | ||
.Ql -or8.png . | ||
.It Fl f , Fl Fl force | ||
Overwrite existing output files. | ||
.Do | ||
.Fl Fl ext | ||
.Ar .png | ||
.Fl Fl force | ||
.Dc | ||
can be used to convert files in place (which is unsafe). | ||
.It Fl Fl nofs , Fl Fl ordered | ||
Disable Floyd-Steinberg dithering. | ||
.It Fl Fl floyd Op Ar =N | ||
Set dithering level using fractional number between | ||
.Cm 0 | ||
(none) and | ||
.Cm 1 | ||
(full, the default). | ||
.It Fl s Ar N , Fl Fl speed Ar N | ||
.Cm 1 | ||
(brute-force) to | ||
.Cm 11 | ||
(fastest). The default is | ||
.Cm 3 . | ||
Speed | ||
.Cm 10 | ||
has 5% lower quality, but is about 8 times faster than the default. Speed 11 disables dithering and lowers compression level. | ||
.It Fl Q Ar min-max , Fl Fl quality Ar min-max | ||
.Va min | ||
and | ||
.Va max | ||
are numbers in range | ||
.Cm 0 | ||
(worst) to | ||
.Cm 100 | ||
(perfect), similar to JPEG. | ||
.Nm | ||
will use the least amount of colors required to meet or exceed the | ||
.Va max | ||
quality. If conversion results in quality below the | ||
.Va min | ||
quality the image won't be saved (or if outputting to stdin, 24-bit original will be output) and pngquant will exit with status code | ||
.Er 99 . | ||
.It Fl Fl skip-if-larger | ||
If conversion results in a file larger than the original, the image won't be saved and pngquant will exit with status code | ||
.Er 98 . | ||
Additionally, file size gain must be greater than the amount of quality lost. If quality drops by 50%, it will expect 50% file size reduction to consider it worthwhile. | ||
.It Fl Fl posterize Ar bits | ||
Truncate number of least significant bits of color (per channel). Use this when image will be output on low-depth displays (e.g. 16-bit RGB). | ||
.Nm | ||
will make almost-opaque pixels fully opaque and will reduce amount of semi-transparent colors. When this option is enabled the default filename suffix is | ||
.Ql -ie-fs8.png | ||
/ | ||
.Ql -ie-or8.png . | ||
.It Fl Fl strip | ||
Remove optional chunks (metadata) from PNG files. | ||
.It Fl Fl transbug | ||
Workaround for readers that expect fully transparent color to be the last entry in the palette. | ||
.It Fl v , Fl Fl verbose | ||
Enable verbose messages showing progress and information about input/output. Opposite is | ||
.Fl Fl quiet . | ||
Errors are output to | ||
.Pa stderr | ||
regardless of this option. | ||
.It Fl V , Fl Fl version | ||
Display version on | ||
.Pa stdout | ||
and exit. | ||
.It Fl h , Fl Fl help | ||
Display help and exit. | ||
.El | ||
.Sh EXAMPLE | ||
Creating a new image with the number of colors reduced to 64: | ||
.Bd -ragged -offset indent | ||
.Nm | ||
.Cm 64 image.png | ||
.Ed | ||
.Pp | ||
The resulting image will have 64 colors and will be saved as | ||
.Pa image-fs8.png . | ||
.Pp | ||
Overwriting image in-place if it can be reduced without too much quality loss: | ||
.Bd -ragged -offset indent | ||
.Nm | ||
.Cm -f --ext .png --quality 70-95 image.png | ||
.Ed | ||
.Sh AUTHOR | ||
.Nm | ||
is developed by Kornel Lesinski | ||
.Aq Mt kornel@pngquant.org | ||
based on code by Greg Roelofs | ||
.Aq Mt newt@pobox.com . | ||
.Pp | ||
.Lk https://pngquant.org "pngquant homepage" . |
Binary file not shown.