macos 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a108d88ec5b706a9bc9839ded07b08849a2a232cb74ec9f9ec9e50f23f84734d
-  data.tar.gz: f55c8d91de3341d0d709a59cd921c96f4690dce88a0dd7568af617e084682c4e
+  metadata.gz: bf5821a0d9cb6f49c609d0f04404516616827d6638cfbdeb1f0f8aff0d971511
+  data.tar.gz: cb023c3393ed3cab754e83d25d6499c2d14ff9ba580a4338e785e0dbaf74a6d9
 SHA512:
-  metadata.gz: 00aea0fa47b5dc3363fd3be123288ab12277429d0af9cd7db45066a9bc431421a3c966ab3d04401b6aa510a641378b1b58107577952a763b0b8f0e218956393f
-  data.tar.gz: 9530f04a0e57b4b22b78c46266ea9079f4e138c6238f8ac503764e72f106f281fd6ac7d9ccb1bc91f18cd81ee59fd4f2126e50e886bbbec75c52269469280970
+  metadata.gz: 8df71d32c14d10495fbdb6fda286d0a61149125513dda133b5c736968a2dcea6ec4e76362f7284741704394f7eec7e98ffa6b8aac146906cfadb3741ab4fdaf6
+  data.tar.gz: 43dcd007db945422d82bd5e66e489becb2171c309420f9f78da91d17b0f88d912e0722bf040844cf4f6a3440686b6f7caee4990397f7b6744d9efc21afa6a1a9

data/Gemfile

@@ -4,6 +4,7 @@ source "https://rubygems.org"
 
 gemspec
 
+gem "irb"
 gem "rake"
 gem "rspec"
 gem "rspec_junit_formatter"

data/lib/macos/display.rb

@@ -1,23 +1,25 @@
 # frozen_string_literal: true
 
+require "tempfile"
+
 module MacOS
   # Simulates a macOS display.
   class Display
     Size = Struct.new(:width, :height)
 
     def self.main
-      id = Library.CGMainDisplayID
+      id = Library::CoreGraphics.CGMainDisplayID
       new(id:)
     end
 
     # @param id [Integer
-    def initialize(id:)
+    def initialize(id: 0)
       @id = id
     end
 
     # @return [Size]
     def bounds
-      bounds = Library.CGDisplayBounds(@id)
+      bounds = Library::CoreGraphics.CGDisplayBounds(@id)
 
       width = Integer(bounds[:size][:width])
       height = Integer(bounds[:size][:height])
@@ -29,7 +31,23 @@ module MacOS
     # @yieldparam tempfile [Tempfile]
     def screenshot
       tempfile = Tempfile.new(["screenshot", ".png"])
-      system("screencapture -o -x #{tempfile.path}")
+      image = Library::CoreGraphics.CGDisplayCreateImage(@id)
+
+      encoding = Library::CoreFoundation::ENCODING_UTF8
+      path = Library::CoreFoundation.CFStringCreateWithCString(nil, tempfile.path, encoding)
+      url = Library::CoreFoundation.CFURLCreateWithFileSystemPath(nil, path, 0, false)
+      uti = Library::CoreFoundation.CFStringCreateWithCString(nil, "public.png", encoding)
+
+      dest = Library::ImageIO.CGImageDestinationCreateWithURL(url, uti, 1, nil)
+      Library::ImageIO.CGImageDestinationAddImage(dest, image, nil)
+      Library::ImageIO.CGImageDestinationFinalize(dest)
+
+      Library::CoreGraphics.CFRelease(image)
+      Library::CoreFoundation.CFRelease(path)
+      Library::CoreFoundation.CFRelease(url)
+      Library::CoreFoundation.CFRelease(uti)
+      Library::CoreFoundation.CFRelease(dest)
+
       yield tempfile
     ensure
       tempfile.close

data/lib/macos/keyboard.rb

@@ -3,11 +3,73 @@
 module MacOS
   # Simulates a macOS keyboard.
   class Keyboard
+    MILISECOND = 0.001
+
+    # @param text [String]
     def type(text)
       text.chars.each do |character|
-        key_down(character)
-        key_up(character)
+        mask = 0
+        mask |= Library::CoreGraphics::EventFlags::MASK_SHIFT if Library::CoreGraphics::KeyCode.shifted?(character)
+        key(character, mask:)
+      end
+    end
+
+    # @example
+    #   keyboard.keys("a")
+    #   keyboard.keys("b")
+    #   keyboard.keys("c")
+    #   keyboard.keys("command+shift+s")
+    #   keyboard.keys("comand+shift+tab")
+    #
+    # @param text [String] e.g. "a", "b", "command+shift+s" or ""
+    def keys(text)
+      mask = 0
+      options = text.split("+")
+      key = options.pop
+
+      options.each do |option|
+        mask |= Library::CoreGraphics::EventFlags.find(option)
       end
