themehowto.txt

FreeAMP(MP3播放)程序源代码-用来研究MP3解码

   Pos -- Defines the closed location for the panel.
   ZOrder -- Defines the ZOrder (layer) for this panel.
   TogglePos -- Defines open location for this panel. [optional]
   OnOpenShow -- Defines another panel to show when this panel is 
                 opened. [optional]
   OnOpenHide -- Defines another panel to hide when this panel is 
                 opened. [optional]
   OnCloseShow -- Defines another panel to show when this panel is 
                  closed. [optional]
   OnCloseHide -- Defines another panel to hide when this panel is 
                  closed. [optional]
   
   Subtags:
   
   <Controls> (required)
   

<Controls>
   
   -- specifies which controls to place in the window
   
   Attributes:
   
   None.
   
   Subtags:

   <MultiStateControl>
   <ButtonControl>
   <TextControl>
   <SliderControl>
   <VSliderControl>

   
<ButtonControl>

   -- specifies a name button control
   
   Attributes:
   
   Name -- the name of the control. See Appendix A for a list of
           possible control names.
   URL -- For the 'Logo' button only. This specifies the web page to
          go to if the user clicks on the button. Defaults to 
          http://www.freeamp.org if not specified.        

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

<TextControl>

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

   Subtags:

   <Position> (required)
   <Style> (required) 

<SliderControl>

   -- specifies a slider control
   
   Attributes:
   
   Name -- the name of the control. See Appendix A for a list of
           possible control names.
   Notch -- define a location on the slider bar where the slider thumb
            will snap to. This is specified in percent. (e.g. 50% will
            place a notch in the middle of the slider) [optional]
   NotchWidth -- Used with a Notch, it defines the width of the notch
                 snap zone. [optional]

   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]


<Headlines>

   -- specified a what to display in the HeadlineInfo text field.
   
   URL -- The HTTP location where the XML headline document can be found.
   XMLPath -- The XML location where headlines can be found.
   XMLURLPath -- The XML location where headline URLs can be found.	[optional]
   DownloadInterval -- How frequently to download new headlines (seconds)
   ChangeInterval -- How frequently to show a new headline (seconds)

      

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.


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.
Mute          -- Mute volume control. State 0 is shown during normal playback
                 and state 1 is shown when the player is muted.
SigIndicator  -- The signatures pending indicator. State 0 is shown when
                 no signatures are pending, state 1 when signatures are
                 pending and state 2 when the player is signaturing tracks.
EqEnable      -- Enabled/disable the equalizer. State 0 is shown when the
                 equalizer is enabled and state 1 is shown when the equalizer
                 is disabled.

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 (use '@' key to test the size of the field)
TimeRemaining -- The time display used when in TimeRemaining mode 
        
SliderControls,VSliderControls:        
        
Volume        -- adjusts the volume
Seek          -- seek in a track
Balance       -- adjusts the balance between the left and right speaker
Preamp        -- adjusts the preamp
Eq0 - Eq9     -- sliders that adjust the equalizers settings. Eq0 through
                 Eq9 map to 60Hz, 170Hz, 310Hz, 600hz, 1Khz, 3Khz, 6Khz,
                 12Khz, 14Khz, 16Khz, repectively.
   
APPENDIX B

This is the current FreeAmp theme.xml file:

<Bitmap Name="Background" File="background.bmp" TransColor="#FF0000"/>
<Bitmap Name="Buttons" File="buttons.bmp" TransColor="#FF0000"/>
<Bitmap Name="MiniButtons" File="minibuttons.bmp" TransColor="#FF0000"/>
<Bitmap Name="MiniBackground" File="minibackground.bmp" TransColor="#FF0000"/>
<Bitmap Name="MediumBackground" File="mediumbackground.bmp" TransColor="#FF0000"/> 
<Bitmap Name="Equalizer" File="equalizer.bmp" TransColor="#FF0000"/> 

<Font Name="Main" File="arial.ttf" Face="Arial"/>

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

<Window Name="MainWindow">
    <Panel Name="PlayerBottom" Bitmap="Background" 
           Rect="0, 95, 327, 161" Pos="0,95" TogglePos="0,170" ZOrder="2"
           OnCloseHide="Equalizer" OnOpenShow="Equalizer">
        <Controls>
            <ButtonControl Name="Logo" URL="http://www.freeamp.org">
            	<Info Desc="Go to the FreeAmp web site" Tip="FreeAmp"/>
                <Position Pos="23,33"/>
                <ControlBitmap Rect="0,236,267,255" Name="Buttons"/>
            </ButtonControl>
            <MultiStateControl Name="PlayStop" NumStates="2">
            	<Info Desc="Play the current track||Stop the current track" Tip="Play||Stop"/>
                <Position Pos="228,29"/>
                <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,29"/>
                <ControlBitmap Rect="0,282,119,345" Name="Buttons"/>
            </ButtonControl>
            <ButtonControl Name="Prev">
            	<Info Desc="Move to previous track" Tip="Previous"/>
                <Position Pos="198,29"/>
                <ControlBitmap Rect="0,0,119,31" Name="Buttons"/>
            </ButtonControl>
            <ButtonControl Name="Next">
            	<Info Desc="Move to next track" Tip="Next"/>
                <Position Pos="287,29"/>
                <ControlBitmap Rect="0,32,119,63" Name="Buttons"/>
            </ButtonControl>	
            <ButtonControl Name="MyMusic">
            	<Info Desc="Browse my music collection" Tip="MyMusic"/>
                <Position Pos="44,7"/>
                <ControlBitmap Rect="0,172,291,186" Name="Buttons"/>
            </ButtonControl>
            <ButtonControl Name="Options">
            	<Info Desc="Open the options window" Tip="Options"/>
                <Position Pos="119,7"/>
                <ControlBitmap Rect="0,188,263,202" Name="Buttons"/>
            </ButtonControl>
            <ButtonControl Name="Download">
             	 <Info Desc="Open the download manager" Tip="Download"/>