Difference between revisions of "User:Opensource Obscure/FFHUD"

From Second Life Wiki
Jump to navigation Jump to search
m
m (templatizationingsx)
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{LSL Header}}
{{User:Opensource_Obscure/Backlink}}


== FFHUD: a simple FriendFeed HUD ==
{{Help/Box|FFHUD|'''A SIMPLE FRIENDFEED HUD'''}}
'''by [[User:Opensource_Obscure|Opensource Obscure]] '''<br>


Current release: '''0.7.1''' <br>
* An idea by '''[[User:Opensource_Obscure|Opensource Obscure]]'''
One-button, Custom messages, Rooms and Profile Image support.
* Current release: '''0.7.3'''  
* Features:
** single, non-obtrusive button
** quick automatic or custom messages
** Friendfeed Rooms support
** Parcel Owner Profile Image support
<br/>


'''FFHUD lets you post to FriendFeed.''' Posts always include a SLURL link to your actual location. You can send a quick update that automatically includes the parcel description, or write a custom message. If available, the owner or owner-group profile image is also published, accordingly to their privacy settings.
== What does it do ==


'''If you're on FriendFeed, you may want to join this room: <br>
'''FFHUD lets you publish to the [http://friendfeed.com/ FriendFeed] microblogging service from inside Second Life.'''
http://friendfeed.com/rooms/secondlife'''
 
You send your posts by writing them in a private chat channel. Posts always include a SLURL link to your actual location. You can send a quick update that automatically includes the parcel description, or write a custom message. If available, the owner or owner-group profile image is also published, accordingly to their privacy settings.
 
FFHUD is an ideal way to participate on web social networks while you're enjoying Second Life. You can publish a quick review of an interesting place you just found in-world, or share with your friends your random thoughts from your home.
 
=== Automated Web Diary of your SL parcel ===
 
You could also use FFHUD to automatically report on a web page what's happening in Second Life. Use it together with sensors and scripted objects so that a new post is published to a dedicated Friendfeed group/room when actions occur, then [http://friendfeed.com/embed embed] that Friendfeed stream in your website.
 
* ''Example''. I'm currently using FFHUD to automatically transmit information from [http://slurl.com/secondlife/LOL my Second Life island, LOL], to http://friendfeed.com/lolsl - Many LSL sensors using FFHUD are placed near various places inside the region. They get triggered when visitors walk over them, or they start using devices and installations made by LOL builders.


== Setup==  
== Setup==  


* Edit the script and put your FriendFeed account data. You may also specify a room.
* Put the script (see below) in a prim (you may also want to rename it).
* Put the script in a prim (you may also want to rename it)
* Edit the script and insert your FriendFeed account data. You may also specify a room.
* Wear the prim as an HUD
* Wear the prim as an HUD. Resize and replace as needed.


== How to use FFHUD ==
== How to use FFHUD ==


* Touch it once to get information about parcel you're in (printed in private chat via llOwnerSay)
Touch it once to '''get information about the parcel''' you're in (printed in private chat via llOwnerSay). Then:
* Touch it again within 20 seconds to publish a post on FriendFeed... (that includes available info about the parcel: SLURL, description, owner/owner-group profile image)
 
* ...or say a message on channel 8 within 20 seconds to publish a post (that includes same parcel info than above + your message) - Example:
* if you're not publishing a post, just wait until FFHUD resets itself before touching it again;
* touch it again within 20 seconds to '''publish a post''' on FriendFeed that includes '''available info about the parcel''': SLURL, description, owner profile image;
* or say a message on channel 8 within 20 seconds to '''publish a post''' that includes both parcel info and your message. Example:
  /8 This is my message
  /8 This is my message
Do you need help? Feel free to contact me (Opensource Obscure) in-world, through this wiki or [http://friendfeed.com/oobscure on FriendFeed].


== Notes ==
== Notes ==


Feel free to use this room for testing: <br>
'''FFHUD builds your posts this way:'''
http://friendfeed.com/rooms/ffhud
 
FFHUD builds your posts like this:
* LINK = SLURL of your location
* LINK = SLURL of your location
* TITLE = parcel name
* TITLE = parcel name
Line 37: Line 52:
* ROOM = according to your settings
* ROOM = according to your settings


FFHUD shows the FriendFeed favicon image by default; it changes (after the first touch) if a profile image is available for the parcel owners. Profile images are shown by using [[llSetTexture]]; the UUID is retrieved using the Second Life Search; the image web address (not the image itself) is sent to FriendFeed, that then retrieves and hosts a copy of the image.
FFHUD shows the FriendFeed logo by default. After you touch it once, it will display the parcel owner profile image, if available. It's the same picture that will be published in your post. Profile images are shown by using [[llSetTexture]]; the UUID is retrieved using the Second Life Search; the image web address (not the image itself) is sent to FriendFeed, that then retrieves and hosts a copy of the image.
 
'''If you're on FriendFeed, join the Second Life room!''' <br>
'''http://friendfeed.com/rooms/secondlife'''
 
Feel free to use this room for testing: <br>
http://friendfeed.com/rooms/ffhud


== Script ==
== Script ==


This code is probably horrible and flawed. Feel free to [[User_talk:Opensource_Obscure/FFHUD|suggest how to improve it]]. I am not a real developer and I lack programming basis, so any feedback can help me. I usually read around, cut, paste and tweak code from other sources. To write FFHUD I used snippets by Ordinal Malaprop, Cory Ondrejka, MarcoDuff Palen, Jana Kamachi and others.  
This code works but may be horrible and flawed. Feel free to [[User_talk:Opensource_Obscure/FFHUD|suggest me how to improve it]]. I am not a real developer and I lack some programming basis, so any feedback can help me. I usually make the LSL scripts I need by reading around, cutting, pasting and tweaking code from other sources. To write FFHUD I used snippets by [[User:Ordinal Malaprop]], [[User:Cory Linden]], [http://www.marcoduff.com/ MarcoDuff Palen], [[User:Jana Kamachi]] and others. Thanks to Tayra Dagostino. [[User:Strife Onizuka]] [https://wiki.secondlife.com/w/index.php?title=User%3AOpensource_Obscure%2FFFHUD&diff=78978&oldid=78929 improved] this script, however its changes are missing from the current version and will be merged back as soon as possible.


To do:
To do:
* multiple rooms support
* add switch to turn off/on image support
* add switch to turn off/on image support
* enriched SLURL as in Ordinal Malaprop's TwitterBox
* enriched SLURL as in [http://ordinalmalaprop.com/twitter/ Ordinal Malaprop's TwitterBox]
* ...better code
* parcel pics support (needs https://jira.secondlife.com/browse/SVC-1638 fix)
* ...better code = a real developer should rewrite it from scratch :D


<lsl>
<lsl>// FFHUD 0.7.3
// FFHUD 0.7
// free for public use
// free for public use
// A project started by Opensource Obscure
// A project started by Opensource Obscure
Line 63: Line 85:
//  "secondlife" -> an unofficial SL room - http://friendfeed.com/rooms/secondlife
//  "secondlife" -> an unofficial SL room - http://friendfeed.com/rooms/secondlife
// Change accordingly the line below:
// Change accordingly the line below:
string room="";  
string room="ffhud";  




Line 90: Line 112:




// let's replace '&' with 'and'
// let's substitute '&' character with 'and'
string strReplace(string source, string pattern, string replace) {
string strReplace(string source, string pattern, string replace) {
     while (llSubStringIndex(source, pattern) > -1) {
     while (llSubStringIndex(source, pattern) > -1) {
Line 209: Line 231:
     room +
     room +
     "&image0_url=" +  
     "&image0_url=" +  
     llEscapeURL(imageurl);
     llEscapeURL(imageurl) +
    "&via=ffhud";
     return post;
     return post;
}
}
Line 310: Line 333:
          
          
}
}
</lsl>
</lsl>

Latest revision as of 04:12, 22 April 2011

Go back to Opensource Obscure's userpage



FFHUD

A SIMPLE FRIENDFEED HUD

  • An idea by Opensource Obscure
  • Current release: 0.7.3
  • Features:
    • single, non-obtrusive button
    • quick automatic or custom messages
    • Friendfeed Rooms support
    • Parcel Owner Profile Image support


What does it do

FFHUD lets you publish to the FriendFeed microblogging service from inside Second Life.

You send your posts by writing them in a private chat channel. Posts always include a SLURL link to your actual location. You can send a quick update that automatically includes the parcel description, or write a custom message. If available, the owner or owner-group profile image is also published, accordingly to their privacy settings.

FFHUD is an ideal way to participate on web social networks while you're enjoying Second Life. You can publish a quick review of an interesting place you just found in-world, or share with your friends your random thoughts from your home.

Automated Web Diary of your SL parcel

You could also use FFHUD to automatically report on a web page what's happening in Second Life. Use it together with sensors and scripted objects so that a new post is published to a dedicated Friendfeed group/room when actions occur, then embed that Friendfeed stream in your website.

  • Example. I'm currently using FFHUD to automatically transmit information from my Second Life island, LOL, to http://friendfeed.com/lolsl - Many LSL sensors using FFHUD are placed near various places inside the region. They get triggered when visitors walk over them, or they start using devices and installations made by LOL builders.

Setup

  • Put the script (see below) in a prim (you may also want to rename it).
  • Edit the script and insert your FriendFeed account data. You may also specify a room.
  • Wear the prim as an HUD. Resize and replace as needed.

How to use FFHUD

Touch it once to get information about the parcel you're in (printed in private chat via llOwnerSay). Then:

  • if you're not publishing a post, just wait until FFHUD resets itself before touching it again;
  • touch it again within 20 seconds to publish a post on FriendFeed that includes available info about the parcel: SLURL, description, owner profile image;
  • or say a message on channel 8 within 20 seconds to publish a post that includes both parcel info and your message. Example:
/8 This is my message

Do you need help? Feel free to contact me (Opensource Obscure) in-world, through this wiki or on FriendFeed.

Notes

FFHUD builds your posts this way:

  • LINK = SLURL of your location
  • TITLE = parcel name
  • COMMENT = parcel description (if available) OR your message
  • IMAGE = profile image of resident or group that owns the parcel
  • ROOM = according to your settings

FFHUD shows the FriendFeed logo by default. After you touch it once, it will display the parcel owner profile image, if available. It's the same picture that will be published in your post. Profile images are shown by using llSetTexture; the UUID is retrieved using the Second Life Search; the image web address (not the image itself) is sent to FriendFeed, that then retrieves and hosts a copy of the image.

If you're on FriendFeed, join the Second Life room!
http://friendfeed.com/rooms/secondlife

Feel free to use this room for testing:
http://friendfeed.com/rooms/ffhud

Script

This code works but may be horrible and flawed. Feel free to suggest me how to improve it. I am not a real developer and I lack some programming basis, so any feedback can help me. I usually make the LSL scripts I need by reading around, cutting, pasting and tweaking code from other sources. To write FFHUD I used snippets by User:Ordinal Malaprop, User:Cory Linden, MarcoDuff Palen, User:Jana Kamachi and others. Thanks to Tayra Dagostino. User:Strife Onizuka improved this script, however its changes are missing from the current version and will be merged back as soon as possible.

To do:

<lsl>// FFHUD 0.7.3 // free for public use // A project started by Opensource Obscure //

// Look for your username and FriendFeed key here: https://friendfeed.com/account/api string user=""; // your FriendFeed username string ffkey=""; // your FriendFeed key

// You can send messages to a FriendFeed room: // "" -----------> default setting - you won't share messages to any room // "ffhud" ------> a test room you can freely use // "secondlife" -> an unofficial SL room - http://friendfeed.com/rooms/secondlife // Change accordingly the line below: string room="ffhud";


// after 1st click you have a few seconds to write and send // your text message before FFHUD comes back to default state. // you can change the timing below: float listentime = 20.0;


/////////////////////////////////////////////////// // you don't need to modify anything below


string desc; integer listen_handle; string baseurl="@friendfeed.com/api/share"; key request_ff; key request_texture; string ownerurl = "http://world.secondlife.com/resident/"; string groupurl = "http://world.secondlife.com/group/"; string code1 = "<img alt=\"profile image\" src=\"http://secondlife.com/app/image/"; string code2 = "\" class=\"parcelimg\" />"; key textureuuid = ""; key texturedefault = "4760a44f-06f7-622e-7429-b01570a598b0";


// let's substitute '&' character with 'and' string strReplace(string source, string pattern, string replace) {

   while (llSubStringIndex(source, pattern) > -1) {
       integer len = llStringLength(pattern);
       integer pos = llSubStringIndex(source, pattern);
       if (llStringLength(source) == len) { source = replace; }
       else if (pos == 0) { source = replace+llGetSubString(source, pos+len, -1); }
       else if (pos == llStringLength(source)-len) { source = llGetSubString(source, 0, pos-1)+replace; }
       else { source = llGetSubString(source, 0, pos-1)+replace+llGetSubString(source, pos+len, -1); }
   }
   return source;

}


// partially redundant (1) string parcelname() {

   list lstParcelName=llGetParcelDetails(llGetPos(),[PARCEL_DETAILS_NAME]);                
   string a = (string)lstParcelName;
   string name = llDumpList2String(llParseString2List(a,[" "],[]),"+"); 
   return name; 

}


// partially redundant (1) // we use this after 2nd touch if no message is provided by the user string parceldesc() {

   list lstParcelDesc=llGetParcelDetails(llGetPos(),[PARCEL_DETAILS_DESC]);                
   string a = (string)lstParcelDesc;  
   if(a != "00000000-0000-0000-0000-000000000000")
   {
       desc = llDumpList2String(llParseString2List(a,[" "],[]),"+") + "+-+";                
   } 
   else
   {
       desc = "";
   } 
   return strReplace(desc, "&", "and");   

}


// partially redundant (1) string parcelowner() {

   list lstParcelOwner=llGetParcelDetails(llGetPos(),[PARCEL_DETAILS_OWNER]);                
   string uuid = (string)lstParcelOwner;    
   return uuid;    

}


// partially redundant (1) string parcelgroup() {

   list lstParcelGroup=llGetParcelDetails(llGetPos(),[PARCEL_DETAILS_GROUP]);              
   string uuid = (string)lstParcelGroup;
   return uuid;

}