+
+      key(key, mask:)
+    end
+
+    # @example
+    #   keyboard.key("s", mask: Library::CoreGraphics::EventFlags::MASK_COMMAND)
+    #
+    # @param character [String] a character to be pressed then released
+    # @param mask [Integer] a bitmask of event flags  (e.g. Library::CoreGraphics::EventFlags::MASK_SHIFT)
+    def key(character, mask: 0)
+      key_down(character, mask:)
+      key_up(character, mask:)
+    end
+
+    # @example
+    #   keyboard.key_down("c", mask: Library::CoreGraphics::EventFlags::MASK_COMMAND)
+    #
+    # @param character [String] a character to be typed
+    # @param mask [Integer] a bitmask of event flags (e.g. Library::CoreGraphics::EventFlags::MASK_SHIFT)
+    def key_down(character, mask: 0)
+      code = Library::CoreGraphics::KeyCode.find(character)
+      event = Library::CoreGraphics.CGEventCreateKeyboardEvent(nil, code, true)
+      Library::CoreGraphics.CGEventSetFlags(event, mask) unless mask.zero?
+      Library::CoreGraphics.CGEventPost(Library::CoreGraphics::EventTapLocation::HID_EVENT_TAP, event)
+      Library::CoreGraphics.CFRelease(event)
+      sleep(MILISECOND)
+    end
+
+    # @example
+    #   keyboard.key_up("c", mask: Library::CoreGraphics::EventFlags::MASK_COMMAND)
+    #
+    # @param character [String] a character to be released
+    # @param mask [Integer] a bitmask of event flags (e.g. Library::CoreGraphics::EventFlags::MASK_SHIFT)
+    def key_up(character, mask: 0)
+      code = Library::CoreGraphics::KeyCode.find(character)
+      event = Library::CoreGraphics.CGEventCreateKeyboardEvent(nil, code, false)
+      Library::CoreGraphics.CGEventSetFlags(event, mask) unless mask.zero?
+      Library::CoreGraphics.CGEventPost(Library::CoreGraphics::EventTapLocation::HID_EVENT_TAP, event)
+      Library::CoreGraphics.CFRelease(event)
+      sleep(MILISECOND)
     end
   end
 end

data/lib/macos/library/core_foundation.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "ffi"
+
+module MacOS
+  module Library
+    # https://developer.apple.com/documentation/corefoundation
+    module CoreFoundation
+      extend ::FFI::Library
+      ENCODING_UTF8 = 0x08000100
+
+      ffi_lib "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation"
+
+      typedef :pointer, :CFStringRef
+      typedef :long, :CFIndex
+      typedef :CFIndex, :CFURLPathStyle
+
+      attach_function :CFStringCreateWithCString, %i[pointer string int], :pointer
+      attach_function :CFURLCreateWithFileSystemPath, %i[pointer CFStringRef CFURLPathStyle bool], :pointer
+      attach_function :CFRelease, %i[pointer], :void
+    end
+  end
+end

data/lib/macos/library/core_graphics/event_flags.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module MacOS
+  module Library
+    module CoreGraphics
+      # https://developer.apple.com/documentation/coregraphics/cgeventflags
+      module EventFlags
+        MASK_SHIFT = 0x00020000 # https://developer.apple.com/documentation/coregraphics/cgeventflags/maskshift
+        MASK_CONTROL = 0x00040000 # https://developer.apple.com/documentation/coregraphics/cgeventflags/maskcontrol
+        MASK_ALTERNATE = 0x00080000 # https://developer.apple.com/documentation/coregraphics/cgeventflags/maskalternate
+        MASK_COMMAND = 0x00100000 # https://developer.apple.com/documentation/coregraphics/cgeventflags/maskcommand
+        MASK_HELP = 0x00400000 # https://developer.apple.com/documentation/coregraphics/cgeventflags/maskhelp
+
+        MAPPING = {
+          "shift" => MASK_SHIFT,
+          "control" => MASK_CONTROL,
+          "ctrl" => MASK_CONTROL,
+          "option" => MASK_ALTERNATE,
+          "opt" => MASK_ALTERNATE,
+          "alt" => MASK_ALTERNATE,
+          "command" => MASK_COMMAND,
+          "cmd" => MASK_COMMAND,
+          "help" => MASK_HELP,
+        }.freeze
+
+        # @param modifier [String]
+        #
+        # @raise [ArgumentError]
+        #
+        # @return [Integer]
+        def self.find(modifier)
+          MAPPING[modifier] || raise(ArgumentError, "unsupported modifier=#{modifier.inspect}")
+        end
+      end
+    end
+  end
+end

