Polling of input states

Table of Contents

• Overview
  • Disable Input-Events
  • Keyboard
  • Gamepad
  • Mouse
  • Tips

Overview

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

Disable Input-Events

If you are 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!