Input, Event and Listener - Rombusevil/flixel-gdx GitHub Wiki

In this guide you’ll learn how to use the different inputs in flixel. Most of them are accessible via FlxG (the Global helper class).

The Mouse input can be reach via FlxG.mouse. Then you get access to all mouse functions like just pressed, pressed and just released. The Mouse also acts as touch input for touch screen devices. For touch screen devices, multi touch is also supported.

The functions of mouse return a Boolean whether the event has occurred.

Examples:

• EZPlatformer
• Mode
• Drag and Drop

Doing multitouch goes via the same methods as described in the table above, but than with an argument passed to determine which pointer/finger has been used. The snippet below loops through 10 indices (our ten fingers) to check which index is pressed.

for(int i = 0; i < 10; i++)
{		
	if(FlxG.mouse.pressed(i))
	{
		FlxG.log("input: " + i);
	}
}

Examples:

• Multitouch
• FlxCollision Playstate 1

The Keyboard input can be reached via FlxG.keys. The Keyboard has collection of keys and can be check checked via variety ways.

Examples:

• EZPlatformer
• Mode
• BomberPlanet

If you want reconfigurable button support in your game, you can store the key name in a String and use it in the Keyboard's methods.

String jump = "SPACE";
FlxG.keys.justPressed(jump);

GamepadManager, is the plugin class. You’ll need to register this class via FlxG.addPlugin(). This class manages the controllers and passes the input events to the correct Gamepad. It also does auto mapping.

GamepadMapping, contains a bunch of indices for each gamepad button. If you want to map a certain gamepad, you need to change the indices.

Gamepad, it’s like the Keyboard class. It tracks what keys are pressed, tracks analog and accelerometer data.

The gamepad uses the default mapping that is shipped with libGDX. Hooking a gamepad like Xbox 360 won’t work. You’ll need to create a mapping first. Click here for the mapping for Xbox 360. There are different models of controllers with different IDs. The ID is crucial for doing auto mapping. Via GamepadManager you can add the mapping. Adding a gamepad is very simple, just add new Gamepad to the manager. When you do this, the manager will automatically set the correct mapping to the gamepad. It reads the ID of the controller. So be sure the ID is correct written.

// Xbox 360 Controller (ID varies). GamepadManager.addMapping(new Xbox360Controller());
// Create gamepads. You can add as many as you like. GamepadManager.addGamepad(gamepad = new Gamepad());
// Xbox 360 Controller (ID varies).
GamepadManager.addMapping(new Xbox360Controller());
// Create gamepads. You can add as many as you like.
GamepadManager.addGamepad(gamepad = new Gamepad());

Getting the state of the buttons, you can get it like this: gamepad.justPressed("Button_X"). Look at this example. If you want to add your own mapping, you’ll need to read the buttonCode. If you develop from source you can add a log in GamepadManager.buttonDown and axisMoved.

Examples:

• Controller Demo (DPAD)
• Controller Demo (Analog)

Flixel comes with two on screen controllers: FlxVirtualPad and FlxAnalog. They are easy in use by simply adding them to the state.

FlxVirtualPad’s constructor requires two arguments. You can customize the layout by passing FlxVirtualPad.FULL for 4 direction buttons and FlxVirtualPad.A_B_C for three action buttons. You can get the status of the button by FlxVirtualPad.buttonLeft.status.

FlxVirtualPad pad = new FlxVirtualPad(FlxVirtualPad.FULL, FlxVirtualPad.A);
if(pad.buttonLeft.status == FlxButton.PRESSED)
{
	// Do something
}

You can customize the graphics by overriding FlxVirtualPad.createButton() and createCenter().

Examples:

• Tiledmap2 Demo

The constructor of FlxAnalog has 4 arguments (two optional).

• The first two are the position.
• The third is the radius where the thumb can move.
• The fourth is the radius where the pointer (mouse/finger) can move while dragging the thumb. If the pointer is outside the radius, the thumb will be released.

You can get the x,y data via FlxAnalog.acceleration.

Examples:

• Analog Demo

The gesture detector is part of the input processor. To use gesture you only need to create a FlxGesture object and call start().

FlxGesture gesture = new FlxGesture();
gesture.start(new IFlxGesture()
{
	@Override
	public void callback(int Gesture, GestureData data)
	{
		switch(Gesture)
		{
			case FlxGesture.ZOOM:
				text.setText("ZOOM");
				break;
		}
	}
}

In start() you need to pass a callback. The callback returns the type and data that belongs to the gesture that got performed. The type can be accessed via FlxGesture. The GestureData holds information like the position, velocity, distance between two fingers, etc.

Examples:

• Gesture Demo

The sensor is part of the input processor and can be accessed via FlxG.sensor. The Sensor class got various attributes.

Examples:

• Sensor Demo