data/lib/macos/library/core_graphics/event_tap_location.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MacOS
+  module Library
+    module CoreGraphics
+      # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation
+      module EventTapLocation
+        HID_EVENT_TAP = 0 # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation/cghideventtap
+        SESSSION_EVENT_TAP = 1 # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation/sessioneventtap
+        ANNOTATED_SESSION_EVENT_TAP = 2 # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation/annotatedsessioneventtap
+      end
+    end
+  end
+end

data/lib/macos/library/core_graphics/event_type.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module MacOS
+  module Library
+    module CoreGraphics
+      # https://developer.apple.com/documentation/coregraphics/cgeventtype
+      module EventType
+        NULL = 0 # https://developer.apple.com/documentation/coregraphics/cgeventtype/null
+        LEFT_MOUSE_DOWN = 1 # https://developer.apple.com/documentation/coregraphics/cgeventtype/leftmousedown
+        LEFT_MOUSE_UP = 2 # https://developer.apple.com/documentation/coregraphics/cgeventtype/leftmouseup
+        RIGHT_MOUSE_DOWN = 3 # https://developer.apple.com/documentation/coregraphics/cgeventtype/rightmousedown
+        RIGHT_MOUSE_UP = 4 # https://developer.apple.com/documentation/coregraphics/cgeventtype/rightmouseup
+        MOUSE_MOVED = 5 # https://developer.apple.com/documentation/coregraphics/cgeventtype/mousemoved
+        LEFT_MOUSE_DRAGGED = 6 # https://developer.apple.com/documentation/coregraphics/cgeventtype/leftmousedragged
+        RIGHT_MOUSE_DRAGGED = 7 # https://developer.apple.com/documentation/coregraphics/cgeventtype/rightmousedragged
+        KEY_DOWN = 10 # https://developer.apple.com/documentation/coregraphics/cgeventtype/keydown
+        KEY_UP = 11 # https://developer.apple.com/documentation/coregraphics/cgeventtype/keyup
+        OTHER_MOUSE_DOWN = 25 # https://developer.apple.com/documentation/coregraphics/cgeventtype/othermousedown
+        OTHER_MOUSE_UP = 26 # https://developer.apple.com/documentation/coregraphics/cgeventtype/othermouseup
+        OTHER_MOUSE_DRAGGED = 27 # https://developer.apple.com/documentation/coregraphics/cgeventtype/othermousedragged
+      end
+    end
+  end
+end

data/lib/macos/library/core_graphics/key_code.rb

