win32screenshot 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 715102dbb42b3d540877ce3c29143f96cdb82038e6693807e174630b0c212df7
-  data.tar.gz: 8b9e11a96da5eb9fbc917d8ed84bcff3d9235e41d6ebb0c8abcd5c386f7899e3
+  metadata.gz: af9b9611193b8f4cc8d98745a6130cf16fe6fb2674e26e76a3745e34cf8de959
+  data.tar.gz: 278502bd7bc360a2813db04f590ee82b706eaee894cd6ce252227acb0765676e
 SHA512:
-  metadata.gz: 237afec95fe95cf6b209fad244763c350adbfdd6477d72d6b74af6c7783cd33fb09d20f4a1f06aa07251529344bb190b17a43250c465239095b772e5d4407cb7
-  data.tar.gz: d36b345764cd101b823a2b742f96947b9137634739c00c08249159c2f5453a9ebf84a199692279f6e37fb8a78e008ae2ebb9fe356109c6bcc509aeb93e68f0b8
+  metadata.gz: 636cfeb1613a8b84a000b1c5b449168cf398306bfbe47de4ac882ad6bfbb5e461055e921b63cc17ad4bd1f915fc6e13c582158da5518f835813f41b55662f947
+  data.tar.gz: 1209209433553596e94ed0a65c67becbb652756eca79ac3ff00777e5cc8b29ea8faa9eea42312303d048bd5121a985622e5aac93db1a55e86242f3fa196d92a4

data/CHANGES.md

@@ -1,3 +1,6 @@
+# 3.1.0 2022-02-05
+*   Update dependencies
+
 # 3.0.0 2019-12-11
 *   Use RAutomation 1.0.0 as its dependency to be able to use newer ffi.
 *   Update bundled ImageMagick to 7.0.9-8.

data/Gemfile.lock

@@ -1,39 +1,45 @@
 PATH
   remote: .
   specs:
-    win32screenshot (3.0.0)
-      ffi (~> 1.11.0)
+    win32screenshot (3.1.0)
+      ffi (~> 1.15.0)
       mini_magick (~> 4.9)
-      rautomation (~> 1.0.0)
+      rautomation (~> 1.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.2.1)
-    ffi (1.11.3-x86-mingw32)
-    mini_magick (4.9.5)
-    rake (10.1.0)
-    rautomation (1.0.0)
-      ffi (~> 1.11.0)
-    rspec (2.13.0)
-      rspec-core (~> 2.13.0)
-      rspec-expectations (~> 2.13.0)
-      rspec-mocks (~> 2.13.0)
-    rspec-core (2.13.0)
-    rspec-expectations (2.13.0)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.13.0)
-    yard (0.9.20)
+    diff-lcs (1.5.0)
+    ffi (1.15.5-x86-mingw32)
+    mini_magick (4.11.0)
+    rake (13.0.6)
+    rautomation (1.1.0)
+      ffi (~> 1.15.0)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.2)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    webrick (1.7.0)
+    yard (0.9.27)
+      webrick (~> 1.7.0)
 
 PLATFORMS
-  ruby
   x86-mingw32
 
 DEPENDENCIES
   rake
-  rspec (~> 2.5)
+  rspec (~> 3.10)
   win32screenshot!
   yard
 
 BUNDLED WITH
-   1.17.2
+   2.3.3

data/lib/win32/screenshot/version.rb

@@ -1,5 +1,5 @@
-module Win32
-  module Screenshot
-    VERSION = "3.0.0"
-  end
-end
+module Win32
+  module Screenshot
+    VERSION = "3.1.0"
+  end
+end

data/spec/spec_helper.rb

