chunky_png 1.3.5 → 1.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1395efeb7e88472e7540738a53c3741b73fca724
-  data.tar.gz: 47a55fd705b53d3c55df1d3c172e49c5890f29c5
+  metadata.gz: fcd13f536104dcb74ae0a6ab6f4c32fe743b62d0
+  data.tar.gz: dfbfd7a772203855d816b00650b2c0559392588c
 SHA512:
-  metadata.gz: aff023ebfaa594917ac6b46b6fa39725a66cb81e3430f05b0c9fa7fab421eeaa2844bf6617ec12958087655211d435a3ed873e76789b9be1bea910234cdeac6b
-  data.tar.gz: 440d1f499da4349fab1c47b912fbf26347f304a33470c7420c4bb5b96511ac80f6bd677544e974116ed90669dea75197089043da6d4c852a63687ea2cdfd1546
+  metadata.gz: 5eaa5acf93abd3766ff83a825552c879396c8a61cc0f9f72ee1b4904cbd38f4e4f33caf98d1968cae748c30140f6d65f0f10453ed34c001b9a2cda37bf76ab66
+  data.tar.gz: 184f7559e6cabfe646b6c18cc1cb9d33c5f67b64f204deb30ceb264c0143959fbea27e34630521f3a84fe9d8fff59579fabc2ad96fe15577e6e10eb898f22272

data/CHANGELOG.rdoc

@@ -9,6 +9,19 @@ The file documents the changes to this library over the different versions.
 
 - Nothing yet!
 