@@ -0,0 +1,230 @@
+# frozen_string_literal: true
+
+module MacOS
+  module Library
+    module CoreGraphics
+      # https://developer.apple.com/documentation/coregraphics/cgkeycode
+      module KeyCode
+        SHIFTED = "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890!@#$%^&*()_+{}|:\"<>?~`"
+
+        KEY_CODE_A = 0
+        KEY_CODE_B = 11
+        KEY_CODE_C = 8
+        KEY_CODE_D = 2
+        KEY_CODE_E = 14
+        KEY_CODE_F = 3
+        KEY_CODE_G = 5
+        KEY_CODE_H = 4
+        KEY_CODE_I = 34
+        KEY_CODE_J = 38
+        KEY_CODE_K = 40
+        KEY_CODE_L = 37
+        KEY_CODE_M = 46
+        KEY_CODE_N = 45
+        KEY_CODE_O = 31
+        KEY_CODE_P = 35
+        KEY_CODE_Q = 12
+        KEY_CODE_R = 15
+        KEY_CODE_S = 1
+        KEY_CODE_T = 17
+        KEY_CODE_U = 32
+        KEY_CODE_V = 9
+        KEY_CODE_W = 13
+        KEY_CODE_X = 7
+        KEY_CODE_Y = 16
+        KEY_CODE_Z = 6
+
+        KEY_CODE_0 = 29
+        KEY_CODE_1 = 18
+        KEY_CODE_2 = 19
+        KEY_CODE_3 = 20
+        KEY_CODE_4 = 21
+        KEY_CODE_5 = 23
+        KEY_CODE_6 = 22
+        KEY_CODE_7 = 26
+        KEY_CODE_8 = 28
+        KEY_CODE_9 = 25
+
+        KEY_CODE_TILDE = 30
+        KEY_CODE_BACKTICK = 30
+
+        KEY_CODE_EXCLAMATION = 18
+        KEY_CODE_AMPERSAT = 19
+        KEY_CODE_HASH = 20
+        KEY_CODE_DOLLAR = 21
+        KEY_CODE_PERCENT = 23
+        KEY_CODE_CARET = 22
+        KEY_CODE_AMPERSAND = 26
+        KEY_CODE_ASTERISK = 28
+        KEY_CODE_LPARENTHESIS = 25
+        KEY_CODE_RPARENTHESIS = 29
+        KEY_CODE_MINUS = 27
+        KEY_CODE_UNDERSCORE = 27
+        KEY_CODE_EQUAL = 24
+        KEY_CODE_PLUS = 24
+
+        KEY_CODE_LBRACKET = 33
+        KEY_CODE_RBRACKET = 30
+        KEY_CODE_BACKSLASH = 42
+        KEY_CODE_SEMICOLON = 41
+        KEY_CODE_LBRACE = 33
+        KEY_CODE_RBRACE = 30
+        KEY_CODE_PIPE = 42
+        KEY_CODE_COLON = 41
+        KEY_CODE_QUOTE = 39
+        KEY_CODE_QUOTATION = 39
+        KEY_CODE_COMMA = 43
+        KEY_CODE_PERIOD = 47
+        KEY_CODE_SLASH = 44
+        KEY_CODE_LT = 43
+        KEY_CODE_GT = 47
+        KEY_CODE_TAB = 48
+        KEY_CODE_ESCAPE = 53
+        KEY_CODE_RETURN = 36
+        KEY_CODE_DELETE = 51
+        KEY_CODE_SPACE = 49
+        KEY_CODE_LEFT = 123
+        KEY_CODE_RIGHT = 124
+        KEY_CODE_DOWN = 125
+        KEY_CODE_UP = 126
+        KEY_CODE_SHIFT = 56
+        KEY_CODE_CONTROL = 59
+        KEY_CODE_OPTION = 58
+        KEY_CODE_COMMAND = 55
+        KEY_CODE_FUNCTION = 63
+
+        MAPPING = {
+          "a" => KEY_CODE_A,
+          "A" => KEY_CODE_A,
+          "b" => KEY_CODE_B,
+          "B" => KEY_CODE_B,
+          "c" => KEY_CODE_C,
+          "C" => KEY_CODE_C,
+          "d" => KEY_CODE_D,
+          "D" => KEY_CODE_D,
+          "e" => KEY_CODE_E,
+          "E" => KEY_CODE_E,
+          "f" => KEY_CODE_F,
+          "F" => KEY_CODE_F,
+          "g" => KEY_CODE_G,
+          "G" => KEY_CODE_G,
+          "h" => KEY_CODE_H,
+          "H" => KEY_CODE_H,
+          "i" => KEY_CODE_I,
+          "I" => KEY_CODE_I,
+          "j" => KEY_CODE_J,
+          "J" => KEY_CODE_J,
+          "k" => KEY_CODE_K,
+          "K" => KEY_CODE_K,
+          "l" => KEY_CODE_L,
+          "L" => KEY_CODE_L,
+          "m" => KEY_CODE_M,
+          "M" => KEY_CODE_M,
+          "n" => KEY_CODE_N,
+          "N" => KEY_CODE_N,
+          "o" => KEY_CODE_O,
+          "O" => KEY_CODE_O,
+          "p" => KEY_CODE_P,
+          "P" => KEY_CODE_P,
+          "q" => KEY_CODE_Q,
+          "Q" => KEY_CODE_Q,
+          "r" => KEY_CODE_R,
+          "R" => KEY_CODE_R,
+          "s" => KEY_CODE_S,
+          "S" => KEY_CODE_S,
+          "t" => KEY_CODE_T,
+          "T" => KEY_CODE_T,
+          "u" => KEY_CODE_U,
+          "U" => KEY_CODE_U,
+          "v" => KEY_CODE_V,
+          "V" => KEY_CODE_V,
+          "w" => KEY_CODE_W,
+          "W" => KEY_CODE_W,
+          "x" => KEY_CODE_X,
+          "X" => KEY_CODE_X,
+          "y" => KEY_CODE_Y,
+          "Y" => KEY_CODE_Y,
+          "z" => KEY_CODE_Z,
+          "Z" => KEY_CODE_Z,
+          "1" => KEY_CODE_1,
+          "2" => KEY_CODE_2,
+          "3" => KEY_CODE_3,
+          "4" => KEY_CODE_4,
+          "5" => KEY_CODE_5,
+          "6" => KEY_CODE_6,
+          "7" => KEY_CODE_7,
+          "8" => KEY_CODE_8,
+          "9" => KEY_CODE_9,
+          "0" => KEY_CODE_0,
+          "~" => KEY_CODE_TILDE,
+          "`" => KEY_CODE_BACKTICK,
+          "!" => KEY_CODE_EXCLAMATION,
+          "@" => KEY_CODE_AMPERSAT,
+          "#" => KEY_CODE_HASH,
+          "$" => KEY_CODE_DOLLAR,
+          "%" => KEY_CODE_PERCENT,
+          "^" => KEY_CODE_CARET,
+          "&" => KEY_CODE_AMPERSAND,
+          "*" => KEY_CODE_ASTERISK,
+          "(" => KEY_CODE_LPARENTHESIS,
+          ")" => KEY_CODE_RPARENTHESIS,
+          "=" => KEY_CODE_EQUAL,
+          "-" => KEY_CODE_MINUS,
+          "+" => KEY_CODE_PLUS,
+          "_" => KEY_CODE_UNDERSCORE,
+          "[" => KEY_CODE_LBRACKET,
+          "]" => KEY_CODE_RBRACKET,
+          "<" => KEY_CODE_LT,
+          ">" => KEY_CODE_GT,
+          "{" => KEY_CODE_LBRACE,
+          "}" => KEY_CODE_RBRACE,
+          "|" => KEY_CODE_PIPE,
+          ":" => KEY_CODE_COLON,
+          "'" => KEY_CODE_QUOTE,
+          "\"" => KEY_CODE_QUOTATION,
+          "," => KEY_CODE_COMMA,
+          "." => KEY_CODE_PERIOD,
+          "/" => KEY_CODE_SLASH,
+          "\\" => KEY_CODE_BACKSLASH,
+          " " => KEY_CODE_SPACE,
+          "escape" => KEY_CODE_ESCAPE,
+          "backspace" => KEY_CODE_DELETE,
+          "delete" => KEY_CODE_DELETE,
+          "command" => KEY_CODE_COMMAND,
+          "option" => KEY_CODE_OPTION,
+          "control" => KEY_CODE_CONTROL,
+          "shift" => KEY_CODE_SHIFT,
+          "function" => KEY_CODE_FUNCTION,
+          "left" => KEY_CODE_LEFT,
+          "right" => KEY_CODE_RIGHT,
+          "up" => KEY_CODE_UP,
+          "down" => KEY_CODE_DOWN,
+          "←" => KEY_CODE_LEFT,
+          "→" => KEY_CODE_RIGHT,
+          "↑" => KEY_CODE_UP,
+          "↓" => KEY_CODE_DOWN,
+          "tab" => KEY_CODE_TAB,
+          "\t" => KEY_CODE_TAB,
+          "return" => KEY_CODE_RETURN,
+          "enter" => KEY_CODE_RETURN,
+          "\n" => KEY_CODE_RETURN,
+        }.freeze
+
+        # @param key [String]
+        # @raise [ArgumentError]
+        #
+        # @return [Integer]
+        def self.find(key)
+          MAPPING[key] || raise(ArgumentError, "unsupported key=#{key.inspect}")
+        end
+
+        # @param key [String]
+        #
+        # @return [Boolean]
+        def self.shifted?(key)
+          SHIFTED.include?(key)
+        end
+      end
+    end
+  end
+end

