Dialog Module - Revision history

ObviousAltIsObvious Resident: tag to

ObviousAltIsObvious Resident — Sun, 25 Jan 2015 17:58:56 GMT

← Older revision		Revision as of 10:58, 25 January 2015
Line 124:		Line 124:
	<br /> Example Access script to Dialog Module:<br />		<br /> Example Access script to Dialog Module:<br />

	<~~pre~~>string sepchar = "\|";		<source lang="lsl2">string sepchar = "\|";
	integer answer = 546;		integer answer = 546;
	integer DialogComm = 12;		integer DialogComm = 12;
Line 184:		Line 184:
	}		}
	}		}
	}</~~pre~~>		}</source>

	<br /><br /> Dialog Module:<br />		<br /><br /> Dialog Module:<br />

	<~~pre~~>//////////////////////////////////////////////////////////////////////////////////////		<source lang="lsl2">//////////////////////////////////////////////////////////////////////////////////////
	//		//
	// Dialog Module		// Dialog Module
Line 393:		Line 393:
	llSetTimerEvent(ticks = 0);		llSetTimerEvent(ticks = 0);
	}		}
	}</~~pre~~>		}</source>

	<br /> ESL Version:<br />		<br /> ESL Version:<br />

	<~~pre~~>//////////////////////////////////////////////////////////////////////////////////////		<source lang="lsl2">//////////////////////////////////////////////////////////////////////////////////////
	//		//
	// Dialog Module		// Dialog Module
Line 629:		Line 629:
	wipe();		wipe();
	}		}
	}</~~pre~~>		}</source>

	----		----

Kireji Haiku: Undo revision 1173017 by Kireji Haiku (Talk)

Kireji Haiku — Tue, 02 Oct 2012 21:15:44 GMT

Undo revision 1173017 by Kireji Haiku (Talk)

← Older revision		Revision as of 14:15, 2 October 2012
Line 124:		Line 124:
	<br /> Example Access script to Dialog Module:<br />		<br /> Example Access script to Dialog Module:<br />

	<~~lsl~~>		<pre>string sepchar = "\|";
	string sepchar = "\|";
	integer answer = 546;		integer answer = 546;
	integer DialogComm = 12;		integer DialogComm = 12;
Line 185:		Line 184:
	}		}
	}		}
	}</~~lsl~~>		}</pre>

	<br /><br /> Dialog Module:<br />		<br /><br /> Dialog Module:<br />

	<~~lsl~~>//////////////////////////////////////////////////////////////////////////////////////		<pre>//////////////////////////////////////////////////////////////////////////////////////
	//		//
	// Dialog Module		// Dialog Module
Line 394:		Line 393:
	llSetTimerEvent(ticks = 0);		llSetTimerEvent(ticks = 0);
	}		}
	}</~~lsl~~>		}</pre>

	<br /> ESL Version:<br />		<br /> ESL Version:<br />

	<~~lsl~~>//////////////////////////////////////////////////////////////////////////////////////		<pre>//////////////////////////////////////////////////////////////////////////////////////
	//		//
	// Dialog Module		// Dialog Module
Line 630:		Line 629:
	wipe();		wipe();
	}		}
	}</~~lsl~~>		}</pre>

	----		----

Kireji Haiku: changed to show LSL syntax highlighting

Kireji Haiku — Tue, 02 Oct 2012 20:58:11 GMT

changed to show LSL syntax highlighting

← Older revision		Revision as of 13:58, 2 October 2012
Line 124:		Line 124:
	<br /> Example Access script to Dialog Module:<br />		<br /> Example Access script to Dialog Module:<br />

	<~~pre~~>string sepchar = "\|";		<lsl>
			string sepchar = "\|";
	integer answer = 546;		integer answer = 546;
	integer DialogComm = 12;		integer DialogComm = 12;
Line 184:		Line 185:
	}		}
	}		}
	}</~~pre~~>		}</lsl>

	<br /><br /> Dialog Module:<br />		<br /><br /> Dialog Module:<br />

	<~~pre~~>//////////////////////////////////////////////////////////////////////////////////////		<lsl>//////////////////////////////////////////////////////////////////////////////////////
	//		//
	// Dialog Module		// Dialog Module
Line 393:		Line 394:
	llSetTimerEvent(ticks = 0);		llSetTimerEvent(ticks = 0);
	}		}
	}</~~pre~~>		}</lsl>

	<br /> ESL Version:<br />		<br /> ESL Version:<br />

	<~~pre~~>//////////////////////////////////////////////////////////////////////////////////////		<lsl>//////////////////////////////////////////////////////////////////////////////////////
	//		//
	// Dialog Module		// Dialog Module
Line 629:		Line 630:
	wipe();		wipe();
	}		}
	}</~~pre~~>		}</lsl>

	----		----

Taper Pirandello at 19:36, 30 April 2007

Taper Pirandello — Mon, 30 Apr 2007 19:36:28 GMT

