Class: Rixmap::Format::PNG::PNGImageIO

Inherits:

ImageIO::BaseImageIO

Object
ImageIO::BaseImageIO
Rixmap::Format::PNG::PNGImageIO

show all

Defined in:: lib/rixmap/format/png/imageio.rb

Overview

PNG入出力実装クラス.

さすがにPNGフル実装はきついですな(´・ω・‘)

Instance Attribute Summary collapse

#compression_level ⇒ Integer

ピクセルデータ圧縮時の圧縮レベル.
#filter_method ⇒ Integer

スキャンライン毎のフィルタリングメソッド.

Class Method Summary collapse

.readable?(magic) ⇒ Boolean

指定マジックデータがPNG画像のものかを判定します.
.writable?(image) ⇒ Boolean

指定画像をPNGとしてエンコードできるかを返します.

Instance Method Summary collapse

#decode(data, options = {}) ⇒ Rixmap::Image

バイトデータをPNG画像として復元します.
#encode(image, options = {}) ⇒ String

画像をPNG形式でエンコードします.
#initialize(options = {}) ⇒ PNGImageIO constructor

PNG入出力オブジェクトを初期化します.

Constructor Details

#initialize(options = {}) ⇒ `PNGImageIO`

PNG入出力オブジェクトを初期化します.

Options Hash (options):

:compression_level (Integer) —

圧縮レベル (0-9).
:filter_method (Integer) —

スキャンラインのフィルタリングメソッド

# File 'lib/rixmap/format/png/imageio.rb', line 200

def initialize(options={})
  @compression_level = Zlib::BEST_COMPRESSION
  @filter_method     = ADAPTIVEFILTER_UP
  super(options)
end

Instance Attribute Details

#compression_level ⇒ `Integer`

ピクセルデータ圧縮時の圧縮レベル.

値としては Zlib モジュールの定数か、0～9の数値を指定します.



180
181
182

# File 'lib/rixmap/format/png/imageio.rb', line 180

def compression_level
  @compression_level
end

#filter_method ⇒ `Integer`

スキャンライン毎のフィルタリングメソッド.

値は以下のいずれかです.



193
194
195

# File 'lib/rixmap/format/png/imageio.rb', line 193

def filter_method
  @filter_method
end

Class Method Details

.readable?(magic) ⇒ `Boolean`

指定マジックデータがPNG画像のものかを判定します.



163
164
165

# File 'lib/rixmap/format/png/imageio.rb', line 163

def self.readable?(magic)
  return (magic[0, FILE_SIGNATURE_SIZE] == FILE_SIGNATURE)
end

.writable?(image) ⇒ `Boolean`

指定画像をPNGとしてエンコードできるかを返します.



171
172
173

# File 'lib/rixmap/format/png/imageio.rb', line 171

def self.writable?(image)
  return true
end

Instance Method Details

#decode(data, options = {}) ⇒ `Rixmap::Image`

バイトデータをPNG画像として復元します.

# File 'lib/rixmap/format/png/imageio.rb', line 314

def decode(data, options={})
  if data.byteslice(0, FILE_SIGNATURE_SIZE) != FILE_SIGNATURE
    raise ArgumentError.new("InvalidSignature detected. Input is not PNG Image Data.")
  end

  # チャンクを分割

  offset = FILE_SIGNATURE_SIZE
  length = data.bytesize
  chunks = []
  while offset < length
    chunk_size = data.byteslice(offset, offset + 4).unpack('N')[0]; offset += 4
    chunk_data = nil
    chunk_type = nil
    chunk_crc  = nil
    if chunk_size > 0
      chunk_type, chunk_data, chunk_crc = data.byteslice(offset, offset + (chunk_size + 8)).unpack("a4a#{chunk_size}N")
    elsif chunk_size == 0
      chunk_type, chunk_crc = data.byteslice(offset, offset + 8).unpack("a4N")
    else
      raise RuntimeError.new("Invalid Chunk Size: #{chunk_size}")
    end
    offset += (chunk_size + 8)

    # チャンクがあるかをチェック

    unless Chunk.has?(chunk_type)
      # ないので警告出して次へ

      warn("Unknown or Not-Implemented Chunk Type: #{chunk_type}")
      next
    end
    chunk = Chunk.get(chunk_type).new
    chunk.data = chunk_data

    chunks << chunk
    break if chunk.type == Chunk::IENDChunk::TYPE
  end

  # IHDRチャンクを処理

  ihdr = chunks.shift
  unless ihdr.type == Chunk::IHDRChunk::TYPE
    raise ArgumentError.new("Illegal Chunk Order. First chunk must to be IHDR chunk.")
  end

  image_width  = ihdr.width
  image_height = ihdr.height
  image_depth  = ihdr.depth
  colortype    = ihdr.colortype

  # 残りチャンクを処理

  image_data = ''
  palette    = nil
  chunks.each do |chunk|
    case chunk
    when Chunk::IDATChunk
      image_data.concat(chunk.data)
    when Chunk::PLTEChunk
      palette = Rixmap::Palette.new(2 ** image_depth)
      palette.size.times do |i|
        palette[i] = chunk[i]
      end
    when Chunk::IENDChunk
      break
    end
  end

  # ピクセルを復元

  pixels = Zlib.inflate(image_data).each_byte

  # ベース画像を作成

  image = nil
  case colortype
  when COLORTYPE_INDEXED
    image  = Rixmap::Image.new(Rixmap::INDEXED, image_width, image_height, :palette => palette)
    filter = AdaptiveFilter.new(image.mode)
    pixels.each_slice(image_width + 1).each_with_index do |bytes, i|
      image[i] = filter.recon(bytes)
    end
  when COLORTYPE_GRAYSCALE
    image  = Rixmap::Image.new(Rixmap::GRAYSCALE, image_width, image_height)
    filter = AdaptiveFilter.new(image.mode)
    pixels.each_slice(image_width + 1).each_with_index do |bytes, i|
      image[i] = filter.recon(bytes)
    end
  when COLORTYPE_GRAYSCALE_WITH_ALPHA
    image  = Rixmap::Image.new(Rixmap::GRAYALPHA, image_width, image_height)
    filter = AdaptiveFilter.new(image.mode)
    pixels.each_slice((image_width * 2) + 1).each_with_index do |bytes, i|
      image[i] = filter.recon(bytes)
    end
  when COLORTYPE_TRUECOLOR
    image  = Rixmap::Image.new(Rixmap::RGB, image_width, image_height)
    filter = AdaptiveFilter.new(image.mode)
    pixels.each_slice((image_width * 3) + 1).each_with_index do |bytes, i|
      image[i] = filter.recon(bytes)
    end
  when COLORTYPE_TRUECOLOR_WITH_ALPHA
    image  = Rixmap::Image.new(Rixmap::RGBA, image_width, image_height)
    filter = AdaptiveFilter.new(image.mode)
    pixels.each_slice((image_width * 4) + 1).each_with_index do |bytes, i|
      image[i] = filter.recon(bytes)
    end
  else
    raise RuntimeError.new("Unsupported Colo-Type: #{colortype}")
  end

  return image
end

#encode(image, options = {}) ⇒ `String`

画像をPNG形式でエンコードします.