Game control

From Second Life Wiki
Revision as of 16:02, 18 October 2023 by Leviathan Linden (talk | contribs) (change game_control signature to use bitfields instead of lists for buttons)
Jump to navigation Jump to search

Description

Event: game_control( key id, list button_levels, list button_edges, list axes ){ ; }

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 button_levels bitfield of buttons held down
• list button_edges bitfield of buttons that have changed
• list axes list of axes values in range [-1, 1]

Template:LSL Constants/GameControlInputs

Caveats

  • If enabled at the client: unhandled keystrokes will be treated as button presses.
  • There is room for 32 buttons [bits 0 through 31] however at most only 16 buttons can be simultaneously held down at any one time.
  • button_edges is computed using old an new button_levels between events, not between when the data arrives by network packet from the client. If the script is unable to process events fast enough then some rapid down-up or up-down edges may be lost.
  • 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]


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 button_levels, list button_edges, list axes );