[Example] Controller

[paladin-t]

Background: the gamepad API supports virtual gamepads (could be binded to actual hardware) with 6 buttons for each player (Left/Right/Up/Down, A/B).

What's new in this post: furthermore the btn(...) and btnp(...) functions also support retrieving from connected game controllers directly, with full buttons and axes support.

The key/axis constants are:

Controller = {
  A = 0,
  B = 1,
  X = 2,
  Y = 3,
  Back = 4,
  Guide = 5,
  Start = 6,
  LeftStick = 7,
  RightStick = 8,
  LeftShoulder = 9,
  RightShoulder = 10,
  DpadUp = 11,
  DpadDown = 12,
  DpadLeft = 13,
  DpadRight = 14,

  AxisLeftX = -1,
  AxisLeftY = -2,
  AxisRightX = -3,
  AxisRightY = -4,
  AxisTriggerLeft = -5,
  AxisTriggerRight = -6
}

Pass negative index to the two functions to retrieve from a controller hardware. Eg.

• btn(Controller.A, -1): gets whether the A button of the 1st connected controller is being pressed
• btnp(Controller.B, -1): gets whether the B button of the 1st connected controller is released from pressing
• btn(Controller.A, -2): gets whether the A button of the 2nd connected controller is being pressed
• btn(Controller.AxisLeftX, -2): gets the offset value of the Left X-axis of the 2nd connected controller

This feature is not yet documented, because I suppose the API could be more intuitive and improved but I haven't decided how to. So if you'd like to take an early try, consider importing and using the following wrapper instead.

example controller.zip

Wrapper usage:

Controller:update()
Controller:btn(Controller.A)
Controller:btnp(Controller.B)
Controller:axis(Controller.AxisLeftX)
Controller:axisp(Controller.AxisTriggerLeft)