← Older revision		Revision as of 12:36, 30 April 2007
Line 1:		Line 1:
	This [[script]] is a standalone module for the handling of [[dialog]] boxes. All you, the script writer, ~~has~~ to do is build a [[link\|linked message]] handler. Use the example access script as a starting point.<br /><br />'''if you are using a version prior to 9.3 please upgrade as there is a bug which could result in the responce not being registered'''<br />'''8.x is not compatible with 9.x, if you are using a version prior to 8.4 please upgrade as there is a bug with bit 17'''<br /><br />'''Security''':<br /> The dialog boxes each use a random unique negative [[channel]], for each dialog box.<br /> Channel numbers range from -2147483648 to -255 with the possibility of the lower 8 bits being zero.<br /> The [[listen\|listens]] are bound to the [[user\|user's]] [[key]]. This means that no script or other user can activate the interface.<br /> By using a negative number there is no way for the user to type in a command and have it mistaken as a response.<br /> Only responses that are valid buttons from the requested user (and in the mask) will result in a return; no 3rd party tampering is possible.<br /> It would be very difficult for anyone to predict the channel number to listen on (2 billion is a big range).<br /><br />'''The Request''':<br /> The link message [[string]] format is a list. The first element of this [[list]] is the [[integer]] that will be used as the second integer in the [[return]] the link message. The rest of this list is string that will be returned (in list form with the same separating character).<br /><br /> The link message key format is a list. The first element is the key of the user, if this is left blank (or [[NULL KEY\|NULL_KEY]]) the [[owner]] is assumed. The second element is the message, this can be any valid string. The third element is a [[float]], which is the dialog box time to live. The forth element is an integer it is used as a [[mask]] for when a button is pressed if it will trigger a response. The rest of the list is for the buttons; an empty list can be used, but it will default to ["OK"] (there is no way around this, just cope).<br /><br />'''The Response''':<br /> The link message string format is a list. It is whatever was passed as the second string minus the first entry of that list.<br /> The link message key format is a list. The first element of this list is the number of the button pressed (or error code). The second entry is the text of the button pressed. The third entry is the key it used for creating the dialog box. The forth entry is the user name. The fifth entry is how much [[time]] was left in the time to live of the dialog box (not very useful but maybe it is). <br /> The response always goes back to only the [[prim]] that requested the dialog box.<br />		This [[script]] is a standalone module for the handling of [[dialog]] boxes. All you, the script writer, have to do is build a [[link\|linked message]] handler. Use the example access script as a starting point.<br /><br />'''if you are using a version prior to 9.3 please upgrade as there is a bug which could result in the responce not being registered'''<br />'''8.x is not compatible with 9.x, if you are using a version prior to 8.4 please upgrade as there is a bug with bit 17'''<br /><br />'''Security''':<br /> The dialog boxes each use a random unique negative [[channel]], for each dialog box.<br /> Channel numbers range from -2147483648 to -255 with the possibility of the lower 8 bits being zero.<br /> The [[listen\|listens]] are bound to the [[user\|user's]] [[key]]. This means that no script or other user can activate the interface.<br /> By using a negative number there is no way for the user to type in a command and have it mistaken as a response.<br /> Only responses that are valid buttons from the requested user (and in the mask) will result in a return; no 3rd party tampering is possible.<br /> It would be very difficult for anyone to predict the channel number to listen on (2 billion is a big range).<br /><br />'''The Request''':<br /> The link message [[string]] format is a list. The first element of this [[list]] is the [[integer]] that will be used as the second integer in the [[return]] the link message. The rest of this list is string that will be returned (in list form with the same separating character).<br /><br /> The link message key format is a list. The first element is the key of the user, if this is left blank (or [[NULL KEY\|NULL_KEY]]) the [[owner]] is assumed. The second element is the message, this can be any valid string. The third element is a [[float]], which is the dialog box time to live. The forth element is an integer it is used as a [[mask]] for when a button is pressed if it will trigger a response. The rest of the list is for the buttons; an empty list can be used, but it will default to ["OK"] (there is no way around this, just cope).<br /><br />'''The Response''':<br /> The link message string format is a list. It is whatever was passed as the second string minus the first entry of that list.<br /> The link message key format is a list. The first element of this list is the number of the button pressed (or error code). The second entry is the text of the button pressed. The third entry is the key it used for creating the dialog box. The forth entry is the user name. The fifth entry is how much [[time]] was left in the time to live of the dialog box (not very useful but maybe it is). <br /> The response always goes back to only the [[prim]] that requested the dialog box.<br />

	<code>		<code>

Strife Onizuka at 05:25, 19 April 2007

Strife Onizuka — Thu, 19 Apr 2007 05:25:43 GMT

← Older revision		Revision as of 22:25, 18 April 2007
Line 134:		Line 134:
	}		}

	//~~Tightlist~~ family of functions Version 1.0		//TightList family of functions Version 1.0
	//Copyright Strife Onizuka 2004-2006		//Copyright Strife Onizuka 2004-2006
	//Free to use and distribute as long as this message is not removed.		//Free to use and distribute as long as this message is not removed.
Line 241:		Line 241:
	}		}

	//~~Tightlist~~ family of functions Version 1.0		//TightList family of functions Version 1.0
	//Copyright Strife Onizuka 2004-2006		//Copyright Strife Onizuka 2004-2006
	//Free to use and distribute as long as this message is not removed.		//Free to use and distribute as long as this message is not removed.

Strife Onizuka: Updating the tightlist functions, etc

Strife Onizuka — Thu, 19 Apr 2007 05:23:13 GMT

Updating the tightlist functions, etc

← Older revision		Revision as of 22:23, 18 April 2007
Line 130:		Line 130:
	dialog(key user, string message, float timeout, list buttons, integer buttonmask, integer retchan, list ret)		dialog(key user, string message, float timeout, list buttons, integer buttonmask, integer retchan, list ret)
	{		{
	llMessageLinked(llGetLinkNumber(), DialogComm, ~~dump~~([retchan] + ret, sepchar),		llMessageLinked(llGetLinkNumber(), DialogComm, TightListDump([retchan] + ret, sepchar),
	~~dump~~([user, message, timeout, buttonmask] + buttons, sepchar));		TightListDump([user, message, timeout, buttonmask] + buttons, sepchar));
	}		}

Line 178:		Line 178:
	{		{
	llWhisper(0,(string)b);		llWhisper(0,(string)b);
	llWhisper(0,llList2CSV(~~parse~~(c)));		llWhisper(0,llList2CSV(TightListParse(c)));
	llWhisper(0,llList2CSV(~~parse~~(d)));		llWhisper(0,llList2CSV(TightListParse(d)));
	//c is the return list		//c is the return list
	//d is a list [button number pressed, user, time left, user name, button text]		//d is a list [button number pressed, user, time left, user name, button text]

Strife Onizuka: Updating the tightlist functions

Strife Onizuka — Thu, 19 Apr 2007 05:20:46 GMT

Updating the tightlist functions

← Older revision		Revision as of 22:20, 18 April 2007
Line 1:		Line 1:
	This [[script]] is a standalone module for the handling of [[dialog]] boxes. All you, the script writer, has to do is build a [[link\|linked message]] handler. Use the example access script as a starting point.<br /><br />'''if you are using a version prior to 9.3 please upgrade as there is a bug which could result in the responce not being registered'''<br />'''8.x is not compatible with 9.x, if you are using a version prior to 8.4 please upgrade as there is a bug with bit 17'''<br /><br />'''Security''':<br /> The dialog boxes each use a random unique negative [[channel]], for each dialog box.<br /> Channel numbers range from -2147483648 to -255 with the possibility of the lower 8 bits being zero.<br /> The [[listen\|listens]] are bound to the [[user\|user's]] [[key]]. This means that no script or other user can activate the interface.<br /> By using a negative number there is no way for the user to type in a command and have it mistaken as a response.<br /> Only responses that are valid buttons from the requested user (and in the mask) will result in a return; no 3rd party tampering is possible.<br /> It would be very difficult for anyone to predict the channel number to listen on (2 billion is a big range).<br /><br />'''The Request''':<br /> The link message [[string]] format is a list. The first element of this [[list]] is the [[integer]] that will be used as the second integer in the [[return]] the link message. The rest of this list is string that will be returned (in list form with the same separating character).<br /><br /> The link message key format is a list. The first element is the key of the user, if this is left blank (or [[NULL KEY\|NULL_KEY]]) the [[owner]] is assumed. The second element is the message, this can be any valid string. The third element is a [[float]], which is the dialog box time to live. The forth element is an integer it is used as a [[mask]] for when a button is pressed if it will trigger a response. The rest of the list is for the buttons; an empty list can be used, but it will default to ["OK"] (there is no way around this, just cope).<br /><br />'''The Response''':<br /> The link message string format is a list. It is whatever was passed as the second string minus the first entry of that list.<br /> The link message key format is a list. The first element of this list is the number of the button pressed (or error code). The second entry is the text of the button pressed. The third entry is the key it used for creating the dialog box. The forth entry is the user name. The fifth entry is how much [[time]] was left in the time to live of the dialog box (not very useful but maybe it is). <br /> The response always goes back to only the [[prim]] that requested the dialog box.<br />		This [[script]] is a standalone module for the handling of [[dialog]] boxes. All you, the script writer, has to do is build a [[link\|linked message]] handler. Use the example access script as a starting point.<br /><br />'''if you are using a version prior to 9.3 please upgrade as there is a bug which could result in the responce not being registered'''<br />'''8.x is not compatible with 9.x, if you are using a version prior to 8.4 please upgrade as there is a bug with bit 17'''<br /><br />'''Security''':<br /> The dialog boxes each use a random unique negative [[channel]], for each dialog box.<br /> Channel numbers range from -2147483648 to -255 with the possibility of the lower 8 bits being zero.<br /> The [[listen\|listens]] are bound to the [[user\|user's]] [[key]]. This means that no script or other user can activate the interface.<br /> By using a negative number there is no way for the user to type in a command and have it mistaken as a response.<br /> Only responses that are valid buttons from the requested user (and in the mask) will result in a return; no 3rd party tampering is possible.<br /> It would be very difficult for anyone to predict the channel number to listen on (2 billion is a big range).<br /><br />'''The Request''':<br /> The link message [[string]] format is a list. The first element of this [[list]] is the [[integer]] that will be used as the second integer in the [[return]] the link message. The rest of this list is string that will be returned (in list form with the same separating character).<br /><br /> The link message key format is a list. The first element is the key of the user, if this is left blank (or [[NULL KEY\|NULL_KEY]]) the [[owner]] is assumed. The second element is the message, this can be any valid string. The third element is a [[float]], which is the dialog box time to live. The forth element is an integer it is used as a [[mask]] for when a button is pressed if it will trigger a response. The rest of the list is for the buttons; an empty list can be used, but it will default to ["OK"] (there is no way around this, just cope).<br /><br />'''The Response''':<br /> The link message string format is a list. It is whatever was passed as the second string minus the first entry of that list.<br /> The link message key format is a list. The first element of this list is the number of the button pressed (or error code). The second entry is the text of the button pressed. The third entry is the key it used for creating the dialog box. The forth entry is the user name. The fifth entry is how much [[time]] was left in the time to live of the dialog box (not very useful but maybe it is). <br /> The response always goes back to only the [[prim]] that requested the dialog box.<br />

	<~~pre~~>		<code>
	(string)~~dump~~([[llList2List\|llList2List]](~~parse~~(paramString),1,-1)),		(string)[[TightList\|TightListDump]]([[llList2List\|llList2List]]([[TightList\|TightListParse]](paramString),1,-1)),
	(key)~~dump~~([integer buttonNum, string buttonText, key user, string userName, float aproxTimeLeft],"")		(key)[[TightList\|TightListDump]]([integer buttonNum, string buttonText, key user, string userName, float aproxTimeLeft],"")
	</~~pre~~>		</code>

	<br /> There is no way to create a dialog box that won't timeout. The value must be between 5.0 and 7200.0; or it will be replaced by the default timeout. The timeout won't make a box disapeer off the users screen, but the script will stop listening for results.<br /><br />'''Notes''':<br /> Know your data; if your strings contain "\|" then don't use "\|" as the separator. If the script acts weirdly this is probably why. The separator can only be one character. The two different strings being passed in the linked message can use different separating characters.<br /><br />'''Misc''':<br /> The ButtonMask has a few extra tricks.<br /> The first 12 [[bit\|bits]] corespond to the 12 buttons (bits 0 -> 11)<br /> Bits 16 through 22 are special bits for error handling and setup.<br /> All other bits are ignored, do with them as you please but be warned they may be used in the future.<br />		<br /> There is no way to create a dialog box that won't timeout. The value must be between 5.0 and 7200.0; or it will be replaced by the default timeout. The timeout won't make a box disapeer off the users screen, but the script will stop listening for results.<br /><br />'''Notes''':<br /> Know your data; if your strings contain "\|" then don't use "\|" as the separator. If the script acts weirdly this is probably why. The separator can only be one character. The two different strings being passed in the linked message can use different separating characters.<br /><br />'''Misc''':<br /> The ButtonMask has a few extra tricks.<br /> The first 12 [[bit\|bits]] corespond to the 12 buttons (bits 0 -> 11)<br /> Bits 16 through 22 are special bits for error handling and setup.<br /> All other bits are ignored, do with them as you please but be warned they may be used in the future.<br />
Line 116:		Line 116:
	<br /> The queue is cleared in two ways: [[on rez\|on_rez]] or when creating a dialog box requests it. When the script is rez'ed, the old dialog box requests become meaningless (because the script cannot receive the response). By having bit 17 on, it allows for this [[event]] to be returned to the script requesting the box. By having bit 20 turned on also causes the queue to be reset (exactly like an on_rez). Using bit 20 may have undesired effects if you are using this module with multiple scripts. Using bit 21 causes a partial clear. It clears out all boxes for the requested user; it is advisable to use this option instead of bit 20.<br /><br />'''Todo''':<br /> When bits 20 and 21 are true have the inverse result happen. All boxes not of the current user would be cleared from the queue.<br /><br />'''Tricks''':<br /> Pass a list of useful values as the return list. Have them correspond to the button list. Then use the code below to get that value from the return (remember if you have any of bits 16 -> 19 enabled you will get negative index values on errors).<br />		<br /> The queue is cleared in two ways: [[on rez\|on_rez]] or when creating a dialog box requests it. When the script is rez'ed, the old dialog box requests become meaningless (because the script cannot receive the response). By having bit 17 on, it allows for this [[event]] to be returned to the script requesting the box. By having bit 20 turned on also causes the queue to be reset (exactly like an on_rez). Using bit 20 may have undesired effects if you are using this module with multiple scripts. Using bit 21 causes a partial clear. It clears out all boxes for the requested user; it is advisable to use this option instead of bit 20.<br /><br />'''Todo''':<br /> When bits 20 and 21 are true have the inverse result happen. All boxes not of the current user would be cleared from the queue.<br /><br />'''Tricks''':<br /> Pass a list of useful values as the return list. Have them correspond to the button list. Then use the code below to get that value from the return (remember if you have any of bits 16 -> 19 enabled you will get negative index values on errors).<br />

	<~~pre~~>[[llList2String\|llList2String]](~~parse~~(c),(integer)[[llList2String\|llList2String]](~~parse~~(d),0));</~~pre~~>		<code>[[llList2String\|llList2String]]([[TightList\|TightListParse]](c),(integer)[[llList2String\|llList2String]]([[TightList\|TightListParse]](d),0));</code>

	<br />		<br />
Line 134:		Line 134:
	}		}

	string ~~dump~~(list a, string b)		//Tightlist family of functions Version 1.0
	{		//Copyright Strife Onizuka 2004-2006
	string c = (string)a;		//Free to use and distribute as long as this message is not removed.
	if(1+llSubStringIndex(c,b) ~~\|\| llStringLength(b)!=1~~)
	{		string TightListDump(list input, string possibles)
	b += "\|\\/?!@#$%^&*()_=:;~{}[],\n qQxXzZ";		{//TLD( complex) makes a string from a list using a seperator that is supposed to be unique to the string
	~~integer d = -llStringLength(b)~~;		string buffer = (string)(input);//dump the list without a seperator
	while(1+llSubStringIndex(c,llGetSubString(b,d,d)) && d)		integer counter = -39 - llStringLength(possibles);
	~~d++~~;		if(counter == -40)
	b = llGetSubString(b,d,d);		if(!~llSubStringIndex(buffer,possibles))
	}		jump end;//woot, we were given a unique seperator
	return b + llDumpList2String(a, b);		possibles += "\|/?!@#$%^&*()_=:;~`'<>{}[],.\n\" qQxXzZ\\";//Good character set of rarely used letters.
			do; while(~llSubStringIndex(buffer,llGetSubString(possibles,counter,counter)) && (counter=-~counter));//search for unique seperator
			possibles = llGetSubString(possibles,counter,counter);
			@end;
			buffer = "";//save memory
			return possibles + llDumpList2String((input = []) + input, possibles);
	}		}

	list ~~parse~~(string a) {		list TightListParse(string a) {
	string b = llGetSubString(a,0,0);//save memory		string b = llGetSubString(a,0,0);//save memory
	return llParseStringKeepNulls(llDeleteSubString(a,0,0), [b],[]);		return llParseStringKeepNulls(llDeleteSubString(a,0,0), [a=b],[]);
	}		}

Line 235:		Line 240:
	users = llDeleteSubString(users,a*=36,a+35);		users = llDeleteSubString(users,a*=36,a+35);
	}		}

			//Tightlist family of functions Version 1.0
			//Copyright Strife Onizuka 2004-2006
			//Free to use and distribute as long as this message is not removed.

	list TightListParse(string a) {		list TightListParse(string a) {
Line 461:		Line 470:
	string quickdump(list a, string b){ return b + llDumpList2String(a, b); }		string quickdump(list a, string b){ return b + llDumpList2String(a, b); }
	#endif		#endif

			#//include "tightlist.esl"

			//Tightlist family of functions Version 1.0
			//Copyright Strife Onizuka 2004-2006
			//Free to use and distribute as long as this message is not removed.

	list TightListParse(string a) {		list TightListParse(string a) {
Line 615:		Line 630:
	}		}
	}</pre>		}</pre>

	----		----

	{{LSLC\|Library}} ~~\| [[Inventory Menu Module]]~~		[[Inventory Menu Module]]
			{{LSLC\|Library}}

Strife Onizuka: Lazy port from RPGStats (I am the exclusive author)

Strife Onizuka — Thu, 19 Apr 2007 05:13:30 GMT

Lazy port from RPGStats (I am the exclusive author)

New page

This [[script]] is a standalone module for the handling of [[dialog]] boxes. All you, the script writer, has to do is build a [[link|linked message]] handler. Use the example access script as a starting point. '''if you are using a version prior to 9.3 please upgrade as there is a bug which could result in the responce not being registered''' '''8.x is not compatible with 9.x, if you are using a version prior to 8.4 please upgrade as there is a bug with bit 17''' '''Security''': The dialog boxes each use a random unique negative [[channel]], for each dialog box. Channel numbers range from -2147483648 to -255 with the possibility of the lower 8 bits being zero. The [[listen|listens]] are bound to the [[user|user's]] [[key]]. This means that no script or other user can activate the interface. By using a negative number there is no way for the user to type in a command and have it mistaken as a response. Only responses that are valid buttons from the requested user (and in the mask) will result in a return; no 3rd party tampering is possible. It would be very difficult for anyone to predict the channel number to listen on (2 billion is a big range). '''The Request''': The link message [[string]] format is a list. The first element of this [[list]] is the [[integer]] that will be used as the second integer in the [[return]] the link message. The rest of this list is string that will be returned (in list form with the same separating character). The link message key format is a list. The first element is the key of the user, if this is left blank (or [[NULL KEY|NULL_KEY]]) the [[owner]] is assumed. The second element is the message, this can be any valid string. The third element is a [[float]], which is the dialog box time to live. The forth element is an integer it is used as a [[mask]] for when a button is pressed if it will trigger a response. The rest of the list is for the buttons; an empty list can be used, but it will default to ["OK"] (there is no way around this, just cope). '''The Response''': The link message string format is a list. It is whatever was passed as the second string minus the first entry of that list. The link message key format is a list. The first element of this list is the number of the button pressed (or error code). The second entry is the text of the button pressed. The third entry is the key it used for creating the dialog box. The forth entry is the user name. The fifth entry is how much [[time]] was left in the time to live of the dialog box (not very useful but maybe it is). The response always goes back to only the [[prim]] that requested the dialog box. 

<pre>
(string)dump([[llList2List|llList2List]](parse(paramString),1,-1)),
(key)dump([integer buttonNum, string buttonText, key user, string userName, float aproxTimeLeft],"")
</pre>

 There is no way to create a dialog box that won't timeout. The value must be between 5.0 and 7200.0; or it will be replaced by the default timeout. The timeout won't make a box disapeer off the users screen, but the script will stop listening for results. '''Notes''': Know your data; if your strings contain "|" then don't use "|" as the separator. If the script acts weirdly this is probably why. The separator can only be one character. The two different strings being passed in the linked message can use different separating characters. '''Misc''': The ButtonMask has a few extra tricks. The first 12 [[bit|bits]] corespond to the 12 buttons (bits 0 -> 11) Bits 16 through 22 are special bits for error handling and setup. All other bits are ignored, do with them as you please but be warned they may be used in the future. 

{| {{Prettytable}}
|- valign="top"
|| '''Bit'''
|| '''Hex Value'''
|| '''Event'''
|| '''Return Button'''
|-
|| 0
|| 0x000001
|| Button 0 Pressed
|| 0
|-
|| 1
|| 0x000002
|| Button 1 Pressed
|| 1
|-
|| 2
|| 0x000004
|| Button 2 Pressed
|| 2
|-
|| 3
|| 0x000008
|| Button 3 Pressed
|| 3
|-
|| 4
|| 0x000010
|| Button 4 Pressed
|| 4
|-
|| 5
|| 0x000020
|| Button 5 Pressed
|| 5
|-
|| 6
|| 0x000040
|| Button 6 Pressed
|| 6
|-
|| 7
|| 0x000080
|| Button 7 Pressed
|| 7
|-
|| 8
|| 0x000100
|| Button 8 Pressed
|| 8
|-
|| 9
|| 0x000200
|| Button 9 Pressed
|| 9
|-
|| 10
|| 0x000400
|| Button 10 Pressed
|| 10
|-
|| 11
|| 0x000800
|| Button 11 Pressed
|| 11
|-
|| 16
|| 0x010000
|| Dialog box times out
|| -1
|-
|| 17
|| 0x020000
||
[[queue|Queue]] being cleared
|| -2
|-
|| 18
|| 0x040000
||
[[Target]] [[agentandavatar|agent]] not found
|| -3
|-
|| 19
|| 0x080000
|| No buttons to listen for, bad mask or bad return channel
|| -4
|-
|| 20
|| 0x100000
|| Clears the queue then creates the dialog box
|| -2 via Bit 17
|-
|| 21
|| 0x200000
|| Same as bit 20 but only for boxes for the current user
|| -2 via Bit 17
|-
|| 22
|| 0x400000
||
[[Target]] [[agentandavatar|agent]] has left the sim
|| -5
|}

 The queue is cleared in two ways: [[on rez|on_rez]] or when creating a dialog box requests it. When the script is rez'ed, the old dialog box requests become meaningless (because the script cannot receive the response). By having bit 17 on, it allows for this [[event]] to be returned to the script requesting the box. By having bit 20 turned on also causes the queue to be reset (exactly like an on_rez). Using bit 20 may have undesired effects if you are using this module with multiple scripts. Using bit 21 causes a partial clear. It clears out all boxes for the requested user; it is advisable to use this option instead of bit 20. '''Todo''': When bits 20 and 21 are true have the inverse result happen. All boxes not of the current user would be cleared from the queue. '''Tricks''': Pass a list of useful values as the return list. Have them correspond to the button list. Then use the code below to get that value from the return (remember if you have any of bits 16 -> 19 enabled you will get negative index values on errors). 

<pre>[[llList2String|llList2String]](parse(c),(integer)[[llList2String|llList2String]](parse(d),0));</pre>

 

----

 Example Access script to Dialog Module: 

<pre>string sepchar = "|";
integer answer = 546;
integer DialogComm = 12;

dialog(key user, string message, float timeout, list buttons, integer buttonmask, integer retchan, list ret)
{
llMessageLinked(llGetLinkNumber(), DialogComm, dump([retchan] + ret, sepchar),
dump([user, message, timeout, buttonmask] + buttons, sepchar));
}

string dump(list a, string b)
{
string c = (string)a;
if(1+llSubStringIndex(c,b) || llStringLength(b)!=1)
{
b += "|\\/?!@#$%^&*()_=:;~{}[],\n qQxXzZ";
integer d = -llStringLength(b);
while(1+llSubStringIndex(c,llGetSubString(b,d,d)) && d)
d++;
b = llGetSubString(b,d,d);
}
return b + llDumpList2String(a, b);
}

list parse(string a) {
string b = llGetSubString(a,0,0);//save memory
return llParseStringKeepNulls(llDeleteSubString(a,0,0), [b],[]);
}

default
{
state_entry()
{
integer rint = 6;
string question = "Would you like a drink?";
list Answers = ["Yes", "No", "Strongest"];
integer AnswerMask = 0x005;
list ExtraPassback = ["extra info to pass back"];
dialog(llGetOwner(), question, 30,Answers, AnswerMask , answer, ExtraPassback);
}
touch_start(integer a)
{
dialog(llDetectedKey(0), "Hello\nDo you like me?", 30, ["Yes", "No"], 0xf0fff, answer, ["I think they like us"]);
}
link_message(integer a, integer b, string c, key d)
{
if(b==answer)
{
llWhisper(0,(string)b);
llWhisper(0,llList2CSV(parse(c)));
llWhisper(0,llList2CSV(parse(d)));
//c is the return list
//d is a list [button number pressed, user, time left, user name, button text]
}
}
}</pre>

 Dialog Module: 

<pre>//////////////////////////////////////////////////////////////////////////////////////
//
// Dialog Module
// Version 9.3 Release
// Copyright (C) 2004-2006, Strife Onizuka
// http://home.comcast.net/~mailerdaemon/
// http://secondlife.com/badgeo/wakka.php?wakka=LibraryDialogModule
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public License
// as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
//////////////////////////////////////////////////////////////////////////////////////

//////////////////////////////////////////////////////////////////////////////////////
//Don't change anything else unless you *really* need to.

list handles;
list time;
list chans;
string users;//save memory
list answer;
list button;
list prim;
list mask;
list intchan;

integer ticks;

remove(integer a)
{
llListenRemove(llList2Integer(handles,a));
handles = llDeleteSubList(handles,a,a);
time = llDeleteSubList(time, a,a);
chans = llDeleteSubList(chans, a,a);
answer = llDeleteSubList(answer, a,a);
button = llDeleteSubList(button, a,a);
prim = llDeleteSubList(prim, a,a);
mask = llDeleteSubList(mask, a,a);
intchan = llDeleteSubList(intchan,a,a);
users = llDeleteSubString(users,a*=36,a+35);
}

list TightListParse(string a) {
string b = llGetSubString(a,0,0);//save memory
return llParseStringKeepNulls(llDeleteSubString(a,0,0), [a=b],[]);
}

clear()
{
integer a = llGetListLength(handles);
while(a)
{
llListenRemove(llList2Integer(handles,--a));
if(llList2Integer(mask,a)&0x20000)
llMessageLinked(llList2Integer(prim,a), llList2Integer(intchan,a),
llList2String(answer,a), "|-2||"+llGetSubString(users,a * 36,(a * 36) + 35)+"||-1");
}
llSetTimerEvent(ticks = 0);
}

default
{
state_entry()
{

llOwnerSay("Dialog Module, Version 9.3, Released Under the GNU Lesser General Public License");
llOwnerSay("Copyright (C) 2004-2006, Strife Onizuka, http://secondlife.com/badgeo/wakka.php?wakka=LibraryDialogModule");

}
on_rez(integer a)
{
clear();
}
link_message(integer a, integer b, string c, key d)
{
if(b == 12)
{
b = llSubStringIndex(llDeleteSubString(c,0,0), llGetSubString(c,0,0));
list e = TightListParse(d);
integer buttonmask = (integer)llList2String(e,3);
string user = llList2String(e,0);
list buttons = llDeleteSubList(e,0,3);
float timeout = (float)llList2String(e,2);
integer cat = (integer)llFrand(-2147483392.0) - 255;
integer chan = (integer)llDeleteSubString(c, b + 1, 0);
string ans = llDeleteSubString(c,0,b);

if(buttonmask & 0x100000)
clear();
else if(buttonmask & 0x200000)
{//clean out other box's that went to this user.
while(1 + (b = llSubStringIndex(users, user)))
{
if(llList2Integer(mask,b/=36)&0x20000)
llMessageLinked(llList2Integer(prim,b), llList2Integer(intchan,b),
llList2String(answer,b), "|-2||"+llGetSubString(users,b * 36,(b * 36) + 35)+"||-1");
remove(b);
}
if(time == [])
llSetTimerEvent(ticks = 0);
}

if(user == "" || user == NULL_KEY) //lazy check
user = llGetOwner();
if(!llGetAgentInfo(user))
{// target not in the sim
if(buttonmask & 0x40000)
llMessageLinked(a, chan, ans, "|-3||"+user+"||0");
jump end1;//instead of a return, too many local variables to clear off the stack.
}
while(1+llListFindList(chans,[cat]))
--cat;

b = llListen(cat,"",user,"");
llDialog(user, llList2String(e,1), buttons, cat);
if(chan != 12)
{//loopback catch
if(buttons == []) // so we can match the ok button
buttons = ["OK"];
if(buttonmask & ((1<<llGetListLength(buttons)) - 1))
{ //we checked the mask to see if we should expect any values back
chans += cat;
handles += b;
if(timeout < 5.0 || timeout > 7200)
timeout = 5.0;
time += (ticks + (timeout / 5.0));
users += user;
answer += ans;
button += (llGetSubString(d,0,0) + llDumpList2String(buttons, llGetSubString(d,0,0)));
prim += a;
mask += buttonmask;
intchan += chan;
llSetTimerEvent(5.0);
jump end2;//instead of a return, too many local variables to clear off the stack.
}
}
llListenRemove(b);
if(buttonmask & 0x80000)
llMessageLinked(a, chan, ans, "|-4||"+(string)user+"||0");
}
@end1;@end2;
}
listen(integer a, string b, key c, string d)
{
if(a+1 && llGetSubString(users,36 * a=llListFindList(chans,[a]),(a * 36) + 35) == c)
{//it's one of our listens
integer f = llListFindList(TightListParse(llList2String(button,a)),[d]);
if(f+1)
{//we matched a button
if(llList2Integer(mask,a)&(1<<f))
{
list ret = [f, d, c, b,(llList2Float(time,a) - ticks) * 5.0];
if(llSubStringIndex(d = (string)ret,b = "|") + 1)
{
f = -37;
b = "|\\/?!@#$%^&*()_=:;~{}[]<>`',\n\" qQxXzZ";
do;while(1+llSubStringIndex(d,llGetSubString(b,f,f)) && ++f);
b = llGetSubString(b,f,f);
}
d = "";
llMessageLinked(llList2Integer(prim,a), llList2Integer(intchan,a),
llList2String(answer,a), (b + llDumpList2String(ret, b)));
}
remove(a);
if(time == [])
llSetTimerEvent(ticks = 0);
}
}
}
timer()
{
++ticks;
integer a = llGetListLength(time);
float c;
key d;
while(a)
{
if(((c = llList2Float(time,a)) <= ticks) || !llGetAgentInfo(d = llGetSubString(users,--a * 36,(a * 36) + 35)))
{
if(llList2Integer(mask,a)&0x10000)
llMessageLinked(llList2Integer(prim,a), llList2Integer(intchan,a),
llList2String(answer,a), "|-1||"+(string)d+"||"+(string)((ticks - c) * 5.0));

remove(a);
}
}
if(time == [])
llSetTimerEvent(ticks = 0);
}
}</pre>

 ESL Version: 

<pre>//////////////////////////////////////////////////////////////////////////////////////
//
// Dialog Module
// Version 9.3 Release
// Copyright (C) 2004-2006, Strife Onizuka
// http://home.comcast.net/~mailerdaemon/
// http://secondlife.com/badgeo/wakka.php?wakka=LibraryDialogModule
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public License
// as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
//////////////////////////////////////////////////////////////////////////////////////

#ifndef DIALOGCOMM
#define DIALOGCOMM 12
#endif
#ifdef USESCRIPTNAME
integer DialogComm = DIALOGCOMM;
#elif !defined DialogComm
#define DialogComm DIALOGCOMM
#endif

#ifndef TICKSIZE
#define TICKSIZE 5.0
#endif
#ifndef DEFAULTTIMEOUT
#define DEFAULTTIMEOUT TICKSIZE
#endif
//////////////////////////////////////////////////////////////////////////////////////
//Don't change anything else unless you *really* need to.
#define ZERO_INTEGER 0
list handles;
list time;
list chans;
string users;//save memory
list answer;
list button;
list prim;
list mask;
list intchan;

integer ticks;

remove(integer a)
{
llListenRemove(llList2Integer(handles,a));
handles = llDeleteSubList(handles,a,a);
time = llDeleteSubList(time, a,a);
chans = llDeleteSubList(chans, a,a);
answer = llDeleteSubList(answer, a,a);
button = llDeleteSubList(button, a,a);
prim = llDeleteSubList(prim, a,a);
mask = llDeleteSubList(mask, a,a);
intchan = llDeleteSubList(intchan,a,a);
users = llDeleteSubString(users,a*=36,a+35);
}

#define wipe() llSetTimerEvent(ticks = ZERO_INTEGER)
#define quickdump(a, b) (b + llDumpList2String(a, b))
#ifndef quickdump
string quickdump(list a, string b){ return b + llDumpList2String(a, b); }
#endif

list TightListParse(string a) {
string b = llGetSubString(a,ZERO_INTEGER,ZERO_INTEGER);//save memory
return llParseStringKeepNulls(llDeleteSubString(a,ZERO_INTEGER,ZERO_INTEGER), [a=b],[]);
}

clear()
{
integer a = llGetListLength(handles);
while(a)
{
llListenRemove(llList2Integer(handles,--a));
if(llList2Integer(mask,a)&0x20000)
llMessageLinked(llList2Integer(prim,a), llList2Integer(intchan,a),
llList2String(answer,a), "|-2||"+llGetSubString(users,a * 36,(a * 36) + 35)+"||-1");
}
wipe();
}

default
{
state_entry()
{
#ifdef USESCRIPTNAME
if((DialogComm += (integer)llList2String(llParseString2List(llGetScriptName(), [" "],[]), -1)) == DialogComm)
{
#endif
llOwnerSay("Dialog Module, Version 9.3, Released Under the GNU Lesser General Public License");
llOwnerSay("Copyright (C) 2004-2006, Strife Onizuka, http://secondlife.com/badgeo/wakka.php?wakka=LibraryDialogModule");
#ifdef USESCRIPTNAME
}
#endif
}
on_rez(integer a)
{
clear();
}
link_message(integer a, integer b, string c, key d)
{
if(b == DialogComm)
{
b = llSubStringIndex(llDeleteSubString(c,ZERO_INTEGER,ZERO_INTEGER), llGetSubString(c,ZERO_INTEGER,ZERO_INTEGER));
list e = TightListParse(d);
integer buttonmask = (integer)llList2String(e,3);
string user = llList2String(e,ZERO_INTEGER);
list buttons = llDeleteSubList(e,ZERO_INTEGER,3);
float timeout = (float)llList2String(e,2);
integer cat = (integer)llFrand(-2147483392.0) - 255;
integer chan = (integer)llDeleteSubString(c, b + 1, ZERO_INTEGER);
string ans = llDeleteSubString(c,ZERO_INTEGER,b);

if(buttonmask & 0x100000)
clear();
else if(buttonmask & 0x200000)
{//clean out other box's that went to this user.
while(1 + (b = llSubStringIndex(users, user)))
{
if(llList2Integer(mask,b/=36)&0x20000)
llMessageLinked(llList2Integer(prim,b), llList2Integer(intchan,b),
llList2String(answer,b), "|-2||"+llGetSubString(users,b * 36,(b * 36) + 35)+"||-1");
remove(b);
}
if(time == [])
wipe();
}

if(user == "" || user == NULL_KEY) //lazy check
user = llGetOwner();
if(!llGetAgentInfo(user))
{// target not in the sim
if(buttonmask & 0x40000)
llMessageLinked(a, chan, ans, "|-3||"+user+"||0");
jump end1;//instead of a return, too many local variables to clear off the stack.
}
while(1+llListFindList(chans,[cat]))
--cat;

b = llListen(cat,"",user,"");
llDialog(user, llList2String(e,1), buttons, cat);
if(chan != DialogComm)
{//loopback catch
if(buttons == []) // so we can match the ok button
buttons = ["OK"];
if(buttonmask & ((1<<llGetListLength(buttons)) - 1))
{ //we checked the mask to see if we should expect any values back
chans += cat;
handles += b;
if(timeout < 5.0 || timeout > 7200)
timeout = DEFAULTTIMEOUT;
time += (ticks + (timeout / TICKSIZE));
users += user;
answer += ans;
button += quickdump(buttons,llGetSubString(d,ZERO_INTEGER,ZERO_INTEGER));
prim += a;
mask += buttonmask;
intchan += chan;
llSetTimerEvent(TICKSIZE);
jump end2;//instead of a return, too many local variables to clear off the stack.
}
}
llListenRemove(b);
if(buttonmask & 0x80000)
llMessageLinked(a, chan, ans, "|-4||"+(string)user+"||0");
}
@end1;@end2;
}
listen(integer a, string b, key c, string d)
{
if(a+1 && llGetSubString(users,36 * a=llListFindList(chans,[a]),(a * 36) + 35) == c)
{//it's one of our listens
integer f = llListFindList(TightListParse(llList2String(button,a)),[d]);
if(f+1)
{//we matched a button
if(llList2Integer(mask,a)&(1<<f))
{
list ret = [f, d, c, b,(llList2Float(time,a) - ticks) * TICKSIZE];
if(llSubStringIndex(d = (string)ret,b = "|") + 1)
{
f = -37;
b = "|\\/?!@#$%^&*()_=:;~{}[]<>`',\n\" qQxXzZ";
do;while(1+llSubStringIndex(d,llGetSubString(b,f,f)) && ++f);
b = llGetSubString(b,f,f);
}
d = "";
llMessageLinked(llList2Integer(prim,a), llList2Integer(intchan,a),
llList2String(answer,a), quickdump(ret, b));
}
remove(a);
if(time == [])
wipe();
}
}
}
timer()
{
++ticks;
integer a = llGetListLength(time);
float c;
key d;
while(a)
{
if(((c = llList2Float(time,a)) <= ticks) || !llGetAgentInfo(d = llGetSubString(users,--a * 36,(a * 36) + 35)))
{
if(llList2Integer(mask,a)&0x10000)
llMessageLinked(llList2Integer(prim,a), llList2Integer(intchan,a),
llList2String(answer,a), "|-1||"+(string)d+"||"+(string)((ticks - c) * TICKSIZE));

remove(a);
}
}
if(time == [])
wipe();
}
}</pre>
----

{{LSLC|Library}} | [[Inventory Menu Module]]