Second Life Wiki - User contributions [en]

LlEmail

2008-08-19T04:47:49Z

Gellan Glenelg: Undo revision 86877 - not sure it works!

{{LSL_Function
|func_id=119|func_sleep=20.0|func_energy=10.0
|sort=Email|func=llEmail
|p1_type=string|p1_name=address
|p2_type=string|p2_name=subject
|p3_type=string|p3_name=message
|func_footnote=The entire message (including the address, subject and other miscellaneous fields) can't be longer than 4096 bytes combined.
|func_desc=Sends an email to '''address''' with '''subject''' and '''message'''.
|return_text
|spec=The '''message''' is prefixed with information about the prim sending the email.
{{{!}}{{Prettytable}}
{{!}}-{{Hl2}}
!Template
!Example
{{!}}-
{{!}}<pre>
Object-Name: *prim*
Region: *simname* (*simpos.x*, *simpos.y*)
Local-Position: (*primpos.x*, *primpos.y*, *primpos.z*)

*message*
</pre>
{{!}}
<pre>
Object-Name: Object
Region: Gibson (254976, 256000)
Local-Position: (117, 129, 50)

The real message starts here.
</pre>
{{!}}}
|caveats=* There is a limit to the number of email messages an object can send in a given amount of time.
* Due to the bug {{Jira|SVC-23}} (present since 2005), objects may stop receiving emails completely until either the region is restarted or the object crosses a region boundary (resetting the script doesn't help). Emails sent may eventually be received after a restart/region-cross. Hence, don't rely on this function for reliable inter-region messaging.
|constants
|examples=
<lsl>
string email_address = "somebody@example.com"; // who will receive the messages

default
{
state_entry() {

//Send an email to a normal email account
llEmail( email_address, "Look it's an email subject line!", "Testing 1 2 3" );
}

touch_start( integer num_detected ) {
integer i = 0;

// Send another email, telling who touched the prim.
do
llEmail( email_address, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) );
while(++i < num_detected);
}
}
</lsl>
|helpers=
<lsl>
email( string time, string address, string subj, string message, integer num_left )
{
if(llGetSubString(address, -19, -1) == "@lsl.secondlife.com")//trim the header
message = llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1);
}
</lsl>
|also_functions=*{{LSLG|llGetNextEmail}}
*{{LSLG|llMessageLinked}}
|also_events=*{{LSLG|email}}
*{{LSLG|link message}}
|also_tests=*[[llEmail]]
|also_articles
|notes=* Because of the long delay on this function, it is often called from a second script triggered by {{LSLG|link message}}.
* If you are sending email to a prim within Second Life, its address is ''[key]''@lsl.secondlife.com
** Which means if the key returned by [[llGetKey]] is "a2e76fcd-9360-4f6d-a924-000000000003", then its email address is "a2e76fcd-9360-4f6d-a924-000000000003@lsl.secondlife.com".
** Agents do not have fixed email addresses, use [[llInstantMessage]] or [[llOwnerSay]].
|permission
|negative_index
|cat1=Communications
|cat2=Email
|cat3
|cat4
}}
<div id="box">
== Open Source Portal ==
<div style="padding: 0.5em;">
{{OSWikiFeatureNav}}
=== Feature Design Document ===
(none)

=== Functional Spec ===
(none)