@@ -1,47 +1,47 @@
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-require 'win32/screenshot'
-require 'rspec'
-require 'fileutils'
-
-module SpecHelper
-  HWND_TOPMOST = -1
-  HWND_NOTOPMOST = -2
-  SWP_NOSIZE = 1
-  SWP_NOMOVE = 2
-  SWP_SHOWWINDOW = 40
-
-  extend FFI::Library
-  ffi_lib 'user32'
-  ffi_convention :stdcall
-
-  # user32.dll
-  attach_function :set_window_pos, :SetWindowPos,
-                  [:long, :long, :int, :int, :int, :int, :int], :bool
-  
-  def save_and_verify_image(img, file=nil)
-    FileUtils.mkdir @temp_dir unless File.exists?(@temp_dir)
-    file_name = File.join @temp_dir, "#{file}.bmp"
-    img.write file_name
-    img.bitmap[0..1].should == 'BM'
-  end
-
-  def resize title
-    hwnd = RAutomation::Window.new(:title => title).hwnd
-    set_window_pos(hwnd,
-                   HWND_TOPMOST,
-                   0, 0, 150, 238,
-                   SWP_NOMOVE)
-    set_window_pos(hwnd,
-                   HWND_NOTOPMOST,
-                   0, 0, 0, 0,
-                   SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE)
-    sleep 1
-  end
-end
-
-RSpec.configure do |config|
-  config.include(SpecHelper)
-  config.before(:suite) {FileUtils.rm Dir.glob(File.join(File.dirname(__FILE__), "tmp/*"))}
-  config.before(:all) {@temp_dir = File.join(File.dirname(__FILE__), 'tmp')}
-end
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'win32/screenshot'
+require 'rspec'
+require 'fileutils'
+
+module SpecHelper
+  HWND_TOPMOST = -1
+  HWND_NOTOPMOST = -2
+  SWP_NOSIZE = 1
+  SWP_NOMOVE = 2
+  SWP_SHOWWINDOW = 40
+
+  extend FFI::Library
+  ffi_lib 'user32'
+  ffi_convention :stdcall
+
+  # user32.dll
+  attach_function :set_window_pos, :SetWindowPos,
+                  [:long, :long, :int, :int, :int, :int, :int], :bool
+  
+  def save_and_verify_image(img, file=nil)
+    FileUtils.mkdir @temp_dir unless File.exists?(@temp_dir)
+    file_name = File.join @temp_dir, "#{file}.bmp"
+    img.write file_name
+    expect(img.bitmap[0..1]).to eq('BM')
+  end
+
+  def resize title
+    hwnd = RAutomation::Window.new(:title => title).hwnd
+    set_window_pos(hwnd,
+                   HWND_TOPMOST,
+                   0, 0, 150, 238,
+                   SWP_NOMOVE)
+    set_window_pos(hwnd,
+                   HWND_NOTOPMOST,
+                   0, 0, 0, 0,
+                   SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE)
+    sleep 1
+  end
+end
+
+RSpec.configure do |config|
+  config.include(SpecHelper)
+  config.before(:suite) {FileUtils.rm Dir.glob(File.join(File.dirname(__FILE__), "tmp/*"))}
+  config.before(:all) {@temp_dir = File.join(File.dirname(__FILE__), 'tmp')}
+end

data/spec/win32/screenshot/image_spec.rb

