1 Star 0 Fork 0

铜豌豆 Linux / png2svg

Create your Gitee Account
Explore and code with more than 12 million developers,Free private repositories !:)
Sign up
Clone or Download
Sync branch
Notice: Creating folder will generate an empty file .keep, because not support in Git

png2svg Build GoDoc Go Report Card

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)
5.7 KiB 187 KiB 61 KiB
png svg svgopt

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)
171 KiB 3.0 MiB 911 KiB
png svg svgopt

With palette reduction:

-n 96 + svgo -n 32 + svgo -n 16 + svgo -n 4 + svgo
610 KiB 425 KiB 439 KiB 188 KiB
96 colors 32 colors 16 colors 4 colors

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

The rainforest image is from Wikipedia.

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)
2.3 KiB 167 KiB 69 KiB 22 KiB
png svgpixel svg4096 svgpink svgopt

The Glenda bunny is from 9p.io.


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!


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

Packaging status

General information

Copyright 2022 Alexander F. Rødseth Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


png2svg expand collapse
Go and 2 more languages


No release




Load More
can not load any more