Difference between revisions of "LlTakeControls/ja"

Latest revision as of 05:30, 25 February 2016

関数 | イベント | 型 | 演算子 | 定数 | 実行制御 | スクリプトライブラリ | カテゴリ別スクリプトライブラリ | チュートリアル

関数: llTakeControls( integer controls, integer accept, integer pass_on );


111	関数ID
0.0	遅延
10.0	エネルギー

スクリプトが権限をもつエージェントのキーボードやマウスのクリックを、具体的には controls で指定したものを、傍受させます。

• integer	controls	–	CONTROL_* フラグのビットフィールド
• integer	accept	–	真偽値。 control イベントが発生するかを指定します。
• integer	pass_on	–	真偽値。コントロールを操作不能にするかを指定します。

実行するには、llRequestPermissions による PERMISSION_TAKE_CONTROLS 権限が必要です。 accept が FALSE で pass_on が FALSE の場合、指定したコントロールは通常通りにふるまい、他のコントロールは全て操作不能になります。
accept が FALSE で pass_on が TRUE の場合、全てのコントロールは通常通りにふるまいます。
accept が TRUE で pass_on が FALSE の場合、指定したコントロールは操作不能となり (しかし control イベントは発生する) 、他のコントロールは全て通常通りにふるまいます。
accept が TRUE で pass_on が TRUE の場合、指定したコントロールは control イベントを発生させ、全てのコントロールは通常通りふるまいます。

定数	値	説明
CONTROL_FWD	0x00000001	前進 (↑ か W)
CONTROL_BACK	0x00000002	後進 (↓ か S)
CONTROL_LEFT	0x00000004	左移動 (⇧ Shift-← か ⇧ Shift-A [マウスルックならば ← か A])
CONTROL_RIGHT	0x00000008	右移動 (⇧ Shift-→ か ⇧ Shift-D [マウスルックならば → か D])
CONTROL_ROT_LEFT	0x00000100	左回転 (← か A)
CONTROL_ROT_RIGHT	0x00000200	右回転 (→ か D)
CONTROL_UP	0x00000010	上昇 (PgUp か E)
CONTROL_DOWN	0x00000020	下降 (PgDn か C)
CONTROL_LBUTTON	0x10000000	マウス左クリック
CONTROL_ML_LBUTTON	0x40000000	マウスルック中のマウス左クリック
(undocumented)	0x02000000	Avatar left rotation detected. Triggers llGetAnimation == "Turning Left"
(undocumented)	0x04000000	Avatar right rotation detected. Triggers llGetAnimation == "Turning Right"

警告

権限の自動付与に頼らないようにしましょう。常に run_time_permissions イベントを使用しましょう。
スクリプトに PERMISSION_TAKE_CONTROLS の権限が不足していると、スクリプトはエラーを DEBUG_CHANNEL で叫び、操作に失敗します (しかしスクリプトは処理を続けます)。
PERMISSION_TAKE_CONTROLS 権限が付与された後は、スクリプトの中で (llReleaseControls か、新しい llRequestPermissions の呼び出しにより)、もしくはユーザがビューワから「キー制御を解除」を選択することで、権限をはく奪することができます。そうでなければ、スクリプトはオブジェクトが derez (削除、取り外し、取り込み) されない限り権限が失われません。

サンプル

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]));
    }
}

注意点

スクリプトがコントロールを取得すると、そのスクリプトや、同じプリムに入っている他のスクリプトは、エージェントが「スクリプト禁止」の土地に入っても停止しません。これは、乗り物のコントロールを動作させ、 AO を機能させるためにあります。これは、意図した仕様です。

特記事項

All Issues

~ Search JIRA for related Issues

SVC-3187

A

llTakeControls overrides existing controls

Signature
function void llTakeControls( integer controls, integer accept, integer pass_on );

この翻訳は原文と比べて古いですか？間違いがありますか？読みにくいですか？みんなで修正していきましょう！ (手順はこちら)

この項目はあなたにとって参考にならない項目ですか？もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。

