/*
 * Copyright (c) 2011, 2018, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package sun.lwawt.macosx;

import java.awt.Point;
import java.awt.Rectangle;
import java.awt.Robot;
import java.awt.peer.RobotPeer;

import sun.awt.CGraphicsDevice;

final class CRobot implements RobotPeer {

    private static final int MOUSE_LOCATION_UNKNOWN      = -1;

    private final CGraphicsDevice fDevice;
    private int mouseLastX = MOUSE_LOCATION_UNKNOWN;
    private int mouseLastY = MOUSE_LOCATION_UNKNOWN;

    // OS X doesn't generate dragged event as a result of button press and
    // mouse move events. This means that we have to track buttons state
    // in order to generate dragged events ourselves.
    private int mouseButtonsState = 0;

    
Uses the given GraphicsDevice as the coordinate system for subsequent coordinate calls.
/** * Uses the given GraphicsDevice as the coordinate system for subsequent * coordinate calls. */
public CRobot(Robot r, CGraphicsDevice d) { fDevice = d; initRobot(); } @Override public void dispose() { }
Moves mouse pointer to given screen coordinates.
Params:
  • x – X position
  • y – Y position
/** * Moves mouse pointer to given screen coordinates. * @param x X position * @param y Y position */
@Override public void mouseMove(int x, int y) { mouseLastX = x; mouseLastY = y; mouseEvent(mouseLastX, mouseLastY, mouseButtonsState, true, true); }
Presses one or more mouse buttons.
Params:
  • buttons – the button mask (combination of InputEvent.BUTTON1/2/3_MASK)
/** * Presses one or more mouse buttons. * * @param buttons the button mask (combination of * {@code InputEvent.BUTTON1/2/3_MASK}) */
@Override public void mousePress(int buttons) { mouseButtonsState |= buttons; checkMousePos(); mouseEvent(mouseLastX, mouseLastY, buttons, true, false); }
Releases one or more mouse buttons.
Params:
  • buttons – the button mask (combination of InputEvent.BUTTON1/2/3_MASK)
/** * Releases one or more mouse buttons. * * @param buttons the button mask (combination of * {@code InputEvent.BUTTON1/2/3_MASK}) */
@Override public void mouseRelease(int buttons) { mouseButtonsState &= ~buttons; checkMousePos(); mouseEvent(mouseLastX, mouseLastY, buttons, false, false); }
Set unknown mouse location, if needed.
/** * Set unknown mouse location, if needed. */
private void checkMousePos() { if (mouseLastX == MOUSE_LOCATION_UNKNOWN || mouseLastY == MOUSE_LOCATION_UNKNOWN) { Rectangle deviceBounds = fDevice.getDefaultConfiguration().getBounds(); Point mousePos = CCursorManager.getInstance().getCursorPosition(); if (mousePos.x < deviceBounds.x) { mousePos.x = deviceBounds.x; } else if (mousePos.x > deviceBounds.x + deviceBounds.width) { mousePos.x = deviceBounds.x + deviceBounds.width; } if (mousePos.y < deviceBounds.y) { mousePos.y = deviceBounds.y; } else if (mousePos.y > deviceBounds.y + deviceBounds.height) { mousePos.y = deviceBounds.y + deviceBounds.height; } mouseLastX = mousePos.x; mouseLastY = mousePos.y; } } @Override public native void mouseWheel(int wheelAmt);
Presses a given key.

Key codes that have more than one physical key associated with them (e.g. KeyEvent.VK_SHIFT could mean either the left or right shift key) will map to the left key.

Assumes that the peer implementations will throw an exception for other bogus values e.g. -1, 999999

Params:
  • keycode – the key to press (e.g. KeyEvent.VK_A)
/** * Presses a given key. * <p> * Key codes that have more than one physical key associated with them * (e.g. {@code KeyEvent.VK_SHIFT} could mean either the * left or right shift key) will map to the left key. * <p> * Assumes that the * peer implementations will throw an exception for other bogus * values e.g. -1, 999999 * * @param keycode the key to press (e.g. {@code KeyEvent.VK_A}) */
@Override public void keyPress(final int keycode) { keyEvent(keycode, true); }
Releases a given key.

Key codes that have more than one physical key associated with them (e.g. KeyEvent.VK_SHIFT could mean either the left or right shift key) will map to the left key.

Assumes that the peer implementations will throw an exception for other bogus values e.g. -1, 999999

Params:
  • keycode – the key to release (e.g. KeyEvent.VK_A)
/** * Releases a given key. * <p> * Key codes that have more than one physical key associated with them * (e.g. {@code KeyEvent.VK_SHIFT} could mean either the * left or right shift key) will map to the left key. * <p> * Assumes that the * peer implementations will throw an exception for other bogus * values e.g. -1, 999999 * * @param keycode the key to release (e.g. {@code KeyEvent.VK_A}) */
@Override public void keyRelease(final int keycode) { keyEvent(keycode, false); }
Returns the color of a pixel at the given screen coordinates.
Params:
  • x – X position of pixel
  • y – Y position of pixel
Returns:color of the pixel
/** * Returns the color of a pixel at the given screen coordinates. * @param x X position of pixel * @param y Y position of pixel * @return color of the pixel */
@Override public int getRGBPixel(int x, int y) { int[] c = new int[1]; double scale = fDevice.getScaleFactor(); getScreenPixels(new Rectangle(x, y, (int) scale, (int) scale), c); return c[0]; }
Creates an image containing pixels read from the screen.
Params:
  • bounds – the rect to capture in screen coordinates
Returns:the array of pixels
/** * Creates an image containing pixels read from the screen. * @param bounds the rect to capture in screen coordinates * @return the array of pixels */
@Override public int [] getRGBPixels(final Rectangle bounds) { int[] c = new int[bounds.width * bounds.height]; getScreenPixels(bounds, c); return c; } private native void initRobot(); private native void mouseEvent(int lastX, int lastY, int buttonsState, boolean isButtonsDownState, boolean isMouseMove); private native void keyEvent(int javaKeyCode, boolean keydown); private void getScreenPixels(Rectangle r, int[] pixels){ double scale = fDevice.getScaleFactor(); nativeGetScreenPixels(r.x, r.y, r.width, r.height, scale, pixels); } private native void nativeGetScreenPixels(int x, int y, int width, int height, double scale, int[] pixels); }