eyes_core 5.0.0 → 6.0.1

data/ext/eyes_core/eyes_core.c

@@ -1,252 +0,0 @@
-#include "eyes_core.h"
-
-void Init_eyes_core() {
-  VALUE Applitools = rb_define_module("Applitools");
-  VALUE Resampling = rb_define_module_under(Applitools, "ResamplingFast");
-  rb_define_method(Resampling, "resampling_first_step", c_resampling_first_step, 2);
-};
-
-VALUE c_resampling_first_step(VALUE self, VALUE dst_dimension_x, VALUE dst_dimension_y) {
-    PIXEL *source, *destination;
-    unsigned long int source_width, source_height, c_dst_dimension_x, c_dst_dimension_y, w_m, h_m;
-    VALUE result_array;
-
-    source_width = NUM2UINT(rb_funcall(self, rb_intern("width"), 0));
-    source_height = NUM2UINT(rb_funcall(self, rb_intern("height"), 0));
-
-    c_dst_dimension_x = NUM2UINT(dst_dimension_x);
-    c_dst_dimension_y = NUM2UINT(dst_dimension_y);
-
-    w_m = source_width / c_dst_dimension_x;
-    h_m = source_height / c_dst_dimension_y;
-
-    if (w_m == 0) {
-      w_m = 1;
-    };
-
-    if (h_m == 0) {
-      h_m = 1;
-    };
-
-    source = get_c_array(self);
-
-    destination = get_bicubic_points(source, source_width, source_height, c_dst_dimension_x * w_m, c_dst_dimension_y * h_m);
-
-    if (w_m * h_m > 1) {
-      source = destination;
-      destination = c_scale_points(source, c_dst_dimension_x, c_dst_dimension_y, w_m, h_m);
-    }
-
-    result_array = get_ruby_array(self, destination, c_dst_dimension_x * c_dst_dimension_y);
-    free(destination);
-    return result_array;
-};
-
-VALUE get_ruby_array(VALUE self, PIXEL *pixels, unsigned long int pixels_size) {
-    VALUE result_array;
-    unsigned long int i;
-    result_array = rb_ary_new2(pixels_size);
-    for (i=0; i<pixels_size; i++) {
-      rb_ary_store(result_array, i, UINT2NUM(pixels[i]));
-    };
-    return result_array;
-}
-
-PIXEL* get_c_array(VALUE self) {
-  unsigned long int w,h,i;
-  PIXEL* ary;
-  VALUE pixels;
-
-  pixels = rb_funcall(self, rb_intern("pixels"), 0);
-  w = NUM2UINT(rb_funcall(self, rb_intern("width"), 0));
-  h = NUM2UINT(rb_funcall(self, rb_intern("height"), 0));
-  ary = (PIXEL*)malloc( w*h*sizeof(PIXEL));
-
-  for(i=0; i<w*h; i++) {
-    ary[i] = NUM2UINT(rb_ary_entry(pixels, i));
-  }
-
-  return ary;
-}
-
-PIXEL raw_interpolate_cubic(double t, PIXEL p0, PIXEL p1, PIXEL p2, PIXEL p3) {
-  BYTE  new_r, new_g, new_b, new_a;
-
-  new_r = interpolate_char(t, R_BYTE(p0), R_BYTE(p1), R_BYTE(p2), R_BYTE(p3));
-  new_g = interpolate_char(t, G_BYTE(p0), G_BYTE(p1), G_BYTE(p2), G_BYTE(p3));
-  new_b = interpolate_char(t, B_BYTE(p0), B_BYTE(p1), B_BYTE(p2), B_BYTE(p3));
-  new_a = interpolate_char(t, A_BYTE(p0), A_BYTE(p1), A_BYTE(p2), A_BYTE(p3));
-
-  return BUILD_PIXEL(new_r, new_g, new_b, new_a);
-}
-
-BYTE interpolate_char(double t, BYTE c0, BYTE c1, BYTE c2, BYTE c3) {
-  double a, b, c, d, res;
-  a = - 0.5 * c0 + 1.5 * c1 - 1.5 * c2 + 0.5 * c3;
-  b = c0 - 2.5 * c1 + 2 * c2 - 0.5 * c3;
-  c = 0.5 * c2 - 0.5 * c0;
-  d = c1;
-  res = a * t * t * t + b * t * t + c * t + d + 0.5;
-  if(res < 0) {
-    res = 0;
-  } else if(res > 255) {
-    res = 255;
-  };
-  return (BYTE)(res);
-};
-
-PIXEL raw_merge_pixels(PIXEL* merge_pixels, unsigned long int size) {
-  unsigned long int i, real_colors, acum_r, acum_g, acum_b, acum_a;
-  BYTE new_r, new_g, new_b, new_a;
-  PIXEL pix;
-
-  acum_r = 0;
-  acum_g = 0;
-  acum_b = 0;
-  acum_a = 0;
-
-  new_r = 0;
-  new_g = 0;
-  new_b = 0;
-  new_a = 0;
-
-  real_colors = 0;
-
-  for(i=0; i < size; i++) {
-    pix = merge_pixels[i];
-    if(A_BYTE(pix) != 0) {
-      acum_r += R_BYTE(pix);
-      acum_g += G_BYTE(pix);
-      acum_b += B_BYTE(pix);
-      acum_a += A_BYTE(pix);
-      real_colors += 1;
-    };
-  };
-
-  if(real_colors > 0) {
-    new_r = (BYTE)(acum_r/real_colors);
-    new_g = (BYTE)(acum_g/real_colors);
-    new_b = (BYTE)(acum_b/real_colors);
-  };
-  new_a = (BYTE)(acum_a/size);
-  return BUILD_PIXEL(new_r, new_g, new_b, new_a);
-};
-
-void setup_steps_residues(unsigned long int *steps, double *residues,
-  unsigned long int src_dimension, unsigned long int dst_dimension) {
-  unsigned long int i;
-  double step = (double) (src_dimension - 1) / (dst_dimension - 1);
-  for(i = 0; i < dst_dimension - 1; i++) {
-    steps[i] = (unsigned long int) i*step;
-    residues[i]  = i*step - steps[i];
-  };
-
-  steps[dst_dimension - 1] = src_dimension - 2;
-  residues[dst_dimension - 1] = 1;
-};
-
-PIXEL get_line_pixel(PIXEL* source, unsigned long int line, long int pixel,
-  unsigned long int src_dimension_x) {
-  if(pixel >= 0 && pixel < (long int)src_dimension_x) {
-    return source[line * src_dimension_x + pixel];
-  } else {
-    return 0;
-  };
-};
-
-PIXEL get_column_pixel(PIXEL* source,
-  unsigned long int column, long int pixel,
-  unsigned long int src_dimension_y, unsigned long int src_dimension_x) {
-
-  if(pixel >=0 && pixel < (long int)src_dimension_y) {
-    return source[src_dimension_x * pixel + column];
-  } else {
-    return 0;
-  };
-};
-
-PIXEL* get_bicubic_points(PIXEL* source_array,
-  unsigned long int src_dimension_x, unsigned long int src_dimension_y,
-  unsigned long int dst_dimension_x, unsigned long int dst_dimension_y) {
-  PIXEL* dest, *source;
-  unsigned long int index_y, index, y, x;
-  unsigned long int* steps;
-  double* residues;
-
-  steps = (unsigned long int*) malloc(dst_dimension_x * sizeof(unsigned long int));
-  residues = (double*) malloc(dst_dimension_x * sizeof(double));
-  setup_steps_residues(steps, residues, src_dimension_x, dst_dimension_x);
-
-  source = source_array;
-  dest = (PIXEL*)malloc( src_dimension_y*dst_dimension_x*sizeof(PIXEL) );
-
-  for (y=0; y < src_dimension_y; y++) {
-    index_y = dst_dimension_x * y;
-    for (x=0; x < dst_dimension_x; x++) {
-      index = index_y + x;
-      dest[index] = raw_interpolate_cubic(residues[x],
-        get_line_pixel(source, y, steps[x] - 1, src_dimension_x),
-        get_line_pixel(source, y, steps[x], src_dimension_x),
-        get_line_pixel(source, y, steps[x] + 1, src_dimension_x),
-        get_line_pixel(source, y, steps[x] + 2, src_dimension_x)
-      );
-    };
-  };
-
-  steps = realloc(steps, dst_dimension_y * sizeof(unsigned long int));
-  residues = realloc(residues, dst_dimension_y * sizeof(double));
-  setup_steps_residues(steps, residues, src_dimension_y, dst_dimension_y);
-
-  free(source);
-  source = dest;
-  dest = (PIXEL*)malloc( dst_dimension_x * dst_dimension_y * sizeof(PIXEL));
-
-  for (y=0; y < dst_dimension_x; y++) {
-    for (x=0; x < dst_dimension_y; x++) {
-      index = dst_dimension_x * x + y;
-      dest[index] = raw_interpolate_cubic(residues[x],
-        get_column_pixel(source, y, steps[x] - 1, src_dimension_y, dst_dimension_x),
-        get_column_pixel(source, y, steps[x], src_dimension_y, dst_dimension_x),
-        get_column_pixel(source, y, steps[x] + 1, src_dimension_y, dst_dimension_x),
-        get_column_pixel(source, y, steps[x] + 2, src_dimension_y, dst_dimension_x)
-      );
-    };
-  };
-
-  free(source);
-  free(steps);
-  free(residues);
-
-  return dest;
-};
-
-PIXEL* c_scale_points(PIXEL* source, unsigned long int dst_width, unsigned long int dst_height,
-  unsigned long int w_m, unsigned long int h_m) {
-
-  unsigned long int y_pos, x_pos, index, i, j, x, y, buffer_size, buffer_index;
-  PIXEL* pixels_to_merge;
-  PIXEL* result;
-
-  pixels_to_merge = malloc(w_m*h_m*sizeof(PIXEL));
-  result = malloc(dst_width * dst_height * sizeof(PIXEL));
-
-  buffer_size = h_m * w_m;
-
-  for (i = 0; i < dst_height; i++) {
-    for (j = 0; j < dst_width; j++) {
-      buffer_index = 0;
-      for (y = 0; y < h_m; y++) {
-        y_pos = i * h_m + y;
-        for (x = 0; x < w_m; x++) {
-          x_pos = j * w_m + x;
-          pixels_to_merge[buffer_index++] = source[dst_width * w_m * y_pos + x_pos];
-        };
-      };
-      index = i * dst_width + j;
-      result[index] = raw_merge_pixels(pixels_to_merge, buffer_size);
-
-    };
-  };
-  free(source);
-  return result;
-};

