Second Life Wiki - User contributions [en]

Phantom Child

2013-12-25T12:20:45Z

CharlieA Nightfire:

{{Multi-lang|Phantom Child}}
{{LSL Header}}
{{LSL Tip|The examples listed below are '''NOT NEEDED''' anymore. This page is being kept for archiving purposes. Instead please set the [[PRIM_PHYSICS_SHAPE_TYPE]] to [[PRIM_PHYSICS_SHAPE_NONE]] for all child prims you want to set a phantom effect for.}}
= Phantom Child =

This easy to use code when put into a child prim of a linkset will make that child and only that child phantom, even when taken into inventory and re-rezzed. You can use multiple copies of this script to make multiple children of a linkset phantom.

This code relies on a bug in Second Life and may not function in later versions (Currently working in server 1.36). This script was created in part by [[User:Aeron Kohime|Aeron Kohime]] and documents this useful bug (which like invis-prims, has countless applications).

You may use the following script in any manner you like, excluding claiming you made it and individually reselling it without change in function (its on the Wiki silly). Otherwise you can sell it as part of a product, modify it, remove my comments, etc etc.

It needs to be reset on sim restarts. A reliable solution is included in all these scripts. Checking [[llGetTime]] and a timer could be used but, is a more "expensive" method.

== Basic ==

<lsl>//Phantom Child Script by Aeron Kohime
//WARNING: When used on the root prim it makes the entire object phantom, it
// also does not function correctly on tortured prims. (Sorry.)
//Reset on Sim restart added by Void Singer
//Strife Onizuka was here doing simplification
//Reset on collision added by Taff Nouvelle (my stairs kept reverting)
//Psi Merlin updated CHANGED_REGION_START (live as of Server 1.27)
//New function code added by Taff Nouvelle December 15th.

default {
state_entry() {
llSetPrimitiveParams([PRIM_TYPE, PRIM_TYPE_BOX,
0, <0,1,0>, 0, <0,0,0>, <1,1,0>, <0,0,0>,
PRIM_FLEXIBLE, TRUE, 0, 0, 0, 0, 0, <0,0,0>,
PRIM_TYPE] + llGetPrimitiveParams([PRIM_TYPE]));
}

on_rez(integer s) {
llResetScript();
}

//-- This event/test will reset the script on sim restart.
changed (integer vBitChanges){
if (CHANGED_REGION_START & vBitChanges){
llResetScript();
}
}
collision_start(integer num_detected){
llResetScript();

}
}</lsl>

== Switchable ==

Addition to the above script, a switchable version that could be useful for a phantom door.

<lsl>//Phantom Child Script by Aeron Kohime
//WARNING: When used on the root prim it makes the entire object phantom, it
// also does not function correctly on tortured prims. (Sorry.)
//Reset on Sim restart added by Void Singer
//Strife Onizuka was here doing simplification
//Phantom door idea added by Taff Nouvelle
//Psi Merlin updated CHANGED_REGION_START (live as of Server 1.27)

integer a = 1;

default
{
state_entry()
{
}
touch_start(integer total_number)
{
a*=-1;
if(a == 1)
{
llSetPrimitiveParams([PRIM_TYPE, PRIM_TYPE_BOX,
0, <0,1,0>, 0, <0,0,0>, <1,1,0>, <0,0,0>,
PRIM_FLEXIBLE, TRUE, 0, 0, 0, 0, 0, <0,0,0>,
PRIM_TYPE] + llGetPrimitiveParams([PRIM_TYPE]));
llOwnerSay ("Phantom");
}
else
{
llSetPrimitiveParams([PRIM_PHANTOM, FALSE]);
llOwnerSay ("Solid");
}
}
on_rez(integer s) {
llResetScript();
}
changed (integer vBitChanges){
if (CHANGED_REGION_START & vBitChanges){
llResetScript();
}
}
}</lsl>

== New Functions ==

New functions brought in with MESH now make setting a child prim to phantom very simple.
This can be applied to any number of prims in the linkset, but not the root prim.

<lsl>
default
{
state_entry()
{
llSetLinkPrimitiveParamsFast(LINK_THIS,[ PRIM_PHYSICS_SHAPE_TYPE,PRIM_PHYSICS_SHAPE_NONE]);
}
}
</lsl>

== Advanced ==

