image_util 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27dbed58dd9646ef50f6ae022f3d2599629670f0d430f61c76416cb28d49bbd6
-  data.tar.gz: 55d78376ffbbf3f85b60db158ca65c46b96164c9e6c52b0d7324b70e1bd11dc4
+  metadata.gz: 92f9a0c088385d833ceee58b203a3ba52a4de3d2cbfdd16ed6dc8d0213e18753
+  data.tar.gz: 275a94eb28e30c8d1a59ba25723284e864e8ad9b8a1041826cba37d983ba01fd
 SHA512:
-  metadata.gz: 2c14b302a030e83cc6f398f8560138c31f53e93d9059c7f2b18ce5b81aeb41e4922932a64e8221b5e2e52fc4e5c876ac4dfd74f0eb7630e907e5a74a50a52335
-  data.tar.gz: 6f3834f813239cc80418d54a01224ae5afbd28870a8beff19f1a2c32fabfe7a800d2cc59a857d98faed713c49fff2cc0519332927004c900a72709b08162bcc3
+  metadata.gz: 523748193e1b51083729b1583cfec3ac19ec02a11e893cc3d858deb30388eebd013a01ade2770cd236c2f947bffc0cc2583783d3094552451d99b873d840311b
+  data.tar.gz: 228f82c3508d236822c4a6e27ad721381ffa42aaa31d1e3ab839eeaf9d60363ab2bcd7e6340fab00cdeac23320ad4681036187bd2eb5bb5680242ff9a8451464

data/AGENTS.md

@@ -6,11 +6,7 @@
 - Prefer double-quoted strings except in specs and the gemspec.
 - Use RSpec's `should` syntax instead of `expect`.
 - For one-line methods, use the `def name = expression` style.
-
-Additional notes from the existing code:
-- Image data is stored in `Image::Buffer` backed by `IO::Buffer`.
-- Use `Filter::Mixin#define_immutable_version` to add non-bang versions of mutating filters.
-- Views such as `View::Interpolated` and `View::Rounded` are built with `Data.define`.
-- Pure Ruby algorithms are provided with optional FFI wrappers for libpng, libturbojpeg and libsixel.
+- After adding new features or modifying existing ones, change documentation accordingly (especially README and especially CHANGELOG).
+- Don't discuss codec internals or bug fixes in README. Only list supported formats. Document bug fixes in the CHANGELOG, not in README.
 - Specs target at least 80% coverage as enforced by SimpleCov.
 - The library aims to remain lightweight and portable.

data/CHANGELOG.md

@@ -1,5 +1,13 @@
-## [Unreleased]
-### Added
+## [0.2.0] - 2025-07-21
+- Ruby Sixel encoder now sets pixel aspect ratio metadata to display correctly in Windows Terminal
+- Support for all CSS color names
+- Range assignments with images now resize the image before pasting
+- Circle drawing filter
+- ImageMagick codec can encode and decode `png`, `jpeg` and `sixel`
+
+## [0.1.0] - 2025-07-21
+
+- Initial release
 - Drop support for Ruby 3.1
 - Native SIXEL encoder
 - Background filter
@@ -12,7 +20,3 @@
 - Paste and Draw filters for compositing and drawing
 - Rounded and interpolated pixel views
 - `Image#view` helper for custom access
-
-## [0.1.0] - 2025-07-19
-
-- Initial release

data/README.md

@@ -1,144 +1,191 @@
 # ImageUtil
 
-ImageUtil provides a minimal in-memory image container and a set of utilities for handling raw pixel data in Ruby. It is aimed at small scripts and tools that need to manipulate images without relying on heavy external dependencies.
+ImageUtil is a lightweight Ruby library focused on manipulating images directly in memory. Its primary goal is to help scripts visualize data right in the terminal by supporting SIXEL output alongside common image formats. The API is still evolving and should be considered unstable until version 1.0.
 
-Features include:
+## Creating an Image
 
-* Representation of images with arbitrary dimensions.
-* Support for 8, 16 or 32 bit components and RGB or RGBA color values.
-* A `Color` helper class capable of parsing numbers, arrays and HTML style strings.
-* Conversion of an image to PAM or SIXEL for quick previews in compatible terminals.
-* Built-in SIXEL encoder that works without ImageMagick.
-* Convenience methods for iterating over pixel locations and setting values.
-* Overlaying colors with the `+` operator which blends using the alpha channel.
-* Automatic format detection when reading images from strings or files.
-* Alternate pixel views for interpolated or rounded coordinates.
-
-## Installation
-
-ImageUtil is available on RubyGems:
+```ruby
+require 'image_util'
 
-```bash
-gem install image_util
+# 40×40 RGBA image
+img = ImageUtil::Image.new(40, 40)
 ```
 
-Alternatively add it to your `Gemfile`:
+An optional block receives pixel coordinates and should return something that can be converted to a color. Dimensions of more than two axes are supported.
 
 ```ruby
