This notecard-composable music box now includes 10 songs! Available at O&E (Odds and Ends) in Tableau.
VERSION 2.0 CHANGES
- Allowed a clickable reset to stop the music once it's playing
- Added some note preloading functionality upon rezzing
- 5 new songs: YT-Spring, YT-LaDispute (thanks to Thaumata Strangelove), JB-Jesu, JMD, FT-Lagrima, RH-Edelweiss
INTRODUCTION
Thank you for your interest in this music box, created by Candle Hazlitt. The following explains the operation and customization of this box.
TOUCH MENU
By clicking the box (owner only) you will be shown a menu that can perform all the text commands with simpler buttons. Note that the songs you can load on the touch menu are limited to 12 and that songs with "2", "3", or "4" at the end (multi-part additions to songs) will not be in the buttons. It is advised that if your song is not a multi-part song that you do not put a number at the end.
Ex.: Do: Gymnopedies Three
Don't: Gymnopedies 3
COMMANDS
Only accepts commands from the owner.
1) Load insert notecard name here
If notecard found in music box's inventory, begins loading process.
The time taken depends on two factors:
- notecard length
- simulator lag
2) Play
If a notecard has been loaded, this starts the music playing.
3) Reset
The scripts are reset.
Any loading or playing process is stopped.
The currently loaded song is cleared from script memory.
In the case of a math error, you will need to go into contents
and manually reset the scripts.
4) Notecards
Tells you what notecards are in the object.
CUSTOM MUSIC
Music is stored via notecard. This section walks through how to create a custom song.
1) Create a notecard in your inventory. Title it the name of the song. Notecard names must not be longer than 19 characters or an error message "llDialog:Button Labels can not have more than 24 characters." will result.
2) Begin editing the notecard. The first line will look something like this: 16|Title. The first number is the tempo. 16 means that the notes will be sixteenth notes. 8 would mean eighth notes, and so on. Acceptable values are: 1, 2, 4, 8, 16. This value should reflect the length of the shortest note in your song. The | is a seperator. It is required. There should be no space on either side of the |. The value after the | is the name of the notecard to play after this one finishes. This is case-sensitive. If there is no notecard to play after this one, write End (note capital E). Up to four notecards can be stringed together in this music box. This is handy for long songs, or when you want to loop a one card song four times, or a two card song twice. You can string the notecard to itself.
3) The lines after this initialization line contain the "meat" of the song. There can be up to 12 lines after initialization and each of them can contain up to 255 characters. Please note that if you try to feed the music box a card with 12 lines of 255 characters each, the script memory will overload and you will have to manually reset the scripts. Try to keep the lines within the bounds of a normal notecard width or just slightly over. If you do this you should be able to feed the box a 12 line card without overload.
4) These lines are strings of 3 character combinations signifying notes and rests. There are no spaces between them. If you input an invalid 3 character combination (AKA a snip) you will get an error telling you your invalid input upon loading. The list of valid input is as follows:
"Cn3", "C#3", "Dn3", "Eb3", "En3", "Fn3", "F#3", "Gn3", "G#3", "An3", "Bb3", "Bn3", "Cn4", "C#4", "Dn4", "Eb4", "En4", "Fn4", "F#4", "Gn4", "G#4", "An4", "Bb4", "Bn4", "Cn5", "C#5", "Dn5", "Eb5", "En5", "Fn5", "F#5", "Gn5", "G#5", "An5", "Bb5", "Bn5", "Cn6", "C#6", "Dn6", "Eb6", "En6", "Fn6", "F#6", "Gn6", "G#6", "An6", "Bb6", "Bn6", "Cn7", "RSx"
5) Several things are worth mentioning. First off, RSx is a rest. Under a 16 tempo, it is a sixteenth rest. Also, for example, if you wanted a D#5, you would have to enter it as an Eb5. D#5 would give you an invalid snip. As you can see the notes stretch four octaves from Cn3 at the bottom to Cn7 at the top. The n means natural: it is not sharp or flat. The way notes are numbered, they cross over to the next number octave at the C. A line might look like:
Gn3Bn3RSxGn3Cn4RSxGn3Bn3RSxGn3Cn4RSxRSxGn3Bn3
6) Notecards may be between 2 and 13 lines in length. Keep lines reasonably sized to avoid overload. Four notecards may be linked to automatically play in a series. Two notes can be played at a time. The lines are arranged in pairs. For example:
Cn3
Cn4
These two notes would be played at the same time.
Cn3RSxCn3RSx
RSxCn3RSxCn3
would be the same as
Cn3Cn3Cn3Cn3
RSxRSxRSxRSx
as you can see, this is a two-track music box.
CLOSING
Special thanks to Nylon, Polyester, Lita, Yukino, Toast, Otis, Rachel, and Thaumata, for texture help, suggestions, song transcription, and beta testing. Whether you compose or just listen, I hope you enjoy your music box as much as I enjoyed scripting it. If you have questions/comments/problems, send an IM to Candle Hazlitt. This concludes the music box manual.