Game control

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ja Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

game_control

Description

Event: game_control( key id, list buttons_edge_down, list buttons_edge_up, list buttons_down, list axes ){ ; }

40	Event ID
	Delay

Experimental event only available in some testing regions (soon). Triggered when compatible viewer sends fresh GameControlInput message, but only for scripts on attachments or seat.

• key	id	–	avatar UUID
• list	buttons_edge_down	–	list of buttons indices that transitioned to down state
• list	buttons_edge_up	–	list of buttons indices that transitioned to up state
• list	buttons_down	–	list of buttons indices that are currently pressed down
• list	axes	–	list of axes values in range [-1, 1]

Caveats

• If enabled at the client: unhandled keystrokes will be treated as button presses.
• There are 256 possible button indices however the buttons_down list is capped to a maximum length of 16.
• buttons_edge_down and buttons_edge_up are computed using old an new buttons_down values when the event runs. If the script is unable to process events fast enough then some down-up and up-down edge pairs may cancel out and not register.
• There are always 6 axes values, even when the controller device has more or less
  • All axes elements will be in range [-1,1] except for GAME_CONTROL_AXIS_TRIGGERLEFT and GAME_CONTROL_AXIS_TRIGGERRIGHT which range [0, 1]

All Issues ~ Search JIRA for related Bugs

Examples

print_list(string name, integer type, list data)
{
    integer data_length = llGetListLength(data);
    string text = name + " : ";
    if (data_length > 0)
    {
        integer use_comma = FALSE;
        integer i = 0;
        for (i = 0; i < data_length; i++)
        {
            if (!use_comma)
            {
                use_comma = TRUE;
            }
            else
            {
                text += ",";
            }
            if (type == TYPE_INTEGER)
            {
                integer b = (llList2Integer(data, i));
                text += (string)(b);
                llOwnerSay("pack i=" + (string)(i) + " b=" + (string)(b));
            }
            else if (type == TYPE_FLOAT)
            {
                text += (string)(llList2Float(data, i));
            }
        }
    }
    llOwnerSay(text);
}

default
{
    state_entry()
    {
        llOwnerSay("attach or sit");
    }
    game_control(key id, list buttons_down_edge, list buttons_up_edge, list buttons_down, list axes)
    {
        llOwnerSay("game_control :");
        print_list("  edge_down", TYPE_INTEGER, buttons_down_edge);
        print_list("  edge_up", TYPE_INTEGER, buttons_up_edge);
        print_list("  down", TYPE_INTEGER, buttons_down);
        print_list("  axes", TYPE_FLOAT, axes);
    }
}

See Also

Events

•

control

Deep Notes

Signature
event void game_control( key id, list buttons_edge_down, list buttons_edge_up, list buttons_down, list axes );