Difference between revisions of "LlSetTextureAnim"

Revision as of 14:18, 12 May 2010

LSL Portal

3 Bugs

Function: llSetTextureAnim( integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate );


211	Function ID
0.0	Forced Delay
10.0	Energy

Animate the texture on the specified face/faces by setting the texture scale and offset.

• integer	mode	–	mask of Mode flags
• integer	face	–	face number or ALL_SIDES
• integer	sizex	–	horizontal frames (ignored for ROTATE and SCALE)
• integer	sizey	–	vertical frames (ignored for ROTATE and SCALE)
• float	start	–	Start position/frame number (or radians for ROTATE)
• float	length	–	number of frames to display (or radians for ROTATE)
• float	rate	–	frames per second (must not be zero)

start supports negative indexes. If face is ALL_SIDES then the function works on all sides. Frames are numbered from left to right, top to bottom, starting at 0.
If rate is negative, it has the same effect as using the REVERSE flag.^[1]

Specification

Index	Positive	Negative
First	`0`	`-length`
Last	`length - 1`	`-1`

Indexes

Positive indexes count from the beginning, the first item being indexed as 0, the last as (length - 1).

Negative indexes count from the far end, the first item being indexed as -length, the last as -1.

Frames

Frames are sub-rectangles within the texture. A set of frames with 2 horizontal (sizex) and 3 vertical (sizey) means the overall texture is divided into 3 rows of 2 columns of images, each of which is a frame. llSetTextureAnim will animate across these 6 starting with the top left image and going across and down, optionally repeating. If SMOOTH is set the frames slide smoothly from one to the next, if off, each frame is displayed in turn centered on the face.

Modes		Description
ANIM_ON	0x01	Texture animation is on. This must be set to start the animation, cleared to stop it.
LOOP	0x02	Loop the texture animation.
REVERSE	0x04	Play animation in reverse direction.
PING_PONG	0x08	Play animation going forwards, then backwards.
SMOOTH	0x10	Slide in the X direction, instead of playing separate frames. In both SCALE and ROTATE modes, causes smooth transitions.
ROTATE	0x20	Animate texture rotation. Does not work with SCALE
SCALE	0x40	Animate the texture scale. Does not work with ROTATE

Caveats

If start is out of bounds the script continues to execute without an error message.
The function silently fails if its face value indicates a face that does not exist.
You can only have one texture animation on a prim
- Calling llSetTextureAnim more than once on a prim will reset the existing animation.
You cannot combine ROTATE and SCALE flags.
sizex & sizey are both limited to a range of 0 to 255
llSetTextureAnim when on shows the texture with 1 repeat in X and Y and 0 rotation and offset.

Important Issues

~ All Issues ~ Search JIRA for related Bugs

SVC-3925	A	Some persistent prim properties lost when duplicated
SVC-1242	A	Texture Animation is not copied (llSetTextureAnim)
VWR-4018	A	Texture animations ignore repeats per face

Examples

This slides a texture smoothly and loops it when it gets to the end.

