View source for LlTakeControls

{{Issues/SVC-3187}}{{LSL_Function/permission|PERMISSION_TAKE_CONTROLS}}{{LSL_Function
|func_id=111|func_sleep=0.0|func_energy=10.0
|sort=TakeControls|func=llTakeControls
|p1_type=integer|p1_name=controls|p1_desc=bitfield of CONTROL_* flags
|p2_type=integer|p2_name=accept|p2_desc=boolean, determines whether [[control]] events are generated
|p3_type=integer|p3_name=pass_on|p3_desc=boolean, determines whether controls perform their normal functions
|func_footnote=If '''accept''' is [[FALSE]] and '''pass_on''' is [[FALSE]], behavior is not intuitive.  In this case, the complement of the specified controls do not generate events and do not perform their normal functions. They are effectively disabled.  Certain control bits (e.g. CONTROL_ROT_LEFT) are also disabled when specified, in this case.<br />
If '''accept''' is [[FALSE]] and '''pass_on''' is [[TRUE]], then the specified controls do not generate events but perform their normal functions.<br/>
If '''accept''' is [[TRUE]] and '''pass_on''' is [[FALSE]], then the specified controls generate events but do not perform their normal functions.<br />
If '''accept''' is [[TRUE]] and '''pass_on''' is [[TRUE]], then the specified controls generate events and perform their normal functions.
|func_desc=Allows for intercepting of keyboard and mouse clicks, specifically those specified by '''controls''', from the agent the script has permissions for.
|return_text
|spec
|caveats
|constants={{LSL_Constants/Controls}}
|examples=<lsl>default
{
    state_entry()
    {
        llRequestPermissions(llGetOwner(), PERMISSION_TAKE_CONTROLS);
    }
    run_time_permissions(integer perm)
    {
        if(PERMISSION_TAKE_CONTROLS & perm)
        {
            llTakeControls(
                            CONTROL_FWD |
                            CONTROL_BACK |
                            CONTROL_LEFT |
                            CONTROL_RIGHT |
                            CONTROL_ROT_LEFT |
                            CONTROL_ROT_RIGHT |
                            CONTROL_UP |
                            CONTROL_DOWN |
                            CONTROL_LBUTTON |
                            CONTROL_ML_LBUTTON ,
                            TRUE, TRUE);
                           
        }
    }
    control(key id, integer level, integer edge)
    {
        integer start = level & edge;
        integer end = ~level & edge;
        integer held = level & ~edge;
        integer untouched = ~(level | edge);
        llOwnerSay(llList2CSV([level, edge, start, end, held, untouched]));
    }
}</lsl>
|helpers
|also_functions={{LSL DefineRow||[[llReleaseControls]]}}
|also_events={{LSL DefineRow||[[control]]}}
|also_articles
|also_tests
|notes=If a script has taken controls, it and other scripts in the same prim will not be stopped if the Agent enters a "No Outside Scripts" parcel. This is done to keep vehicle control alive and AOs functional. This is an intentional feature. 
|cat1=Controls
|cat2
|cat3
|cat4
}}