image_util 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31687d0660e040e340b6ed26f581f95de0746e33f992acf7dfcdb4fa4a88f4cd
-  data.tar.gz: 4fee3793295fb2207a54caa1ed430bdc43ddc8307f96ef597ba0ed777618b8e6
+  metadata.gz: 893e648382567326c70c82a4b3e3b6580889229c9d56c7a20ec4d182b45332b4
+  data.tar.gz: 70fd8a63b0551a0aaca12dae391c076fb01621443ec1ae5e5f92c680655277f2
 SHA512:
-  metadata.gz: c02064cb968adae5e5d5b5328922e77fd542d6ca4322a9259d27b513339ff44ca71e272f8cf01055d864f3dbc3fef702d3187a745e98af09a95f2dc9907470c4
-  data.tar.gz: 97c9852b31aab0d2b71f19579968d856fd87eed7339c3b2ec9e6bd1dcee3b674862821f6d4a033148db8d45b0a8228d890670d43c2f0ba921dc98d7d5ed774de
+  metadata.gz: 89a0a3bf90307337674acae7e1315505bc4a8363e58c041388dc6e6beeaab3f03e4534d2ff41e9a97c23f5775e62db6ebe5493658ac2b81e06f3a650a197d28a
+  data.tar.gz: 6b425b6539c389431e78cdc98744a82888a3f55e0fdeed64062bf69a3e0448fec84e83264b3dd1380133a5adafa87e5751dd36595c7c3dc413e4ead3173d21ae

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [0.4.0] - 2025-10-04
+- BREAKING: Float color components now share the 0..255 range with integers instead of being scaled from 0..1.
+- Add `define_mutable_version` helper to create bang versions from immutable methods
+- Add `background!` and `resize!` filters
+
 ## [0.3.0] - 2025-07-25
 - Rename `dither!` to `palette_reduce!`
 - Rename `#set_each_pixel_by_location` to `#set_each_pixel_by_location!` since it's mutable

data/README.md

@@ -96,13 +96,13 @@ the earlier system packages. Both Kitty and SIXEL outputs also accept one-dimens
 - Symbols or strings containing CSS color names (`:rebeccapurple`, 'papayawhip')
 - Hex strings like `'#abc'`, `'#aabbcc'` or `'#rrggbbaa'`
 
-When numeric components are given, integers are first clamped to the `0..255`
-range. Float values are treated as fractions of 255, so `0.5` becomes `127.5`
-and `1.0` becomes `255`. After scaling, values are again clamped to this range.
-If the alpha channel is omitted it defaults to `255`.
+When numeric components are given, values are clamped directly to the `0..255`
+range regardless of whether they are integers or floats. Floating point inputs
+are no longer scaled from `0..1`; instead they are treated in the same units as
+integers. If the alpha channel is omitted it defaults to `255`.
 
 ```ruby
-ImageUtil::Color[0.5] # => #808080
+ImageUtil::Color[128.5] # => #808080
 ImageUtil::Color[:red] # => #ff0000
 ImageUtil::Color["#fc0"] # => #ffcc00
 ```
@@ -177,7 +177,8 @@ Flatten an RGBA image on a solid color.
 img = ImageUtil::Image.new(128, 128) { |x, y| [255, 0, 0, x + y] }
 
 # put it on a blue background
-img.background([0, 0, 255])
+img.background!([0, 0, 255])
+# img.background([0, 0, 255]) # returns a new image
 ```
 
 ![Background example](docs/samples/background.png)
@@ -216,6 +217,7 @@ Scale an image to new dimensions.
 img = ImageUtil::Image.new(128, 128) { |x, y| [x, y, 30] }
 img[20, 20] = img.resize(64, 64)
 img
+# img.resize!(64, 64) # modifies in place
 ```
 
 ![Resize example](docs/samples/resize.png)

data/lib/image_util/codec/image_magick.rb

@@ -64,20 +64,15 @@ module ImageUtil
             img = img.redimension(img.width, img.height + pad) if pad > 0
           end
           pam = Codec::Pam.encode(:pam, img)
-
-          IO.popen(["magick", "pam:-", "#{fmt}:-"], "r+b") do |proc_io|
-            proc_io << pam
-            proc_io.close_write
-            proc_io.read
-          end
         else
           frames = image.buffer.last_dimension_split.map { |b| Image.from_buffer(b) }
-          stream = frames.map { |f| Codec::Pam.encode(:pam, f) }.join
-          IO.popen(["magick", "pam:-", "#{fmt}:-"], "r+b") do |proc_io|
-            proc_io << stream
-            proc_io.close_write
-            proc_io.read
-          end
+          pam = frames.map { |f| Codec::Pam.encode(:pam, f) }.join
+        end
+
+        IO.popen(["magick", "pam:-", "#{fmt}:-"], "r+b") do |proc_io|
+          proc_io << pam
+          proc_io.close_write
+          proc_io.read
         end
       end
 

data/lib/image_util/color.rb

@@ -24,7 +24,7 @@ module ImageUtil
       when Integer
         number.clamp(0, 255)
       when Float
-        (number * 255).clamp(0, 255)
+        number.clamp(0, 255)
       else
         raise ArgumentError, "wrong type passed as component (passed: #{number})"
       end

data/lib/image_util/filter/_mixin.rb

@@ -11,6 +11,15 @@ module ImageUtil
         end
       end
 
+      def define_mutable_version(*names)
+        names.each do |name|
+          define_method("#{name}!") do |*args, **kwargs, &block|
+            initialize_from_buffer(public_send(name, *args, **kwargs, &block).buffer)
+            self
+          end
+        end
+      end
+
       def axis_to_number(axis)
         axis = 0 if axis == :x
         axis = 1 if axis == :y

data/lib/image_util/filter/background.rb

@@ -3,6 +3,7 @@
 module ImageUtil
   module Filter
     module Background
+      extend ImageUtil::Filter::Mixin
       def background(bgcolor)
         return self if channels == 3
 
@@ -18,6 +19,8 @@ module ImageUtil
         end
         img
       end
+
+      define_mutable_version :background
     end
   end
 end

data/lib/image_util/filter/resize.rb

@@ -3,6 +3,7 @@
 module ImageUtil
   module Filter
     module Resize
+      extend ImageUtil::Filter::Mixin
       def resize(*new_dimensions, view: View::Interpolated)
         src = self.view(view)
 
@@ -15,6 +16,8 @@ module ImageUtil
           src[*src_loc]
         end
       end
+
+      define_mutable_version :resize
     end
   end
 end

data/lib/image_util/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ImageUtil
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: image_util
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - hmdne
@@ -168,7 +168,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Simple pixel buffers with SIXEL and codec helpers
 test_files: []