zpng 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99e5f2ae6f86a27757f442011a5fa365b06f4a4bf52c1348a6018bb0cc8b5f85
-  data.tar.gz: f435672e701c25224d5e61dba082131608567fbe14d86fbd4065495d460d2932
+  metadata.gz: 45cbe6009082c09bd91263c35aafcde94fe9a244f30999a8181a42cde9d8c591
+  data.tar.gz: bfb0767ed14b07544ca7159454b9dbe5ccdd404f98f7e293dddb52b13abf43aa
 SHA512:
-  metadata.gz: ce27f95e40b522d1dd854ecb4619650e22a6fc2b5bd4c9aee6c3247e5d32bf98da6778343645723359bb05872e33a68cad9ad08dbc2fae7c0f09c123d6567675
-  data.tar.gz: 3f9ea93a539c4ef1f16900eab6b9e4a8e8f2be7aceed695778cf296dd151df642e1da8b4bff3ff23f34aa560c660816d99d46d462d431547f32455fcfa7375e8
+  metadata.gz: f3929af614a96f549e331a65c15f210bc96bd52c5d88625d85156eb507773b89fc010d968ceddd25de213124db0dc935821dc02f255555eff4780ff20b87eb91
+  data.tar.gz: 1d5ab750a6f0aa24fe710ee53b53240d0b3a4335e3484c6c24eb99419413acc3701af9bd7aa5c3928b6971344e0759ee1843e5dbeed09004d06906ef5f9d0a4c

data/Gemfile

@@ -3,6 +3,7 @@ source "http://rubygems.org"
 # Example:
 #   gem "activesupport", ">= 2.3.5"
 gem 'rainbow', '~> 3.1.1'
+gem "iostruct", ">= 0.7.0"
 
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.

data/Gemfile.lock

@@ -1,13 +1,36 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    builder (3.2.4)
+    activesupport (7.1.6)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      mutex_m
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    base64 (0.3.0)
+    benchmark (0.5.0)
+    bigdecimal (4.0.1)
+    builder (3.3.0)
+    cgi (0.5.1)
+    concurrent-ruby (1.3.6)
+    connection_pool (2.5.5)
+    date (3.5.1)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
-    diff-lcs (1.5.0)
-    faraday (1.10.0)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    erb (4.0.4)
+      cgi (>= 0.3.3)
+    faraday (1.10.4)
       faraday-em_http (~> 1.0)
       faraday-em_synchrony (~> 1.0)
       faraday-excon (~> 1.1)
@@ -20,18 +43,20 @@ GEM
       faraday-retry (~> 1.0)
       ruby2_keywords (>= 0.0.4)
     faraday-em_http (1.0.0)
-    faraday-em_synchrony (1.0.0)
+    faraday-em_synchrony (1.0.1)
     faraday-excon (1.1.0)
     faraday-httpclient (1.0.1)
-    faraday-multipart (1.0.4)
-      multipart-post (~> 2)
-    faraday-net_http (1.0.1)
+    faraday-multipart (1.2.0)
+      multipart-post (~> 2.0)
+    faraday-net_http (1.0.2)
     faraday-net_http_persistent (1.2.0)
     faraday-patron (1.0.0)
     faraday-rack (1.0.0)
     faraday-retry (1.0.3)
-    git (1.13.1)
+    git (2.3.3)
+      activesupport (>= 5.0)
       addressable (~> 2.8)
+      process_executer (~> 1.1)
       rchardet (~> 1.8)
     github_api (0.19.0)
       addressable (~> 2.4)
@@ -40,7 +65,12 @@ GEM
       hashie (~> 3.5, >= 3.5.2)
       oauth2 (~> 1.0)
     hashie (3.6.0)
-    highline (2.0.3)
+    highline (3.1.2)
+      reline
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.2)
+    iostruct (0.7.0)
     juwelier (2.4.9)
       builder
       bundler
@@ -53,15 +83,19 @@ GEM
       rake
       rdoc
       semver2
-    jwt (2.4.1)
+    jwt (2.10.2)
+      base64
     kamelcase (0.0.2)
       semver2 (~> 3)
-    mini_portile2 (2.8.1)
-    multi_json (1.15.0)
+    logger (1.7.0)
+    mini_portile2 (2.8.9)
+    minitest (5.26.1)
+    multi_json (1.19.1)
     multi_xml (0.6.0)
-    multipart-post (2.2.3)
-    nokogiri (1.14.2)
-      mini_portile2 (~> 2.8.0)
+    multipart-post (2.4.1)
+    mutex_m (0.3.0)
+    nokogiri (1.17.2)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
     oauth2 (1.4.11)
       faraday (>= 0.17.3, < 3.0)
@@ -69,45 +103,56 @@ GEM
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (>= 1.2, < 4)
-    psych (4.0.4)
+    process_executer (1.1.2)
+    psych (5.3.1)
+      date
       stringio
-    public_suffix (4.0.7)
-    racc (1.6.2)
-    rack (3.0.4.1)
+    public_suffix (6.0.2)
+    racc (1.8.1)
+    rack (3.2.4)
     rainbow (3.1.1)
-    rake (13.0.6)
-    rchardet (1.8.0)
-    rdoc (6.4.0)
+    rake (13.3.1)
+    rchardet (1.10.0)
+    rdoc (7.1.0)
+      erb
       psych (>= 4.0.0)
