Second Life Wiki - User contributions [en]

LlSetStatus

2008-12-10T03:24:21Z

Vinhold Starbrook: better comment wording in script example

{{LSL_Function
|func_id=45|func_sleep=0.0|func_energy=10.0
|func=llSetStatus
|p1_type=integer|p1_name=status|p1_desc=bit mask, STATUS_* flags
|p2_type=integer|p2_name=value|p2_desc=boolean
|func_footnote
|func_desc=Sets the object status attributes indicated in the '''status''' mask to '''value'''
|return_text
|spec
|caveats=*Status is an object attribute; all prims in an object share the same status.
** Except for STATUS_BLOCK_GRAB, this only affects the prim the script is in, child prims in linked objects will not be affected.
|constants={{LSL Constants/Status}}
|examples=<lsl>default
{
state_entry()
{
llSetStatus( STATUS_DIE_AT_EDGE | STATUS_PHYSICS, TRUE);
llSetStatus( STATUS_ROTATE_X | STATUS_ROTATE_Y, FALSE);
}
}</lsl>

If STATUS_BLOCK_GRAB is to be set TRUE for all prims in a linked set, the following script can be run in each prim to set the flag:

<lsl>default
{
state_entry() {
llSetStatus(STATUS_BLOCK_GRAB,TRUE); // Set 'No grab' flag on prim.
llOwnerSay("'No Grab' was set!");
llRemoveInventory(llGetScriptName());
}
}</lsl>

See JIRA comment [http://jira.secondlife.com/browse/SVC-1773 SVC-1773] for more information until resolved.

|helpers
|also_functions=
{{LSL DefineRow||[[llGetStatus]]|Gets the object status.}}
|also_tests
|also_events
|also_articles
|notes
|cat1
|cat2=Status
|cat3=Physics
|cat4
}}

LlSetStatus

2008-12-10T03:22:12Z

Vinhold Starbrook: Added commentary on STATUS_BLOCK_GRAB with code example and refernce to JIRA link for more information.

{{LSL_Function
|func_id=45|func_sleep=0.0|func_energy=10.0
|func=llSetStatus
|p1_type=integer|p1_name=status|p1_desc=bit mask, STATUS_* flags
|p2_type=integer|p2_name=value|p2_desc=boolean
|func_footnote
|func_desc=Sets the object status attributes indicated in the '''status''' mask to '''value'''
|return_text
|spec
|caveats=*Status is an object attribute; all prims in an object share the same status.
** Except for STATUS_BLOCK_GRAB, this only affects the prim the script is in, child prims in linked objects will not be affected.
|constants={{LSL Constants/Status}}
|examples=<lsl>default
{
state_entry()
{
llSetStatus( STATUS_DIE_AT_EDGE | STATUS_PHYSICS, TRUE);
llSetStatus( STATUS_ROTATE_X | STATUS_ROTATE_Y, FALSE);
}
}</lsl>

If STATUS_BLOCK_GRAB is to be set TRUE for all prims in a linked set, the following script can be run in each prim to set the flag:

<lsl>default
{
state_entry() {
llSetStatus(STATUS_BLOCK_GRAB,TRUE); // Set No grab setting for prim.
llOwnerSay("'No Grab' was set!");
llRemoveInventory(llGetScriptName());
}
}</lsl>

See JIRA comment [http://jira.secondlife.com/browse/SVC-1773 SVC-1773] for more information until resolved.

|helpers
|also_functions=
{{LSL DefineRow||[[llGetStatus]]|Gets the object status.}}
|also_tests
|also_events
|also_articles
|notes
|cat1
|cat2=Status
|cat3=Physics
|cat4
}}

Category:LSL Video

2007-09-27T06:02:38Z

Vinhold Starbrook: /* Description */

{{LSL Header}}
==Description==
Second Life allows video to be played in world on the sides of prims by replacing the texture with a video stream. Movies can not be uploaded to Second Life, but a URL to a movie stream is used instead.

Quicktime is used in the client to play the movie so only Quicktime compatible formats currently work, though with the client now [[Open_Source_Portal|open source]], someone may come up with a wrapper for other video players and formats.

The thumbrule is if it can play in Quicktime, then it can probably play in Second life.

To set which texture to replace and what movie URL to play, use the {{LSLG|llParcelMediaCommandList}} function.

To determine information about the video on the current parcel, use {{LSLG|llParcelMediaQuery}}

You can also give the appearance of playing a movie by animating a texture. This is done with the {{LSLG|llSetTextureAnim}} function.

Video cannot be recorded with LSL, but it can be recorded with the client.

For additional information see [[How To Show Video in SL]].

==Functions==
*{{LSLG|llParcelMediaCommandList}}
*{{LSLG|llParcelMediaQuery}}
*{{LSLG|llSetTextureAnim}}

How To Show Video in SL

2007-09-27T06:01:36Z

Vinhold Starbrook:

'''How to set up and play streaming video in Second Life.'''

This article covers each of the steps from encoding video content to displaying it in Second Life.

== Encoding a Video File ==
The video from any source must first be converted to a computer file form from whatever source it is in. There are variety of programs and devices that can do this step. Once the video is on the computer it must be encoded in a format that Quicktime can play. These are the settings used in Quicktime Pro to create a movie that Second Life can read. There may be other combinations that can work but these were what worked for this example.

=== Quicktime Pro Settings ===
'''Standard Video Compression Settings'''
Compression Type: MPEG-4 Video
Frame Rate: 30 fps
Key Frames: Every 24 frames

Data Rate: Restrict to 436 kbits/sec
Optimized for: Download
Compressor Quality: Best

'''Sound Settings'''
Format: AAC
Channels: Stereo (L R)
Rate: 44.100 kHz
Render Settings:
Quality: Best
AAC Encoder Settings:
Target Bit Rate: 64 kbps

'''Movie Settings'''
Video
Compression: MPEG-4 Video
Quality: Best
Bitrate: 436 kbits / sec
Dimensions: 320 x 240

Sound
Format: AAC
Sample Rate: 44.100 kHz
Channels: Stereo (L R)
Bit Rate: 64 kbps

'''Prepare for Internet Streaming'''
Fast Start

At this point the program will start encoding the video and will produce an .MOV file. It is now ready to place on your web server.

== Web Server Configurations ==
You will need to have access to a web server, either a normal website or a specialized streaming server that is configured to support http access. Once the file is in place determine the URL address to access the file. If you can play the video in Quicktime on your computer using the URL address, chances are good it will also play in SL.

== Parcel Settings ==
To set up land parcel for video requires that you either be a land owner or member of a group that has the privileges to set the Media for streaming video. This option can be accessed by right clicking on the ground in the parcel and selecting the About Land menu. Open the Media Tab.

There are two items to set here for video. A texture that will be replaced by the video when it plays and the URL address for the video file. The texture can be any picture texture, but I find it useful to set a texture that indicates what video is available. It is my opinion that the texture should advertise the video as well as provide some instruction on how to start the program. Once the texture and URL are in place you are ready to start the show.

All devices that can play a video can only display the URL set in the Land Media settings. If any change is made to that URL all playing devices in that parcel are immediately changed. Each visitor does not see the same portion of the video that anyone else may be seeing. This is the result of each client independently connecting to the URL. If the video is started using the display device, all present and equipped to see it will all start seeing it at the same time. Confused? I certainly was at first! See article [http://secondlife.com/app/help/guides/streamingmedia.php Streaming Media] for more information on how video is implemented in SL.

== Scripting a Display ==
There are a number of free, and paid, "TV" (or video display) devices available in SL, but if you wanted to create your own display device here are some tips in getting it done!

The size of the video does not control how big you can make your display unit in SL, it establishes a standard ratio between width and height. Any multiple of those numbers will have the correct aspect ratio and will display undistorted video. Anything not matching that ratio will cause the video to display stretched or squished. A convenient size can be made by making your display prim from a cube set to X=2.0, Y=1.5 (This is four 0.5m units by three 0.5m units!) The z value can be set to whatever your device will need for depth. This resulting arrangement has the display facing up. The display surface just happens to be face 0 (zero) of the cube. This is important in having a correct orientation so your picture is not showing sideways! Remove any texture on face zero and set to a dark gray or black color. This will be the "off" setting for the TV. Now you are ready for a bit of simple scripting to start showing the movie!

=== Basic Video Display Script ===

The following script will run but you will soon find it inconvenient to use. It is to illustrate these commands:
{|
| [[llParcelMediaQuery]]()
| Get Land parcel media settings for video
|-
| [[llSetPrimitiveParams]]()
| To display the video on a surface making the device appear to turn on and off.
|-
| [[llParcelMediaCommandList]]()
| To control activating the media stream through the device.
|}

<pre>
// This script would be used in the prim that will show the video on surface zero.
// Touching the prim will start or stop the video display set in Land Media: Video.

// Global Variable declarations
key DefTexture;
vector DefColor;
list data;
key texture;

default {
state_entry() {
DefTexture = llGetTexture(0); // Save default texture set on prim surface zero.
DefColor = llGetColor(0); // Save default color of prim surface zero
IsPlaying = FALSE; // Set playing flag to FALSE.
}

touch_start(integer total_number) {
// Read land parcel media settings
data = llParcelMediaQuery([PARCEL_MEDIA_COMMAND_TEXTURE, PARCEL_MEDIA_COMMAND_URL]);
texture = (key) llList2String(data, 0); // Get texture for parcel to display
if (IsPlaying) { // Player has video active
llParcelMediaCommandList([PARCEL_MEDIA_COMMAND_STOP]); // Stop streaming to the device.
llSetPrimitiveParams([PRIM_TEXTURE,0,DefTexture,<1,1,0>,ZERO_VECTOR,0.0,PRIM_COLOR,0,DefColor,1.0,PRIM_FULLBRIGHT,0,TRUE]);
IsPlaying = FALSE;
}
else { // Check if Parcel Video is available
if (llList2String(data, 0) == "") { // Not a landowner or land group member error display
key ErrTexture = llGetInventoryKey("ErrMsg"); // Get texture by name from inventory
llSetPrimitiveParams([PRIM_TEXTURE,0,ErrTexture,<1,1,0>,ZERO_VECTOR,0.0,PRIM_COLOR,0,<1,1,1>,1.0,PRIM_FULLBRIGHT,0,TRUE]);
}
else { // Set texture
llSetPrimitiveParams([PRIM_TEXTURE,0,texture,<1,1,0>,ZERO_VECTOR,0.0,PRIM_COLOR,0,<1,1,1>,1.0,PRIM_FULLBRIGHT,0,TRUE]);
llParcelMediaCommandList([PARCEL_MEDIA_COMMAND_PLAY]); // Start media playing to this device
IsPlaying = TRUE;
}
}
}
}
</pre>

'''NOTE:''' The use of the ErrMsg texture is is a useful reminder if the device cannot function due to permissions not available to the owner. This is the text I used in white on blue:

<pre>
You are not a land owner or land group member; or parcel does not have media set. Cannot connect to parcel media.
</pre>

It gives the basic idea as to why the video is not playing.

[[Category:LSL Library|Video]]

How To Show Video in SL

2007-09-27T05:59:36Z

Vinhold Starbrook: New page: '''How to set up and play streaming video in Second Life.''' This article covers each of the steps from encoding video content to displaying it in Second Life. == Encoding a Video File ...