Documentation Backend

remapper — Configure controller mapping

bool remapper(const uint8 layout[43]);

Configure the controller mapping in accordance with layout[43] parameter. Once the controller mapping is configured, it remains active with the specified input port(s) until the memory slot is unloaded or remapper_reset() is called.

The default mapping layout is defined as:

#include <remapper.gph>
 
const uint8 DefaultMappingLayout[43] = {
    RMP_USB_A | RMP_USB_B | RMP_USB_C | RMP_USB_D | RMP_BT_A | RMP_BT_B,
    BUTTON_1,  BUTTON_2,  BUTTON_3,  BUTTON_4,  BUTTON_5,  BUTTON_6,  BUTTON_7, 
    BUTTON_8,  BUTTON_9,  BUTTON_10, BUTTON_11, BUTTON_12, BUTTON_13, BUTTON_14, 
    BUTTON_15, BUTTON_16, BUTTON_17, BUTTON_18, BUTTON_19, BUTTON_20, BUTTON_21, 
    STICK_1_X, STICK_1_Y, STICK_2_X, STICK_2_Y, 
    POINT_1_X, POINT_1_Y, POINT_2_X, POINT_2_Y, 
    ACCEL_1_X, ACCEL_1_Y, ACCEL_1_Z, ACCEL_2_X, ACCEL_2_Y, ACCEL_2_Z, 
    GYRO_1_X,  GYRO_1_Y,  GYRO_1_Z,
    PADDLE_1,  PADDLE_2,  PADDLE_3,  PADDLE_4
};

A new custom layout is created by changing the positions of the I/O Identifiers in the array. Any arrangement is possible, including mapping a accelerometer to a button or stick.

The first element of the array defines which input port(s) the new layout should be applied.

• layout[43]: Constant array of 43 elements that defines a controller mapping and the port(s) the layout should be applied.

Returns true if the mapping layout was successfully loaded, or FALSE if the mapping layout failed to load.

#include <remapper.gph>
 
// Changed mappings:
// BUTTON_4  mapped to BUTTON_14
// BUTTON_5  mapped to BUTTON_15
// BUTTON_14 mapped to BUTTON_5
// BUTTON_15 mapped to BUTTON_17
// BUTTON_17 mapped to BUTTON_4
 
const uint8 GodOfWarLayout[43] = {
    RMP_USB_A, 
    BUTTON_1,  BUTTON_2,  BUTTON_3,  BUTTON_14, BUTTON_15, BUTTON_6,  BUTTON_7, 
    BUTTON_8,  BUTTON_9,  BUTTON_10, BUTTON_11, BUTTON_12, BUTTON_13, BUTTON_5, 
    BUTTON_17, BUTTON_16, BUTTON_4,  BUTTON_18, BUTTON_19, BUTTON_20, BUTTON_21, 
    STICK_1_X, STICK_1_Y, STICK_2_X, STICK_2_Y, 
    POINT_1_X, POINT_1_Y, POINT_2_X, POINT_2_Y, 
    ACCEL_1_X, ACCEL_1_Y, ACCEL_1_Z, ACCEL_2_X, ACCEL_2_Y, ACCEL_2_Z, 
    GYRO_1_X,  GYRO_1_Y,  GYRO_1_Z,
    PADDLE_1,  PADDLE_2,  PADDLE_3,  PADDLE_4
};
 
init {
    // Change the button layout to play Dark Souls as God of War 
    // using the controller on Input-A.
    remapper(GodOfWarLayout);
}

• remapper_swap
• remapper_disable
• remapper_mask
• remapper_reset
• #import