data/ext/eyes_core/eyes_core.h

@@ -1,28 +0,0 @@
-#ifndef APPLITOOLS_RESAMPLING_EXT
-#define APPLITOOLS_RESAMPLING_EXT
-#include "ruby.h"
-
-typedef uint32_t PIXEL; // Pixels use 32 bits unsigned integers
-typedef unsigned char BYTE; // Bytes use 8 bits unsigned integers
-
-#define R_BYTE(pixel)  ((BYTE) (((pixel) & (PIXEL) 0xff000000) >> 24))
-#define G_BYTE(pixel)  ((BYTE) (((pixel) & (PIXEL) 0x00ff0000) >> 16))
-#define B_BYTE(pixel)  ((BYTE) (((pixel) & (PIXEL) 0x0000ff00) >> 8))
-#define A_BYTE(pixel)  ((BYTE) (((pixel) & (PIXEL) 0x000000ff)))
-
-#define BUILD_PIXEL(r, g, b, a)  (((PIXEL) (r) << 24) + ((PIXEL) (g) << 16) + ((PIXEL) (b) << 8) + (PIXEL) (a))
-#define INT8_MULTIPLY(a, b)      (((((a) * (b) + 0x80) >> 8) + ((a) * (b) + 0x80)) >> 8)
-
-BYTE interpolate_char(double, BYTE, BYTE, BYTE, BYTE);
-
-PIXEL* get_bicubic_points(PIXEL*, unsigned long int, unsigned long int, unsigned long int, unsigned long int);
-
-PIXEL* get_c_array(VALUE);
-VALUE c_resampling_first_step(VALUE, VALUE, VALUE);
-VALUE get_ruby_array(VALUE, PIXEL*, unsigned long int);
-PIXEL get_line_pixel(PIXEL*, unsigned long int, long int, unsigned long int);
-PIXEL get_column_pixel(PIXEL*, unsigned long int, long int, unsigned long int, unsigned long int);
-PIXEL raw_merge_pixels(PIXEL*, unsigned long int);
-PIXEL* c_scale_points(PIXEL*, unsigned long int, unsigned long int, unsigned long int, unsigned long int);
-
-#endif