data/lib/macos/library/core_graphics/mouse_button.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MacOS
+  module Library
+    module CoreGraphics
+      # https://developer.apple.com/documentation/coregraphics/cgmousebutton
+      module MouseButton
+        LEFT = 0 # https://developer.apple.com/documentation/coregraphics/cgmousebutton/left
+        RIGHT = 1 # https://developer.apple.com/documentation/coregraphics/cgmousebutton/right
+        CENTER = 2 # https://developer.apple.com/documentation/coregraphics/cgmousebutton/center
+      end
+    end
+  end
+end

data/lib/macos/library/core_graphics.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "ffi"
+
+module MacOS
+  module Library
+    # https://developer.apple.com/documentation/coregraphics
+    module CoreGraphics
+      extend ::FFI::Library
+      ffi_lib "/System/Library/Frameworks/CoreGraphics.framework/CoreGraphics"
+
+      # https://developer.apple.com/documentation/corefoundation/cgpoint
+      class CGPoint < FFI::Struct
+        layout :x, :double, :y, :double
+      end
+
+      # https://developer.apple.com/documentation/corefoundation/cgsize
+      class CGSize < FFI::Struct
+        layout :width, :double, :height, :double
+      end
+
+      # https://developer.apple.com/documentation/corefoundation/cgrect
+      class CGRect < FFI::Struct
+        layout :origin, CGPoint, :size, CGSize
+      end
+
+      typedef :pointer, :CGError
+      typedef :pointer, :CGEventRef
+      typedef :pointer, :CGImageRef
+      typedef :uint16, :CGKeyCode
+      typedef :uint32, :CGDirectDisplayID
+      typedef :uint32, :CGEventFlags
+      typedef :uint32, :CGEventTapLocation
+      typedef :uint32, :CGEventType
+      typedef :uint32, :CGMouseButton
+
+      attach_function :CFRelease, %i[pointer], :void
+      attach_function :CGEventCreate, %i[pointer], :CGEventRef
+      attach_function :CGEventGetLocation, %i[pointer], CGPoint.by_value
+      attach_function :CGEventCreateMouseEvent, [:pointer, :CGEventType, CGPoint.by_value, :CGMouseButton], :CGEventRef
+      attach_function :CGEventCreateKeyboardEvent, %i[pointer CGKeyCode bool], :CGEventRef
+      attach_function :CGEventSetFlags, %i[CGEventRef CGEventFlags], :void
+      attach_function :CGEventPost, %i[CGEventTapLocation CGEventRef], :void
+      attach_function :CGWarpMouseCursorPosition, [CGPoint.by_value], :CGError
+      attach_function :CGMainDisplayID, [], :CGDirectDisplayID
+      attach_function :CGDisplayBounds, %i[CGDirectDisplayID], CGRect.by_value
+      attach_function :CGDisplayCreateImage, %i[CGDirectDisplayID], :CGImageRef
+    end
+  end
+end

