themehowto.txt

这是一个mp3的源代码

<SliderControl>

   -- specifies a slider control
   
   Attributes:
   
   Name -- the name of the control. See Appendix A for a list of
           possible control names.

   Subtags:

   <Info> (required)
   <Position> (required)
   <ControlBitmap> (required) 

<VSliderControl>

   -- specifies a vertical slider control
   
   Attributes:
   
   Name -- the name of the control. See Appendix A for a list of
           possible control names.

   Subtags:

   <Info> (required)
   <Position> (required)
   <ControlBitmap> (required) 

<Info>

   -- specifies textual information for this control such as the
      description and the tooltip.   

   Attributes:
   
   Desc -- the text displayed in the Info TextControl when the user
           moves the mouse over the control.
   Tip -- The tooltip text to display when the user places the mouse
          over the control. (Not currently implemented) [optional]
          
   Subtags:
   
   None.
   
<Position>

   -- specifies the location of the control on the window
   
   Attributes:
   
   Rect -- the location where the control should appear
   
   Subtags:
   
   None.
   
<ControlBitmap>

   -- specifies the source bitmap and source locations for a control
   
   Attributes:
   
   Rect -- the location where the multi-frame bitmap is located
   Name -- the name of the bitmap to take the bitmaps from
   
   Subtags:
   
   None.
  
