Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Pure ruby library for read/write access to PNG images.
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
spec
tasks
.gitignore
LICENSE
README.rdoc
Rakefile
chunky_png.gemspec

README.rdoc

Chunky PNG

This library can read and write PNG files. It is written in pure Ruby for maximum portability. Let me rephrase: it does NOT require RMagick or any other memory leaking image library.

Source code

github.com/wvanbergen/chunky_png/tree

RDoc

rdoc.info/projects/wvanbergen/chunky_png

Wiki

wiki.github.com/wvanbergen/chunky_png

Issue tracker

github.com/wvanbergen/chunky_png/issues

Features

  • Decodes almost any image that the PNG standard allows, except for images that use a different color depth than 8 bits. This includes all standard color modes and all transparency, interlacing and filtering options.

  • Encodes images supports all color modes (true color, grayscale and indexed) and transparency for all these color modes. The best color mode will be chosen automatically, based on the image's colors.

  • R/W access to the image's pixels.

  • R/W access to all image metadata that is stored in chunks.

Classes

The main classes used within ChunkyPNG are:

ChunkyPNG::Image

create PNG images from scratch or based on another PNG image.

ChunkyPNG::Datastream

low-level read and write access to PNG images from or to a file or stream.

ChunkyPNG::PixelMatrix

represents an images as a matrix of pixels.

ChunkyPNG::Pixel

represents a single pixel or color value.

Usage

require 'chunky_png'

# Creating an image from scratch
png = ChunkyPNG::Image.new(16, 16, ChunkyPNG::Pixel::TRANSPARENT)
png[1,1] = ChunkyPNG::Pixel.rgba(255, 255, 255, 128)
png[2,1] = ChunkyPNG::Pixel.rgba(255, 255, 255, 128)
png.save('filename.png')

# Modify an image - TODO
# Inspecting metadata - TODO

(Note: this is subject to change while work is in progress)

About

The library is written by Willem van Bergen for Floorplanner.com, and released under the MIT license (see LICENSE). Please contact me for questions or remarks. Patches are greatly appreciated! :-)

P.S.: _why is why this library is so chunky.

Something went wrong with that request. Please try again.