data/lib/applitools/appium/android_region_provider.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'region_provider'
-module Applitools
-  module Appium
-    class AndroidRegionProvider < ::Applitools::Appium::RegionProvider
-      private
-
-      def convert_element_coordinates
-        Applitools::Region.from_location_size(eye_region.location, eye_region.size)
-      end
-
-      def convert_viewport_rect_coordinates
-        region  = viewport_rect
-
-        session_info = Applitools::Appium::Utils.session_capabilities(driver)
-        if session_info['deviceScreenSize']
-          device_height = session_info['deviceScreenSize'].split('x').last.to_i
-          system_bars_height = driver.get_system_bars.map {|_,v| v['height'] }.sum
-          region['height'] = device_height - system_bars_height
-        end
-
-        Applitools::Region.new(
-            region['left'],
-            region['top'],
-            region['width'],
-            region['height']
-        )
-      end
-    end
-  end
-end

data/lib/applitools/appium/android_screenshot.rb

@@ -1,21 +0,0 @@
-require_relative './screenshot.rb'
-module Applitools
-  module Appium
-    class AndroidScreenshot < Applitools::Appium::Screenshot
-      def convert_region_location(region, from, to)
-        # converted_size = region.size.dup.scale_it!(1 / device_pixel_ratio)
-        # converted_location = region.location.dup.offset_negative(Applitools::Location.new(0, status_bar_height)).scale_it!(1 / device_pixel_ratio)
-        # Applitools::Region.from_location_size(converted_location, converted_size)
-        Applitools::Region.from_location_size(
-          convert_location(region.location, nil, nil),
-          region.size
-        ).scale_it!(1.to_f / device_pixel_ratio)
-      end
-
-      def convert_location(location, _from, _to)
-        location.offset_negative(Applitools::Location.new(0, status_bar_height))
-      end
-
-    end
-  end
-end