=== Test scripts ===
[https://osiris.lindenlab.com/mediawiki/index.php/Email_Test internal test]

=== Discussion for future improvements ===
(none)

=== Relationship to other features ===
<b> List of features that need to be tested when this feature changes, and why. </b>

[[IM to email]] - verify IM -> email still works.

[[Postcards]] - Postcards use email out?

=== User Guides ===
[http://lslwiki.net/lslwiki/wakka.php?wakka=llemail llEmail on LSLwiki.net]
</div></div>

LlEmail

2008-08-19T04:35:49Z

Gellan Glenelg: Added note for aditi addresses

{{LSL_Function
|func_id=119|func_sleep=20.0|func_energy=10.0
|sort=Email|func=llEmail
|p1_type=string|p1_name=address
|p2_type=string|p2_name=subject
|p3_type=string|p3_name=message
|func_footnote=The entire message (including the address, subject and other miscellaneous fields) can't be longer than 4096 bytes combined.
|func_desc=Sends an email to '''address''' with '''subject''' and '''message'''.
|return_text
|spec=The '''message''' is prefixed with information about the prim sending the email.
{{{!}}{{Prettytable}}
{{!}}-{{Hl2}}
!Template
!Example
{{!}}-
{{!}}<pre>
Object-Name: *prim*
Region: *simname* (*simpos.x*, *simpos.y*)
Local-Position: (*primpos.x*, *primpos.y*, *primpos.z*)

*message*
</pre>
{{!}}
<pre>
Object-Name: Object
Region: Gibson (254976, 256000)
Local-Position: (117, 129, 50)

The real message starts here.
</pre>
{{!}}}
|caveats=* There is a limit to the number of email messages an object can send in a given amount of time.
* Due to the bug {{Jira|SVC-23}} (present since 2005), objects may stop receiving emails completely until either the region is restarted or the object crosses a region boundary (resetting the script doesn't help). Emails sent may eventually be received after a restart/region-cross. Hence, don't rely on this function for reliable inter-region messaging.
|constants
|examples=
<lsl>
string email_address = "somebody@example.com"; // who will receive the messages

default
{
state_entry() {

//Send an email to a normal email account
llEmail( email_address, "Look it's an email subject line!", "Testing 1 2 3" );
}

touch_start( integer num_detected ) {
integer i = 0;

// Send another email, telling who touched the prim.
do
llEmail( email_address, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) );
while(++i < num_detected);
}
}
</lsl>
|helpers=
<lsl>
email( string time, string address, string subj, string message, integer num_left )
{
if(llGetSubString(address, -19, -1) == "@lsl.secondlife.com")//trim the header
message = llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1);
}
</lsl>
|also_functions=*{{LSLG|llGetNextEmail}}
*{{LSLG|llMessageLinked}}
|also_events=*{{LSLG|email}}
*{{LSLG|link message}}
|also_tests=*[[llEmail]]
|also_articles
|notes=* Because of the long delay on this function, it is often called from a second script triggered by {{LSLG|link message}}.
* If you are sending email to a prim within Second Life, its address is ''[key]''@lsl.secondlife.com
** Which means if the key returned by [[llGetKey]] is "a2e76fcd-9360-4f6d-a924-000000000003", then its email address is "a2e76fcd-9360-4f6d-a924-000000000003@lsl.secondlife.com".
** Agents do not have fixed email addresses, use [[llInstantMessage]] or [[llOwnerSay]].
* If you are sending email to a prim on the Second Life Preview Grid (Aditi), its address is ''[key]''@lsl.aditi.lindenlab.com {{Jira|SVC-2873}}
|permission
|negative_index
|cat1=Communications
|cat2=Email
|cat3
|cat4
}}
<div id="box">
== Open Source Portal ==
<div style="padding: 0.5em;">
{{OSWikiFeatureNav}}
=== Feature Design Document ===
(none)

=== Functional Spec ===
(none)

=== Test scripts ===
[https://osiris.lindenlab.com/mediawiki/index.php/Email_Test internal test]

=== Discussion for future improvements ===
(none)

=== Relationship to other features ===
<b> List of features that need to be tested when this feature changes, and why. </b>

[[IM to email]] - verify IM -> email still works.

[[Postcards]] - Postcards use email out?

=== User Guides ===
[http://lslwiki.net/lslwiki/wakka.php?wakka=llemail llEmail on LSLwiki.net]
</div></div>

Bug triage/2008-08-04

2008-08-04T18:35:21Z

Gellan Glenelg:

{{Bug triage}}

Next meeting: 2008-08-04 at 12 PM SLT at {{SLurl|region=Hippotropolis|x=241|y=27|z=23|title=Hippotropolis Meeting area}}. See [[Bug triage]] for details.

== Fast Track Import ==

* {{jira|VWR-380}} - Votes: 10 - Resized Flexible Prims Render Improperly - {{User|Khamon Fate}}
** Was supposedly fixed in 1.20.3 but still happening in 1.20.15
* {{jira|SVC-2712}} - Votes: 2 - Content loss in 1.23.4 sim - {{User|trodden miles}}

== Hot by Vote ==
[http://www.sljirastats.com/jira_search.php?search=33&output=wiki High Voted Bugs]

* {{jira|VWR-7156}} - Votes: 12 - Zoom doesn't work in Flycam mode - {{User|tenebrous pau}}
* {{jira|SVC-2596}} - Votes: 12 - Script dataserver events become permanently blocked until sim restart - {{User|Cenji Neutra}}
* {{jira|SVC-2723}} - Votes: 18 - Change in llPushObject strength cap behavior 1.22 -> 1.23 simulator release - {{User|Chalice Yao}}

== Patches ==
[http://www.sljirastats.com/jira_search.php?search=34&output=wiki Patches]

* {{jira|VWR-1366}} - Votes: 9 - Analog Joystick support - {{User|Lucy Zelmanov}}

== Misc Pool ==
[http://www.sljirastats.com/jira_search.php?search=35&output=wiki Misc Pool]

* {{jira|VWR-8474}} - Votes: 2 - Blog info not showing on the new login screen - {{User|scarlett glenelg}}
* {{jira|SVC-2740}} - Votes: 0 - Attachment is attached in viewer, detached on server after TP with high attached prim count - {{User|Maggie Darwin}}
* {{jira|VWR-8456}} - Votes: 0 - Mac client bug in ""Find Friends"" - {{User|Regulus Darkstone}}
* {{jira|VWR-8017}} - Votes: 0 - ATI driver crash with Windows XP - {{User|Al Supercharge}}
* {{jira|VWR-8301}} - Votes: 0 - Animation preview does not play animations after end of loop - {{User|Doris Haller}}
* {{jira|VWR-7846}} - Votes: 0 - English Client cannot send IM's, Notecards, teleports etc to a french client - {{User|dania daviau}}
* {{jira|SVC-2611}} - Votes: 0 - Group invitation failed and spam mail of group invitation. - {{User|Naonao Watanabe}}
* {{jira|VWR-6740}} - Votes: 2 - SpaceNavigator input cross-talk to other apps - {{User|Whichway Janus}}
* {{jira|VWR-6970}} - Votes: 1 - Crash on Advanced > Character > Display Agent Target - {{User|Day Oh}}
* {{jira|SVC-1684}} - Votes: 0 - Build rezzers experiencing problems on havok4 servers only. - {{User|cal corleone}}
* {{jira|VWR-7157}} - Votes: 0 - llDetectedGrab() returns bad results for certain viewer window sizes - {{User|Lex Neva}}
* {{jira|VWR-7011}} - Votes: 0 - Camera locks into top of head view - {{User|WarKirby Magojiro}}
* {{jira|SVC-1847}} - Votes: 0 - llStringLength won't diferentiate between single and multiple byte characters, while the cap for chat will - {{User|TigroSpottystripes Katsu}}
* {{jira|SVC-1685}} - Votes: 0 - Teens unable to use the beta grid. - {{User|Liny Odell}}
* {{jira|VWR-7416}} - Votes: 0 - Display wobbles at altitudes higher than 650m - {{User|Vinco DeCuir}}
* {{jira|SVC-996}} - Votes: 0 - Five minute wait due to ""System Logging You Out"" happens everytime when wearing scripted HUD - {{User|Chase Marellan}}
* {{jira|SVC-250}} - Votes: 5 - llHTTPRequest does not deliver results on URLs connecting to non standard ports - {{User|BlckCobra Shikami}}
* {{jira|WEB-600}} - Votes: 0 - When event fails to submit and needs corrections, Location select box does not remember initial choice - {{User|Blue Revolution}}
* {{jira|VWR-5773}} - Votes: 0 - When Basic Shaders is selected in Graphics settings, it causes a fog bar along the right side of the screen also visible in photos. In viewer 1.19.1 - {{User|cherie parker}}
* {{jira|VWR-5090}} - Votes: 0 - Landing on a Mega Prim in Havok 4 fails and causes the avvie to float as if in Zero Gravity - {{User|Corsi Mousehold}}
* {{jira|VWR-7769}} - Votes: 0 - Exit out of Mouselook, shattered the viewer into broken pieces, like a shattered mirror - {{User|Marc Montague}}
* {{jira|VWR-2964}} - Votes: 3 - Land terrain textures displayed inconsistently with current release (1.18.3.5) - {{User|Jonas Ingrassia}}
* {{jira|MISC-1394}} - Votes: 0 - Group Invite not being received in world, but received later as offline email - {{User|Mynx Carroll}}
* {{jira|WEB-374}} - Votes: 0 - Land Auction Search To Restrictive - {{User|Munchy Yost}}
* {{jira|SVC-1568}} - Votes: 0 - Havok4 scripts - {{User|yikes lopez}}
* {{jira|VWR-7819}} - Votes: 0 - SL crashes when trying to save or upload a picture - {{User|Rowana Rolland}}

== Pre-meeting activity ==

Some issues will be resolved in the course of building this agenda. Rather than deleting them from the proposed agenda, move the issue and associated discussion into the appropriate section below.

=== Imported ===

=== Resolved ===

== Transcript ==
Transcript is/will be at [[{{PAGENAME}}/Transcript]]

== Creating An Agenda ==
{{Bug List Instructions}}

Bug triage/2008-08-04

2008-08-04T18:29:46Z

Gellan Glenelg:

{{Bug triage}}

Next meeting: 2008-08-04 at 12 PM SLT at {{SLurl|region=Hippotropolis|x=241|y=27|z=23|title=Hippotropolis Meeting area}}. See [[Bug triage]] for details.

== Fast Track Import ==

* {{jira|VWR-380}} - Votes: 10 - Resized Flexible Prims Render Improperly - {{User|Khamon Fate}}
** Was supposedly fixed in 1.20.3 but still happening in 1.20.15
* {{jira|SVC-2712}} - Votes: 2 - Content loss in 1.23.4 sim - {{User|trodden miles}}

== Hot by Vote ==
[http://www.sljirastats.com/jira_search.php?search=33&output=wiki High Voted Bugs]

* {{jira|VWR-7156}} - Votes: 12 - Zoom doesn't work in Flycam mode - {{User|tenebrous pau}}
* {{jira|SVC-2596}} - Votes: 12 - Script dataserver events become permanently blocked until sim restart - {{User|Cenji Neutra}}
* {{jira|SVC-2723}} - Votes: 18 - Change in llPushObject strength cap behavior 1.22 -> 1.23 simulator release - {{User|Chalice Yao}}

== Patches ==
[http://www.sljirastats.com/jira_search.php?search=34&output=wiki Patches]

* {{jira|VWR-1366}} - Votes: 9 - Analog Joystick support - {{User|Lucy Zelmanov}}

== Misc Pool ==
[http://www.sljirastats.com/jira_search.php?search=35&output=wiki Misc Pool]

* {{jira|VWR-8474}} - Votes: 1 - Blog info not showing on the new login screen - {{User|scarlett glenelg}}
* {{jira|SVC-2740}} - Votes: 0 - Attachment is attached in viewer, detached on server after TP with high attached prim count - {{User|Maggie Darwin}}
* {{jira|VWR-8456}} - Votes: 0 - Mac client bug in ""Find Friends"" - {{User|Regulus Darkstone}}
* {{jira|VWR-8017}} - Votes: 0 - ATI driver crash with Windows XP - {{User|Al Supercharge}}
* {{jira|VWR-8301}} - Votes: 0 - Animation preview does not play animations after end of loop - {{User|Doris Haller}}
* {{jira|VWR-7846}} - Votes: 0 - English Client cannot send IM's, Notecards, teleports etc to a french client - {{User|dania daviau}}
* {{jira|SVC-2611}} - Votes: 0 - Group invitation failed and spam mail of group invitation. - {{User|Naonao Watanabe}}
* {{jira|VWR-6740}} - Votes: 2 - SpaceNavigator input cross-talk to other apps - {{User|Whichway Janus}}
* {{jira|VWR-6970}} - Votes: 1 - Crash on Advanced > Character > Display Agent Target - {{User|Day Oh}}
* {{jira|SVC-1684}} - Votes: 0 - Build rezzers experiencing problems on havok4 servers only. - {{User|cal corleone}}
* {{jira|VWR-7157}} - Votes: 0 - llDetectedGrab() returns bad results for certain viewer window sizes - {{User|Lex Neva}}
* {{jira|VWR-7011}} - Votes: 0 - Camera locks into top of head view - {{User|WarKirby Magojiro}}
* {{jira|SVC-1847}} - Votes: 0 - llStringLength won't diferentiate between single and multiple byte characters, while the cap for chat will - {{User|TigroSpottystripes Katsu}}
* {{jira|SVC-1685}} - Votes: 0 - Teens unable to use the beta grid. - {{User|Liny Odell}}
* {{jira|VWR-7416}} - Votes: 0 - Display wobbles at altitudes higher than 650m - {{User|Vinco DeCuir}}
* {{jira|SVC-996}} - Votes: 0 - Five minute wait due to ""System Logging You Out"" happens everytime when wearing scripted HUD - {{User|Chase Marellan}}
* {{jira|SVC-250}} - Votes: 5 - llHTTPRequest does not deliver results on URLs connecting to non standard ports - {{User|BlckCobra Shikami}}
* {{jira|WEB-600}} - Votes: 0 - When event fails to submit and needs corrections, Location select box does not remember initial choice - {{User|Blue Revolution}}
* {{jira|VWR-5773}} - Votes: 0 - When Basic Shaders is selected in Graphics settings, it causes a fog bar along the right side of the screen also visible in photos. In viewer 1.19.1 - {{User|cherie parker}}
* {{jira|VWR-5090}} - Votes: 0 - Landing on a Mega Prim in Havok 4 fails and causes the avvie to float as if in Zero Gravity - {{User|Corsi Mousehold}}
* {{jira|VWR-7769}} - Votes: 0 - Exit out of Mouselook, shattered the viewer into broken pieces, like a shattered mirror - {{User|Marc Montague}}
* {{jira|VWR-2964}} - Votes: 3 - Land terrain textures displayed inconsistently with current release (1.18.3.5) - {{User|Jonas Ingrassia}}
* {{jira|MISC-1394}} - Votes: 0 - Group Invite not being received in world, but received later as offline email - {{User|Mynx Carroll}}
* {{jira|WEB-374}} - Votes: 0 - Land Auction Search To Restrictive - {{User|Munchy Yost}}
* {{jira|SVC-1568}} - Votes: 0 - Havok4 scripts - {{User|yikes lopez}}
* {{jira|VWR-7819}} - Votes: 0 - SL crashes when trying to save or upload a picture - {{User|Rowana Rolland}}

== Pre-meeting activity ==

Some issues will be resolved in the course of building this agenda. Rather than deleting them from the proposed agenda, move the issue and associated discussion into the appropriate section below.

=== Imported ===

=== Resolved ===

== Transcript ==
Transcript is/will be at [[{{PAGENAME}}/Transcript]]

== Creating An Agenda ==
{{Bug List Instructions}}

LlCSV2List

2008-05-02T18:46:20Z

Gellan Glenelg:

{{LSL_Function
|func_id=196|func_sleep=0.0|func_energy=10.0
|func=llCSV2List|return_type=list|p1_type=string|p1_name=src
|func_footnote=
Do not confuse this function with the {{Wikipedia|CSV|CSV}} format, it is ''not'' the CSV format.
|func_desc
|return_text=made from '''src''' as comma separated values.
|spec=Anything between "<" and ">" is considered a single value regardless of the existence of a comma between. For every "<" there needs to be a corresponding ">".
<lsl>
llCSV2List("<>,>,a") == ["<>", ">", "a"]; //didn't match the last ">"
llCSV2List("<<>,>,a") == ["<<>,>", "a"]; //matched everything
llCSV2List("<<<>,>,a") == ["<<<>,>,a"]; //didn't match the last "<"
</lsl>

|caveats=*It eats leading and trailing spaces from values.
* Anything between "<" and ">" is considered a single value, see [[#Specification|Specification]] for further details.
** This is done so that the function can handle [[vector]]s and [[rotation]]s without extra parsing.
* All items in the returned list are strings until [[typecast]].
* llCSV2List("") returns [""], not []
|constants
|examples=
<lsl>
default
{
state_entry()
{
string csv = "first,second,third";
list my_list = llCSV2List(csv);
llOwnerSay("CSV: " + csv);
integer i;
for (i=0; i<llGetListLength(my_list); ++i)
{
llOwnerSay("my_list[" + (string)i + "]: " + llList2String(my_list,i));
}
}
}</lsl>
|helpers
|also_functions={{LSL DefineRow||[[llList2CSV]]|}}
{{LSL DefineRow||[[llDumpList2String]]|}}
{{LSL DefineRow||[[llParseString2List]]|}}
{{LSL DefineRow||[[llParseStringKeepNulls]]|}}
|also_events
|also_tests
|also_articles={{LSL DefineRow||[[Typecast]]|}}
|notes
|permission
|negative_index
|sort=CSV2List
|cat1=List
|cat2=String
|cat3=Data Conversion
|cat4=CSV
}}

User:Gellan Glenelg

2007-12-27T18:52:34Z

Gellan Glenelg:

{{Jira Reporter}}
Gellan's Page