Second Life Wiki - User contributions [en]

Importprimscript

2015-06-19T01:36:41Z

Techplex Engineer: /* Source */

==Introduction==

importprimscript is a complement to Qarl Linden's [[Advanced_Sculptie_Exporter_From_Maya]]. Once you've exported a folder of files using his script, this program will log in to Second Life using an account of your choice, upload all of the textures, and rez the entire sculptie structure. Sculpt maps are compressed with a single layer lossless JPEG2000 encoding while textures use the traditional five layer lossy JPEG2000 encoding.

== Download ==

* [http://abbloch.com/importprimscript/importprimscript-1.4.2-libomv-0.6r2334-x64.zip 1.4.2(x64)] (Works with 64-bit Windows Vista; More secure than previous versions (objects now rez with Allow Anyone To Copy/Move turned off by default instead of on); Functionality that had been broken by SL server 1.20 is restored)
* [http://abbloch.com/importprimscript/importprimscript-1.4.2-libomv-0.6r2334.zip 1.4.2(x86)] (Works with 32-bit Windows Vista and XP; More secure than previous versions (objects now rez with Allow Anyone To Copy/Move turned off by default instead of on); Functionality that had been broken by SL server 1.20 is restored)
* [http://abbloch.com/importprimscript/importprimscript-1.4.0-libsl-0.3.2.3-x64.zip 1.4.0(x64)] (Compatibility added for 64-bit Vista; Functionality that had been broken by SL server 1.20 is restored)
* [http://www.jhurliman.org/download/importprimscript-1.3.0.zip 1.3.0] (Uploads go in to an inventory folder, more reliable file uploads)
* [http://www.jhurliman.org/download/importprimscript-1.0.2.zip 1.0.2]

== Source ==

* https://github.com/openmetaversefoundation/libopenmetaverse/tree/master/Programs/importprimscript
* http://openmv.org/svn/libsl/libopenmetaverse/branches/modularized/Programs/importprimscript/
* http://openmv.org/svn/libsl/libopenmetaverse/branches/simd/Programs/importprimscript/

==Requirements==

If you are on Windows you will need the [http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB-4362-4B0D-8EDD-AAB15C5E04F5&displaylang=en .NET 2.0 framework]. On other platforms, a current version of [http://www.monoproject.org/ Mono] is required.

===Linux/OSX Users===

The current version does not ship with a binary of the openjpeg-libsl library. You will need a current copy of [http://www.libsecondlife.org/ libsecondlife], and to run "make" (or "make osx" on OSX) in the openjpeg-libsl directory and copy the resulting .so or .dylib file to the importprimscript directory. A future release will contain openjpeg-libsl binaries for 32/64-bit Linux and Intel OSX.

==Usage==

This program is meant to be run from the command line. All input is fed through command line parameters and the program runs and periodically outputs status information to the console. Eight parameters must be passed in (multiple word parameters must be enclosed in quotes), using this order: FirstName LastName Password Simulator X Y Z Primscript.

* FirstName: The first name of the avatar you are going to use to import the structure. This avatar will be listed as the creator, although the object will have full permissions so you can copy it with another avatar. This avatar cannot be logged in before you run the program, so if you are already logged in to Second Life this must be an alt account.

* LastName: The last name of the avatar that is going to import the structure.

* Password: The account password. This password is hashed before being sent to the login server and is never sent to any other sources, running this program is as safe as running the official Second Life client.

* Simulator: The name of the simulator you want the bot to log in to and create the import in. Examples are Hooper or "My Region" (notice the quotes).

* X, Y, Z: Coordinates to log the bot in to the simulator and rez the structure at. These are whole numbers between 0 and 255.

* Primscript: The path to the primscript file to import. Lets say you installed this program to c:\importprimscript\ and exported a folder of textures and the primscript file from Maya in to c:\importprimscript\myexport, and the primscript file is named myexport1.primscript. The command line argument could be either the relative path myexport/myexport1.primscript or the absolute c:\importprimscript\myexport\myexport1.primscript.

==Optional GUI==

To make things a little more user friendly, there is an [http://www.fileden.com/files/2006/10/8/271989/sculptgui.zip optional GUI] for controlling the upload utility. Basically, just move sculptgui.exe to the folder with importprimscript.exe in it, and then double click the GUI to use it.

The GUI is Windows only. It could be compiled for Mac with little trouble, only the developer's Mac is broken.
[[Category:Sculpted_Prims]]

Talk:LlSetContentType

2013-07-12T17:20:53Z

Techplex Engineer: /* Too many Questions */

== Too many Questions ==
we (will) have a pretty new function, but zero information about it...
only works for LL's browser / MOAP? (seems like a strange limitation.)
only works for the prim owner? (hows that going to work with the internal browser / MOAP, user key/name isn't sent except from llHTTPRequest)
I can assume it only works for the script that received the request (since normally other scripts can't respond)

if someone has some better info, it'd be really helpful... if all the above are true, it has zero value, since html from llHTTPRequest can't be displayed as such. if it's just limited to html within SL, it has no use for exporting interface of inworld to the web, but more use for things like huds and distrubuted inworld networks.<br/>-- '''[[User:Void_Singer|Void]]''' <sup><small>([[User_talk:Void_Singer|talk]]|[[Special:Contributions/Void_Singer|contribs]])</small></sup> 15:29, 5 August 2011 (PDT)

:"for things like huds and distrubuted inworld networks" I think this is exactly the intended use. The exact wording in the release notes was <code>CONTENT_TYPE_HTML "text/html", only valid for embedded browsers on content owned by the person viewing. Falls back to "text/plain" otherwise.</code> The implication is that this is to be used with {{LSLGC|Prim Media}}; which should be made clear (and isn't) in the caveat or description. -- '''[[User:Strife_Onizuka|Strife]]''' <sup><small>([[User talk:Strife_Onizuka|talk]]|[[Special:Contributions/Strife_Onizuka|contribs]])</small></sup> 10:20, 6 August 2011 (PDT)

The intended use is to enable HTML based HUDs. I have created an [[HTML_HUD_Demo]].
<br>For the technical nitty gritty:
* The server will check if the user-agent string contains Second Life and revert to text/plain if it doesn't.
* The server will check the incoming IP of the request against the IP of the object owner and revert to text/plain if they don't match.

For HUDs this will work as expected. Non-HUD content may have weird behavior:
* You may set a custom user-agent string to include Second Life in a non-SL browser to view these urls while logged into the region with the content.
* If you run multiple clients from the same IP and logged into the same region you may be able to see HTML rendered content cross-account.
* Poxy and IP anonymizing services are unlikely to work well with this.

In general these are rare and unreliable enough to sufficiently reduce the concern for hosting webpages under the Linden Lab domain name. This feature is *not* meant to enable serving general purpose web pages from LSL scripts.

: [[User:Kelly Linden|Kelly Linden]] 14:25, 26 August 2011 (PDT)

:: any hope of opening this up to any browser with the secondlife user-agent string? that'd still keep it out of the wider internet and the association clean, while enabling wider use cases within SL. <br/>-- '''[[User:Void_Singer|Void]]''' <sup><small>([[User_talk:Void_Singer|talk]]|[[Special:Contributions/Void_Singer|contribs]])</small></sup> 12:46, 30 August 2011 (PDT)

I wonder if the Caveats is applicable to the new content types:
* CONTENT_TYPE_XML application/xml
* CONTENT_TYPE_XHTML application/xhtml+xml
* CONTENT_TYPE_ATOM application/atom+xml
* CONTENT_TYPE_JSON application/json
* CONTENT_TYPE_LLSD application/llsd+xml
* CONTENT_TYPE_FORM application/x-www-form-urlencoded
* CONTENT_TYPE_RSS application/rss+xml
[[User:Techplex Engineer|Techplex Engineer]] 10:20, 12 July 2013 (PDT)

File:VW HTTP requests.svg

2012-12-26T04:32:15Z

Techplex Engineer: uploaded a new version of "File:VW HTTP requests.svg": Trying to fix svg render problem

Simple diagram that illustrates the difference between http_response and http_request.

File:VW HTTP requests.svg

2012-12-26T04:29:51Z

Techplex Engineer: Simple diagram that illustrates the difference between http_response and http_request.

Simple diagram that illustrates the difference between http_response and http_request.

Category:LSL HTTP

2012-12-26T04:19:13Z

Techplex Engineer: /* Understanding LSL HTTP Communications */

{{LSL Header|ml=*}}

== HTTP ==

[[LSL]] includes functions that utilize HTTP, the HyperText Transfer Protocol, for communicating with other scripts in-world or web servers on the outside internet. HTTP requests incur no speed penalty, but there is a limit on how many requests per [[object]] can be made.

=== Functions ===
;[[llEscapeURL]]: Returns the UTF-8 encoded escape codes for selected characters.
;[[llHTTPRequest]]: Requests information from an HTTP server.
;[[llLoadURL]]: Loads a web page in an external browser.
;[[llUnescapeURL]]: Returns the UTF-8 characters without escape codes.
;[[llHTTPResponse]]: Responds to an HTTP request made to the script.
;[[llGetFreeURLs]]: Returns the number of URLs that the script can request for HTTP-In.
;[[llGetHTTPHeader]]: Returns the value of the requested header for a given HTTP request made to the script.
;[[llReleaseURL]]: Releases a given URL so it may not be used further.
;[[llRequestURL]]: Requests a non-secure URL to be used with HTTP-In.
;[[llRequestSecureURL]]: Same as [[llRequestURL]] but requests a secure url <nowiki>(https://)</nowiki>

=== Events ===
;[[http_request]]: Called when the script receives an HTTP request.
;[[http_response]]: Called when an HTTP request is complete.

{{LSLC|}}{{LSLC|Communications}}

=== Understanding LSL HTTP Communications ===

[[File:VW_http.png|500px]]

File:VW http.png

2012-12-26T04:18:35Z

Techplex Engineer: Simple diagram that illustrates the difference between http_response and http_request.

Simple diagram that illustrates the difference between http_response and http_request.

Category:LSL HTTP

2012-12-26T04:18:05Z

Techplex Engineer: /* Understanding LSL HTTP Communications */

File:VW HTTP requests2.jpg

2012-12-26T04:17:47Z

Techplex Engineer: Simple diagram that illustrates the difference between http_response and http_request.

Simple diagram that illustrates the difference between http_response and http_request.

File:VW HTTP requests.jpg

2012-12-26T04:12:19Z

Techplex Engineer: uploaded a new version of "File:VW HTTP requests.jpg": Updated to fix some semantic errors.

Simple diagram that illustrates the difference between http_response and http_request.

Talk:Mesh and LOD

2012-07-20T17:20:19Z

Techplex Engineer: Created page with "Has anyone done any testing on what is a good polygon count at the different LODs? --TE"

Has anyone done any testing on what is a good polygon count at the different LODs? --TE

Good Building Practices

2012-07-20T17:03:52Z

Techplex Engineer: /* Scripting */

== Welcome to Good Building Practices ==
This page is all about how to be creative and efficient at the same time!

{| width="100%"
|-
|valign="top"|
<div id="box">

== Animation ==
<div style="padding: 0.5em">
* '''[[Animation Streamlined]]''' - Make your creations move without dragging Second Life to a crawl!
</div>
</div>

<div id="box">

== Mesh ==
<div style="padding: 0.5em">
* '''[[Making Mesh Physics]]''' - Why and How.
* '''[[Making Mesh for Pathfinding]]''' - Pathfinding friendly mesh.
* '''[[Mesh and LOD]]''' - Mesh objects that don't crash your friends' old computer.
</div>
</div>

<div id="box">

== Pathfinding ==
<div style="padding: 0.5em">
*'''[[Pathfinding_Overview]]''' - Pathfinding explained.
*'''[[Pathfinding_Tools_in_the_Second_Life_Viewer]]''' - The Pathfinding tools.
*'''[[Pathfinding_Quick_Start_Guide]]''' - The best way to get up and running with Pathfinding.
*'''[[Visual_Guide_to_Pathfinding|A Visual Guide]]''' - Watch how easy it is!
*'''[[Walkability_Coefficients]]''' - Control the speed of your Walkable areas.
*'''[[Material_Volumes]]''' - Control the speed of your characters.
*'''[[Universal_Attribute_Changes_for_Pathfinding]]''' Configure objects for pathfinding in bulk
</div>
</div>
<div id="box">

== Physics ==
<div style="padding: 0.5em">
* '''[[Physics Optimization]]''' - Not everything needs physics, learn how to add the least load necessary to the physics engine.
* '''[[PRIM_PHYSICS_SHAPE_NONE]]''' - Additional information on this important attribute.

</div>
</div>
|valign="top" width="50%"|
<div id="box">

== Scripting ==
<div style="padding: 0.5em">
* '''[[Debugging Tips]]''' - how to work out what your code is doing without a conventional development toolkit

* '''Pathfinding'''
** '''[[Pathfinding LSL Functions]]''' - standard reference for all of the pathfinding functions.
** '''[[Modular Pathfinding Kit]]''' - code snippets designed to be plugged together to quickly build unique behaviors.
** '''[[Pathfinding Cookbook]]''' - ready made solutions for some critters.
** '''[[Holistic Pathfinding Management]]''' - Strategies for managing large numbers of pathfinding objects.

* '''Vehicles'''
** '''[[Linden Vehicle Tutorial]]''' - Vehicle scripting best practices.

</div>
</div>

<div id="box">

== Sound ==
<div style="padding: 0.5em">
Tips for adding sound effects to your builds.
* [[Environment_Sounds|Environment Sounds]]
* [[Event_Driven_Sounds|Event Driven Sounds]]
</div>
</div>

<div id="box">

== Sculpted Prims ==
<div style="padding: 0.5em">
*'''[[Sculpted Prim Usage]]''' - What you need to know about how sculpted prims effect Second Life.
</div>
</div>

<div id="box">

== Textures ==
<div style="padding: 0.5em">
* '''[[Texture Usage]]''' - What size to use, and what to avoid.
</div>
</div>

|}
__NOTOC__

User:Techplex Engineer

2012-07-18T18:09:46Z

Techplex Engineer: Initially Created

Hey

Nice to meet ya!
I'm an avid scripter and builder, let me know if there is something I can help with.

I have submitted a couple of patches to opensim and written a php texture manager.

I enjoy Virtual worlds and the potential they have for profiteering and education. I work with a number of educators in Maine to spread the use of Virtual Worlds.

File:VW HTTP requests.jpg

2012-07-18T18:06:12Z

Techplex Engineer: uploaded a new version of "File:VW HTTP requests.jpg": Added Details to help make the diagram Clearer. Fixed arrows to make them point the right way.

Simple diagram that illustrates the difference between http_response and http_request.

File:VW HTTP requests.jpg

2012-07-10T00:44:42Z

Techplex Engineer: uploaded a new version of "File:VW HTTP requests.jpg"

Simple diagram that illustrates the difference between http_response and http_request.

Category:LSL HTTP

2012-07-10T00:43:52Z

Techplex Engineer: /* Events */ added image to help newcommers

File:VW HTTP requests.jpg

2012-07-10T00:43:12Z

Techplex Engineer: uploaded a new version of "File:VW HTTP requests.jpg"

Simple diagram that illustrates the difference between http_response and http_request.

File:VW HTTP requests.jpg

2012-07-10T00:38:02Z

Techplex Engineer: uploaded a new version of "File:VW HTTP requests.jpg": Removed the Gliffy banner

Simple diagram that illustrates the difference between http_response and http_request.

File:VW HTTP requests.jpg

2012-07-10T00:36:21Z

Techplex Engineer: Simple diagram that illustrates the difference between http_response and http_request.

Simple diagram that illustrates the difference between http_response and http_request.

LSL HTTP server/examples

2012-06-14T00:03:54Z

Techplex Engineer: /* Echo World */

{{LSL Header|ml=*}}
=== Utility Script ===
A script intended as a 'fill in the blank' exercise for very, very simple HTTP servers is here: [[LSL_http_server/examples/utility_script | Utility Script]]
=== Hello World! ===
Classic example, the smallest http_request script possible.
<lsl>
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == "GET")
{
llHTTPResponse(id,200,"Hello World!");
}
}
}
</lsl>
A slightly more robust version:
<lsl>
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
llHTTPResponse(id,200,"Hello World!");
}
else
{
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

=== Echo World ===
"Echo World ([[User:Byrd Sciavo|Byrd Sciavo]] 04:19, 7 October 2009 (UTC))" is a slightly more useful "Hello World", demonstrating a basic server that echos back dynamic data fed. Echo World shows how http_request receives GET variables. To receive this "dynamic echo", append your cap url with a query string, such as https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322/foo/bar?arg=gra
<lsl>
string url;
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
url=body;
llOwnerSay(url);
}
else if(method=="GET")
{
if(llGetHTTPHeader(id,"x-query-string")=="")
llHTTPResponse(id,200,"I ECHO when you append some GET variables to me, e.g., /?var=foo");
else
llHTTPResponse(id,200,llGetHTTPHeader(id,"x-query-string"));
}
}
}
</lsl>

=== Visitor List ===
A list of residents within sensor range of the server.
<br>Notes:
* This includes a method for handling multiple requests while waiting for asynchronous data requests to come back.
<lsl>integer scanning = FALSE;

list requests;

send_response(string body)
{
integer j;
for (j = 0; j < llGetListLength(requests); ++j)
{
llHTTPResponse(llList2Key(requests,j), 200, body);
}
requests = [];
}

default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
if (!scanning)
{
llSensor("",NULL_KEY,AGENT,96,PI);
scanning = TRUE;
}

requests += [id];
}
else
{
llHTTPResponse(id,405,"Unsupported method.");
}
}

no_sensor()
{
send_response("There is no one here.");
scanning = FALSE;
}

sensor(integer n)
{
string output;
if (n < 16) output = "There are " + (string)n + " avatars nearby:";
else output = "There are at least 16 avatars nearby:";

integer i;
for (i = 0;i<n;++i)
{
output += "\n\t" + llDetectedName(i);
}

send_response(output);

scanning = FALSE;
}
}
</lsl>

=== Url Persistence / Visitor Counter ===
A more complete 'hello world', always has an url and keeps a visitor counter.
<lsl>
string url;
integer hits;

setup()
{
llSetObjectName("HTTP Server");
url = "";
llRequestURL();
hits = (integer)llGetObjectDesc();
llSetText((string)hits + " visitors.",<1,1,0>,1);
}

default
{
state_entry() { setup(); }
on_rez(integer n) { setup(); }

changed(integer c)
{
if (c & (CHANGED_REGION | CHANGED_REGION_START | CHANGED_TELEPORT) )
{
setup();
}
}

touch_start(integer n)
{
llSay(0,"My url is: " + url);
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
url = body;
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
++hits;
llSetObjectDesc((string)hits);
llSetText((string)hits + " visitors.",<1,1,0>,1);
llHTTPResponse(id,200,"Hello! You are visitor " + (string)hits + ".");
}
else
{
llHTTPResponse(id,405,"Method unsupported");
}
}
}
</lsl>

=== Perl/Python Examples Using POST ===
Here are a set of scripts to provide another example using POST. The first script is the LSL code to receive the information on the grid. The second script is a Perl script that is used on the outside server to contact the code on the grid. The third script is a Python script that is also used on the outside server to contact the code on the grid. ([[User:Grandma Bates|Grandma Bates]] 12:42, 27 May 2009 (UTC))
<lsl>
key requestURL;

default
{

state_entry()
{
requestURL = llRequestURL(); // Request that an URL be assigned to me.
}

http_request(key id, string method, string body)
{
if ((method == URL_REQUEST_GRANTED) && (id == requestURL) )
{
// An URL has been assigned to me.
llOwnerSay("Obtained URL: " + body);
requestURL = NULL_KEY;
}
else if ((method == URL_REQUEST_DENIED) && (id == requestURL))
{
// I could not obtain a URL
llOwnerSay("There was a problem, and an URL was not assigned: " + body);
requestURL = NULL_KEY;
}

else if (method == "POST")
{
// An incoming message was received.
llOwnerSay("Received information from the outside: " + body);
llHTTPResponse(id,200,"Thank you for calling. All of our operators are busy.");
}
else
{
// An incoming message has come in using a method that has not been anticipated.
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

Here is the Perl script to contact the prim on the grid.

<perl>
#!/usr/bin/perl
# Routine to contact a script on the SL Grid using http server
use strict;
use warnings;
use LWP;

my $browser = LWP::UserAgent->new;

sub submitInformation) {
my( $url, $params ) = @_;
return $browser->post( $url, $params )->content;
}

# Set the URL manually....
my $url = 'http://sim3015.aditi.lindenlab.com:12046/cap/d57a7c8b-3ace-3186-730a-f22fde870d48';

my $info = submitInformation( $url, {
id => '244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
name => 'M Linden',
} );

print $info,"\n";
</perl>

Here is the Python code that does the same thing as the PERL code above.

<python>
#!/usr/bin/python

import urllib

# #################################################
# Routine to send the information to the prim
# submitInformation(url,information)
#
def submitInformation(url,parameters) :
# Set the parameters to be sent.
encodedParams = urllib.urlencode(parameters);

# Post the data.
net = urllib.urlopen(url,encodedParams);

# return the result.
return(net.read());

if __name__ == "__main__":

# Set the URL manually
url = 'http://sim3015.aditi.lindenlab.com:12046/cap/d57a7c8b-3ace-3186-730a-f22fde870d48';

# Define the parameters
parameters = {'id':'244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name':'M Linden'}

# Pass the information along to the prim
info = submitInformation(url,parameters);
print(info);
</python>

=== Perl/Python Examples Using POST With Argument Parsing ===
Here are a set of scripts to provide another example using POST. In this example the scripts are adapted to handle the parsing of the arguments that are passed. The first script is the LSL code to receive the information on the grid. The second script is a PERL script that is used on the outside server to contact the code on the grid. The third script is a Python script that is also used on the outside server to contact the code on the grid. ([[User:Grandma Bates|Grandma Bates]] 12:42, 27 May 2009 (UTC))

<lsl>
key requestURL;

// ###############################################
// Routine to parse a string sent through the
// http server via post.
// parsePostData(theMessage)
// Returns a strided list with stride length 2.
// Each set has the key and then its value.
list parsePostData(string message) {
list postData = []; // The list with the data that was passed in.
list parsedMessage = llParseString2List(message,["&"],[]); // The key/value pairs parsed into one list.
integer len = ~llGetListLength(parsedMessage);

while(++len) {
string currentField = llList2String(parsedMessage, len); // Current key/value pair as a string.

integer split = llSubStringIndex(currentField,"="); // Find the "=" sign
if(split == -1) { // There is only one field in this part of the message.
postData += [llUnescapeURL(currentField),""];
} else {
postData += [llUnescapeURL(llDeleteSubString(currentField,split,-1)), llUnescapeURL(llDeleteSubString(currentField,0,split))];
}
}
// Return the strided list.
return postData ;
}

default {

state_entry() {
requestURL = llRequestURL(); // Request that an URL be assigned to me.
}

http_request(key id, string method, string body) {
list incomingMessage;

if ((method == URL_REQUEST_GRANTED) && (id == requestURL) ){
// An URL has been assigned to me.
llOwnerSay("Obtained URL: " + body);
requestURL = NULL_KEY;
}
else if ((method == URL_REQUEST_DENIED) && (id == requestURL)) {
// I could not obtain a URL
llOwnerSay("There was a problem, and an URL was not assigned: " +
body);
requestURL = NULL_KEY;
}
else if (method == "POST") {
// An incoming message was received.
llOwnerSay("Received information form the outside: " + body);
incomingMessage = parsePostData(body);
llOwnerSay(llDumpList2String(incomingMessage,"\n"));

llHTTPResponse(id,200,"You passed the following:\n" +
llDumpList2String(incomingMessage,"\n"));

}
else {
// An incoming message has come in using a method that has
// not been anticipated.
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

Here is the coresponding PERL script for contacting the LSL script on the grid.

<perl>
#!/usr/bin/perl
# Routine to contact a script on the SL Grid using http server
use strict;
use warnings;

use LWP;

my $browser = LWP::UserAgent->new;

sub submitInformation) {
my( $url, $params ) = @_;
return $browser->post( $url, $params )->content;
}

# Set the URL manually....
my $url = 'http://sim3015.aditi.lindenlab.com:12046/cap/5a1b89cd-e681-8110-7245-fb98969f32a0';

my $info = submitInformation( $url, {
'action' => 'send message',
'value' => 'Hi there chief!',
'id' => '244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name' => 'M Linden',
});

print($info,"\n");

</perl>

Here is the coresponding Python script. It does the same thing as the Perl script above.

<python>
#!/usr/bin/python

import urllib
import re

# #################################################
# Routine to send the information to the prim
# submitInformation(url,information)
#
def submitInformation(url,parameters) :

# encodedParams = urllib.urlencode(parameters); # encode the parameters
encodedParams = dictionary2URI(parameters); # encode the parameters
net = urllib.urlopen(url,encodedParams); # Post the data.
return(net.read()); # return the result.

# ################################################
# Routine to encode a dictionary without using
# "+" for spaces.
# dictionary2URI(theDictionary)
def dictionary2URI(theDictionary) :

encoded = ''; # Initialize the string to return
for key, value in theDictionary.iteritems():
# Encode each item in the dictionary.
encoded += urllib.quote(key)+"="+urllib.quote(value)+"&";

remove = re.compile('&$') # Remove the trailing ampersand.
encoded = remove.sub('',encoded);

return(encoded);

if __name__ == "__main__":

# Set the URL manually
url = 'http://sim3015.aditi.lindenlab.com:12046/cap/5a1b89cd-e681-8110-7245-fb98969f32a0';

# Define the parameters
parameters = {'id':'244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name':'M Linden',
'action':'send message',
'value':'Hey there, hi there, ho there!'};

# Pass the information along to the prim
info = submitInformation(url,parameters);
print(info);
</python>
<div style="display:none;"><lsl></lsl></div>

=== Simple script for sending data to an LSL via PHP ===
This example by Simba Fuhr '''UPDATE April 16, 2011'''
{{Warning|Some hosting providers only allow fsockopen on the standard 80 and 443 ports. This script will not work on those providers. If your provider is willing to open some ports for you, HTTP-in uses port 12046, and HTTPS-in uses port 12043.}}

'''Note:'''
To use SSL encrypted sockets, you need to have SSL activated on your server. If you run your own server, you need to import the ssl support to your server (apache => apache.conf +"LoadModule ssl_module modules/mod_ssl.so")(normaly based on openssl).

Secure URL Request with LSL.
Script returns the URL to the chat. Please put the URL into the PHP below.
<lsl>
default
{
state_entry()
{
llRequestSecureURL();
}
http_request(key id, string method, string body)
{
if ((method == URL_REQUEST_GRANTED))
{
llOwnerSay("URL: " + body);
}
else if (method == "POST")
{
llOwnerSay("PHP script sent: {" + body + "}");
llHTTPResponse(id, 200, "PHP script sent: {" + body + "}");
}
}
}
</lsl>

Here the PHP.
A more advanced php function which supports complete url structures and automatical GET and POST types.
Just don't submit any post Data to make a GET request.
The Function supports any kind of url as secure and not secure (https and http).
If you dont submit a port in the url, the default port for http (80) and https (443) will be used.
(An example is shown on the top of the script.)

<php>
<?php
echo "LSL Script answered:<br>";
echo Advanced_HTTP_Request("https://sim20557.agni.lindenlab.com:12043/cap/5851e666-b0c6-f0a0-758a-9e8156765215", "Hello script, how are you ?");

function Advanced_HTTP_Request($Host, $PostData = "")
{
$Method = "POST";
if (empty($PostData))
{$Method = "GET";}
$Port = 80;
if (strtolower(substr($Host, 0, 5)) == "https")
{$Port = 443;}
$Host = explode("//", $Host, 2);
if (count($Host) < 2)
{$Host[1] = $Host[0];}
$Host = explode("/", $Host[1], 2);
if ($Port == 443)
{$SSLAdd = "ssl://";}
$Host[0] = explode(":", $Host[0]);
if (count($Host[0]) > 1)
{
$Port = $Host[0][1];
$Host[0] = $Host[0][0];
}
else
{$Host[0] = $Host[0][0];}
$Socket = fsockopen($SSLAdd.$Host[0], $Port, $Dummy1, $Dummy2, 10);
if ($Socket)
{
fputs($Socket, "$Method /$Host[1] HTTP/1.1\r\n".
"Host: $Host[0]\r\n".
"Content-type: application/x-www-form-urlencoded\r\n".
"User-Agent: Opera/9.01 (Windows NT 5.1; U; en)\r\n".
"Accept-Language: de-DE,de;q=0.9,en;q=0.8\r\n".
"Accept-Charset: iso-8859-1, utf-8, utf-16, *;q=0.1\r\n".
"Content-length: ".strlen($PostData)."\r\n".
"Connection: close\r\n".
"\r\n".
$PostData);
$Tme = time();
while(!feof($Socket) && $Tme + 30 > time())
{$Res = $Res.fgets($Socket, 256);}
fclose($Socket);
}
$Res = explode("\r\n\r\n", $Res, 2);
return $Res[1];
}
?>
</php>

=== Kelly's Stupid Web Status Updater ===
Is actually on its own page: [[LSL_http_server/examples/kellys_stupid_web_status_updater | Kelly's Stupid Web Status Updater]]<br>
Kurai's mod from Kelly's stupid thing: [[LSL_http_server/examples/kurais_stupid_web_status_updater| Kurai's Stupid Web Status Updater Mod]]
{{LSLC|HTTP}}{{LSLC|Examples}}

=== Web-based dynamic buildings ===
HTTP-in may be used to easily send commands from a web page to an in-world object, so that web users can control and interact with buildings. The interactive installation ''Chromutate'' is based upon this idea: see its [[User:Opensource_Obscure/Chromutate|documentation page]] for free scripts and more details.

=== PHP/SQL Object DNS ===
Simple DNS server written in PHP to facilitate a DNS service for LSL scripts
[[LSL_http_server/examples/phpdns|PHPDNS]]

LSL HTTP server/examples

2012-06-14T00:02:11Z

Techplex Engineer: /* Echo World */

{{LSL Header|ml=*}}
=== Utility Script ===
A script intended as a 'fill in the blank' exercise for very, very simple HTTP servers is here: [[LSL_http_server/examples/utility_script | Utility Script]]
=== Hello World! ===
Classic example, the smallest http_request script possible.
<lsl>
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == "GET")
{
llHTTPResponse(id,200,"Hello World!");
}
}
}
</lsl>
A slightly more robust version:
<lsl>
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
llHTTPResponse(id,200,"Hello World!");
}
else
{
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

=== Echo World ===
"Echo World ([[User:Byrd Sciavo|Byrd Sciavo]] 04:19, 7 October 2009 (UTC))" is a slightly more useful "Hello World", demonstrating a basic server that echos back dynamic data fed. Echo World shows how http_request receives GET variables. To receive this "dynamic echo", append your cap url with a query string, such as https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322/foo/bar?arg=gra
<lsl>
string url;
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
url=body;llOwnerSay(url);
}
else if(method=="GET")
{
if(llGetHTTPHeader(id,"x-query-string")=="")
llHTTPResponse(id,200,"I ECHO when you append some GET variables to me, e.g., /?var=foo");
else
llHTTPResponse(id,200,llGetHTTPHeader(id,"x-query-string"));
}
}
}
</lsl>

=== Visitor List ===
A list of residents within sensor range of the server.
<br>Notes:
* This includes a method for handling multiple requests while waiting for asynchronous data requests to come back.
<lsl>integer scanning = FALSE;

list requests;

send_response(string body)
{
integer j;
for (j = 0; j < llGetListLength(requests); ++j)
{
llHTTPResponse(llList2Key(requests,j), 200, body);
}
requests = [];
}

default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
if (!scanning)
{
llSensor("",NULL_KEY,AGENT,96,PI);
scanning = TRUE;
}

requests += [id];
}
else
{
llHTTPResponse(id,405,"Unsupported method.");
}
}

no_sensor()
{
send_response("There is no one here.");
scanning = FALSE;
}

sensor(integer n)
{
string output;
if (n < 16) output = "There are " + (string)n + " avatars nearby:";
else output = "There are at least 16 avatars nearby:";

integer i;
for (i = 0;i<n;++i)
{
output += "\n\t" + llDetectedName(i);
}

send_response(output);

scanning = FALSE;
}
}
</lsl>

=== Url Persistence / Visitor Counter ===
A more complete 'hello world', always has an url and keeps a visitor counter.
<lsl>
string url;
integer hits;

setup()
{
llSetObjectName("HTTP Server");
url = "";
llRequestURL();
hits = (integer)llGetObjectDesc();
llSetText((string)hits + " visitors.",<1,1,0>,1);
}

default
{
state_entry() { setup(); }
on_rez(integer n) { setup(); }

changed(integer c)
{
if (c & (CHANGED_REGION | CHANGED_REGION_START | CHANGED_TELEPORT) )
{
setup();
}
}

touch_start(integer n)
{
llSay(0,"My url is: " + url);
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
url = body;
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
++hits;
llSetObjectDesc((string)hits);
llSetText((string)hits + " visitors.",<1,1,0>,1);
llHTTPResponse(id,200,"Hello! You are visitor " + (string)hits + ".");
}
else
{
llHTTPResponse(id,405,"Method unsupported");
}
}
}
</lsl>

=== Perl/Python Examples Using POST ===
Here are a set of scripts to provide another example using POST. The first script is the LSL code to receive the information on the grid. The second script is a Perl script that is used on the outside server to contact the code on the grid. The third script is a Python script that is also used on the outside server to contact the code on the grid. ([[User:Grandma Bates|Grandma Bates]] 12:42, 27 May 2009 (UTC))
<lsl>
key requestURL;

default
{

state_entry()
{
requestURL = llRequestURL(); // Request that an URL be assigned to me.
}

http_request(key id, string method, string body)
{
if ((method == URL_REQUEST_GRANTED) && (id == requestURL) )
{
// An URL has been assigned to me.
llOwnerSay("Obtained URL: " + body);
requestURL = NULL_KEY;
}
else if ((method == URL_REQUEST_DENIED) && (id == requestURL))
{
// I could not obtain a URL
llOwnerSay("There was a problem, and an URL was not assigned: " + body);
requestURL = NULL_KEY;
}

else if (method == "POST")
{
// An incoming message was received.
llOwnerSay("Received information from the outside: " + body);
llHTTPResponse(id,200,"Thank you for calling. All of our operators are busy.");
}
else
{
// An incoming message has come in using a method that has not been anticipated.
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

Here is the Perl script to contact the prim on the grid.

<perl>
#!/usr/bin/perl
# Routine to contact a script on the SL Grid using http server
use strict;
use warnings;
use LWP;

my $browser = LWP::UserAgent->new;

sub submitInformation) {
my( $url, $params ) = @_;
return $browser->post( $url, $params )->content;
}

# Set the URL manually....
my $url = 'http://sim3015.aditi.lindenlab.com:12046/cap/d57a7c8b-3ace-3186-730a-f22fde870d48';

my $info = submitInformation( $url, {
id => '244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
name => 'M Linden',
} );

print $info,"\n";
</perl>

Here is the Python code that does the same thing as the PERL code above.

<python>
#!/usr/bin/python

import urllib

# #################################################
# Routine to send the information to the prim
# submitInformation(url,information)
#
def submitInformation(url,parameters) :
# Set the parameters to be sent.
encodedParams = urllib.urlencode(parameters);

# Post the data.
net = urllib.urlopen(url,encodedParams);

# return the result.
return(net.read());

if __name__ == "__main__":

# Set the URL manually
url = 'http://sim3015.aditi.lindenlab.com:12046/cap/d57a7c8b-3ace-3186-730a-f22fde870d48';

# Define the parameters
parameters = {'id':'244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name':'M Linden'}

# Pass the information along to the prim
info = submitInformation(url,parameters);
print(info);
</python>

=== Perl/Python Examples Using POST With Argument Parsing ===
Here are a set of scripts to provide another example using POST. In this example the scripts are adapted to handle the parsing of the arguments that are passed. The first script is the LSL code to receive the information on the grid. The second script is a PERL script that is used on the outside server to contact the code on the grid. The third script is a Python script that is also used on the outside server to contact the code on the grid. ([[User:Grandma Bates|Grandma Bates]] 12:42, 27 May 2009 (UTC))

<lsl>
key requestURL;

// ###############################################
// Routine to parse a string sent through the
// http server via post.
// parsePostData(theMessage)
// Returns a strided list with stride length 2.
// Each set has the key and then its value.
list parsePostData(string message) {
list postData = []; // The list with the data that was passed in.
list parsedMessage = llParseString2List(message,["&"],[]); // The key/value pairs parsed into one list.
integer len = ~llGetListLength(parsedMessage);

while(++len) {
string currentField = llList2String(parsedMessage, len); // Current key/value pair as a string.

integer split = llSubStringIndex(currentField,"="); // Find the "=" sign
if(split == -1) { // There is only one field in this part of the message.
postData += [llUnescapeURL(currentField),""];
} else {
postData += [llUnescapeURL(llDeleteSubString(currentField,split,-1)), llUnescapeURL(llDeleteSubString(currentField,0,split))];
}
}
// Return the strided list.
return postData ;
}

default {

state_entry() {
requestURL = llRequestURL(); // Request that an URL be assigned to me.
}

http_request(key id, string method, string body) {
list incomingMessage;

if ((method == URL_REQUEST_GRANTED) && (id == requestURL) ){
// An URL has been assigned to me.
llOwnerSay("Obtained URL: " + body);
requestURL = NULL_KEY;
}
else if ((method == URL_REQUEST_DENIED) && (id == requestURL)) {
// I could not obtain a URL
llOwnerSay("There was a problem, and an URL was not assigned: " +
body);
requestURL = NULL_KEY;
}
else if (method == "POST") {
// An incoming message was received.
llOwnerSay("Received information form the outside: " + body);
incomingMessage = parsePostData(body);
llOwnerSay(llDumpList2String(incomingMessage,"\n"));

llHTTPResponse(id,200,"You passed the following:\n" +
llDumpList2String(incomingMessage,"\n"));

}
else {
// An incoming message has come in using a method that has
// not been anticipated.
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

Here is the coresponding PERL script for contacting the LSL script on the grid.

<perl>
#!/usr/bin/perl
# Routine to contact a script on the SL Grid using http server
use strict;
use warnings;

use LWP;

my $browser = LWP::UserAgent->new;

sub submitInformation) {
my( $url, $params ) = @_;
return $browser->post( $url, $params )->content;
}

# Set the URL manually....
my $url = 'http://sim3015.aditi.lindenlab.com:12046/cap/5a1b89cd-e681-8110-7245-fb98969f32a0';

my $info = submitInformation( $url, {
'action' => 'send message',
'value' => 'Hi there chief!',
'id' => '244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name' => 'M Linden',
});

print($info,"\n");

</perl>

Here is the coresponding Python script. It does the same thing as the Perl script above.

<python>
#!/usr/bin/python

import urllib
import re

# #################################################
# Routine to send the information to the prim
# submitInformation(url,information)
#
def submitInformation(url,parameters) :

# encodedParams = urllib.urlencode(parameters); # encode the parameters
encodedParams = dictionary2URI(parameters); # encode the parameters
net = urllib.urlopen(url,encodedParams); # Post the data.
return(net.read()); # return the result.

# ################################################
# Routine to encode a dictionary without using
# "+" for spaces.
# dictionary2URI(theDictionary)
def dictionary2URI(theDictionary) :

encoded = ''; # Initialize the string to return
for key, value in theDictionary.iteritems():
# Encode each item in the dictionary.
encoded += urllib.quote(key)+"="+urllib.quote(value)+"&";

remove = re.compile('&$') # Remove the trailing ampersand.
encoded = remove.sub('',encoded);

return(encoded);

if __name__ == "__main__":

# Set the URL manually
url = 'http://sim3015.aditi.lindenlab.com:12046/cap/5a1b89cd-e681-8110-7245-fb98969f32a0';

# Define the parameters
parameters = {'id':'244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name':'M Linden',
'action':'send message',
'value':'Hey there, hi there, ho there!'};

# Pass the information along to the prim
info = submitInformation(url,parameters);
print(info);
</python>
<div style="display:none;"><lsl></lsl></div>

=== Simple script for sending data to an LSL via PHP ===
This example by Simba Fuhr '''UPDATE April 16, 2011'''
{{Warning|Some hosting providers only allow fsockopen on the standard 80 and 443 ports. This script will not work on those providers. If your provider is willing to open some ports for you, HTTP-in uses port 12046, and HTTPS-in uses port 12043.}}

'''Note:'''
To use SSL encrypted sockets, you need to have SSL activated on your server. If you run your own server, you need to import the ssl support to your server (apache => apache.conf +"LoadModule ssl_module modules/mod_ssl.so")(normaly based on openssl).

Secure URL Request with LSL.
Script returns the URL to the chat. Please put the URL into the PHP below.
<lsl>
default
{
state_entry()
{
llRequestSecureURL();
}
http_request(key id, string method, string body)
{
if ((method == URL_REQUEST_GRANTED))
{
llOwnerSay("URL: " + body);
}
else if (method == "POST")
{
llOwnerSay("PHP script sent: {" + body + "}");
llHTTPResponse(id, 200, "PHP script sent: {" + body + "}");
}
}
}
</lsl>

Here the PHP.
A more advanced php function which supports complete url structures and automatical GET and POST types.
Just don't submit any post Data to make a GET request.
The Function supports any kind of url as secure and not secure (https and http).
If you dont submit a port in the url, the default port for http (80) and https (443) will be used.
(An example is shown on the top of the script.)

<php>
<?php
echo "LSL Script answered:<br>";
echo Advanced_HTTP_Request("https://sim20557.agni.lindenlab.com:12043/cap/5851e666-b0c6-f0a0-758a-9e8156765215", "Hello script, how are you ?");

function Advanced_HTTP_Request($Host, $PostData = "")
{
$Method = "POST";
if (empty($PostData))
{$Method = "GET";}
$Port = 80;
if (strtolower(substr($Host, 0, 5)) == "https")
{$Port = 443;}
$Host = explode("//", $Host, 2);
if (count($Host) < 2)
{$Host[1] = $Host[0];}
$Host = explode("/", $Host[1], 2);
if ($Port == 443)
{$SSLAdd = "ssl://";}
$Host[0] = explode(":", $Host[0]);
if (count($Host[0]) > 1)
{
$Port = $Host[0][1];
$Host[0] = $Host[0][0];
}
else
{$Host[0] = $Host[0][0];}
$Socket = fsockopen($SSLAdd.$Host[0], $Port, $Dummy1, $Dummy2, 10);
if ($Socket)
{
fputs($Socket, "$Method /$Host[1] HTTP/1.1\r\n".
"Host: $Host[0]\r\n".
"Content-type: application/x-www-form-urlencoded\r\n".
"User-Agent: Opera/9.01 (Windows NT 5.1; U; en)\r\n".
"Accept-Language: de-DE,de;q=0.9,en;q=0.8\r\n".
"Accept-Charset: iso-8859-1, utf-8, utf-16, *;q=0.1\r\n".
"Content-length: ".strlen($PostData)."\r\n".
"Connection: close\r\n".
"\r\n".
$PostData);
$Tme = time();
while(!feof($Socket) && $Tme + 30 > time())
{$Res = $Res.fgets($Socket, 256);}
fclose($Socket);
}
$Res = explode("\r\n\r\n", $Res, 2);
return $Res[1];
}
?>
</php>

=== Kelly's Stupid Web Status Updater ===
Is actually on its own page: [[LSL_http_server/examples/kellys_stupid_web_status_updater | Kelly's Stupid Web Status Updater]]<br>
Kurai's mod from Kelly's stupid thing: [[LSL_http_server/examples/kurais_stupid_web_status_updater| Kurai's Stupid Web Status Updater Mod]]
{{LSLC|HTTP}}{{LSLC|Examples}}

=== Web-based dynamic buildings ===
HTTP-in may be used to easily send commands from a web page to an in-world object, so that web users can control and interact with buildings. The interactive installation ''Chromutate'' is based upon this idea: see its [[User:Opensource_Obscure/Chromutate|documentation page]] for free scripts and more details.

=== PHP/SQL Object DNS ===
Simple DNS server written in PHP to facilitate a DNS service for LSL scripts
[[LSL_http_server/examples/phpdns|PHPDNS]]

LSL HTTP server/examples

2012-06-13T23:48:34Z

Techplex Engineer: /* Perl/Python Examples Using POST */ Fixed some formatting

{{LSL Header|ml=*}}
=== Utility Script ===
A script intended as a 'fill in the blank' exercise for very, very simple HTTP servers is here: [[LSL_http_server/examples/utility_script | Utility Script]]
=== Hello World! ===
Classic example, the smallest http_request script possible.
<lsl>
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == "GET")
{
llHTTPResponse(id,200,"Hello World!");
}
}
}
</lsl>
A slightly more robust version:
<lsl>
default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
llHTTPResponse(id,200,"Hello World!");
}
else
{
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

=== Echo World ===
"Echo World ([[User:Byrd Sciavo|Byrd Sciavo]] 04:19, 7 October 2009 (UTC))" is a slightly more useful "Hello World", demonstrating a basic server that echos back dynamic data fed. Echo World shows how http_request receives GET variables. To receive this "dynamic echo", append your cap url with a query string, such as https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322/foo/bar?arg=gra
<lsl>
string url;
default
{
state_entry(){
llRequestURL();
}

http_request(key id, string method, string body){
if (method == URL_REQUEST_GRANTED) {
url=body;llOwnerSay(url);
}else if(method=="GET"){
if(llGetHTTPHeader(id,"x-query-string")=="") llHTTPResponse(id,200,"I ECHO when you append some GET variables to me, e.g., /?var=foo");
else llHTTPResponse(id,200,llGetHTTPHeader(id,"x-query-string"));
}
}
}
</lsl>

=== Visitor List ===
A list of residents within sensor range of the server.
<br>Notes:
* This includes a method for handling multiple requests while waiting for asynchronous data requests to come back.
<lsl>integer scanning = FALSE;

list requests;

send_response(string body)
{
integer j;
for (j = 0; j < llGetListLength(requests); ++j)
{
llHTTPResponse(llList2Key(requests,j), 200, body);
}
requests = [];
}

default
{
state_entry()
{
llRequestURL();
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
llSay(0,"URL: " + body);
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
if (!scanning)
{
llSensor("",NULL_KEY,AGENT,96,PI);
scanning = TRUE;
}

requests += [id];
}
else
{
llHTTPResponse(id,405,"Unsupported method.");
}
}

no_sensor()
{
send_response("There is no one here.");
scanning = FALSE;
}

sensor(integer n)
{
string output;
if (n < 16) output = "There are " + (string)n + " avatars nearby:";
else output = "There are at least 16 avatars nearby:";

integer i;
for (i = 0;i<n;++i)
{
output += "\n\t" + llDetectedName(i);
}

send_response(output);

scanning = FALSE;
}
}
</lsl>

=== Url Persistence / Visitor Counter ===
A more complete 'hello world', always has an url and keeps a visitor counter.
<lsl>
string url;
integer hits;

setup()
{
llSetObjectName("HTTP Server");
url = "";
llRequestURL();
hits = (integer)llGetObjectDesc();
llSetText((string)hits + " visitors.",<1,1,0>,1);
}

default
{
state_entry() { setup(); }
on_rez(integer n) { setup(); }

changed(integer c)
{
if (c & (CHANGED_REGION | CHANGED_REGION_START | CHANGED_TELEPORT) )
{
setup();
}
}

touch_start(integer n)
{
llSay(0,"My url is: " + url);
}

http_request(key id, string method, string body)
{
if (method == URL_REQUEST_GRANTED)
{
url = body;
}
else if (method == URL_REQUEST_DENIED)
{
llSay(0, "Something went wrong, no url. " + body);
}
else if (method == "GET")
{
++hits;
llSetObjectDesc((string)hits);
llSetText((string)hits + " visitors.",<1,1,0>,1);
llHTTPResponse(id,200,"Hello! You are visitor " + (string)hits + ".");
}
else
{
llHTTPResponse(id,405,"Method unsupported");
}
}
}
</lsl>

=== Perl/Python Examples Using POST ===
Here are a set of scripts to provide another example using POST. The first script is the LSL code to receive the information on the grid. The second script is a Perl script that is used on the outside server to contact the code on the grid. The third script is a Python script that is also used on the outside server to contact the code on the grid. ([[User:Grandma Bates|Grandma Bates]] 12:42, 27 May 2009 (UTC))
<lsl>
key requestURL;

default
{

state_entry()
{
requestURL = llRequestURL(); // Request that an URL be assigned to me.
}

http_request(key id, string method, string body)
{
if ((method == URL_REQUEST_GRANTED) && (id == requestURL) )
{
// An URL has been assigned to me.
llOwnerSay("Obtained URL: " + body);
requestURL = NULL_KEY;
}
else if ((method == URL_REQUEST_DENIED) && (id == requestURL))
{
// I could not obtain a URL
llOwnerSay("There was a problem, and an URL was not assigned: " + body);
requestURL = NULL_KEY;
}

else if (method == "POST")
{
// An incoming message was received.
llOwnerSay("Received information from the outside: " + body);
llHTTPResponse(id,200,"Thank you for calling. All of our operators are busy.");
}
else
{
// An incoming message has come in using a method that has not been anticipated.
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

Here is the Perl script to contact the prim on the grid.

<perl>
#!/usr/bin/perl
# Routine to contact a script on the SL Grid using http server
use strict;
use warnings;
use LWP;

my $browser = LWP::UserAgent->new;

sub submitInformation) {
my( $url, $params ) = @_;
return $browser->post( $url, $params )->content;
}

# Set the URL manually....
my $url = 'http://sim3015.aditi.lindenlab.com:12046/cap/d57a7c8b-3ace-3186-730a-f22fde870d48';

my $info = submitInformation( $url, {
id => '244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
name => 'M Linden',
} );

print $info,"\n";
</perl>

Here is the Python code that does the same thing as the PERL code above.

<python>
#!/usr/bin/python

import urllib

# #################################################
# Routine to send the information to the prim
# submitInformation(url,information)
#
def submitInformation(url,parameters) :
# Set the parameters to be sent.
encodedParams = urllib.urlencode(parameters);

# Post the data.
net = urllib.urlopen(url,encodedParams);

# return the result.
return(net.read());

if __name__ == "__main__":

# Set the URL manually
url = 'http://sim3015.aditi.lindenlab.com:12046/cap/d57a7c8b-3ace-3186-730a-f22fde870d48';

# Define the parameters
parameters = {'id':'244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name':'M Linden'}

# Pass the information along to the prim
info = submitInformation(url,parameters);
print(info);
</python>

=== Perl/Python Examples Using POST With Argument Parsing ===
Here are a set of scripts to provide another example using POST. In this example the scripts are adapted to handle the parsing of the arguments that are passed. The first script is the LSL code to receive the information on the grid. The second script is a PERL script that is used on the outside server to contact the code on the grid. The third script is a Python script that is also used on the outside server to contact the code on the grid. ([[User:Grandma Bates|Grandma Bates]] 12:42, 27 May 2009 (UTC))

<lsl>
key requestURL;

// ###############################################
// Routine to parse a string sent through the
// http server via post.
// parsePostData(theMessage)
// Returns a strided list with stride length 2.
// Each set has the key and then its value.
list parsePostData(string message) {
list postData = []; // The list with the data that was passed in.
list parsedMessage = llParseString2List(message,["&"],[]); // The key/value pairs parsed into one list.
integer len = ~llGetListLength(parsedMessage);

while(++len) {
string currentField = llList2String(parsedMessage, len); // Current key/value pair as a string.

integer split = llSubStringIndex(currentField,"="); // Find the "=" sign
if(split == -1) { // There is only one field in this part of the message.
postData += [llUnescapeURL(currentField),""];
} else {
postData += [llUnescapeURL(llDeleteSubString(currentField,split,-1)), llUnescapeURL(llDeleteSubString(currentField,0,split))];
}
}
// Return the strided list.
return postData ;
}

default {

state_entry() {
requestURL = llRequestURL(); // Request that an URL be assigned to me.
}

http_request(key id, string method, string body) {
list incomingMessage;

if ((method == URL_REQUEST_GRANTED) && (id == requestURL) ){
// An URL has been assigned to me.
llOwnerSay("Obtained URL: " + body);
requestURL = NULL_KEY;
}
else if ((method == URL_REQUEST_DENIED) && (id == requestURL)) {
// I could not obtain a URL
llOwnerSay("There was a problem, and an URL was not assigned: " +
body);
requestURL = NULL_KEY;
}
else if (method == "POST") {
// An incoming message was received.
llOwnerSay("Received information form the outside: " + body);
incomingMessage = parsePostData(body);
llOwnerSay(llDumpList2String(incomingMessage,"\n"));

llHTTPResponse(id,200,"You passed the following:\n" +
llDumpList2String(incomingMessage,"\n"));

}
else {
// An incoming message has come in using a method that has
// not been anticipated.
llHTTPResponse(id,405,"Unsupported Method");
}
}
}
</lsl>

Here is the coresponding PERL script for contacting the LSL script on the grid.

<perl>
#!/usr/bin/perl
# Routine to contact a script on the SL Grid using http server
use strict;
use warnings;

use LWP;

my $browser = LWP::UserAgent->new;

sub submitInformation) {
my( $url, $params ) = @_;
return $browser->post( $url, $params )->content;
}

# Set the URL manually....
my $url = 'http://sim3015.aditi.lindenlab.com:12046/cap/5a1b89cd-e681-8110-7245-fb98969f32a0';

my $info = submitInformation( $url, {
'action' => 'send message',
'value' => 'Hi there chief!',
'id' => '244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name' => 'M Linden',
});

print($info,"\n");

</perl>

Here is the coresponding Python script. It does the same thing as the Perl script above.

<python>
#!/usr/bin/python

import urllib
import re

# #################################################
# Routine to send the information to the prim
# submitInformation(url,information)
#
def submitInformation(url,parameters) :

# encodedParams = urllib.urlencode(parameters); # encode the parameters
encodedParams = dictionary2URI(parameters); # encode the parameters
net = urllib.urlopen(url,encodedParams); # Post the data.
return(net.read()); # return the result.

# ################################################
# Routine to encode a dictionary without using
# "+" for spaces.
# dictionary2URI(theDictionary)
def dictionary2URI(theDictionary) :

encoded = ''; # Initialize the string to return
for key, value in theDictionary.iteritems():
# Encode each item in the dictionary.
encoded += urllib.quote(key)+"="+urllib.quote(value)+"&";

remove = re.compile('&$') # Remove the trailing ampersand.
encoded = remove.sub('',encoded);

return(encoded);

if __name__ == "__main__":

# Set the URL manually
url = 'http://sim3015.aditi.lindenlab.com:12046/cap/5a1b89cd-e681-8110-7245-fb98969f32a0';

# Define the parameters
parameters = {'id':'244195d6-c9b7-4fd6-9229-c3a8b2e60e81',
'name':'M Linden',
'action':'send message',
'value':'Hey there, hi there, ho there!'};

# Pass the information along to the prim
info = submitInformation(url,parameters);
print(info);
</python>
<div style="display:none;"><lsl></lsl></div>

=== Simple script for sending data to an LSL via PHP ===
This example by Simba Fuhr '''UPDATE April 16, 2011'''
{{Warning|Some hosting providers only allow fsockopen on the standard 80 and 443 ports. This script will not work on those providers. If your provider is willing to open some ports for you, HTTP-in uses port 12046, and HTTPS-in uses port 12043.}}

'''Note:'''
To use SSL encrypted sockets, you need to have SSL activated on your server. If you run your own server, you need to import the ssl support to your server (apache => apache.conf +"LoadModule ssl_module modules/mod_ssl.so")(normaly based on openssl).

Secure URL Request with LSL.
Script returns the URL to the chat. Please put the URL into the PHP below.
<lsl>
default
{
state_entry()
{
llRequestSecureURL();
}
http_request(key id, string method, string body)
{
if ((method == URL_REQUEST_GRANTED))
{
llOwnerSay("URL: " + body);
}
else if (method == "POST")
{
llOwnerSay("PHP script sent: {" + body + "}");
llHTTPResponse(id, 200, "PHP script sent: {" + body + "}");
}
}
}
</lsl>

Here the PHP.
A more advanced php function which supports complete url structures and automatical GET and POST types.
Just don't submit any post Data to make a GET request.
The Function supports any kind of url as secure and not secure (https and http).
If you dont submit a port in the url, the default port for http (80) and https (443) will be used.
(An example is shown on the top of the script.)

<php>
<?php
echo "LSL Script answered:<br>";
echo Advanced_HTTP_Request("https://sim20557.agni.lindenlab.com:12043/cap/5851e666-b0c6-f0a0-758a-9e8156765215", "Hello script, how are you ?");

function Advanced_HTTP_Request($Host, $PostData = "")
{
$Method = "POST";
if (empty($PostData))
{$Method = "GET";}
$Port = 80;
if (strtolower(substr($Host, 0, 5)) == "https")
{$Port = 443;}
$Host = explode("//", $Host, 2);
if (count($Host) < 2)
{$Host[1] = $Host[0];}
$Host = explode("/", $Host[1], 2);
if ($Port == 443)
{$SSLAdd = "ssl://";}
$Host[0] = explode(":", $Host[0]);
if (count($Host[0]) > 1)
{
$Port = $Host[0][1];
$Host[0] = $Host[0][0];
}
else
{$Host[0] = $Host[0][0];}
$Socket = fsockopen($SSLAdd.$Host[0], $Port, $Dummy1, $Dummy2, 10);
if ($Socket)
{
fputs($Socket, "$Method /$Host[1] HTTP/1.1\r\n".
"Host: $Host[0]\r\n".
"Content-type: application/x-www-form-urlencoded\r\n".
"User-Agent: Opera/9.01 (Windows NT 5.1; U; en)\r\n".
"Accept-Language: de-DE,de;q=0.9,en;q=0.8\r\n".
"Accept-Charset: iso-8859-1, utf-8, utf-16, *;q=0.1\r\n".
"Content-length: ".strlen($PostData)."\r\n".
"Connection: close\r\n".
"\r\n".
$PostData);
$Tme = time();
while(!feof($Socket) && $Tme + 30 > time())
{$Res = $Res.fgets($Socket, 256);}
fclose($Socket);
}
$Res = explode("\r\n\r\n", $Res, 2);
return $Res[1];
}
?>
</php>

=== Kelly's Stupid Web Status Updater ===
Is actually on its own page: [[LSL_http_server/examples/kellys_stupid_web_status_updater | Kelly's Stupid Web Status Updater]]<br>
Kurai's mod from Kelly's stupid thing: [[LSL_http_server/examples/kurais_stupid_web_status_updater| Kurai's Stupid Web Status Updater Mod]]
{{LSLC|HTTP}}{{LSLC|Examples}}

=== Web-based dynamic buildings ===
HTTP-in may be used to easily send commands from a web page to an in-world object, so that web users can control and interact with buildings. The interactive installation ''Chromutate'' is based upon this idea: see its [[User:Opensource_Obscure/Chromutate|documentation page]] for free scripts and more details.

=== PHP/SQL Object DNS ===
Simple DNS server written in PHP to facilitate a DNS service for LSL scripts
[[LSL_http_server/examples/phpdns|PHPDNS]]

Limits

2012-03-18T04:16:25Z

Techplex Engineer: /* All Viewers */ added a note about bytes and characters

<noinclude>{{KBmaster}}</noinclude>
== Summary ==
{{RightToc}}
The Second Life Viewer and simulators have a division of labor, keeping track of the data that makes Second Life run. The Viewer's job is to:

* Handle locations of objects.
* Get velocities and other physics information, and does simple physics to keep track of what is moving where.

The simulator's job is to:

* Run the physics engine.
* Detect collisions.
* Keep track of where everything is
* Send locations of content to the Viewer along with updates when certain changes occur.

Limits are necessary for all of these components to work together. The list below outlines many of the '''Second Life numerical limits that affect your inworld experience'''. Some of these will likely change over time, so if you spot something incorrect/outdated, please take a moment to update it.

{{KBcaution|1=The scope of this page is focused on Linden Lab's official Viewers, keeping in mind [[Third_Party_Viewer_Directory|3rd-party viewers may differ]]. Cite sources and provide substantiation for limits that aren't provided by Linden Lab. Also, unconfirmed speculation [[Talk:Limits|goes on this discussion page]]. Don't add data without a hard limit, and don't add obscure trivia that doesn't practically affect the general inworld experience.}}

== [[Avatar]] ==

* '''Max. # of attachment points''' - 30 for avatar, 8 for [[HUD]].
** They can be viewed by right-clicking your avatar and choosing '''Take Off''' > '''HUD''' or '''Detach'''.
** With the formal introduction of [[multiple attachments|multiple attachments to a single point]] in Viewer 2.4, you can attach up to 38 total objects, and they can all be attached to a single point.
* '''Max. unassisted fly height''' - Stable hover almost 150m above the ground (terrain mesh).
** You can easily acquire a flight attachment to fly high. Also see [[flight limit]] and [[Limits#Navigation|the Navigation section]] below.
* '''Common shoe sizes''' - Most women's shoes are designed for a size 0 (zero) foot. Men's generally scale up to 14.
** You can check this by going to Edit menu > Appearance and clicking on the Shape > Legs tab.

* '''Max. length of avatar name''' - 31 for first name, 31 for last name, 63 in total (including the space).

* '''Max. length of {{LSLGC|Username}}''' - All lower case and a maximum of 63 including the '.'(eg; firstname.lastname)
**Older account user names are a combination of the First and last name in lower case separated by a period(.)(eg; lilmix.pixelmaid)
**Modern user names are a single name(no period)(eg; john1234) - '''Max.''' length is 31 characters
**The {{LSLGC|Legacy Name}}s for modern user names always shows Resident as the last name. So the Max is 40 characters in total for a new avatar's legacy name(including the space and last name 'Resident')
*'''Min. length of [[Display_Names]]''' - At least one script character
*'''Max. length of Display Names''' - 31 characters
**Display Names can include most Unicode script characters, spaces, and some punctuation.

* '''Max. avatar speed''' - 250m/s (with only attachments to assist)
* '''Max. teleport speed'''
** '''Server 1.27.1''' - 10 teleports per 15 seconds
** '''Server 1.27.0''' - 3 teleports per 15 seconds

== [[Animation]] ==

* '''Max. length of animation:''' 30.0 seconds
* '''Min. animation priority:''' 0
* '''Max. animation priority:''' 4

== Building ==

* '''Max. [[prim]] dimensions (non-[[megaprim]])''' - 64×64×64m
** it was 10×10×10m before SL Server 3.0.0 (238864)
* '''Min. prim dimensions''' - 0.01×0.01×0.01m
* '''Max. # of prims in a linkset''' - 256
** It was 255 before SL Server 1.26.
* '''Max. link distance''' - See [[Linkability Rules]].
* '''Max. # of prims in a physical object''' - 32
** If you try to link more, it'll either say "Can't enable physics for objects with more than 32 primitives" or "Object has too many primitives -- its dynamics have been disabled.".
** On server versions 1.38 and below, each sitting avatar counted as 1 prim. From 1.40.2 the limit is only on actual prims.
* '''Max. build or rez height''' - 4,096m
** This is 768m for Viewers prior to SL 1.20
* '''Max. prim name length''' - 63 bytes UTF-8 [[string]]
** Note: This is the same total character limit as avatar names.
* '''Max. prim description length''' - 127 bytes UTF-8 [[string]]
** Note:
* '''Temporary prim lifetime''' - around 60 seconds
* '''Max. number of temporary prims''' - regular_prim_limit - current_regular_prims + minimum(0.5 * regular_prim_limit + 400, 1000)
** From [http://forums-archive.secondlife.com/8/cd/305651/1.html Andrew Linden's February 2009 discussion])
* '''Max. length of hovertext (via [[llSetText]] or [[PRIM_TEXT]])''' - 254 bytes UTF-8 [[string]]

== Chat (text) ==

* '''Whisper distance''' - 10 m
* '''Chat distance''' - 20 m
* '''Shout distance''' - 100 m
** ''Rule of thumb:'' when you're at default zoom ('''View''' > '''Reset View'''), if you can see another person's nametag, they can see your chat. If they're far enough away that you don't see a nametag, they won't "hear" you unless you shout.
** Text spoken as a "Chat" step in a gesture cannot be shouted or whispered
** Text spoken as "Replace with" text in a gesture can be whispered or shouted in Viewer 2 either by putting <code>/whisper</code> or <code>/shout</code> at the start of the "Replace with" text or by typing <code>/whisper</code> or <code>/shout</code> at the beginning of the nearby chat input bar, followed by the gesture's trigger text. (Though, if you do both, or if a gesture with built-in <code>/whisper</code> or <code>/shout</code> is used mid-sentence, the "/whisper" or "/shout" will appear literally.) Viewer 1 does not honor <code>/whisper</code> or <code>/shout</code> and will always send them literally.
* '''Max. length of a chat message''' - 1023 bytes/single-byte characters
** The same holds true for an IM <-> email replies.
*** When the receiver is offline, if they set an IM to Email feature ('''Edit''' > '''Preferences''' (or press {{K|Ctrl|P}}), go to the '''Communication''' tab and check the '''Send IM to Email''' checkbox), it will send offline messages directly to the mailbox connected to your account. When an offline message is received via Email, this message can also be answered via Email again. The length of properly delivered Email replies is limited to 1023 bytes/single-byte characters.
* '''Capped''' - Maximum number of offline messages (involving [[IM]]s, inventory offers, group notices and group invitations) received before messages get capped is 25.
** Senders can't know whether their messages were capped or not.
* '''Email -> IM''' replies can be sent up to 5 days after receiving the offline IM the email is meant to answer.<sup>[<span class="plainlinks">[https://blogs.secondlife.com/community/features/blog/2007/02/06/im-to-e-mail-return-addresses-changing blog]</span>]</sup>
* '''IMs''' are retained on Linden Lab's servers for up to 31 days before being discarded. For example, if someone sends you an Instant Message and the next time you login is 33 days later, you won't get it.
** Torley confirmed this with Kelly Linden.
* The number of '''IMs''' an object can send in one hour is 5000.

== [[Gesture]]s ==

* '''Shortcut key mapping:''' 33 unique combinations, since {{K|F2}}–{{K|F12}} can be used with the {{K|Ctrl}} or {{K|Shift}} modifiers.
* '''Maximum Chat step length:''' 127 single-byte characters.
* '''Maximum Wait time:''' 3600 seconds (one hour).

== [[Group]]s ==

* '''Maximum number of groups you can belong to:''' 42
** Roles within groups are sort of like sub-groups. In many cases, you can use them instead of creating new groups.
* '''Minimum number of members in a group:''' 2
** A group with only 1 person for 48 hours will be disbanded (cancelled). Unless the group owns land.
* '''Maximum number of roles allowed in a group:''' 10 (including "Owners" and "Everyone", which cannot be deleted)
* '''Maximum Group Name:''' 35 single-byte characters.
* '''Maximum Group Title:''' 20 single-byte characters.
* '''Maximum Length of a Group Notice:''' 512 single-byte characters.

== [[Inventory]] ==

* '''Maximum number of inventory items that can be sent in a folder:''' 42
** Folders count as items too. This has more to do with packet size limits than cheeky Douglas Adams references.
* '''Maximum notecard line:''' None, but scripts can only read the first 255 bytes.
* '''Maximum notecard size:''' 65,536 bytes
* '''Number of items in the Library:''' 1,248 as of 2010-06-17
** Verified by [[How_does_the_Library_work|hiding the Library]] and counting the difference.

== [[Land]] ==

* '''Maximum [[Land#Parcel|parcel]] size:''' 65,536 meters²
** Covering a whole region, or square on the World Map.
* '''Minimum parcel size:''' 16 meters²
* '''Maximum parcel name length:''' 63 single-byte characters
* '''Maximum parcel description length:''' 255 characters
* '''Region name length:''' Under Linden Concierge policy, minimum of 3 characters, and a maximum of 25 characters (including spaces). See [[Linden Lab Official:Guidelines for Private Region Naming|Guidelines for Private Region Naming]].
** Rare exceptions exist, like [http://slurl.com/secondlife/Q/128/128/24 Q].
* '''Maximum "NO ENTRY" ban line height:''' 768 meters above the terrain mesh.
** This is if you are explicitly banned from a parcel. If the parcel is simply not public access or restricted to certain Residents or a group, then the access lines go up to 50 meters above the terrain mesh.
* '''Maximum prims in a [[Land#Region|region]]:'''
** Full region: 15,000
** [[Land#Homestead|Homestead]]: 3,750
** [[Land#Openspace|Openspace]]: 750
* '''Maximum auto return value''': Besides "0" (which means ''never''), {{HoverText|999,999|Almost 23 months}} minutes is the highest auto return value.
* '''Terraforming limits:'''
** Most mainland can be raised/lowered by 4 meters (+/-).
** Some mainland cannot be terraformed, including: Bay City Regions, Blumfield, Boardman, Brown, De Haro, Nautilus City Regions, Nova Albion Regions, Shermerville Regions, and West Haven.
** A few, very old mainland Regions like Da Boom have a terraform range of 40 meters (+/-).
** Estate (private island) terraformability is settable to a maximum of 100 meters (+/-) by the estate owner or managers.
* '''Maximum water height:''' 100 meters using inworld controls (mainland limit), 255 meters by using a *.raw file upload.
** Region water height is usually 20 meters, and adjacent regions should have the same water height, or else they will look discontinuous.
* '''Maximum terrain height:''' 255 meters using inworld controls (mainland limit), 510 meters by using a *.raw file upload.
* '''Miscellaneous estate limits:''' You can have a maximum of 10 estate managers, 500 allowed Residents, 63 allowed groups, and 500 banned Residents.
** See World menu > Region/Estate > Estate tab.
* '''Mainland maximum number of agents'''
** Full region: 100 (Historically set to 40 by LL but this does vary. Some meeting areas have this set to 60 and higher.)
*** Recent server performance improvements make regions with 60 agents in them perform quite well excepting the issue described in {{JIRA|SVC-3895}}.
** [[Land#Homestead|Homestead]]: 20
** [[Land#Openspace|Openspace]]: 10
* '''Island maximum number of agents:'''
** Full region: 100
** [[Land#Homestead|Homestead]]: 20
** [[Land#Openspace|Openspace]]: 10
* '''Freeze Time:''' Land owners can [[freeze]] other Residents for up to 30 seconds. Members of land owning groups can also be granted this ability.
* '''Minimum parcel that can be listed in Places or All search:''' 144 meters² 
* '''Minimum parcel that can be listed in Events:''' 512 meters²
* '''Maximum altitude for event listings:''' 768 meters ({{JIRA|WEB-814}})
* '''Maximum heights that objects can be seen on the [[World Map]]:''' 400.005m
* '''[[Classic clouds]] layer:''' Approximately 150-225 meters, although the edges of particles can appear to exceed that.

== Misc. ==

*'''[https://secondlife.com/currency/describe-limits.php Billing and Trading Limits]''' - Includes [https://secondlife.com/whatis/economy-market.php LindeX] currency exchange limits.
*'''Contacts in Communication > Friends tab ''' - A maximum of 20 simultaneous contacts can be selected to change permissions, remove, or invite for a conference chat.

== Navigation ==

[[File:Max Alt.jpg|thumb|right|435px|'''Height counter error above 2147483647 meters''']]
* '''Absolute height limit:''' [http://en.wikipedia.org/wiki/2147483647#2147483647_in_computing 2147483647] = 2<sup>31</sup> − 1 meters, which causes the altitude counter to roll over. Altitudes well below this cause graphics errors probably due to limited floating point number precision.
* '''Highest z-value of an [[SLurl]], that will still teleport you to a positive altitude:''' 2147483583
** This is lower than the ''Absolute height limit'' above probably because of precision issues. Any value higher than 2147483583 would be rounded up to something beyond 2147483647 and thus cause an [http://en.wikipedia.org/wiki/Arithmetic_overflow overflow], while 2147483583 will still be rounded down to 2147483520 (see below).
* '''Highest altitude you can teleport to with an SLurl:''' 2147483520 meters

== [[Profile]] ==

Each 7-bit ASCII character is encoded in one byte. International characters might need more bytes. When pasting text instead of typing, you can get in one byte more into each of the below.

* '''2nd Life tab's About field''' - 510 bytes
* '''Picks tab''' - 10 picks with 1022 bytes each
* '''1st Life tab's Info field''' - 253 bytes
* '''Classified tab''' - 100 listings with x bytes each
* '''My Notes''' - 1022 bytes

== Performance ==

* '''Healthy Viewer FPS''' - Generally, FPS above 15 is good. The higher it gets, the smoother. You can check via Help menu > Lag Meter, or for more advanced usage, see View menu > Statistics Bar.
* '''Avatar Rendering Cost scores''' - [[Avatar Rendering Cost|Learn all about it!]]

== [[Scripting]] ==

* '''Height at which scripts reactivate on a no-script parcel''' - 50 m above terrain mesh. Scripted objects that take controls continue to remain active when you fly down or enter a no-script parcel.
* '''Maximum height where scripts can run''' - none, as long as the object remains rezzed or attached.
* '''Maximum script source code size''' - 65536 single byte characters.
* For specific scripting limits, lookup calls in the '''[[LSL Portal]]'''.

== [[Textures]] ==
* '''[http://en.wikipedia.org/wiki/Aspect_ratio Aspect ratios]''' of profile, place, etc. pictures — all of these were measured at UI size (Edit menu > Preferences > General tab > UI Size) = 1.000:

=== 1.x Series Viewers ===

(official Viewer up to 1.23.5, most [[Alternate viewers|Third Party Viewers]])
* '''Search > All for "Classifieds", "People", and "Places"''' - 4:3 (256×192 pi×els)
* '''Search > Places and Classified tabs''' - ~7:5 (398×282 pixels)
* '''Search > Land tab''' - ~7:5 (358×252 pixels)
* '''Profile > 2nd Life tab''' - ~4:3 (178×133 pixels)
* '''Profile > Picks tab''' - 16:9 (288×162 pixels)
* '''Profile > 1st Life tab''' - 1:1 (133×133 pixels)
* '''Profile > Classifieds tab''' - ~3:2 (206×137 pixels)
* '''Profile > Web tab''' - 1:1 (400×400 pixels)
** A scrollbar uses 15 pixels on the right-hand side.
* '''About Land > Options tab''' - ~3:2 (178×117 pixels)
* '''Group Information > General tab's "Group Insignia"''' - 1:1 (126×126 pixels)
** Some of these textures are shared (for example, Search > All place pages, Search > Places, and About Land > Options use the same image), so you should pick a well-balanced ratio and size.
** [[Texture_aspect_ratios|Learn how to get correct texture aspect ratios when editing images.]]

=== 2.x Series Viewers ===

* '''Search > Classifieds thumbnail''' - 4:3 (60×45 pixels)
* '''Search > Classifieds expanded''' - ~4:3 (252×188 pixels)
* '''Search > Classifieds expanded > Details''' - 17:7 (272×112 pixels)
* '''Search > People''' - 4:3 (188×141 pixels)
* '''Search > Destination Guide thumbnail''' - ~4:3 (45×34 pixels)
* '''Search > Destination Guide expanded''' - 5:3 (250×150 pixels)
* '''Profile > 2nd Life tab''' - ~1:1 (100×99 pixels)
* '''Profile > Picks thumbnail''' - 8:5 (88×55 pixels)
* '''Profile > Pick expanded''' - ~5:3 (285×172 pixels)
* '''About Land > Options tab''' - ~20:13 (193×125 pixels)
* '''Places > More information''' - ~11:7 (272×173 pixels)

=== All Viewers ===

* '''Maximum texture size''' - 1024×1024 pixels
** All Second Life textures are constrained to [http://en.wikipedia.org/wiki/Power_of_2 powers of 2] (e.g., 128, 256, 512).
** Some textures inworld have a resolution as high as 2048×2048; this is due to a previous limit that was higher.
** We strongly recommend you use as small textures as possible because larger ones consume more memory and take substantially longer to load.
** Where large textures are being forced by import to only 512×512, lower your ...> Preferences >...> UI Size under 1.0, to increase import size to the max 1024×1024.

[[Category:Creation]] [[Category:Tutorials]] [[Category:Lists]]

=== Notes ===
In general 1 byte is enough to contain one character.