Referência rápida

Folha de dicas da biblioteca de imagens ChunkyPNG para Ruby

Guia de referência rápida do ChunkyPNG, a biblioteca PNG em Ruby puro: carregamento, salvamento, manipulação de pixels e cortes.

· Publicado

ChunkyPNG é uma biblioteca em Ruby puro para ler, gravar e manipular imagens PNG sem depender de extensões em C ou ImageMagick.

Carregamento de imagens (Loading Images)

require 'chunky_png'

# Load directly from filesystem
image = ChunkyPNG::Image.from_file('input.png')

# Load from binary in-memory blob or IO stream
image = ChunkyPNG::Image.from_blob(File.binread('input.png'))
image = ChunkyPNG::Image.from_io(io_stream)

Salvamento e exportação de imagens

# Save to file
image.save('output.png')

# Export to binary string blob
binary_blob = image.to_blob

# Write to stream
File.open('stream.png', 'wb') { |io| image.write(io) }

Desenho de pixels e formas geométricas

# Set individual pixel RGBA values
image[0, 0] = ChunkyPNG::Color.rgba(255, 0, 0, 128)

# Color constructors
red  = ChunkyPNG::Color.from_hex('#ff0000')
cyan = ChunkyPNG::Color.rgba(0, 255, 255, 255)

# Draw geometric primitives
image.line(10, 10, 100, 10, red)
image.rect(20, 20, 80, 80, red, cyan) # border, fill
image.circle(50, 50, 25, red)

Transformações e corte (Transforms)

# Crop sub-rectangle: crop(x, y, width, height)
cropped = image.crop(10, 10, 200, 200)

# Flipping and rotation
transformed = image.flip_horizontally.rotate_right
flipped_v   = image.flip_vertically

Temas relacionados