home *** CD-ROM | disk | FTP | other *** search
/ CD Actual Thematic 7: Programming / CDAT7.iso / Share / Java / CoolMap / README.TXT < prev    next >
Encoding:
Text File  |  1996-09-17  |  10.3 KB  |  212 lines
  1. *****************************************************************
  2. *                                                               *
  3. *                           CoolMap(F1.5)                       *
  4. *                                                               *
  5. *                         Written by Mark Qian                  *
  6. *                                                               *
  7. *****************************************************************
  8.  
  9.  
  10.  
  11.  
  12. ***FREE***FREE***FREE***FREE***FREE***FREE***FREE
  13.  
  14. This software is FREE!!
  15. Feel FREE to share with(pass to) your friends 
  16. and clients, upload to your favorite BBS,
  17. On-line systems, FTP sites, or collect it 
  18. into any CD-ROMs!!
  19.  
  20.    
  21.  
  22.  
  23. CoolMap is a Java applet which works as an image map.
  24. It is COOL because it not only works as an image map
  25. but also comes with a built-in design center which 
  26. makes image map design and maintenance visible: CoolMap
  27. can generate a HTML script which calls itself!  A 
  28. sound will also be played when mouse is moved over
  29. a particular hot area.  The corresponding URL will
  30. be opened when clicking at a hot area. 
  31.  
  32. New features are just added: background can be specified to use a transparent map!!
  33.  
  34.  
  35.  
  36. Parameters:
  37.  
  38.  
  39.    mode -           There are two values:
  40.                     design - You can design you image map in this mode.  After clicking at 
  41.                              "Generate HTML Script"button when you finish your design, you 
  42.                              can get the ready-to-plug-in HTML script in "HTML Scropt" field
  43.                              at the bottom of Coolmap Design Center.  Copy and Paste it to 
  44.                              your page.
  45.                     map =    This is the regular mode when the map is pluged in to your page.
  46.                              The mode in HTML script generated by Coolmap Design Center will 
  47.                              be set to "map".
  48.  
  49.   whichBase -       0 the applet uses DocumentBase.  That is, applet will search resouces from
  50.                              the directory where HTML file resides
  51.                     1 applet uses CodeBase.  That is, applet will search resouces from
  52.                              the directory where Java class files resides.
  53.  
  54.   
  55.   mode -           There are two values:
  56.                     design - You can design you image map in this mode.  After clicking at 
  57.                              "Generate HTML Script"button when you finish your design, you 
  58.                              can get the ready-to-plug-in HTML script in "HTML Scropt" field
  59.                              at the bottom of Coolmap Design Center.  Copy and Paste it to 
  60.                              your page.
  61.                     map =    This is the regular mode when the map is pluged in to your page.
  62.                              The mode in HTML script generated by Coolmap Design Center will 
  63.                              be set to "map
  64.  
  65.   
  66.   whichBase -       0 the applet uses DocumentBase.  That is, applet will search resouces from
  67.                              the directory where HTML file resides
  68.                     1 applet uses CodeBase.  That is, applet will search resouces from
  69.                              the directory where Java class files resides.
  70.  
  71.   background   - URL of the Image which is used to paint caption area's background.
  72.                     This URL has to be a local one such as "images/brnpapr.gif".
  73.                     You can not use a URL that point to an address that is not in
  74.                     the server where the applet resides. If parameter background
  75.                     is valid, bgcolor will be ignored.
  76.                     NOTE: Using an image as background will slow down the
  77.                     scrolling speed dramatically.  I may want to adjust the speed
  78.                     to speed up the scrolling text. Or you can ignore parameter
  79.                     background so that the applet use parameter bgcolor in order
  80.                     to increase the srolling speed.
  81.  
  82.                     Why to use an image for background?
  83.  
  84.                     You may usually want to cover the entire applet area with the map.
  85.                     But in some case such as using CoolMap as a toolbar, you may want 
  86.                     have more space to your tooltips while the toolbar image is relatively
  87.                     small.  If you add some blank space to the toolbar image to make 
  88.                     it cover a larger area so that your tooltips can be displayed properly,
  89.                     it will take a large amount of time for the browser to load the large
  90.                     image.  Instead, if you use exactly space requiesd by toolbar but set
  91.                     appletWidth and appletHeight large enough to hold your tooltips.
  92.                     The area that is not covered my toolbar image will be covered with 
  93.                     the background image which is the same as the background on the page.
  94.  
  95.                     Another reason to use background image is that you can make use of
  96.                     transparent gif if you like to have map image transparent. You can
  97.                     use image editor like GIF Construction Set for Windows 
  98.                     (http://www.mindworkshop.com/alchemy/gifcon.html")
  99.                     to create transparent gif used as your map image or toolbar image.
  100.                     You need to set the backgound parameter to the same as the background
  101.                     on the page where Coolmap resides.
  102.  
  103.  
  104.                                          
  105.   bgcolor      - Color of caption background. This feature can be overrided by 
  106.                     parameter background(That is, if background presents, bgcolor
  107.                     will not effect. You need to use the same code format like you use
  108.                     in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
  109.                     Value "vary" will give caption background a random color each time
  110.                     the applet is called.
  111.  
  112.                
  113.   imageWidth -      The width of your image which is used as the map. If the size you specify
  114.                     is different from the actual size of the image, the result will be a stetch
  115.                     one.
  116.   
  117.   imageHeigth -     The heigth of your image which is used as the map.
  118.  
  119.   imageLeft   -     the horizontal position of top-left conner of them map image. In other word,
  120.                     horizontal distance in term number of pixels from the top-left conner of the
  121.                     applet area    to top-left conner of them map image. 
  122.  
  123.   imageTop    -     the vertical position of top-left conner of them map image. In other word,
  124.                     vertical distance in term number of pixels from the top-left conner of the 
  125.                     applet area to top-left conner of them map image. 
  126.  
  127.   appletWidth -     width of applet in design mode.  Important: this pair of parameters will appear
  128.                     as Width and Height in HTML code which calls Coolmap (the Code generated
  129.                     by Coolmap). That is, this is the place where is specify the size of Coolmap.
  130.  
  131.   appletHeigth      height of applet in design mode.
  132.  
  133.  
  134.   deskArrange  - The arrangement of applet and design panel.  It can be "LeftRight" or TopBottom"(default).
  135.                     Note: if the space you specify is not enough for "LeftRight", it will be set to
  136.                     "TopBottom".
  137.  
  138.  
  139.  
  140.   hotStyle          0 - Coolmap will not show the border of a hotware when mouse cursor 
  141.                     is over the hotarea.
  142.                     1 - Coolmap will show a frashing border of a hotware when mouse cursor 
  143.                         is over the hotarea.
  144.   tipsOn            0 - Disable tooltips.
  145.                     1 - Enable tooltips.
  146.  
  147.   imageWidth -      The width of your image which is used as the map.
  148.   
  149.   imageHeigth -     The heigth of your image which is used as the map.
  150.   
  151.   hintWidth -       The width of tool tips window.
  152.  
  153.   fontHeight -      The heigth of tool tips window.
  154.                                         
  155.   mapImage -        File name of the image which is used as the map.
  156.  
  157.   hot_area1 -       The infor about hot area 1 
  158.   hot_area1 -       The infor about hot area 2
  159.   ...
  160.   hot_arean -       The infor about hot area n
  161.  
  162.  
  163.   The sound played by this applet can be turn On/Off dynamically button another
  164.   applet wrtten by Mark Qian, CButton. 
  165.  
  166.  
  167. To place it into your page for FREE, you need to
  168.   
  169.   
  170.   A). Run setup.exe to rename class files.  Because 
  171.       PKUNZIP will extract the  class file, coolmap.class, 
  172.       to coolmap.CLA,  you have to RENAME the class file to 
  173.       coolmap.class.  Similarly, rename the rest
  174.       of *.CLA to *.class.  Then place coolmap.class 
  175.       in the place you want. 
  176.      
  177.       NOTE: ALL THE NAMES OF CLASS HAS TO BE IN LOWER CASE.
  178.             THEY ARE CASE SENSITIVE!!
  179.  
  180.   B). Open TEST_CM.HTM with your browser locally.
  181.       
  182.      
  183.   C). Design your own image map
  184.   
  185.    To use CoolMap's Design Center to generate HTML script which calls CoolMap for you with your hot areas,
  186.    you need to
  187.  
  188.     1).  Set parameter mode in you HTML script that call CoolMap to Design. Then run the script with a browser
  189.          (You have done this).
  190.     2).  Select the Edit mode in Mode section.
  191.     3).  Point your mouse cursor to a point where you like to use as the first point of the hot area. Press left
  192.          mouse button and drag to the second point. Then release mouse button.
  193.     4).  Click at next point.
  194.     5).  Repeat step 4 until you finished all the points which limit the hot area.
  195.     6).  Edit content of tooltips.
  196.     7).  Edit URL address. This URL will be opened when the hot area is clicked.
  197.     8).  Select an audio file for the hot area.  This audio file will be played when mouse cursor moves over the hot area.
  198.     9).  Click at button label 'Click When Done Edit'.
  199.     10). Click at button label 'Generate HTML Script'.
  200.     11). Select the content in the text area at the bottom label 'HTML Script' using mouse
  201.     12). Select Edit and Copy from the pull-down manu of broser to copy the HTML script to clipboard.
  202.     13). Paste the content of clipboard to an empty text file named, say test.htm.  Then browse test.htm with your browser.
  203.          If you see what you want, insert the HTML script to your page.
  204.  
  205.          Done!!  Easy and quickly done!!";  
  206.  
  207.   
  208.     
  209. Go Mark's Home Page(http://www.coolshare.com) to see more exciting applets!
  210.  
  211.  
  212.