-gem "image_util"
+img = ImageUtil::Image.new(4, 4) { |x, y| ImageUtil::Color[x * 64, y * 64, 0] }
 ```
 
-Run `bundle install` afterwards.
+## Loading and Saving
 
-You can also build and install the gem manually:
+Instead of building an image from scratch you can load one with
+`ImageUtil::Image.from_string` or `ImageUtil::Image.from_file`.
+Both helpers understand the built in codecs for `png`, `jpeg` and `pam`
+formats:
 
-```bash
-git clone https://github.com/rbutils/image_util.git
-cd image_util
-bundle exec rake install
+```ruby
+img = ImageUtil::Image.from_file("logo.png")
+data = ImageUtil::Image.from_string(File.binread("logo.jpeg"))
 ```
 
-## Usage
+The same formats can be written back using `to_string` or `to_file`.
 
 ```ruby
-require 'image_util'
+img.to_file("out.png", :png)
+binary = img.to_string(:jpeg)
+```
 
-# create a 4×4 image using 8‑bit RGBA colors
-i = ImageUtil::Image.new(4, 4)
+## SIXEL Output
 
-# set the top‑left pixel to red
-i[0, 0] = ImageUtil::Color[255, 0, 0]
+Images can be previewed in compatible terminals:
 
-# display the image in a SIXEL-capable terminal
-puts i.to_sixel
+```ruby
+puts img.to_sixel
 ```
 
-Images can also be iterated over or modified using ranges:
+In `irb` or `pry` the `inspect` method shows the image automatically, so you can
+just evaluate the object:
 
 ```ruby
-# fill an area with blue
-i[0..1, 0..1] = ImageUtil::Color['#0000ff']
+img
+```
 
-# iterate over every pixel
-i.each_pixel do |pixel|
-  # pixel is an ImageUtil::Color instance
-end
+Most notably, SIXEL works in Windows Terminal, Konsole (KDE), iTerm2 (macOS), XTerm (launch with: `xterm -ti vt340`). Here's how it looks in Konsole:
 
-# paste one image into another
-target = ImageUtil::Image.new(8, 8) { ImageUtil::Color[0] }
-source = ImageUtil::Image.new(2, 2) { ImageUtil::Color[255, 0, 0, 128] }
-target.paste!(source, 3, 3, respect_alpha: true)
+![Sixel example](docs/samples/sixel.png)
 
-# draw a diagonal line
-i.draw_line!([0, 0], [3, 3], ImageUtil::Color['red'], view: ImageUtil::View::Rounded)
-```
 
-`View::Interpolated` provides subpixel access while `View::Rounded` snaps
-coordinates to the nearest pixel. These views are useful for drawing
-operations like the example above.
+This library supports generating Sixel with either `libsixel`, `ImageMagick` or using a pure-Ruby Sixel generator. For best performance, try to install one of the earlier system packages.
 
-### Reading and Writing Images
+## Color Values
+
+`ImageUtil::Color.from` (also known as `ImageUtil::Color.[]`) accepts several inputs:
+
+- Another `Color` instance
+- Arrays of numeric components (`[r, g, b]` or `[r, g, b, a]`)
+- Numbers (used for all RGB channels)
+- 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`.
 
 ```ruby
-# detect format automatically when loading from a file
-img = ImageUtil::Image.from_file("photo.png")
+ImageUtil::Color[0.5] # => #808080
+ImageUtil::Color[:red] # => #ff0000
+ImageUtil::Color["#fc0"] # => #ffcc00
+```
+
+Note that whenever the library expects a color, it may be given in any form accepted by this function.
 
-# save using a specific codec
-img.to_file("out.jpg", :jpeg)
+## Pixel Access
 
-# convert directly to a string
-data = img.to_string(:png)
+Pixels can be accessed with integer coordinates or ranges. When ranges are used
+a new `Image` containing that region is returned and can be modified separately.
+
+```ruby
+img[0, 0] = '#ff0000'
+patch = img[0..1, 0..1]
 ```
 
