Polling of input states

Table of Contents

• Overview
  • Disable Input-Events
  • Keyboard
  • Gamepad
  • Mouse
  • Tips
  • Polling without a window

Overview

FPL supports manual polling of input states for Keyboard/Gamepad/Mouse as well.

Disable Input-Events

If you only use polling to get your input states, you should disable the input-events entirely.
This is done by simply setting the fplInputSettings::disabledEvents to "1" in your fplSettings structure.

Keyboard

Use fplPollKeyboardState to poll the current keyboard state.
This state contains all the raw/mapped button states and the modifier states.

fplKeyboardState keyboardState;
if (fplPollKeyboardState(&keyboardState)) {
    if (keyboardState.buttonStatesMapped[fplKey_Space] >= fplButtonState_Press) {
        // Spacebar pressed
    }
}

See fplKeyboardState for more details.

Gamepad

Use fplPollGamepadStates to poll the current states for all connected game controllers.
This state contains all the buttons, digital-pad, the left/right stick position + trigger, etc.

fplGamepadStates gamepadStates;
if (fplPollGamepadStates(&gamepadStates)) {
    for (int index = 0; index < fplArrayCount(gamepadStates.deviceStates); ++index) {
        fplGamepadState *gamepadState = gamepadStates.deviceStates + index;
        // ... do something with the gamepad state
    }
}

See fplGamepadStates for more details.

Note

use fplGamepadState::isConnected to check if the gamepad is connected or not.

Mouse

Use fplPollMouseState to poll the current mouse state.
This state contains the state of all the buttons (Left, Right, Middle) and the position in pixels coordinates.

fplMouseState mouseState;
if (fplPollMouseState(&mouseState)) {
    int mousePosX = mouseState.x;
    int mousePosY = mouseState.y;
    if (mouseState.buttonStates[fplMouseButtonType_Left] >= fplButtonState_Pressed) {
        // Left mouse button down
    }
}

See fplMouseState for more details.

Tips

Note

You can always use all those polling functions, regardless of the fplInputSettings::disabledEvents field!

Polling without a window

When the application runs without a window (FPL_NO_WINDOW or fplInputSettings::detachFromWindow), the input subsystem is not driven by a window event loop. Call fplUpdateInputDevices once per frame to refresh cached state and dispatch gamepad connect/disconnect events. fplPollEvent and fplPollEvents also work in this mode and drive the input subsystem internally.

See Using input without a window for a full example.