com.sun.glass.ui.monocle

Class LinuxInputDevice

java.lang.Object

com.sun.glass.ui.monocle.LinuxInputDevice

All Implemented Interfaces:

InputDevice, java.lang.Runnable

class LinuxInputDevice
extends java.lang.Object
implements java.lang.Runnable, InputDevice

A LinuxInputDevice listens for events on a Linux input device node, typically one of the files in /dev/input. When events are waiting to be processed on the device it notifies its listener on a thread provided by its runnable processor object.

Event lines are accumulated in a buffer until an event "EV_SYN EV_SYN_REPORT 0" is received. At this point the listener is notified. The listener can then use the methods getEventType(), getEventCode() and getEventValue() to obtain the details of the current event line to process. nextEvent() and hasNextEvent() are used to iterate over pending events.

To save on RAM and GC, event lines are not objects.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) class	LinuxInputDevice.EventProcessor The EventProcessor is used to notify listeners of pending events.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<java.lang.Integer,LinuxAbsoluteInputCapabilities>	absCaps
private LinuxEventBuffer	buffer
private java.util.Map<java.lang.String,java.util.BitSet>	capabilities
private java.io.File	devNode
private java.nio.ByteBuffer	event
private long	fd
private java.nio.channels.ReadableByteChannel	in
private LinuxInputProcessor	inputProcessor
private LinuxInputDevice.EventProcessor	processor
private RunnableProcessor	runnableProcessor
private java.io.File	sysPath
private static LinuxSystem	system
private java.util.Map<java.lang.String,java.lang.String>	udevManifest
private java.util.Map<java.lang.String,java.lang.String>	uevent

Constructor Summary

Constructors

Constructor and Description
LinuxInputDevice(java.io.File devNode, java.io.File sysPath, java.util.Map<java.lang.String,java.lang.String> udevManifest) Create a new com.sun.glass.ui.monocle.input.LinuxInputDevice on the given input node.
LinuxInputDevice(java.util.Map<java.lang.String,java.util.BitSet> capabilities, java.util.Map<java.lang.Integer,LinuxAbsoluteInputCapabilities> absCaps, java.nio.channels.ReadableByteChannel in, java.util.Map<java.lang.String,java.lang.String> udevManifest, java.util.Map<java.lang.String,java.lang.String> uevent) Create a new simulated LinuxInputDevice

Method Summary

Modifier and Type	Method and Description
(package private) LinuxAbsoluteInputCapabilities	getAbsoluteInputCapabilities(int axis)
(package private) LinuxEventBuffer	getBuffer()
(package private) java.util.BitSet	getCapability(java.lang.String type)
(package private) java.lang.String	getProduct()
boolean	is5Way()
boolean	isFullKeyboard()
boolean	isMultiTouch()
(package private) boolean	isQuiet() Asks whether the device is quiet.
boolean	isRelative()
boolean	isTouch()
private boolean	isTouchDeclaredAsMouse()
private void	readToEventBuffer()
void	run()
(package private) void	setInputProcessor(LinuxInputProcessor inputProcessor)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

inputProcessor

private LinuxInputProcessor inputProcessor

in

private java.nio.channels.ReadableByteChannel in

fd

private long fd

devNode

private java.io.File devNode

sysPath

private java.io.File sysPath

capabilities

private java.util.Map<java.lang.String,java.util.BitSet> capabilities

absCaps

private java.util.Map<java.lang.Integer,LinuxAbsoluteInputCapabilities> absCaps

udevManifest

private java.util.Map<java.lang.String,java.lang.String> udevManifest

event

private final java.nio.ByteBuffer event

runnableProcessor

private RunnableProcessor runnableProcessor

processor

private LinuxInputDevice.EventProcessor processor

buffer

private final LinuxEventBuffer buffer

uevent

private java.util.Map<java.lang.String,java.lang.String> uevent

system

private static LinuxSystem system

Constructor Detail

LinuxInputDevice

LinuxInputDevice(java.io.File devNode,
                 java.io.File sysPath,
                 java.util.Map<java.lang.String,java.lang.String> udevManifest)
          throws java.io.IOException

Create a new com.sun.glass.ui.monocle.input.LinuxInputDevice on the given input node.

Parameters:

devNode - The node on which to listen for input

sysPath - The sysfs path describing the device

Throws:

java.io.IOException

LinuxInputDevice

LinuxInputDevice(java.util.Map<java.lang.String,java.util.BitSet> capabilities,
                 java.util.Map<java.lang.Integer,LinuxAbsoluteInputCapabilities> absCaps,
                 java.nio.channels.ReadableByteChannel in,
                 java.util.Map<java.lang.String,java.lang.String> udevManifest,
                 java.util.Map<java.lang.String,java.lang.String> uevent)

Create a new simulated LinuxInputDevice

Parameters:

capabilities - Simulated capabilities

absCaps - Simulated absolute axis capabilities

in - Channel f or simulated input events

uevent - Simulated uevent data

Method Detail

setInputProcessor

void setInputProcessor(LinuxInputProcessor inputProcessor)

readToEventBuffer

private void readToEventBuffer()
                        throws java.io.IOException

Throws:

java.io.IOException

run

public void run()

Specified by:

run in interface java.lang.Runnable

getBuffer

LinuxEventBuffer getBuffer()

isQuiet

boolean isQuiet()

Asks whether the device is quiet. "Quiet" means that the event reader is blocked waiting for events, the buffer is empty and the event processor is not scheduled. Called on the application thread.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

Returns:

a string describing this input device

getCapability

java.util.BitSet getCapability(java.lang.String type)

getAbsoluteInputCapabilities

LinuxAbsoluteInputCapabilities getAbsoluteInputCapabilities(int axis)

getProduct

java.lang.String getProduct()

isTouch

public boolean isTouch()

Specified by:

isTouch in interface InputDevice

Returns:

true if the device provides touch input for at least one touch point.

isTouchDeclaredAsMouse

private boolean isTouchDeclaredAsMouse()

isMultiTouch

public boolean isMultiTouch()

Specified by:

isMultiTouch in interface InputDevice

Returns:

true if the device provides touch input for more than one touch point.

isRelative

public boolean isRelative()

Specified by:

isRelative in interface InputDevice

Returns:

true if the device provides relative pointing events. Relative pointing events are those received from devices where the event signifies a relative change in cursor position on the screen. For example, a mouse, trackball, trackpad or joystick is a relative pointing device. A touch screen is an sbsolute pointing device.

is5Way

public boolean is5Way()

Specified by:

is5Way in interface InputDevice

Returns:

true if the device provides direction arrow keys (UP, DOWN, LEFT and RIGHT) and a selection key.

isFullKeyboard

public boolean isFullKeyboard()

Specified by:

isFullKeyboard in interface InputDevice

Returns:

true if the device provides keys for the letters 'A' through 'Z', the digits '0' through '9' and also SPACE, SHIFT and TAB keys in addition to directional arrows and a selection key.