data/lib/macos/library/image_io.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "ffi"
+
+module MacOS
+  module Library
+    # https://developer.apple.com/documentation/corefoundation
+    module ImageIO
+      extend FFI::Library
+      ffi_lib "/System/Library/Frameworks/ImageIO.framework/ImageIO"
+
+      attach_function :CGImageDestinationCreateWithURL, %i[pointer pointer size_t pointer], :pointer
+      attach_function :CGImageDestinationAddImage, %i[pointer pointer pointer], :void
+      attach_function :CGImageDestinationFinalize, %i[pointer], :bool
+      attach_function :CFRelease, %i[pointer], :void
+    end
+  end
+end

data/lib/macos/mouse.rb

@@ -7,9 +7,9 @@ module MacOS
 
     # @return [Position]
     def position
-      event = Library.CGEventCreate(nil)
-      position = Library.CGEventGetLocation(event)
-      Library.CFRelease(event)
+      event = Library::CoreGraphics.CGEventCreate(nil)
+      position = Library::CoreGraphics.CGEventGetLocation(event)
+      Library::CoreGraphics.CFRelease(event)
 
       x = position[:x]
       y = position[:y]
@@ -17,80 +17,94 @@ module MacOS
       Position.new(x, y)
     end
 
-    # @param type [Integer] e.g. `MacOS::CG::EventType::MOUSE_MOVED`
-    # @param x [Float]
-    # @param y [Float]
-    # @param button [Integer] e.g. `MacOS::CG::MouseButton::LEFT` / `MacOS::CG::MouseButton::RIGHT` / etc.
+    # @param type [Integer] e.g. `MacOS::Library::CoreGraphicsEventType::MOUSE_MOVED`
+    # @param x [Integer]
+    # @param y [Integer]
+    # @param button [Integer] e.g. `MacOS::Library::CoreGraphicsMouseButton::MIDDLE`
     def trigger(type:, x:, y:, button: 0)
-      position = CG::Point.new
+      position = Library::CoreGraphics::CGPoint.new
       position[:x] = x
       position[:y] = y
-      event = Library.CGEventCreateMouseEvent(nil, type, position, button)
-      Library.CGEventPost(CG::EventTapLocation::HID_EVENT_TAP, event)
-      Library.CFRelease(event)
+
+      event = Library::CoreGraphics.CGEventCreateMouseEvent(nil, type, position, button)
+
+      Library::CoreGraphics.CGEventPost(Library::CoreGraphics::EventTapLocation::HID_EVENT_TAP, event)
+      Library::CoreGraphics.CFRelease(event)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def move(x:, y:)
-      position = CG::Point.new
+      position = Library::CoreGraphics::CGPoint.new
       position[:x] = x
       position[:y] = y
