/*******************************************************************************
* Copyright 2011 See AUTHORS file.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
******************************************************************************/
package com.badlogic.gdx.controllers;
import com.badlogic.gdx.Application;
import com.badlogic.gdx.ApplicationListener;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.LifecycleListener;
import com.badlogic.gdx.Application.ApplicationType;
import com.badlogic.gdx.utils.Array;
import com.badlogic.gdx.utils.GdxRuntimeException;
import com.badlogic.gdx.utils.ObjectMap;
import com.badlogic.gdx.utils.reflect.ClassReflection;
/** Provides access to connected {@link Controller} instances. Query the available controllers via {@link #getControllers()}, add
* and remove global {@link ControllerListener} instances via {@link #addListener(ControllerListener)} and
* {@link #removeListener(ControllerListener)}. The listeners will be invoked on the rendering thread. The global listeners will
* be invoked for all events generated by all controllers. Polling a Controller can be done by invoking one of its getter methods.
*
* @author Nathan Sweet */
public class Controllers {
private static final String TAG = "Controllers";
static final ObjectMap<Application, ControllerManager> managers = new ObjectMap<Application, ControllerManager>();
/** Returns an array of connected {@link Controller} instances. This method should only be called on the rendering thread.
*
* @return the connected controllers */
static public Array<Controller> getControllers () {
initialize();
return getManager().getControllers();
}
/** Add a global {@link ControllerListener} that can react to events from all {@link Controller} instances. The listener will be
* invoked on the rendering thread.
* @param listener */
static public void addListener (ControllerListener listener) {
initialize();
getManager().addListener(listener);
}
/** Removes a global {@link ControllerListener}. The method must be called on the rendering thread.
* @param listener */
static public void removeListener (ControllerListener listener) {
initialize();
getManager().removeListener(listener);
}
static private ControllerManager getManager () {
return managers.get(Gdx.app);
}
static private void initialize () {
if (managers.containsKey(Gdx.app)) return;
String className = null;
ApplicationType type = Gdx.app.getType();
ControllerManager manager = null;
if (type == ApplicationType.Android) {
if (Gdx.app.getVersion() >= 12) {
className = "com.badlogic.gdx.controllers.android.AndroidControllers";
} else {
Gdx.app.log(TAG, "No controller manager is available for Android versions < API level 12");
manager = new ControllerManagerStub();
}
} else if (type == ApplicationType.Desktop) {
className = "com.badlogic.gdx.controllers.desktop.DesktopControllerManager";
} else if (type == ApplicationType.WebGL) {
className = "com.badlogic.gdx.controllers.gwt.GwtControllers";
} else {
Gdx.app.log(TAG, "No controller manager is available for: " + Gdx.app.getType());
manager = new ControllerManagerStub();
}
if (manager == null) {
try {
Class controllerManagerClass = ClassReflection.forName(className);
manager = (ControllerManager)ClassReflection.newInstance(controllerManagerClass);
} catch (Throwable ex) {
throw new GdxRuntimeException("Error creating controller manager: " + className, ex);
}
}
managers.put(Gdx.app, manager);
final Application app = Gdx.app;
Gdx.app.addLifecycleListener(new LifecycleListener() {
@Override
public void resume () {
}
@Override
public void pause () {
}
@Override
public void dispose () {
managers.remove(app);
Gdx.app.log(TAG, "removed manager for application, " + managers.size + " managers active");
}
});
Gdx.app.log(TAG, "added manager for application, " + managers.size + " managers active");
}
}