<Style>

   -- specifies the font and font style for a TextControl
   
   Attributes:
   
   Font -- The name of the font to be used in this control 
   Align -- The text alignment within the control (Left, Center, Right) [optional]     
   Bold -- Show text in boldface (Yes, No) [optional]
   Italic -- Show text in italics (Yes, No) [optional]
   Underline -- Show text underlined (Yes, No) [optional]
   Color -- Show the text in the given color (#RRGGBB) [optional]

<ThemeInfo>

   -- specifies the credits for this theme
   
   Attributes:
   
   Name -- The name of the theme
   Author -- The name(s) of the theme author(s) [optional]
   EMail -- The email address of the theme author(s) [optional]
   WebPage -- The Web page associated with the author(s)/theme. [optional]
      

Troubleshooting:

Q: When I move the mouse over a button the button moves slightly.
   What's up with that?
   
A: The Rect specified in the ControlBitmap tag is of a different size
   than the Rect specified in the Position tag.

Q: Why does it hurt when I pee?

A: http://www.emusic.com/artists/48/


APPENDIX A


Available Control Names

MultiStateControls:

PlayPause     -- Play/Pause button
PlayStop      -- Play/Stop button
Repeat        -- Repeat None/Repeat One/Repeat All
Shuffle       -- Normal/Shuffle mode
MPause        -- Multistate Pause button. State 0 is shown when the player
                 is not paused, and state 1 is shown when the player is
				 paused to give the user visual feedback that the player is
				 paused.

ButtonControls:

Play          -- The play button that gets disabled during playback
Pause         -- The pause button that gets disabled during non playback
Stop          -- stop playing
Prev          -- go to previous track
Next          -- go to next track
Quit          -- quit the player
MyMusic       -- open musicbrowser
Options       -- open options dialog
Download      -- open the download manager
Logo          -- FreeAmp logo, clicking it will open a web browser to 
                 the FreeAmp site.
Minimize      -- Minimizes FreeAmp
ReloadTheme   -- Reload the current theme
Credits       -- Shows the theme credits in the title field
Help          -- Show the FreeAmp help files.
Files         -- Allows the user to select a file to play.

TextControls:

Title         -- The song title text area
Info          -- The area where button info and status messages get displayed
StreamInfo    -- Shows the bitrate, sample rate and stereo mode for the
                 current mp3.
BufferInfo    -- The input and output buffer states (for streaming only)
Time          -- The time display
TimeRemaining -- The time display used when in TimeRemaining mode 
        
SliderControls,VSliderControls:        
        
Volume        -- adjusts the volume
Seek          -- seek in a track

   
APPENDIX B

This is the current Emusic theme.xml file:

<Bitmap Name="Background" File="background.bmp" TransColor="#FF0000"/>
<Bitmap Name="Buttons" File="buttons.bmp" TransColor="#FF0000"/>
<Font Name="Main" File="verdana.ttf" Face="Verdana"/>

<ThemeInfo Name="EMusic Theme" Author="Bill Bull, Robert Kaye & Mark B. Elrod " 
           EMail="[e-mail]" WebPage="http://www.emusic.com"/>

<Window Name="MainWindow">
    <BackgroundBitmap Name="Background" Rect="0, 0, 327, 161"/>
    <Controls>
        <ButtonControl Name="Logo" URL="http://www.emusic.com">
        	<Info Desc="Go to the EMusic web site" Tip="EMusic"/>
            <Position Pos="17,126"/>
            <ControlBitmap Rect="0,236,327,260" Name="Buttons"/>
        </ButtonControl>
        <MultiStateControl Name="PlayStop" NumStates="2">
        	<Info Desc="Play the current track||Stop the current track" Tip="Play||Stop"/>
            <Position Pos="228,124"/>
            <ControlBitmap Rect="0,96,119,159" Name="Buttons"/>
        </MultiStateControl>
        <MultiStateControl Name="MPause" NumStates="2">
        	<Info Desc="Pause the current track||Continue playing" 
        	            Tip="Pause||Continue"/>
            <Position Pos="258,124"/>
            <ControlBitmap Rect="0,282,119,345" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Prev">
        	<Info Desc="Move to previous track" Tip="Previous"/>
            <Position Pos="198,124"/>
            <ControlBitmap Rect="0,0,119,31" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Next">
        	<Info Desc="Move to next track" Tip="Next"/>
            <Position Pos="287,124"/>
            <ControlBitmap Rect="0,32,119,63" Name="Buttons"/>
        </ButtonControl>	
        <ButtonControl Name="Quit">
        	<Info Desc="Quit EMusic" Tip="Quit"/>
            <Position Rect="303,0,315,15"/>
            <ControlBitmap Rect="212,264,263,272" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Minimize">
        	<Info Desc="Minimize EMusic" Tip="Minimize"/>
            <Position Rect="289,0,301,15"/>
            <ControlBitmap Rect="159,264,210,272" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Help">
        	<Info Desc="View EMusic help" Tip="Help"/>
            <Position Rect="275,0,287,15"/>
            <ControlBitmap Rect="106,264,157,272" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="ReloadTheme">
        	<Info Desc="Reload current theme" Tip="Reload theme"/>
            <Position Rect="12,0,24,15"/>
            <ControlBitmap Rect="53,264,104,272" Name="Buttons"/>
        </ButtonControl>
        <!--ButtonControl Name="WindowShade"!>
        	<!--Info Desc="Change to windowshade" Tip="Windowshade"/!>
            <!--Position Rect="269,4,280,13"/!>
            <!--ControlBitmap Rect="0,264,51,272" Name="Buttons"/!>
            <!--ChangeWindow Window="WindowShade"/!>
        <!--/ButtonControl!>
        <ButtonControl Name="MyMusic">
        	<Info Desc="Browse my music collection" Tip="MyMusic"/>
            <Position Pos="44,102"/>
            <ControlBitmap Rect="0,172,291,186" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Options">
        	<Info Desc="Open the options window" Tip="Options"/>
            <Position Pos="119,102"/>
            <ControlBitmap Rect="0,188,263,202" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Download">
        	<Info Desc="Open the download manager" Tip="Download"/>
            <Position Pos="187,102"/>
            <ControlBitmap Rect="0,204,303,218" Name="Buttons"/>
        </ButtonControl>
        <ButtonControl Name="Files">
        	<Info Desc="Open files/playlists to play" Tip="Files"/>
            <Position Pos="265,102"/>
            <ControlBitmap Rect="0,220,207,234" Name="Buttons"/>
        </ButtonControl>
        <MultiStateControl Name="Repeat" NumStates="3">
        	<Info Desc="Repeat no tracks||Repeat current track||Repeat all tracks" 
                  Tip="Repeat none||Repeat current||Repeat all"/>
            <Position Pos="151,126"/>
            <ControlBitmap Rect="123,11,286,85" Name="Buttons"/>
        </MultiStateControl>
        <MultiStateControl Name="Shuffle" NumStates="2">
        	<Info Desc="Play tracks in normal order||Play tracks in random order" Tip="Normal Play||Random Play"/>
            <Position Pos="109,126"/>
            <ControlBitmap Rect="123,87,286,136" Name="Buttons"/>
        </MultiStateControl>
        <TextControl Name="Title">
            <Position Rect="9,21,317,38"/>
            <Style Align="Left" Font="Main" Bold="Yes"/>
        </TextControl>
        <TextControl Name="Info">
            <Position Rect="9,53,179,67"/>
            <Style Font="Main"/>
        </TextControl>	 
        <TextControl Name="StreamInfo">
            <Position Rect="9,40,210,52"/>
            <Style Font="Main"/>
        </TextControl>
        <TextControl Name="Time">
        	   <Info Desc="Current time/time remaining"/>
            <Position Rect="210,41,317,67"/>
            <Style Font="Main" Align="Right" Bold="Yes"/>
        </TextControl>
        <TextControl Name="TimeRemaining">
        	   <Info Desc="Time remaining/Current Time"/>
            <Position Rect="210,41,317,67"/>
            <Style Font="Main" Align="Right" Bold="Yes" Color="#666666"/>
        </TextControl>
        <SliderControl Name="Volume">  
        	   <Info Desc="Change volume" Tip="Volume"/>
            <Position Rect="37,80,117,88"/>
            <ControlBitmap Rect="136,0,183,8" Name="Buttons"/>
        </SliderControl>
        <SliderControl Name="Seek">
        	<Info Desc="Seek in the current track" Tip="Seek"/>
            <Position Rect="151,80,308,88"/>
            <ControlBitmap Rect="136,0,183,8" Name="Buttons"/>
        </SliderControl>
    </Controls>
</Window>