simple_bmp 0.0.3 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cb9f1ad83d93fa70a90dcd64b6443b3e4f55f05c
-  data.tar.gz: 9ab7e0f122ade992d4824ceb61e40bdc2e2dbe04
+  metadata.gz: d84f668c6933430316c3ac409ecc577b7fb71924
+  data.tar.gz: cf46732f084471b98c9f106fedfa781451b6e432
 SHA512:
-  metadata.gz: b4c5a14f65ec7c8e9f905708cf41076ab60fb0b454a35c6d101447a8f7f1368e24809c34b5b91dca3275c6d6c36d6321879918f883f9a67ef564cf3b1afe65a8
-  data.tar.gz: e202d61ca18e776abcae7b87474f4f054116ce3582dcffa5d7d1b537ddeff82d7a4c36d58c00ef85a0edad6cc165e4aba430a53d171225f92b153b14e1969cf0
+  metadata.gz: 66d1d770f7bbd94fb8b36356f0c9c77d1871d2ca8ec1f720283126dca9a892257f2f41774d26d185fa5ee45714dfe63536b3c7c621f7b5a764a83feaa512d7ed
+  data.tar.gz: 97ecd52f84f73ef570d0dbdadfe5359b6ef5fc87875b6786c8b475724f68d9be75a922240eb395ca723b5d7e378fee722c95eeb3d973d2240a2edf8196313cf6

data/lib/simple_bmp.rb

@@ -1,11 +1,26 @@
+##
+# Currently there are no need of classes -- just a single public module method.
+#
+
 module SimpleBMP
-    # export 2-dimensional array [height x width] of 0..255 for grayscale
-    # export 3-dimensional array [height x width x 3] of 0..255 for RGB
-    # we use BITMAPINFOHEADER (40 bytes), because BITMAPCOREHEADER (12 bytes) can't 8bpp
+
+    ##
+    # Pixels is either two or three dimensional array:
+    #   pixels: [height x width x 3] of 0..255 for RGB
+    #   pixels: [height x width] of 0..255 for grayscale
+    # Two-dimensional will be processed as it's three, where R, G anb B are equal.
+    #
+    # Examples of exporting a single pixel image which is almost gray:
+    #   export [[100]], "temp.bmp"
+    #   export [[[90,100,110]]], "temp.bmp"
+    #--
+    # we use BITMAPINFOHEADER (40 bytes), because BITMAPCOREHEADER (12 bytes) can't 1 channel
+
     def self.export pixels, filename = "temp.bmp"
         bitmap_width = pixels.first.size
         bitmap_height = pixels.size
 =begin
+--
         hsv2bgr = lambda do |(h,s,v)|
             a = (v - vmin = (100-s)*v/100)*(h % 60)/60.0
             vinc, vdec = vmin + a, v - a
@@ -20,18 +35,26 @@ module SimpleBMP
         end
 =end
         pixel_array = pixels.reverse.flat_map do |row|
-            #row_bytes = row.map(&hsv2bgr).flatten
+            #--
+            # row_bytes = row.map(&hsv2bgr).flatten
             row_bytes = row.flat_map{ |pixel| pixel.is_a?(Array) ? pixel : [pixel]*3 }
             row_bytes.fill 0, row_bytes.size .. (row_bytes.size + 3) / 4 * 4 - 1
         end
-        file_size = 14 + 40 + pixel_array.size
+
+        #--
+        # 12=>BITMAPCOREHEADER, 40=>BITMAPINFOHEADER
+        dib_header_size = 12
+        file_size = 14 + dib_header_size + pixel_array.size
 
         open(filename, "wb") do |file|
-            # Bitmap file header (14 bytes)
-            file.write ["BM", file_size, 14 + 40].pack "A2qi" # "A2QL"
-            # DIB header (BITMAPINFOHEADER, 40 bytes)
-            file.write [40, bitmap_width, bitmap_height, 1, 24].pack "LllSS"
-            file.write [0, 0, 1, 1, 0, 0].pack "LLllLL"
+            #--
+            # Bitmap file header
+            file.write ["BM", file_size, 14 + dib_header_size].pack "A2qi" # "A2QL"
+            #--
+            # DIB header
+            # file.write [dib_header_size, bitmap_width, bitmap_height, 1, 24].pack "LllSS"
+            # file.write [0, 0, 1, 1, 0, 0].pack "LLllLL"
+            file.write [dib_header_size, bitmap_width, bitmap_height, 1, 24].pack "LSSSS"
             file.write pixel_array.pack "C*"
         end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_bmp
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.0
 platform: ruby
 authors:
 - Victor Maslov
@@ -10,7 +10,9 @@ bindir: bin
 cert_chain: []
 date: 2014-05-14 00:00:00.000000000 Z
 dependencies: []
-description: A simple BMP renderer
+description: As simple as you really need. You get only 40 bytes type header, and
+  currently only either RGB or Grayscale. If it seems to work under <=1.8.7, let me
+  know -- I'll update gemspec.
 email: nakilon@gmail.com
 executables: []
 extensions: []
@@ -29,7 +31,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
-      version: 1.8.7
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='