data/lib/applitools/appium/driver.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module Applitools::Appium
-  class Driver < Applitools::Selenium::Driver
-    def initialize(eyes, options)
-      super(eyes, options)
-    end
-    module AppiumLib
-      extend self
-    end
-  end
-end

data/lib/applitools/appium/eyes.rb

@@ -1,189 +0,0 @@
-# frozen_string_literal: false
-
-class Applitools::Appium::Eyes < Applitools::Selenium::SeleniumEyes
-  attr_accessor :status_bar_height
-
-  def perform_driver_settings_for_appium_driver
-    self.region_visibility_strategy = Applitools::Selenium::NopRegionVisibilityStrategy.new
-    self.force_driver_resolution_as_viewport_size = true
-  end
-
-  def initialize(*args)
-    super
-    self.dont_get_title = true
-    self.runner = Applitools::ClassicRunner.new unless runner
-    self.base_agent_id = "eyes.appium.ruby/#{Applitools::VERSION}".freeze
-    self.status_bar_height = 0
-    self.utils = Applitools::Appium::Utils
-  end
-
-  private :perform_driver_settings_for_appium_driver
-
-  def check(*args)
-    args.compact!
-    case (first_arg = args.shift)
-    when String
-      name = first_arg
-      target = args.shift
-    when Applitools::Selenium::Target
-      target = first_arg
-    when Hash
-      target = first_arg[:target]
-      name = first_arg[:name] || first_arg[:tag]
-    end
-
-    logger.info "check(#{name}) is called"
-    self.tag_for_debug = name
-    Applitools::ArgumentGuard.one_of? target, 'target', [Applitools::Selenium::Target, Applitools::Appium::Target]
-
-    # target.fully(false) if target.options[:stitch_content].nil?
-
-    return universal_check(name, target)
-    return check_native(name, target) if native_app?
-    super
-  end
-
-  attr_accessor :eyes_element_to_check, :region_provider
-  private :eyes_element_to_check, :eyes_element_to_check=, :region_provider, :region_provider=
-
-  def check_native(name, target)
-    logger.info "check_native(#{name}) is called"
-    update_scaling_params
-    target_to_check = target.finalize
-    match_data = Applitools::MatchWindowData.new(default_match_settings)
-    match_data.tag = name
-    timeout = target_to_check.options[:timeout] || USE_DEFAULT_MATCH_TIMEOUT
-
-    eyes_element = target_to_check.region_to_check.call(driver)
-    self.eyes_element_to_check = eyes_element
-    region_provider = region_provider_class.new(driver, eyes_element)
-    match_data.read_target(target_to_check, driver)
-
-    check_window_base(
-      region_provider, timeout, match_data
-    )
-  end
-
-  def native_app?
-    return true if driver.current_context == 'NATIVE_APP'
-    false
-  end
-
-  def capture_screenshot
-    logger.info 'Getting screenshot (capture_screenshot() has been invoked)'
-    case eyes_element_to_check
-    when Applitools::Region
-      viewport_screenshot
-    when Selenium::WebDriver::Element, Applitools::Selenium::Element
-      element_screenshot
-    end
-  end
-
-  def get_app_output_with_screenshot(*args)
-    result = super do |screenshot|
-      if scale_provider
-        scaled_image = scale_provider.scale_image(screenshot.image)
-        self.screenshot = screenshot_class.new(
-          Applitools::Screenshot.from_image(
-            case scaled_image
-            # when ChunkyPNG::Image
-            #   scaled_image
-            when Applitools::Screenshot::Datastream
-              scaled_image.image
-            else
-              raise Applitools::EyesError.new('Unknown image format after scale!')
-            end
-          ),
-          status_bar_height: self.utils.status_bar_height(driver),
-          device_pixel_ratio: self.utils.device_pixel_ratio(driver)
-        )
-      end
-    end
-    self.screenshot_url = nil
-    result
-  end
-
-  def dom_data
-    {}
-  end
-
-  def check_window(tag = nil, match_timeout = USE_DEFAULT_MATCH_TIMEOUT)
-    target = Applitools::Appium::Target.window.tap do |t|
-      t.timeout(match_timeout)
-    end
-    check(tag, target)
-  end
-
-  def check_region(*args)
-    options = { timeout: USE_DEFAULT_MATCH_TIMEOUT, tag: nil }.merge! Applitools::Utils.extract_options!(args)
-    target = Applitools::Appium::Target.new.region(*args).timeout(options[:match_timeout])
-    check(options[:tag], target)
-  end
-
-  def set_mobile_capabilities(nmg_caps, nml_api_key, eyes_server_url, proxy_settings)
-    new_caps = {}
-
-    if nml_api_key.nil? || nml_api_key.empty?
-      nml_api_key = ENV['APPLITOOLS_API_KEY']
-      if nml_api_key.nil? || nml_api_key.empty?
-        raise Applitools::EyesError.new('No API key was given, or is an empty string.')
-      end
-    end
-    new_caps[:NML_API_KEY] = nml_api_key
-
-    if eyes_server_url.nil? || eyes_server_url.empty?
-      eyes_server_url = ENV['APPLITOOLS_SERVER_URL']
-    end
-    new_caps[:NML_SERVER_URL] = eyes_server_url if eyes_server_url
-
-    if proxy_settings.nil? || proxy_settings.empty?
-      proxy_settings = ENV['APPLITOOLS_HTTP_PROXY']
-    end
-    new_caps[:NML_PROXY_URL] = proxy_settings if proxy_settings
-
-    nmg_caps[:optionalIntentArguments] = "--es APPLITOOLS '" + new_caps.to_json + "'"
-    nmg_caps[:processArguments] = {
-      args: [],
-      env: new_caps.merge(DYLD_INSERT_LIBRARIES: "@executable_path/Frameworks/UFG_lib.xcframework/ios-arm64/UFG_lib.framework/UFG_lib:@executable_path/Frameworks/UFG_lib.xcframework/ios-arm64_x86_64-simulator/UFG_lib.framework/UFG_lib")
-    }
-  end
-
-  alias set_nmg_capabilities set_mobile_capabilities
-
-  def use_system_screenshot(value = true)
-    self.screenshot_mode = !value ? 'applitools-lib' : 'default'
-    self
-  end
-
-  private
-
-  def viewport_screenshot
-    logger.info 'Viewport screenshot requested...'
-    obtain_viewport_screenshot
-  end
-
-  def element_screenshot
-    logger.info 'Element screenshot requested...'
-    obtain_viewport_screenshot
-  end
-
-  def obtain_viewport_screenshot
-    self.screenshot = screenshot_class.new(
-        Applitools::Screenshot.from_datastream(driver.screenshot_as(:png)),
-        status_bar_height: self.utils.status_bar_height(driver),
-        device_pixel_ratio: self.utils.device_pixel_ratio(driver)
-    )
-  end
-
-  def screenshot_class
-    return Applitools::Appium::IosScreenshot if self.utils.ios?(Applitools::Appium::Driver::AppiumLib)
-    return Applitools::Appium::AndroidScreenshot if self.utils.android?(Applitools::Appium::Driver::AppiumLib)
-    raise Applitools::EyesError, 'Unknown device type'
-  end
-
-  def region_provider_class
-    return Applitools::Appium::IosRegionProvider if self.utils.ios?(Applitools::Appium::Driver::AppiumLib)
-    return Applitools::Appium::AndroidRegionProvider if self.utils.android?(Applitools::Appium::Driver::AppiumLib)
-    raise Applitools::EyesError, 'Unknown device type'
-  end
-end