@@ -1,78 +1,78 @@
-require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
-
-describe Win32::Screenshot::Image do
-
-  before :all do
-    IO.popen("notepad")
-    @notepad = RAutomation::Window.new(:title => /notepad/i).pid
-    @image = Win32::Screenshot::Take.of(:window, :pid => @notepad)
-  end
-
-  describe "stores raw bitmap data" do
-    it "#bitmap" do
-      @image.bitmap[0..1].should == 'BM'
-    end
-  end
-
-  describe "saving the image to the disk" do
-    context "saving to the bmp format" do
-      it "#write" do
-        file_path = @temp_dir + '/image.bmp'
-        expect {@image.write(file_path)}.to_not raise_exception
-        File.open(file_path, "rb") {|io| io.read}[0..1].should == "BM"
-      end
-    end
-
-    context "saving to the png format" do
-      it "#write" do
-        file_path = @temp_dir + '/image.png'
-        expect {@image.write(file_path)}.to_not raise_exception
-        File.open(file_path, "rb") {|io| io.read}[0..3].should == "\211PNG".force_encoding(Encoding::ASCII_8BIT)
-      end
-    end
-
-    context "trying to save to the unknown format" do
-      it "#write" do
-        file_path = @temp_dir + '/image.notknown'
-        expect {@image.write(file_path)}.
-                to raise_exception("File '#{file_path}' has to have one of the following extensions: #{Win32::Screenshot::Image::FORMATS.join(", ")}")
-        File.should_not exist(file_path)
-      end
-    end
-
-    context "trying to save with the filename without an extension" do
-      it "#write" do
-        file_path = @temp_dir + '/image'
-        expect {@image.write(file_path)}.
-                to raise_exception("File '#{file_path}' has to have one of the following extensions: #{Win32::Screenshot::Image::FORMATS.join(", ")}")
-        File.should_not exist(file_path)
-      end
-    end
-
-    context "not allowing to overwrite existing files" do
-      it "#write" do
-        file_path = @temp_dir + '/invalid-image.png'
-        content = "invalid content"
-        File.open(file_path, "w") {|io| io.write content}
-        expect {@image.write(file_path)}.to raise_exception("File already exists: #{file_path}!")
-        File.size(file_path).should == content.size
-      end
-    end
-
-    context "allowing to overwrite existing files when desired" do
-      it "#write!" do
-        file_path = @temp_dir + '/overwritten-image.png'
-        content = "content"
-        File.open(file_path, "w") {|io| io.write content}
-        @image.write!(file_path)
-        File.size(file_path).should_not eq(content.size)
-      end
-    end    
-  end
-
-  after :all do
-    # kill in a jruby friendly way
-    system("taskkill /PID #{@notepad} > nul")
-  end
-
-end
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe Win32::Screenshot::Image do
+
+  before :all do
+    IO.popen("notepad")
+    @notepad = RAutomation::Window.new(:title => /notepad/i).pid
+    @image = Win32::Screenshot::Take.of(:window, :pid => @notepad)
+  end
+
+  describe "stores raw bitmap data" do
+    it "#bitmap" do
+      expect(@image.bitmap[0..1]).to eq('BM')
+    end
+  end
+
+  describe "saving the image to the disk" do
+    context "saving to the bmp format" do
+      it "#write" do
+        file_path = @temp_dir + '/image.bmp'
+        expect {@image.write(file_path)}.to_not raise_exception
+        expect(File.open(file_path, "rb") {|io| io.read}[0..1]).to eq("BM")
+      end
+    end
+
+    context "saving to the png format" do
+      it "#write" do
+        file_path = @temp_dir + '/image.png'
+        expect {@image.write(file_path)}.to_not raise_exception
+        expect(File.open(file_path, "rb") {|io| io.read}[0..3]).to eq("\211PNG".force_encoding(Encoding::ASCII_8BIT))
+      end
+    end
+
+    context "trying to save to the unknown format" do
+      it "#write" do
+        file_path = @temp_dir + '/image.notknown'
+        expect {@image.write(file_path)}.
+                to raise_exception("File '#{file_path}' has to have one of the following extensions: #{Win32::Screenshot::Image::FORMATS.join(", ")}")
+        expect(File.exist?(file_path)).to eq(false)
+      end
+    end
+
+    context "trying to save with the filename without an extension" do
+      it "#write" do
+        file_path = @temp_dir + '/image'
+        expect {@image.write(file_path)}.
+                to raise_exception("File '#{file_path}' has to have one of the following extensions: #{Win32::Screenshot::Image::FORMATS.join(", ")}")
+        expect(File.exist?(file_path)).to eq(false)
+      end
+    end
+
+    context "not allowing to overwrite existing files" do
+      it "#write" do
+        file_path = @temp_dir + '/invalid-image.png'
+        content = "invalid content"
+        File.open(file_path, "w") {|io| io.write content}
+        expect {@image.write(file_path)}.to raise_exception("File already exists: #{file_path}!")
+        expect(File.size(file_path)).to eq(content.size)
+      end
+    end
+
+    context "allowing to overwrite existing files when desired" do
+      it "#write!" do
+        file_path = @temp_dir + '/overwritten-image.png'
+        content = "content"
+        File.open(file_path, "w") {|io| io.write content}
+        @image.write!(file_path)
+        expect(File.size(file_path)).to_not eq(content.size)
+      end
+    end    
+  end
+
+  after :all do
+    # kill in a jruby friendly way
+    system("taskkill /PID #{@notepad} > nul")
+  end
+
+end

