*****************************************************************
*                                                               *
*                           CBUTTON (F1.6)                      *
*                                                               *
*                         Written by Mark Qian                  *
*                                                               *
*                             - Adware -                        *
*****************************************************************

   


CBUTTON, Command Button, is a JAVA applet written 
by Mark Qian. It works as a command button with pictures 
and scrolling and muilt-line caption.  It also provides sound
when mouse over or click.  Its on_click parameter allows you 
open a given URL address when clicking.  In additional, it allows you display a
message in the status bar when mouse cursor move over the applet. Details
about how to install it in your page is available in below.

NOTE:      Both Adware (FREE) and shareware (NOT FREE) versions are 
           available. The parameters marked with (share) are only 
           available in shareware version. 
           
           
Good News!!

           
           You can now use Adware version of CButton with full-feature during the period other than business hours.
           That is, all the functions in the Adware are available at a period from 7:00PM - 7:00AM.  You can use your own
           parameters during that period.  But during the period 7:00AM - 7:00PM, the caption and URL will be
           replaced by author's infor and URL.  If you like to use it as an Adware with limited parameters
           instead of evaluate it's full-feature, you need to set parameter whatWare = Adware. 
           (The default of whatWare is evaluteShareware). If you like to have all these features available full-time,
           you need to download the shareware version and register it to get the Registration Code to unzip the
           shareware package.
           
  
                        


  !!!!!!!!!!!!!!!!  Be sure you try it with your own stuff during 7:00AM - 7:00PM   !!!!!!!!!!!!!!!!!!!
                       
	       Note: You can also set the clock in your local machine to 
		   a time between 7:00PM - 7:00AP so that you can test it any time.

                    
           
IMPORTANT:
*********  You have to make sure the Adware version (FREE) 
           works fine in your server before you register the 
           shareware version because you are buying a Code.
           That is, after you register the shareware (pay fee)
           only thing you will recieve is a Code which can be
           used to unzip the shareware package.  The Code is
           NOT refundable, NOT returnable, and NOT exchangable.
           Don't register the shareware if you are NOT sure
               - It REALLY WORK in your server
               - You REALLY like to use the shareware.
               