// this comes from Cory Ondrejka I think string slurl() {

   string simname = llDumpList2String(llParseString2List(llGetRegionName(),[" "],[]),"+");
   string regionname = simname;
   vector detectedPos = llGetRootPosition();        
   string sx = (string)llRound(detectedPos.x);
   string sy = (string)llRound(detectedPos.y);
   string sz = (string)llRound(detectedPos.z);
   string url = "http://slurl.com/secondlife/";  
   url += simname; 
   url += "/" + sx + "/" + sy + "/" + sz ; 
   return url;   

}


// partially redundant (1) infoparcel() {

   llOwnerSay("parcel name = " + (string)llGetParcelDetails(llGetPos(),[PARCEL_DETAILS_NAME]));
   llOwnerSay("parcel desc = " + (string)llGetParcelDetails(llGetPos(),[PARCEL_DETAILS_DESC]));
   llOwnerSay("parcel owner = " + "secondlife:///app/agent/" + parcelowner() + "/about");   
   llOwnerSay("parcel group = "  + "secondlife:///app/group/" + parcelgroup() + "/about");

}


texture() {

   if (parcelgroup() == parcelowner()) // group-owned land
   {
       request_texture = llHTTPRequest(groupurl + parcelgroup(),[HTTP_METHOD,"GET"],"");            
   }  
   else // group may be set, but land is not group-owned
       // single residents have pictures more often than group so we choose them
   { 
       request_texture = llHTTPRequest(ownerurl + parcelowner(),[HTTP_METHOD,"GET"],"");               
   }

}


