home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / i / imagemap / !ImageMap / !Help < prev    next >
Text File  |  1997-02-10  |  7KB  |  178 lines

  1. This document discribes version 0.66 of ImageMap
  2. ------------------------------------------------
  3.  
  4. Any comments would be much apprehiated.
  5. Also keep an eye out for upgrades, on my website.
  6.  
  7. Introduction
  8. ============
  9. ImageMap is a WWW image map creator. It will currently output NSCA and CERN format server side maps [note that server side maps require a script to be present on the server] and HTML client side maps.
  10.  
  11. The Main window
  12. ===============
  13. ImageMap has been designed to be as easy to use as possible. It is just as easy to draw a shape as it is to resize it, move it or even delete it.
  14.  
  15. A selected region will have all it's points shown by small 'hot spot' rectangles. Dragging these will change the shape of the region. Dragging the region will move the whole region it's self.
  16.  
  17. Tools
  18. =====
  19. To make using ImageMap easy there is a small toolbar attracted to the main window. This shows the position of the mouse on the image map as well as having short cuts to the main functions.
  20.  
  21. From left to right the tools are;
  22.  
  23.   • The Select Tool
  24.       It is with this that you can move and resize a region as well as 
  25.       selecting it for delete.
  26.  
  27.   • Rectangle
  28.       Will draw a rectanglar region that will act as a hot spot for the image 
  29.       map.
  30.  
  31.   • Circle
  32.       Will draw a circular region that will act as a hot spot for the image map.
  33.  
  34.   • Polygon
  35.       Will draw a polygonial region that will act as a hot spot for the image 
  36.       map. Unlike the other two drawing tools the polygon tool can create a 
  37.       shape of n number of sides or shape.
  38.  
  39. Choices window
  40. ==============
  41. The choices window can be accessed via the icon bar menu. A small window will open with options in it they are;
  42.  
  43.   • Handle Jpegs natively
  44.       Can be used for fast machines using the new SpriteExtend modules.
  45.       
  46.   • Use ChangeFSI for Unknown
  47.       Will send any file that ImageMap does not understand to ChangeFSI just
  48.       in case it does.
  49.       
  50.   • Use current mode with ChangeFSI.
  51.       With this selected what ever mode you are in is the mode that ChangeFSI.
  52.       With this unselectd it will use the mode in the writable icon below.
  53.  
  54. Saving map files
  55. ================
  56.  
  57. You can save in three formats, NSCA, CERN and Client side. NSCA and CERN are Server side maps Client side is for client side maps. When you save the map as a client side file you can save the graphic with it as well. No conversion is currently done to the file so if it was loaded a sprite, or though ChangeFSI then it will be saved as image/spr. If it was loaded a a Jpeg and ImageMap is setup to handle Jpegs natively then it will be saved as a Jpeg.
  58.  
  59. Note..
  60.  
  61. Client side maps outputted by ImageMap have been tested with;
  62.  
  63.   • MS Internet Explorer 2.01
  64.   • Netscape Navigator 3.00
  65.   • Doggysoft' Web browser 1.40
  66.   
  67. NSCA Server side maps outputted by ImageMap have been tested with;
  68.  
  69.   • Doggysoft' Web browser (1.36)
  70.   
  71. I have been unable to test CERN output.
  72.  
  73. Server side maps
  74. ================
  75. (This section is written assuming you know how to write HTML.)
  76.  
  77. To use server side maps you need a script that will handle them, for Demon customers it is http://www.<nodename>.demon.co.uk/cgi-bin/imagemap. You also need to save the map in the format specified for use with the script, for Demon again customers this is NSCA format.
  78.  
  79. Then you need to alter you web page. To the line where you have defined your image maps graphic, <img src=" graphics path ">, you need to add a link around it to the uploaded map file that ImageMap created as well as INMAP to the img tag.
  80.  
  81. So that you end up with something like..
  82.  
  83.   <a href="/cgi-bin/imagemap/main.map">
  84.   <img src="/map.gif" ISMAP>
  85.   </a>
  86.   
  87. Assuming that both the image and the map file containg the hotspots are in the root directory of the website.
  88.  
  89. Still to be done
  90. ================
  91. There are still things to be done to ImageMap.
  92. Some of the ideas I've had are;
  93.  
  94. • Loading of Client side maps.
  95. • Draw end option. - (Select double click or Adjust click)
  96. • Configurable image helper.
  97. • Clipboard.
  98. • Multiple selections.
  99. • PCA / OLE
  100. • Better handling of regions.
  101. • Coordinates window. So you can change the points via the keyboard
  102.   accurately.
  103. • Better selecting of polygon areas.
  104.   
  105. Previous versions
  106. =================
  107.  
  108. Changes from version 0.50 to 0.53
  109. ---------------------------------
  110. • Double clicking on a map file will now load ImageMap
  111. • Fixed dragging point problem. Should now be more accurate.
  112. • Fixed bug with dragging rectangles.
  113.   Dragging bottom point to the top would cause it to be unselectable.
  114. • Trimmed down redraw code should be faster.
  115. • Made last drawn region top one.
  116.   
  117. Changes from version 0.53 to 0.55
  118. ---------------------------------
  119. • Fixed Template/Help file clash.
  120. • Added support for different image helpers.
  121.   (Requires manual editing of the !Choices file)
  122. • Fixed palette handling for some sprites.
  123.   
  124. Changes from version 0.55 to 0.56
  125. ---------------------------------
  126. • Made ImageMap a !!CONNECTED!! application.
  127. • Fixed reserved flag bug on Risc OS 3.1 machines.
  128.  
  129. Changes from version 0.56 to 0.61
  130. ---------------------------------
  131. • Better internationality.
  132. • Made tool pane act like the toolbar in Acorn's Draw application.
  133. • Better screen redrawing. Very noticable when you have a lot of regions.
  134.   Still needs some more work though.
  135. • Reports error when you try to quit with modified map loaded.
  136. • Supports desktop save protocol.
  137. • Fixed bug in client side map saving.
  138. • Fixed bug in choices window.
  139. • Altered !Run file to include more options, etc.. 
  140. • Limited support for interactive help.
  141.  
  142. Changes from version 0.61 to 0.66
  143. ---------------------------------
  144. • Multiple bug fixes.
  145. • Saves to !Boot application if possible.
  146.  
  147. Changes from version 0.66 to 0.67
  148. ---------------------------------
  149. • Fixed factory default bug.
  150.  
  151. Changes from version 0.67 to 0.70
  152. ---------------------------------
  153. • Fixed choices bugs!
  154.  
  155. Copyright
  156. =========
  157. This program is FreeWare. This means that ImageMap maybe freely copied and distributed as long as only a small charge is made for costs. (Small means less than 5 pounds. If you want to charge any more per disc ask my permission first).
  158.  
  159. I, the author, keep full copyright over ImageMap and you may not alter it in any way.
  160.  
  161. Disclaimer
  162. ==========
  163. I, the author, do not accept any liability for the loss or damage to your computer or any data stored on it, however caused, arising as a result of the use or misuse of this program.
  164.  
  165. Contacting the author
  166. =====================
  167. You can contact by any of the following methods. If you have any problems or if you have any suggestions for ImageMap then please do contact me as it'll give me some ideas as to what other people would like adding.
  168.  
  169. E-mail     : mailto:davemac@rylands.demon.co.uk
  170.  
  171. WWW        : http://www.atlantic.oaktree.co.uk/
  172.  
  173. Snail mail : David McCormack,
  174.              2 Cornwall Avenue,
  175.              Beeston Rylands,
  176.              Nottingham,
  177.              NG9 1NL
  178.