xyproto/png2svg

:twisted_rightwards_arrows: Convert small PNG images to SVG Tiny 1.2

png2svg

Go module and command line utility for converting small PNG images to SVG Tiny 1.2.

Features and limitations

• Draws rectangles for each region in the PNG image that can be covered by a rectangle.
• The remaining pixels are drawn with a rectangle for each pixel.
• This is not an efficient representation of PNG images!
• The conversion may be useful if you have a small PNG image or icons at sizes around 32x32, and wish to scale them up and print them out without artifacts.
• The utility is fast for small images, but larger images will take an unreasonable amount of time to convert, creating SVG files many megabytes in size. This could potentially also be used for benchmarking the single-core performance of a CPU.
• The resulting SVG images can be opened directly in a browser like Firefox or Chromium, and may look sharper and crisper than small PNG or JPEG images that are smoothed/blurred by the browser, by default (this can be configured with CSS, though).
• The default crispiness of how SVG images are displayed may be useful for displaying "pixel art" style graphics in the browser.
• Written in pure Go, with no runtime dependencies on any external library or utility.
• Handles transparent PNG images by not drawing SVG elements for the transparent regions.
• For creating SVG images that draws a rectangle for each and every pixel, instead of also using larger rectangles, use the -p flag.

Image Comparison

192x192 PNG image (16 colors)	192x192 SVG image (16 colors)	192x192 SVG image (optimized with svgo)
8.2 KiB	193 KiB	66 KiB

The spaceships are drawn by wuhu (CC-BY 3.0).

Try zooming in on the images. Most browsers will keep the SVG image crisp when zooming in, but blur the PNG image.

For keeping PNG images crisp, this CSS can be used, but this is not normally needed for SVG images:

image-rendering: -moz-crisp-edges; /* Firefox */
image-rendering: -o-crisp-edges; /* Opera */
image-rendering: -webkit-optimize-contrast; /* Webkit (non-standard naming) */
image-rendering: crisp-edges;
-ms-interpolation-mode: nearest-neighbor; /* IE (non-standard property) */

Right now, Chrome does not support image-rendering: crisp-edges, while Firefox does not support image-rendering: pixelated. This may change over time, check out the excellent caniuse.com page.

Using SVG to get crisp images has the advantage of not relying on CSS that may differ from browser to browser.

Other comparisons:

302x240 PNG image	302x240 SVG image (limited to 4096 colors)	302x240 SVG (optimized with svgo)
176 KiB	3.1 MiB	934 KiB

With palette reduction:

-n 96 + svgo	-n 32 + svgo	-n 16 + svgo	-n 4 + svgo
516 KiB	356 KiB	369 KiB	139 KiB

Note that fewer colors does not always result in smaller images, because it depends on the shapes of the resulting areas with the same colors, and not just on having few colors.

64x64 PNG image	64x64 SVG image (one rectangle per pixel)	64x64 SVG image (4096 colors)	64x64 SVG image (rectangles >1px are colored pink)	64x64 SVG image (optimized with svgo)
4.1 KiB	172 KiB	74 KiB		25 KiB

The rainforest image is from Wikipedia. The Glenda bunny is from 9p.io.

Q&A

Q: Why 4096 colors?
A: Because representing colors on the short form (#000 as opposed to #000000) makes it possible to express 4096 unique colors.

Q: Does this mean that I can make an entire web page in SVG, with photos and everything?
A: Yes! This is not the intended use of png2svg, but it might work out if the images are kept small.

Q: Can I use this for QR codes?
A: Yes!

Q: Can I use png2svg together with svgo to create assets for a game that only uses vector graphics?
A: Yes! If the images are kept small.

Q: Are these questions just made up, or did someone actually ask this?
A: Look behind you, a three headed monkey!

Installation

For Go 1.17 or later:

go install github.com/xyproto/png2svg/cmd/png2svg@latest

Example usage

Generate an SVG image with as few rectangles as possible (-o for "output"):

png2svg -o output.svg input.png

Generate an SVG image with one rectangle per pixel:

png2svg -p -o output.svg input.png

Generate an SVG image where the output is limited to 4096 unique colors (-l for "limit"):

png2svg -l -o output.svg input.png

Like above, but with progress information while the image is being generated:

png2svg -v -l -o output.svg input.png

Same as above, but also reduce the number of colors to 32:

png2svg -v -l -n 32 -o output.svg input.png

Packaging status

General information

• Version: 1.5.4
• Author: Alexander F. Rødseth <[email protected]>
• License: BSD-3

png2svg's Issues

png2svg -V don't output version

Hi,

When run png2svg -V, there is no version info output.

-V version (default: false)

Is this a bug of -V GLOBAL OPTIONS?

Thanks!

Generated SVGs are semitransparent

Hi, first of all thanks for this repo!
I tried to convert my profile picture to see how this tool worked, and I noticed that some SVG viewers render the image as if it were semitransparent (the input PNG is not transparent). For example, Xfce's thumbnails and this site see the transparentness, but Chromium's SVG viewer does not.
Do you think there's a solution to this behavior?

support Apple Silicon (M1)

Compile support Apple M1

Is there deb format package for png2svg?

The png2svg is good tools, I like it.

Is there deb format package for png2svg already?

Perhaps I can make a deb package for png2svg.

Integrate/recommend svgo for ~65% size reduction

Using svgo reduces the demo files on the README by about 65%. Maybe you should recommend it, or even make use of it in your code, if the user has it installed?

❯ svgo -i spaceships.svg -o spaceships.min.svg                               

spaceships.svg:
Done in 992 ms!
186.949 KiB - 63.3% = 68.553 KiB

❯ svgo -i rainforest4096.svg -o rainforest4096.min.svg 

rainforest4096.svg:
Done in 294565 ms!
3051.344 KiB - 64.4% = 1086.735 KiB

After analyzing the source files (you'll find the --pretty option useful for that), it looks like it's basically just converting all your rects into paths. Possibly something this code could do on its own.

Can there be option choose qty of colors?

Hi, I'd like to make it work images Canva. So now in order to do it I use - https://www.pngtosvg.com/. If you want to be able to change colors in Canva you put the number of colors.

Is it possible to do it here?

I mean not just general limitation 4096 with -l but manual limitation.