@@ Line 1: / Line 1: @@
-{{multi-lang}}{{LSL_Function/permission/ja|PERMISSION_TAKE_CONTROLS}}{{LSL_Function/ja
+{{Issues/SVC-3187}}{{LSL_Function/permission/ja|PERMISSION_TAKE_CONTROLS}}{{LSL_Function/ja
-|func_id=111
+|func_id=111|func_sleep=0.0|func_energy=10.0
-|func_sleep=0.0
+|sort=TakeControls|func=llTakeControls
-|func_energy=10.0
+|p1_type=integer|p1_name=controls|p1_desc=CONTROL_* フラグのビットフィールド
-|sort=TakeControls
+|p2_type=integer|p2_name=accept|p2_desc=真偽値。 {{LSLG/ja|control}} イベントが発生するかを指定します。
-|func=llTakeControls
+|p3_type=integer|p3_name=pass_on|p3_desc=真偽値。コントロールを操作不能にするかを指定します。
-|p1_type=integer
+|func_footnote='''accept''' が {{LSLG/ja|FALSE}} で '''pass_on''' が {{LSLG/ja|FALSE}} の場合、指定したコントロールは通常通りにふるまい、他のコントロールは全て操作不能になります。<br />
-|p1_name=controls
+'''accept''' が {{LSLG/ja|FALSE}} で '''pass_on''' が {{LSLG/ja|TRUE}} の場合、全てのコントロールは通常通りにふるまいます。<br />
-|p2_type=integer
+'''accept''' が {{LSLG/ja|TRUE}} で '''pass_on''' が {{LSLG/ja|FALSE}} の場合、指定したコントロールは操作不能となり (しかし {{LSLG/ja|control}} イベントは発生する) 、他のコントロールは全て通常通りにふるまいます。<br />
-|p2_name=accept
+'''accept''' が {{LSLG/ja|TRUE}} で '''pass_on''' が {{LSLG/ja|TRUE}} の場合、指定したコントロールは {{LSLG/ja|control}} イベントを発生させ、全てのコントロールは通常通りふるまいます。
-|p3_type=integer
+|func_desc=スクリプトが権限をもつエージェントのキーボードやマウスのクリックを、具体的には '''controls''' で指定したものを、傍受させます。
-|p3_name=pass_on
-|func_footnote
-|func_desc=タスクに許される範囲で、エージェントのコントロールを横取りします。acceptがcontrolsと入力のビット演算結果と同一の場合、入力はタスクに送られます。'''pass_on'''が[[TRUE/ja|TRUE]]の場合、エージェントにも送られます。
 |return_text
 |spec
 |caveats
 |constants={{LSL_Constants/Controls/ja}}
-|examples
+|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 |
+, 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||[[llReleaseControls/ja|llReleaseControls]]}}
+|also_functions={{LSL DefineRow||{{LSLG/ja|llReleaseControls}}}}
-|also_events={{LSL DefineRow||[[control/ja|control]]}}
+|also_events={{LSL DefineRow||{{LSLG/ja|control}}}}
 |also_articles
 |also_tests
-|notes=スクリプトがコントロールを取得した場合、エージェントがスクリプト禁止領域に入ってもスクリプトは停止しないでしょう。これは、乗り物のコントロールを有効なままにするためには、とりあえず妥当と言えます。同様に、AOもスクリプト禁止領域に入っても停止しないことになりますが、こちらはバグなのか意図的なものなのかははっきりしません。
+|notes=スクリプトがコントロールを取得すると、そのスクリプトや、同じプリムに入っている他のスクリプトは、エージェントが「スクリプト禁止」の土地に入っても停止しません。これは、乗り物のコントロールを動作させ、 AO を機能させるためにあります。これは、意図した仕様です。
-|cat1=Controls/ja
+|cat1=Controls
 |cat2
 |cat3
 |cat4
 }}

Difference between revisions of "LlTakeControls/ja"

Latest revision as of 05:30, 25 February 2016

Contents

要約

警告

サンプル

注意点

関連項目

イベント

関数

記事

特記事項

All Issues

Signature

Navigation menu

Search

•	run_time_permissions	–	権限取得イベント
•	control

•	llGetPermissions	–	付与されている権限を取得します
•	llGetPermissionsKey	–	権限を許可したエージェントを取得します
•	llRequestPermissions	–	権限を要求します
•	llReleaseControls