vips 8.8.4 → 8.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e63e0ca10ce7e3c41bfda60bea2a13f12d13937c5ccab8be832648ed3d4aa6c
-  data.tar.gz: 9e40c91344b418e24aed13952f335bb5b6a08dd015e675597e656650ce4bd2a9
+  metadata.gz: 872a3771eee6d56c17254a27013a7ff1d002506965bf488fad3d055817457f1a
+  data.tar.gz: 76930aa9a3b5456460be220e3373c3a7ff573a86f18c3e07a3cd4ebbf37614af
 SHA512:
-  metadata.gz: 85aa8d1d02d8d91cdc33a2b012a2340f7b93aed72e3e6081ed3012ed7d0a8f605ec64a0a523d77a1add4cb6be15dfe2982d72d8770226c09547b39d3d6680145
-  data.tar.gz: de62d6c3d576d3d0c34e0f391a6e720412152aafe672db9f2df148d34b948059f23402e2af4393421129efbfb2d414fb93b74bd1c50e0599fc367f73adf5fc83
+  metadata.gz: 51239e27dfe2b430985f875150abc758f2f4756fca00647e4c976ff36e4569da42a67bf236988bb244c3e4c8d2043d1d2308baceb58833accb0434460fc2ca87
+  data.tar.gz: 11e11cfdece5955686490f861ef20abcfd283d1d2875f5c7212cfabd0bf03aff8589e085e9277b61cd8d0bb71fef6db309617d93134590e574b6817722637d81

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Questions or suggestions**
+
+We are using [Discussions](https://github.com/libvips/ruby-vips/discussions) for questions and suggestions for new features. Issues are only for bug reports.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

data/.github/workflows/development.yml

@@ -0,0 +1,54 @@
+name: Development
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    name: ${{matrix.ruby}} on ${{matrix.os}}
+    runs-on: ${{matrix.os}}-latest
+    continue-on-error: ${{matrix.experimental}}
+    
+    strategy:
+      matrix:
+        os:
+          - ubuntu
+          # - macos
+        
+        ruby:
+          - "2.6"
+          - "2.7"
+          - "3.0"
+          - "3.1"
+        
+        experimental: [false]
+        env: [""]
+        
+        include:
+          - os: ubuntu
+            ruby: truffleruby
+            experimental: true
+          - os: ubuntu
+            ruby: jruby
+            experimental: true
+          - os: ubuntu
+            ruby: head
+            experimental: true
+    
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{matrix.ruby}}
+        bundler-cache: true
+    
+    - name: Install libvips
+      env:
+        DEBIAN_FRONTEND: noninteractive
+      run: |
+        sudo apt-get update -qq -o Acquire::Retries=3
+        sudo apt-get install --fix-missing -qq -o Acquire::Retries=3 libvips
+        bundle exec rake ext
+    
+    - name: Run tests
+      timeout-minutes: 5
+      run: ${{matrix.env}} bundle exec rake spec

data/.standard.yml

@@ -0,0 +1,17 @@
+fix: false              # default: false
+parallel: true          # default: false
+format: progress        # default: Standard::Formatter
+ruby_version: 2.0       # default: RUBY_VERSION
+default_ignores: false  # default: true
+
+ignore:                 # default: []
+  - '**/*':
+    - Standard/SemanticBlocks
+  - 'lib/vips/methods.rb'
+  - '{lib,example}/**/*':
+    - Lint/IneffectiveAccessModifier
+    - Lint/RescueException
+    - Style/GlobalVars
+  - 'spec/**/*':
+      - Lint/BinaryOperatorWithIdenticalOperands
+  - 'vendor/**/*'

data/.travis.yml

@@ -41,6 +41,7 @@ matrix:
     - rvm: 2.6
       os: osx
       env: PKG_CONFIG_PATH="/usr/local/opt/libffi/lib/pkgconfig"
+    - rvm: 2.7
     - rvm: truffleruby
     - rvm: jruby-head
     - rvm: ruby-head

data/.yardopts

@@ -1,2 +1 @@
---markup-provider=redcarpet
 --markup=markdown

data/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 ## master
 