-      Library.CGWarpMouseCursorPosition(position)
+      Library::CoreGraphics.CGWarpMouseCursorPosition(position)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def left_down(x:, y:)
-      trigger(type: CG::EventType::LEFT_MOUSE_DOWN, x:, y:, button: CG::MouseButton::LEFT)
+      trigger(x:, y:,
+        type: Library::CoreGraphics::EventType::LEFT_MOUSE_DOWN,
+        button: Library::CoreGraphics::MouseButton::LEFT)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def left_up(x:, y:)
-      trigger(type: CG::EventType::LEFT_MOUSE_UP, x:, y:, button: CG::MouseButton::LEFT)
+      trigger(x:, y:,
+        type: Library::CoreGraphics::EventType::LEFT_MOUSE_UP,
+        button: Library::CoreGraphics::MouseButton::LEFT)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def left_click(x:, y:)
       left_down(x:, y:)
       left_up(x:, y:)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def right_down(x:, y:)
-      trigger(type: CG::EventType::RIGHT_MOUSE_DOWN, x:, y:, button: CG::MouseButton::RIGHT)
+      trigger(x:, y:,
+        type: Library::CoreGraphics::EventType::RIGHT_MOUSE_DOWN,
+        button: Library::CoreGraphics::MouseButton::RIGHT)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def right_up(x:, y:)
-      trigger(type: CG::EventType::RIGHT_MOUSE_UP, x:, y:, button: CG::MouseButton::RIGHT)
+      trigger(x:, y:,
+        type: Library::CoreGraphics::EventType::RIGHT_MOUSE_UP,
+        button: Library::CoreGraphics::MouseButton::RIGHT)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def right_click(x:, y:)
       right_down(x:, y:)
       right_up(x:, y:)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def middle_down(x:, y:)
-      trigger(type: CG::EventType::OTHER_MOUSE_DOWN, x:, y:, button: CG::MouseButton::CENTER)
+      trigger(x:, y:,
+        type: Library::CoreGraphics::EventType::OTHER_MOUSE_DOWN,
+        button: Library::CoreGraphics::MouseButton::CENTER)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def middle_up(x:, y:)
-      trigger(type: CG::EventType::OTHER_MOUSE_UP, x:, y:, button: CG::MouseButton::CENTER)
+      trigger(x:, y:,
+        type: Library::CoreGraphics::EventType::OTHER_MOUSE_UP,
+        button: Library::CoreGraphics::MouseButton::CENTER)
     end
 
-    # @param x [Float]
-    # @param y [Float]
+    # @param x [Integer]
+    # @param y [Integer]
     def middle_click(x:, y:)
       middle_down(x:, y:)
       middle_up(x:, y:)

data/lib/macos/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MacOS
-  VERSION = "0.1.4"
+  VERSION = "0.1.6"
 end

data/lib/macos.rb

@@ -4,8 +4,8 @@ require "fiddle"
 require "zeitwerk"
 
 loader = Zeitwerk::Loader.for_gem
-loader.inflector.inflect "cg" => "CG"
 loader.inflector.inflect "macos" => "MacOS"
+loader.inflector.inflect "image_io" => "ImageIO"
 loader.setup
 
 # Interacts with macOS.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: macos
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - Kevin Sylvestre
@@ -64,15 +64,16 @@ files:
 - bin/demo
 - bin/setup
 - lib/macos.rb
-- lib/macos/cg/event_tap_location.rb
-- lib/macos/cg/event_type.rb
-- lib/macos/cg/mouse_button.rb
-- lib/macos/cg/point.rb
-- lib/macos/cg/rect.rb
-- lib/macos/cg/size.rb
 - lib/macos/display.rb
 - lib/macos/keyboard.rb
-- lib/macos/library.rb
+- lib/macos/library/core_foundation.rb
+- lib/macos/library/core_graphics.rb
+- lib/macos/library/core_graphics/event_flags.rb
+- lib/macos/library/core_graphics/event_tap_location.rb
+- lib/macos/library/core_graphics/event_type.rb
+- lib/macos/library/core_graphics/key_code.rb
+- lib/macos/library/core_graphics/mouse_button.rb
+- lib/macos/library/image_io.rb
 - lib/macos/mouse.rb
 - lib/macos/version.rb
 homepage: https://github.com/ksylvest/macos

data/lib/macos/cg/event_tap_location.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module MacOS
-  module CG
-    # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation
-    module EventTapLocation
-      HID_EVENT_TAP = 0 # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation/cghideventtap
-      SESSSION_EVENT_TAP = 1 # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation/sessioneventtap
-      ANNOTATED_SESSION_EVENT_TAP = 2 # https://developer.apple.com/documentation/coregraphics/cgeventtaplocation/annotatedsessioneventtap
-    end
-  end
-end

