* void printSamples(MotionEvent ev) {
- * final int historySize = ev.getHistorySize();
- * final int pointerCount = ev.getPointerCount();
- * for (int h = 0; h < historySize; h++) {
- * System.out.printf("At time %d:", ev.getHistoricalEventTime(h));
- * for (int p = 0; p < pointerCount; p++) {
- * System.out.printf(" pointer %d: (%f,%f)",
- * ev.getPointerId(p), ev.getHistoricalX(p, h), ev.getHistoricalY(p, h));
- * }
- * }
- * System.out.printf("At time %d:", ev.getEventTime());
- * for (int p = 0; p < pointerCount; p++) {
- * System.out.printf(" pointer %d: (%f,%f)",
- * ev.getPointerId(p), ev.getX(p), ev.getY(p));
- * }
+ * final int historySize = ev.getHistorySize();
+ * final int pointerCount = ev.getPointerCount();
+ * for (int h = 0; h < historySize; h++) {
+ * System.out.printf("At time %d:", ev.getHistoricalEventTime(h));
+ * for (int p = 0; p < pointerCount; p++) {
+ * System.out.printf(" pointer %d: (%f,%f)",
+ * ev.getPointerId(p), ev.getHistoricalX(p, h), ev.getHistoricalY(p, h));
+ * }
+ * }
+ * System.out.printf("At time %d:", ev.getEventTime());
+ * for (int p = 0; p < pointerCount; p++) {
+ * System.out.printf(" pointer %d: (%f,%f)",
+ * ev.getPointerId(p), ev.getX(p), ev.getY(p));
+ * }
* }
* - * This is also a good time to check the button state to distinguish - * secondary and tertiary button clicks and handle them appropriately. - * Use {@link #getButtonState} to retrieve the button state. - *
- */ - public static final int ACTION_DOWN = 0; - - /** - * Constant for {@link #getActionMasked}: A pressed gesture has finished, the - * motion contains the final release location as well as any intermediate - * points since the last down or move event. - */ - public static final int ACTION_UP = 1; - - /** - * Constant for {@link #getActionMasked}: A change has happened during a - * press gesture (between {@link #ACTION_DOWN} and {@link #ACTION_UP}). - * The motion contains the most recent point, as well as any intermediate - * points since the last down or move event. - */ - public static final int ACTION_MOVE = 2; - - /** - * Constant for {@link #getActionMasked}: The current gesture has been aborted. - * You will not receive any more points in it. You should treat this as - * an up event, but not perform any action that you normally would. - */ - public static final int ACTION_CANCEL = 3; - - /** - * Constant for {@link #getActionMasked}: A movement has happened outside of the - * normal bounds of the UI element. This does not provide a full gesture, - * but only the initial location of the movement/touch. - */ - public static final int ACTION_OUTSIDE = 4; - - /** - * Constant for {@link #getActionMasked}: A non-primary pointer has gone down. - *- * Use {@link #getActionIndex} to retrieve the index of the pointer that changed. - *
- * The index is encoded in the {@link #ACTION_POINTER_INDEX_MASK} bits of the - * unmasked action returned by {@link #getAction}. - *
- */ - public static final int ACTION_POINTER_DOWN = 5; - - /** - * Constant for {@link #getActionMasked}: A non-primary pointer has gone up. - *- * Use {@link #getActionIndex} to retrieve the index of the pointer that changed. - *
- * The index is encoded in the {@link #ACTION_POINTER_INDEX_MASK} bits of the - * unmasked action returned by {@link #getAction}. - *
- */ - public static final int ACTION_POINTER_UP = 6; - - /** - * Constant for {@link #getActionMasked}: A change happened but the pointer - * is not down (unlike {@link #ACTION_MOVE}). The motion contains the most - * recent point, as well as any intermediate points since the last - * hover move event. - *- * This action is always delivered to the window or view under the pointer. - *
- * This action is not a touch event so it is delivered to - * {@link View#onGenericMotionEvent(MotionEvent)} rather than - * {@link View#onTouchEvent(MotionEvent)}. - *
- */ - public static final int ACTION_HOVER_MOVE = 7; - - /** - * Constant for {@link #getActionMasked}: The motion event contains relative - * vertical and/or horizontal scroll offsets. Use {@link #getAxisValue(int)} - * to retrieve the information from {@link #AXIS_VSCROLL} and {@link #AXIS_HSCROLL}. - * The pointer may or may not be down when this event is dispatched. - *- * This action is always delivered to the window or view under the pointer, which - * may not be the window or view currently touched. - *
- * This action is not a touch event so it is delivered to - * {@link View#onGenericMotionEvent(MotionEvent)} rather than - * {@link View#onTouchEvent(MotionEvent)}. - *
- */ - public static final int ACTION_SCROLL = 8; - - /** - * Constant for {@link #getActionMasked}: The pointer is not down but has entered the - * boundaries of a window or view. - *- * This action is always delivered to the window or view under the pointer. - *
- * This action is not a touch event so it is delivered to - * {@link View#onGenericMotionEvent(MotionEvent)} rather than - * {@link View#onTouchEvent(MotionEvent)}. - *
- */ - public static final int ACTION_HOVER_ENTER = 9; - - /** - * Constant for {@link #getActionMasked}: The pointer is not down but has exited the - * boundaries of a window or view. - *- * This action is always delivered to the window or view that was previously under the pointer. - *
- * This action is not a touch event so it is delivered to - * {@link View#onGenericMotionEvent(MotionEvent)} rather than - * {@link View#onTouchEvent(MotionEvent)}. - *
- */ - public static final int ACTION_HOVER_EXIT = 10; - - /** - * Bits in the action code that represent a pointer index, used with - * {@link #ACTION_POINTER_DOWN} and {@link #ACTION_POINTER_UP}. Shifting - * down by {@link #ACTION_POINTER_INDEX_SHIFT} provides the actual pointer - * index where the data for the pointer going up or down can be found; you can - * get its identifier with {@link #getPointerId(int)} and the actual - * data with {@link #getX(int)} etc. - * - * @see #getActionIndex - */ - public static final int ACTION_POINTER_INDEX_MASK = 0xff00; - - /** - * Bit shift for the action bits holding the pointer index as - * defined by {@link #ACTION_POINTER_INDEX_MASK}. - * - * @see #getActionIndex - */ - public static final int ACTION_POINTER_INDEX_SHIFT = 8; - - /** - * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the - * data index associated with {@link #ACTION_POINTER_DOWN}. - */ - @Deprecated - public static final int ACTION_POINTER_1_DOWN = ACTION_POINTER_DOWN | 0x0000; - - /** - * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the - * data index associated with {@link #ACTION_POINTER_DOWN}. - */ - @Deprecated - public static final int ACTION_POINTER_2_DOWN = ACTION_POINTER_DOWN | 0x0100; - - /** - * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the - * data index associated with {@link #ACTION_POINTER_DOWN}. - */ - @Deprecated - public static final int ACTION_POINTER_3_DOWN = ACTION_POINTER_DOWN | 0x0200; - - /** - * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the - * data index associated with {@link #ACTION_POINTER_UP}. - */ - @Deprecated - public static final int ACTION_POINTER_1_UP = ACTION_POINTER_UP | 0x0000; - - /** - * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the - * data index associated with {@link #ACTION_POINTER_UP}. - */ - @Deprecated - public static final int ACTION_POINTER_2_UP = ACTION_POINTER_UP | 0x0100; - - /** - * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the - * data index associated with {@link #ACTION_POINTER_UP}. - */ - @Deprecated - public static final int ACTION_POINTER_3_UP = ACTION_POINTER_UP | 0x0200; - - /** - * @deprecated Renamed to {@link #ACTION_POINTER_INDEX_MASK} to match - * the actual data contained in these bits. - */ - @Deprecated - public static final int ACTION_POINTER_ID_MASK = 0xff00; - - /** - * @deprecated Renamed to {@link #ACTION_POINTER_INDEX_SHIFT} to match - * the actual data contained in these bits. - */ - @Deprecated - public static final int ACTION_POINTER_ID_SHIFT = 8; - - /** - * This flag indicates that the window that received this motion event is partly - * or wholly obscured by another visible window above it. This flag is set to true - * even if the event did not directly pass through the obscured area. - * A security sensitive application can check this flag to identify situations in which - * a malicious application may have covered up part of its content for the purpose - * of misleading the user or hijacking touches. An appropriate response might be - * to drop the suspect touches or to take additional precautions to confirm the user's - * actual intent. - */ - public static final int FLAG_WINDOW_IS_OBSCURED = 0x1; - - /** - * Private flag that indicates when the system has detected that this motion event - * may be inconsistent with respect to the sequence of previously delivered motion events, - * such as when a pointer move event is sent but the pointer is not down. - * - * @hide - * @see #isTainted - * @see #setTainted - */ - public static final int FLAG_TAINTED = 0x80000000; - - /** - * Flag indicating the motion event intersected the top edge of the screen. - */ - public static final int EDGE_TOP = 0x00000001; - - /** - * Flag indicating the motion event intersected the bottom edge of the screen. - */ - public static final int EDGE_BOTTOM = 0x00000002; - - /** - * Flag indicating the motion event intersected the left edge of the screen. - */ - public static final int EDGE_LEFT = 0x00000004; - - /** - * Flag indicating the motion event intersected the right edge of the screen. - */ - public static final int EDGE_RIGHT = 0x00000008; - - /** - * Axis constant: X axis of a motion event. - *- *
- *
- *
- *
- *
- *
- * When the touch is circular, the major and minor axis lengths will be equal to one another. - *
- * - * @see #getTouchMinor(int) - * @see #getHistoricalTouchMinor(int, int) - * @see MotionEvent.PointerCoords#touchMinor - * @see InputDevice#getMotionRange - */ - public static final int AXIS_TOUCH_MINOR = 5; - - /** - * Axis constant: ToolMajor axis of a motion event. - *- *
- * When the touch is circular, the major and minor axis lengths will be equal to one another. - *
- * The tool size may be larger than the touch size since the tool may not be fully - * in contact with the touch sensor. - *
- * - * @see #getToolMajor(int) - * @see #getHistoricalToolMajor(int, int) - * @see MotionEvent.PointerCoords#toolMajor - * @see InputDevice#getMotionRange - */ - public static final int AXIS_TOOL_MAJOR = 6; - - /** - * Axis constant: ToolMinor axis of a motion event. - *- *
- * When the touch is circular, the major and minor axis lengths will be equal to one another. - *
- * The tool size may be larger than the touch size since the tool may not be fully - * in contact with the touch sensor. - *
- * - * @see #getToolMinor(int) - * @see #getHistoricalToolMinor(int, int) - * @see MotionEvent.PointerCoords#toolMinor - * @see InputDevice#getMotionRange - */ - public static final int AXIS_TOOL_MINOR = 7; - - /** - * Axis constant: Orientation axis of a motion event. - *- *
- *
- * This axis should be used to scroll views vertically. - *
- * - * @see #getAxisValue(int, int) - * @see #getHistoricalAxisValue(int, int, int) - * @see MotionEvent.PointerCoords#getAxisValue(int) - * @see InputDevice#getMotionRange - */ - public static final int AXIS_VSCROLL = 9; - - /** - * Axis constant: Horizontal Scroll axis of a motion event. - *- *
- * This axis should be used to scroll views horizontally. - *
- * - * @see #getAxisValue(int, int) - * @see #getHistoricalAxisValue(int, int, int) - * @see MotionEvent.PointerCoords#getAxisValue(int) - * @see InputDevice#getMotionRange - */ - public static final int AXIS_HSCROLL = 10; - - /** - * Axis constant: Z axis of a motion event. - *- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- * The system may send a {@link KeyEvent#KEYCODE_BACK} key press to the application - * when this button is pressed. - *
- * - * @see #getButtonState - */ - public static final int BUTTON_BACK = 1 << 3; - - /** - * Button constant: Forward button pressed (mouse forward button). - *- * The system may send a {@link KeyEvent#KEYCODE_FORWARD} key press to the application - * when this button is pressed. - *
- * - * @see #getButtonState - */ - public static final int BUTTON_FORWARD = 1 << 4; - - // NOTE: If you add a new axis here you must also add it to: - // native/include/android/input.h - - // Symbolic names of all button states in bit order from least significant - // to most significant. - private static final String[] BUTTON_SYMBOLIC_NAMES = new String[] { - "BUTTON_PRIMARY", - "BUTTON_SECONDARY", - "BUTTON_TERTIARY", - "BUTTON_BACK", - "BUTTON_FORWARD", - "0x00000020", - "0x00000040", - "0x00000080", - "0x00000100", - "0x00000200", - "0x00000400", - "0x00000800", - "0x00001000", - "0x00002000", - "0x00004000", - "0x00008000", - "0x00010000", - "0x00020000", - "0x00040000", - "0x00080000", - "0x00100000", - "0x00200000", - "0x00400000", - "0x00800000", - "0x01000000", - "0x02000000", - "0x04000000", - "0x08000000", - "0x10000000", - "0x20000000", - "0x40000000", - "0x80000000", - }; - - /** - * Tool type constant: Unknown tool type. - * This constant is used when the tool type is not known or is not relevant, - * such as for a trackball or other non-pointing device. - * - * @see #getToolType - */ - public static final int TOOL_TYPE_UNKNOWN = 0; - - /** - * Tool type constant: The tool is a finger. - * - * @see #getToolType - */ - public static final int TOOL_TYPE_FINGER = 1; - - /** - * Tool type constant: The tool is a stylus. - * - * @see #getToolType - */ - public static final int TOOL_TYPE_STYLUS = 2; - - /** - * Tool type constant: The tool is a mouse or trackpad. - * - * @see #getToolType - */ - public static final int TOOL_TYPE_MOUSE = 3; - - /** - * Tool type constant: The tool is an eraser or a stylus being used in an inverted posture. - * - * @see #getToolType - */ - public static final int TOOL_TYPE_ERASER = 4; - - // NOTE: If you add a new tool type here you must also add it to: - // native/include/android/input.h - - // Symbolic names of all tool types. - private static final SparseArray+ * This is also a good time to check the button state to distinguish + * secondary and tertiary button clicks and handle them appropriately. + * Use {@link #getButtonState} to retrieve the button state. + *
+ */ + public static final int ACTION_DOWN = 0; + + /** + * Constant for {@link #getActionMasked}: A pressed gesture has finished, the + * motion contains the final release location as well as any intermediate + * points since the last down or move event. + */ + public static final int ACTION_UP = 1; + + /** + * Constant for {@link #getActionMasked}: A change has happened during a + * press gesture (between {@link #ACTION_DOWN} and {@link #ACTION_UP}). + * The motion contains the most recent point, as well as any intermediate + * points since the last down or move event. + */ + public static final int ACTION_MOVE = 2; + + /** + * Constant for {@link #getActionMasked}: The current gesture has been aborted. + * You will not receive any more points in it. You should treat this as + * an up event, but not perform any action that you normally would. + */ + public static final int ACTION_CANCEL = 3; + + /** + * Constant for {@link #getActionMasked}: A movement has happened outside of the + * normal bounds of the UI element. This does not provide a full gesture, + * but only the initial location of the movement/touch. + */ + public static final int ACTION_OUTSIDE = 4; + + /** + * Constant for {@link #getActionMasked}: A non-primary pointer has gone down. + *+ * Use {@link #getActionIndex} to retrieve the index of the pointer that changed. + *
+ * The index is encoded in the {@link #ACTION_POINTER_INDEX_MASK} bits of the + * unmasked action returned by {@link #getAction}. + *
+ */ + public static final int ACTION_POINTER_DOWN = 5; + + /** + * Constant for {@link #getActionMasked}: A non-primary pointer has gone up. + *+ * Use {@link #getActionIndex} to retrieve the index of the pointer that changed. + *
+ * The index is encoded in the {@link #ACTION_POINTER_INDEX_MASK} bits of the + * unmasked action returned by {@link #getAction}. + *
+ */ + public static final int ACTION_POINTER_UP = 6; + + /** + * Constant for {@link #getActionMasked}: A change happened but the pointer + * is not down (unlike {@link #ACTION_MOVE}). The motion contains the most + * recent point, as well as any intermediate points since the last + * hover move event. + *+ * This action is always delivered to the window or view under the pointer. + *
+ * This action is not a touch event so it is delivered to + * {@link View#onGenericMotionEvent(MotionEvent)} rather than + * {@link View#onTouchEvent(MotionEvent)}. + *
+ */ + public static final int ACTION_HOVER_MOVE = 7; + + /** + * Constant for {@link #getActionMasked}: The motion event contains relative + * vertical and/or horizontal scroll offsets. Use {@link #getAxisValue(int)} + * to retrieve the information from {@link #AXIS_VSCROLL} and {@link #AXIS_HSCROLL}. + * The pointer may or may not be down when this event is dispatched. + *+ * This action is always delivered to the window or view under the pointer, which + * may not be the window or view currently touched. + *
+ * This action is not a touch event so it is delivered to + * {@link View#onGenericMotionEvent(MotionEvent)} rather than + * {@link View#onTouchEvent(MotionEvent)}. + *
+ */ + public static final int ACTION_SCROLL = 8; + + /** + * Constant for {@link #getActionMasked}: The pointer is not down but has entered the + * boundaries of a window or view. + *+ * This action is always delivered to the window or view under the pointer. + *
+ * This action is not a touch event so it is delivered to + * {@link View#onGenericMotionEvent(MotionEvent)} rather than + * {@link View#onTouchEvent(MotionEvent)}. + *
+ */ + public static final int ACTION_HOVER_ENTER = 9; + + /** + * Constant for {@link #getActionMasked}: The pointer is not down but has exited the + * boundaries of a window or view. + *+ * This action is always delivered to the window or view that was previously under the pointer. + *
+ * This action is not a touch event so it is delivered to + * {@link View#onGenericMotionEvent(MotionEvent)} rather than + * {@link View#onTouchEvent(MotionEvent)}. + *
+ */ + public static final int ACTION_HOVER_EXIT = 10; + + /** + * Bits in the action code that represent a pointer index, used with + * {@link #ACTION_POINTER_DOWN} and {@link #ACTION_POINTER_UP}. Shifting + * down by {@link #ACTION_POINTER_INDEX_SHIFT} provides the actual pointer + * index where the data for the pointer going up or down can be found; you can + * get its identifier with {@link #getPointerId(int)} and the actual + * data with {@link #getX(int)} etc. + * + * @see #getActionIndex + */ + public static final int ACTION_POINTER_INDEX_MASK = 0xff00; + + /** + * Bit shift for the action bits holding the pointer index as + * defined by {@link #ACTION_POINTER_INDEX_MASK}. + * + * @see #getActionIndex + */ + public static final int ACTION_POINTER_INDEX_SHIFT = 8; + + /** + * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the + * data index associated with {@link #ACTION_POINTER_DOWN}. + */ + @Deprecated + public static final int ACTION_POINTER_1_DOWN = ACTION_POINTER_DOWN | 0x0000; + + /** + * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the + * data index associated with {@link #ACTION_POINTER_DOWN}. + */ + @Deprecated + public static final int ACTION_POINTER_2_DOWN = ACTION_POINTER_DOWN | 0x0100; + + /** + * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the + * data index associated with {@link #ACTION_POINTER_DOWN}. + */ + @Deprecated + public static final int ACTION_POINTER_3_DOWN = ACTION_POINTER_DOWN | 0x0200; + + /** + * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the + * data index associated with {@link #ACTION_POINTER_UP}. + */ + @Deprecated + public static final int ACTION_POINTER_1_UP = ACTION_POINTER_UP | 0x0000; + + /** + * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the + * data index associated with {@link #ACTION_POINTER_UP}. + */ + @Deprecated + public static final int ACTION_POINTER_2_UP = ACTION_POINTER_UP | 0x0100; + + /** + * @deprecated Use {@link #ACTION_POINTER_INDEX_MASK} to retrieve the + * data index associated with {@link #ACTION_POINTER_UP}. + */ + @Deprecated + public static final int ACTION_POINTER_3_UP = ACTION_POINTER_UP | 0x0200; + + /** + * @deprecated Renamed to {@link #ACTION_POINTER_INDEX_MASK} to match + * the actual data contained in these bits. + */ + @Deprecated + public static final int ACTION_POINTER_ID_MASK = 0xff00; + + /** + * @deprecated Renamed to {@link #ACTION_POINTER_INDEX_SHIFT} to match + * the actual data contained in these bits. + */ + @Deprecated + public static final int ACTION_POINTER_ID_SHIFT = 8; + + /** + * This flag indicates that the window that received this motion event is partly + * or wholly obscured by another visible window above it. This flag is set to true + * even if the event did not directly pass through the obscured area. + * A security sensitive application can check this flag to identify situations in which + * a malicious application may have covered up part of its content for the purpose + * of misleading the user or hijacking touches. An appropriate response might be + * to drop the suspect touches or to take additional precautions to confirm the user's + * actual intent. + */ + public static final int FLAG_WINDOW_IS_OBSCURED = 0x1; + + /** + * Private flag that indicates when the system has detected that this motion event + * may be inconsistent with respect to the sequence of previously delivered motion events, + * such as when a pointer move event is sent but the pointer is not down. + * + * @hide + * @see #isTainted + * @see #setTainted + */ + public static final int FLAG_TAINTED = 0x80000000; + + /** + * Flag indicating the motion event intersected the top edge of the screen. + */ + public static final int EDGE_TOP = 0x00000001; + + /** + * Flag indicating the motion event intersected the bottom edge of the screen. + */ + public static final int EDGE_BOTTOM = 0x00000002; + + /** + * Flag indicating the motion event intersected the left edge of the screen. + */ + public static final int EDGE_LEFT = 0x00000004; + + /** + * Flag indicating the motion event intersected the right edge of the screen. + */ + public static final int EDGE_RIGHT = 0x00000008; + + /** + * Axis constant: X axis of a motion event. + *+ *
+ *
+ *
+ *
+ *
+ *
+ * When the touch is circular, the major and minor axis lengths will be equal to one another. + *
+ * + * @see #getTouchMinor(int) + * @see #getHistoricalTouchMinor(int, int) + * @see MotionEvent.PointerCoords#touchMinor + * @see InputDevice#getMotionRange + */ + public static final int AXIS_TOUCH_MINOR = 5; + + /** + * Axis constant: ToolMajor axis of a motion event. + *+ *
+ * When the touch is circular, the major and minor axis lengths will be equal to one another. + *
+ * The tool size may be larger than the touch size since the tool may not be fully + * in contact with the touch sensor. + *
+ * + * @see #getToolMajor(int) + * @see #getHistoricalToolMajor(int, int) + * @see MotionEvent.PointerCoords#toolMajor + * @see InputDevice#getMotionRange + */ + public static final int AXIS_TOOL_MAJOR = 6; + + /** + * Axis constant: ToolMinor axis of a motion event. + *+ *
+ * When the touch is circular, the major and minor axis lengths will be equal to one another. + *
+ * The tool size may be larger than the touch size since the tool may not be fully + * in contact with the touch sensor. + *
+ * + * @see #getToolMinor(int) + * @see #getHistoricalToolMinor(int, int) + * @see MotionEvent.PointerCoords#toolMinor + * @see InputDevice#getMotionRange + */ + public static final int AXIS_TOOL_MINOR = 7; + + /** + * Axis constant: Orientation axis of a motion event. + *+ *
+ *
+ * This axis should be used to scroll views vertically. + *
+ * + * @see #getAxisValue(int, int) + * @see #getHistoricalAxisValue(int, int, int) + * @see MotionEvent.PointerCoords#getAxisValue(int) + * @see InputDevice#getMotionRange + */ + public static final int AXIS_VSCROLL = 9; + + /** + * Axis constant: Horizontal Scroll axis of a motion event. + *+ *
+ * This axis should be used to scroll views horizontally. + *
+ * + * @see #getAxisValue(int, int) + * @see #getHistoricalAxisValue(int, int, int) + * @see MotionEvent.PointerCoords#getAxisValue(int) + * @see InputDevice#getMotionRange + */ + public static final int AXIS_HSCROLL = 10; + + /** + * Axis constant: Z axis of a motion event. + *+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * The system may send a {@link KeyEvent#KEYCODE_BACK} key press to the application + * when this button is pressed. + *
+ * + * @see #getButtonState + */ + public static final int BUTTON_BACK = 1 << 3; + + /** + * Button constant: Forward button pressed (mouse forward button). + *+ * The system may send a {@link KeyEvent#KEYCODE_FORWARD} key press to the application + * when this button is pressed. + *
+ * + * @see #getButtonState + */ + public static final int BUTTON_FORWARD = 1 << 4; + + // NOTE: If you add a new axis here you must also add it to: + // native/include/android/input.h + + // Symbolic names of all button states in bit order from least significant + // to most significant. + private static final String[] BUTTON_SYMBOLIC_NAMES = new String[] { + "BUTTON_PRIMARY", + "BUTTON_SECONDARY", + "BUTTON_TERTIARY", + "BUTTON_BACK", + "BUTTON_FORWARD", + "0x00000020", + "0x00000040", + "0x00000080", + "0x00000100", + "0x00000200", + "0x00000400", + "0x00000800", + "0x00001000", + "0x00002000", + "0x00004000", + "0x00008000", + "0x00010000", + "0x00020000", + "0x00040000", + "0x00080000", + "0x00100000", + "0x00200000", + "0x00400000", + "0x00800000", + "0x01000000", + "0x02000000", + "0x04000000", + "0x08000000", + "0x10000000", + "0x20000000", + "0x40000000", + "0x80000000", + }; + + /** + * Tool type constant: Unknown tool type. + * This constant is used when the tool type is not known or is not relevant, + * such as for a trackball or other non-pointing device. + * + * @see #getToolType + */ + public static final int TOOL_TYPE_UNKNOWN = 0; + + /** + * Tool type constant: The tool is a finger. + * + * @see #getToolType + */ + public static final int TOOL_TYPE_FINGER = 1; + + /** + * Tool type constant: The tool is a stylus. + * + * @see #getToolType + */ + public static final int TOOL_TYPE_STYLUS = 2; + + /** + * Tool type constant: The tool is a mouse or trackpad. + * + * @see #getToolType + */ + public static final int TOOL_TYPE_MOUSE = 3; + + /** + * Tool type constant: The tool is an eraser or a stylus being used in an inverted posture. + * + * @see #getToolType + */ + public static final int TOOL_TYPE_ERASER = 4; + + // NOTE: If you add a new tool type here you must also add it to: + // native/include/android/input.h + + // Symbolic names of all tool types. + private static final SparseArray- * Specifically excludes pointer events with action {@link #ACTION_HOVER_MOVE}, - * {@link #ACTION_HOVER_ENTER}, {@link #ACTION_HOVER_EXIT}, or {@link #ACTION_SCROLL} - * because they are not actually touch events (the pointer is not down). - *
- * @return True if this motion event is a touch event. - * @hide - */ - public final boolean isTouchEvent() { - return nativeIsTouchEvent(mNativePtr); - } + /** + * Returns true if this motion event is a touch event. + *+ * Specifically excludes pointer events with action {@link #ACTION_HOVER_MOVE}, + * {@link #ACTION_HOVER_ENTER}, {@link #ACTION_HOVER_EXIT}, or {@link #ACTION_SCROLL} + * because they are not actually touch events (the pointer is not down). + *
+ * @return True if this motion event is a touch event. + * @hide + */ + public final boolean isTouchEvent() { + return nativeIsTouchEvent(mNativePtr); + } - /** - * Gets the motion event flags. - * - * @see #FLAG_WINDOW_IS_OBSCURED - */ - public final int getFlags() { - return nativeGetFlags(mNativePtr); - } + /** + * Gets the motion event flags. + * + * @see #FLAG_WINDOW_IS_OBSCURED + */ + public final int getFlags() { + return nativeGetFlags(mNativePtr); + } - /** @hide */ - @Override - public final boolean isTainted() { - final int flags = getFlags(); - return (flags & FLAG_TAINTED) != 0; - } + /** @hide */ + @Override + public final boolean isTainted() { + final int flags = getFlags(); + return (flags & FLAG_TAINTED) != 0; + } - /** @hide */ - @Override - public final void setTainted(boolean tainted) { - final int flags = getFlags(); - nativeSetFlags(mNativePtr, tainted ? flags | FLAG_TAINTED : flags & ~FLAG_TAINTED); - } + /** @hide */ + @Override + public final void setTainted(boolean tainted) { + final int flags = getFlags(); + nativeSetFlags(mNativePtr, tainted ? flags | FLAG_TAINTED : flags & ~FLAG_TAINTED); + } - /** - * Returns the time (in ms) when the user originally pressed down to start - * a stream of position events. - */ - public final long getDownTime() { - return nativeGetDownTimeNanos(mNativePtr) / NS_PER_MS; - } + /** + * Returns the time (in ms) when the user originally pressed down to start + * a stream of position events. + */ + public final long getDownTime() { + return nativeGetDownTimeNanos(mNativePtr) / NS_PER_MS; + } - /** - * Sets the time (in ms) when the user originally pressed down to start - * a stream of position events. - * - * @hide - */ - public final void setDownTime(long downTime) { - nativeSetDownTimeNanos(mNativePtr, downTime * NS_PER_MS); - } + /** + * Sets the time (in ms) when the user originally pressed down to start + * a stream of position events. + * + * @hide + */ + public final void setDownTime(long downTime) { + nativeSetDownTimeNanos(mNativePtr, downTime * NS_PER_MS); + } - /** - * Retrieve the time this event occurred, - * in the {@link android.os.SystemClock#uptimeMillis} time base. - * - * @return Returns the time this event occurred, - * in the {@link android.os.SystemClock#uptimeMillis} time base. - */ - @Override - public final long getEventTime() { - return nativeGetEventTimeNanos(mNativePtr, HISTORY_CURRENT) / NS_PER_MS; - } + /** + * Retrieve the time this event occurred, + * in the {@link android.os.SystemClock#uptimeMillis} time base. + * + * @return Returns the time this event occurred, + * in the {@link android.os.SystemClock#uptimeMillis} time base. + */ + @Override + public final long getEventTime() { + return nativeGetEventTimeNanos(mNativePtr, HISTORY_CURRENT) / NS_PER_MS; + } - /** - * Retrieve the time this event occurred, - * in the {@link android.os.SystemClock#uptimeMillis} time base but with - * nanosecond precision. - *- * The value is in nanosecond precision but it may not have nanosecond accuracy. - *
- * - * @return Returns the time this event occurred, - * in the {@link android.os.SystemClock#uptimeMillis} time base but with - * nanosecond precision. - * - * @hide - */ - @Override - public final long getEventTimeNano() { - return nativeGetEventTimeNanos(mNativePtr, HISTORY_CURRENT); - } + /** + * Retrieve the time this event occurred, + * in the {@link android.os.SystemClock#uptimeMillis} time base but with + * nanosecond precision. + *+ * The value is in nanosecond precision but it may not have nanosecond accuracy. + *
+ * + * @return Returns the time this event occurred, + * in the {@link android.os.SystemClock#uptimeMillis} time base but with + * nanosecond precision. + * + * @hide + */ + @Override + public final long getEventTimeNano() { + return nativeGetEventTimeNanos(mNativePtr, HISTORY_CURRENT); + } - /** - * {@link #getX(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_X - */ - public final float getX() { - return coord_x; - } + /** + * {@link #getX(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_X + */ + public final float getX() { + return coord_x; + } - /** - * {@link #getY(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_Y - */ - public final float getY() { - return coord_y; - } + /** + * {@link #getY(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_Y + */ + public final float getY() { + return coord_y; + } - /** - * {@link #getPressure(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_PRESSURE - */ - public final float getPressure() { -// return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, 0, HISTORY_CURRENT); + /** + * {@link #getPressure(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_PRESSURE + */ + public final float getPressure() { +// return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, 0, HISTORY_CURRENT); return 0; - } + } - /** - * {@link #getSize(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_SIZE - */ - public final float getSize() { - return nativeGetAxisValue(mNativePtr, AXIS_SIZE, 0, HISTORY_CURRENT); - } - - /** - * {@link #getTouchMajor(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_TOUCH_MAJOR - */ - public final float getTouchMajor() { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, 0, HISTORY_CURRENT); - } + /** + * {@link #getSize(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_SIZE + */ + public final float getSize() { + return nativeGetAxisValue(mNativePtr, AXIS_SIZE, 0, HISTORY_CURRENT); + } + + /** + * {@link #getTouchMajor(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_TOUCH_MAJOR + */ + public final float getTouchMajor() { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, 0, HISTORY_CURRENT); + } - /** - * {@link #getTouchMinor(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_TOUCH_MINOR - */ - public final float getTouchMinor() { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, 0, HISTORY_CURRENT); - } - - /** - * {@link #getToolMajor(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_TOOL_MAJOR - */ - public final float getToolMajor() { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, 0, HISTORY_CURRENT); - } + /** + * {@link #getTouchMinor(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_TOUCH_MINOR + */ + public final float getTouchMinor() { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, 0, HISTORY_CURRENT); + } + + /** + * {@link #getToolMajor(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_TOOL_MAJOR + */ + public final float getToolMajor() { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, 0, HISTORY_CURRENT); + } - /** - * {@link #getToolMinor(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_TOOL_MINOR - */ - public final float getToolMinor() { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, 0, HISTORY_CURRENT); - } + /** + * {@link #getToolMinor(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_TOOL_MINOR + */ + public final float getToolMinor() { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, 0, HISTORY_CURRENT); + } - /** - * {@link #getOrientation(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @see #AXIS_ORIENTATION - */ - public final float getOrientation() { - return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, 0, HISTORY_CURRENT); - } + /** + * {@link #getOrientation(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @see #AXIS_ORIENTATION + */ + public final float getOrientation() { + return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, 0, HISTORY_CURRENT); + } - /** - * {@link #getAxisValue(int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param axis The axis identifier for the axis value to retrieve. - * - * @see #AXIS_X - * @see #AXIS_Y - */ - public final float getAxisValue(int axis) { - return nativeGetAxisValue(mNativePtr, axis, 0, HISTORY_CURRENT); - } + /** + * {@link #getAxisValue(int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param axis The axis identifier for the axis value to retrieve. + * + * @see #AXIS_X + * @see #AXIS_Y + */ + public final float getAxisValue(int axis) { + return nativeGetAxisValue(mNativePtr, axis, 0, HISTORY_CURRENT); + } - /** - * The number of pointers of data contained in this event. Always - * >= 1. - */ - public final int getPointerCount() { - return 1; - } - - /** - * Return the pointer identifier associated with a particular pointer - * data index is this event. The identifier tells you the actual pointer - * number associated with the data, accounting for individual pointers - * going up and down since the start of the current gesture. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - */ - public final int getPointerId(int pointerIndex) { - return pointerIndex; - } + /** + * The number of pointers of data contained in this event. Always + * >= 1. + */ + public final int getPointerCount() { + return 1; + } + + /** + * Return the pointer identifier associated with a particular pointer + * data index is this event. The identifier tells you the actual pointer + * number associated with the data, accounting for individual pointers + * going up and down since the start of the current gesture. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + */ + public final int getPointerId(int pointerIndex) { + return pointerIndex; + } - /** - * Gets the tool type of a pointer for the given pointer index. - * The tool type indicates the type of tool used to make contact such - * as a finger or stylus, if known. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @return The tool type of the pointer. - * - * @see #TOOL_TYPE_UNKNOWN - * @see #TOOL_TYPE_FINGER - * @see #TOOL_TYPE_STYLUS - * @see #TOOL_TYPE_MOUSE - */ - public final int getToolType(int pointerIndex) { - return nativeGetToolType(mNativePtr, pointerIndex); - } + /** + * Gets the tool type of a pointer for the given pointer index. + * The tool type indicates the type of tool used to make contact such + * as a finger or stylus, if known. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @return The tool type of the pointer. + * + * @see #TOOL_TYPE_UNKNOWN + * @see #TOOL_TYPE_FINGER + * @see #TOOL_TYPE_STYLUS + * @see #TOOL_TYPE_MOUSE + */ + public final int getToolType(int pointerIndex) { + return nativeGetToolType(mNativePtr, pointerIndex); + } - /** - * Given a pointer identifier, find the index of its data in the event. - * - * @param pointerId The identifier of the pointer to be found. - * @return Returns either the index of the pointer (for use with - * {@link #getX(int)} et al.), or -1 if there is no data available for - * that pointer identifier. - */ - public final int findPointerIndex(int pointerId) { - return nativeFindPointerIndex(mNativePtr, pointerId); - } + /** + * Given a pointer identifier, find the index of its data in the event. + * + * @param pointerId The identifier of the pointer to be found. + * @return Returns either the index of the pointer (for use with + * {@link #getX(int)} et al.), or -1 if there is no data available for + * that pointer identifier. + */ + public final int findPointerIndex(int pointerId) { + return nativeFindPointerIndex(mNativePtr, pointerId); + } - /** - * Returns the X coordinate of this event for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * Whole numbers are pixels; the - * value may have a fraction for input devices that are sub-pixel precise. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_X - */ - public final float getX(int pointerIndex) { - return coord_x; - } + /** + * Returns the X coordinate of this event for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * Whole numbers are pixels; the + * value may have a fraction for input devices that are sub-pixel precise. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_X + */ + public final float getX(int pointerIndex) { + return coord_x; + } - /** - * Returns the Y coordinate of this event for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * Whole numbers are pixels; the - * value may have a fraction for input devices that are sub-pixel precise. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_Y - */ - public final float getY(int pointerIndex) { - return coord_y; - } + /** + * Returns the Y coordinate of this event for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * Whole numbers are pixels; the + * value may have a fraction for input devices that are sub-pixel precise. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_Y + */ + public final float getY(int pointerIndex) { + return coord_y; + } - /** - * Returns the current pressure of this event for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * The pressure generally - * ranges from 0 (no pressure at all) to 1 (normal pressure), however - * values higher than 1 may be generated depending on the calibration of - * the input device. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_PRESSURE - */ - public final float getPressure(int pointerIndex) { -// return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, pointerIndex, HISTORY_CURRENT); + /** + * Returns the current pressure of this event for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * The pressure generally + * ranges from 0 (no pressure at all) to 1 (normal pressure), however + * values higher than 1 may be generated depending on the calibration of + * the input device. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_PRESSURE + */ + public final float getPressure(int pointerIndex) { +// return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, pointerIndex, HISTORY_CURRENT); return 0; - } - - /** - * Returns a scaled value of the approximate size for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * This represents some approximation of the area of the screen being - * pressed; the actual value in pixels corresponding to the - * touch is normalized with the device specific range of values - * and scaled to a value between 0 and 1. The value of size can be used to - * determine fat touch events. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_SIZE - */ - public final float getSize(int pointerIndex) { - return nativeGetAxisValue(mNativePtr, AXIS_SIZE, pointerIndex, HISTORY_CURRENT); - } - - /** - * Returns the length of the major axis of an ellipse that describes the touch - * area at the point of contact for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_TOUCH_MAJOR - */ - public final float getTouchMajor(int pointerIndex) { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, pointerIndex, HISTORY_CURRENT); - } - - /** - * Returns the length of the minor axis of an ellipse that describes the touch - * area at the point of contact for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_TOUCH_MINOR - */ - public final float getTouchMinor(int pointerIndex) { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, pointerIndex, HISTORY_CURRENT); - } - - /** - * Returns the length of the major axis of an ellipse that describes the size of - * the approaching tool for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * The tool area represents the estimated size of the finger or pen that is - * touching the device independent of its actual touch area at the point of contact. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_TOOL_MAJOR - */ - public final float getToolMajor(int pointerIndex) { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, pointerIndex, HISTORY_CURRENT); - } - - /** - * Returns the length of the minor axis of an ellipse that describes the size of - * the approaching tool for the given pointer - * index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * The tool area represents the estimated size of the finger or pen that is - * touching the device independent of its actual touch area at the point of contact. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_TOOL_MINOR - */ - public final float getToolMinor(int pointerIndex) { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, pointerIndex, HISTORY_CURRENT); - } - - /** - * Returns the orientation of the touch area and tool area in radians clockwise from vertical - * for the given pointer index (use {@link #getPointerId(int)} to find the pointer - * identifier for this index). - * An angle of 0 radians indicates that the major axis of contact is oriented - * upwards, is perfectly circular or is of unknown orientation. A positive angle - * indicates that the major axis of contact is oriented to the right. A negative angle - * indicates that the major axis of contact is oriented to the left. - * The full range is from -PI/2 radians (finger pointing fully left) to PI/2 radians - * (finger pointing fully right). - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * - * @see #AXIS_ORIENTATION - */ - public final float getOrientation(int pointerIndex) { - return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, pointerIndex, HISTORY_CURRENT); - } - - /** - * Returns the value of the requested axis for the given pointer index - * (use {@link #getPointerId(int)} to find the pointer identifier for this index). - * - * @param axis The axis identifier for the axis value to retrieve. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @return The value of the axis, or 0 if the axis is not available. - * - * @see #AXIS_X - * @see #AXIS_Y - */ - public final float getAxisValue(int axis, int pointerIndex) { - return nativeGetAxisValue(mNativePtr, axis, pointerIndex, HISTORY_CURRENT); - } - - /** - * Populates a {@link PointerCoords} object with pointer coordinate data for - * the specified pointer index. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param outPointerCoords The pointer coordinate object to populate. - * - * @see PointerCoords - */ - public final void getPointerCoords(int pointerIndex, PointerCoords outPointerCoords) { - nativeGetPointerCoords(mNativePtr, pointerIndex, HISTORY_CURRENT, outPointerCoords); - } - - /** - * Populates a {@link PointerProperties} object with pointer properties for - * the specified pointer index. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param outPointerProperties The pointer properties object to populate. - * - * @see PointerProperties - */ - public final void getPointerProperties(int pointerIndex, - PointerProperties outPointerProperties) { - nativeGetPointerProperties(mNativePtr, pointerIndex, outPointerProperties); - } - - /** - * Returns the state of any meta / modifier keys that were in effect when - * the event was generated. This is the same values as those - * returned by {@link KeyEvent#getMetaState() KeyEvent.getMetaState}. - * - * @return an integer in which each bit set to 1 represents a pressed - * meta key - * - * @see KeyEvent#getMetaState() - */ - public final int getMetaState() { - return nativeGetMetaState(mNativePtr); - } - - /** - * Gets the state of all buttons that are pressed such as a mouse or stylus button. - * - * @return The button state. - * - * @see #BUTTON_PRIMARY - * @see #BUTTON_SECONDARY - * @see #BUTTON_TERTIARY - * @see #BUTTON_FORWARD - * @see #BUTTON_BACK - */ - public final int getButtonState() { - return nativeGetButtonState(mNativePtr); - } - - /** - * Returns the original raw X coordinate of this event. For touch - * events on the screen, this is the original location of the event - * on the screen, before it had been adjusted for the containing window - * and views. - * - * @see #getX(int) - * @see #AXIS_X - */ - public final float getRawX() { - return coord_x; - } - - /** - * Returns the original raw Y coordinate of this event. For touch - * events on the screen, this is the original location of the event - * on the screen, before it had been adjusted for the containing window - * and views. - * - * @see #getY(int) - * @see #AXIS_Y - */ - public final float getRawY() { - return coord_y; - } - - /** - * Return the precision of the X coordinates being reported. You can - * multiply this number with {@link #getX} to find the actual hardware - * value of the X coordinate. - * @return Returns the precision of X coordinates being reported. - * - * @see #AXIS_X - */ - public final float getXPrecision() { - return nativeGetXPrecision(mNativePtr); - } - - /** - * Return the precision of the Y coordinates being reported. You can - * multiply this number with {@link #getY} to find the actual hardware - * value of the Y coordinate. - * @return Returns the precision of Y coordinates being reported. - * - * @see #AXIS_Y - */ - public final float getYPrecision() { - return nativeGetYPrecision(mNativePtr); - } - - /** - * Returns the number of historical points in this event. These are - * movements that have occurred between this event and the previous event. - * This only applies to ACTION_MOVE events -- all other actions will have - * a size of 0. - * - * @return Returns the number of historical points in the event. - */ - public final int getHistorySize() { - return nativeGetHistorySize(mNativePtr); - } - - /** - * Returns the time that a historical movement occurred between this event - * and the previous event, in the {@link android.os.SystemClock#uptimeMillis} time base. - *- * This only applies to ACTION_MOVE events. - *
- * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * @return Returns the time that a historical movement occurred between this - * event and the previous event, - * in the {@link android.os.SystemClock#uptimeMillis} time base. - * - * @see #getHistorySize - * @see #getEventTime - */ - public final long getHistoricalEventTime(int pos) { - return nativeGetEventTimeNanos(mNativePtr, pos) / NS_PER_MS; - } - - /** - * Returns the time that a historical movement occurred between this event - * and the previous event, in the {@link android.os.SystemClock#uptimeMillis} time base - * but with nanosecond (instead of millisecond) precision. - *- * This only applies to ACTION_MOVE events. - *
- * The value is in nanosecond precision but it may not have nanosecond accuracy. - *
- * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * @return Returns the time that a historical movement occurred between this - * event and the previous event, - * in the {@link android.os.SystemClock#uptimeMillis} time base but with - * nanosecond (instead of millisecond) precision. - * - * @see #getHistorySize - * @see #getEventTime - * - * @hide - */ - public final long getHistoricalEventTimeNano(int pos) { - return nativeGetEventTimeNanos(mNativePtr, pos); - } - - /** - * {@link #getHistoricalX(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getX() - * @see #AXIS_X - */ - public final float getHistoricalX(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_X, 0, pos); - } - - /** - * {@link #getHistoricalY(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getY() - * @see #AXIS_Y - */ - public final float getHistoricalY(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_Y, 0, pos); - } - - /** - * {@link #getHistoricalPressure(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getPressure() - * @see #AXIS_PRESSURE - */ - public final float getHistoricalPressure(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, 0, pos); - } - - /** - * {@link #getHistoricalSize(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getSize() - * @see #AXIS_SIZE - */ - public final float getHistoricalSize(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_SIZE, 0, pos); - } - - /** - * {@link #getHistoricalTouchMajor(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getTouchMajor() - * @see #AXIS_TOUCH_MAJOR - */ - public final float getHistoricalTouchMajor(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, 0, pos); - } - - /** - * {@link #getHistoricalTouchMinor(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getTouchMinor() - * @see #AXIS_TOUCH_MINOR - */ - public final float getHistoricalTouchMinor(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, 0, pos); - } - - /** - * {@link #getHistoricalToolMajor(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getToolMajor() - * @see #AXIS_TOOL_MAJOR - */ - public final float getHistoricalToolMajor(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, 0, pos); - } - - /** - * {@link #getHistoricalToolMinor(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getToolMinor() - * @see #AXIS_TOOL_MINOR - */ - public final float getHistoricalToolMinor(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, 0, pos); - } - - /** - * {@link #getHistoricalOrientation(int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getOrientation() - * @see #AXIS_ORIENTATION - */ - public final float getHistoricalOrientation(int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, 0, pos); - } - - /** - * {@link #getHistoricalAxisValue(int, int, int)} for the first pointer index (may be an - * arbitrary pointer identifier). - * - * @param axis The axis identifier for the axis value to retrieve. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getAxisValue(int) - * @see #AXIS_X - * @see #AXIS_Y - */ - public final float getHistoricalAxisValue(int axis, int pos) { - return nativeGetAxisValue(mNativePtr, axis, 0, pos); - } - - /** - * Returns a historical X coordinate, as per {@link #getX(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getX(int) - * @see #AXIS_X - */ - public final float getHistoricalX(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_X, pointerIndex, pos); - } - - /** - * Returns a historical Y coordinate, as per {@link #getY(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getY(int) - * @see #AXIS_Y - */ - public final float getHistoricalY(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_Y, pointerIndex, pos); - } - - /** - * Returns a historical pressure coordinate, as per {@link #getPressure(int)}, - * that occurred between this event and the previous event for the given - * pointer. Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getPressure(int) - * @see #AXIS_PRESSURE - */ - public final float getHistoricalPressure(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, pointerIndex, pos); - } - - /** - * Returns a historical size coordinate, as per {@link #getSize(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getSize(int) - * @see #AXIS_SIZE - */ - public final float getHistoricalSize(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_SIZE, pointerIndex, pos); - } - - /** - * Returns a historical touch major axis coordinate, as per {@link #getTouchMajor(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getTouchMajor(int) - * @see #AXIS_TOUCH_MAJOR - */ - public final float getHistoricalTouchMajor(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, pointerIndex, pos); - } - - /** - * Returns a historical touch minor axis coordinate, as per {@link #getTouchMinor(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getTouchMinor(int) - * @see #AXIS_TOUCH_MINOR - */ - public final float getHistoricalTouchMinor(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, pointerIndex, pos); - } - - /** - * Returns a historical tool major axis coordinate, as per {@link #getToolMajor(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getToolMajor(int) - * @see #AXIS_TOOL_MAJOR - */ - public final float getHistoricalToolMajor(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, pointerIndex, pos); - } - - /** - * Returns a historical tool minor axis coordinate, as per {@link #getToolMinor(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getToolMinor(int) - * @see #AXIS_TOOL_MINOR - */ - public final float getHistoricalToolMinor(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, pointerIndex, pos); - } - - /** - * Returns a historical orientation coordinate, as per {@link #getOrientation(int)}, that - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * - * @see #getHistorySize - * @see #getOrientation(int) - * @see #AXIS_ORIENTATION - */ - public final float getHistoricalOrientation(int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, pointerIndex, pos); - } - - /** - * Returns the historical value of the requested axis, as per {@link #getAxisValue(int, int)}, - * occurred between this event and the previous event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param axis The axis identifier for the axis value to retrieve. - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * @return The value of the axis, or 0 if the axis is not available. - * - * @see #AXIS_X - * @see #AXIS_Y - */ - public final float getHistoricalAxisValue(int axis, int pointerIndex, int pos) { - return nativeGetAxisValue(mNativePtr, axis, pointerIndex, pos); - } - - /** - * Populates a {@link PointerCoords} object with historical pointer coordinate data, - * as per {@link #getPointerCoords}, that occurred between this event and the previous - * event for the given pointer. - * Only applies to ACTION_MOVE events. - * - * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 - * (the first pointer that is down) to {@link #getPointerCount()}-1. - * @param pos Which historical value to return; must be less than - * {@link #getHistorySize} - * @param outPointerCoords The pointer coordinate object to populate. - * - * @see #getHistorySize - * @see #getPointerCoords - * @see PointerCoords - */ - public final void getHistoricalPointerCoords(int pointerIndex, int pos, - PointerCoords outPointerCoords) { - nativeGetPointerCoords(mNativePtr, pointerIndex, pos, outPointerCoords); - } - - /** - * Returns a bitfield indicating which edges, if any, were touched by this - * MotionEvent. For touch events, clients can use this to determine if the - * user's finger was touching the edge of the display. - * - * This property is only set for {@link #ACTION_DOWN} events. - * - * @see #EDGE_LEFT - * @see #EDGE_TOP - * @see #EDGE_RIGHT - * @see #EDGE_BOTTOM - */ - public final int getEdgeFlags() { - return nativeGetEdgeFlags(mNativePtr); - } - - /** - * Sets the bitfield indicating which edges, if any, were touched by this - * MotionEvent. - * - * @see #getEdgeFlags() - */ - public final void setEdgeFlags(int flags) { - nativeSetEdgeFlags(mNativePtr, flags); - } - - /** - * Sets this event's action. - */ - public final void setAction(int action) { - nativeSetAction(mNativePtr, action); - } - - /** - * Adjust this event's location. - * @param deltaX Amount to add to the current X coordinate of the event. - * @param deltaY Amount to add to the current Y coordinate of the event. - */ - public final void offsetLocation(float deltaX, float deltaY) { - if (deltaX != 0.0f || deltaY != 0.0f) { - nativeOffsetLocation(mNativePtr, deltaX, deltaY); - } - } - - /** - * Set this event's location. Applies {@link #offsetLocation} with a - * delta from the current location to the given new location. - * - * @param x New absolute X location. - * @param y New absolute Y location. - */ - public final void setLocation(float x, float y) { - float oldX = getX(); - float oldY = getY(); - offsetLocation(x - oldX, y - oldY); - } - - /** - * Applies a transformation matrix to all of the points in the event. - * - * @param matrix The transformation matrix to apply. - */ - public final void transform(Matrix matrix) { - if (matrix == null) { - throw new IllegalArgumentException("matrix must not be null"); - } - - nativeTransform(mNativePtr, matrix); - } - - /** - * Add a new movement to the batch of movements in this event. The event's - * current location, position and size is updated to the new values. - * The current values in the event are added to a list of historical values. - * - * Only applies to {@link #ACTION_MOVE} or {@link #ACTION_HOVER_MOVE} events. - * - * @param eventTime The time stamp (in ms) for this data. - * @param x The new X position. - * @param y The new Y position. - * @param pressure The new pressure. - * @param size The new size. - * @param metaState Meta key state. - */ - public final void addBatch(long eventTime, float x, float y, - float pressure, float size, int metaState) { - synchronized (gSharedTempLock) { - ensureSharedTempPointerCapacity(1); - final PointerCoords[] pc = gSharedTempPointerCoords; - pc[0].clear(); - pc[0].x = x; - pc[0].y = y; - pc[0].pressure = pressure; - pc[0].size = size; - - nativeAddBatch(mNativePtr, eventTime * NS_PER_MS, pc, metaState); - } - } - - /** - * Add a new movement to the batch of movements in this event. The event's - * current location, position and size is updated to the new values. - * The current values in the event are added to a list of historical values. - * - * Only applies to {@link #ACTION_MOVE} or {@link #ACTION_HOVER_MOVE} events. - * - * @param eventTime The time stamp (in ms) for this data. - * @param pointerCoords The new pointer coordinates. - * @param metaState Meta key state. - */ - public final void addBatch(long eventTime, PointerCoords[] pointerCoords, int metaState) { - nativeAddBatch(mNativePtr, eventTime * NS_PER_MS, pointerCoords, metaState); - } - - /** - * Adds all of the movement samples of the specified event to this one if - * it is compatible. To be compatible, the event must have the same device id, - * source, action, flags, pointer count, pointer properties. - * - * Only applies to {@link #ACTION_MOVE} or {@link #ACTION_HOVER_MOVE} events. - * - * @param event The event whose movements samples should be added to this one - * if possible. - * @return True if batching was performed or false if batching was not possible. - * @hide - */ - public final boolean addBatch(MotionEvent event) { - final int action = nativeGetAction(mNativePtr); - if (action != ACTION_MOVE && action != ACTION_HOVER_MOVE) { - return false; - } - if (action != nativeGetAction(event.mNativePtr)) { - return false; - } - - if (nativeGetDeviceId(mNativePtr) != nativeGetDeviceId(event.mNativePtr) - || nativeGetSource(mNativePtr) != nativeGetSource(event.mNativePtr) - || nativeGetFlags(mNativePtr) != nativeGetFlags(event.mNativePtr)) { - return false; - } - - final int pointerCount = nativeGetPointerCount(mNativePtr); - if (pointerCount != nativeGetPointerCount(event.mNativePtr)) { - return false; - } - - synchronized (gSharedTempLock) { - ensureSharedTempPointerCapacity(Math.max(pointerCount, 2)); - final PointerProperties[] pp = gSharedTempPointerProperties; - final PointerCoords[] pc = gSharedTempPointerCoords; - - for (int i = 0; i < pointerCount; i++) { - nativeGetPointerProperties(mNativePtr, i, pp[0]); - nativeGetPointerProperties(event.mNativePtr, i, pp[1]); - if (!pp[0].equals(pp[1])) { - return false; - } - } - - final int metaState = nativeGetMetaState(event.mNativePtr); - final int historySize = nativeGetHistorySize(event.mNativePtr); - for (int h = 0; h <= historySize; h++) { - final int historyPos = (h == historySize ? HISTORY_CURRENT : h); - - for (int i = 0; i < pointerCount; i++) { - nativeGetPointerCoords(event.mNativePtr, i, historyPos, pc[i]); - } - - final long eventTimeNanos = nativeGetEventTimeNanos(event.mNativePtr, historyPos); - nativeAddBatch(mNativePtr, eventTimeNanos, pc, metaState); - } - } - return true; - } - - /** - * Returns true if all points in the motion event are completely within the specified bounds. - * @hide - */ - public final boolean isWithinBoundsNoHistory(float left, float top, - float right, float bottom) { - final int pointerCount = nativeGetPointerCount(mNativePtr); - for (int i = 0; i < pointerCount; i++) { - final float x = nativeGetAxisValue(mNativePtr, AXIS_X, i, HISTORY_CURRENT); - final float y = nativeGetAxisValue(mNativePtr, AXIS_Y, i, HISTORY_CURRENT); - if (x < left || x > right || y < top || y > bottom) { - return false; - } - } - return true; - } - - private static final float clamp(float value, float low, float high) { - if (value < low) { - return low; - } else if (value > high) { - return high; - } - return value; - } - - /** - * Returns a new motion events whose points have been clamped to the specified bounds. - * @hide - */ - public final MotionEvent clampNoHistory(float left, float top, float right, float bottom) { - MotionEvent ev = obtain(); - synchronized (gSharedTempLock) { - final int pointerCount = nativeGetPointerCount(mNativePtr); - - ensureSharedTempPointerCapacity(pointerCount); - final PointerProperties[] pp = gSharedTempPointerProperties; - final PointerCoords[] pc = gSharedTempPointerCoords; - - for (int i = 0; i < pointerCount; i++) { - nativeGetPointerProperties(mNativePtr, i, pp[i]); - nativeGetPointerCoords(mNativePtr, i, HISTORY_CURRENT, pc[i]); - pc[i].x = clamp(pc[i].x, left, right); - pc[i].y = clamp(pc[i].y, top, bottom); - } - ev.mNativePtr = nativeInitialize(ev.mNativePtr, - nativeGetDeviceId(mNativePtr), nativeGetSource(mNativePtr), - nativeGetAction(mNativePtr), nativeGetFlags(mNativePtr), - nativeGetEdgeFlags(mNativePtr), nativeGetMetaState(mNativePtr), - nativeGetButtonState(mNativePtr), - nativeGetXOffset(mNativePtr), nativeGetYOffset(mNativePtr), - nativeGetXPrecision(mNativePtr), nativeGetYPrecision(mNativePtr), - nativeGetDownTimeNanos(mNativePtr), - nativeGetEventTimeNanos(mNativePtr, HISTORY_CURRENT), - pointerCount, pp, pc); - return ev; - } - } - - /** - * Gets an integer where each pointer id present in the event is marked as a bit. - * @hide - */ - public final int getPointerIdBits() { - int idBits = 0; - final int pointerCount = nativeGetPointerCount(mNativePtr); - for (int i = 0; i < pointerCount; i++) { - idBits |= 1 << nativeGetPointerId(mNativePtr, i); - } - return idBits; - } - - /** - * Splits a motion event such that it includes only a subset of pointer ids. - * @hide - */ - public final MotionEvent split(int idBits) { - MotionEvent ev = obtain(); - synchronized (gSharedTempLock) { - final int oldPointerCount = nativeGetPointerCount(mNativePtr); - ensureSharedTempPointerCapacity(oldPointerCount); - final PointerProperties[] pp = gSharedTempPointerProperties; - final PointerCoords[] pc = gSharedTempPointerCoords; - final int[] map = gSharedTempPointerIndexMap; - - final int oldAction = nativeGetAction(mNativePtr); - final int oldActionMasked = oldAction & ACTION_MASK; - final int oldActionPointerIndex = (oldAction & ACTION_POINTER_INDEX_MASK) - >> ACTION_POINTER_INDEX_SHIFT; - int newActionPointerIndex = -1; - int newPointerCount = 0; - int newIdBits = 0; - for (int i = 0; i < oldPointerCount; i++) { - nativeGetPointerProperties(mNativePtr, i, pp[newPointerCount]); - final int idBit = 1 << pp[newPointerCount].id; - if ((idBit & idBits) != 0) { - if (i == oldActionPointerIndex) { - newActionPointerIndex = newPointerCount; - } - map[newPointerCount] = i; - newPointerCount += 1; - newIdBits |= idBit; - } - } - - if (newPointerCount == 0) { - throw new IllegalArgumentException("idBits did not match any ids in the event"); - } - - final int newAction; - if (oldActionMasked == ACTION_POINTER_DOWN || oldActionMasked == ACTION_POINTER_UP) { - if (newActionPointerIndex < 0) { - // An unrelated pointer changed. - newAction = ACTION_MOVE; - } else if (newPointerCount == 1) { - // The first/last pointer went down/up. - newAction = oldActionMasked == ACTION_POINTER_DOWN - ? ACTION_DOWN : ACTION_UP; - } else { - // A secondary pointer went down/up. - newAction = oldActionMasked - | (newActionPointerIndex << ACTION_POINTER_INDEX_SHIFT); - } - } else { - // Simple up/down/cancel/move or other motion action. - newAction = oldAction; - } - - final int historySize = nativeGetHistorySize(mNativePtr); - for (int h = 0; h <= historySize; h++) { - final int historyPos = h == historySize ? HISTORY_CURRENT : h; - - for (int i = 0; i < newPointerCount; i++) { - nativeGetPointerCoords(mNativePtr, map[i], historyPos, pc[i]); - } - - final long eventTimeNanos = nativeGetEventTimeNanos(mNativePtr, historyPos); - if (h == 0) { - ev.mNativePtr = nativeInitialize(ev.mNativePtr, - nativeGetDeviceId(mNativePtr), nativeGetSource(mNativePtr), - newAction, nativeGetFlags(mNativePtr), - nativeGetEdgeFlags(mNativePtr), nativeGetMetaState(mNativePtr), - nativeGetButtonState(mNativePtr), - nativeGetXOffset(mNativePtr), nativeGetYOffset(mNativePtr), - nativeGetXPrecision(mNativePtr), nativeGetYPrecision(mNativePtr), - nativeGetDownTimeNanos(mNativePtr), eventTimeNanos, - newPointerCount, pp, pc); - } else { - nativeAddBatch(ev.mNativePtr, eventTimeNanos, pc, 0); - } - } - return ev; - } - } - - @Override - public String toString() { - StringBuilder msg = new StringBuilder(); - msg.append("MotionEvent { action=").append(actionToString(getAction())); - - final int pointerCount = getPointerCount(); - for (int i = 0; i < pointerCount; i++) { - msg.append(", id[").append(i).append("]=").append(getPointerId(i)); - msg.append(", x[").append(i).append("]=").append(getX(i)); - msg.append(", y[").append(i).append("]=").append(getY(i)); - msg.append(", toolType[").append(i).append("]=").append( - toolTypeToString(getToolType(i))); - } - - msg.append(", buttonState=").append(MotionEvent.buttonStateToString(getButtonState())); - msg.append(", metaState=").append(/*KeyEvent.metaStateToString(getMetaState())*/"FIXME"); - msg.append(", flags=0x").append(Integer.toHexString(getFlags())); - msg.append(", edgeFlags=0x").append(Integer.toHexString(getEdgeFlags())); - msg.append(", pointerCount=").append(pointerCount); - msg.append(", historySize=").append(getHistorySize()); - msg.append(", eventTime=").append(getEventTime()); - msg.append(", downTime=").append(getDownTime()); - msg.append(", deviceId=").append(getDeviceId()); - msg.append(", source=0x").append(Integer.toHexString(getSource())); - msg.append(" }"); - return msg.toString(); - } - - /** - * Returns a string that represents the symbolic name of the specified unmasked action - * such as "ACTION_DOWN", "ACTION_POINTER_DOWN(3)" or an equivalent numeric constant - * such as "35" if unknown. - * - * @param action The unmasked action. - * @return The symbolic name of the specified action. - * @see #getAction() - */ - public static String actionToString(int action) { - switch (action) { - case ACTION_DOWN: - return "ACTION_DOWN"; - case ACTION_UP: - return "ACTION_UP"; - case ACTION_CANCEL: - return "ACTION_CANCEL"; - case ACTION_OUTSIDE: - return "ACTION_OUTSIDE"; - case ACTION_MOVE: - return "ACTION_MOVE"; - case ACTION_HOVER_MOVE: - return "ACTION_HOVER_MOVE"; - case ACTION_SCROLL: - return "ACTION_SCROLL"; - case ACTION_HOVER_ENTER: - return "ACTION_HOVER_ENTER"; - case ACTION_HOVER_EXIT: - return "ACTION_HOVER_EXIT"; - } - int index = (action & ACTION_POINTER_INDEX_MASK) >> ACTION_POINTER_INDEX_SHIFT; - switch (action & ACTION_MASK) { - case ACTION_POINTER_DOWN: - return "ACTION_POINTER_DOWN(" + index + ")"; - case ACTION_POINTER_UP: - return "ACTION_POINTER_UP(" + index + ")"; - default: - return Integer.toString(action); - } - } - - /** - * Returns a string that represents the symbolic name of the specified axis - * such as "AXIS_X" or an equivalent numeric constant such as "42" if unknown. - * - * @param axis The axis. - * @return The symbolic name of the specified axis. - */ - public static String axisToString(int axis) { - String symbolicName = AXIS_SYMBOLIC_NAMES.get(axis); - return symbolicName != null ? symbolicName : Integer.toString(axis); - } - - /** - * Gets an axis by its symbolic name such as "AXIS_X" or an - * equivalent numeric constant such as "42". - * - * @param symbolicName The symbolic name of the axis. - * @return The axis or -1 if not found. - * @see KeyEvent#keyCodeToString(int) - */ - public static int axisFromString(String symbolicName) { - if (symbolicName == null) { - throw new IllegalArgumentException("symbolicName must not be null"); - } - - final int count = AXIS_SYMBOLIC_NAMES.size(); - for (int i = 0; i < count; i++) { - if (symbolicName.equals(AXIS_SYMBOLIC_NAMES.valueAt(i))) { - return i; - } - } - - try { - return Integer.parseInt(symbolicName, 10); - } catch (NumberFormatException ex) { - return -1; - } - } - - /** - * Returns a string that represents the symbolic name of the specified combined - * button state flags such as "0", "BUTTON_PRIMARY", - * "BUTTON_PRIMARY|BUTTON_SECONDARY" or an equivalent numeric constant such as "0x10000000" - * if unknown. - * - * @param buttonState The button state. - * @return The symbolic name of the specified combined button state flags. - * @hide - */ - public static String buttonStateToString(int buttonState) { - if (buttonState == 0) { - return "0"; - } - StringBuilder result = null; - int i = 0; - while (buttonState != 0) { - final boolean isSet = (buttonState & 1) != 0; - buttonState >>>= 1; // unsigned shift! - if (isSet) { - final String name = BUTTON_SYMBOLIC_NAMES[i]; - if (result == null) { - if (buttonState == 0) { - return name; - } - result = new StringBuilder(name); - } else { - result.append('|'); - result.append(name); - } - } - i += 1; - } - return result.toString(); - } - - /** - * Returns a string that represents the symbolic name of the specified tool type - * such as "TOOL_TYPE_FINGER" or an equivalent numeric constant such as "42" if unknown. - * - * @param toolType The tool type. - * @return The symbolic name of the specified tool type. - * @hide - */ - public static String toolTypeToString(int toolType) { - String symbolicName = TOOL_TYPE_SYMBOLIC_NAMES.get(toolType); - return symbolicName != null ? symbolicName : Integer.toString(toolType); - } - - /** - * Transfer object for pointer coordinates. - * - * Objects of this type can be used to specify the pointer coordinates when - * creating new {@link MotionEvent} objects and to query pointer coordinates - * in bulk. - * - * Refer to {@link InputDevice} for information about how different kinds of - * input devices and sources represent pointer coordinates. - */ - public static final class PointerCoords { - private static final int INITIAL_PACKED_AXIS_VALUES = 8; - private long mPackedAxisBits; - private float[] mPackedAxisValues; - - /** - * Creates a pointer coords object with all axes initialized to zero. - */ - public PointerCoords() { - } - - /** - * Creates a pointer coords object as a copy of the - * contents of another pointer coords object. - * - * @param other The pointer coords object to copy. - */ - public PointerCoords(PointerCoords other) { - copyFrom(other); - } - - /** @hide */ - public static PointerCoords[] createArray(int size) { - PointerCoords[] array = new PointerCoords[size]; - for (int i = 0; i < size; i++) { - array[i] = new PointerCoords(); - } - return array; - } - - /** - * The X component of the pointer movement. - * - * @see MotionEvent#AXIS_X - */ - public float x; - - /** - * The Y component of the pointer movement. - * - * @see MotionEvent#AXIS_Y - */ - public float y; - - /** - * A normalized value that describes the pressure applied to the device - * by a finger or other tool. - * The pressure generally ranges from 0 (no pressure at all) to 1 (normal pressure), - * although values higher than 1 may be generated depending on the calibration of - * the input device. - * - * @see MotionEvent#AXIS_PRESSURE - */ - public float pressure; - - /** - * A normalized value that describes the approximate size of the pointer touch area - * in relation to the maximum detectable size of the device. - * It represents some approximation of the area of the screen being - * pressed; the actual value in pixels corresponding to the - * touch is normalized with the device specific range of values - * and scaled to a value between 0 and 1. The value of size can be used to - * determine fat touch events. - * - * @see MotionEvent#AXIS_SIZE - */ - public float size; - - /** - * The length of the major axis of an ellipse that describes the touch area at - * the point of contact. - * If the device is a touch screen, the length is reported in pixels, otherwise it is - * reported in device-specific units. - * - * @see MotionEvent#AXIS_TOUCH_MAJOR - */ - public float touchMajor; - - /** - * The length of the minor axis of an ellipse that describes the touch area at - * the point of contact. - * If the device is a touch screen, the length is reported in pixels, otherwise it is - * reported in device-specific units. - * - * @see MotionEvent#AXIS_TOUCH_MINOR - */ - public float touchMinor; - - /** - * The length of the major axis of an ellipse that describes the size of - * the approaching tool. - * The tool area represents the estimated size of the finger or pen that is - * touching the device independent of its actual touch area at the point of contact. - * If the device is a touch screen, the length is reported in pixels, otherwise it is - * reported in device-specific units. - * - * @see MotionEvent#AXIS_TOOL_MAJOR - */ - public float toolMajor; - - /** - * The length of the minor axis of an ellipse that describes the size of - * the approaching tool. - * The tool area represents the estimated size of the finger or pen that is - * touching the device independent of its actual touch area at the point of contact. - * If the device is a touch screen, the length is reported in pixels, otherwise it is - * reported in device-specific units. - * - * @see MotionEvent#AXIS_TOOL_MINOR - */ - public float toolMinor; - - /** - * The orientation of the touch area and tool area in radians clockwise from vertical. - * An angle of 0 radians indicates that the major axis of contact is oriented - * upwards, is perfectly circular or is of unknown orientation. A positive angle - * indicates that the major axis of contact is oriented to the right. A negative angle - * indicates that the major axis of contact is oriented to the left. - * The full range is from -PI/2 radians (finger pointing fully left) to PI/2 radians - * (finger pointing fully right). - * - * @see MotionEvent#AXIS_ORIENTATION - */ - public float orientation; - - /** - * Clears the contents of this object. - * Resets all axes to zero. - */ - public void clear() { - mPackedAxisBits = 0; - - x = 0; - y = 0; - pressure = 0; - size = 0; - touchMajor = 0; - touchMinor = 0; - toolMajor = 0; - toolMinor = 0; - orientation = 0; - } - - /** - * Copies the contents of another pointer coords object. - * - * @param other The pointer coords object to copy. - */ - public void copyFrom(PointerCoords other) { - final long bits = other.mPackedAxisBits; - mPackedAxisBits = bits; - if (bits != 0) { - final float[] otherValues = other.mPackedAxisValues; - final int count = Long.bitCount(bits); - float[] values = mPackedAxisValues; - if (values == null || count > values.length) { - values = new float[otherValues.length]; - mPackedAxisValues = values; - } - System.arraycopy(otherValues, 0, values, 0, count); - } - - x = other.x; - y = other.y; - pressure = other.pressure; - size = other.size; - touchMajor = other.touchMajor; - touchMinor = other.touchMinor; - toolMajor = other.toolMajor; - toolMinor = other.toolMinor; - orientation = other.orientation; - } - - /** - * Gets the value associated with the specified axis. - * - * @param axis The axis identifier for the axis value to retrieve. - * @return The value associated with the axis, or 0 if none. - * - * @see MotionEvent#AXIS_X - * @see MotionEvent#AXIS_Y - */ - public float getAxisValue(int axis) { - switch (axis) { - case AXIS_X: - return x; - case AXIS_Y: - return y; - case AXIS_PRESSURE: - return pressure; - case AXIS_SIZE: - return size; - case AXIS_TOUCH_MAJOR: - return touchMajor; - case AXIS_TOUCH_MINOR: - return touchMinor; - case AXIS_TOOL_MAJOR: - return toolMajor; - case AXIS_TOOL_MINOR: - return toolMinor; - case AXIS_ORIENTATION: - return orientation; - default: { - if (axis < 0 || axis > 63) { - throw new IllegalArgumentException("Axis out of range."); - } - final long bits = mPackedAxisBits; - final long axisBit = 1L << axis; - if ((bits & axisBit) == 0) { - return 0; - } - final int index = Long.bitCount(bits & (axisBit - 1L)); - return mPackedAxisValues[index]; - } - } - } - - /** - * Sets the value associated with the specified axis. - * - * @param axis The axis identifier for the axis value to assign. - * @param value The value to set. - * - * @see MotionEvent#AXIS_X - * @see MotionEvent#AXIS_Y - */ - public void setAxisValue(int axis, float value) { - switch (axis) { - case AXIS_X: - x = value; - break; - case AXIS_Y: - y = value; - break; - case AXIS_PRESSURE: - pressure = value; - break; - case AXIS_SIZE: - size = value; - break; - case AXIS_TOUCH_MAJOR: - touchMajor = value; - break; - case AXIS_TOUCH_MINOR: - touchMinor = value; - break; - case AXIS_TOOL_MAJOR: - toolMajor = value; - break; - case AXIS_TOOL_MINOR: - toolMinor = value; - break; - case AXIS_ORIENTATION: - orientation = value; - break; - default: { - if (axis < 0 || axis > 63) { - throw new IllegalArgumentException("Axis out of range."); - } - final long bits = mPackedAxisBits; - final long axisBit = 1L << axis; - final int index = Long.bitCount(bits & (axisBit - 1L)); - float[] values = mPackedAxisValues; - if ((bits & axisBit) == 0) { - if (values == null) { - values = new float[INITIAL_PACKED_AXIS_VALUES]; - mPackedAxisValues = values; - } else { - final int count = Long.bitCount(bits); - if (count < values.length) { - if (index != count) { - System.arraycopy(values, index, values, index + 1, - count - index); - } - } else { - float[] newValues = new float[count * 2]; - System.arraycopy(values, 0, newValues, 0, index); - System.arraycopy(values, index, newValues, index + 1, - count - index); - values = newValues; - mPackedAxisValues = values; - } - } - mPackedAxisBits = bits | axisBit; - } - values[index] = value; - } - } - } - } - - /** - * Transfer object for pointer properties. - * - * Objects of this type can be used to specify the pointer id and tool type - * when creating new {@link MotionEvent} objects and to query pointer properties in bulk. - */ - public static final class PointerProperties { - /** - * Creates a pointer properties object with an invalid pointer id. - */ - public PointerProperties() { - clear(); - } - - /** - * Creates a pointer properties object as a copy of the contents of - * another pointer properties object. - * @param other - */ - public PointerProperties(PointerProperties other) { - copyFrom(other); - } - - /** @hide */ - public static PointerProperties[] createArray(int size) { - PointerProperties[] array = new PointerProperties[size]; - for (int i = 0; i < size; i++) { - array[i] = new PointerProperties(); - } - return array; - } - - /** - * The pointer id. - * Initially set to {@link #INVALID_POINTER_ID} (-1). - * - * @see MotionEvent#getPointerId(int) - */ - public int id; - - /** - * The pointer tool type. - * Initially set to 0. - * - * @see MotionEvent#getToolType(int) - */ - public int toolType; - - /** - * Resets the pointer properties to their initial values. - */ - public void clear() { - id = INVALID_POINTER_ID; - toolType = TOOL_TYPE_UNKNOWN; - } - - /** - * Copies the contents of another pointer properties object. - * - * @param other The pointer properties object to copy. - */ - public void copyFrom(PointerProperties other) { - id = other.id; - toolType = other.toolType; - } - - @Override - public boolean equals(Object other) { - if (other instanceof PointerProperties) { - return equals((PointerProperties)other); - } - return false; - } - - private boolean equals(PointerProperties other) { - return other != null && id == other.id && toolType == other.toolType; - } - - @Override - public int hashCode() { - return id | (toolType << 8); - } - } + } + + /** + * Returns a scaled value of the approximate size for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * This represents some approximation of the area of the screen being + * pressed; the actual value in pixels corresponding to the + * touch is normalized with the device specific range of values + * and scaled to a value between 0 and 1. The value of size can be used to + * determine fat touch events. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_SIZE + */ + public final float getSize(int pointerIndex) { + return nativeGetAxisValue(mNativePtr, AXIS_SIZE, pointerIndex, HISTORY_CURRENT); + } + + /** + * Returns the length of the major axis of an ellipse that describes the touch + * area at the point of contact for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_TOUCH_MAJOR + */ + public final float getTouchMajor(int pointerIndex) { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, pointerIndex, HISTORY_CURRENT); + } + + /** + * Returns the length of the minor axis of an ellipse that describes the touch + * area at the point of contact for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_TOUCH_MINOR + */ + public final float getTouchMinor(int pointerIndex) { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, pointerIndex, HISTORY_CURRENT); + } + + /** + * Returns the length of the major axis of an ellipse that describes the size of + * the approaching tool for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * The tool area represents the estimated size of the finger or pen that is + * touching the device independent of its actual touch area at the point of contact. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_TOOL_MAJOR + */ + public final float getToolMajor(int pointerIndex) { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, pointerIndex, HISTORY_CURRENT); + } + + /** + * Returns the length of the minor axis of an ellipse that describes the size of + * the approaching tool for the given pointer + * index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * The tool area represents the estimated size of the finger or pen that is + * touching the device independent of its actual touch area at the point of contact. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_TOOL_MINOR + */ + public final float getToolMinor(int pointerIndex) { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, pointerIndex, HISTORY_CURRENT); + } + + /** + * Returns the orientation of the touch area and tool area in radians clockwise from vertical + * for the given pointer index (use {@link #getPointerId(int)} to find the pointer + * identifier for this index). + * An angle of 0 radians indicates that the major axis of contact is oriented + * upwards, is perfectly circular or is of unknown orientation. A positive angle + * indicates that the major axis of contact is oriented to the right. A negative angle + * indicates that the major axis of contact is oriented to the left. + * The full range is from -PI/2 radians (finger pointing fully left) to PI/2 radians + * (finger pointing fully right). + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * + * @see #AXIS_ORIENTATION + */ + public final float getOrientation(int pointerIndex) { + return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, pointerIndex, HISTORY_CURRENT); + } + + /** + * Returns the value of the requested axis for the given pointer index + * (use {@link #getPointerId(int)} to find the pointer identifier for this index). + * + * @param axis The axis identifier for the axis value to retrieve. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @return The value of the axis, or 0 if the axis is not available. + * + * @see #AXIS_X + * @see #AXIS_Y + */ + public final float getAxisValue(int axis, int pointerIndex) { + return nativeGetAxisValue(mNativePtr, axis, pointerIndex, HISTORY_CURRENT); + } + + /** + * Populates a {@link PointerCoords} object with pointer coordinate data for + * the specified pointer index. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param outPointerCoords The pointer coordinate object to populate. + * + * @see PointerCoords + */ + public final void getPointerCoords(int pointerIndex, PointerCoords outPointerCoords) { + nativeGetPointerCoords(mNativePtr, pointerIndex, HISTORY_CURRENT, outPointerCoords); + } + + /** + * Populates a {@link PointerProperties} object with pointer properties for + * the specified pointer index. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param outPointerProperties The pointer properties object to populate. + * + * @see PointerProperties + */ + public final void getPointerProperties(int pointerIndex, + PointerProperties outPointerProperties) { + nativeGetPointerProperties(mNativePtr, pointerIndex, outPointerProperties); + } + + /** + * Returns the state of any meta / modifier keys that were in effect when + * the event was generated. This is the same values as those + * returned by {@link KeyEvent#getMetaState() KeyEvent.getMetaState}. + * + * @return an integer in which each bit set to 1 represents a pressed + * meta key + * + * @see KeyEvent#getMetaState() + */ + public final int getMetaState() { + return nativeGetMetaState(mNativePtr); + } + + /** + * Gets the state of all buttons that are pressed such as a mouse or stylus button. + * + * @return The button state. + * + * @see #BUTTON_PRIMARY + * @see #BUTTON_SECONDARY + * @see #BUTTON_TERTIARY + * @see #BUTTON_FORWARD + * @see #BUTTON_BACK + */ + public final int getButtonState() { + return nativeGetButtonState(mNativePtr); + } + + /** + * Returns the original raw X coordinate of this event. For touch + * events on the screen, this is the original location of the event + * on the screen, before it had been adjusted for the containing window + * and views. + * + * @see #getX(int) + * @see #AXIS_X + */ + public final float getRawX() { + return coord_x; + } + + /** + * Returns the original raw Y coordinate of this event. For touch + * events on the screen, this is the original location of the event + * on the screen, before it had been adjusted for the containing window + * and views. + * + * @see #getY(int) + * @see #AXIS_Y + */ + public final float getRawY() { + return coord_y; + } + + /** + * Return the precision of the X coordinates being reported. You can + * multiply this number with {@link #getX} to find the actual hardware + * value of the X coordinate. + * @return Returns the precision of X coordinates being reported. + * + * @see #AXIS_X + */ + public final float getXPrecision() { + return nativeGetXPrecision(mNativePtr); + } + + /** + * Return the precision of the Y coordinates being reported. You can + * multiply this number with {@link #getY} to find the actual hardware + * value of the Y coordinate. + * @return Returns the precision of Y coordinates being reported. + * + * @see #AXIS_Y + */ + public final float getYPrecision() { + return nativeGetYPrecision(mNativePtr); + } + + /** + * Returns the number of historical points in this event. These are + * movements that have occurred between this event and the previous event. + * This only applies to ACTION_MOVE events -- all other actions will have + * a size of 0. + * + * @return Returns the number of historical points in the event. + */ + public final int getHistorySize() { + return nativeGetHistorySize(mNativePtr); + } + + /** + * Returns the time that a historical movement occurred between this event + * and the previous event, in the {@link android.os.SystemClock#uptimeMillis} time base. + *+ * This only applies to ACTION_MOVE events. + *
+ * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * @return Returns the time that a historical movement occurred between this + * event and the previous event, + * in the {@link android.os.SystemClock#uptimeMillis} time base. + * + * @see #getHistorySize + * @see #getEventTime + */ + public final long getHistoricalEventTime(int pos) { + return nativeGetEventTimeNanos(mNativePtr, pos) / NS_PER_MS; + } + + /** + * Returns the time that a historical movement occurred between this event + * and the previous event, in the {@link android.os.SystemClock#uptimeMillis} time base + * but with nanosecond (instead of millisecond) precision. + *+ * This only applies to ACTION_MOVE events. + *
+ * The value is in nanosecond precision but it may not have nanosecond accuracy. + *
+ * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * @return Returns the time that a historical movement occurred between this + * event and the previous event, + * in the {@link android.os.SystemClock#uptimeMillis} time base but with + * nanosecond (instead of millisecond) precision. + * + * @see #getHistorySize + * @see #getEventTime + * + * @hide + */ + public final long getHistoricalEventTimeNano(int pos) { + return nativeGetEventTimeNanos(mNativePtr, pos); + } + + /** + * {@link #getHistoricalX(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getX() + * @see #AXIS_X + */ + public final float getHistoricalX(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_X, 0, pos); + } + + /** + * {@link #getHistoricalY(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getY() + * @see #AXIS_Y + */ + public final float getHistoricalY(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_Y, 0, pos); + } + + /** + * {@link #getHistoricalPressure(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getPressure() + * @see #AXIS_PRESSURE + */ + public final float getHistoricalPressure(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, 0, pos); + } + + /** + * {@link #getHistoricalSize(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getSize() + * @see #AXIS_SIZE + */ + public final float getHistoricalSize(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_SIZE, 0, pos); + } + + /** + * {@link #getHistoricalTouchMajor(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getTouchMajor() + * @see #AXIS_TOUCH_MAJOR + */ + public final float getHistoricalTouchMajor(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, 0, pos); + } + + /** + * {@link #getHistoricalTouchMinor(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getTouchMinor() + * @see #AXIS_TOUCH_MINOR + */ + public final float getHistoricalTouchMinor(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, 0, pos); + } + + /** + * {@link #getHistoricalToolMajor(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getToolMajor() + * @see #AXIS_TOOL_MAJOR + */ + public final float getHistoricalToolMajor(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, 0, pos); + } + + /** + * {@link #getHistoricalToolMinor(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getToolMinor() + * @see #AXIS_TOOL_MINOR + */ + public final float getHistoricalToolMinor(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, 0, pos); + } + + /** + * {@link #getHistoricalOrientation(int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getOrientation() + * @see #AXIS_ORIENTATION + */ + public final float getHistoricalOrientation(int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, 0, pos); + } + + /** + * {@link #getHistoricalAxisValue(int, int, int)} for the first pointer index (may be an + * arbitrary pointer identifier). + * + * @param axis The axis identifier for the axis value to retrieve. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getAxisValue(int) + * @see #AXIS_X + * @see #AXIS_Y + */ + public final float getHistoricalAxisValue(int axis, int pos) { + return nativeGetAxisValue(mNativePtr, axis, 0, pos); + } + + /** + * Returns a historical X coordinate, as per {@link #getX(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getX(int) + * @see #AXIS_X + */ + public final float getHistoricalX(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_X, pointerIndex, pos); + } + + /** + * Returns a historical Y coordinate, as per {@link #getY(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getY(int) + * @see #AXIS_Y + */ + public final float getHistoricalY(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_Y, pointerIndex, pos); + } + + /** + * Returns a historical pressure coordinate, as per {@link #getPressure(int)}, + * that occurred between this event and the previous event for the given + * pointer. Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getPressure(int) + * @see #AXIS_PRESSURE + */ + public final float getHistoricalPressure(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_PRESSURE, pointerIndex, pos); + } + + /** + * Returns a historical size coordinate, as per {@link #getSize(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getSize(int) + * @see #AXIS_SIZE + */ + public final float getHistoricalSize(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_SIZE, pointerIndex, pos); + } + + /** + * Returns a historical touch major axis coordinate, as per {@link #getTouchMajor(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getTouchMajor(int) + * @see #AXIS_TOUCH_MAJOR + */ + public final float getHistoricalTouchMajor(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MAJOR, pointerIndex, pos); + } + + /** + * Returns a historical touch minor axis coordinate, as per {@link #getTouchMinor(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getTouchMinor(int) + * @see #AXIS_TOUCH_MINOR + */ + public final float getHistoricalTouchMinor(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOUCH_MINOR, pointerIndex, pos); + } + + /** + * Returns a historical tool major axis coordinate, as per {@link #getToolMajor(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getToolMajor(int) + * @see #AXIS_TOOL_MAJOR + */ + public final float getHistoricalToolMajor(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MAJOR, pointerIndex, pos); + } + + /** + * Returns a historical tool minor axis coordinate, as per {@link #getToolMinor(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getToolMinor(int) + * @see #AXIS_TOOL_MINOR + */ + public final float getHistoricalToolMinor(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_TOOL_MINOR, pointerIndex, pos); + } + + /** + * Returns a historical orientation coordinate, as per {@link #getOrientation(int)}, that + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * + * @see #getHistorySize + * @see #getOrientation(int) + * @see #AXIS_ORIENTATION + */ + public final float getHistoricalOrientation(int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, AXIS_ORIENTATION, pointerIndex, pos); + } + + /** + * Returns the historical value of the requested axis, as per {@link #getAxisValue(int, int)}, + * occurred between this event and the previous event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param axis The axis identifier for the axis value to retrieve. + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * @return The value of the axis, or 0 if the axis is not available. + * + * @see #AXIS_X + * @see #AXIS_Y + */ + public final float getHistoricalAxisValue(int axis, int pointerIndex, int pos) { + return nativeGetAxisValue(mNativePtr, axis, pointerIndex, pos); + } + + /** + * Populates a {@link PointerCoords} object with historical pointer coordinate data, + * as per {@link #getPointerCoords}, that occurred between this event and the previous + * event for the given pointer. + * Only applies to ACTION_MOVE events. + * + * @param pointerIndex Raw index of pointer to retrieve. Value may be from 0 + * (the first pointer that is down) to {@link #getPointerCount()}-1. + * @param pos Which historical value to return; must be less than + * {@link #getHistorySize} + * @param outPointerCoords The pointer coordinate object to populate. + * + * @see #getHistorySize + * @see #getPointerCoords + * @see PointerCoords + */ + public final void getHistoricalPointerCoords(int pointerIndex, int pos, + PointerCoords outPointerCoords) { + nativeGetPointerCoords(mNativePtr, pointerIndex, pos, outPointerCoords); + } + + /** + * Returns a bitfield indicating which edges, if any, were touched by this + * MotionEvent. For touch events, clients can use this to determine if the + * user's finger was touching the edge of the display. + * + * This property is only set for {@link #ACTION_DOWN} events. + * + * @see #EDGE_LEFT + * @see #EDGE_TOP + * @see #EDGE_RIGHT + * @see #EDGE_BOTTOM + */ + public final int getEdgeFlags() { + return nativeGetEdgeFlags(mNativePtr); + } + + /** + * Sets the bitfield indicating which edges, if any, were touched by this + * MotionEvent. + * + * @see #getEdgeFlags() + */ + public final void setEdgeFlags(int flags) { + nativeSetEdgeFlags(mNativePtr, flags); + } + + /** + * Sets this event's action. + */ + public final void setAction(int action) { + nativeSetAction(mNativePtr, action); + } + + /** + * Adjust this event's location. + * @param deltaX Amount to add to the current X coordinate of the event. + * @param deltaY Amount to add to the current Y coordinate of the event. + */ + public final void offsetLocation(float deltaX, float deltaY) { + if (deltaX != 0.0f || deltaY != 0.0f) { + nativeOffsetLocation(mNativePtr, deltaX, deltaY); + } + } + + /** + * Set this event's location. Applies {@link #offsetLocation} with a + * delta from the current location to the given new location. + * + * @param x New absolute X location. + * @param y New absolute Y location. + */ + public final void setLocation(float x, float y) { + float oldX = getX(); + float oldY = getY(); + offsetLocation(x - oldX, y - oldY); + } + + /** + * Applies a transformation matrix to all of the points in the event. + * + * @param matrix The transformation matrix to apply. + */ + public final void transform(Matrix matrix) { + if (matrix == null) { + throw new IllegalArgumentException("matrix must not be null"); + } + + nativeTransform(mNativePtr, matrix); + } + + /** + * Add a new movement to the batch of movements in this event. The event's + * current location, position and size is updated to the new values. + * The current values in the event are added to a list of historical values. + * + * Only applies to {@link #ACTION_MOVE} or {@link #ACTION_HOVER_MOVE} events. + * + * @param eventTime The time stamp (in ms) for this data. + * @param x The new X position. + * @param y The new Y position. + * @param pressure The new pressure. + * @param size The new size. + * @param metaState Meta key state. + */ + public final void addBatch(long eventTime, float x, float y, + float pressure, float size, int metaState) { + synchronized (gSharedTempLock) { + ensureSharedTempPointerCapacity(1); + final PointerCoords[] pc = gSharedTempPointerCoords; + pc[0].clear(); + pc[0].x = x; + pc[0].y = y; + pc[0].pressure = pressure; + pc[0].size = size; + + nativeAddBatch(mNativePtr, eventTime * NS_PER_MS, pc, metaState); + } + } + + /** + * Add a new movement to the batch of movements in this event. The event's + * current location, position and size is updated to the new values. + * The current values in the event are added to a list of historical values. + * + * Only applies to {@link #ACTION_MOVE} or {@link #ACTION_HOVER_MOVE} events. + * + * @param eventTime The time stamp (in ms) for this data. + * @param pointerCoords The new pointer coordinates. + * @param metaState Meta key state. + */ + public final void addBatch(long eventTime, PointerCoords[] pointerCoords, int metaState) { + nativeAddBatch(mNativePtr, eventTime * NS_PER_MS, pointerCoords, metaState); + } + + /** + * Adds all of the movement samples of the specified event to this one if + * it is compatible. To be compatible, the event must have the same device id, + * source, action, flags, pointer count, pointer properties. + * + * Only applies to {@link #ACTION_MOVE} or {@link #ACTION_HOVER_MOVE} events. + * + * @param event The event whose movements samples should be added to this one + * if possible. + * @return True if batching was performed or false if batching was not possible. + * @hide + */ + public final boolean addBatch(MotionEvent event) { + final int action = nativeGetAction(mNativePtr); + if (action != ACTION_MOVE && action != ACTION_HOVER_MOVE) { + return false; + } + if (action != nativeGetAction(event.mNativePtr)) { + return false; + } + + if (nativeGetDeviceId(mNativePtr) != nativeGetDeviceId(event.mNativePtr) + || nativeGetSource(mNativePtr) != nativeGetSource(event.mNativePtr) + || nativeGetFlags(mNativePtr) != nativeGetFlags(event.mNativePtr)) { + return false; + } + + final int pointerCount = nativeGetPointerCount(mNativePtr); + if (pointerCount != nativeGetPointerCount(event.mNativePtr)) { + return false; + } + + synchronized (gSharedTempLock) { + ensureSharedTempPointerCapacity(Math.max(pointerCount, 2)); + final PointerProperties[] pp = gSharedTempPointerProperties; + final PointerCoords[] pc = gSharedTempPointerCoords; + + for (int i = 0; i < pointerCount; i++) { + nativeGetPointerProperties(mNativePtr, i, pp[0]); + nativeGetPointerProperties(event.mNativePtr, i, pp[1]); + if (!pp[0].equals(pp[1])) { + return false; + } + } + + final int metaState = nativeGetMetaState(event.mNativePtr); + final int historySize = nativeGetHistorySize(event.mNativePtr); + for (int h = 0; h <= historySize; h++) { + final int historyPos = (h == historySize ? HISTORY_CURRENT : h); + + for (int i = 0; i < pointerCount; i++) { + nativeGetPointerCoords(event.mNativePtr, i, historyPos, pc[i]); + } + + final long eventTimeNanos = nativeGetEventTimeNanos(event.mNativePtr, historyPos); + nativeAddBatch(mNativePtr, eventTimeNanos, pc, metaState); + } + } + return true; + } + + /** + * Returns true if all points in the motion event are completely within the specified bounds. + * @hide + */ + public final boolean isWithinBoundsNoHistory(float left, float top, + float right, float bottom) { + final int pointerCount = nativeGetPointerCount(mNativePtr); + for (int i = 0; i < pointerCount; i++) { + final float x = nativeGetAxisValue(mNativePtr, AXIS_X, i, HISTORY_CURRENT); + final float y = nativeGetAxisValue(mNativePtr, AXIS_Y, i, HISTORY_CURRENT); + if (x < left || x > right || y < top || y > bottom) { + return false; + } + } + return true; + } + + private static final float clamp(float value, float low, float high) { + if (value < low) { + return low; + } else if (value > high) { + return high; + } + return value; + } + + /** + * Returns a new motion events whose points have been clamped to the specified bounds. + * @hide + */ + public final MotionEvent clampNoHistory(float left, float top, float right, float bottom) { + MotionEvent ev = obtain(); + synchronized (gSharedTempLock) { + final int pointerCount = nativeGetPointerCount(mNativePtr); + + ensureSharedTempPointerCapacity(pointerCount); + final PointerProperties[] pp = gSharedTempPointerProperties; + final PointerCoords[] pc = gSharedTempPointerCoords; + + for (int i = 0; i < pointerCount; i++) { + nativeGetPointerProperties(mNativePtr, i, pp[i]); + nativeGetPointerCoords(mNativePtr, i, HISTORY_CURRENT, pc[i]); + pc[i].x = clamp(pc[i].x, left, right); + pc[i].y = clamp(pc[i].y, top, bottom); + } + ev.mNativePtr = nativeInitialize(ev.mNativePtr, + nativeGetDeviceId(mNativePtr), nativeGetSource(mNativePtr), + nativeGetAction(mNativePtr), nativeGetFlags(mNativePtr), + nativeGetEdgeFlags(mNativePtr), nativeGetMetaState(mNativePtr), + nativeGetButtonState(mNativePtr), + nativeGetXOffset(mNativePtr), nativeGetYOffset(mNativePtr), + nativeGetXPrecision(mNativePtr), nativeGetYPrecision(mNativePtr), + nativeGetDownTimeNanos(mNativePtr), + nativeGetEventTimeNanos(mNativePtr, HISTORY_CURRENT), + pointerCount, pp, pc); + return ev; + } + } + + /** + * Gets an integer where each pointer id present in the event is marked as a bit. + * @hide + */ + public final int getPointerIdBits() { + int idBits = 0; + final int pointerCount = nativeGetPointerCount(mNativePtr); + for (int i = 0; i < pointerCount; i++) { + idBits |= 1 << nativeGetPointerId(mNativePtr, i); + } + return idBits; + } + + /** + * Splits a motion event such that it includes only a subset of pointer ids. + * @hide + */ + public final MotionEvent split(int idBits) { + MotionEvent ev = obtain(); + synchronized (gSharedTempLock) { + final int oldPointerCount = nativeGetPointerCount(mNativePtr); + ensureSharedTempPointerCapacity(oldPointerCount); + final PointerProperties[] pp = gSharedTempPointerProperties; + final PointerCoords[] pc = gSharedTempPointerCoords; + final int[] map = gSharedTempPointerIndexMap; + + final int oldAction = nativeGetAction(mNativePtr); + final int oldActionMasked = oldAction & ACTION_MASK; + final int oldActionPointerIndex = (oldAction & ACTION_POINTER_INDEX_MASK) + >> ACTION_POINTER_INDEX_SHIFT; + int newActionPointerIndex = -1; + int newPointerCount = 0; + int newIdBits = 0; + for (int i = 0; i < oldPointerCount; i++) { + nativeGetPointerProperties(mNativePtr, i, pp[newPointerCount]); + final int idBit = 1 << pp[newPointerCount].id; + if ((idBit & idBits) != 0) { + if (i == oldActionPointerIndex) { + newActionPointerIndex = newPointerCount; + } + map[newPointerCount] = i; + newPointerCount += 1; + newIdBits |= idBit; + } + } + + if (newPointerCount == 0) { + throw new IllegalArgumentException("idBits did not match any ids in the event"); + } + + final int newAction; + if (oldActionMasked == ACTION_POINTER_DOWN || oldActionMasked == ACTION_POINTER_UP) { + if (newActionPointerIndex < 0) { + // An unrelated pointer changed. + newAction = ACTION_MOVE; + } else if (newPointerCount == 1) { + // The first/last pointer went down/up. + newAction = oldActionMasked == ACTION_POINTER_DOWN + ? ACTION_DOWN : ACTION_UP; + } else { + // A secondary pointer went down/up. + newAction = oldActionMasked + | (newActionPointerIndex << ACTION_POINTER_INDEX_SHIFT); + } + } else { + // Simple up/down/cancel/move or other motion action. + newAction = oldAction; + } + + final int historySize = nativeGetHistorySize(mNativePtr); + for (int h = 0; h <= historySize; h++) { + final int historyPos = h == historySize ? HISTORY_CURRENT : h; + + for (int i = 0; i < newPointerCount; i++) { + nativeGetPointerCoords(mNativePtr, map[i], historyPos, pc[i]); + } + + final long eventTimeNanos = nativeGetEventTimeNanos(mNativePtr, historyPos); + if (h == 0) { + ev.mNativePtr = nativeInitialize(ev.mNativePtr, + nativeGetDeviceId(mNativePtr), nativeGetSource(mNativePtr), + newAction, nativeGetFlags(mNativePtr), + nativeGetEdgeFlags(mNativePtr), nativeGetMetaState(mNativePtr), + nativeGetButtonState(mNativePtr), + nativeGetXOffset(mNativePtr), nativeGetYOffset(mNativePtr), + nativeGetXPrecision(mNativePtr), nativeGetYPrecision(mNativePtr), + nativeGetDownTimeNanos(mNativePtr), eventTimeNanos, + newPointerCount, pp, pc); + } else { + nativeAddBatch(ev.mNativePtr, eventTimeNanos, pc, 0); + } + } + return ev; + } + } + + @Override + public String toString() { + StringBuilder msg = new StringBuilder(); + msg.append("MotionEvent { action=").append(actionToString(getAction())); + + final int pointerCount = getPointerCount(); + for (int i = 0; i < pointerCount; i++) { + msg.append(", id[").append(i).append("]=").append(getPointerId(i)); + msg.append(", x[").append(i).append("]=").append(getX(i)); + msg.append(", y[").append(i).append("]=").append(getY(i)); + msg.append(", toolType[").append(i).append("]=").append( + toolTypeToString(getToolType(i))); + } + + msg.append(", buttonState=").append(MotionEvent.buttonStateToString(getButtonState())); + msg.append(", metaState=").append(/*KeyEvent.metaStateToString(getMetaState())*/"FIXME"); + msg.append(", flags=0x").append(Integer.toHexString(getFlags())); + msg.append(", edgeFlags=0x").append(Integer.toHexString(getEdgeFlags())); + msg.append(", pointerCount=").append(pointerCount); + msg.append(", historySize=").append(getHistorySize()); + msg.append(", eventTime=").append(getEventTime()); + msg.append(", downTime=").append(getDownTime()); + msg.append(", deviceId=").append(getDeviceId()); + msg.append(", source=0x").append(Integer.toHexString(getSource())); + msg.append(" }"); + return msg.toString(); + } + + /** + * Returns a string that represents the symbolic name of the specified unmasked action + * such as "ACTION_DOWN", "ACTION_POINTER_DOWN(3)" or an equivalent numeric constant + * such as "35" if unknown. + * + * @param action The unmasked action. + * @return The symbolic name of the specified action. + * @see #getAction() + */ + public static String actionToString(int action) { + switch (action) { + case ACTION_DOWN: + return "ACTION_DOWN"; + case ACTION_UP: + return "ACTION_UP"; + case ACTION_CANCEL: + return "ACTION_CANCEL"; + case ACTION_OUTSIDE: + return "ACTION_OUTSIDE"; + case ACTION_MOVE: + return "ACTION_MOVE"; + case ACTION_HOVER_MOVE: + return "ACTION_HOVER_MOVE"; + case ACTION_SCROLL: + return "ACTION_SCROLL"; + case ACTION_HOVER_ENTER: + return "ACTION_HOVER_ENTER"; + case ACTION_HOVER_EXIT: + return "ACTION_HOVER_EXIT"; + } + int index = (action & ACTION_POINTER_INDEX_MASK) >> ACTION_POINTER_INDEX_SHIFT; + switch (action & ACTION_MASK) { + case ACTION_POINTER_DOWN: + return "ACTION_POINTER_DOWN(" + index + ")"; + case ACTION_POINTER_UP: + return "ACTION_POINTER_UP(" + index + ")"; + default: + return Integer.toString(action); + } + } + + /** + * Returns a string that represents the symbolic name of the specified axis + * such as "AXIS_X" or an equivalent numeric constant such as "42" if unknown. + * + * @param axis The axis. + * @return The symbolic name of the specified axis. + */ + public static String axisToString(int axis) { + String symbolicName = AXIS_SYMBOLIC_NAMES.get(axis); + return symbolicName != null ? symbolicName : Integer.toString(axis); + } + + /** + * Gets an axis by its symbolic name such as "AXIS_X" or an + * equivalent numeric constant such as "42". + * + * @param symbolicName The symbolic name of the axis. + * @return The axis or -1 if not found. + * @see KeyEvent#keyCodeToString(int) + */ + public static int axisFromString(String symbolicName) { + if (symbolicName == null) { + throw new IllegalArgumentException("symbolicName must not be null"); + } + + final int count = AXIS_SYMBOLIC_NAMES.size(); + for (int i = 0; i < count; i++) { + if (symbolicName.equals(AXIS_SYMBOLIC_NAMES.valueAt(i))) { + return i; + } + } + + try { + return Integer.parseInt(symbolicName, 10); + } catch (NumberFormatException ex) { + return -1; + } + } + + /** + * Returns a string that represents the symbolic name of the specified combined + * button state flags such as "0", "BUTTON_PRIMARY", + * "BUTTON_PRIMARY|BUTTON_SECONDARY" or an equivalent numeric constant such as "0x10000000" + * if unknown. + * + * @param buttonState The button state. + * @return The symbolic name of the specified combined button state flags. + * @hide + */ + public static String buttonStateToString(int buttonState) { + if (buttonState == 0) { + return "0"; + } + StringBuilder result = null; + int i = 0; + while (buttonState != 0) { + final boolean isSet = (buttonState & 1) != 0; + buttonState >>>= 1; // unsigned shift! + if (isSet) { + final String name = BUTTON_SYMBOLIC_NAMES[i]; + if (result == null) { + if (buttonState == 0) { + return name; + } + result = new StringBuilder(name); + } else { + result.append('|'); + result.append(name); + } + } + i += 1; + } + return result.toString(); + } + + /** + * Returns a string that represents the symbolic name of the specified tool type + * such as "TOOL_TYPE_FINGER" or an equivalent numeric constant such as "42" if unknown. + * + * @param toolType The tool type. + * @return The symbolic name of the specified tool type. + * @hide + */ + public static String toolTypeToString(int toolType) { + String symbolicName = TOOL_TYPE_SYMBOLIC_NAMES.get(toolType); + return symbolicName != null ? symbolicName : Integer.toString(toolType); + } + + /** + * Transfer object for pointer coordinates. + * + * Objects of this type can be used to specify the pointer coordinates when + * creating new {@link MotionEvent} objects and to query pointer coordinates + * in bulk. + * + * Refer to {@link InputDevice} for information about how different kinds of + * input devices and sources represent pointer coordinates. + */ + public static final class PointerCoords { + private static final int INITIAL_PACKED_AXIS_VALUES = 8; + private long mPackedAxisBits; + private float[] mPackedAxisValues; + + /** + * Creates a pointer coords object with all axes initialized to zero. + */ + public PointerCoords() { + } + + /** + * Creates a pointer coords object as a copy of the + * contents of another pointer coords object. + * + * @param other The pointer coords object to copy. + */ + public PointerCoords(PointerCoords other) { + copyFrom(other); + } + + /** @hide */ + public static PointerCoords[] createArray(int size) { + PointerCoords[] array = new PointerCoords[size]; + for (int i = 0; i < size; i++) { + array[i] = new PointerCoords(); + } + return array; + } + + /** + * The X component of the pointer movement. + * + * @see MotionEvent#AXIS_X + */ + public float x; + + /** + * The Y component of the pointer movement. + * + * @see MotionEvent#AXIS_Y + */ + public float y; + + /** + * A normalized value that describes the pressure applied to the device + * by a finger or other tool. + * The pressure generally ranges from 0 (no pressure at all) to 1 (normal pressure), + * although values higher than 1 may be generated depending on the calibration of + * the input device. + * + * @see MotionEvent#AXIS_PRESSURE + */ + public float pressure; + + /** + * A normalized value that describes the approximate size of the pointer touch area + * in relation to the maximum detectable size of the device. + * It represents some approximation of the area of the screen being + * pressed; the actual value in pixels corresponding to the + * touch is normalized with the device specific range of values + * and scaled to a value between 0 and 1. The value of size can be used to + * determine fat touch events. + * + * @see MotionEvent#AXIS_SIZE + */ + public float size; + + /** + * The length of the major axis of an ellipse that describes the touch area at + * the point of contact. + * If the device is a touch screen, the length is reported in pixels, otherwise it is + * reported in device-specific units. + * + * @see MotionEvent#AXIS_TOUCH_MAJOR + */ + public float touchMajor; + + /** + * The length of the minor axis of an ellipse that describes the touch area at + * the point of contact. + * If the device is a touch screen, the length is reported in pixels, otherwise it is + * reported in device-specific units. + * + * @see MotionEvent#AXIS_TOUCH_MINOR + */ + public float touchMinor; + + /** + * The length of the major axis of an ellipse that describes the size of + * the approaching tool. + * The tool area represents the estimated size of the finger or pen that is + * touching the device independent of its actual touch area at the point of contact. + * If the device is a touch screen, the length is reported in pixels, otherwise it is + * reported in device-specific units. + * + * @see MotionEvent#AXIS_TOOL_MAJOR + */ + public float toolMajor; + + /** + * The length of the minor axis of an ellipse that describes the size of + * the approaching tool. + * The tool area represents the estimated size of the finger or pen that is + * touching the device independent of its actual touch area at the point of contact. + * If the device is a touch screen, the length is reported in pixels, otherwise it is + * reported in device-specific units. + * + * @see MotionEvent#AXIS_TOOL_MINOR + */ + public float toolMinor; + + /** + * The orientation of the touch area and tool area in radians clockwise from vertical. + * An angle of 0 radians indicates that the major axis of contact is oriented + * upwards, is perfectly circular or is of unknown orientation. A positive angle + * indicates that the major axis of contact is oriented to the right. A negative angle + * indicates that the major axis of contact is oriented to the left. + * The full range is from -PI/2 radians (finger pointing fully left) to PI/2 radians + * (finger pointing fully right). + * + * @see MotionEvent#AXIS_ORIENTATION + */ + public float orientation; + + /** + * Clears the contents of this object. + * Resets all axes to zero. + */ + public void clear() { + mPackedAxisBits = 0; + + x = 0; + y = 0; + pressure = 0; + size = 0; + touchMajor = 0; + touchMinor = 0; + toolMajor = 0; + toolMinor = 0; + orientation = 0; + } + + /** + * Copies the contents of another pointer coords object. + * + * @param other The pointer coords object to copy. + */ + public void copyFrom(PointerCoords other) { + final long bits = other.mPackedAxisBits; + mPackedAxisBits = bits; + if (bits != 0) { + final float[] otherValues = other.mPackedAxisValues; + final int count = Long.bitCount(bits); + float[] values = mPackedAxisValues; + if (values == null || count > values.length) { + values = new float[otherValues.length]; + mPackedAxisValues = values; + } + System.arraycopy(otherValues, 0, values, 0, count); + } + + x = other.x; + y = other.y; + pressure = other.pressure; + size = other.size; + touchMajor = other.touchMajor; + touchMinor = other.touchMinor; + toolMajor = other.toolMajor; + toolMinor = other.toolMinor; + orientation = other.orientation; + } + + /** + * Gets the value associated with the specified axis. + * + * @param axis The axis identifier for the axis value to retrieve. + * @return The value associated with the axis, or 0 if none. + * + * @see MotionEvent#AXIS_X + * @see MotionEvent#AXIS_Y + */ + public float getAxisValue(int axis) { + switch (axis) { + case AXIS_X: + return x; + case AXIS_Y: + return y; + case AXIS_PRESSURE: + return pressure; + case AXIS_SIZE: + return size; + case AXIS_TOUCH_MAJOR: + return touchMajor; + case AXIS_TOUCH_MINOR: + return touchMinor; + case AXIS_TOOL_MAJOR: + return toolMajor; + case AXIS_TOOL_MINOR: + return toolMinor; + case AXIS_ORIENTATION: + return orientation; + default: { + if (axis < 0 || axis > 63) { + throw new IllegalArgumentException("Axis out of range."); + } + final long bits = mPackedAxisBits; + final long axisBit = 1L << axis; + if ((bits & axisBit) == 0) { + return 0; + } + final int index = Long.bitCount(bits & (axisBit - 1L)); + return mPackedAxisValues[index]; + } + } + } + + /** + * Sets the value associated with the specified axis. + * + * @param axis The axis identifier for the axis value to assign. + * @param value The value to set. + * + * @see MotionEvent#AXIS_X + * @see MotionEvent#AXIS_Y + */ + public void setAxisValue(int axis, float value) { + switch (axis) { + case AXIS_X: + x = value; + break; + case AXIS_Y: + y = value; + break; + case AXIS_PRESSURE: + pressure = value; + break; + case AXIS_SIZE: + size = value; + break; + case AXIS_TOUCH_MAJOR: + touchMajor = value; + break; + case AXIS_TOUCH_MINOR: + touchMinor = value; + break; + case AXIS_TOOL_MAJOR: + toolMajor = value; + break; + case AXIS_TOOL_MINOR: + toolMinor = value; + break; + case AXIS_ORIENTATION: + orientation = value; + break; + default: { + if (axis < 0 || axis > 63) { + throw new IllegalArgumentException("Axis out of range."); + } + final long bits = mPackedAxisBits; + final long axisBit = 1L << axis; + final int index = Long.bitCount(bits & (axisBit - 1L)); + float[] values = mPackedAxisValues; + if ((bits & axisBit) == 0) { + if (values == null) { + values = new float[INITIAL_PACKED_AXIS_VALUES]; + mPackedAxisValues = values; + } else { + final int count = Long.bitCount(bits); + if (count < values.length) { + if (index != count) { + System.arraycopy(values, index, values, index + 1, + count - index); + } + } else { + float[] newValues = new float[count * 2]; + System.arraycopy(values, 0, newValues, 0, index); + System.arraycopy(values, index, newValues, index + 1, + count - index); + values = newValues; + mPackedAxisValues = values; + } + } + mPackedAxisBits = bits | axisBit; + } + values[index] = value; + } + } + } + } + + /** + * Transfer object for pointer properties. + * + * Objects of this type can be used to specify the pointer id and tool type + * when creating new {@link MotionEvent} objects and to query pointer properties in bulk. + */ + public static final class PointerProperties { + /** + * Creates a pointer properties object with an invalid pointer id. + */ + public PointerProperties() { + clear(); + } + + /** + * Creates a pointer properties object as a copy of the contents of + * another pointer properties object. + * @param other + */ + public PointerProperties(PointerProperties other) { + copyFrom(other); + } + + /** @hide */ + public static PointerProperties[] createArray(int size) { + PointerProperties[] array = new PointerProperties[size]; + for (int i = 0; i < size; i++) { + array[i] = new PointerProperties(); + } + return array; + } + + /** + * The pointer id. + * Initially set to {@link #INVALID_POINTER_ID} (-1). + * + * @see MotionEvent#getPointerId(int) + */ + public int id; + + /** + * The pointer tool type. + * Initially set to 0. + * + * @see MotionEvent#getToolType(int) + */ + public int toolType; + + /** + * Resets the pointer properties to their initial values. + */ + public void clear() { + id = INVALID_POINTER_ID; + toolType = TOOL_TYPE_UNKNOWN; + } + + /** + * Copies the contents of another pointer properties object. + * + * @param other The pointer properties object to copy. + */ + public void copyFrom(PointerProperties other) { + id = other.id; + toolType = other.toolType; + } + + @Override + public boolean equals(Object other) { + if (other instanceof PointerProperties) { + return equals((PointerProperties)other); + } + return false; + } + + private boolean equals(PointerProperties other) { + return other != null && id == other.id && toolType == other.toolType; + } + + @Override + public int hashCode() { + return id | (toolType << 8); + } + } }