string prepara(string messaggio) {

   string imageurl = "http://secondlife.com/app/image/" + (string)textureuuid + "/2";       
   messaggio = llDumpList2String(llParseString2List(messaggio,[" "],[]),"+");
   string post = 
   "http://" + 
   user + 
   ":" + 
   ffkey + 
   baseurl + 
   "?title=" + 
   parcelname() +
   "&link=" + 
   llEscapeURL(slurl()) + 
   "&comment=" +      
   messaggio +
   "&room=" +
   room +
   "&image0_url=" + 
   llEscapeURL(imageurl) +
   "&via=ffhud";
   return post;

}


default {

   on_rez(integer start_param)
   {
       llOwnerSay(": Ready. Touch once to get parcel info - Touch twice to update your FriendFeed page.");         
   }
   
   state_entry()
   {
       llSetTexture(texturedefault, ALL_SIDES);         
       llSetTimerEvent(0.0);                
   }
   
   
   touch_start(integer total_number)
   {      
       infoparcel();
       texture();
       state pronto;        
   }
   // redundant (2)
   http_response(key request_id, integer status, list metadata, string body)
   {
   if(request_id == request_ff) 
       {
        llOwnerSay(": Message sent.");
       }
   
   else if(request_id == request_texture)
       {
       textureuuid = (key)llGetSubString(body,llSubStringIndex(body, code1)+llStringLength(code1),llSubStringIndex(body,code2)-3);
       llSetTexture(textureuuid, ALL_SIDES);
       }
   }                                 

}