-### Filters
+For instance, you can extract a region, edit it and paste it back:
 
 ```ruby
-# reduce palette to 32 colors
-dithered = img.dither(32)
+img = ImageUtil::Image.new(4, 4) { [0, 0, 0] }
+corner = img[0..1, 0..1]
+corner.all = :green
+img[0..1, 0..1] = corner
+img[2, 2] = :yellow
+img.to_file("pixel_patch.png", :png)
+```
 
-# composite two images without altering the originals
-result = base.paste(other, 10, 10)
+Assigning an image to a range automatically resizes it to fit before pasting.
 
-# apply a background color to an RGBA image
-flattened = img.background(ImageUtil::Color[255, 255, 255])
+Iteration helpers operate on arbitrary ranges and share the same syntax used
+when indexing images.  `each_pixel` yields color objects, while
+`each_pixel_location` yields coordinate arrays.  `set_each_pixel_by_location`
+assigns the value returned by the block to every location (unless `nil` is returned).
+
+```ruby
+# fill a checkerboard pattern
+img = ImageUtil::Image.new(8, 8) { :white }
+img.set_each_pixel_by_location do |x, y|
+  :black if (x + y).odd?
+end
+
+# count how many black pixels were set
+black = img.each_pixel.count { |c| c == :black }
 ```
 
-### Working with Views
+Note that instead of manually calling `set_each_pixel_by_location`, you can just pass a block to `ImageUtil::Image.new`.
+
+## Filters
+
+`ImageUtil::Image` ships with a few convenience filters. Each bang method
+modifies the image in place while the non-bang version returns a copy.
+
+### Background
+
+Flatten an RGBA image on a solid color.
 
 ```ruby
-# access using fractional coordinates
-interp = img.view(ImageUtil::View::Interpolated)
-interp[1.2, 2.8] = ImageUtil::Color[0, 0, 255]
+img = ImageUtil::Image.new(128, 128) { |x, y| [255, 0, 0, x + y] }
+img.background([0, 0, 255])
+```
+
+![Background example](docs/samples/background.png)
+
+### Paste
+
+Place one image over another. When `respect_alpha` is true, the pasted pixels are
+blended with the base image.
 
-# round coordinates instead
-rounded = img.view(ImageUtil::View::Rounded)
-color = rounded[1.6, 0.3]
+```ruby
+base    = ImageUtil::Image.new(128, 128) { |x, y| [x, y, 50] }
+overlay = ImageUtil::Image.new(64, 64)  { |x, y| [255, 0, 0, (x + y) * 2] }
+base.paste!(overlay, 32, 32, respect_alpha: true)
 ```
 
-### Codecs
+![Paste example](docs/samples/paste.png)
+
+### Draw
 
-ImageUtil includes a small registry of codecs for converting images to and from
-common formats such as PNG, JPEG and SIXEL. The library ships with pure Ruby
-encoders and FFI wrappers around `libpng`, `libturbojpeg` and `libsixel` when
-available.
+Draw simple shapes directly on the image.
 
 ```ruby
-png = ImageUtil::Codec.encode(:png, i)
-back = ImageUtil::Codec.decode(:png, png)
+img = ImageUtil::Image.new(128, 128) { [0, 0, 0] }
+img.draw_line!([0, 0], [127, 127], :red)
+img.draw_line!([0, 127], [127, 0], :lime)
+img.draw_circle!([64, 64], 30, :blue)
+```
 
-File.open("img.pam", "wb") do |f|
-  ImageUtil::Codec.encode_io(:pam, i, f)
-end
+![Draw example](docs/samples/draw.png)
+
+### Resize
+
+Scale an image to new dimensions.
+
+```ruby
+img = ImageUtil::Image.new(256, 256) { |x, y| [x, y, 30] }
+img[70, 70] = img.resize(64, 64)
+img
 ```
 
-You can read images from files without specifying the format:
+![Resize example](docs/samples/resize.png)
+
+### Dither
+
+Reduce the image to a limited palette.
 
 ```ruby
-image = ImageUtil::Image.from_file("picture.jpg")
+img = ImageUtil::Image.new(256, 64) { |x, y| [x, y * 4, 200] }
+img.dither(8)
 ```
 
-Use `ImageUtil::Codec.supported?(format)` to check if a particular format is
-available. Unsupported formats raise `ImageUtil::Codec::UnsupportedFormatError`.
+![Dither example](docs/samples/dither.png)
 
 ## Development
 

