home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / airport / utils / imagemap / !ImageMap / !Help < prev    next >
Text File  |  1997-08-01  |  9KB  |  273 lines
  1. This document discribes version 1.25a 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
  10. format server side maps [note that server side maps require a script to be
  11. present on the server] and HTML client side maps.
  12.  
  13. The Main window
  14. ===============
  15. ImageMap has been designed to be as easy to use as possible. It is just as
  16. easy to draw a shape as it is to resize it, move it or even delete it.
  17.  
  18. A selected region will have all it's points shown by small 'hot spot'
  19. rectangles. Dragging these will change the shape of the region. Dragging the
  20. region will move the whole region it's self.
  21.  
  22. Tools
  23. =====
  24. To make using ImageMap easy there is a small toolbar attracted to the main
  25. window. This shows the position of the mouse on the image map as well as
  26. having short cuts to the main functions.
  27.  
  28. From left to right the tools are;
  29.  
  30.   o Coordinates box
  31.  
  32.     This displays the mouse pointer's current location in the loaded
  33.     imagemap. This is taken from the top left hand corner of the window.
  34.  
  35.   o Select
  36.  
  37.     It is with this that you can move and resize a region as well as
  38.     selecting it for delete.
  39.  
  40.   o Rectangle
  41.  
  42.     Will draw a rectanglar region that will act as a hot spot for the
  43.     image map.
  44.  
  45.   o Circle
  46.  
  47.     Will draw a circular region that will act as a hot spot for the image map.
  48.  
  49.   o Polygon
  50.  
  51.     Will draw a polygonial region that will act as a hot spot for the image
  52.     map. Unlike the other two drawing tools the polygon tool can create a
  53.     shape of n > 2 number of sides.
  54.  
  55.   o Zoom
  56.  
  57.     This tool opens the zoom window so that you can change the zoom factor
  58.     of the window.
  59.  
  60.   o PCA Menu
  61.  
  62.     This tool opens a menu of all the PCA server applications that are
  63.     currently loaded.
  64.  
  65. Editing regions
  66. ===============
  67. Once a region has been drawn it is possible to edit it, only if it is a
  68. polygon. By holding down shift you can copy a region exactly very easily
  69. by dragging it from the center of the shape. If you drag a 'handle' with
  70. shift held down you will create a brand new 'handle'. To delete a
  71. 'handle' you simply have to copy it over another 'handle'.
  72.  
  73. By double-clicking on a region you can alter the URL that the region
  74. points to, but if you double-click on a 'handle' then you can alter its
  75. coordinates directly.
  76.  
  77. Choices window
  78. ==============
  79. The choices window can be accessed via the icon bar menu. A small window
  80. will open with options in it they are;
  81.  
  82.   o Handle Jpegs natively
  83.  
  84.     Can be used for fast machines using the new SpriteExtend modules.
  85.  
  86.   o Use ChangeFSI for Unknown
  87.  
  88.     Will send any file that ImageMap does not understand to ChangeFSI just
  89.     in case it does.
  90.  
  91.   o Use current mode with ChangeFSI.
  92.  
  93.     With this selected what ever mode you are in is the mode that ChangeFSI.
  94.     With this unselectd it will use the mode in the writable icon below.
  95.  
  96. Saving map files
  97. ================
  98.  
  99. You can save in three formats, NSCA, CERN and Client side. NSCA and CERN are
  100. Server side maps Client side is for client side maps. When you save the map
  101. as a client side file you can save the graphic with it as well. No
  102. conversion is currently done to the file so if it was loaded a sprite, or
  103. though ChangeFSI then it will be saved as image/spr. If it was loaded a a
  104. Jpeg and ImageMap is setup to handle Jpegs natively then it will be saved as
  105. a Jpeg.
  106.  
  107. Note..
  108.  
  109. Client side maps outputted by ImageMap have been tested with;
  110.  
  111.   o MS Internet Explorer 2.01
  112.   o Netscape Navigator 3.00
  113.   o Doggysoft' Web browser 1.40
  114.  
  115. NSCA Server side maps outputted by ImageMap have been tested with;
  116.  
  117.   o Doggysoft' Web browser (1.36)
  118.  
  119. I have been unable to test CERN output.
  120.  
  121. Server side maps
  122. ================
  123. [ This section is written assuming you know how to write HTML ] 
  124.  
  125. To use server side maps you need a script that will handle them, for Demon
  126. customers it is http://www.<nodename>.demon.co.uk/cgi-bin/imagemap. You also
  127. need to save the map in the format specified for use with the script, for
  128. Demon customers this is NSCA format.
  129.  
  130. Then you need to alter you web page. To the line where you have defined your
  131. the graphic for the imagemap, <img src=" graphics path ">, you need to add
  132. a link around it to the uploaded map file that ImageMap created as well
  133. as INMAP to the img tag.
  134.  
  135. So that you end up with something like the following.....
  136. [ This is for Demon customers ]
  137.  
  138.   <a href="http://www.<nodename>.demon.co.uk/cgi-bin/imagemap/main.map">
  139.   <img src="/map.gif" ISMAP>
  140.   </a>
  141.  
  142. Assuming that both the image and the map file containg the hotspots are
  143. in the root directory of the website. If not then you will need to add
  144. the file path in place of main.map for the link, and likewise for the
  145. graphic.
  146.  
  147. Still to be done
  148. ================
  149. There are still things to be done to ImageMap.
  150. Some of the ideas I've had are;
  151.  
  152. o Loading of Client side maps.
  153. o Clipboard.
  154. o Multiple selections.
  155. o Better selecting of polygon areas.
  156. o Multiple graphics (Possible shareware version ?)
  157.  
  158. Previous versions from 0.70
  159. ===========================
  160.  
  161. information about version before 0.70 has been removed.
  162.  
  163. Changes from version 0.70 to 0.90
  164. ---------------------------------
  165. o Fixed misc bugs.
  166. o Fixed choices Native jpeg problem.
  167. o Fixed 'WWW home page' problem.
  168. o Changed memory manager to newer version. Old version would report not
  169.    enough memory errors.
  170. o Added pilimary support for Imagen files after email from Justin Fletcher.
  171. o Added support for Imagemap files which will hopefully be a standard for
  172.    transporting between ImageMap and Imagen.
  173.    It has been agreed by both myself and Justin Fletcher :D
  174. o Shift-dragging a point will now create a new point
  175.    (currently polygons only).
  176. o Dragging a point on to another point will delete it.
  177. o Double clicking on a point will open the coords window. Here you can
  178.    enter values directly for the X and Y position of a point.
  179. o Improved redrawing. Prevents constant flickering that could happen.
  180. o Improved messages.
  181. o Fixed bug with loading some files.
  182. o Added key control for which tool is selected.
  183.  
  184. Changes from version 0.90 to 0.94
  185. ---------------------------------
  186. o Added Adjust click for cancelling drawing.
  187. o Added Delete button for deleting a region.
  188.  
  189. Changes from version 0.94 to 1.00
  190. ---------------------------------
  191. o Added support for PCA as a client rather then a server.
  192. o Added zoom option.
  193. o Improved redrawing by removing the xs shape drawing calls. Should
  194.    be speeded up. 
  195.  
  196. Changes from version 1.00 to 1.05
  197. ---------------------------------
  198. o Corrected inline (PCA) editing bug
  199. o Corrected delete region bug that would not wipe the region from
  200.   the screen till the next redraw of the area.
  201. o Fixed JPEG zoom display problem.
  202.  
  203. Changes from version 1.05 to 1.10
  204. ---------------------------------
  205. o Added zoom to window and previous zoom options.
  206. o Improved PCA support.
  207. o Fixed low resolution UI problems.
  208.  
  209. Changes from version 1.10 to 1.15
  210. ---------------------------------
  211. o Fixed PCA support problem when you have selected 'in place'
  212.   editting off. When you created a new region it would close
  213.   down the PCA session :(
  214. o Added new zoom options. To window and previous zoom.
  215.  
  216. Changes from version 1.15 to 1.25
  217. ---------------------------------
  218. o Fixed interactive help bug.
  219. o Fixed wimp polling bug.
  220. o Added pointer shape changing.
  221. o Improved interactive help support.
  222. o Made ImageMap more RISC OS compatiable.
  223. o Improved PCA support.  
  224. o Added zoom tool to tool bar.
  225. o Improved save options.
  226.  
  227. Changes from version 1.25 to 1.25a
  228. ----------------------------------
  229. o Fixed shift-dragging a point to create a new one bug.
  230.  
  231. Changes from version 1.25a to 1.30
  232. ----------------------------------
  233. o Fixed small buglett with PCA support.
  234. o Removed multitasking error windows - to make it more RISC OS complient.
  235. o Fixed large buglet with PCA support.
  236. o Added Shift function key control over the zoom.
  237. o Corrected redraw bug which made positioning of areas wrong when you
  238.   where editing a handle.
  239. o Added choice of Image helper.
  240. o Added some hi-res monochrome sprites.
  241.  
  242. Copyright
  243. =========
  244. This program is FreeWare. This means that ImageMap maybe freely copied and
  245. distributed as long as only a small charge is made for costs. (Small means
  246. less than 5 pounds. If you want to charge any more per disc ask my
  247. permission first).
  248.  
  249. I, the author, keep full copyright over ImageMap and you may not alter it in
  250. any way.
  251.  
  252. Disclaimer
  253. ==========
  254. I, the author, do not accept any liability for the loss or damage to your
  255. computer or any data stored on it, however caused, arising as a result of
  256. the use or misuse of this program.
  257.  
  258. Contacting the author
  259. =====================
  260. You can contact by any of the following methods. If you have any problems or
  261. if you have any suggestions for ImageMap then please do contact me as it'll
  262. give me some ideas as to what other people would like adding.
  263.  
  264. E-mail     : mailto:davemac@atlantic.oaktree.co.uk
  265.  
  266. WWW        : http://www.atlantic.oaktree.co.uk/
  267.  
  268. Snail mail : David McCormack,
  269.              2 Cornwall Avenue,
  270.              Beeston Rylands,
  271.              Nottingham,
  272.              NG9 1NL
  273.