data/lib/applitools/appium/ios_region_provider.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-#
-require_relative 'region_provider'
-module Applitools
-  module Appium
-    class IosRegionProvider < ::Applitools::Appium::RegionProvider
-      private
-
-      def convert_element_coordinates
-        Applitools::Region.from_location_size(eye_region.location, eye_region.size).
-            scale_it!(scale_factor)
-      end
-
-      def convert_viewport_rect_coordinates
-        region  = viewport_rect
-        Applitools::Region.new(
-          region['left'],
-          region['top'],
-          region['width'],
-          region['height']
-        )
-      end
-    end
-  end
-end

data/lib/applitools/appium/ios_screenshot.rb

@@ -1,10 +0,0 @@
-require_relative './screenshot.rb'
-module Applitools
-  module Appium
-    class IosScreenshot < Applitools::Appium::Screenshot
-      def convert_location(location, _from, _to)
-        location.offset_negative(Applitools::Location.new(0, status_bar_height))
-      end
-    end
-  end
-end

data/lib/applitools/appium/region_provider.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-module Applitools
-  module Appium
-    class RegionProvider
-      attr_accessor :driver, :eye_region, :region_to_check
-
-      def initialize(driver, eye_region)
-        self.driver = driver
-        self.eye_region = eye_region
-        self.region_to_check = Applitools::Region::EMPTY
-        convert_region_coordinates
-      end
-
-      def region
-        region_to_check
-      end
-
-      def coordinate_type
-        nil
-      end
-
-      private
-
-      def viewport_rect
-        Applitools::Appium::Utils.viewport_rect(driver)
-      end
-
-      def convert_region_coordinates
-        self.region_to_check = case eye_region
-                               when ::Selenium::WebDriver::Element, Applitools::Selenium::Element
-                                  convert_element_coordinates
-                               else
-                                  convert_viewport_rect_coordinates
-                               end
-      end
-
-      def convert_element_coordinates
-        raise Applitools::AbstractMethodCalled.new(:convert_region_coordinates, 'Applitools::Appium::RegionProvider')
-      end
-
-      def convert_viewport_rect_coordinates
-        raise Applitools::AbstractMethodCalled.new(:convert_viewport_rect_coordinates, 'Applitools::Appium::RegionProvider')
-      end
-
-      def scale_factor
-        Applitools::Appium::Utils.device_pixel_ratio(driver)
-      end
-    end
-  end
-end

data/lib/applitools/appium/screenshot.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Applitools
-  module Appium
-    class Screenshot < Applitools::EyesScreenshot
-
-      attr_reader :status_bar_height, :device_pixel_ratio
-
-      def initialize(*args)
-        options = Applitools::Utils.extract_options!(args)
-        @status_bar_height = options[:status_bar_height] || 0
-        @device_pixel_ratio = options[:device_pixel_ratio] || 1
-        super
-      end
-
-      def sub_screenshot(region, _coordinate_type, _throw_if_clipped = false, _force_nil_if_clipped = false)
-        self.class.new(
-          Applitools::Screenshot.from_image(
-            image.crop(region.x, region.y, region.width, region.height)
-          )
-        )
-      end
-
-      def convert_location(location, _from, _to)
-        raise 'Applitools::Appium::Screenshot is an abstract class.' \
-          ' You should implement :convert_location method in a descendant class.'
-      end
-    end
-  end
-end