data/lib/image_util/codec/image_magick.rb

@@ -3,7 +3,7 @@
 module ImageUtil
   module Codec
     module ImageMagick
-      SUPPORTED_FORMATS = [:sixel].freeze
+      SUPPORTED_FORMATS = %i[sixel jpeg png].freeze
 
       extend Guard
 
@@ -26,10 +26,13 @@ module ImageUtil
       def encode(format, image)
         guard_supported_format!(format, SUPPORTED_FORMATS)
 
-        IO.popen("magick pam:- sixel:-", "r+") do |io|
-          io << Codec::Pam.encode(:pam, image, fill_to: 6)
-          io.close_write
-          io.read
+        fmt = format.to_s.downcase
+        pam = Codec::Pam.encode(:pam, image, fill_to: fmt == "sixel" ? 6 : nil)
+
+        IO.popen(["magick", "pam:-", "#{fmt}:-"], "r+") do |proc_io|
+          proc_io << pam
+          proc_io.close_write
+          proc_io.read
         end
       end
 
@@ -37,12 +40,18 @@ module ImageUtil
         io << encode(format, image)
       end
 
-      def decode(*)
-        raise UnsupportedFormatError, "decode not supported for sixel"
+      def decode(format, data)
+        guard_supported_format!(format, SUPPORTED_FORMATS)
+
+        IO.popen(["magick", "#{format}:-", "pam:-"], "r+") do |proc_io|
+          proc_io << data
+          proc_io.close_write
+          Pam.decode(:pam, proc_io.read)
+        end
       end
 
-      def decode_io(*)
-        raise UnsupportedFormatError, "decode not supported for sixel"
+      def decode_io(format, io)
+        decode(format, io.read)
       end
     end
   end

data/lib/image_util/codec/ruby_sixel.rb

@@ -56,7 +56,7 @@ module ImageUtil
           end
         end
 
-        out = "\ePq".dup
+        out = "\ePq\"1;1;#{width};#{height}".dup
         palette.each_with_index do |c, idx|
           out << format("#%d;2;%d;%d;%d", idx, c.r * 100 / 255, c.g * 100 / 255, c.b * 100 / 255)
         end

data/lib/image_util/codec.rb

@@ -111,7 +111,7 @@ module ImageUtil
     register_codec :Libpng, :png
     register_codec :Libturbojpeg, :jpeg
     register_encoder :Libsixel, :sixel
-    register_encoder :ImageMagick, :sixel
+    register_codec :ImageMagick, :png, :jpeg, :sixel
     register_encoder :RubySixel, :sixel
   end
 end

