vips 8.11.3 → 8.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d8cc116cc011d40275e97c4f71ed4de8c816986b0ea7f693569c1c8e1c389c6
-  data.tar.gz: b38e3424536c7c35da15394a1f79d29a1a70058280eaefb75a8e43372e50bddf
+  metadata.gz: 872a3771eee6d56c17254a27013a7ff1d002506965bf488fad3d055817457f1a
+  data.tar.gz: 76930aa9a3b5456460be220e3373c3a7ff573a86f18c3e07a3cd4ebbf37614af
 SHA512:
-  metadata.gz: 8f9014f781138d33232a3f7bd88706a0cc3b6f494a9ea48def52d5f1e4db6d2fce07eca88782c9130121866cd6b9231d2f96dde5f5064a9739cdd9fc1074cb12
-  data.tar.gz: 60273f63fc6289240650c675141afe46037cc301926f691507dfd3a39971dd236cebd1ee964df090f4e911a17f33141bd614223de1492a74ba1f954c7ed816ad
+  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/.yardopts

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

data/CHANGELOG.md

@@ -0,0 +1,323 @@
+# Changelog
+
+## 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]
+* fix doc generation typo for array return [jcupitt]
+* update tests for libvips 8.8 [jcupitt]
+
+## Version 2.0.14 (2018-10-3)
+
+* update links for new home [jcupitt]
+* various doc fixes [janko-m]
+* add `Vips::get_suffixes` [jcupitt]
+* prefer options splat [ioquatix]
+* update docs for 8.8 [jcupitt]
+
+## Version 2.0.13 (2018-8-6)
+
+* allow optional args to have `nil` as a value [janko-m]
+* fix five small memleaks [kleisauke]
+
+## Version 2.0.12 (2018-4-25)
+
+* fix `Vips::Image#has_alpha?` with older libvips [larskanis]
+
+## Version 2.0.11 (2018-4-23)
+
+* fix init with older glib [lsat12357]
+* add `Vips::Image#has_alpha?` and `#add_alpha` [aried3r]
+
+## Version 2.0.10 (2017-12-21)
+
+* add support for uint64 parameters
+* add `draw_point` convenience method
+* add docs for `CompassDirection` [janko-m]
+* add `MAX_COORD` constant
+* doc fixes [janko-m]
+* remove duplicate function attach [janko-m]
+* fix a crash with `new_from_buffer` with a UTF-8 string [janko-m]
+
+## Version 2.0.9 (2017-12-21)
+
+* update docs for libvips 8.6
+
+## Version 2.0.8 (2017-09-14)
+
+* add `thumb.rb` example, and verify we run stably and in constant memory 
+* cleanups and polish [Nakilon]
+* add `composite` convenience method 
+* add `Vips::concurrency_set` and `Vips::vector_set`
+
+## Version 2.0.7 (2017-09-08)
+
+* disable the logging for now, it could deadlock
+
+## Version 2.0.6 (2017-09-02)
+
+* improve get() behaviour on error with older libvipses
+
+## Version 2.0.5 (2017-09-02)
+
+* fix get() with older libvipses
+
+## Version 2.0.4 (2017-09-02)
+
+* add a test for `get_fields`, since it appeared in libvips 8.5 (thanks zverok)
+
+## Version 2.0.3 (2017-09-02)
+
+* add `get_fields`
+
+## Version 2.0.2 (2017-08-26)
+
+* switch to `logger` for all logging output
+* add libvips cache control functions `Vips::cache_set_max()` etc.
+* fix a ref leak
+
+## Version 2.0.1 (2017-08-23)
+
+* add support for `VipsRefStr` in gvalue, thanks tomasc
+
+## Version 2.0.0 (2017-08-22)
+
+* rewrite on top of 'ffi' [John Cupitt, Kleis Auke Wolthuizen]
+
+## Version 1.0.6 (2017-07-17)
+
+* remove lazy load, fixing a race with multi-threading [felixbuenemann]
+* make `Image#to_a` much faster [John Cupitt]
+* remove the `at_exit` handler [John Cupitt]
+
+## Version 1.0.5 (2017-04-29)
+
+* fix `_const` for libvips 8.5 [John Cupitt]
+* add `scaleimage`, the scale operation renamed to avoid a clash with the
+  `scale` property [John Cupitt]
+* add `.new_from_image`: make a new image from a constant [John Cupitt]
+* `bandjoin` will use `bandjoin_const`, if it can [John Cupitt]
+* update generated docs for libvips 8.5 [John Cupitt]
+* added docs for new libvips 8.5 enums [John Cupitt]
+
+## Version 1.0.4 (2017-02-07)
+
+* remove stray comma from some docs lines [John Cupitt]
+* update generated docs for libvips 8.5 [John Cupitt]
+* small doc improvements [John Cupitt]
+* update for gobject-introspection 3.1 [John Cupitt]
+* support ruby 2.4 [John Cupitt]
+
+## Version 1.0.3 (2016-08-18)
+
+* doc improvements [John Cupitt]
+* add `Image#size` to get `[width, height]` [John Cupitt]
+* only ask for ruby 2.0 to help OS X [John Cupitt]
+* break up `Image.call` to make it easier to understand [John Cupitt]
+* detect operation build fail correctly [John Cupitt]
+* lock gobject-introspection at 3.0.8 to avoid breakage [John Cupitt]
+
+## Version 1.0.2 (2016-07-07)
+
+* add `.yardopts` to fix ruby-gems docs [John Cupitt]
+
+## Version 1.0.1 (2016-07-07)
+
+* simplify gemspec [sandstrom]
+* remove jeweler dependency [John Cupitt]
+* add `.to_a` to Image [John Cupitt]
+
+## Version 1.0.0 (2016-06-07)
+
+* complete rewrite, API break [John Cupitt]
+
+## Version 0.3.14 (2016-01-25)
+
+* more GC tuning [felixbuenemann]
+* add `write.rb` example program [felixbuenemann]
+
+## Version 0.3.13 (2016-01-18)
+
+* don't use generational GC options on old Rubys [John Cupitt]
+
+## Version 0.3.12 (2016-01-17)
+
+* incremental GC every 10 writes [felixbuenemann]
+* updated bundle [John Cupitt]
+
+## Version 0.3.11 (2015-10-15)
+
+* added magick load from buffer [John Cupitt]
+
+## Version 0.3.10 (2015-06-24)
+
+* added webp write [John Cupitt]
+
+## Version 0.3.9 (2014-07-17)
+
+* removed a stray file from gemspec [Alessandro Tagliapietra]
+* updated bundle [John Cupitt]
+* revised spec tests [John Cupitt]
+* fix a segv in im.label_regions [John Cupitt]
+* add a Valgrind suppressions file [John Cupitt]
+* fix .monotonic? [John Cupitt]
+* fix .data on coded images [John Cupitt]
+* add .size, see issue #58 [John Cupitt]
+* add rdoc-data dep, maybe it will help ruby-gems docs [John Cupitt]
+
+## Version 0.3.8 (2014-05-11)
+
+* add VIPS::thread_shutdown(), must be called on foreign thread exit [John Cupitt]
+
+## Version 0.3.7 (2014-02-04)
+
+* update build dependencies [John Cupitt]
+* README updated [John Cupitt]
+
+## Version 0.3.6 (2013-06-25)
+
+* add png and jpg load from memory buffer [John Cupitt]
+* README updated to include buffer read/write example [John Cupitt]
+* better vips version testing [John Cupitt]
+* spec tests for new buffer read/write code [John Cupitt]
+* fix rdoc build to include C sources [John Cupitt]
+* better compat with older libvips [John Cupitt]
+
+## Version 0.3.5 (2013-01-15)
+
+* rb_raise() in mask.c no longer passes a string pointer as the fmt arg, stopping gcc bailing out on some platforms [John Cupitt]
+* Image.magick() now calls im_magick2vips() directly rather than relying on libvips file type sniffing [John Cupitt]
+
+## Version 0.3.4 (2012-09-11)
+
+* Update specs for lcms changes, thanks Stanislaw [John Cupitt]
+* VIPS::Reader supports .exif() / .exif?() methods for better back compat, thanks Jeremy [John Cupitt]
+* VIPS::Reader fallbacks load the image if its not been loaded [John Cupitt]
+* VIPS::Reader no longer allows VIPS::Header methods [John Cupitt]
+
+## Version 0.3.3 (2012-08-31)
+
+* Typo in workaround in 0.3.2 [John Cupitt]
+
+## Version 0.3.2 (2012-08-31)
+
+### Fixed
+
+* Workaround helps ruby-vips compile (and run) against 7.26.3 [John Cupitt and 
+James Harrison]
+
+## Version 0.3.1 (2012-08-30)
+
+### Fixed
+
+* PNG writer no longer changes the filename argument [John Cupitt]
+* Workaround helps ruby-vips compile against 7.26.3 [John Cupitt]
+* Image read now runs GC and retries on fail [John Cupitt]
+* Image write GCs every 100 images [John Cupitt]
+
+## Version 0.3.0 (2012-07-20)
+
+### Added
+
+* More rspec tests [John Cupitt]
+* Updated to libvips-7.30 [John Cupitt]
+
+### Changed
+
+* Reworked Reader class offers better performance and compatibility [John
+  Cupitt]
+* Don't use :sequential option for older libvipses [John Cupitt]
+* Rename "tone_analyze" as "tone_analyse" for consistency with the rest of
+  vips [John  CUpitt]
+
+### Fixed
+
+* Now passes rspec test suite cleanly in valgrind [John Cupitt]
+* Fixed check of sequential mode support [Stanislaw Pankevich]
+
+## Version 0.2.0 (2012-06-29)
+
+### Added
+
+* Add tile_cache [John Cupitt]
+* Add :sequential option to tiff, jpeg and png readers [John Cupitt]
+* Add raise if suitable pkg_config for libvips is not found, thanks to Pierre
+  Chapuis [Stanislaw Pankevich]
+* Add backward compatibility of 0.1.x ruby-vips with libvips versions less than 7.28 [John Cupitt]
+* Add Travis. ruby-vips now is being tested on travis-ci.org. [Stanislaw Pankevich]
+
+### Changed
+
+* Disable the vips8 operation cache to save some memory [John Cupitt]
+* Update example shrinker [John Cupitt]
+
+### Fixed
+
+* #8: Memory allocation-free issues [Grigoriy Chudnov]
+
+## Version 0.1.1 (2012-06-22)
+
+### Changed
+
+* Upgrade spec/* code to latest RSpec  [Stanislaw Pankevich]
+
+### Added
+
+* Added CHANGELOG.md file (thanks to jnicklas/capybara - using the layout of their History.txt) [Stanislaw Pankevich]
+* Added Gemfile with the only 'rspec' dependency. [Stanislaw Pankevich]
+* Added Jeweler Rakefile contents to release ruby-vips as a gem. [Stanislaw Pankevich]
+
+## Before (initial unreleased version 0.1.0)
+
+Long-long history here undocumented...

data/Gemfile

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

data/README.md

@@ -1,29 +1,26 @@
 # Vips
 
-Programs that use `vips` don't manipulate images directly, instead they create pipelines of image processing operations building on a source image. When the end of the pipe is connected to a destination, the whole pipeline executes at once, streaming the image in parallel from source to destination a section at a time.  Because `ruby-vips` is parallel, it's quick, and because it doesn't need to keep entire images in memory, it's light.
+[![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://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
@@ -40,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

@@ -1,17 +1,26 @@
 #!/usr/bin/ruby
 
-require 'vips'
+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])
 
-file = File.open ARGV[0], "rb"
 source = Vips::SourceCustom.new
-source.on_read { |length| file.read length }
-# this method is optional
-# source.on_seek { |offset, whence| file.seek(offset, whence) }
+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
 
-dest = File.open ARGV[1], "wb"
+byte_target = File.open ARGV[1], "wb"
 target = Vips::TargetCustom.new
-target.on_write { |chunk| dest.write(chunk) }
-target.on_finish { dest.close }
+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, ".png"
+image.write_to_target target, ".jpg"