+## Version 2.1.4 (2021-10-28)
+
+* `write_to_buffer` tries to use the new target API, then falls back to the old 
+  buffer system [jcupitt]
+* don't generate yard docs for deprecated args [jcupitt]
+* add hyperbolic trig functions [jcupitt]
+
+## Version 2.1.3 (2021-8-23)
+
+* fix a gtype size error on win64 [danini-the-panini]
+
+## Version 2.1.2 (2021-5-3)
+
+* allow `FFI::Pointer` as an argument to `new_from_memory` etc. [sled]
+
+## Version 2.1.1 (2021-5-3)
+
+* fix "mutate" with libvips 8.9 [jcupitt]
+* update autodocs for libvips 8.11 [jcupitt]
+
+## Version 2.1.0 (2021-3-8)
+
+* add "mutate" system [jcupitt]
+* better behaviour with some nil parameters [jcupitt]
+* revise gemspec [jcupitt]
+* allow symbols for Interpolate.new [noraj]
+* update docs for 8.10, fix minor doc formatting issues [jcupitt]
+* `new_from_array` checks array argument more carefully [dkam]
+* add `new_from_memory` and `new_from_memory_copy` [ankane]
+* jruby added to CI testing [pftg]
+* switch to github actions for CI [pftg]
+* remove rubocop, revise formatting for standardrb [pftg]
+
+## Version 2.0.17 (2019-10-29)
+
+* install msys2 libvips on Windows [larskanis]
+* better `-` to `_` conversion [Nakilon]
+* fix `GValue#set` for stricter metadata rules in 8.9 [jcupitt]
+* fix a ref leak on operation build error [jcupitt]
+* faster operation call [jcupitt]
+* add support for VipsConnection [jcupitt]
+* add `signal_connect` [jcupitt]
+* add `Image#set_kill` for progress termination [jcupitt]
+
+## Version 2.0.16 (2019-9-21)
+
+* better library name generation [renchap]
+* allow `_` as a separator in enum names [D-W-L]
+* add `Vips::Region` and `Region#fetch` [jcupitt]
+
 ## Version 2.0.15 (2019-6-12)
 
 * better error messages from `write_to_memory` [linkyndy]

data/Gemfile

@@ -1,4 +1,11 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # all gems are handled by .gemspec (since this repo is for a gem)
 gemspec
+
+group :maintenance, optional: true do
+	gem "bake"
+	gem "bake-gem"
+end
+
+gem "github-markup"

data/README.md

@@ -1,27 +1,26 @@
 # Vips
 
