|
Muzo Parameters
Click an item in the list to the left to find out more about it.
Width & Height
The width and height of the applet are set in the HTML code you add to the web page. Be sure to change the dimensions in the <object> and the <embed> tags.
Muzo's width can be almost anything you want. In general it should be at least 140 pixels wide to allow space for the various buttons, sliders and information. You should ensure that it is wide enough to display the longest song title in your play list. Note that if you change the Language items, the timer panel at the bottom right will be expanded to display the longest text, possibly making the progress area to its left too small to be useful. If so, the applet's width should be increased.
Muzo's height is fixed, and depends on the size and type of fonts you use. Making the applet taller does not change the height of the console, it just means more blank space below it. To find the correct height (after selecting your fonts), set the Testmode parameter to 'yes' and click anywhere inside the applet: the height will be shown in a tooltip message. You can then edit the HTML code and set Testmode back to 'no'.
Parameters
The parameters below should be added to your datafile in the form NAME=VALUE (for instance, BgColor=FF0000). Each parameter should be on a separate line. You can leave blank lines in the list to organize the parameters into groups if you want to. The parameter names are not case-sensitive, and neither are the values, so BgColor=FF0000 is the same as bgcolor=ff0000. You can add the parameters to your file in any order. Most parameters have a default value which we show in bold text below: if you don't include the parameter in your datafile, the default value will be used automatically.
AutoStart
A choice of yes or no according to whether Muzo should automatically play the selected track as soon as it starts. The default is yes. If set to 'no', the user must press the Play button (or choose a different track from the playlist using the cue buttons and then press Play).
BgColor
Sets the background color of the applet. This color will be visible only if you set the height (in your HTML code) to greater than the applet needs to display the console. The default is 000000.
BufferingColor
Sets the color of the title and timer text when Muzo is buffering audio before starting playback. The default is 808080 (gray).
CueIconColor
If ShowCueButtons is set to 'yes', this sets the color of the optional cue buttons in the upper-right corner when unfocused. The default is 909090 (gray).
CueIconFocusColor
If ShowCueButtons is set to 'yes', this sets the color of a cue icon when the mouse moves over it. The default is F0F0FF (white).
Delimiter
Muzo will convert file names to displayable titles if you separate each word in the filename with a particular character. Use this parameter to specify the character you use to separate words, and Muzo will replace it with a space for display. The default is an underscore (_). As an example, if the playlist contains "audio/The_Laughing_Gnome.mp3", Muzo will display the title as "The Laughing Gnome".
IconColor
Sets the color of the Play, Pause and Stop buttons when unfocused, and the Mute button when the sound is muted. The default is 909090 (gray).
IconFocusColor
Sets the color of the Play, Pause or Stop button when the mouse moves over it. The default is F0F0FF (white).
IconActiveColor
Sets the color of the Play, Pause or Stop button when the button's mode is selected. The default is 0080FF (blue).
Loop
A choice of yes or no to whether Muzo should automatically loop from track to track, playing the next track in the playlist when the current track finishes. The default is yes.
MuteIconColor
Sets the color of the Mute icon when the sound is not muted (its normal setting). The default is 0080FF (blue).
PanelStartColor
Sets the upper color used to create the gradient-filled panels of the console. The default is 808080 (gray). If no gradient is wanted, set this and the PanelEndColor to the same color.
PanelEndColor
Sets the lower color used to create the gradient-filled panels of the console. The default is 333333 (dark gray). If no gradient is wanted, set this and the PanelStartColor to the same color.
ProgressBgColor
Sets the main background color of the progress bar at the bottom-left of the console. This is gradually covered by ProgressBufferColor as the audio loads. The default is 606060 (dark gray).
ProgressBufferColor
Sets the color of the expanding progress bar which indicates what percentage of the audio has been buffered. This expands to fill the progress bar area. The default is 000000 (black).
ProgressPlayStartColor
Sets the upper color used to create the narrow gradient-filled play-position progress bar. The default is 0080FF (blue). If no gradient is wanted, set this to match the ProgressPlayEndColor.
ProgressPlayEndColor
Sets the lower color used to create the gradient-filled play-position progress bar. The default is 003070 (dark blue). If no gradient is wanted, set this to match the ProgressPlayStartColor.
RandomOrder
A yes or no value. If Yes, the tracks in the playlist will be played in random order, and the SelectedTrack parameter is ignored. (This is best used with the Loop parameter set to Yes.) The default value is No.
SelectedTrack
The index of the playlist track that should play (or be ready to play, if AutoStart is set to 'no') when the applet starts. The default is 1, which cues up the first track in your playlist when the applet starts. If no song should be selected at startup, set this parameter to 0.
ShowCueButtons
A choice of yes and no to specify whether to display the cue buttons in the top-right of the console, which let the user view and cue up tracks from the playlist. The user can use these buttons to scroll through available titles, click a title to view its information, and click the Play button to play it. The default is yes. Note that Cue buttons are only shown when the playlist contains 2 or more files. However, if you add tracks to the playlist dynamically in your web page, the Cue buttons will appear when the playlist has grown to 2 items, provided this parameter is set to 'yes'.
ShowVersion
A yes or no value. This parameter is included in all Cool Focus Flash applets, and its default is no. If set to 'yes', the version number of the applet (and other details) will be shown when the applet starts. This is included only for troubleshooting purposes, to help you determine which version of an applet you're using. It should be set to 'no' (or removed from your datafile) before you publish your page.
Testmode
A yes or no value, with a default of 'no'. This parameter is included in most Cool Focus Flash applets, and in Muzo it's used to help you determine the best height for the applet. (Because of this, it's best to use this parameter when you've got everything in the applet the way you want it.) Set this parameter to 'yes', then view the applet in your browser and click anywhere inside the applet. You'll see the best height displayed in a tooltip message, and you can copy this value into the page's HTML code. When you're done, remember to set the Testmode parameter back to 'no' or delete it from your datafile. Note: If you've specified a list of font names in the applet's font parameters, it's a good idea to check that the applet will be big enough whichever of those fonts is used: with Testmode set to 'yes', move each font name to the beginning of the list and refresh the page to see if Testmode reports that larger dimensions are needed.
TimerFillColor
Sets the fill color of the numerical timer-text area at the bottom-right of the console. The default is 000000 (black).
TimerFont
Sets the name, size and style of font to use for the numeric timer text at the bottom-right of the console, with each part separated by commas. The default is Sans,8,plain.
- Name: You can include any number of font names, separated by pipe symbols (|), and the applet will use the first font available on the user's system. To ensure compatibility, finish with one of these generic names: Sans, Serif or Typewriter.
- Size: The size of the font in points.
- Style: The style can be plain, bold, italic or bold-italic.
An example font parameter would be: Comic Sans MS|Verdana|Arial|Sans,9,bold.
TimerTextColor
Sets the color of the timer text, indicating the minutes:seconds position in the current track. The default is 0080FF (blue).
TitleFillColor
Sets the fill color of the top area where track titles and information are displayed. The default is 000000 (black).
TitleFont
Sets the name, size and style of font to use for the track titles and information at the top of the console. The default is Sans,8,plain. This parameter is constructed in the same way as TimerFont.
TitleTextColor
Sets the text color of the currently-playing song title. The default is 0080FF (blue).
TitleTextCuedColor
Sets the color of a cued-up (but not yet playing) song title selected by clicking the cue buttons. The default is 909090 (gray).
TitleTextInfoColor
Sets the text color of the scrolling information shown for a track when the user clicks the track title. The default is F0F0FF (white).
Volume
Sets the initial volume of the player, from 0 (silent) to 100 (the user's current system volume). The default is 100.
VolumeSliderFillColor
Sets the fill color of the horizontal runner for the volume slider. The default is 000000 (black).
Language
The 8 parameters below specify the text displayed in Muzo when the mouse hovers over different icons and buttons. You can usually leave these out of your datafile (as long as you're happy with the built-in English default text). However, these parameters let you specify text in a different language if required, or simply change any text item you don't like.
TxtPlay
The text displayed when the mouse moves over the Play button. The default is Play.
TxtPause
The text displayed when the track is playing and the mouse moves over the Pause button. The default is Pause.
TxtResume
The text displayed when the track is paused and the mouse moves over the Pause button. The default is Resume.
TxtStop
The text displayed when the mouse moves over the Stop button. The default is Stop.
TxtMute
The text displayed when the mouse moves over the Mute icon. The default is Mute.
TxtCue
The text displayed when the mouse moves over one of the Cue buttons. The default is Cue.
TxtInfo
The text displayed when the mouse moves over a track title which has associated information that can be displayed. The default is Info.
TxtNoSelection
The text displayed in the title area at the top of the applet when the applet starts and SelectedTrack is set to 0. The default is [No selection].
MP3 Tracks
The two parameters below are used to specify the URLs of the MP3 tracks in the playlist, and optional information to accompany each track. Unless you want to operate Muzo entirely by JavaScript, you should add at least one Track parameter to your datafile. The parameters must be numbered consecutively from 1. If a number is missing, Muzo stops looking for more and will only find the track parameters up to the missing number. You can include as many numbered Track parameters as you like.
Note that the playlist will contain the tracks in the numerical order of their parameter numbers.
Track1, Track2, ..., Trackn
Specifies the absolute or relative URL of an MP3 audio file to add to the playlist. For best display, separate the words in the filename with a particular character (such as _ or -) and specify that character in the Delimiter parameter.
Info1, Info2, ..., Infon
These optional parameters let you provide text information for the Track with the same number. When the user clicks the track title, the text will be displayed. The text can be as long as you like, and Muzo will scroll it if it's wider than the available display area.
|