Parameters:

         target   - target window where the target URL will be opened.
                    You can set it to a sub frame if you use frames so
                    that the URL is opened in the sub frame.  You can 
                    also set it to one of following

                      _top 
                       Bowser will place URL page into top-level window of the browser

                      _parent 
                       Bowser will place URL page into parent window of the widnow
                       where HTML resides

                      _self 
                       Bowser will place URL page into the widnow where HTML resides

                      _blank 
                       Bowser will place URL page into a new window


          captionMode  - The way caption is displayed: 
                        0 - display a static (still) multi-line caption.  Of course, you
                            can display only a single line caption by provide only one
                            caption text and set parameter, numcaption to 1. 
                            Note: Multi-line is only available in shareware version (share).
                        1 - display a scrolling (moving) single-line caption horizontally.  Caption1, 
                            caption2, ..., captionN will be scrolled in the order of their
                            numbers. (share)      
                        2 - display a scrolling (moving) single-line caption vertically.  Caption1, 
                            caption2, ..., captionN will be scrolled in the order of their
                            numbers. (share)     
                        3 - display Caption1 originally and display caption2 after a click. Switch between
                            Caption1 and Caption2 when clicking.

         whichBase   - 0 the applet uses DocumentBase.  That is, applet will search resouces from
                       the directory where HTML file resides
                       1 applet uses CodeBase.  That is, applet will search resouces from
                       the directory where Java class files resides.


          speed       - the speed (in milli-second) of animation. Range of speed can be 0 - n,
		               where n can be a large number such as 5000. Note: 0 - 10 is a
					   special range Where scrolling speed will change dramatically.

          soundmode    - The way sound is played.
                        0 - Sound is played when mouse cusor over Animator
                        1 - Sound is played when clicking.
          audiofile    - The audio file that should reside in
                        the directory where the applet resides.
          upImage      - The image displayed when cbutton is not pressed.
          downImage    - The image displayed when cbutton is pressed.
          numCaption   - Number of caption text.   
          
          fixCaption   - Display a static caption at the first row.
          fixCaptionColor - Determinate the color of the static caption.   
          fixCaptionHeight - Height of static caption area.
          fixCaptionBlink - Make the static caption blick.
          
          caption1     - Caption text 1
          caption2     - Caption text 2  (share)
          ...
          captionN     - Caption text N  (share)
       
          borderWidth  - The bevelwidth of left and right edges(in pixel).Set to 0 if you don't
                         like to have a border. 
          borderHeight - The bevelwidth of top and bottom edges(in pixel)
          fontHeight   - The size of caption font(1-100).
          
          fgcolor      - Color of caption. You need to use the same code format like you use
                         in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
                         Value "vary" will give caption a random color periodically.
           
          background   - URL of the Image which is used to paint caption area's background.
                         This URL has to be a local one such as "images/brnpapr.gif".
                         You can not use a URL that point to an address that is not in
                         the server where the applet resides. If parameter background
                         is valid, bgcolor will be ignored.
                                         
          bgcolor      - Color of caption background. This feature can be overrided by 
                         parameter background(That is, if background presents, bgcolor
                         will not effect. You need to use the same code format like you use
                         in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
                         Value "vary" will give caption background a random color each time
                         the applet is called.
                         
          fixCaptionColor  - Color of static caption. You need to use the same code format like you use
                         in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
                         Value "vary" will give static caption a random color periodically.                                        
         
          status_text - status text which will be displayed in the status.
                        Just set it to "" to disable it. (share)
          action      - determinate what to do when click
                        "URL" - open the URL specified by "on_click"
                        "SoundSwitch" - Turn Sound On or Off.(Note: This can only control those
                                        sounds played by Mark's applets.
          on_click    - an URL address whose content will be opened by browser
                        when clicking at the applet.  Just set it to "" to disable it.  

INSTALLATION:
============           
          
If you are a webmaster or experienced person, just follow the brief
instructions below. 

IMPORTANT:
=========
   
   *********************************************************************************
   *                                                                               *
   *   If you are NOT familiar with Java applet installation an Unix environment,  *
   *   Please follow the detail instructions in                                    *
   *                                                                               *
   *   http://www.coolshare.com/html/APP_CB.HTM                                    *
   *                                                                               *
   *   to install it.  Don't try it youself.                                       *
   *                                                                               *
   *********************************************************************************



BRIEF INSTRUCTIONS (for experienced people only):
==================
  
  0). Unzip CBUTTON.ZIP in your local machine (you had done this step).
  
  
  1). Run SETUP.BAT to rename class files. Because PKUNZIP will extract the
      class file, cbutton.class, to CBUTTON.CLA,  if you like to name them 
      yourself instead of using SETUP.BAT, you have to RENAME 
      the class file to cbutton.class and rename COMMON.CLA to common.class.  
      Note: class names has to be in lower cases.     
  
  2). Open TEST_CB.HTM with your browser locally. If it works locally,
      go to next step.  Otherwise, go to Mark's home page for detail
      instructions.
      
  3). Try TEST_CB.HTM online(Ignore this step if you think that you 
      REALLY know what to do). 
  
         - place cbutton.class and common.class in the place you want in your server.
           (FTP program may change cbutton.class to talk.cla. Rename class file
            if needed).
         - place TEST_CB.HTM, AZ_SN*.GIF, and LAUGH.AU to the same directory
         - change access attributes of all the files above to readable(744)
         - Browse TEST_CB.HTM from your local machine
         
      If it works, go to next step.  Otherwise Go to Mark's page for instructions.
         
   
   4).Use your own stuff
         
     - add following HTML statements into your HTML's body  
 
     
       <applet code="cbutton.class" width=155 height=85>
       <param name=captionMode value="0">
       <param name=speed value="5">
       <param name=soundmode value="2">
       <param name=audiofile value="WOLF.AU">
       <param name=upImage value="IN_RV_1.GIF">
       <param name=downImage value="IN_RV_2.GIF">
       <param name=borderWidth value="3"> 
       <param name=borderHeight value="3"> 
       <param name=fontHeight value="15"> 
       <param name=numCaption value="1"> 
       <param name=caption1 value="Cool Screen Savers!!"> 
       <param name=caption2 value="Mark Qian's">
       <param name=caption3 value="pageto get">
       <param name=caption4 value="more fun!">
       <param name=textAreaHeight value="20"> 
       <param name=colorR value="255"> 
       <param name=colorG value="0"> 
       <param name=colorB value="0"> 
       <param name=on_click value="http://www.coolshare.com/html/SCREENSA.HTM">     
       <param name=status_text value="My message is here.">     
       </applet>
         
  
      - replace parametes such as "primarysound" and "sndsound" with your stuff.
  
  
  5). If it works, enjoy it!! (If you like to do its hard-working author a favor, Drop him an 
      EMail to let Mark know It runs OK).  Otherwise, go to Mark's page for detail instructions
      of troubleshooting.


    
Go Mark's Home Page(http://www.coolshare.com") to see more exciting applets!

 