data/lib/macos/cg/event_type.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module MacOS
-  module CG
-    # https://developer.apple.com/documentation/coregraphics/cgeventtype
-    module EventType
-      NULL = 0 # https://developer.apple.com/documentation/coregraphics/cgeventtype/null
-      LEFT_MOUSE_DOWN = 1 # https://developer.apple.com/documentation/coregraphics/cgeventtype/leftmousedown
-      LEFT_MOUSE_UP = 2 # https://developer.apple.com/documentation/coregraphics/cgeventtype/leftmouseup
-      RIGHT_MOUSE_DOWN = 3 # https://developer.apple.com/documentation/coregraphics/cgeventtype/rightmousedown
-      RIGHT_MOUSE_UP = 4 # https://developer.apple.com/documentation/coregraphics/cgeventtype/rightmouseup
-      MOUSE_MOVED = 5 # https://developer.apple.com/documentation/coregraphics/cgeventtype/mousemoved
-      LEFT_MOUSE_DRAGGED = 6 # https://developer.apple.com/documentation/coregraphics/cgeventtype/leftmousedragged
-      RIGHT_MOUSE_DRAGGED = 7 # https://developer.apple.com/documentation/coregraphics/cgeventtype/rightmousedragged
-      KEY_DOWN = 10 # https://developer.apple.com/documentation/coregraphics/cgeventtype/keydown
-      KEY_UP = 11 # https://developer.apple.com/documentation/coregraphics/cgeventtype/keyup
-      OTHER_MOUSE_DOWN = 25 # https://developer.apple.com/documentation/coregraphics/cgeventtype/othermousedown
-      OTHER_MOUSE_UP = 26 # https://developer.apple.com/documentation/coregraphics/cgeventtype/othermouseup
-      OTHER_MOUSE_DRAGGED = 27 # https://developer.apple.com/documentation/coregraphics/cgeventtype/othermousedragged
-    end
-  end
-end

data/lib/macos/cg/mouse_button.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-module MacOS
-  module CG
-    # https://developer.apple.com/documentation/coregraphics/cgmousebutton
-    module MouseButton
-      LEFT = 0 # https://developer.apple.com/documentation/coregraphics/cgmousebutton/left
-      RIGHT = 1 # https://developer.apple.com/documentation/coregraphics/cgmousebutton/right
-      CENTER = 2 # https://developer.apple.com/documentation/coregraphics/cgmousebutton/center
-    end
-  end
-end

data/lib/macos/cg/point.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require "ffi"
-
-module MacOS
-  module CG
-    # https://developer.apple.com/documentation/corefoundation/cgpoint
-    class Point < FFI::Struct
-      layout :x, :double, :y, :double
-    end
-  end
-end

data/lib/macos/cg/rect.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require "ffi"
-
-module MacOS
-  module CG
-    # https://developer.apple.com/documentation/corefoundation/cgrect
-    class Rect < FFI::Struct
-      layout :origin, MacOS::CG::Point, :size, MacOS::CG::Size
-    end
-  end
-end

data/lib/macos/cg/size.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require "ffi"
-
-module MacOS
-  module CG
-    # https://developer.apple.com/documentation/corefoundation/cgsize
-    class Size < FFI::Struct
-      layout :width, :double, :height, :double
-    end
-  end
-end

data/lib/macos/library.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require "ffi"
-
-module MacOS
-  # https://developer.apple.com/documentation/coregraphics
-  module Library
-    extend ::FFI::Library
-    ffi_lib "/System/Library/Frameworks/CoreGraphics.framework/CoreGraphics"
-
-    attach_function :CGEventCreate, %i[pointer], :pointer
-    attach_function :CGEventGetLocation, %i[pointer], CG::Point.by_value
-    attach_function :CFRelease, %i[pointer], :void
-    attach_function :CGEventCreateMouseEvent, [:pointer, :uint32, CG::Point.by_value, :uint32], :pointer
-    attach_function :CGEventPost, %i[uint32 pointer], :void
-    attach_function :CGWarpMouseCursorPosition, [CG::Point.by_value], :pointer
-    attach_function :CGEventCreateKeyboardEvent, %i[pointer uint16 bool bool], :pointer
-    attach_function :CGMainDisplayID, [], :uint32
-    attach_function :CGDisplayBounds, [:uint32], CG::Rect.by_value
-  end
-end