<lsl>llSetTextureAnim(ANIM_ON

Notes

Texture animation is a property of the prim (i.e., you can remove the script that started the animation, and the prim will remember the settings anyway.) Note, though, that as of Jan 2009, texture animation is still one of the prim properties that are lost when using the rezzed in world copy method of shift-drag. Originally brought up in VWR-640, it got it's own issue in SVC-3925

An online-tool for rough and ready conversion of moving gifs to animated textures is here: http://www.peregrinesalon.com/anim/ (link valid as of Jan 2009.)

Deep Notes

All Issues

~ Search JIRA for related Issues

SVC-3925	A	Some persistent prim properties lost when duplicated
SVC-1242	A	Texture Animation is not copied (llSetTextureAnim)
VWR-4018	A	Texture animations ignore repeats per face

Footnotes

^ Though if rate is negative and the REVERSE flag is used, they cancel each other out.

Signature
function void llSetTextureAnim( integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate );

@@ Line 1: / Line 1: @@
-{{Issues/SVC-3925}}{{Issues/SVC-1242}}{{Issues/VWR-4018}}{{LSL_Function/negative index/ja|true|start}}{{LSL_Function/face/ja|face}}{{LSL_Function/ja
+{{Issues/SVC-3925}}{{Issues/SVC-1242}}{{Issues/VWR-4018}}{{LSL_Function/negative index|true|start}}{{LSL_Function/face|face}}{{LSL_Function
 |func_id=211
 |func_sleep=0.0
@@ Line 5: / Line 5: @@
 |sort=SetTextureAnim
 |func=llSetTextureAnim
-|p1_type=integer|p1_name=mode|p1_desc=モードフラグのマスク
+|p1_type=integer|p1_name=mode|p1_desc=mask of Mode flags
 |p2_type=integer|p2_name=face
-|p3_type=integer|p3_name=sizex|p3_desc=横フレーム ( {{LSLG/ja|ROTATE}} と{{LSLG/ja|SCALE}} では無視される)
+|p3_type=integer|p3_name=sizex|p3_desc=horizontal frames (ignored for [[ROTATE]] and [[SCALE]])
-|p4_type=integer|p4_name=sizey|p4_desc=縦フレーム ( {{LSLG/ja|ROTATE}} と{{LSLG/ja|SCALE}} では無視される)
+|p4_type=integer|p4_name=sizey|p4_desc=vertical frames (ignored for [[ROTATE]] and [[SCALE]])
-|p5_type=float|p5_name=start|p5_desc=開始位置/フレーム番号 ( {{LSLG/ja|ROTATE}} ではラジアン)
+|p5_type=float|p5_name=start|p5_desc=Start position/frame number (or radians for [[ROTATE]])
-|p6_type=float|p6_name=length|p6_desc=表示するフレーム数 ( {{LSLG/ja|ROTATE}} ではラジアン)
+|p6_type=float|p6_name=length|p6_desc=number of frames to display (or radians for [[ROTATE]])
-|p7_type=float|p7_name=rate|p7_desc=毎秒のフレーム数（0 にすべきではありません）
+|p7_type=float|p7_name=rate|p7_desc=frames per second (must not be zero)
-|func_footnote=フレームは 0 から始まって、左から右、上から下に数えられます。<br/>'''rate''' がマイナス域の場合、 {{LSLG/ja|REVERSE}} フラグを使っているのと同じ効果があります。{{Footnote|しかし、'''rate''' がマイナスで {{LSLG/ja|REVERSE}} フラグが使用されていると、効果が打ち消されます。|しかし、'''rate''' がマイナスで REVERSE フラグが使用されていると、効果が打ち消されます。}}
+|func_footnote=Frames are numbered from left to right, top to bottom, starting at 0.<br/>If '''rate''' is negative, it has the same effect as using the [[REVERSE]] flag.{{Footnote|Though if '''rate''' is negative and the [[REVERSE]] flag is used, they cancel each other out.}}
-|func_desc=テクスチャの大きさとオフセットを設定して、指定した面のテクスチャをアニメーションさせます。
+|func_desc=Animate the texture on the specified face/faces by setting the texture scale and offset.
 |return_text
 |spec=
-===フレーム===
+===Frames===
-フレームはテクスチャの中の sub-rectangles です。縦 2 ('''{{LSL Param|sizex}}''') 横 3 ('''{{LSL Param|sizey}}''') のフレームセットは、テクスチャ全体が 3 行 2 桁 の画像に切り分けられ、それぞれがフレームとなることを意味しています。llSetTextureAnim will animate across these 6 starting with the top left image and going across and down, optionally repeating. {{LSLG/ja|SMOOTH}} が設定されていると、フレームは次から次へとスムーズにスライドしていき、OFF になっていると、それぞれのフレームはかわるがわる面の中心に表示されます。
+Frames are sub-rectangles within the texture. A set of frames with 2 horizontal ('''sizex''') and 3 vertical ('''sizey''') means the overall texture is divided into 3 rows of 2 columns of images, each of which is a frame. llSetTextureAnim will animate across these 6 starting with the top left image and going across and down, optionally repeating. If [[SMOOTH]] is set the frames slide smoothly from one to the next, if off, each frame is displayed in turn centered on the face.
-|caveats=*1 つのプリムに 1 つのテクスチャアニメーションのみ設定することができます。
+|caveats=*You can only have one texture animation on a prim
-**llSetTextureAnim を 2 回以上呼び出すと、プリムは既にあるアニメーションをリセットします。
+**Calling llSetTextureAnim more than once on a prim will reset the existing animation.
-*{{LSLG/ja|ROTATE}} フラグと {{LSLG/ja|SCALE}} フラグを併用することはできません。
+*You cannot combine [[ROTATE]] and [[SCALE]] flags.
-*'''sizex''' と '''sizey''' は両方とも 0 ～ 255 に制限されています。
+*'''sizex''' & '''sizey''' are both limited to a range of 0 to 255
-*llSetTextureAnim はオンのとき、 X 方向と Y 方向で 1 回ずつ繰り返し、回転とオフセットは 0 となっているテクスチャを表示します。
+*llSetTextureAnim when on shows the texture with 1 repeat in X and Y and 0 rotation and offset.
 |constants={{{!}} class="sortable collapsible" {{Prettytable|style=margin-top:0;}}
 {{!}}-{{Hl2}}
-! モード
+! Modes
-! title="値" {{!}}
+! title="Value" {{!}}
-! class="unsortable" {{!}} 説明
+! class="unsortable" {{!}} Description
 {{!}}-
-{{!}}{{LSLG/ja|ANIM_ON}}
+{{!}}[[ANIM_ON]]
-{{!}}{{LSL Hex/ja||1|chars=2}}
+{{!}}{{LSL Hex||1|chars=2}}
-{{!}}テクスチャのアニメーションは ON です。アニメーションを開始するときに設定し、停止するときに解除しなければなりません。
+{{!}}Texture animation is on. This must be set to start the animation, cleared to stop it.
 {{!}}-
-{{!}}{{LSLG/ja|LOOP}}
+{{!}}[[LOOP]]
-{{!}}{{LSL Hex/ja||2|chars=2}}
+{{!}}{{LSL Hex||2|chars=2}}
-{{!}}テクスチャのアニメーションをループさせます。
+{{!}}Loop the texture animation.
 {{!}}-
-{{!}}{{LSLG/ja|REVERSE}}
+{{!}}[[REVERSE]]
-{{!}}{{LSL Hex/ja||4|chars=2}}
+{{!}}{{LSL Hex||4|chars=2}}
-{{!}}アニメーションを逆順で再生します。
+{{!}}Play animation in reverse direction.
 {{!}}-
-{{!}}{{LSLG/ja|PING_PONG}}
+{{!}}[[PING_PONG]]
-{{!}}{{LSL Hex/ja||8|chars=2}}
+{{!}}{{LSL Hex||8|chars=2}}
-{{!}}アニメーションを順番に再生し、そのあとで逆順に再生します。
+{{!}}Play animation going forwards, then backwards.
 {{!}}-
-{{!}}{{LSLG/ja|SMOOTH}}
+{{!}}[[SMOOTH]]
-{{!}}{{LSL Hex/ja||16|chars=2}}
+{{!}}{{LSL Hex||16|chars=2}}
-{{!}}それぞれのフレームを再生するのではなく、X 方向にスライドさせます。{{LSLG/ja|SCALE}} と {{LSLG/ja|ROTATE}} のモードで、スムーズな切り替えができます。
+{{!}}Slide in the X direction, instead of playing separate frames.<br/>In both [[SCALE]] and [[ROTATE]] modes, causes smooth transitions.
 {{!}}-
-{{!}}{{LSLG/ja|ROTATE}}
+{{!}}[[ROTATE]]
-{{!}}{{LSL Hex/ja||32|chars=2}}
+{{!}}{{LSL Hex||32|chars=2}}
-{{!}}テクスチャを回転させます。<br>{{LSLG/ja|SCALE}} と併用できません。
+{{!}}Animate texture rotation.<br>Does not work with [[SCALE]]
 {{!}}-
-{{!}}{{LSLG/ja|SCALE}}
+{{!}}[[SCALE]]
-{{!}}{{LSL Hex/ja||64|chars=2}}
+{{!}}{{LSL Hex||64|chars=2}}
-{{!}}テクスチャを拡大させます。<br>{{LSLG/ja|ROTATE}} と併用できません。
+{{!}}Animate the texture scale.<br>Does not work with [[ROTATE]]
 {{!}}}
 |examples=
-これはテクスチャを滑らかにずらし、終端についたときに繰り返します。
+This slides a texture smoothly and loops it when it gets to the end.
-<lsl>llSetLinkTextureAnim(LINK_THIS, ANIM_ON | SMOOTH | LOOP , ALL_SIDES, 1, 1, 1, 1, 1);</lsl>
+<lsl>llSetTextureAnim(ANIM_ON | SMOOTH | LOOP , ALL_SIDES, 1, 1, 1, 1, 1);</lsl>
-これは反対方向にテクスチャを滑らかにずらします。
+This slides a texture smoothly in the opposite direction
-<lsl>llSetLinkTextureAnim(LINK_THIS, ANIM_ON | SMOOTH | LOOP , ALL_SIDES, 1, 1, 1, 1, -1);</lsl>
+<lsl>llSetTextureAnim(ANIM_ON | SMOOTH | LOOP , ALL_SIDES, 1, 1, 1, 1, -1);</lsl>
-横8縦8の64セルにテクスチャを分割し、左から右、上から下に通して反転させます。セルアニメーションで使い勝手がいいです。
+This divides a texture into 64 "cells", 8 across, and 8 down, and flips through them, left to right, top to bottom. This is useful for cell animation.
-<lsl>llSetLinkTextureAnim(LINK_THIS, ANIM_ON | LOOP, ALL_SIDES, 8, 8, 0, 64, 6.4 );</lsl>
+<lsl>llSetTextureAnim( ANIM_ON | LOOP, ALL_SIDES, 8, 8, 0, 64, 6.4 );</lsl>
-これは毎秒2回、半時計周りにテクスチャを回転します。最後の値は-2*TWO_PIの時計周り回転に変わります。
+This rotates a texture counter-clockwise at 2 revolutions per second. Change the last value to -2*TWO_PI to rotate clockwise.
-<lsl>llSetLinkTextureAnim(LINK_THIS, ANIM_ON | SMOOTH | ROTATE | LOOP, ALL_SIDES,1,1,0, TWO_PI, 2*TWO_PI);</lsl>
+<lsl>llSetTextureAnim(ANIM_ON | SMOOTH | ROTATE | LOOP, ALL_SIDES,1,1,0, TWO_PI, 2*TWO_PI);</lsl>
-これはテクスチャを拡大縮小して変形します。
+This scales a texture larger and smaller.
-<lsl>llSetLinkTextureAnim(LINK_THIS, ANIM_ON | SMOOTH | SCALE | PING_PONG | LOOP, ALL_SIDES, 1, 1, 1, 3, 2);</lsl>
+<lsl>llSetTextureAnim(ANIM_ON | SMOOTH | SCALE | PING_PONG | LOOP, ALL_SIDES, 1, 1, 1, 3, 2);</lsl>
-これはループ再生しているアニメーションを特定のフレームで停止させたり開始させたりします。
+This turns off all texture animations
+<lsl>llSetTextureAnim(FALSE, ALL_SIDES, 0, 0, 0.0, 0.0, 1.0);</lsl>
+This toggles a looping animation to make it stop at a specific frame.
 <lsl>integer ON;
 default
@@ Line 92: / Line 95: @@
 |helpers
-|also_functions={{LSL DefineRow||{{LSLG/ja|llSetLinkTextureAnim}}}}
+|also_functions={{LSL DefineRow||[[llSetLinkTextureAnim]]}}
 |also_events
 |also_articles
 |notes=
-テクスチャアニメーションはプリムのプロパティです (例えば、アニメーションを開始させてからスクリプトを抜くことができます。いずれにせよプリムはその設定を覚えています)。しかし、2009 年 1 月時点ではまだ、テクスチャアニメーションは Shift ドラッグによってコピーされるとその設定が消えてしまうプリムプロパティとなっています。最初にこの問題が {{Jira|VWR-640}} でもちあがり、[[#SVC-3925|SVC-3925]] で分離独立して議論されています。
+Texture animation is a property of the prim (i.e., you can remove the script that started the animation, and the prim will remember the settings anyway.) Note, though, that as of Jan 2009, texture animation is still one of the prim properties that are lost when using the rezzed in world copy method of shift-drag. Originally brought up in {{Jira|VWR-640}}, it got it's own issue in [[#SVC-3925|SVC-3925]]
-早くざっくりと GIF をアニメーションテクスチャに変換するオンラインツールがこちらにあります。 http://www.peregrinesalon.com/anim/ (2009 年 1 月現在で有効なリンクです)
+An online-tool for rough and ready conversion of moving gifs to animated textures is here: http://www.peregrinesalon.com/anim/ (link valid as of Jan 2009.)
 |cat1=Media
 |cat2=Effects

Difference between revisions of "LlSetTextureAnim"

Revision as of 14:18, 12 May 2010

Contents

Summary

Specification

Indexes

Frames

Caveats

Important Issues

Examples

Notes

See Also

Functions

Articles

Deep Notes

All Issues

Footnotes

Signature

Navigation menu

Search