state pronto {

   state_entry()
   {
       llSetTimerEvent(listentime);        
       llOwnerSay(": Say your message on channel 8 within 20 seconds, or touch again to send a quick post.");        
       listen_handle = llListen(8, "", llGetOwner(), "");                
   }
   
   changed(integer change) 
   { 
   if (change & (CHANGED_TELEPORT|CHANGED_REGION))
   {
       llOwnerSay(": Location changed, restarting.");           
        state default;
   }
   }


  timer()
  {
       llOwnerSay(": Time over.");        
       state default;
  }


   touch_start(integer total_number)
   {
       request_ff = llHTTPRequest(prepara(parceldesc()), [HTTP_METHOD,"POST"], ""); 
       state default;        
   } 
   
   
   listen(integer channel, string name, key id, string message)
   {
       request_ff = llHTTPRequest(prepara(message), [HTTP_METHOD,"POST"], ""); 
       state default;        
   }
   
   // redundant (2)
   http_response(key request_id, integer status, list metadata, string body)
   {
   if(request_id == request_ff) 
       {
        llOwnerSay(": Message sent.");
       }
   
   else if(request_id == request_texture)
       {
       textureuuid = (key)llGetSubString(body,llSubStringIndex(body, code1)+llStringLength(code1),llSubStringIndex(body,code2)-3);
       llSetTexture(textureuuid, ALL_SIDES);
       }
   }                                                                     


}

</lsl>