+      tsort
+    reline (0.6.3)
+      io-console (~> 0.5)
     rspec (3.11.0)
       rspec-core (~> 3.11.0)
       rspec-expectations (~> 3.11.0)
       rspec-mocks (~> 3.11.0)
     rspec-core (3.11.0)
       rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
+    rspec-expectations (3.11.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.11.0)
-    rspec-its (1.3.0)
+    rspec-its (1.3.1)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.11.1)
+    rspec-mocks (3.11.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.11.0)
-    rspec-support (3.11.0)
+    rspec-support (3.11.1)
     ruby2_keywords (0.0.5)
+    securerandom (0.3.2)
     semver2 (3.4.2)
-    stringio (3.0.2)
+    stringio (3.2.0)
     thread_safe (0.3.6)
+    tsort (0.2.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  iostruct (>= 0.7.0)
   juwelier (~> 2.4.9)
   rainbow (~> 3.1.1)
   rspec (~> 3.11.0)
   rspec-its (~> 1.3.0)
 
 BUNDLED WITH
-   2.3.12
+   2.4.22

data/VERSION

@@ -1 +1 @@
-0.4.5
+0.4.6

data/lib/zpng/bmp/reader.rb

@@ -1,22 +1,27 @@
+# -*- coding:binary; frozen_string_literal: true -*-
+require 'iostruct'
+
 module ZPNG
   module BMP
 
-    class BITMAPFILEHEADER < ReadableStruct.new 'VvvV', #a2VvvV',
-      #:bfType,
-      :bfSize,      # the size of the BMP file in bytes
+    MAGIC = "BM"
+
+    class BITMAPFILEHEADER < IOStruct.new 'VvvV',
+      #:bfType,         # read separately as magic bytes
+      :bfSize,          # the size of the BMP file in bytes
       :bfReserved1,
       :bfReserved2,
-      :bfOffBits    # imagedata offset
+      :bfOffBits        # imagedata offset
 
       def inspect
         "<" + super.partition(self.class.to_s.split('::').last)[1..-1].join
       end
     end
 
-    class BITMAPINFOHEADER < ReadableStruct.new 'V3v2V6',
+    class BITMAPINFOHEADER < IOStruct.new 'Vl2v2V2l2V2',  # l2 for signed width/height and pels/meter
       :biSize,          # BITMAPINFOHEADER::SIZE
-      :biWidth,
-      :biHeight,
+      :biWidth,         # can be negative for top-down DIB
+      :biHeight,        # can be negative for top-down DIB
       :biPlanes,
       :biBitCount,
       :biCompression,

data/lib/zpng/cli.rb

@@ -177,11 +177,11 @@ module ZPNG
 
     def info
       color = %w'COLOR_GRAYSCALE COLOR_RGB COLOR_INDEXED COLOR_GRAY_ALPHA COLOR_RGBA'.find do |k|
-        @img.hdr.color == ZPNG.const_get(k)
+        @img.hdr&.color == ZPNG.const_get(k)
       end
       puts "[.] image size #{@img.width || '?'}x#{@img.height || '?'}, #{@img.bpp || '?'}bpp, #{color}"
       puts "[.] palette = #{@img.palette}" if @img.palette
-      puts "[.] uncompressed imagedata size = #{@img.imagedata_size || '?'} bytes"
+      puts "[.] uncompressed imagedata size = #{@img.imagedata_size} bytes" if @img.imagedata_size.to_i > 0
       _conditional_hexdump(@img.imagedata, 3) if @options[:verbose] > 0
     end
 

data/lib/zpng/color.rb

@@ -6,6 +6,8 @@ module ZPNG
 
     include DeepCopyable
 
+    MAX_VALUES = 17.times.map{ |x| (2**x)-1 }.freeze
+
     def initialize *a
       h = a.last.is_a?(Hash) ? a.pop : {}
       @r,@g,@b,@a = *a
@@ -14,11 +16,15 @@ module ZPNG
       @depth       = h[:depth]       || 8
 
       # default ALPHA = 0xff - opaque
-      @a ||= h[:alpha] || h[:a] || (2**@depth-1)
+      @a ||= h[:alpha] || h[:a] || max_value
+    end
+
+    def max_value
+      MAX_VALUES[@depth]
     end
 
     def a= a
-      @a = a || (2**@depth-1)   # NULL alpha means fully opaque
+      @a = a || max_value   # NULL alpha means fully opaque
     end
     alias :alpha  :a
     alias :alpha= :a=
@@ -64,8 +70,7 @@ module ZPNG
     end
 
     def white?
-      max = 2**depth-1
-      r == max && g == max && b == max
+      r == max_value && g == max_value && b == max_value
     end
 
     def black?
@@ -77,7 +82,7 @@ module ZPNG
     end
 
     def opaque?
-      a.nil? || a == 2**depth-1
+      a.nil? || a == max_value
     end
 
     def to_grayscale
@@ -135,7 +140,7 @@ module ZPNG
     # try to convert to one pseudographics ASCII character
     def to_ascii map=ASCII_MAP
       #p self
-      map[self.to_grayscale*(map.size-1)/(2**@depth-1), 1]
+      map[self.to_grayscale*(map.size-1)/max_value, 1]
     end
 
     # convert to ANSI color name
@@ -162,7 +167,7 @@ module ZPNG
       color = Color.new :depth => new_depth
       if new_depth > self.depth
         %w'r g b a'.each do |part|
-          color.send("#{part}=", (2**new_depth-1)/(2**depth-1)*self.send(part))
+          color.send("#{part}=", (2**new_depth-1)/max_value*self.send(part))
         end
       else
         # new_depth < self.depth
@@ -242,27 +247,96 @@ module ZPNG
     end
 
     # Op! op! op! Op!! Oppan Gangnam Style!!
-    def op op, c=nil
-      # XXX what to do with alpha?
-      max = 2**depth-1
+    def op op, c=nil, op2=:&
+      # alpha is kept from 1st color
       if c
         c = c.to_depth(depth)
         Color.new(
-          @r.send(op, c.r) & max,
-          @g.send(op, c.g) & max,
-          @b.send(op, c.b) & max,
-          :depth => self.depth
+          @r.send(op, c.r).send(op2, max_value),
+          @g.send(op, c.g).send(op2, max_value),
+          @b.send(op, c.b).send(op2, max_value),
+#          [0, [@r.send(op, c.r), max_value].min].max,
+#          [0, [@g.send(op, c.g), max_value].min].max,
+#          [0, [@b.send(op, c.b), max_value].min].max,
+          depth: depth,
+          alpha: alpha
         )
       else
         Color.new(
-          @r.send(op) & max,
-          @g.send(op) & max,
-          @b.send(op) & max,
-          :depth => self.depth
+          @r.send(op).send(op2, max_value),
+          @g.send(op).send(op2, max_value),
+          @b.send(op).send(op2, max_value),
+#          [0, [@r.send(op), max_value].min].max,
+#          [0, [@g.send(op), max_value].min].max,
+#          [0, [@b.send(op), max_value].min].max,
+          depth: depth,
+          alpha: alpha
         )
       end
     end
 
+    # multiplies the pixel values of the upper layer with those of the layer below it and then divides the result by MAX_VALUE
+    def * c
+      c = c.to_depth(depth)
+      Color.new(
+        (@r * c.r) / max_value,
+        (@g * c.g) / max_value,
+        (@b * c.b) / max_value,
+        depth: depth,
+        alpha: alpha
+      )
+    end
+
+    def / c
+      c = c.to_depth(depth)
+      Color.new(
+        [max_value, (max_value*@r/c.r)].min,
+        [max_value, (max_value*@g/c.g)].min,
+        [max_value, (max_value*@b/c.b)].min,
+#        (max_value*@r/c.r),
+#        (max_value*@g/c.g),
+#        (max_value*@b/c.b),
+        depth: depth,
+        alpha: alpha
+      )
+    rescue ZeroDivisionError
+      c = c.dup
+      c.r = 1 if c.r == 0 # XXX or it should be max_value ?
+      c.g = 1 if c.g == 0
+      c.b = 1 if c.b == 0
+      return Color.new(
+        [max_value, (max_value*@r/c.r)].min,
+        [max_value, (max_value*@g/c.g)].min,
+        [max_value, (max_value*@b/c.b)].min,
+        depth: depth,
+        alpha: alpha
+      )
+    end
+
+    def divmul c1, c2
+      c1 = c1.to_depth(depth)
+      c2 = c2.to_depth(depth)
+      Color.new(
+        [max_value, (c2.r*@r/c1.r)].min,
+        [max_value, (c2.g*@g/c1.g)].min,
+        [max_value, (c2.b*@b/c1.b)].min,
+        depth: depth,
+        alpha: alpha
+      )
+    end
+
+    # http://www.pegtop.net/delphi/articles/blendmodes/screen.htm
+    def screen c
+      c = c.to_depth(depth)
+      Color.new(
+        max_value - (((max_value-@r) * (max_value-c.r)) >> depth),
+        max_value - (((max_value-@g) * (max_value-c.g)) >> depth),
+        max_value - (((max_value-@b) * (max_value-c.b)) >> depth),
+        depth: depth,
+        alpha: alpha
+      )
+    end
+
     # for Array.uniq()
     def hash
       self.to_i

data/lib/zpng/image.rb

@@ -1,8 +1,9 @@
+# -*- coding:binary; frozen_string_literal: true -*-
 require 'stringio'
 
 module ZPNG
   class Image
-    attr_accessor :chunks, :scanlines, :imagedata, :extradata, :format, :verbose
+    attr_accessor :chunks, :scanlines, :extradata, :format, :verbose
 
     # now only for (limited) BMP support
     attr_accessor :color_class
@@ -12,15 +13,21 @@ module ZPNG
     alias :dup   :deep_copy
 
     include BMP::Reader
+    include JPEG::Reader
 
-    PNG_HDR = "\x89PNG\x0d\x0a\x1a\x0a".force_encoding('binary')
-    BMP_HDR = "BM".force_encoding('binary')
+    PNG_HDR = "\x89PNG\x0d\x0a\x1a\x0a"
 
     # possible input params:
     #   IO      of opened image file
     #   String  with image file already readed
     #   Hash    of image parameters to create new blank image
+    #   width, height
     def initialize x, h={}
+      if x.is_a?(Numeric) && h.is_a?(Numeric)
+        x = { width: x, height: h }
+        h = {}
+      end
+
       @chunks = []
       @extradata = []
       @color_class = Color
@@ -74,6 +81,18 @@ module ZPNG
       end
       alias :load_file :load
       alias :from_file :load # as in ChunkyPNG
+
+      def from_rgb data, width:, height:
+        img = new(width: width, height: height, bpp: 24)
+        img.scanlines = height.times.map{ |i| ScanLine.new(img, i, decoded_bytes: data[width*3*i, width*3]) }
+        img
+      end
+
+      def from_rgba data, width:, height:
+        img = new(width: width, height: height, bpp: 32)
+        img.scanlines = height.times.map{ |i| ScanLine.new(img, i, decoded_bytes: data[width*4*i, width*4]) }
+        img
+      end
     end
 
     # save image to file
@@ -154,11 +173,13 @@ module ZPNG
       # Once a stream is in binary mode, it cannot be reset to nonbinary mode.
       io.binmode
 
-      hdr = io.read(BMP_HDR.size)
-      if hdr == BMP_HDR
+      hdr = io.read(BMP::MAGIC.size)
+      if hdr == BMP::MAGIC
         _read_bmp io
+      elsif hdr == JPEG::MAGIC
+        _read_jpeg io
       else
-        hdr << io.read(PNG_HDR.size - BMP_HDR.size)
+        hdr << io.read(PNG_HDR.size - BMP::MAGIC.size)
         if hdr == PNG_HDR
           _read_png io
         else
@@ -276,7 +297,7 @@ module ZPNG
     # on errors keep going and try to return maximum possible data
     def _safe_inflate data
       zi = Zlib::Inflate.new
-      pos = 0; r = ''
+      pos = 0; r = String.new
       begin
         # save some memory by not using String#[] when not necessary
         r << zi.inflate(pos==0 ? data : data[pos..-1])
@@ -326,6 +347,11 @@ module ZPNG
         end
     end
 
+    def imagedata= data
+      @scanlines = nil
+      @imagedata = data
+    end
+
     def imagedata_size
       if new_image?
         @scanlines.map(&:size).inject(&:+)
@@ -409,6 +435,18 @@ module ZPNG
       end
     end
 
+    def to_ansi wide: false
+      spc = wide ? "  " : " "
+      r = String.new
+      height.times do |y|
+        width.times do |x|
+          r << spc.background(self[x,y].to_ansi)
+        end
+        r << "\n"
+      end
+      r
+    end
+
     def extract_block x,y=nil,w=nil,h=nil
       if x.is_a?(Hash)
         Block.new(self,x[:x], x[:y], x[:width], x[:height])
@@ -487,11 +525,10 @@ module ZPNG
     end
 
     # returns new image
-    def crop params
-      decode_all_scanlines
-      # deep copy first, then crop!
-      deep_copy.crop!(params)
+    def cropped **args
+      dup.crop!(**args)
     end
+    alias crop cropped
 
     def pixels
       Pixels.new(self)
@@ -547,5 +584,133 @@ module ZPNG
 
       new_img
     end
+
+    def _normalize_rotate x
+      x = x.to_i
+      x %= 360
+      x += 360 if x < 0
+      raise "invalid rotate: #{x}" if x%90 != 0
+      x
+    end
+
+    # always returns a copy
+    def rotated degrees
+      degrees = _normalize_rotate(degrees)
+      return dup if degrees == 0
+
+      dst = self
+      while degrees > 0
+        dst = dst.rotated_90_cw
+        degrees -= 90
+      end
+      dst
+    end
+
+    # returns new image rotated 90 degrees clockwise
+    def rotated_90_cw
+      dst = Image.new(width: height, height: width, bpp: bpp)
+      each_pixel do |c,x,y|
+        dst[height-y-1,x] = c
+      end
+      dst
+    end
+
+    def copy_from(src, copy_transparent: false,
+                  src_x: 0, src_y: 0, src_width: src.width, src_height: src.height,
+                  dst_x: 0, dst_y: 0, dst_width: src_width, dst_height: src_height)
+
+      dst_height.times do |iy|
+        dy = dst_y + iy
+        next if dy >= height
+        sy = src_y + iy * src_height / dst_height
+        next if sy >= src.height
+        dst_width.times do |ix|
+          dx = dst_x + ix
+          next if dx >= width
+          sx = src_x + ix * src_width / dst_width
+          next if sx >= src.width
+          c = src[sx,sy]
+          next if c.transparent? && !copy_transparent
+          self[dx,dy] = c
+        end
+      end
+      self
+    end
+
+    # op is a symbol of operation, like :+, :-, :* ...
+    def op_from(src, op,
+                  src_x: 0, src_y: 0, src_width: src.width, src_height: src.height,
+                  dst_x: 0, dst_y: 0, dst_width: src_width, dst_height: src_height)
+
+      dst_height.times do |iy|
+        dy = dst_y + iy
+        next if dy >= height
+        sy = src_y + iy * src_height / dst_height
+        next if sy >= src.height
+        dst_width.times do |ix|
+          dx = dst_x + ix
+          next if dx >= width
+          sx = src_x + ix * src_width / dst_width
+          next if sx >= src.width
+          c = src[sx,sy]
+          self[dx,dy] = self[dx,dy].send(op, c)
+        end
+      end
+      self
+    end
+
+    def scale(x, y=x)
+      dst = Image.new(width: width*x, height: height*y, bpp: bpp)
+      dst.copy_from(self, dst_width: dst.width, dst_height: dst.height)
+    end
+
+    alias scaled scale
+
+    def shear(mx, my)
+      src = self
+      dst = Image.new(width: width+(mx*height).abs, height: height+(my*width).abs, bpp: bpp)
+      xadd = mx < 0 ? src.height: 0
+      yadd = my < 0 ? src.width : 0
+      each_pixel do |c,x,y|
+        dst[xadd + (x+mx*y).to_i, yadd + (y+my*x).to_i] = c
+      end
+      dst
+    end
+
+    def empty?
+      pixels.all?(&:transparent?)
+    end
+
+    def * value; op(:*, value); end
+    def / value; op(:/, value); end
+    def + value; op(:+, value); end
+    def - value; op(:-, value); end
+
+    def op op, value
+      case value
+      when Image
+        dst = Image.new(width: width, height: height, bpp: bpp)
+        each_pixel do |c,x,y|
+          dst[x,y] = c.send(op, value[x,y])
+        end
+        dst
+      when Color
+        dst = Image.new(width: width, height: height, bpp: bpp)
+        each_pixel do |c,x,y|
+          dst[x,y] = c.send(op, value)
+        end
+        dst
+      else
+        raise ArgumentError, "cannot #{op} Image by #{value}"
+      end
+    end
+
+    def divmul c1, c2
+      dst = Image.new(width: width, height: height, bpp: bpp)
+      each_pixel do |c,x,y|
+        dst[x,y] = c.divmul(c1, c2)
+      end
+      dst
+    end
   end
 end

data/lib/zpng/jpeg/chunks.rb

@@ -0,0 +1,164 @@
+# -*- coding:binary; frozen_string_literal: true -*-
+
+module ZPNG
+  module JPEG
+
+    class Chunk
+      attr_accessor :marker, :size, :data
+
+      def initialize marker, io
+        @marker = marker
+        @size = io.read(2).unpack('n')[0]
+        @data = io.read(@size-2)
+      end
+
+      def type
+        r = self.class.name.split("::").last.ljust(4)
+        r = "ch_%02X" % @marker[1].ord if r == "Chunk"
+        r
+      end
+
+      def crc
+        :no_crc
+      end
+
+      def inspect *args
+        size = @size ? sprintf("%6d",@size) : sprintf("%6s","???")
+        sprintf "<%4s size=%s >", type, size
+      end
+
+      def export *args
+        @marker + [@size].pack('n') + @data
+      end
+    end
+
+    class APP < Chunk
+      attr_accessor :name
+
+      # BYTE Version[2];      /* 07h  JFIF Format Revision      */
+      # BYTE Units;           /* 09h  Units used for Resolution */
+      # BYTE Xdensity[2];     /* 0Ah  Horizontal Resolution     */
+      # BYTE Ydensity[2];     /* 0Ch  Vertical Resolution       */
+      # BYTE XThumbnail;      /* 0Eh  Horizontal Pixel Count    */
+      # BYTE YThumbnail;      /* 0Fh  Vertical Pixel Count      */
+      class JFIF < IOStruct.new( 'vCnnCC', :version, :units, :xdensity, :ydensity, :xthumbnail, :ythumbnail )
+        def inspect *args
+          r = "<" + super.split(' ',3).last
+          r.sub!(/version=\d+/, "version=#{version >> 8}.#{version & 0xff}") if version
+          r
+        end
+      end
+
+      def initialize marker, io
+        super
+        @id  = marker[1].ord & 0xf
+        @name = @data.unpack('Z*')[0]
+        if @name == 'JFIF'
+          @jfif = JFIF.read(@data[5..-1])
+          # TODO: read thumbnail, see https://en.wikipedia.org/wiki/JPEG_File_Interchange_Format
+        end
+      end
+
+      def type
+        "APP#{@id}"
+      end
+
+      def inspect *args
+        r = super.chop + ("name=%s >" % name.inspect)
+        if @jfif
+          r = r.chop + ("jfif=%s>" % @jfif.inspect)
+        end
+        r
+      end
+    end
+
+    class SOF < Chunk
+      def initialize marker, io
+        super
+        @id = marker[1].ord & 0xf
+      end
+
+      def type
+        "SOF#{@id}"
+      end
+    end
+
+    class SOF0 < SOF
+      attr_accessor :bpp, :width, :height, :components
+      attr_accessor :color # for compatibility with IHDR
+
+      def initialize marker, io
+        super
+        @bpp, @height, @width, @components = @data.unpack('CnnC')
+      end
+
+      def inspect *args
+        super.chop + ("bpp=%d width=%d height=%d components=%d >" % [bpp, width, height, components])
+      end
+    end
+
+    class SOF2 < SOF
+      attr_accessor :precision, :width, :height, :components
+      attr_accessor :color # for compatibility with IHDR
+
+      def initialize marker, io
+        super
+        @precision, @height, @width, @components = @data.unpack('CnnC')
+      end
+
+      def bpp
+        precision
+      end
+
+      def inspect *args
+        super.chop + ("precision=%d width=%d height=%d components=%d >" % [precision, width, height, components])
+      end
+    end
+
+    class DHT < Chunk
+      attr_accessor :id, :lengths, :values
+
+      def initialize marker, io
+        super
+        @id, *@lengths = @data.unpack("CC16")
+        @values = @data.unpack("x17C" + @lengths.inject(:+).to_s)
+      end
+
+      def inspect verbose = 0
+        r = super.chop + ("id=%02x lengths=%s >" % [id, lengths.inspect])
+        r = r.chop + ("values=%s >" % [values.inspect]) if verbose > 0
+        r
+      end
+    end
+
+    class SOS < Chunk; end
+    class DRI < Chunk; end
+    class DQT < Chunk; end
+    class DAC < Chunk; end
+
+    class COM < Chunk
+      def inspect *args
+        super.chop + ("data=%s>" % data.inspect)
+      end
+    end
+
+    # Its length is unknown in advance, nor defined in the file.
+    # The only way to get its length is to either decode it or to fast-forward over it:
+    # just scan forward for a FF byte. If it's a restart marker (followed by D0 - D7) or a data FF (followed by 00), continue.
+    class ECS < Chunk
+      def initialize io
+        @data = io.read
+        if (pos = @data.index(/\xff[^\x00\xd0-\xd7]/))
+          io.seek(pos-@data.size, :CUR) # seek back
+          @data = @data[0, pos]
+        end
+        @size = @data.size
+      end
+
+      def export *args
+        @data
+      end
+    end
+
+  end
+end

data/lib/zpng/jpeg/reader.rb

@@ -0,0 +1,55 @@
+# -*- coding:binary; frozen_string_literal: true -*-
+
+# https://github.com/corkami/formats/blob/master/image/jpeg.md
+# https://docs.fileformat.com/image/jpeg/
+# https://www.file-recovery.com/jpg-signature-format.htm
+# https://exiftool.org/TagNames/JPEG.html
+
+module ZPNG
+  module JPEG
+
+    SOI = "\xff\xd8" # Start of Image
+    EOI = "\xff\xd9" # End of Image
+
+    MAGIC = SOI
+
+    module Reader
+      def _read_jpeg io
+        @format = :jpeg
+
+        while !io.eof?
+          marker = io.read(2)
+          break if marker == EOI
+
+          case marker[1].ord
+          when 0xc0
+            @chunks << (@ihdr=SOF0.new(marker, io))
+          when 0xc2
+            @chunks << (@ihdr=SOF2.new(marker, io))
+          when 0xc4
+            @chunks << DHT.new(marker, io)
+          when 0xcc
+            @chunks << DAC.new(marker, io)
+          when 0xc1..0xcf
+            @chunks << SOF.new(marker, io)
+          when 0xda
+            @chunks << SOS.new(marker, io)
+            # Entropy-Coded Segment starts
+            @chunks << ECS.new(io)
+          when 0xdb
+            @chunks << DQT.new(marker, io)
+          when 0xdd
+            @chunks << DRI.new(marker, io)
+          when 0xe0..0xef
+            @chunks << APP.new(marker, io)
+          when 0xfe
+            @chunks << COM.new(marker, io)
+          else
+            $stderr.puts "[?] Unknown JPEG marker #{marker.inspect}".yellow
+            @chunks << Chunk.new(marker, io)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zpng.rb

@@ -16,11 +16,12 @@ require 'zpng/scan_line'
 require 'zpng/scan_line/mixins'
 require 'zpng/chunk'
 require 'zpng/text_chunk'
-require 'zpng/readable_struct'
 require 'zpng/adam7_decoder'
 require 'zpng/hexdump'
 require 'zpng/metadata'
 require 'zpng/pixels'
 
 require 'zpng/bmp/reader'
+require 'zpng/jpeg/chunks'
+require 'zpng/jpeg/reader'
 require 'zpng/image'

data/spec/cli_spec.rb

@@ -1,8 +1,6 @@
 require File.expand_path(File.join(File.dirname(__FILE__), '/spec_helper'))
 require 'zpng/cli'
 
-CLI_PATHNAME = File.expand_path(File.join(File.dirname(__FILE__), '/../bin/zpng'))
-
 describe "CLI" do
   PNGSuite.each_good do |fname|
     describe fname.sub(%r|\A#{Regexp::escape(Dir.getwd)}/?|, '') do

data/spec/image_spec.rb

@@ -1,51 +1,126 @@
+# coding: binary
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 NEW_IMG_WIDTH  = 20
 NEW_IMG_HEIGHT = 10
 
 describe ZPNG::Image do
-  describe "new" do
-    let!(:img){ ZPNG::Image.new :width => NEW_IMG_WIDTH, :height => NEW_IMG_HEIGHT }
+
+  shared_examples "exported image" do |bpp=32|
+    let(:eimg){ img.export }
+    let(:img2){ ZPNG::Image.new(eimg) }
+
+    it "has PNG header" do
+      eimg.should start_with(ZPNG::Image::PNG_HDR)
+    end
+
+    describe "parsed again" do
+      it "is a ZPNG::Image" do
+        img2.should be_instance_of(ZPNG::Image)
+      end
+
+      it "should be of specified size" do
+        img2.width.should  == NEW_IMG_WIDTH
+        img2.height.should == NEW_IMG_HEIGHT
+      end
+
+      it "should have bpp = #{bpp}" do
+        img2.hdr.bpp.should == bpp
+      end
+
+      it "should have 3 chunks: IHDR, IDAT, IEND" do
+        img2.chunks.map(&:type).should == %w'IHDR IDAT IEND'
+      end
+
+    end
+  end
+
+  describe ".new" do
+    let(:img){ ZPNG::Image.new :width => NEW_IMG_WIDTH, :height => NEW_IMG_HEIGHT }
 
     it "returns ZPNG::Image" do
       img.should be_instance_of(ZPNG::Image)
     end
+
     it "creates new image of specified size" do
       img.width.should  == NEW_IMG_WIDTH
       img.height.should == NEW_IMG_HEIGHT
     end
 
-    describe "exported image" do
-      let!(:eimg){ img.export }
-      it "has PNG header" do
-        eimg.should start_with(ZPNG::Image::PNG_HDR)
+    include_examples "exported image" do
+      it "should have all pixels transparent" do
+        NEW_IMG_HEIGHT.times do |y|
+          NEW_IMG_WIDTH.times do |x|
+            img2[x,y].should be_transparent
+          end
+        end
       end
+    end
 
-      describe "parsed again" do
-        let!(:img2){ ZPNG::Image.new(eimg) }
-
-        it "is a ZPNG::Image" do
-          img2.should be_instance_of(ZPNG::Image)
+    describe "setting imagedata" do
+      before do
+        imagedata_size = NEW_IMG_WIDTH * NEW_IMG_HEIGHT * 4
+        imagedata = "\x00" * imagedata_size
+        imagedata_size.times do |i|
+          imagedata.setbyte(i, i & 0xff)
         end
+        img.imagedata = imagedata
+      end
 
-        it "should be of specified size" do
-          img2.width.should  == NEW_IMG_WIDTH
-          img2.height.should == NEW_IMG_HEIGHT
+      include_examples "exported image" do
+        it "should not have all pixels transparent" do
+          skip "TBD"
+          NEW_IMG_HEIGHT.times do |y|
+            NEW_IMG_WIDTH.times do |x|
+              img2[x,y].should_not be_transparent
+            end
+          end
         end
+      end
+    end
 
-        it "should have bpp = 32" do
-          img2.hdr.bpp.should == 32
-        end
+  end
+
+  describe ".from_rgb" do
+    before do
+      data_size = NEW_IMG_WIDTH * NEW_IMG_HEIGHT * 3
+      @data = "\x00" * data_size
+      data_size.times do |i|
+        @data.setbyte(i, i & 0xff)
+      end
+    end
+
+    let(:img){ ZPNG::Image.from_rgb(@data, width: NEW_IMG_WIDTH, height: NEW_IMG_HEIGHT) }
 
-        it "should have 3 chunks: IHDR, IDAT, IEND" do
-          img2.chunks.map(&:type).should == %w'IHDR IDAT IEND'
+    include_examples "exported image", 24 do
+      it "should have pixels from passed data" do
+        i = (0..255).cycle
+        NEW_IMG_HEIGHT.times do |y|
+          NEW_IMG_WIDTH.times do |x|
+            img2[x,y].should == ZPNG::Color.new(i.next, i.next, i.next)
+          end
         end
+      end
+    end
+  end
 
-        it "should have all pixels transparent" do
-          NEW_IMG_HEIGHT.times do |y|
-            NEW_IMG_WIDTH.times do |x|
-              img2[x,y].should be_transparent
-            end
+  describe ".from_rgba" do
+    before do
+      data_size = NEW_IMG_WIDTH * NEW_IMG_HEIGHT * 4
+      @data = "\x00" * data_size
+      data_size.times do |i|
+        @data.setbyte(i, i & 0xff)
+      end
+    end
+
+    let(:img){ ZPNG::Image.from_rgba(@data, width: NEW_IMG_WIDTH, height: NEW_IMG_HEIGHT) }
+
+    include_examples "exported image" do
+      it "should have pixels from passed data" do
+        i = (0..255).cycle
+        NEW_IMG_HEIGHT.times do |y|
+          NEW_IMG_WIDTH.times do |x|
+            img2[x,y].should == ZPNG::Color.new(i.next, i.next, i.next, i.next)
           end
         end
       end

data/spec/rotate_spec.rb

@@ -0,0 +1,62 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+ROTATE_SAMPLE = File.join(SAMPLES_DIR, "captcha_4bpp.png")
+
+include ZPNG
+
+describe Image do
+  describe "#rotated_90_cw" do
+    it "rotates and keeps original image unchanged" do
+      src = Image.load(ROTATE_SAMPLE)
+      src2 = Image.load(ROTATE_SAMPLE)
+      dst = src.rotated_90_cw
+
+      dst.width.should  == src.height
+      dst.height.should == src.width
+
+      dst.width.should_not  == src.width
+      dst.height.should_not == src.height
+
+      src.export.should == src2.export
+      src.export.should_not == dst.export
+      src2.export.should_not == dst.export
+
+      dst.should == Image.load(File.join(SAMPLES_DIR, "captcha_4bpp_rotated90.png"))
+    end
+  end
+
+  describe "#rotated" do
+    0.step(360, 90) do |angle|
+      it "rotates #{angle} degrees and keeps original image unchanged" do
+        src = Image.load(ROTATE_SAMPLE)
+        src2 = Image.load(ROTATE_SAMPLE)
+        dst = src.rotated(angle)
+        dst.save(File.join(SAMPLES_DIR, "captcha_4bpp_rotated#{angle}.png"))
+
+        if angle % 180 == 0
+          dst.width.should  == src.width
+          dst.height.should == src.height
+        else
+          dst.width.should  == src.height
+          dst.height.should == src.width
+
+          dst.width.should_not  == src.width
+          dst.height.should_not == src.height
+        end
+
+        src.export.should == src2.export
+
+        if angle % 360 == 0
+          src.export == dst.export
+          src2.export == dst.export
+        else
+          src.export.should_not == dst.export
+          src2.export.should_not == dst.export
+        end
+
+        src = Image.load(angle % 360 == 0 ? ROTATE_SAMPLE : File.join(SAMPLES_DIR, "captcha_4bpp_rotated#{angle}.png"))
+        dst.should == src
+      end
+    end
+  end
+end

data/zpng.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: zpng 0.4.5 ruby lib
+# stub: zpng 0.4.6 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "zpng".freeze
-  s.version = "0.4.5"
+  s.version = "0.4.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Andrey \"Zed\" Zaikin".freeze]
-  s.date = "2023-02-19"
+  s.date = "2026-01-28"
   s.email = "zed.0xff@gmail.com".freeze
   s.executables = ["zpng".freeze]
   s.extra_rdoc_files = [
@@ -42,9 +42,10 @@ Gem::Specification.new do |s|
     "lib/zpng/deep_copyable.rb",
     "lib/zpng/hexdump.rb",
     "lib/zpng/image.rb",
+    "lib/zpng/jpeg/chunks.rb",
+    "lib/zpng/jpeg/reader.rb",
     "lib/zpng/metadata.rb",
     "lib/zpng/pixels.rb",
-    "lib/zpng/readable_struct.rb",
     "lib/zpng/scan_line.rb",
     "lib/zpng/scan_line/mixins.rb",
     "lib/zpng/string_ext.rb",
@@ -68,6 +69,7 @@ Gem::Specification.new do |s|
     "spec/modify_spec.rb",
     "spec/pixel_access_spec.rb",
     "spec/pixels_enumerator_spec.rb",
+    "spec/rotate_spec.rb",
     "spec/running_pixel_spec.rb",
     "spec/set_random_pixel_spec.rb",
     "spec/spec_helper.rb",
@@ -76,7 +78,7 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "http://github.com/zed-0xff/zpng".freeze
   s.licenses = ["MIT".freeze]
-  s.rubygems_version = "3.3.7".freeze
+  s.rubygems_version = "3.2.33".freeze
   s.summary = "pure ruby PNG file manipulation & validation".freeze
 
   if s.respond_to? :specification_version then
@@ -85,11 +87,13 @@ Gem::Specification.new do |s|
 
   if s.respond_to? :add_runtime_dependency then
     s.add_runtime_dependency(%q<rainbow>.freeze, ["~> 3.1.1"])
+    s.add_runtime_dependency(%q<iostruct>.freeze, [">= 0.7.0"])
     s.add_development_dependency(%q<rspec>.freeze, ["~> 3.11.0"])
     s.add_development_dependency(%q<rspec-its>.freeze, ["~> 1.3.0"])
     s.add_development_dependency(%q<juwelier>.freeze, ["~> 2.4.9"])
   else
     s.add_dependency(%q<rainbow>.freeze, ["~> 3.1.1"])
+    s.add_dependency(%q<iostruct>.freeze, [">= 0.7.0"])
     s.add_dependency(%q<rspec>.freeze, ["~> 3.11.0"])
     s.add_dependency(%q<rspec-its>.freeze, ["~> 1.3.0"])
     s.add_dependency(%q<juwelier>.freeze, ["~> 2.4.9"])

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zpng
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - Andrey "Zed" Zaikin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-19 00:00:00.000000000 Z
+date: 2026-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 3.1.1
+- !ruby/object:Gem::Dependency
+  name: iostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -98,9 +112,10 @@ files:
 - lib/zpng/deep_copyable.rb
 - lib/zpng/hexdump.rb
 - lib/zpng/image.rb
+- lib/zpng/jpeg/chunks.rb
+- lib/zpng/jpeg/reader.rb
 - lib/zpng/metadata.rb
 - lib/zpng/pixels.rb
-- lib/zpng/readable_struct.rb
 - lib/zpng/scan_line.rb
 - lib/zpng/scan_line/mixins.rb
 - lib/zpng/string_ext.rb
@@ -124,6 +139,7 @@ files:
 - spec/modify_spec.rb
 - spec/pixel_access_spec.rb
 - spec/pixels_enumerator_spec.rb
+- spec/rotate_spec.rb
 - spec/running_pixel_spec.rb
 - spec/set_random_pixel_spec.rb
 - spec/spec_helper.rb
@@ -148,7 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.2.33
 signing_key:
 specification_version: 4
 summary: pure ruby PNG file manipulation & validation

data/lib/zpng/readable_struct.rb

@@ -1,56 +0,0 @@
-module ZPNG
-  module ReadableStruct
-
-    def self.new fmt, *args
-      size = fmt.scan(/([a-z])(\d*)/i).map do |f,len|
-        [len.to_i, 1].max *
-          case f
-          when /[aAC]/ then 1
-          when 'v' then 2
-          when 'V','l' then 4
-          when 'Q' then 8
-          else raise "unknown fmt #{f.inspect}"
-          end
-      end.inject(&:+)
-
-      Struct.new( *args ).tap do |x|
-        x.const_set 'FORMAT', fmt
-        x.const_set 'SIZE',  size
-        x.class_eval do
-          include InstanceMethods
-        end
-        x.extend ClassMethods
-      end
-    end
-
-    module ClassMethods
-      # src can be IO or String, or anything that responds to :read or :unpack
-      def read src, size = nil
-        size ||= const_get 'SIZE'
-        data =
-          if src.respond_to?(:read)
-            src.read(size).to_s
-          elsif src.respond_to?(:unpack)
-            src
-          else
-            raise "[?] don't know how to read from #{src.inspect}"
-          end
-        if data.size < size
-          $stderr.puts "[!] #{self.to_s} want #{size} bytes, got #{data.size}"
-        end
-        new(*data.unpack(const_get('FORMAT')))
-      end
-    end
-
-    module InstanceMethods
-      def pack
-        to_a.pack self.class.const_get('FORMAT')
-      end
-
-      def empty?
-        to_a.all?{ |t| t == 0 || t.nil? || t.to_s.tr("\x00","").empty? }
-      end
-    end
-
-  end # ReadableStruct
-end # ZPNG