data/lib/image_util/color/css_colors.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+module ImageUtil
+  class Color < Array
+    CSS_COLORS = {
+      "aliceblue" => [240, 248, 255],
+      "antiquewhite" => [250, 235, 215],
+      "aqua" => [0, 255, 255],
+      "aquamarine" => [127, 255, 212],
+      "azure" => [240, 255, 255],
+      "beige" => [245, 245, 220],
+      "bisque" => [255, 228, 196],
+      "black" => [0, 0, 0],
+      "blanchedalmond" => [255, 235, 205],
+      "blue" => [0, 0, 255],
+      "blueviolet" => [138, 43, 226],
+      "brown" => [165, 42, 42],
+      "burlywood" => [222, 184, 135],
+      "cadetblue" => [95, 158, 160],
+      "chartreuse" => [127, 255, 0],
+      "chocolate" => [210, 105, 30],
+      "coral" => [255, 127, 80],
+      "cornflowerblue" => [100, 149, 237],
+      "cornsilk" => [255, 248, 220],
+      "crimson" => [220, 20, 60],
+      "cyan" => [0, 255, 255],
+      "darkblue" => [0, 0, 139],
+      "darkcyan" => [0, 139, 139],
+      "darkgoldenrod" => [184, 134, 11],
+      "darkgray" => [169, 169, 169],
+      "darkgrey" => [169, 169, 169],
+      "darkgreen" => [0, 100, 0],
+      "darkkhaki" => [189, 183, 107],
+      "darkmagenta" => [139, 0, 139],
+      "darkolivegreen" => [85, 107, 47],
+      "darkorange" => [255, 140, 0],
+      "darkorchid" => [153, 50, 204],
+      "darkred" => [139, 0, 0],
+      "darksalmon" => [233, 150, 122],
+      "darkseagreen" => [143, 188, 143],
+      "darkslateblue" => [72, 61, 139],
+      "darkslategray" => [47, 79, 79],
+      "darkslategrey" => [47, 79, 79],
+      "darkturquoise" => [0, 206, 209],
+      "darkviolet" => [148, 0, 211],
+      "deeppink" => [255, 20, 147],
+      "deepskyblue" => [0, 191, 255],
+      "dimgray" => [105, 105, 105],
+      "dimgrey" => [105, 105, 105],
+      "dodgerblue" => [30, 144, 255],
+      "firebrick" => [178, 34, 34],
+      "floralwhite" => [255, 250, 240],
+      "forestgreen" => [34, 139, 34],
+      "fuchsia" => [255, 0, 255],
+      "gainsboro" => [220, 220, 220],
+      "ghostwhite" => [248, 248, 255],
+      "gold" => [255, 215, 0],
+      "goldenrod" => [218, 165, 32],
+      "gray" => [128, 128, 128],
+      "grey" => [128, 128, 128],
+      "green" => [0, 128, 0],
+      "greenyellow" => [173, 255, 47],
+      "honeydew" => [240, 255, 240],
+      "hotpink" => [255, 105, 180],
+      "indianred" => [205, 92, 92],
+      "indigo" => [75, 0, 130],
+      "ivory" => [255, 255, 240],
+      "khaki" => [240, 230, 140],
+      "lavender" => [230, 230, 250],
+      "lavenderblush" => [255, 240, 245],
+      "lawngreen" => [124, 252, 0],
+      "lemonchiffon" => [255, 250, 205],
+      "lightblue" => [173, 216, 230],
+      "lightcoral" => [240, 128, 128],
+      "lightcyan" => [224, 255, 255],
+      "lightgoldenrodyellow" => [250, 250, 210],
+      "lightgray" => [211, 211, 211],
+      "lightgrey" => [211, 211, 211],
+      "lightgreen" => [144, 238, 144],
+      "lightpink" => [255, 182, 193],
+      "lightsalmon" => [255, 160, 122],
+      "lightseagreen" => [32, 178, 170],
+      "lightskyblue" => [135, 206, 250],
+      "lightslategray" => [119, 136, 153],
+      "lightslategrey" => [119, 136, 153],
+      "lightsteelblue" => [176, 196, 222],
+      "lightyellow" => [255, 255, 224],
+      "lime" => [0, 255, 0],
+      "limegreen" => [50, 205, 50],
+      "linen" => [250, 240, 230],
+      "magenta" => [255, 0, 255],
+      "maroon" => [128, 0, 0],
+      "mediumaquamarine" => [102, 205, 170],
+      "mediumblue" => [0, 0, 205],
+      "mediumorchid" => [186, 85, 211],
+      "mediumpurple" => [147, 112, 219],
+      "mediumseagreen" => [60, 179, 113],
+      "mediumslateblue" => [123, 104, 238],
+      "mediumspringgreen" => [0, 250, 154],
+      "mediumturquoise" => [72, 209, 204],
+      "mediumvioletred" => [199, 21, 133],
+      "midnightblue" => [25, 25, 112],
+      "mintcream" => [245, 255, 250],
+      "mistyrose" => [255, 228, 225],
+      "moccasin" => [255, 228, 181],
+      "navajowhite" => [255, 222, 173],
+      "navy" => [0, 0, 128],
+      "oldlace" => [253, 245, 230],
+      "olive" => [128, 128, 0],
+      "olivedrab" => [107, 142, 35],
+      "orange" => [255, 165, 0],
+      "orangered" => [255, 69, 0],
+      "orchid" => [218, 112, 214],
+      "palegoldenrod" => [238, 232, 170],
+      "palegreen" => [152, 251, 152],
+      "paleturquoise" => [175, 238, 238],
+      "palevioletred" => [219, 112, 147],
+      "papayawhip" => [255, 239, 213],
+      "peachpuff" => [255, 218, 185],
+      "peru" => [205, 133, 63],
+      "pink" => [255, 192, 203],
+      "plum" => [221, 160, 221],
+      "powderblue" => [176, 224, 230],
+      "purple" => [128, 0, 128],
+      "red" => [255, 0, 0],
+      "rosybrown" => [188, 143, 143],
+      "royalblue" => [65, 105, 225],
+      "saddlebrown" => [139, 69, 19],
+      "salmon" => [250, 128, 114],
+      "sandybrown" => [244, 164, 96],
+      "seagreen" => [46, 139, 87],
+      "seashell" => [255, 245, 238],
+      "sienna" => [160, 82, 45],
+      "silver" => [192, 192, 192],
+      "skyblue" => [135, 206, 235],
+      "slateblue" => [106, 90, 205],
+      "slategray" => [112, 128, 144],
+      "slategrey" => [112, 128, 144],
+      "snow" => [255, 250, 250],
+      "springgreen" => [0, 255, 127],
+      "steelblue" => [70, 130, 180],
+      "tan" => [210, 180, 140],
+      "teal" => [0, 128, 128],
+      "thistle" => [216, 191, 216],
+      "tomato" => [255, 99, 71],
+      "turquoise" => [64, 224, 208],
+      "violet" => [238, 130, 238],
+      "wheat" => [245, 222, 179],
+      "white" => [255, 255, 255],
+      "whitesmoke" => [245, 245, 245],
+      "yellow" => [255, 255, 0],
+      "yellowgreen" => [154, 205, 50],
+      "rebeccapurple" => [102, 51, 153]
+    }.freeze
+  end
+end

