Difference between revisions of "User:Rufus Darkfold/Dialogger"

From Second Life Wiki
Jump to navigation Jump to search
(Created page with "Dialogger is a HUD which uses a pool of prims to display buttons and sliders and other types of controls. This affords much greater control over the location and the appearance o…")
 
Line 4: Line 4:


To put a dialog prim on the screen, send a chat to channel 444 or a link message to 44400:
To put a dialog prim on the screen, send a chat to channel 444 or a link message to 44400:
[/outchan] name,p,px[,v]
[/outchan] name,p,px[,v]
/outchan = (optional) / character followed by return chat channel number followed by space.  (The [ ] are not part of the message)  
/outchan = (optional) / character followed by return chat channel number followed by space.  (The [ ] are not part of the message)  
name = field label or texture
name = field label or texture
p = location to place control (rotation: <lowerleft.x,lowerleft.y,upperright.x,upperright.y>).  0,0 is the lower-left corner of the root prim,  1,1 is the upper right, so <0,0,1,1> would cover the whole thing if it is rectangular.  
p = location to place control (rotation: <lowerleft.x,lowerleft.y,upperright.x,upperright.y>).  0,0 is the lower-left corner of the root prim,  1,1 is the upper right, so <0,0,1,1> would cover the whole thing if it is rectangular.  
px (rotation) = bounds or control type:
px (rotation) = bounds or control type:
  <1,0,0,0> texture (texture name in newtext)
:<1,0,0,0> texture (texture name in newtext)
  <1,1,0,0> texture picker.  Drop any full-perm texture on it to send its UUID as its value.
:<1,1,0,0> texture picker.  Drop any full-perm texture on it to send its UUID as its value.
  <2,0,0,0> on/off button green/red
:<2,0,0,0> on/off button green/red
  <2,r,g,b>  (0<(r,g,b)<1) menu button in color rgb
:<2,r,g,b>  (0<(r,g,b)<1) menu button in color rgb
  <3,lo,0,hi> 3 vertical sliders with a range from lo to hi
:<3,lo,0,hi> 3 vertical sliders with a range from lo to hi
  <3,lo,2,hi> 1 2-dimensional xy-slider and 1 vertical z slider with a range from lo to hi
:<3,lo,2,hi> 1 2-dimensional xy-slider and 1 vertical z slider with a range from lo to hi
    otherwise <lowerlimit.x,lowerlimit.y,upperlimit.x,upperlimit.y> slider control in 1 or 2 dimensions
::otherwise <lowerlimit.x,lowerlimit.y,upperlimit.x,upperlimit.y> slider control in 1 or 2 dimensions
    zero bounds for dimension not being used (except use 1 to force values to integers).
::zero bounds for dimension not being used (except use 1 to force values to integers).
v = value (vector) to display (optional).  Scalar values are passed as <x,0,0>
v = value (vector) to display (optional).  Scalar values are passed as <x,0,0>



Revision as of 00:15, 13 September 2011

Dialogger is a HUD which uses a pool of prims to display buttons and sliders and other types of controls. This affords much greater control over the location and the appearance of these controls than llDialog, as well as providing a convenient way of setting numerical values.

To put a dialog prim on the screen, send a chat to channel 444 or a link message to 44400:

[/outchan] name,p,px[,v]

/outchan = (optional) / character followed by return chat channel number followed by space. (The [ ] are not part of the message)

name = field label or texture p = location to place control (rotation: <lowerleft.x,lowerleft.y,upperright.x,upperright.y>). 0,0 is the lower-left corner of the root prim, 1,1 is the upper right, so <0,0,1,1> would cover the whole thing if it is rectangular. px (rotation) = bounds or control type:

<1,0,0,0> texture (texture name in newtext)
<1,1,0,0> texture picker. Drop any full-perm texture on it to send its UUID as its value.
<2,0,0,0> on/off button green/red
<2,r,g,b> (0<(r,g,b)<1) menu button in color rgb
<3,lo,0,hi> 3 vertical sliders with a range from lo to hi
<3,lo,2,hi> 1 2-dimensional xy-slider and 1 vertical z slider with a range from lo to hi
otherwise <lowerlimit.x,lowerlimit.y,upperlimit.x,upperlimit.y> slider control in 1 or 2 dimensions
zero bounds for dimension not being used (except use 1 to force values to integers).

v = value (vector) to display (optional). Scalar values are passed as <x,0,0>

If name specifies a dialog prim that is already being displayed, that one is updated. In that case, p and px are also optional (use old values if blank or missing).

An empty message clears all dialog prims (makes them invisible)