data/spec/win32/screenshot/take_spec.rb

@@ -1,151 +1,151 @@
-require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
-
-describe Win32::Screenshot::Take do
-
-  before :all do
-    Dir.chdir("c:/program files/Internet Explorer") { IO.popen(".\\iexplore about:blank") }
-    IO.popen("notepad")
-    @iexplore = RAutomation::Window.new(:title => /internet explorer/i).pid
-    @notepad = RAutomation::Window.new(:title => /notepad/i).pid
-  end
-
-  it "captures the foreground" do
-    image = Win32::Screenshot::Take.of(:foreground)
-    save_and_verify_image(image, 'foreground')
-    hwnd = Win32::Screenshot::BitmapMaker.foreground_window
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(hwnd, :window)
-  end
-
-  it "captures an area of the foreground" do
-    image = Win32::Screenshot::Take.of(:foreground, :area => [30, 30, 100, 150])
-    save_and_verify_image(image, 'foreground_area')
-    image.width.should == 70
-    image.height.should == 120
-  end
-
-  it "doesn't allow to capture an area of the foreground with invalid coordinates" do
-    expect {Win32::Screenshot::Take.of(:foreground, :area => [0, 0, -1, 100])}.
-            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: -1, y2: 100) are invalid - cannot be negative!")
-  end
-
-  it "captures the desktop" do
-    image = Win32::Screenshot::Take.of(:desktop)
-    save_and_verify_image(image, 'desktop')
-    hwnd = Win32::Screenshot::BitmapMaker.desktop_window
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(hwnd, :window)
-  end
-
-  it "captures an area of the desktop" do
-    image = Win32::Screenshot::Take.of(:desktop, :area => [30, 30, 100, 150])
-    save_and_verify_image(image, 'desktop_area')
-    image.width.should == 70
-    image.height.should == 120
-  end
-
-  it "doesn't allow to capture an area of the desktop with invalid coordinates" do
-    expect {Win32::Screenshot::Take.of(:desktop, :area => [0, 0, -1, 100])}.
-            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: -1, y2: 100) are invalid - cannot be negative!")
-  end
-
-  it "captures a maximized window" do
-    window = RAutomation::Window.new(:pid => @iexplore)
-    window.maximize
-    image = Win32::Screenshot::Take.of(:window, :pid => @iexplore)
-    save_and_verify_image(image, 'iexplore_max')
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-  end
-
-  it "captures a minimized window" do
-    window = RAutomation::Window.new(:pid => @notepad)
-    window.minimize
-    image = Win32::Screenshot::Take.of(:window, :pid => @notepad)
-    save_and_verify_image(image, 'notepad_min')
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-  end
-
-  it "captures a small window" do
-    title = /Internet Explorer/
-    resize(title)
-    image = Win32::Screenshot::Take.of(:window, :pid => @iexplore)
-    save_and_verify_image(image, 'iexplore_resized')
-
-    # we should get the size of the picture because
-    # screenshot doesn't include titlebar and the size
-    # varies between different themes and Windows versions
-    window = RAutomation::Window.new(:pid => @iexplore)
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-  end
-
-  it "captures a window context of the window" do
-    image = Win32::Screenshot::Take.of(:window, :pid => @notepad, :context => :window)
-    save_and_verify_image(image, 'notepad_context_window')
-    window = RAutomation::Window.new(:pid => @notepad)
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-  end
-
-  it "captures a client context of the window" do
-    image = Win32::Screenshot::Take.of(:window, :pid => @notepad, :context => :client)
-    save_and_verify_image(image, 'notepad_context_client')
-    window = RAutomation::Window.new(:pid => @notepad)
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :client)
-  end
-
-  it "captures an area of the window" do
-    image = Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [30, 30, 100, 150])
-    save_and_verify_image(image, 'notepad_area')
-    image.width.should == 70
-    image.height.should == 120
-  end
-
-  it "captures by the RAutomation::Window" do
-    window = RAutomation::Window.new(:pid => @notepad)
-    image = Win32::Screenshot::Take.of(:window, :rautomation => window)
-    save_and_verify_image(image, 'notepad_rautomation')
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-  end
-
-  it "captures a child windows" do
-    window = RAutomation::Window.new(:pid => @iexplore).child(:class => "Internet Explorer_Server")
-    image = Win32::Screenshot::Take.of(:window, :rautomation => window)
-    save_and_verify_image(image, 'iexplore_child')
-    [image.width, image.height].should == Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-  end
-
-  it "captures a whole window if window size is specified as coordinates" do
-    window = RAutomation::Window.new(:pid => @notepad)
-    expected_width, expected_height = Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-    image = Win32::Screenshot::Take.of(:window, :rautomation => window, :area => [0, 0, expected_width, expected_height])
-    save_and_verify_image(image, 'notepad_area_full_window')
-    image.width.should == expected_width
-    image.height.should == expected_height
-  end
-
-  it "doesn't allow to capture an area of the window with negative coordinates" do
-    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [0, 0, -1, 100])}.
-            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: -1, y2: 100) are invalid - cannot be negative!")
-  end
-
-  it "doesn't allow to capture an area of the window if coordinates are the same" do
-    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [10, 0, 10, 20])}.
-            to raise_exception("specified coordinates (x1: 10, y1: 0, x2: 10, y2: 20) are invalid - cannot be x1 >= x2 or y1 >= y2!")
-  end
-
-  it "doesn't allow to capture an area of the window if second coordinate is smaller than first one" do
-    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [0, 10, 10, 9])}.
-            to raise_exception("specified coordinates (x1: 0, y1: 10, x2: 10, y2: 9) are invalid - cannot be x1 >= x2 or y1 >= y2!")
-  end
-
-  it "doesn't allow to capture an area of the window with too big coordinates" do
-    window = RAutomation::Window.new(:pid => @notepad)
-    expected_width, expected_height = Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
-    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [0, 0, 10, 100000])}.
-            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: 10, y2: 100000) are invalid - maximum x2: #{expected_width} and y2: #{expected_height}!")
-  end
-
-  after :all do
-    [@iexplore, @notepad].each do |pid|
-      # kill them in a jruby friendly way
-      system("taskkill /PID #{pid} > nul")
-    end
-  end
-end
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe Win32::Screenshot::Take do
+
+  before :all do
+    Dir.chdir("c:/program files/Internet Explorer") { IO.popen(".\\iexplore about:blank") }
+    IO.popen("notepad")
+    @iexplore = RAutomation::Window.new(:title => /internet explorer/i).pid
+    @notepad = RAutomation::Window.new(:title => /notepad/i).pid
+  end
+
+  it "captures the foreground" do
+    image = Win32::Screenshot::Take.of(:foreground)
+    save_and_verify_image(image, 'foreground')
+    hwnd = Win32::Screenshot::BitmapMaker.foreground_window
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(hwnd, :window))
+  end
+
+  it "captures an area of the foreground" do
+    image = Win32::Screenshot::Take.of(:foreground, :area => [30, 30, 100, 150])
+    save_and_verify_image(image, 'foreground_area')
+    expect(image.width).to eq(70)
+    expect(image.height).to eq(120)
+  end
+
+  it "doesn't allow to capture an area of the foreground with invalid coordinates" do
+    expect {Win32::Screenshot::Take.of(:foreground, :area => [0, 0, -1, 100])}.
+            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: -1, y2: 100) are invalid - cannot be negative!")
+  end
+
+  it "captures the desktop" do
+    image = Win32::Screenshot::Take.of(:desktop)
+    save_and_verify_image(image, 'desktop')
+    hwnd = Win32::Screenshot::BitmapMaker.desktop_window
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(hwnd, :window))
+  end
+
+  it "captures an area of the desktop" do
+    image = Win32::Screenshot::Take.of(:desktop, :area => [30, 30, 100, 150])
+    save_and_verify_image(image, 'desktop_area')
+    expect(image.width).to eq(70)
+    expect(image.height).to eq(120)
+  end
+
+  it "doesn't allow to capture an area of the desktop with invalid coordinates" do
+    expect {Win32::Screenshot::Take.of(:desktop, :area => [0, 0, -1, 100])}.
+            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: -1, y2: 100) are invalid - cannot be negative!")
+  end
+
+  it "captures a maximized window" do
+    window = RAutomation::Window.new(:pid => @iexplore)
+    window.maximize
+    image = Win32::Screenshot::Take.of(:window, :pid => @iexplore)
+    save_and_verify_image(image, 'iexplore_max')
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window))
+  end
+
+  it "captures a minimized window" do
+    window = RAutomation::Window.new(:pid => @notepad)
+    window.minimize
+    image = Win32::Screenshot::Take.of(:window, :pid => @notepad)
+    save_and_verify_image(image, 'notepad_min')
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window))
+  end
+
+  it "captures a small window" do
+    title = /Internet Explorer/
+    resize(title)
+    image = Win32::Screenshot::Take.of(:window, :pid => @iexplore)
+    save_and_verify_image(image, 'iexplore_resized')
+
+    # we should get the size of the picture because
+    # screenshot doesn't include titlebar and the size
+    # varies between different themes and Windows versions
+    window = RAutomation::Window.new(:pid => @iexplore)
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window))
+  end
+
+  it "captures a window context of the window" do
+    image = Win32::Screenshot::Take.of(:window, :pid => @notepad, :context => :window)
+    save_and_verify_image(image, 'notepad_context_window')
+    window = RAutomation::Window.new(:pid => @notepad)
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window))
+  end
+
+  it "captures a client context of the window" do
+    image = Win32::Screenshot::Take.of(:window, :pid => @notepad, :context => :client)
+    save_and_verify_image(image, 'notepad_context_client')
+    window = RAutomation::Window.new(:pid => @notepad)
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :client))
+  end
+
+  it "captures an area of the window" do
+    image = Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [30, 30, 100, 150])
+    save_and_verify_image(image, 'notepad_area')
+    expect(image.width).to eq(70)
+    expect(image.height).to eq(120)
+  end
+
+  it "captures by the RAutomation::Window" do
+    window = RAutomation::Window.new(:pid => @notepad)
+    image = Win32::Screenshot::Take.of(:window, :rautomation => window)
+    save_and_verify_image(image, 'notepad_rautomation')
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window))
+  end
+
+  it "captures a child windows" do
+    window = RAutomation::Window.new(:pid => @iexplore).child(:class => "Internet Explorer_Server")
+    image = Win32::Screenshot::Take.of(:window, :rautomation => window)
+    save_and_verify_image(image, 'iexplore_child')
+    expect([image.width, image.height]).to eq(Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window))
+  end
+
+  it "captures a whole window if window size is specified as coordinates" do
+    window = RAutomation::Window.new(:pid => @notepad)
+    expected_width, expected_height = Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
+    image = Win32::Screenshot::Take.of(:window, :rautomation => window, :area => [0, 0, expected_width, expected_height])
+    save_and_verify_image(image, 'notepad_area_full_window')
+    expect(image.width).to eq(expected_width)
+    expect(image.height).to eq(expected_height)
+  end
+
+  it "doesn't allow to capture an area of the window with negative coordinates" do
+    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [0, 0, -1, 100])}.
+            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: -1, y2: 100) are invalid - cannot be negative!")
+  end
+
+  it "doesn't allow to capture an area of the window if coordinates are the same" do
+    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [10, 0, 10, 20])}.
+            to raise_exception("specified coordinates (x1: 10, y1: 0, x2: 10, y2: 20) are invalid - cannot be x1 >= x2 or y1 >= y2!")
+  end
+
+  it "doesn't allow to capture an area of the window if second coordinate is smaller than first one" do
+    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [0, 10, 10, 9])}.
+            to raise_exception("specified coordinates (x1: 0, y1: 10, x2: 10, y2: 9) are invalid - cannot be x1 >= x2 or y1 >= y2!")
+  end
+
+  it "doesn't allow to capture an area of the window with too big coordinates" do
+    window = RAutomation::Window.new(:pid => @notepad)
+    expected_width, expected_height = Win32::Screenshot::BitmapMaker.dimensions_for(window.hwnd, :window)
+    expect {Win32::Screenshot::Take.of(:window, :pid => @notepad, :area => [0, 0, 10, 100000])}.
+            to raise_exception("specified coordinates (x1: 0, y1: 0, x2: 10, y2: 100000) are invalid - maximum x2: #{expected_width} and y2: #{expected_height}!")
+  end
+
+  after :all do
+    [@iexplore, @notepad].each do |pid|
+      # kill them in a jruby friendly way
+      system("taskkill /PID #{pid} > nul")
+    end
+  end
+end

