retouch 0.1.0 → 0.3.1

data/lib/retouch.rb

@@ -7,8 +7,16 @@ require_relative "retouch/geometry"
 require_relative "retouch/gravity"
 require_relative "retouch/operations"
 require_relative "retouch/pipeline"
-require_relative "retouch/cli"
 require_relative "retouch/io"
+require_relative "retouch/kernels/lut"
+require_relative "retouch/kernels/convolve"
+require_relative "retouch/kernels/color"
+require_relative "retouch/operations/color"
+require_relative "retouch/operations/filter"
+require_relative "retouch/operations/draw"
+require_relative "retouch/operations/multiple"
+require_relative "retouch/batch"
+require_relative "retouch/cli"
 
 module Retouch
   class Error < StandardError; end
@@ -20,4 +28,9 @@ module Retouch
   def self.from_image(image)
     Pipeline.new(image)
   end
+
+  def self.open_gif(path, frame: :all, **limits)
+    result = Operations.open_gif(path, frame:, **limits)
+    frame == :all ? result : Pipeline.new(result)
+  end
 end

data/retouch.gemspec

@@ -7,8 +7,8 @@ Gem::Specification.new do |spec|
   spec.version = Retouch::VERSION
   spec.authors = ["Yudai Takada"]
   spec.email = ["t.yudai92@gmail.com"]
-  spec.summary = "Ruby image resizing and shape tools"
-  spec.description = "A small Ruby image editor and command line tool for resizing and shape operations."
+  spec.summary = "Pure Ruby image editing and batch tools"
+  spec.description = "A small pure Ruby image editor for color, filter, composite, annotation, and batch operations on PNG, PPM, and BMP images."
   spec.homepage = "https://github.com/rbgfx/retouch"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.1.0"

data/sig/retouch.rbs

@@ -20,6 +20,33 @@ module Retouch
     def self.offset: (Integer container_width, Integer container_height, Integer content_width, Integer content_height, Symbol | String gravity) -> [Integer, Integer]
   end
 
+  module Operations
+    def self.info: (untyped image) -> Hash[Symbol, untyped]
+    def self.grayscale: (untyped image) -> untyped
+    def self.invert: (untyped image) -> untyped
+    def self.brightness: (untyped image, Numeric amount) -> untyped
+    def self.contrast: (untyped image, Numeric factor) -> untyped
+    def self.gamma: (untyped image, Numeric value) -> untyped
+    def self.saturate: (untyped image, Numeric factor) -> untyped
+    def self.tint: (untyped image, String color, ?amount: Numeric) -> untyped
+    def self.opacity: (untyped image, Numeric amount) -> untyped
+    def self.quantize: (untyped image, ?colors: Integer, ?dither: Symbol, ?palette: Array[Array[Integer]]?) -> untyped
+    def self.blur: (untyped image, Numeric sigma) -> untyped
+    def self.sharpen: (untyped image, Numeric sigma, ?amount: Numeric) -> untyped
+    def self.pixelate: (untyped image, Integer size) -> untyped
+    def self.overlay: (untyped image, untyped source, ?x: Integer?, ?y: Integer?, ?gravity: Symbol | String, ?opacity: Numeric, ?mode: Symbol) -> untyped
+    def self.watermark: (untyped image, untyped source, **untyped options) -> untyped
+    def self.text: (untyped image, String text, **untyped options) -> untyped
+    def self.rect: (untyped image, Integer x, Integer y, Integer width, Integer height, ?String color, ?fill: bool) -> untyped
+    def self.arrow: (untyped image, Integer x1, Integer y1, Integer x2, Integer y2, ?String color, ?width: Integer, ?head: Numeric) -> untyped
+    def self.append: (Array[untyped] images, ?direction: Symbol, ?gap: Integer, ?background: untyped) -> untyped
+    def self.montage: (Array[untyped] images, ?columns: Integer?, ?cols: Integer?, ?gap: Integer, ?background: untyped, ?labels: bool | Array[String]?) -> untyped
+    def self.spritesheet: (Array[untyped] images, ?max_width: Integer, ?gap: Integer, ?background: untyped) -> [untyped, Array[Hash[Symbol, Integer]]]
+    def self.diff: (untyped expected, untyped actual, ?threshold: Numeric, ?color: String) -> Hash[Symbol, untyped]
+    def self.animate: (Array[untyped] frames, String path, ?fps: Numeric?, ?delay: Numeric | Array[Numeric]?, ?loop: bool | Integer, ?colors: Integer, ?palette: Symbol | Array[Array[Integer]], ?dither: Symbol) -> String
+    def self.open_gif: (String path, ?frame: Symbol | Integer, ?max_pixels: Integer, ?max_frames: Integer, ?max_total_pixels: Integer) -> untyped
+  end
+
   class Pipeline
     def to_image: -> untyped
     def info: -> Hash[Symbol, untyped]
