/*
* Copyright (c) 2011, 2020, 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.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.
*/
CRobot(CGraphicsDevice d) {
fDevice = d;
initRobot();
}
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);
}