data/win32screenshot.gemspec

@@ -1,25 +1,25 @@
-# -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "win32/screenshot/version"
-
-Gem::Specification.new do |s|
-  s.name = "win32screenshot"
-  s.version = Win32::Screenshot::VERSION
-  s.authors = ["Jarmo Pertman", "Aslak Hellesøy"]
-  s.email = ["jarmo.p@gmail.com", "aslak.hellesoy@gmail.com"]
-  s.description = "Capture Screenshots on Windows with Ruby to bmp, gif, jpg or png formats."
-  s.homepage = "http://github.com/jarmo/win32screenshot"
-  s.summary = "Capture Screenshots on Windows with Ruby to bmp, gif, jpg or png formats."
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- spec/*`.split("\n")
-  s.require_paths = ["lib"]
-  s.license = "MIT"
-  
-  s.add_dependency("ffi", "~> 1.11.0")
-  s.add_dependency("mini_magick", "~> 4.9")
-  s.add_dependency("rautomation", "~> 1.0.0")
-  
-  s.add_development_dependency("rspec", "~> 2.5")
-  s.add_development_dependency("yard")
-  s.add_development_dependency("rake")
-end
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "win32/screenshot/version"
+
+Gem::Specification.new do |s|
+  s.name = "win32screenshot"
+  s.version = Win32::Screenshot::VERSION
+  s.authors = ["Jarmo Pertman", "Aslak Hellesøy"]
+  s.email = ["jarmo.p@gmail.com", "aslak.hellesoy@gmail.com"]
+  s.description = "Capture Screenshots on Windows with Ruby to bmp, gif, jpg or png formats."
+  s.homepage = "http://github.com/jarmo/win32screenshot"
+  s.summary = "Capture Screenshots on Windows with Ruby to bmp, gif, jpg or png formats."
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  s.require_paths = ["lib"]
+  s.license = "MIT"
+  
+  s.add_dependency("ffi", "~> 1.15.0")
+  s.add_dependency("mini_magick", "~> 4.9")
+  s.add_dependency("rautomation", "~> 1.1.0")
+  
+  s.add_development_dependency("rspec", "~> 3.10")
+  s.add_development_dependency("yard")
+  s.add_development_dependency("rake")
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: win32screenshot
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Jarmo Pertman
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-11 00:00:00.000000000 Z
+date: 2022-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -17,14 +17,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.11.0
+        version: 1.15.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.11.0
+        version: 1.15.0
 - !ruby/object:Gem::Dependency
   name: mini_magick
   requirement: !ruby/object:Gem::Requirement
@@ -45,28 +45,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -121,7 +121,6 @@ files:
 - lib/win32/screenshot/image.rb
 - lib/win32/screenshot/take.rb
 - lib/win32/screenshot/version.rb
-- rdoc.rb
 - spec/spec_helper.rb
 - spec/win32/screenshot/image_spec.rb
 - spec/win32/screenshot/take_spec.rb

data/rdoc.rb

@@ -1,3 +0,0 @@
-require 'rdoc'
-h = RDoc::Markup::ToMarkdown.new
-puts h.convert(File.read(ARGV[0]))