@@ -34,10 +61,29 @@ module Retouch
     def extend: (Integer width, Integer height, **untyped options) -> Pipeline
     def border: (Integer width, ?String color, **untyped options) -> Pipeline
     def trim: (**untyped options) -> Pipeline
+    def grayscale: -> Pipeline
+    def invert: -> Pipeline
+    def brightness: (Numeric amount) -> Pipeline
+    def contrast: (Numeric factor) -> Pipeline
+    def gamma: (Numeric value) -> Pipeline
+    def saturate: (Numeric factor) -> Pipeline
+    def tint: (String color, **untyped options) -> Pipeline
+    def opacity: (Numeric amount) -> Pipeline
+    def quantize: (**untyped options) -> Pipeline
+    def blur: (Numeric sigma) -> Pipeline
+    def sharpen: (Numeric sigma, **untyped options) -> Pipeline
+    def pixelate: (Integer size) -> Pipeline
+    def overlay: (String | untyped source, **untyped options) -> Pipeline
+    def watermark: (String | untyped source, **untyped options) -> Pipeline
+    def text: (String text, **untyped options) -> Pipeline
+    def rect: (Integer x, Integer y, Integer width, Integer height, ?String color, **untyped options) -> Pipeline
+    def arrow: (Integer x1, Integer y1, Integer x2, Integer y2, ?String color, **untyped options) -> Pipeline
   end
 
   def self.open: (String path) -> Pipeline
   def self.from_image: (untyped image) -> Pipeline
+  def self.open_gif: (String path, ?frame: Symbol | Integer, **untyped limits) -> (Array[untyped] | Pipeline)
+  def self.batch: (String | Array[String] inputs, to: String, ?jobs: Integer, ?force: bool) { (Pipeline) -> Pipeline } -> Array[String]
 
   class CLI
     def self.run: (Array[String] argv, ?out: untyped, ?err: untyped) -> Integer

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: retouch
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Yudai Takada
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tessel
@@ -99,8 +100,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.6'
-description: A small Ruby image editor and command line tool for resizing and shape
-  operations.
+description: A small pure Ruby image editor for color, filter, composite, annotation,
+  and batch operations on PNG, PPM, and BMP images.
 email:
 - t.yudai92@gmail.com
 executables:
@@ -114,13 +115,22 @@ files:
 - README.md
 - Rakefile
 - bench/retouch.rb
+- docs/index.html
 - exe/retouch
 - lib/retouch.rb
+- lib/retouch/batch.rb
 - lib/retouch/cli.rb
 - lib/retouch/geometry.rb
 - lib/retouch/gravity.rb
 - lib/retouch/io.rb
+- lib/retouch/kernels/color.rb
+- lib/retouch/kernels/convolve.rb
+- lib/retouch/kernels/lut.rb
 - lib/retouch/operations.rb
+- lib/retouch/operations/color.rb
+- lib/retouch/operations/draw.rb
+- lib/retouch/operations/filter.rb
+- lib/retouch/operations/multiple.rb
 - lib/retouch/pipeline.rb
 - lib/retouch/version.rb
 - retouch.gemspec
@@ -132,6 +142,7 @@ metadata:
   homepage_uri: https://github.com/rbgfx/retouch
   source_code_uri: https://github.com/rbgfx/retouch/tree/main
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -146,7 +157,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
-summary: Ruby image resizing and shape tools
+summary: Pure Ruby image editing and batch tools
 test_files: []