Linden text version 2
{
LLEmbeddedItems version 1
{
count 0
}
Text length 7144
At the heart of the CDM is a set of menu Dialogs which allow you to control the dance as well as numerous other options affecting the dance.

Like many things, this takes much longer to explain that to just do it. 

Be sure to make a save copy of your menus notecard in the CDM so you can always replace it with a copy of the original if you mess it up.

To add or remove a dance animation you must add or remove a menu item or, possibly, a complete menu. Within the CDM server is a notecard titled "menus". All menu dialogs for CDM are defined in this notecard.

When you open the menu notecard you will see a listing similar to the "MENU DEFAULT" below.  Each set/group of lines, such as "MENU DEFAULT" below, represents one menu. The first menu definition MUST be the DEFAULT menu.   This is the first menu displayed when you click on the CDM server.

MENU DEFAULT
TOMENU OPTIONS
OPTION STOP|STOP
OPTION SYNC|SYNC
TOMENU DANCES1
TOMENU DANCES2
TOMENU DANCES3
TOMENU DANCES4
 
"DEFAULT MENU" is identified by CDM as a menu ("MENU" in the first line) with the name "DEFAULT". 

The second line may contain one of several optional values - TOMENU, OPTION or TEXT. 

TOMENU defines a button to be displayed on the dialog which will display another menu when clicked, in this example, the menu that will be displayed is called "OPTIONS" and the button will be labeled "OPTIONS".

OPTION starting a line defines functions or options the CDM can perform for you - some are STOP, SYNC, and DANCE. The first word after OPTION is the label of the button on the menu followed by a vertical line | and then the command that CDM is to perform when that button is clicked.

TEXT starts a line that defines a text message to display on the menu dialog, you can use \n to cause the text to move to the next line on the menu.

The DEFAULT menu defines buttons to STOP dancing, to synchronize your dancing, or to display one of five other menus - OPTIONS, DANCES1, DANCES2, DANCES3 and DANCES4.

The next menu defined is the OPTIONS menu. The word "OPTIONS" must follow the word "MENU" on the first line and MUST be spelled exactly the way it is spelled (including capitalization) in the TOMENU line of the DEFAULT menu.

MENU OPTIONS
TOMENU DEFAULT Back
OPTION Save AV Z|saveAVZ
OPTION SYNC|SYNC
OPTION Adjust On|Adjust On
OPTION Adjust Off|Adjust Off
OPTION Save Pos|Save Pos
 
The second line defines a button labeled "Back" that will display the DEFAULT menu when clicked. Notice that if you only specify the name of the menu that name is the button label, if you provide a second word after the name of the menu ("Back") then the second word is used as the label of the menu.

The remaining lines define additional buttons to tell CDM to do something for you.

The third menu is called DANCES1 and is the first menu which displays dance choices. There is a maximum of 12 buttons that can be defined in a menu. All buttons after the 12th will be ignored.

MENU DANCES1
TEXT  \nUse Page Up and Page Down to move your AV up and down while dancing.\n \nUse Option->Save Z +/1 to save your personal adjustment.
TOMENU DEFAULT Back
OPTION SYNC|SYNC
OPTION Slow 3|DANCE|slow-v3f|slow-v3m
OPTION Slow 4|DANCE|slow-v4f|slow-v4m
OPTION Slow 5|DANCE|slow-v5f|slow-v5m
OPTION Slow 6|DANCE|slow-v6f|slow-v6m
OPTION Slow 7|DANCE|slow-v7f|slow-v7m
OPTION Slow 8|DANCE|slow-v8f|slow-v8m
OPTION Slow 9|DANCE|slow-v9f|slow-v9m
OPTION Beautiful|DANCE|BeautifulDream_f|BeautifulDream_m
OPTION Cherished|DANCE|cherished-f|cherished-m
OPTION 2 Step|DANCE|2Step_f|2Step_m

The second OPTION line in the above menu defines a dance. The following describes the fields:

1. The first field after the word OPTION is the name to be displayed on the button. The length of the name that can be displayed on a button varies on each computer, but should generally not be longer than 8 letters.

2. Each field is separated but a vertical line "|" with no spaces before or after the vertical line.

3. The second field is the word "DANCE" which informs CDM that clicking this button will start a dance animation and is required.

4. The third field is the exact name of the female dance animation located in the CDM. The spelling and capitalization are critical and cause most errors in adding a dance to CDM. The easiest way to get this right is to select Rename on the animation in CDM and the select the entire name and copy it and then paste it into the menus notecard.

5. The fourth field is the exact name of the male dance animation located in the CDM.

To Remove an animation from CDM:

1. Locate the animation file in CDM and delete it.
 
2. Locate the animation name in the menus notecard, and delete that line only.
 
3. Save the change to the notecard and reset the CDM scripts using the Build or Tools menu.

To add a dance animation to CDM

1. Copy the animation files into CDM.  Usually there are separate files for male and female animation, but it is not required. You can use the same dance animation for both.

2. Open the menus notecard and locate the menu you want to add the dance to - ensure that after adding the dance to that menu it will not have more than 12 buttons, If there are no menus available with less that 12 buttons, or you just want to start a new menu for this dance, create a new menu by copying one of the existing menus and changing its name on the MENU line.

3. If you created a new menu on the previous step, then go to the DEFAULT menu and add a line like "TOMENU MYMENU" where MYMENU is changed to whatever your new menu name is next to the MENU in it's first line.

4. Next add or edit an OPTION line in your new menu:
   a. Name of button followed by a vertical line |.
   b. The word DANCE followed by a vertical line |.
   c. The exact name of the female animation to be used when this button is clicked followed by a vertical line |
   d. The exact name of the male animation to be used when the button is clicked.

5. Save and close the menus notecard.

6. You now need to adjust the dancing positions for the dance you just added. Select and reset all scripts in the CDM by using the Build or Tools menu.

7. Click on the CDM server or Remote to display the dance balls. Find a partner to help you adjust the dance. You and the dance partner sit on the dance balls.

8. Click on the name of the menu you added the dance to on the DEFAULT menu displayed, and then click on the button with the name of the new dance you added.

9. You should begin dancing as soon as the animation file is loaded into your viewer. Be patient, this can take a while depending on your connection speed. Once the dance is loaded into your viewers cache it will load much faster the next time.

10. Click back until you are at the DEFAULT menu and select/click on the OPTIONS button.

11. On the OPTIONS menu, click on the "Adjust ON" button. Two vertical bars passing through your avatar will be displayed. Edit one or both of the bars to adjust your and your dance partner's position until you are satisfied.

12. Click on the OPTIONS menu again and click the "Save Adj" button to permanently record the settings for your positions in a notecard in CDM.
}
 