data/lib/image_util/color.rb

@@ -6,6 +6,7 @@ module ImageUtil
       super(args)
     end
 
+    autoload :CSS_COLORS, "image_util/color/css_colors"
     def r = self[0]
     def g = self[1]
     def b = self[2]
@@ -69,13 +70,12 @@ module ImageUtil
           new($1.to_i(16), $2.to_i(16), $3.to_i(16))
         when /\A#(\h{2})(\h{2})(\h{2})(\h{2})\z/
           new($1.to_i(16), $2.to_i(16), $3.to_i(16), $4.to_i(16))
-        when "black" then new(0, 0, 0)
-        when "white" then new(255, 255, 255)
-        when "red" then new(255, 0, 0)
-        when "lime" then new(0, 255, 0)
-        when "blue" then new(0, 0, 255)
         else
-          raise ArgumentError, "wrong String passed as color (passed: #{value.inspect})"
+          if (rgb = CSS_COLORS[value.downcase])
+            new(*rgb)
+          else
+            raise ArgumentError, "wrong String passed as color (passed: #{value.inspect})"
+          end
         end
       when Symbol
         from(value.to_s)

data/lib/image_util/filter/draw.rb

@@ -62,7 +62,29 @@ module ImageUtil
         end
       end
 
-      define_immutable_version :draw_function, :draw_line
+      def draw_circle!(center, radius, color = Color[:black], view: View::Interpolated)
+        fp = self.view(view)
+        cx, cy = center
+        min_x = (cx - radius).ceil
+        max_x = (cx + radius).floor
+        min_x.upto(max_x) do |x|
+          dy = Math.sqrt(radius * radius - (x - cx)**2)
+          fp[x, cy + dy] = color
+          fp[x, cy - dy] = color
+        end
+
+        min_y = (cy - radius).ceil
+        max_y = (cy + radius).floor
+        min_y.upto(max_y) do |y|
+          dx = Math.sqrt(radius * radius - (y - cy)**2)
+          fp[cx + dx, y] = color
+          fp[cx - dx, y] = color
+        end
+
+        self
+      end
+
+      define_immutable_version :draw_function, :draw_line, :draw_circle
 
       private
 

data/lib/image_util/image.rb

@@ -136,9 +136,11 @@ module ImageUtil
           @buf.set(location, value)
         end
       else
-        _, locations = location_expand(location)
-        locations.each do |loc|
-          self[*loc] = value
+        sizes, locations = location_expand(location)
+        if value.is_a?(Image)
+          paste!(value.resize(*sizes), *locations.first)
+        else
+          locations.each { |loc| self[*loc] = value }
         end
       end
     end

data/lib/image_util/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: image_util
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - hmdne
@@ -38,6 +38,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- docs/samples/background.png
+- docs/samples/dither.png
+- docs/samples/draw.png
+- docs/samples/paste.png
+- docs/samples/resize.png
+- docs/samples/sixel.png
 - lib/image_util.rb
 - lib/image_util/codec.rb
 - lib/image_util/codec/_guard.rb
@@ -48,6 +54,7 @@ files:
 - lib/image_util/codec/pam.rb
 - lib/image_util/codec/ruby_sixel.rb
 - lib/image_util/color.rb
+- lib/image_util/color/css_colors.rb
 - lib/image_util/filter.rb
 - lib/image_util/filter/_mixin.rb
 - lib/image_util/filter/background.rb