Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
* Copyright (c) 2003 Sun Microsystems, Inc. All Rights Reserved.
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* - Redistribution of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* - Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materails provided with the distribution.
*
* Neither the name Sun Microsystems, Inc. or the names of the contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind.
* ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
* ANY IMPLIED WARRANT OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMEN, ARE HEREBY EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND
* ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS
* A RESULT OF USING, MODIFYING OR DESTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
* REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
* INCIDENTAL OR PUNITIVE DAMAGES. HOWEVER CAUSED AND REGARDLESS OF THE THEORY
* OF LIABILITY, ARISING OUT OF THE USE OF OUR INABILITY TO USE THIS SOFTWARE,
* EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed or intended for us in
* the design, construction, operation or maintenance of any nuclear facility
*
*/
package net.java.games.input;
import java.util.Map;
import java.util.HashMap;
import java.io.IOException;
/**
* An AbstractController is a skeleton implementation of a controller that
* contains a fixed number of axes, controllers, and rumblers.
*/
public abstract class AbstractController implements Controller {
final static int EVENT_QUEUE_DEPTH = 32;
private final static Event event = new Event();
/**
* Human-readable name for this Controller
*/
private final String name;
/**
* Array of components
*/
private final Component[] components;
/**
* Array of child controllers
*/
private final Controller[] children;
/**
* Array of rumblers
*/
private final Rumbler[] rumblers;
/**
* Map from Component.Identifiers to Components
*/
private final Map id_to_components = new HashMap<>();
private EventQueue event_queue = new EventQueue(EVENT_QUEUE_DEPTH);
/**
* Protected constructor for a controller containing the specified
* axes, child controllers, and rumblers
* @param name name for the controller
* @param components components for the controller
* @param children child controllers for the controller
* @param rumblers rumblers for the controller
*/
protected AbstractController(String name, Component[] components, Controller[] children, Rumbler[] rumblers) {
this.name = name;
this.components = components;
this.children = children;
this.rumblers = rumblers;
// process from last to first to let earlier listed Components get higher priority
for (int i = components.length - 1; i >= 0; i--) {
id_to_components.put(components[i].getIdentifier(), components[i]);
}
}
/**
* Returns the controllers connected to make up this controller, or
* an empty array if this controller contains no child controllers.
* The objects in the array are returned in order of assignment priority
* (primary stick, secondary buttons, etc.).
*/
public final Controller[] getControllers() {
return children;
}
/**
* Returns the components on this controller, in order of assignment priority.
* For example, the button controller on a mouse returns an array containing
* the primary or leftmost mouse button, followed by the secondary or
* rightmost mouse button (if present), followed by the middle mouse button
* (if present).
* The array returned is an empty array if this controller contains no components
* (such as a logical grouping of child controllers).
*/
public final Component[] getComponents() {
return components;
}
/**
* Returns a single component based on its identifier, or null
* if no component with the specified type could be found.
*/
public final Component getComponent(Component.Identifier id) {
return id_to_components.get(id);
}
/**
* Returns the rumblers for sending feedback to this controller, or an
* empty array if there are no rumblers on this controller.
*/
public final Rumbler[] getRumblers() {
return rumblers;
}
/**
* Returns the port type for this Controller.
* @return PortType.UNKNOWN by default, can be overridden
*/
public PortType getPortType() {
return PortType.UNKNOWN;
}
/**
* Returns the zero-based port number for this Controller.
* @return 0 by default, can be overridden
*/
public int getPortNumber() {
return 0;
}
/**
* Returns a human-readable name for this Controller.
*/
public final String getName() {
return name;
}
/**
* Returns a non-localized string description of this controller.
*/
public String toString() {
return name;
}
/** Returns the type of the Controller.
*/
public Type getType() {
return Type.UNKNOWN;
}
/**
* Creates a new EventQueue. Events in old queue are lost.
*/
public final void setEventQueueSize(int size) {
try {
setDeviceEventQueueSize(size);
event_queue = new EventQueue(size);
} catch (IOException e) {
ControllerEnvironment.log("Failed to create new event queue of size " + size + ": " + e);
}
}
/**
* Plugins override this method to adjust their internal event queue size
*/
protected void setDeviceEventQueueSize(int size) throws IOException {
}
public final EventQueue getEventQueue() {
return event_queue;
}
protected abstract boolean getNextDeviceEvent(Event event) throws IOException;
protected void pollDevice() throws IOException {
}
/* poll() is synchronized to protect the static event */
public synchronized boolean poll() {
Component[] components = getComponents();
try {
pollDevice();
for (int i = 0; i < components.length; i++) {
AbstractComponent component = (AbstractComponent)components[i];
if (component.isRelative()) {
component.setPollData(0);
} else {
// Let the component poll itself lazily
component.resetHasPolled();
}
}
while (getNextDeviceEvent(event)) {
AbstractComponent component = (AbstractComponent)event.getComponent();
float value = event.getValue();
if (component.isRelative()) {
if (value == 0)
continue;
component.setPollData(component.getPollData() + value);
} else {
if (value == component.getEventValue())
continue;
component.setEventValue(value);
}
if (!event_queue.isFull())
event_queue.add(event);
}
return true;
} catch (IOException e) {
ControllerEnvironment.log("Failed to poll device: " + e.getMessage());
return false;
}
}
} // class AbstractController