Unlike the versions above, this version will work with ANY prim type (torus, tube, box, sculpt etc.) with ANY shaping parameters (twist, hollow, taper, slice, dimple etc.) and ANY texturing applied (glow, texture, fullbright, color etc.) without changing those parameters. In other words... This version works in ALL cases without error (At least I'm pretty sure it does ). The downside being a greater memory use and slower run time (Although this is negligible) for complex (tortured) prims. Should only be used on child prims.

<lsl>list PRIM_PHANTOM_HACK = [
PRIM_FLEXIBLE, 1, 0, 0.0, 0.0, 0.0, 0.0, <0,0,0>,
PRIM_FLEXIBLE, 0, 0, 0.0, 0.0, 0.0, 0.0, <0,0,0>];

list Params()
{
list result = [];
integer i = 0;
integer face = 0;
list src = llGetPrimitiveParams([PRIM_TEXTURE, ALL_SIDES]);
integer len = llGetListLength(src);
do
{
result += [PRIM_TEXTURE, face] + llList2List(src, i, (i + 3));
face++;
i += 4;
}
while(i < len);

i = 0;
face = 0;
src = llGetPrimitiveParams([PRIM_COLOR, ALL_SIDES]);
len = llGetListLength(src);
do
{
result += [PRIM_COLOR, face] + llList2List(src, i, (i + 1));
face++;
i += 2;
}
while(i < len);

i = 0;
face = 0;
src = llGetPrimitiveParams([PRIM_BUMP_SHINY, ALL_SIDES]);
len = llGetListLength(src);
do
{
result += [PRIM_BUMP_SHINY, face] + llList2List(src, i, (i + 1));
face++;
i += 2;
}
while(i < len);

i = 0;
face = 0;
src = llGetPrimitiveParams([PRIM_FULLBRIGHT, ALL_SIDES]);
len = llGetListLength(src);
do
{
result += [PRIM_FULLBRIGHT, face] + llList2List(src, i, i);
face++;
i++;
}
while(i < len);
i = 0;
face = 0;
src = llGetPrimitiveParams([PRIM_TEXGEN, ALL_SIDES]);
len = llGetListLength(src);
do
{
result += [PRIM_TEXGEN, face] + llList2List(src, i, i);
face++;
i++;
}
while(i < len);

i = 0;
face = 0;
src = llGetPrimitiveParams([PRIM_GLOW, ALL_SIDES]);
len = llGetListLength(src);
do
{
result += [PRIM_GLOW, face] + llList2List(src, i, i);
face++;
i++;
}
while(i < len);

return result;
}

default
{
state_entry()
{
list type_params = llGetPrimitiveParams([PRIM_TYPE]);
integer type = llList2Integer(type_params, 0);
if(type > PRIM_TYPE_PRISM)
{
// After prism comes sphere, torus, tube, ring and sculpt.
if(type != PRIM_TYPE_SCULPT)
type_params += Params();

llSetPrimitiveParams([PRIM_TYPE, PRIM_TYPE_BOX, PRIM_HOLE_DEFAULT, <0,1,0>, 0, <0,0,0>, <1,1,0>, <0,0,0>]
+ PRIM_PHANTOM_HACK
+ [PRIM_TYPE] + type_params);
}
else
{
llSetPrimitiveParams(PRIM_PHANTOM_HACK);
}
}
changed(integer change)
{
if(change & CHANGED_REGION_START)
llResetScript();
}
on_rez(integer param)
{
llResetScript();
}
collision_start(integer nd)
{
llResetScript();
}
}
</lsl>

==Sculpted Children==
A modified version of above that will go through all the prims in a linkset and turn only the sculpts phantom. [[User:ninjafoo Ng|ninjafoo Ng]]
<lsl>
// Makes all child sculpted prims phantom, leaves all regular prims alone.

list PRIM_PHANTOM_HACK = [
PRIM_FLEXIBLE, 1, 0, 0.0, 0.0, 0.0, 0.0, <0,0,0>,
PRIM_FLEXIBLE, 0, 0, 0.0, 0.0, 0.0, 0.0, <0,0,0>];

integer get_number_of_prims()
{//ignores avatars.
integer a = llGetNumberOfPrims();
//Mono tweak
vector size = llGetAgentSize(llGetLinkKey(a));
while(size.z > 0)
{
--a;
size = llGetAgentSize(llGetLinkKey(a));
}
return a;
}

default
{
state_entry()
{
integer num_prims = get_number_of_prims();
integer x;
list prim_params;
integer prim_type;

for(x=2;x<=num_prims;++x)
{
prim_params = llGetLinkPrimitiveParams(x,[PRIM_TYPE]);
prim_type = llList2Integer(prim_params, 0);
if(prim_type == PRIM_TYPE_SCULPT) {
llSetLinkPrimitiveParamsFast(x,
[PRIM_TYPE, PRIM_TYPE_BOX, PRIM_HOLE_DEFAULT, <0,1,0>, 0, <0,0,0>, <1,1,0>, <0,0,0>]
+ PRIM_PHANTOM_HACK
+ [PRIM_TYPE] + prim_params
);
}
}
}
changed (integer vBitChanges){
if (CHANGED_REGION_START & vBitChanges){
llResetScript();
}
}
}
</lsl>

{{LSLC|Library}}
{{LSLC|Examples}}

Phantom Child/ja

2013-12-25T12:18:34Z

CharlieA Nightfire:

{{Multi-lang|Phantom Child}}
{{LSL Header}}
{{LSL Tip|下のスクリプトはもう'''必要ありません'''。このページは記録のために残しています。代わりに、ファントム効果をつけたい子プリム全部の {{LSLG/ja|PRIM_PHYSICS_SHAPE_TYPE}} を {{LSLG/ja|PRIM_PHYSICS_SHAPE_NONE}} に設定してください。}}

= Phantom Child (子プリムのファントム化)抜粋 =

<lsl>default {
state_entry() {
llSetPrimitiveParams([PRIM_FLEXIBLE, TRUE, 0,0,0,0,0,<0,0,0>]);
}
on_rez(integer s) {
llResetScript();
}
changed (integer change){
if (CHANGED_REGION_START & change)
llResetScript();
}
collision_start(integer n){
llResetScript();
}
}</lsl>

Phantom Child/ja

2013-12-25T12:08:46Z

CharlieA Nightfire: Created page with "{{LSL Header}} {{LSL Tip|下のスクリプトはもう'''必要ありません'''。このページは記録のために残しています。代わりに、ファントム効果…"

{{LSL Header}}
{{LSL Tip|下のスクリプトはもう'''必要ありません'''。このページは記録のために残しています。代わりに、ファントム効果をつけたい子プリム全部の {{LSLG/ja|PRIM_PHYSICS_SHAPE_TYPE}} を {{LSLG/ja|PRIM_PHYSICS_SHAPE_NONE}} に設定してください。}}

= Phantom Child (子プリムのファントム化)抜粋 =

<lsl>default {
state_entry() {
llSetPrimitiveParams([PRIM_FLEXIBLE, TRUE, 0,0,0,0,0,<0,0,0>]);
}
on_rez(integer s) {
llResetScript();
}
changed (integer change){
if (CHANGED_REGION_START & change)
llResetScript();
}
collision_start(integer n){
llResetScript();
}
}</lsl>

PRIM PHYSICS SHAPE TYPE/ja

2013-12-25T10:30:44Z

CharlieA Nightfire:

<onlyinclude>{{#if:

{{#vardefine:physics_shape_type_const|{{LSL Const/ja|PRIM_PHYSICS_SHAPE_TYPE|integer|30|c=プリムの物理形状タイプを{{GetSet|{{{1|}}}|取得|設定|/}}するのに用いられます。}}}}

{{#vardefine:p_pstype_desc|PRIM_PHYSICS_SHAPE_* flag}}
{{#vardefine:p_pstype_hover|PRIM_PHYSICS_SHAPE_* flag (もちろんPRIM_PHYSICS_SHAPE_TYPEではありません!)}}

{{#vardefine:physics_shape_type_rows|
!{{!}} {{LSL Param/ja|pstype|type}}フラグ
! title="value" {{!}} 値
! colspan="3" {{!}} 説明
! colspan="3" {{!}} ノート
{{!}}-
{{!}} {{LSL Const/ja|PRIM_PHYSICS_SHAPE_PRIM|integer|0|c=ノーマルプリム形状の物理に使います}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} メッシュでないオブジェクトのデフォルト値です
{{!}}-
{{!}} {{LSL Const/ja|PRIM_PHYSICS_SHAPE_CONVEX|integer|2|c=プリムの凸包形状の物理に使います}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} メッシュオブジェクトのデフォルト値です
{{!}}-
{{!}} {{LSL Const/ja|PRIM_PHYSICS_SHAPE_NONE|integer|1|c=プリムの物理形状を無視します}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} これをルートプリム、アバターに適用することはできません
このプリムは、他のオブジェクトやアバターが衝突せずに通り抜けます("ファントム"のように)
}}

}}</onlyinclude>{{#if:

}}{{LSL Constant/ja
|name=PRIM_PHYSICS_SHAPE_TYPE
|type=integer
|value=30
|desc=物理エンジンで使われるオブジェクトの形状タイプを設定するために使われます。
|examples
|constants
|pa={{LSL Constant/List|i_front=[ {{#var:physics_shape_type_const}}, |i_end= ]
|text={{LSLG/ja|llSetPrimitiveParams}}と{{LSLG/ja|llSetLinkPrimitiveParams}}で使われます
|i1_type=integer|i1_name=pstype|i1_disp=type
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:physics_shape_type_const}} ]);|
|r_front=[[list]] [ |r_end= ]を返します
|text
|toc=llGetPrimitiveParams
|r1_type=integer|r1_name=pstype|r1_disp=type
}}
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:physics_shape_type_rows}}
{{!}}}
|functions=
{{LSL DefineRow||{{LSLG/ja|llGetPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llGetLinkPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llSetPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llSetLinkPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llSetLinkPrimitiveParamsFast}}|}}
|events
|location
|history=
*Introduced in [[Release Notes/Second Life RC LeTigre/11#11.09.09.240509|Second Life RC LeTigre 11.09.09.240509]], September 9, 2011
*[http://www.sluniverse.com/php/vb/scripting/61203-future-physics-functions-tease.html#post1305775 SLUniverse:Future physics functions tease]
|cat1=Prim
|cat2=Physics
|cat3
|cat4
}}

PRIM PHYSICS SHAPE TYPE

2013-12-25T10:29:02Z

CharlieA Nightfire:

<onlyinclude>{{#if:

{{#vardefine:physics_shape_type_const|{{LSL Const|PRIM_PHYSICS_SHAPE_TYPE|integer|30|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's physics shape type}}}}

{{#vardefine:p_pstype_desc|PRIM_PHYSICS_SHAPE_* flag}}
{{#vardefine:p_pstype_hover|PRIM_PHYSICS_SHAPE_* flag (not PRIM_PHYSICS_SHAPE_TYPE of course!)}}

{{#vardefine:physics_shape_type_rows|
!{{!}} {{LSLPT|pstype|type}} Flags
! title="value" {{!}} V
! colspan="3" {{!}} Description
! colspan="3" {{!}} Notes
{{!}}-
{{!}} {{LSL Const|PRIM_PHYSICS_SHAPE_PRIM|integer|0|c=Use the normal prim shape for physics}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} default for all non-mesh objects
{{!}}-
{{!}} {{LSL Const|PRIM_PHYSICS_SHAPE_CONVEX|integer|2|c=Use the convex hull of the prim shape for physics}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} default for all mesh objects
{{!}}-
{{!}} {{LSL Const|PRIM_PHYSICS_SHAPE_NONE|integer|1|c=Ignore this prim in the physics shape. }}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} ''This cannot be applied to the root prim or avatars.''
This prim lets other objects and avatars pass through without colliding. (Like "Phantom")
}}

{{LSL Signature/Add|{{LSL Const/Signature|PRIM_PHYSICS_SHAPE_PRIM|integer|0|c=Use the normal prim shape for physics}}
{{LSL Const/Signature|PRIM_PHYSICS_SHAPE_CONVEX|integer|2|c=Use the convex hull of the prim shape for physics}}}}

}}</onlyinclude>{{#if:

}}{{LSL Constant
|name=PRIM_PHYSICS_SHAPE_TYPE
|type=integer
|value=30
|desc=Used to set the type of shape the physics engine should use for the object.
|examples
|constants
|pa={{LSL Constant/List|i_front=[ {{#var:physics_shape_type_const}}, |i_end= ]
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]]
|i1_type=integer|i1_name=pstype|i1_disp=type
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:physics_shape_type_const}} ]);|
|r_front=Returns the [[list]] [ |r_end= ]
|text
|toc=llGetPrimitiveParams
|r1_type=integer|r1_name=pstype|r1_disp=type
}}
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:physics_shape_type_rows}}
{{!}}}
|functions=
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParamsFast]]|}}
|events
|location
|history=
*Introduced in [[Release Notes/Second Life RC LeTigre/11#11.09.09.240509|Second Life RC LeTigre 11.09.09.240509]], September 9, 2011
*[http://www.sluniverse.com/php/vb/scripting/61203-future-physics-functions-tease.html#post1305775 SLUniverse:Future physics functions tease]
|cat1=Physics
|cat2
}}

PRIM PHYSICS SHAPE TYPE/ja

2013-12-25T10:24:51Z

CharlieA Nightfire:

<onlyinclude>{{#if:

{{#vardefine:physics_shape_type_const|{{LSL Const/ja|PRIM_PHYSICS_SHAPE_TYPE|integer|30|c=プリムの物理形状タイプを{{GetSet|{{{1|}}}|取得|設定|/}}するのに用いられます。}}}}

{{#vardefine:p_pstype_desc|PRIM_PHYSICS_SHAPE_* flag}}
{{#vardefine:p_pstype_hover|PRIM_PHYSICS_SHAPE_* flag (もちろんPRIM_PHYSICS_SHAPE_TYPEではありません!)}}

{{#vardefine:physics_shape_type_rows|
!{{!}} {{LSL Param/ja|pstype|type}}フラグ
! title="value" {{!}} 値
! colspan="3" {{!}} 説明
! colspan="3" {{!}} ノート
{{!}}-
{{!}} {{LSL Const/ja|PRIM_PHYSICS_SHAPE_PRIM|integer|0|c=ノーマルプリム形状の物理に使います}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} メッシュでないオブジェクトのデフォルト値です
{{!}}-
{{!}} {{LSL Const/ja|PRIM_PHYSICS_SHAPE_CONVEX|integer|2|c=プリムの凸包形状の物理に使います}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} メッシュオブジェクトのデフォルト値です
{{!}}-
{{!}} {{LSL Const/ja|PRIM_PHYSICS_SHAPE_NONE|integer|1|c=プリムの物理形状を無視します}}
{{!}} {{#var:value}}
{{!}} colspan="3" {{!}} {{#var:comment}}
{{!}} colspan="3" {{!}} これをルートプリム、アバターに適用することはできません
このプリムは、他のオブジェクトやアバターが衝突せずに通り抜けます
}}

}}</onlyinclude>{{#if:

}}{{LSL Constant/ja
|name=PRIM_PHYSICS_SHAPE_TYPE
|type=integer
|value=30
|desc=物理エンジンで使われるオブジェクトの形状タイプを設定するために使われます。
|examples
|constants
|pa={{LSL Constant/List|i_front=[ {{#var:physics_shape_type_const}}, |i_end= ]
|text={{LSLG/ja|llSetPrimitiveParams}}と{{LSLG/ja|llSetLinkPrimitiveParams}}で使われます
|i1_type=integer|i1_name=pstype|i1_disp=type
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:physics_shape_type_const}} ]);|
|r_front=[[list]] [ |r_end= ]を返します
|text
|toc=llGetPrimitiveParams
|r1_type=integer|r1_name=pstype|r1_disp=type
}}
|pc=
{{{!}} class="sortable" {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{#var:physics_shape_type_rows}}
{{!}}}
|functions=
{{LSL DefineRow||{{LSLG/ja|llGetPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llGetLinkPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llSetPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llSetLinkPrimitiveParams}}|}}
{{LSL DefineRow||{{LSLG/ja|llSetLinkPrimitiveParamsFast}}|}}
|events
|location
|history=
*Introduced in [[Release Notes/Second Life RC LeTigre/11#11.09.09.240509|Second Life RC LeTigre 11.09.09.240509]], September 9, 2011
*[http://www.sluniverse.com/php/vb/scripting/61203-future-physics-functions-tease.html#post1305775 SLUniverse:Future physics functions tease]
|cat1=Prim
|cat2=Physics
|cat3
|cat4
}}

LlGetRegionAgentCount/ja

2013-04-01T09:14:54Z

CharlieA Nightfire:

{{LSL_Function/ja
|func_id=334|func_sleep=0.0|func_energy=10.0
|func=llGetRegionAgentCount
|return_type=integer
|return_text=リージョン内のアバターの数
|caveats
|examples=<lsl>//タッチするとオーナーに地域にいるアバターの数をお知らせします
default
{
touch_start(integer count)
{
llOwnerSay((string)llGetRegionAgentCount());
}
}</lsl>
|spec
|caveats=
* この関数が返す値は、技術的にその地域にいたアバターの過去1秒間の平均を整数でまるめたもの。したがって、アバターの地域への出入りがあるときは、アバターを数えた結果に少し遅れ(1秒未満)があります。
|constants
|helpers
|also_functions=
{{LSL DefineRow||{{LSLG/ja|llGetAgentList}}}}
{{LSL DefineRow||{{LSLG/ja|llGetRegionFPS}}}}
{{LSL DefineRow||{{LSLG/ja|llGetRegionTimeDilation}}}}
|also_tests
|also_events
|also_articles
|notes
|history={{SVN|568|rev=88085|branch=Release|anchor=file33|date=Wednesday, 21 May 2008}}で導入。
|cat1=Region
|cat2
|cat3
|cat4
}}

LlGetAgentList/ja

2013-04-01T08:40:53Z

CharlieA Nightfire:

{{LSL_Function/ja
|inject-2={{Issues/SCR-311}}{{Issues/SVC-5488}}{{Issues/MISC-243}}{{Issues/SCR-370}}{{Issues/SCR-371}}
|func=llGetAgentList
|sort=GetAgentList
|func_id
|func_sleep=0
|func_energy=0
|func_desc=現在その地域にいるアバターのリストを問合せます、scopeパラメタで制限
|func_footnote=
|return_type=list
|return_text=<code><nowiki>[</nowiki>{{LSLG/ja|key}} {{HoverText|id0|First agent key}}, {{LSLG/ja|key}} {{HoverText|id1|Second agent key}}, ..., {{LSLG/ja|key}} {{HoverText|idn|nᵗʰ agent key}}]</code> または <code><nowiki>[</nowiki>{{LSLG/ja|string}} {{HoverText|error_msg|An error message}}]</code> - その地域内の、scopeで指定された区画にいる全アバターのキー
|spec=
|p1_type=integer|p1_name=scope|p1_hover=AGENT_LIST_* 選択する範囲を指定するフラグ|p1_desc=<span></span>
{{Collapsible_Table/Simple|title=AGENT_LIST_* 選択する範囲を指定するフラグ
|content={{!}}
* [[AGENT_LIST_PARCEL]] - スクリプトが走っている同じ区画にいるアバターだけを返します
* [[AGENT_LIST_PARCEL_OWNER]] - その地域にある区画で、スクリプトの入ってるオブジェクトがある区画と同じ所有者の区画全部にいるアバターだけを返します
* [[AGENT_LIST_REGION]] - その地域にいる全部のアバターを返します
}}
|p2_type=list|p2_name=options|p2_desc=未使用
|p2_hover=selection flags
|constants=
|caveats=
* 戻りリストの順番は意味を持ちません
* 100以下のアバターしか戻りません
|examples=
{{LSL Tip|アバターが同じSIMにいるかどうかチェックするには、 {{LSLG/ja|llGetAgentSize}} が {{LSLG/ja|ZERO_VECTOR}}を返さないことでチェックしてください。こちらのほうが [[llGetAgentList]] を呼び出してリスト内のキーと比較するよりずっと速くて簡単です。}}
{{LSL Tip|今のところ、この関数はoptionで制限できません。したがって、この関数は最大100のアバターのキーを返すかもしれません。これらのキーを保存するには大きなメモリー容量が必要で、STACK_HEAP_COLLISION_ERRORを起こすかもしれないことに注意してください。}}
<lsl>
//地域内で検出した最大100のアバターのキーと名前を表示

default
{
touch_start(integer total_number)
{
list avatarsInRegion = llGetAgentList(AGENT_LIST_REGION, []);
integer numOfAvatars = llGetListLength(avatarsInRegion);

// アバターがいないときは、リストアップはせずにお知らせ
if (!numOfAvatars)
{
llOwnerSay("この地域にアバターはみつかりません!");
return;
}

integer index;
while (index < numOfAvatars)
{
key id = llList2Key(avatarsInRegion, index);
string name = llKey2Name(id);

llOwnerSay(name + " [ " + (string)id + " ]");
++index;
}
}
}
</lsl>
<lsl>
// タッチで距離で並び替えた名前と距離を答える

default
{
touch_start(integer num_detected)
{
list keys = llGetAgentList(AGENT_LIST_REGION, []);
integer numberOfKeys = llGetListLength(keys);

vector currentPos = llGetPos();
list newkeys;
key thisAvKey;

integer i;
for (i = 0; i < numberOfKeys; ++i) {
thisAvKey = llList2Key(keys,i);
newkeys += [llRound(llVecDist(currentPos,
llList2Vector(llGetObjectDetails(thisAvKey, [OBJECT_POS]), 0))),
thisAvKey];
}

newkeys = llListSort(newkeys, 2, FALSE); // 距離の降順でストライドソート

for (i = 0; i < (numberOfKeys * 2); i += 2) {
llOwnerSay(llGetDisplayName(llList2Key(newkeys, i+1))
+" ["+ (string) llList2Integer(newkeys, i) + "m]");
}
}
}
</lsl>
|helpers
|also_header
|also_functions=*{{LSLG/ja|llGetRegionAgentCount}}
|also_tests
|also_events
|also_articles
|also_footer
|notes
|deprecated
|location
|history=
* LLによる新しい関数、 {{Jira|SVC-805}}, {{Jira|SVC-6427}}, {{Jira|MISC-243}}, {{Jira|SVC-5488}}によって提議された機能に対応。
* プレリリース [[Release_Notes/Second_Life_RC_Magnum/12]] - もとのJIRAの要望は「llGetRegionAgents()」でしたが、リリースされた関数はそれ以上の機能があるので名前は変更されました。
|cat1=Functions
|cat2=Avatar
|cat3=Owner
|cat4=Parcel
|cat5=Region
|cat6
}}

LlGetAgentList/ja

2013-04-01T08:32:28Z

CharlieA Nightfire: Created page with "{{LSL_Function/ja |inject-2={{Issues/SCR-311}}{{Issues/SVC-5488}}{{Issues/MISC-243}}{{Issues/SCR-370}}{{Issues/SCR-371}} |func=llGetAgentList |sort=GetAgentList |func_id |func_sl…"

{{LSL_Function/ja
|inject-2={{Issues/SCR-311}}{{Issues/SVC-5488}}{{Issues/MISC-243}}{{Issues/SCR-370}}{{Issues/SCR-371}}
|func=llGetAgentList
|sort=GetAgentList
|func_id
|func_sleep=0
|func_energy=0
|func_desc=現在その地域にいるアバターのリストを問合せます、scopeパラメタで制限
|func_footnote=
|return_type=list
|return_text=<code><nowiki>[</nowiki>{{LSLG/ja|key}} {{HoverText|id0|First agent key}}, {{LSLG/ja|key}} {{HoverText|id1|Second agent key}}, ..., {{LSLG/ja|key}} {{HoverText|idn|nᵗʰ agent key}}]</code> または <code><nowiki>[</nowiki>{{LSLG/ja|string}} {{HoverText|error_msg|An error message}}]</code> - その地域にいる全アバターのキー、scopeで指定された区画で制限して
|spec=
|p1_type=integer|p1_name=scope|p1_hover=AGENT_LIST_* 選択する範囲を指定するフラグ|p1_desc=<span></span>
{{Collapsible_Table/Simple|title=AGENT_LIST_* 選択する範囲を指定するフラグ
|content={{!}}
* [[AGENT_LIST_PARCEL]] - スクリプトが走っている同じ区画にいるアバターだけを返します
* [[AGENT_LIST_PARCEL_OWNER]] - その地域にある区画で、スクリプトの入ってるオブジェクトがある区画と同じ所有者の区画全部にいるアバターだけを返します
* [[AGENT_LIST_REGION]] - その地域にいる全部のアバターを返します
}}
|p2_type=list|p2_name=options|p2_desc=未使用
|p2_hover=selection flags
|constants=
|caveats=
* 戻りリストの順番は意味を持ちません
* 100以下のアバターしか戻りません
|examples=
{{LSL Tip|アバターが同じSIMにいるかどうかチェックするには、 {{LSLG/ja|llGetAgentSize}} が {{LSLG/ja|ZERO_VECTOR}}を返さないことでチェックしてください。こちらのほうが [[llGetAgentList]] を呼び出してリスト内のキーと比較するよりずっと速くて簡単です。}}
{{LSL Tip|今のところ、この関数はoptionで制限できません。したがって、この関数は最大100のアバターのキーを返すかもしれません。これらのキーを保存するには大きなメモリー容量が必要で、STACK_HEAP_COLLISION_ERRORを起こすかもしれないことに注意してください。}}
<lsl>
//地域内で検出した最大100のアバターのキーと名前を表示

default
{
touch_start(integer total_number)
{
list avatarsInRegion = llGetAgentList(AGENT_LIST_REGION, []);
integer numOfAvatars = llGetListLength(avatarsInRegion);

// アバターがいないときは、リストアップはせずにお知らせ
if (!numOfAvatars)
{
llOwnerSay("この地域にアバターはみつかりません!");
return;
}

integer index;
while (index < numOfAvatars)
{
key id = llList2Key(avatarsInRegion, index);
string name = llKey2Name(id);

llOwnerSay(name + " [ " + (string)id + " ]");
++index;
}
}
}
</lsl>
<lsl>
// タッチで距離で並び替えた名前と距離を答える

default
{
touch_start(integer num_detected)
{
list keys = llGetAgentList(AGENT_LIST_REGION, []);
integer numberOfKeys = llGetListLength(keys);

vector currentPos = llGetPos();
list newkeys;
key thisAvKey;

integer i;
for (i = 0; i < numberOfKeys; ++i) {
thisAvKey = llList2Key(keys,i);
newkeys += [llRound(llVecDist(currentPos,
llList2Vector(llGetObjectDetails(thisAvKey, [OBJECT_POS]), 0))),
thisAvKey];
}

newkeys = llListSort(newkeys, 2, FALSE); // 距離の降順でストライドソート

for (i = 0; i < (numberOfKeys * 2); i += 2) {
llOwnerSay(llGetDisplayName(llList2Key(newkeys, i+1))
+" ["+ (string) llList2Integer(newkeys, i) + "m]");
}
}
}
</lsl>
|helpers
|also_header
|also_functions=*{{LSLG/ja|llGetRegionAgentCount}}
|also_tests
|also_events
|also_articles
|also_footer
|notes
|deprecated
|location
|history=
* LLによる新しい関数、 {{Jira|SVC-805}}, {{Jira|SVC-6427}}, {{Jira|MISC-243}}, {{Jira|SVC-5488}}によって提議された機能に対応。
* プレリリース [[Release_Notes/Second_Life_RC_Magnum/12]] - もとのJIRAの要望は「llGetRegionAgents()」でしたが、リリースされた関数はそれ以上の機能があるので名前は変更されました。
|cat1=Functions
|cat2=Avatar
|cat3=Owner
|cat4=Parcel
|cat5=Region
|cat6
}}

LlStringLength/ja

2012-09-16T16:18:27Z

CharlieA Nightfire:

{{LSL_Function/ja
|func_id=128|func_sleep=0.0|func_energy=10.0
|func=llStringLength|return_type=integer|p1_type=string|p1_name=str
|func_footnote
|func_desc
|return_text='''str''' にある文字の数 (NULL文字をカウントしない) 
|spec
|caveats=
*末尾の文字のインデックス番号は文字列長と一致しません。
**文字のインデックスは 0 から始まります (先頭の文字のインデックスが 0 になります) 。
|constants
|examples=
<lsl>
// 前提:
// オブジェクト名: LSLWiki
// スクリプト名: _lslwiki

default
{
state_entry()
{
string HowLongAmI = "123";
integer strlen = llStringLength(HowLongAmI);
llOwnerSay( "'" + HowLongAmI + "' は " +(string) strlen + " 文字です。");
// オブジェクト LSLWiki のオーナーには以下のように表示されます。
// LSLWiki: '123' は 3 文字です。
}
}
</lsl>
----
<lsl>
integer getStringBytes(string msg){
string s = llEscapeURL(msg);
string t = (string)llParseString2List(s,["%"],[]);
return llStringLength(t) * 2 - llStringLength(s);
}
</lsl>
*複数バイト文字を含む文字列のバイト数を得る
:msg と s のバイト数を次のように書くと：
::mb(msgのバイト数) = nb(置き換わらないバイト数) + bb(置き換わる前のバイト数)
::sb(sのバイト数) = nb + ab(置き換わった後のバイト数)
:ここで、
::ab = bb * 3 (各1バイト例えば '#' は、置き換わって 3 バイトの "%23" に)
:なので、
::mb = sb - bb * 2
:s 中の置き換わった全部が "%xx"(x:0-9またはA-F) の形になっているので、bb = s の中の '%'の数
:'%' を数えるため、s から '%' を除いた文字列 t を作れば：
::bb = sb - tb(tのバイト数)
:(s を llParseString2List()で'%'を除きながらリストに分解して、型キャストでまた文字列に戻して t とします。)
:これで求める答は：
::mb = sb - (sb - tb) * 2 = tb * 2 - sb
*参考ブログ：
:http://snumaw.blogspot.jp/2009/01/lsl-lldialog.html
:http://jinko.slmame.com/e602732.html

|helpers
|also_functions={{LSL DefineRow||{{LSLG/ja|llGetListLength}}|}}
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=StringLength
|cat1=String
|cat2
|cat3
|cat4
}}

LlStringLength

2012-09-16T16:06:07Z

CharlieA Nightfire:

{{LSL_Function
|func_id=128|func_sleep=0.0|func_energy=10.0
|func=llStringLength|return_type=integer|p1_type=string|p1_name=str
|func_footnote
|func_desc
|return_text=that is the number of characters in '''str''' (not counting the null).
|spec
|caveats=
*The index of the last character is not equal to the string length.
**Character indexs start at zero (the index of the first character is zero).
|constants
|examples=
<lsl>
// assumptions:
// object name: LSLWiki
// script name: _lslwiki

default
{
state_entry()
{
string HowLongAmI = "123";
integer strlen = llStringLength(HowLongAmI);
llOwnerSay( "'" + HowLongAmI + "' has " +(string) strlen + " characters.");
// The owner of object LSLWiki will hear
// LSLWiki: '123' has 3 characters.
}
}

</lsl>
<hr>
*LSL-2 sees all strings as UTF8
*LSL-Mono sees all string as UTF16
*llStringLength gets the number of characters
*Both UTF8 and UTF16 use multibyte characters
*Some communication functions (i.e. llHTTPResponse) are limited by number of Bytes, and work with UTF8 strings
<lsl>
integer UTF8Length(string msg)
{
//Returns the number of BYTES a string will have when converted to UTF8 by communication functions
//Simple and efficient!
//Released to the public domain by kimmie Loveless
integer rNum = llStringLength(msg);
return rNum + ((llStringLength(llEscapeURL(msg)) - rNum)/4);
}
</lsl>
----
<lsl>
integer getStringBytes(string msg) {
string s = llEscapeURL(msg);
string t = (string)llParseString2List(s,["%"],[]);
return llStringLength(t) * 2 - llStringLength(s);
}
</lsl>
*Getting string bytes including multibyte characters
:If we write bytes of msg and s as:
::mb(msg bytes) = nb(no escaped bytes) + bb(before escaped bytes)
::sb(s bytes) = nb + ab(after escaped bytes)
:And,
::ab = bb * 3 (each 1 byte like '#' becomes escaped to 3 bytes "%23"):
:Then,
::mb = sb - bb * 2
:All escaped in s are now "%xx"(x:0-9 or A-F) forms, so, bb = number of '%'s in s.
:To count '%'s, we make string t removing '%'s from s, and:
::bb = sb - tb(t bytes)
:(We separate s to a list removing '%'s by llParseString2List(), and again join to one string t by typecast.)
:Now we got answer:
::mb = sb - (sb - tb) * 2 = tb * 2 - sb
*Refer Blog(Japanese)
:http://snumaw.blogspot.jp/2009/01/lsl-lldialog.html
:http://jinko.slmame.com/e602732.html

|helpers
|also_functions={{LSL DefineRow||[[llGetListLength]]|}}
|also_events
|also_tests
|also_articles
|notes
|permission
|negative_index
|sort=StringLength
|cat1=String
|cat2
|cat3
|cat4
}}

状態

2012-09-08T08:53:29Z

CharlieA Nightfire:

{{Multi-lang|State|/ja}}{{Template:Issues/SVC-3017}}{{LSL Header/ja|ml=*}}
{{RightToc}}
LSLでは、ほとんどのスクリプトは何らかの入力を受け取るか、環境で何らかの変化を検出するまで、アイドル状態にあります。どの瞬間も、スクリプトは何らかのstateにあり、プログラマーによって定義された多くのスキームと一致したイベント、あるいはインプットに反応するでしょう。しかしながら、スクリプトは二つ以上の異なるstateを包含することができ、状態によってイベントやインプットに対して異なる反応を定義できます。

中心的なstateはdefault stateです。スクリプトはコンパイルされた時、リセットもしくはリロードされた時、まずdefaultのstateが実行されます。default stateの定義の後に続けて、スクリプトで処理されるイベントがどのような入力、変更によって発生するのかを定義する、新たなstateを追加することができます。
{{#if:

{{#vardefine:name|state}}

{{#vardefine:p_jump_state_desc|実行するstate名です。}}
{{#vardefine:p_label_state_desc|state名です。}}
{{#vardefine:p_events_desc|一つ以上の {{LSLGC|Events/ja|イベント}}です。}}

{{#vardefine:header_title|default { {{LSL Param|events}} } }}
{{#vardefine:header_text|{{{!}}
{{LSL DefineRow|event|events|{{#var:p_events_desc}}}}
{{!}}}
default state の定義です。
}}

{{#vardefine:constants_nb|
<div id="box">
<h2>state {{LSL Param|label_state|target}} { {{LSL Param|events}} }</h2>
<div style="padding: 0.5em">
{{{!}}
{{LSL DefineRow|label|target|{{#var:p_label_state_desc}}}}
{{LSL DefineRow|event|events|{{#var:p_events_desc}}}}
{{!}}}
'''target''' state の定義です。
</div>
</div>
<div id="box">
<h2>state {{LSL Param|jump_state|target}};</h2>
<div style="padding: 0.5em">
{{{!}}
{{LSL DefineRow|label|target|{{#var:p_jump_state_desc}}}}
{{!}}}<br/>
''state target;''が実行時に発生し、''現在'' のstate と ''target'' state が異なる場合、以下の順に動作します。
#現在のstate内に[[state_exit]]が'''存在する場合は実行され、'''イベントキューは消去されます。
#''target''にstateが変わると、'''全ての'''[[llListen/ja|listen]]は解除されます。
#''target'' stateに[[state_entry]]が'''存在する場合は実行されます。'''
もし''target'' state が ''現在'' の state と同じ場合、'''state は変わらず、またどんな副作用もありません。'''
</div>
</div>
}}

{{#vardefine:examples|
<lsl>default
{
touch_end(integer a)
{
state hello;
}
}

state hello
{
state_entry()
{
llOwnerSay("Hello");
state default;
}
state_exit()
{
llOwnerSay("Goodbye");
}
}</lsl>
}}

{{#vardefine:notes|{{#var:notes}}
* これまで溜っていたイベントを破棄するのを防ぐために、{{LSLG/ja|state}} ''target'' コマンドを {{LSLG/ja|timer}} イベントに移動して、{{LSLG/ja|llSetTimerEvent}}( 0.01 ) で呼び出します。それから新しい {{LSLG/ja|state}} の {{LSLG/ja|state_entry}} でタイマーを止めます。これが心配な場合に {{LSLG/ja|state_exit}} を使用しないでください。}}

{{#vardefine:caveats|*stateを変える上で
**全ての[[llListen/ja|listen]]はリリースされます。
**イベントキューは消去されます。
**[[llSensorRepeat/ja|Repeating sensors]] はリリースされます。
**[[llSetTimerEvent/ja|timer event clock]] はクリア'''されません。'''
**つまり、次の state に timer イベントがあり、前の state でタイマーが設定されていると、以前の state で設定された遅延時間で新しい state の timer イベントが発生することになります。
*''default'' stateはほかのstateに行く前に定義すべきです。
*state範囲内にユーザ関数、あるいはユーザ変数を設定することはできず、イベントだけがstate範囲内で定義できます。
*ユーザ定義(グローバル)関数は state を変えることができません。コンパイラは 'ERROR: Global functions can't change state' というエラーを出すでしょう。'''注意''': 以前はグローバル関数でも 'if' 文の中なら state を変えることができましたが、この"裏技"はもう使えません。
}}

{{#vardefine:helpers|}}

{{#vardefine:also_header|<h3>キーワード</h3>
{{{!}}
{{LSL DefineRow||{{LSLG/ja|jump}}|}}
{{LSL DefineRow||{{LSLG/ja|return}}|}}
{{!}}}
}}

{{#vardefine:also_footer|}}

{{#vardefine:also_functions|}}

{{#vardefine:also_events|
{{LSL DefineRow||{{LSLG/ja|state_entry}}|}}
{{LSL DefineRow||{{LSLG/ja|state_exit}}|}}
}}

{{#vardefine:also_articles|}}

{{#vardefine:also_tests|}}

{{#vardefine:location|}}

}}{{LSL Generic/ja}}{{LSLC/ja|Flow Control}}{{LSLC/ja|Script}}{{LSLC/ja|State}}