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
- RDoc
- Wiki
- Issue tracker
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::Canvas
-
represents an image canvas as a matrix of pixels.
ChunkyPNG::Color
-
represents a, RGBA color
Usage
require 'chunky_png'
# Creating an image from scratch
png = ChunkyPNG::Image.new(16, 16, ChunkyPNG::Color::TRANSPARENT)
png[1,1] = ChunkyPNG::Color.rgba(10, 20, 30, 128)
png[2,1] = ChunkyPNG::Color.rgba(0, 0, 0, 128)
png.save('filename.png')
# Compose images using alpha blending
avatar = ChunkyPNG::Image.from_file('avatar.png')
badge = ChunkyPNG::Image.from_file('no_ie_badge.png')
avatar.compose(badge, 10, 10)
avatar.save('composited.png', :color_mode => ChunkyPNG::COLOR_GRAYSCALE, :interlace => true)
# Inspecting metadata - TODO
# Low level access to PNG chunks
png_stream = ChunkyPNG::Datastream.from_file('filename.png')
png_stream.each_chunk { |chunk| p chunk.type }
(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.: The name of this library is intentionally similar to Chunky Bacon and Chunky GIF. Use Google if you want to know _why.