pura-bmp 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c04675c1f6dbc0d7a847e8bfdea1b0e3bf8775cb7f3dd9bd716221bd5c4d32fd
-  data.tar.gz: 7aa89ef86fdebafc1eaf57d7970476a00933484ef80106a82a724c80a8252baf
+  metadata.gz: 4142bd041e92c013c3d1f4724a645a4bb01ca29edac500c6546f76511100cdf6
+  data.tar.gz: f3a3acac9b91640281ed4ae7b90499d7a1284f3d5db473ad75c8239cb3df2324
 SHA512:
-  metadata.gz: 253f58ee2de6e9548ead611ee4ff28ef208bee445a771432ef2f87f7e582199a50aff016c420b1f6de975a5168401681a339a3c061ecf3f624bffe7ce4a288a5
-  data.tar.gz: 63627ded0a9f7cfb98a89c0a0694d4b22563ef2741069e42841bc3d791214657e6893d7ea8f51d5f45eaccdfc79739bd1bcd65bf14c76809725cb242894f352b
+  metadata.gz: c1de9ce4f996d9149d9cc9ec5b1c1093f92cd92eaf6f4d4903a60f18379970c30aa2a8d3af7ab2a89c54087adc4eec6b796449a5b7a4cb81ae26b13d795be849
+  data.tar.gz: 398e6830192effbf7d9bfc8a7eb711a01fd55966b3032e08fc46ced90348c23c3a4d8623d25327a0bd57f981d85250a023f40b30915f8f76a4f60a1e82072a20

data/README.md

@@ -1,6 +1,6 @@
 # pura-bmp
 
-A pure Ruby BMP decoder/encoder with zero C extension dependencies.
+A pure Ruby BMP decoder/encoder without additional image-processing libraries.
 
 Part of the **pura-*** series — pure Ruby image codec gems.
 
@@ -8,7 +8,7 @@ Part of the **pura-*** series — pure Ruby image codec gems.
 
 - BMP decoding and encoding (24-bit RGB)
 - Image resizing (bilinear / nearest-neighbor / fit / fill)
-- No native extensions, no FFI, no external dependencies
+- No image-specific native extension or FFI dependency
 - CLI tool included
 
 ## Installation
@@ -46,6 +46,8 @@ pura-bmp resize input.bmp --width 200 --height 200 --out thumb.bmp
 
 ## Benchmark
 
+These historical measurements include ffmpeg process startup. They do not compare against an in-process C codec or establish Rails pipeline throughput.
+
 400×400 image, Ruby 4.0.2 + YJIT.
 
 ### Decode
@@ -55,7 +57,6 @@ pura-bmp resize input.bmp --width 200 --height 200 --out thumb.bmp
 | **pura-bmp** | **39 ms** |
 | ffmpeg (C) | 59 ms |
 
-**pura-bmp is faster than ffmpeg** for BMP decoding. No other pure Ruby BMP implementation exists.
 
 ### Encode
 
@@ -67,8 +68,6 @@ pura-bmp resize input.bmp --width 200 --height 200 --out thumb.bmp
 ## Why pure Ruby?
 
 - **`gem install` and go** — no `brew install`, no `apt install`, no C compiler needed
-- **Faster than C** — pure Ruby BMP decode beats ffmpeg on this benchmark
-- **Works everywhere Ruby works** — CRuby, ruby.wasm, JRuby, TruffleRuby
 - **Part of pura-\*** — convert between JPEG, PNG, BMP, GIF, TIFF, WebP seamlessly
 
 ## Related gems
@@ -84,6 +83,12 @@ pura-bmp resize input.bmp --width 200 --height 200 --out thumb.bmp
 | [pura-webp](https://github.com/komagata/pura-webp) | WebP | ✅ Available |
 | [pura-image](https://github.com/komagata/pura-image) | All formats | ✅ Available |
 
+## Pixel model and limitations
+
+Images contain 8-bit RGB pixels. Decoded pixels are RGB; any alpha channel is discarded. Encoding writes 24-bit RGB BMP.
+
+`crop(x, y, width, height)` requires integer coordinates, positive dimensions, and a region entirely inside the image; invalid regions raise `ArgumentError`.
+
 ## License
 
 MIT

data/lib/pura/bmp/image.rb

@@ -87,6 +87,11 @@ module Pura
 
       # Crop a region from the image
       def crop(x, y, w, h)
+        unless [x, y, w, h].all?(Integer) &&
+               x >= 0 && y >= 0 && w.positive? && h.positive? && x + w <= @width && y + h <= @height
+          raise ArgumentError, "crop must be a positive integer region within the image"
+        end
+
         out = String.new(encoding: Encoding::BINARY, capacity: w * h * 3)
         h.times do |row|
           src_offset = (((y + row) * @width) + x) * 3

data/lib/pura/bmp/version.rb

@@ -2,6 +2,6 @@
 
 module Pura
   module Bmp
-    VERSION = "0.1.0"
+    VERSION = "0.1.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pura-bmp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - komagata