View source for LlTakeControls/ja

{{Issues/SVC-3187}}{{LSL_Function/permission/ja|PERMISSION_TAKE_CONTROLS}}{{LSL_Function/ja
|func_id=111|func_sleep=0.0|func_energy=10.0
|sort=TakeControls|func=llTakeControls
|p1_type=integer|p1_name=controls|p1_desc=CONTROL_* フラグのビットフィールド
|p2_type=integer|p2_name=accept|p2_desc=真偽値。 {{LSLG/ja|control}} イベントが発生するかを指定します。
|p3_type=integer|p3_name=pass_on|p3_desc=真偽値。コントロールを操作不能にするかを指定します。
|func_footnote='''accept''' が {{LSLG/ja|FALSE}} で '''pass_on''' が {{LSLG/ja|FALSE}} の場合、指定したコントロールは通常通りにふるまい、他のコントロールは全て操作不能になります。<br />
'''accept''' が {{LSLG/ja|FALSE}} で '''pass_on''' が {{LSLG/ja|TRUE}} の場合、全てのコントロールは通常通りにふるまいます。<br />
'''accept''' が {{LSLG/ja|TRUE}} で '''pass_on''' が {{LSLG/ja|FALSE}} の場合、指定したコントロールは操作不能となり (しかし {{LSLG/ja|control}} イベントは発生する) 、他のコントロールは全て通常通りにふるまいます。<br />
'''accept''' が {{LSLG/ja|TRUE}} で '''pass_on''' が {{LSLG/ja|TRUE}} の場合、指定したコントロールは {{LSLG/ja|control}} イベントを発生させ、全てのコントロールは通常通りふるまいます。
|func_desc=スクリプトが権限をもつエージェントのキーボードやマウスのクリックを、具体的には '''controls''' で指定したものを、傍受させます。
|return_text
|spec
|caveats
|constants={{LSL_Constants/Controls/ja}}
|examples=<source lang="lsl2">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 |
                            0, TRUE, TRUE);
                            // | 0 は編集上の都合で、
                            // マスクを変更することはありません
        }
    }
    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]));
    }
}</source>
|helpers
|also_functions={{LSL DefineRow||{{LSLG/ja|llReleaseControls}}}}
|also_events={{LSL DefineRow||{{LSLG/ja|control}}}}
|also_articles
|also_tests
|notes=スクリプトがコントロールを取得すると、そのスクリプトや、同じプリムに入っている他のスクリプトは、エージェントが「スクリプト禁止」の土地に入っても停止しません。これは、乗り物のコントロールを動作させ、 AO を機能させるためにあります。これは、意図した仕様です。
|cat1=Controls
|cat2
|cat3
|cat4
}}