+[![Gem Version](https://badge.fury.io/rb/ruby-vips.svg)](https://badge.fury.io/rb/ruby-vips)
+[![Test](https://github.com/libvips/ruby-vips/workflows/Test/badge.svg)](https://github.com/libvips/ruby-vips/actions?query=workflow%3ATest)
+
 This gem is a backwards compatible fork of `ruby-vips` but also includes (and compiles) the [libvips] source code.
 
-[![Build Status](https://secure.travis-ci.org/ioquatix/vips.svg)](http://travis-ci.org/ioquatix/vips)
+libvips is a [demand-driven, horizontally
+threaded](https://github.com/libvips/libvips/wiki/Why-is-libvips-quick)
+image processing library. Compared to similar
+libraries, [libvips runs quickly and uses little
+memory](https://github.com/libvips/libvips/wiki/Speed-and-memory-use).
+libvips is licensed under the [LGPL
+2.1+](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html).
 
-[libvips]: https://jcupitt.github.io/libvips
+[libvips]: https://libvips.github.io/libvips
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'vips'
+``` shell
+$ bundle add vips
 ```
 
-And then execute:
-
-	$ bundle
-
-Or install it yourself as:
-
-	$ gem install vips
-
 You'll still need to install `glib` and `gobject-introspection`.
 
 ## Usage
@@ -38,7 +37,24 @@ Exactly the same way as [ruby-vips].
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
 
-## License
+## Documentation
+
+There are [full API docs for ruby-vips on
+rubydoc](https://www.rubydoc.info/gems/ruby-vips). This sometimes has issues
+updating, so we have a [copy on the gh-pages for this site as
+well](http://libvips.github.io/ruby-vips), which
+should always work.
+
+See the `Vips` section in the docs for a [tutorial introduction with
+examples](https://www.rubydoc.info/gems/ruby-vips/Vips).
+
+The [libvips reference manual](https://libvips.github.io/libvips/API/current/)
+has a complete explanation of every method.
+
+The [`example/`](https://github.com/libvips/ruby-vips/tree/master/example)
+directory has some simple example programs.
+
+## Benchmarks
 
 Released under the MIT license.
 

data/Rakefile

@@ -1,28 +1,33 @@
 require "bundler/gem_tasks"
-require "rspec/core/rake_task"
 
-RSpec::Core::RakeTask.new(:test)
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  warn e.message
+  warn "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
 
-task :default => :test
+require "rake"
 
-task :ext do
-	Dir.chdir "ext" do
-		sh "rake"
-	end
+require "rspec/core"
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList["spec/**/*_spec.rb"]
 end
 
-task :console do
-	require 'pry'
-	
-	require_relative 'lib/vips'
-	
-	Pry.start
+task default: :spec
+
+task :ext do
+  Dir.chdir "ext" do
+    sh "rake"
+  end
 end
 
-require "yard/rake/yardoc_task"
+unless RUBY_PLATFORM.include?("java")
+  require "github/markup"
+  require "yard"
+  require "yard/rake/yardoc_task"
 
-YARD::Rake::YardocTask.new do |yard|
-	require "yard"
-	require "github/markup"
-	require "redcarpet"
+  YARD::Rake::YardocTask.new
 end

data/TODO

@@ -0,0 +1,43 @@
+# Notes
+
+- We should support complex constants, eg: 
+
+	Complex(1, 2)
+	=> (1+2i)
+
+# Common operations
+
+- Lint.
+
+	bundle exec standardrb
+
+- Reinstall local copy of gem after a change.
+
+	bundle exec rake install
+
+- Run test suite.
+
+	bundle exec rake 
+
+- Version bump.
+
+	edit lib/vips/version.rb 
+	edit VERSION
+
+- Regenerate autodocs.
+
+	cd lib/vips
+	ruby > methods.rb
+	require "vips"; Vips::Yard.generate
+	^D
+
+- Regenerate docs.
+
+	bundle exec rake yard
+
+- Push new gem to rubygems, tag repository with version.
+
+	bundle exec rake release
+
+  You'll be asked for a otp from authy / google authenticator / etc. 
+

data/example/annotate.rb

@@ -1,17 +1,17 @@
 #!/usr/bin/ruby
 
-require 'vips'
+require "vips"
 
-im = Vips::Image.new_from_file ARGV[0], :access => :sequential
+im = Vips::Image.new_from_file ARGV[0], access: :sequential
 
-left_text = Vips::Image.text "left corner", :dpi => 300
+left_text = Vips::Image.text "left corner", dpi: 300
 left = left_text.embed 50, 50, im.width, 150
 
-right_text = Vips::Image.text "right corner", :dpi => 300
+right_text = Vips::Image.text "right corner", dpi: 300
 right = right_text.embed im.width - right_text.width - 50, 50, im.width, 150
 
-footer = (left | right).ifthenelse(0, [255, 0, 0], :blend => true)
+footer = (left | right).ifthenelse(0, [255, 0, 0], blend: true)
 
-im = im.insert footer, 0, im.height, :expand => true
+im = im.insert footer, 0, im.height, expand: true
 
 im.write_to_file ARGV[1]

data/example/connection.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby
+
+require "vips"
+require "down/http"
+
+# byte_source = File.open ARGV[0], "rb"
+# eg. https://images.unsplash.com/photo-1491933382434-500287f9b54b
+byte_source = Down::Http.open(ARGV[0])
+
+source = Vips::SourceCustom.new
+source.on_read do |length|
+  puts "reading #{length} bytes ..."
+  byte_source.read length
+end
+source.on_seek do |offset, whence|
+  puts "seeking to #{offset}, #{whence}"
+  byte_source.seek(offset, whence)
+end
+
+byte_target = File.open ARGV[1], "wb"
+target = Vips::TargetCustom.new
+target.on_write { |chunk| byte_target.write(chunk) }
+target.on_finish { byte_target.close }
+
+image = Vips::Image.new_from_source source, "", access: :sequential
+image.write_to_target target, ".jpg"

data/example/daltonize8.rb

@@ -7,7 +7,7 @@
 # http://libvips.blogspot.co.uk/2013/05/daltonize-in-ruby-vips-carrierwave-and.html
 # for a discussion of this code
 
-require 'vips'
+require "vips"
 
 # Vips.set_debug true
 
@@ -29,13 +29,13 @@ im = Vips::Image.new_from_file ARGV[0]
 alpha = nil
 if im.bands == 4
   alpha = im[3]
-  im = im.extract_band 0, :n => 3
+  im = im.extract_band 0, n: 3
 end
 
 begin
   # import to XYZ with lcms
   # if there's no profile there, we'll fall back to the thing below
-  xyz = im.icc_import :embedded => true, :pcs => :xyz
+  xyz = im.icc_import embedded: true, pcs: :xyz
 rescue Vips::Error
   # nope .. use the built-in converter instead
   xyz = im.colourspace :xyz
@@ -61,9 +61,9 @@ rgb = xyz.colourspace :srgb
 err = im - rgb
 
 # add the error back to other channels to make a compensated image
-im = im + err.recomb([[0, 0, 0],
-                      [0.7, 1, 0],
-                      [0.7, 0, 1]])
+im += err.recomb([[0, 0, 0],
+  [0.7, 1, 0],
+  [0.7, 0, 1]])
 
 # reattach any alpha we saved above
 if alpha

data/example/draw_lines.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby
+
+require "vips"
+
+# load and stream into memory
+image = Vips::Image.new_from_file(ARGV[0], access: :sequential).copy_memory
+
+starting = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+
+lines = image
+(0..1).step 0.01 do |i|
+  lines = lines.draw_line 255, lines.width * i, 0, 0, lines.height * (1 - i)
+end
+
+ending = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+puts "non-destructive took #{ending - starting}s"
+
+starting = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+
+lines = image
+lines = lines.mutate do |x|
+  (0..1).step 0.01 do |i|
+    x.draw_line! 255, x.width * i, 0, 0, x.height * (1 - i)
+  end
+end
+
+ending = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+puts "mutate took #{ending - starting}s"
+
+lines.write_to_file ARGV[1]

data/example/example1.rb

@@ -1,9 +1,9 @@
-#!/usr/bin/env ruby
+#!/usr/bin/ruby
 
-require 'logger'
-require 'vips'
+require "logger"
+require "vips"
 
-GLib::logger.level = Logger::DEBUG
+GLib.logger.level = Logger::DEBUG
 
 Vips::Operation.new "black"
 

data/example/example2.rb

@@ -1,16 +1,16 @@
 #!/usr/bin/ruby
 
-require 'logger'
-require 'vips'
+require "logger"
+require "vips"
 
 puts ""
 puts "starting up:"
 
 # this makes vips keep a list of all active objects which we can print out
-Vips::leak_set true
+Vips.leak_set true
 
 # disable the operation cache
-Vips::cache_set_max 0
+Vips.cache_set_max 0
 
 # GLib::logger.level = Logger::DEBUG
 
@@ -20,7 +20,7 @@ n.times do |i|
   puts ""
   puts "call #{i} ..."
   out = Vips::Operation.call "black", [200, 300]
-  if out.width != 200 or out.height != 300
+  if out.width != 200 || out.height != 300
     puts "bad image result from black"
   end
 end
@@ -28,7 +28,7 @@ end
 puts ""
 puts "after #{n} calls:"
 GC.start
-Vips::Object::print_all
+Vips::Object.print_all
 
 puts ""
 puts "shutting down:"

data/example/example3.rb

@@ -1,19 +1,19 @@
 #!/usr/bin/ruby
 
-require 'vips'
+require "vips"
 
 # this makes vips keep a list of all active objects
-Vips::leak_set true
+Vips.leak_set true
 
 # disable the operation cache
 # Vips::cache_set_max 0
 
 # turn on debug logging
-GLib::logger.level = Logger::DEBUG
+GLib.logger.level = Logger::DEBUG
 
-1.times do |i|
+10.times do |i|
   puts "loop #{i} ..."
   im = Vips::Image.new_from_file ARGV[0]
-  im = im.embed 100, 100, 3000, 3000, :extend => :mirror
+  im = im.embed 100, 100, 3000, 3000, extend: :mirror
   im.write_to_file "x.v"
 end

data/example/example4.rb

@@ -1,9 +1,9 @@
 #!/usr/bin/ruby
 
-require 'vips'
+require "vips"
 
 # this makes vips keep a list of all active objects
-Vips::leak_set true
+Vips.leak_set true
 
 # disable the operation cache
 # Vips::cache_set_max 0

data/example/example5.rb

@@ -1,6 +1,6 @@
 #!/usr/bin/ruby
 
-require 'vips'
+require "vips"
 
 # this makes vips keep a list of all active objects
 # Vips::leak_set true
@@ -15,7 +15,7 @@ if ARGV.length < 2
   raise "usage: #{$PROGRAM_NAME}: input-file output-file"
 end
 
-im = Vips::Image.new_from_file ARGV[0], :access => :sequential
+im = Vips::Image.new_from_file ARGV[0], access: :sequential
 
 im *= [1, 2, 1]
 
@@ -23,8 +23,8 @@ im *= [1, 2, 1]
 # make it ourselves
 # if you are OK with scale=1, you can just pass the array directly to .conv()
 mask = Vips::Image.new_from_array [[-1, -1, -1],
-                                   [-1, 16, -1],
-                                   [-1, -1, -1]], 8
+  [-1, 16, -1],
+  [-1, -1, -1]], 8
 im = im.conv mask
 
 im.write_to_file ARGV[1]