+=== 1.3.6 - 2016-06-19
+
+- Allow reading images from streams that have trailing data after the IEND chunk.
+- Add compatibility for Ruby 2.3's frozen string literals.
+- Documentation updates and small cleanups.
+
+=== 1.3.5 - 2015-10-28
+
+- Performance improvements for <tt>Canvas#crop!</tt> and <tt>ImageData.combine_chunks</tt>
+- Update <tt>chunky_png/rmagick</tt> to work with the latest versions of RMagick.
+- Bugfix in <tt>Color#from_hsl</tt> and <tt>Color#from_hsv</tt> when hue value is 360.
+- Fix encoding issue in <tt>Datastream#to_blob</tt>
+
 === 1.3.4 - 2015-02-16
 
 - Assert compatibility with Ruby 2.2

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2014 Willem van Bergen
+Copyright (c) 2010-2015 Willem van Bergen
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,88 @@
+# ChunkyPNG [![Build Status](https://travis-ci.org/wvanbergen/chunky_png.svg?branch=master)](https://travis-ci.org/wvanbergen/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](http://github.com/wvanbergen/chunky_png/tree)
+- [RDoc](http://rdoc.info/gems/chunky_png/frames)
+- [Wiki](http://github.com/wvanbergen/chunky_png/wiki)
+- [Issue tracker](http://github.com/wvanbergen/chunky_png/issues)
+
+## Features
+
+- Decodes any image that the PNG standard allows. This includes all standard
+  color modes, all bit depths, all transparency, and 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 amount of used colors.
+- R/W access to the image's pixels.
+- R/W access to all image metadata that is stored in chunks.
+- Memory efficient (uses a Fixnum, i.e. 4 or 8 bytes of memory per pixel,
+  depending on the hardware)
+- Reasonably fast for Ruby standards, by only using integer math and a highly
+  optimized saving routine.
+- Interoperability with RMagick if you really have to.
+
+Also, have a look at [OilyPNG](http://github.com/wvanbergen/oily_png) which
+is a mixin module that implements some of the ChunkyPNG algorithms in C, which
+provides a massive speed boost to encoding and decoding.
+
+## Usage
+
+```ruby
+require 'chunky_png'
+
+# Creating an image from scratch, save as an interlaced PNG
+png = ChunkyPNG::Image.new(16, 16, ChunkyPNG::Color::TRANSPARENT)
+png[1,1] = ChunkyPNG::Color.rgba(10, 20, 30, 128)
+png[2,1] = ChunkyPNG::Color('black @ 0.5')
+png.save('filename.png', :interlace => true)
+
+# 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', :fast_rgba) # Force the fast saving routine.
+
+# Accessing metadata
+image = ChunkyPNG::Image.from_file('with_metadata.png')
+puts image.metadata['Title']
+image.metadata['Author'] = 'Willem van Bergen'
+image.save('with_metadata.png') # Overwrite file
+
+# Low level access to PNG chunks
+png_stream = ChunkyPNG::Datastream.from_file('filename.png')
+png_stream.each_chunk { |chunk| p chunk.type }
+```
+
+Also check out the screencast on the ChunkyPNG homepage by John Davison,
+which illustrates basic usage of the library on the [ChunkyPNG
+website](http://chunkypng.com/).
+
+For more information, see the [project
+wiki](https://github.com/wvanbergen/chunky_png/wiki) or the [RDOC
+documentation](http://www.rubydoc.info/gems/chunky_png/frames).
+
+## Security warning
+
+ChunkyPNG is vulnerable to decompression bombs, which means that ChunkyPNG is
+vulnerable to DOS attacks by running out of memory when loading a specifically
+crafted PNG file. Because of the pure-Ruby nature of the library it is very hard
+to fix this problem in the library itself.
+
+In order to safely deal with untrusted images, you should make sure to do the
+image processing using ChunkyPNG in a separate process, e.g. by using fork or a
+background processing library.
+
+## 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!
+
+Please check out CHANGELOG.rdoc to see what changed in all versions.
+
+P.S.: The name of this library is intentionally similar to Chunky Bacon and
+Chunky GIF. Use Google if you want to know _why_. :-)

data/benchmarks/filesize_benchmark.rb

@@ -4,7 +4,7 @@ require 'bundler/setup'
 require 'benchmark'
 require 'chunky_png'
 
-files = ['pixelstream_reference.png', 'operations.png', 'clock_stubbed.png']
+files = ['pixelstream_reference.png', 'operations.png', 'clock.png']
 
 def encode_png(image, constraints = {})
   filesize = nil

data/chunky_png.gemspec

@@ -40,7 +40,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency('rspec', '~> 3')
 
   s.rdoc_options << '--title' << s.name << '--main' << 'README.rdoc' << '--line-numbers' << '--inline-source'
-  s.extra_rdoc_files = ['README.rdoc', 'BENCHMARKING.rdoc', 'CONTRIBUTING.rdoc', 'CHANGELOG.rdoc']
+  s.extra_rdoc_files = ['README.md', 'BENCHMARKING.rdoc', 'CONTRIBUTING.rdoc', 'CHANGELOG.rdoc']
 
   s.files = `git ls-files`.split($/)
   s.test_files = s.files.grep(%r{^(test|spec|features)/})

data/lib/chunky_png.rb

@@ -129,12 +129,12 @@ module ChunkyPNG
   # set correctly to ASCII-8BIT (binary) in Ruby 1.9.
   # @return [String] An empty string, with encoding set to binary in Ruby 1.9
   # @private
-  EMPTY_BYTEARRAY = force_binary("").freeze
+  EMPTY_BYTEARRAY = force_binary(String.new).freeze
 
   # Null-byte, with the encoding set correctly to ASCII-8BIT (binary) in Ruby 1.9.
   # @return [String] A binary string, consisting of one NULL-byte. 
   # @private
-  EXTRA_BYTE = force_binary("\0").freeze
+  EXTRA_BYTE = force_binary(String.new("\0")).freeze
 end
 
 require 'chunky_png/version'

data/lib/chunky_png/canvas/drawing.rb

@@ -299,12 +299,12 @@ module ChunkyPNG
         end
 
         unless fill_color == ChunkyPNG::Color::TRANSPARENT
-          lines.each_with_index do |length, y|
+          lines.each_with_index do |length, y_offset|
             if length > 0
-              line(x0 - length, y0 - y, x0 + length, y0 - y, fill_color)
+              line(x0 - length, y0 - y_offset, x0 + length, y0 - y_offset, fill_color)
             end
-            if length > 0 && y > 0
-              line(x0 - length, y0 + y, x0 + length, y0 + y, fill_color)
+            if length > 0 && y_offset > 0
+              line(x0 - length, y0 + y_offset, x0 + length, y0 + y_offset, fill_color)
             end
           end
         end

data/lib/chunky_png/canvas/operations.rb

@@ -273,7 +273,6 @@ module ChunkyPNG
       # @return [ChunkyPNG::Canvas] Itself, but rotated clockwise.
       # @see #rotate_right for a version that leaves the current canvas intact
       def rotate_right!
-        rotated = self.class.new(height, width)
         new_pixels = []
         0.upto(width - 1) { |i| new_pixels += column(i).reverse }
         replace_canvas!(height, width, new_pixels)

data/lib/chunky_png/canvas/png_decoding.rb

@@ -1,8 +1,8 @@
 module ChunkyPNG
   class Canvas
 
-    # The PNGDecoding contains methods for decoding PNG datastreams to create a 
-    # Canvas object. The datastream can be provided as filename, string or IO 
+    # The PNGDecoding contains methods for decoding PNG datastreams to create a
+    # Canvas object. The datastream can be provided as filename, string or IO
     # stream.
     #
     # Overview of the decoding process:
@@ -22,7 +22,7 @@ module ChunkyPNG
     # * All lines combined to form the original image.
     #
     # For interlaced images, the original image was split into 7 subimages.
-    # These images get decoded just like the process above (from step 3), and get 
+    # These images get decoded just like the process above (from step 3), and get
     # combined to form the original images.
     #
     # @see ChunkyPNG::Canvas::PNGEncoding
@@ -33,7 +33,7 @@ module ChunkyPNG
       # tRNS chunk from the PNG stream. For RGB(A) images, no palette is required.
       # @return [ChunkyPNG::Palette]
       attr_accessor :decoding_palette
-      
+
       # The color to be replaced with fully transparent pixels.
       attr_accessor :transparent_color
 
@@ -84,11 +84,11 @@ module ChunkyPNG
           when ChunkyPNG::COLOR_GRAYSCALE
             self.transparent_color = ds.transparency_chunk.grayscale_entry(depth) if ds.transparency_chunk
         end
-            
+
         decode_png_pixelstream(ds.imagedata, width, height, color_mode, depth, interlace)
       end
 
-      # Decodes a canvas from a PNG encoded pixelstream, using a given width, height, 
+      # Decodes a canvas from a PNG encoded pixelstream, using a given width, height,
       # color mode and interlacing mode.
       # @param [String] stream The pixelstream to read from.
       # @param [Integer] width The width of the image.
@@ -105,14 +105,14 @@ module ChunkyPNG
           when ChunkyPNG::INTERLACING_ADAM7; decode_png_with_adam7_interlacing(stream, width, height, color_mode, depth)
           else raise ChunkyPNG::NotSupported, "Don't know how the handle interlacing method #{interlace}!"
         end
-        
+
         image.pixels.map! { |c| c == transparent_color ? ChunkyPNG::Color::TRANSPARENT : c } if transparent_color
         return image
       end
 
       protected
 
-      # Decodes a canvas from a non-interlaced PNG encoded pixelstream, using a 
+      # Decodes a canvas from a non-interlaced PNG encoded pixelstream, using a
       # given width, height and color mode.
       # @param stream (see ChunkyPNG::Canvas::PNGDecoding#decode_png_pixelstream)
       # @param width (see ChunkyPNG::Canvas::PNGDecoding#decode_png_pixelstream)
@@ -124,7 +124,7 @@ module ChunkyPNG
         decode_png_image_pass(stream, width, height, color_mode, depth, 0)
       end
 
-      # Decodes a canvas from a Adam 7 interlaced PNG encoded pixelstream, using a 
+      # Decodes a canvas from a Adam 7 interlaced PNG encoded pixelstream, using a
       # given width, height and color mode.
       # @param stream (see ChunkyPNG::Canvas::PNGDecoding#decode_png_pixelstream)
       # @param width (see ChunkyPNG::Canvas::PNGDecoding#decode_png_pixelstream)
@@ -143,19 +143,19 @@ module ChunkyPNG
         end
         canvas
       end
-      
+
       # Extract 4 consecutive bits from a byte.
       # @param [Integer] byte The byte (0..255) value to extract a 4 bit value from.
-      # @param [Integer] index The index within the byte. This should be either 0 or 2; 
+      # @param [Integer] index The index within the byte. This should be either 0 or 2;
       #        the value will be modded by 2 to enforce this.
       # @return [Integer] The extracted 4bit value (0..15)
       def decode_png_extract_4bit_value(byte, index)
         (index & 0x01 == 0) ? ((byte & 0xf0) >> 4) : (byte & 0x0f)
       end
-      
+
       # Extract 2 consecutive bits from a byte.
       # @param [Integer] byte The byte (0..255) value to extract a 2 bit value from.
-      # @param [Integer] index The index within the byte. This should be either 0, 1, 2, or 3; 
+      # @param [Integer] index The index within the byte. This should be either 0, 1, 2, or 3;
       #        the value will be modded by 4 to enforce this.
       # @return [Integer] The extracted 2 bit value (0..3)
       def decode_png_extract_2bit_value(byte, index)
@@ -165,49 +165,49 @@ module ChunkyPNG
 
       # Extract a bit from a byte on a given index.
       # @param [Integer] byte The byte (0..255) value to extract a bit from.
-      # @param [Integer] index The index within the byte. This should be 0..7; 
+      # @param [Integer] index The index within the byte. This should be 0..7;
       #        the value will be modded by 8 to enforce this.
       # @return [Integer] Either 1 or 0.
       def decode_png_extract_1bit_value(byte, index)
         bitshift = 7 - (index & 0x07)
         (byte & (0x01 << bitshift)) >> bitshift
       end
-      
+
       # Resamples a 16 bit value to an 8 bit value. This will discard some color information.
       # @param [Integer] value The 16 bit value to resample.
       # @return [Integer] The 8 bit resampled value
       def decode_png_resample_16bit_value(value)
         value >> 8
       end
-      
+
       # No-op - available for completeness sake only
       # @param [Integer] value The 8 bit value to resample.
       # @return [Integer] The 8 bit resampled value
       def decode_png_resample_8bit_value(value)
         value
       end
-      
+
       # Resamples a 4 bit value to an 8 bit value.
       # @param [Integer] value The 4 bit value to resample.
       # @return [Integer] The 8 bit resampled value.
       def decode_png_resample_4bit_value(value)
         value << 4 | value
       end
-      
+
       # Resamples a 2 bit value to an 8 bit value.
       # @param [Integer] value The 2 bit value to resample.
       # @return [Integer] The 8 bit resampled value.
       def decode_png_resample_2bit_value(value)
         value << 6 | value << 4 | value << 2 | value
       end
-      
+
       # Resamples a 1 bit value to an 8 bit value.
       # @param [Integer] value The 1 bit value to resample.
       # @return [Integer] The 8 bit resampled value
       def decode_png_resample_1bit_value(value)
         value == 0x01 ? 0xff : 0x00
       end
-      
+
 
       # Decodes a scanline of a 1-bit, indexed image into a row of pixels.
       # @param [String] stream The stream to decode from.
@@ -216,7 +216,7 @@ module ChunkyPNG
       # @return [Array<Integer>] An array of decoded pixels.
       def decode_png_pixels_from_scanline_indexed_1bit(stream, pos, width)
         (0...width).map do |index|
-          palette_pos = decode_png_extract_1bit_value(stream.getbyte(pos + 1 + (index >> 3)), index) 
+          palette_pos = decode_png_extract_1bit_value(stream.getbyte(pos + 1 + (index >> 3)), index)
           decoding_palette[palette_pos]
         end
       end
@@ -266,14 +266,14 @@ module ChunkyPNG
         end
         return pixels
       end
-      
+
       # Decodes a scanline of an 8-bit, true color image into a row of pixels.
       # @params (see #decode_png_pixels_from_scanline_indexed_1bit)
       # @return (see #decode_png_pixels_from_scanline_indexed_1bit)
       def decode_png_pixels_from_scanline_truecolor_8bit(stream, pos, width)
         stream.unpack("@#{pos + 1}" << ('NX' * width)).map { |c| c | 0x000000ff }
       end
-      
+
       # Decodes a scanline of a 16-bit, true color image into a row of pixels.
       # @params (see #decode_png_pixels_from_scanline_indexed_1bit)
       # @return (see #decode_png_pixels_from_scanline_indexed_1bit)
@@ -291,7 +291,7 @@ module ChunkyPNG
       def decode_png_pixels_from_scanline_grayscale_alpha_8bit(stream, pos, width)
         (0...width).map { |i| ChunkyPNG::Color.grayscale_alpha(stream.getbyte(pos + (i * 2) + 1), stream.getbyte(pos + (i * 2) + 2)) }
       end
-      
+
       # Decodes a scanline of a 16-bit, grayscale image with transparency into a row of pixels.
       # @params (see #decode_png_pixels_from_scanline_indexed_1bit)
       # @return (see #decode_png_pixels_from_scanline_indexed_1bit)
@@ -332,14 +332,14 @@ module ChunkyPNG
           ChunkyPNG::Color.grayscale(decode_png_resample_4bit_value(value))
         end
       end
-      
+
       # Decodes a scanline of an 8-bit, grayscale image into a row of pixels.
       # @params (see #decode_png_pixels_from_scanline_indexed_1bit)
       # @return (see #decode_png_pixels_from_scanline_indexed_1bit)
       def decode_png_pixels_from_scanline_grayscale_8bit(stream, pos, width)
         (1..width).map { |i| ChunkyPNG::Color.grayscale(stream.getbyte(pos + i)) }
       end
-      
+
       # Decodes a scanline of a 16-bit, grayscale image into a row of pixels.
       # @params (see #decode_png_pixels_from_scanline_indexed_1bit)
       # @return (see #decode_png_pixels_from_scanline_indexed_1bit)
@@ -347,7 +347,7 @@ module ChunkyPNG
         values = stream.unpack("@#{pos + 1}n#{width}")
         values.map { |value| ChunkyPNG::Color.grayscale(decode_png_resample_16bit_value(value)) }
       end
-      
+
       # Returns the method name to use to decode scanlines into pixels.
       # @param [Integer] color_mode The color mode of the image.
       # @param [Integer] depth The bit depth of the image.
@@ -362,12 +362,12 @@ module ChunkyPNG
           when ChunkyPNG::COLOR_GRAYSCALE_ALPHA; :"decode_png_pixels_from_scanline_grayscale_alpha_#{depth}bit"
           else nil
         end
-        
+
         raise ChunkyPNG::NotSupported, "No decoder found for color mode #{color_mode} and #{depth}-bit depth!" unless respond_to?(decoder_method, true)
         decoder_method
       end
 
-      # Decodes a single PNG image pass width a given width, height and color 
+      # Decodes a single PNG image pass width a given width, height and color
       # mode, to a Canvas, starting at the given position in the stream.
       #
       # A non-interlaced image only consists of one pass, while an Adam7
@@ -380,21 +380,21 @@ module ChunkyPNG
       # @param [Integer] start_pos The position in the pixel stream to start reading.
       # @return (see ChunkyPNG::Canvas::PNGDecoding#decode_png_pixelstream)
       def decode_png_image_pass(stream, width, height, color_mode, depth, start_pos)
-        
+
         pixels = []
         if width > 0 && height > 0
-          
+
           stream << ChunkyPNG::EXTRA_BYTE if color_mode == ChunkyPNG::COLOR_TRUECOLOR
           pixel_decoder = decode_png_pixels_from_scanline_method(color_mode, depth)
           line_length   = ChunkyPNG::Color.scanline_bytesize(color_mode, depth, width)
           pixel_size    = ChunkyPNG::Color.pixel_bytesize(color_mode, depth)
-          
+
           raise ChunkyPNG::ExpectationFailed, "Invalid stream length!" unless stream.bytesize - start_pos >= ChunkyPNG::Color.pass_bytesize(color_mode, depth, width, height)
 
           pos, prev_pos = start_pos, nil
-          for line_no in 0...height do
+          for _ in 0...height do
             decode_png_str_scanline(stream, pos, prev_pos, line_length, pixel_size)
-            pixels += send(pixel_decoder, stream, pos, width)
+            pixels.concat(send(pixel_decoder, stream, pos, width))
 
             prev_pos = pos
             pos += line_length + 1
@@ -404,9 +404,9 @@ module ChunkyPNG
         new(width, height, pixels)
       end
 
-      # Decodes a scanline if it was encoded using filtering. 
+      # Decodes a scanline if it was encoded using filtering.
       #
-      # It will extract the filtering method from the first byte of the scanline, and uses the 
+      # It will extract the filtering method from the first byte of the scanline, and uses the
       # method to change the subsequent bytes to unfiltered values. This will modify the pixelstream.
       #
       # The bytes of the scanline can then be used to construct pixels, based on the color mode..

data/lib/chunky_png/color.rb

@@ -589,7 +589,7 @@ module ChunkyPNG
     #    include_alpha=true (0-255)
     # @see http://en.wikipedia.org/wiki/HSL_and_HSV
     def to_hsv(color, include_alpha = false)
-      hue, chroma, max, min = hue_and_chroma(color)
+      hue, chroma, max, _ = hue_and_chroma(color)
       value      = max
       saturation = chroma.zero? ? 0.0 : chroma.fdiv(value)
 

data/lib/chunky_png/datastream.rb

@@ -74,7 +74,7 @@ module ChunkyPNG
         verify_signature!(io)
 
         ds = self.new
-        until io.eof?
+        while ds.end_chunk.nil?
           chunk = ChunkyPNG::Chunk.read(io)
           case chunk
             when ChunkyPNG::Chunk::Header;       ds.header_chunk = chunk

data/lib/chunky_png/version.rb

@@ -1,5 +1,5 @@
 module ChunkyPNG
   # The current version of ChunkyPNG.
   # Set it and commit the change this before running rake release.
-  VERSION = "1.3.5"
+  VERSION = "1.3.6"
 end

data/spec/chunky_png/datastream_spec.rb

@@ -17,6 +17,12 @@ describe ChunkyPNG::Datastream do
       stream = StringIO.new
       expect { ChunkyPNG::Datastream.from_io(stream) }.to raise_error(ChunkyPNG::SignatureMismatch)
     end
+
+    it "should read a stream with trailing data without failing" do
+      filename = resource_file('trailing_bytes_after_iend_chunk.png')
+      image = ChunkyPNG::Datastream.from_file(filename)
+      expect(image).to be_instance_of(ChunkyPNG::Datastream)
+    end
   end
 
   describe '#metadata' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chunky_png
 version: !ruby/object:Gem::Version
-  version: 1.3.5
+  version: 1.3.6
 platform: ruby
 authors:
 - Willem van Bergen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-28 00:00:00.000000000 Z
+date: 2016-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -60,7 +60,7 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.rdoc
+- README.md
 - BENCHMARKING.rdoc
 - CONTRIBUTING.rdoc
 - CHANGELOG.rdoc
@@ -73,7 +73,7 @@ files:
 - CONTRIBUTING.rdoc
 - Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - benchmarks/decoding_benchmark.rb
 - benchmarks/encoding_benchmark.rb
@@ -384,6 +384,7 @@ files:
 - spec/resources/rect.png
 - spec/resources/replaced.png
 - spec/resources/text_chunk.png
+- spec/resources/trailing_bytes_after_iend_chunk.png
 - spec/resources/ztxt_chunk.png
 - spec/spec_helper.rb
 - tasks/benchmarks.rake
@@ -413,7 +414,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.14
+rubygems_version: 2.0.14.1
 signing_key: 
 specification_version: 4
 summary: Pure ruby library for read/write, chunk-level access to PNG files
@@ -699,5 +700,6 @@ test_files:
 - spec/resources/rect.png
 - spec/resources/replaced.png
 - spec/resources/text_chunk.png
+- spec/resources/trailing_bytes_after_iend_chunk.png
 - spec/resources/ztxt_chunk.png
 - spec/spec_helper.rb

data/README.rdoc

@@ -1,84 +0,0 @@
-= Chunky PNG {<img src="https://travis-ci.org/wvanbergen/chunky_png.svg?branch=master" alt="Build Status" />}[https://travis-ci.org/wvanbergen/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:: http://github.com/wvanbergen/chunky_png/tree
-RDoc:: http://rdoc.info/gems/chunky_png/frames
-Wiki:: http://github.com/wvanbergen/chunky_png/wiki
-Issue tracker:: http://github.com/wvanbergen/chunky_png/issues
-
-== Features
-
-* Decodes any image that the PNG standard allows. This includes all standard
-  color modes, all bit depths 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 amount of used colors.
-* R/W access to the image's pixels.
-* R/W access to all image metadata that is stored in chunks.
-* Memory efficient (uses a Fixnum, i.e. 4 or 8 bytes of memory per pixel, depending
-  on the hardware)
-* Reasonably fast for Ruby standards, by only using integer math and a highly
-  optimized saving routine.
-* Interoperability with RMagick if you really have to.
-
-Also, have a look at OilyPNG at http://github.com/wvanbergen/oily_png. OilyPNG is a
-mixin module that implements some of the ChunkyPNG algorithms in C, which
-provides a massive speed boost to encoding and decoding.
-
-== Usage
-
-  require 'chunky_png'
-
-  # Creating an image from scratch, save as an interlaced PNG
-  png = ChunkyPNG::Image.new(16, 16, ChunkyPNG::Color::TRANSPARENT)
-  png[1,1] = ChunkyPNG::Color.rgba(10, 20, 30, 128)
-  png[2,1] = ChunkyPNG::Color('black @ 0.5')
-  png.save('filename.png', :interlace => true)
-
-  # 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', :fast_rgba) # Force the fast saving routine.
-
-  # Accessing metadata
-  image = ChunkyPNG::Image.from_file('with_metadata.png')
-  puts image.metadata['Title']
-  image.metadata['Author'] = 'Willem van Bergen'
-  image.save('with_metadata.png') # Overwrite file
-
-  # Low level access to PNG chunks
-  png_stream = ChunkyPNG::Datastream.from_file('filename.png')
-  png_stream.each_chunk { |chunk| p chunk.type }
-
-Also check out the screencast on the ChunkyPNG homepage by John Davison,
-which illustrates basic usage of the library on the ChunkyPNG website:
-http://chunkypng.com/
-
-For more information, see the project wiki on https://github.com/wvanbergen/chunky_png/wiki
-or the RDOC documentation on http://www.rubydoc.info/gems/chunky_png/frames
-
-== Security warning
-
-ChunkyPNG is vulnerable to decompression bombs, which means that ChunkyPNG is vulnerable to
-DOS attacks by running out of memory when loading a specifically crafted PNG file. Because
-of the pure-Ruby nature of the library it is very hard to fix this problem in the library
-itself.
-
-In order to safely deal with untrusted images, you should make sure to do the image
-processing using ChunkyPNG in a separate process, e.g. by using fork or a background
-processing library.
-
-== 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!
-
-Please check out CHANGELOG.rdoc to see what changed in all versions.
-
-P.S.: The name of this library is intentionally similar to Chunky Bacon and
-Chunky GIF. Use Google if you want to know _why. :-)