Menu System 2 (Second Life)

From Grigbertz

(Difference between revisions)
Jump to: navigation, search
(Note Card Format)
(Commands =)
Line 118: Line 118:
-
== Commands ===
+
=== Commands ===
The following commands are available:
The following commands are available:

Revision as of 14:37, 18 October 2008

Menu System 2 is a note-card-configured system for making easily interchangeable and configurable menu trees in second Life objects.

Contents

Note Card Format

The note card may contain the following type of lines:

  • Blank lines
  • Comments
  • Configuration Variable Settings
  • Menu Definitions.

Blank lines and comment lines are ignored when reading the notecard, and not stored in memory.

Comment Lines

Comment lines starts with '#' in the first position.

Configuration Varables

Configuration Variable lines are defined as name '=' value. Names are case independent.

The following variables are currently defined:

  • defaultanimation
  • animationclientname

Configuration variables are for the menu system itself, not for its contents, so they should not be confused with the display variables defined later.

Menu Definitions

Menu Definitions consist of:

  • Menu Name
  • Description
  • Button Definitions

Menu Name

The definition starts with the menu name surrounded by triple hyphens, like this:

  ---main---

The definition ends with the start of the next menu definition, or by just three hyphens on their own:

  ---

Menu Names and Roles

When a menu has a special definion for only a given role of users, that role can be given after the menu name itself, like this:

  ---main operator---

When the user has a specific role, the system first looks for menu name with role, and if it cannot find it, it looks for just the menu name.

The following roles are defined:

  • owner
  • operator
  • other

Description

Description lines start with an asterisk, like this:

  * This is a 
  * multi-line
  * description

Newlines are significant, so the three lines above will show as three lines in the dialog box.

Descriptions and variable substitution

Descriptions can have display variables in them. These variables are sent to the menu system by the other scripts in the object as link messages. When the menu dialog box is to be shown, the variables are looked up and inserted into the description.

Variables are written into the description as dollar-brace name brace-dollar, like this:

  ${name}$

A short number of variables are predefined, and not sent by other scripts. Those are:

  • owner - object owner name
  • object - object name

Like this:

  * ${object}$ is owned by ${owner}$

Button definitions

Buttons are defined by first a single button line, followed by any number of command lines.

The button line consists of the button label within brackets, followed by a number of modifiers separated by vertical bar:

  [Lock] ifnot locked | hideinactive | keepmenu 

The command lines consist of a command, followed by a list of arguments, separated by vertical bars.

  regionsay | 0 | Hello World!

Both button lines and command lines can have any number of spaces surrounding the vertical bars.

Button Modifiers

Button modifiers consists of an optional condition expression, an optional "keepmenu", and/or an optional "hideinactive". These may come in any order.

Button Condition Expression Modifier

The button condition expression governs whether the button should be displayed in the menu. The other scripts in the onject can send named conditions to the menu system, indicating any state of the object that should reflect in the buttons. The condition expression combines these named conditions, and use that combination to choose if the button is shown.

The possible expressions are:

  • if condition
  • ifnot condition
  • ifanyof condition condition ... condition
  • ifallof condition condition ... condition
  • ifnoneof condition condition ... condition

If any more complex logical combination is needed than those above, the state-maintaining script better define that combination as a single new condition and send that one.

Hide Inactive Modifier

This modifier chooses how a button whose condition is not met is displayed.

If the "hideinactive" modifier is given, then the menu system totally removes the button. If it is not there, a blank button is instead shown when the condition is not met.

Keep Menu Modifier

The "keepmenu" modifier governs the menu persistence. If it is present, the menu will be re-displayed after after the button is pressed.


Commands

The following commands are available:

Name Argument 1 Argument 2 Function
menu menu name Replaces this menu with the named one (optionally modified by the user role, see menu name above)
none A no-op.
animateuser animation name Animates the agent using the menu.
animatesitter animation name Animates the agent sitting on this object.
stopanimation Stops the latest animation this object activated on the agent using the menu.
stopallanimations Stops the all animations on the agent using the menu.
messagelinkset message Send a message to all scripts in all prims in the same objects.
messagelinkthis message Send a message to all scripts in the same prim in the same objects.
regionsay channel message Shout a message all over the region.
say channel message Say a message in the local area.
rlv rlv string Send a RLV string to the client of the object's owner, if RLV is activated.

Animation helpers

Communication

Channels Listened to

The Menu system sets up a random channel to listen to for each menu definition. This makes it able to separate buttons with the same label, but in different menus, from each other.

Touch

The Menu System does not itself listen to touch events. Other scripts in the object must send a linked message (see below) to display the first menu.

Linked Messages Listened to

The menu system listens to a number of linked messages

Name Argument(s) Function Example Call
menu menuname Display the given menu llMessageLinked(LINK_THIS, 0, "menu " + menuName, agentKey);
setSitter Set the key of the agent sitting on this object. llMessageLinked(LINK_THIS, 0, "setSitter", agentKey);
removeSitter Remove the key of the agent sitting on this object. llMessageLinked(LINK_THIS, 0, "removeSitter", NULL_KEY);
setConditions space-separated list of conditions Set all conditions that apply. llMessageLinked(LINK_THIS, 0, "setConditions " + llDumpList2String(conditionList, " "), NULL_KEY);
addConditions space-separated list of conditions Add these conditions to those that apply. llMessageLinked(LINK_THIS, 0, "addConditions " + llDumpList2String(conditionList, " "), NULL_KEY);
removeConditions space-separated list of conditions Remove these conditions from those that apply. llMessageLinked(LINK_THIS, 0, "removeConditions " + llDumpList2String(conditionList, " "), NULL_KEY);
setVariableValue name and URL-encoded value, separated by space. Set this display variable for inclusion in menu descriptions. llMessageLinked(LINK_THIS, 0, "setVariableValue" + name + " " + llEscapeURL(value), NULL_KEY);
useDefaultAnimation Use the animation configured as default on the supplied avatar. llMessageLinked(LINK_THIS, 0, "useDefaultAnimation", avatarKey);
Personal tools