ARM Club 3

home *** CD-ROM | disk | FTP | other *** search

/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / imagemap2 / Docs / Manual < prev next >

Wrap

Text File | 1998-06-03 | 22.1 KB | 1,242 lines

___ __ __ |_ _|_ __ ___ __ _ __ _ ___| \/ | __ _ _ __ | || '_ ` _ \ / _` |/ _` |/ _ \ |\/| |/ _` | '_ \ | || | | | | | (_| | (_| | __/ | | | (_| | |_) | |___|_| |_| |_|\__,_|\__, |\___|_| |_|\__,_| .__/ |___/ |_| -------------------- ---------------- --- World Wide Web Image Map Creator For RiscOS --------------------------------------------- This manual describes version 2.40 --------------------------------------------- This is a conversion of the full manual with images and diagrams supplied to registered users. CONTENTS Introduction...........................................................1 Installation...........................................................1 Important..............................................................2 The main window........................................................3 Tool bars - vertical...................................................4 Tool bars - horizontal.................................................5 Editing regions........................................................6 Choices window.........................................................7 Saving map files.......................................................8 Client Side maps.......................................................9 Server side maps......................................................10 Error messages........................................................11 Problems..............................................................12 References............................................................13 Documentation.........................................................13 Test applications.....................................................13 Copyright & Disclaimer................................................14 ShareWare.............................................................14 Licenses..............................................................15 Distribution..........................................................15 Contact informaton....................................................16 ImageMap ________________________________________________________________________ Introduction ———————————— ImageMap is a WWW image map creator. These are special images which have hot-spot areas. These hot-spots act in a similar manner to standard text links, in that a person viewing your pages can select them on move to another page. ImageMap has support for; o NSCA server side image maps. o CERN server side image maps. o HTML client side maps as specified in the HTML3.2 specification. Installation ———————————— Installing ImageMap is very simple all you need to do is copy the; o !ImageMap application folder o Examples folder o Docs folder out of the distribution archive in to a new folder on your hard drive. To load ImageMap you need to double click on the !ImageMap folder or on a file type that it recognises as belong to its self. These are the ImageMap (&B09) and Imagen (&1BF) file types, if Imagen hasn’t already been booted. Page 1 ImageMap ________________________________________________________________________ Important ————————— Before a new image map can created it is necessary for you to have a base image. Its this base image that has the hot-spots created over it. These images can be in any format though normally they will be in; Acorn Sprites JPEGs ImageMap will load these directly[1]. If it can’t load a file directly then it will try to use ChangeFSI to convert them to sprites first. If this fails then an error will be reported. Page 2 ImageMap ________________________________________________________________________ The main window ——————————————— 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. A selected region will have all it’s points shown by small ‘handles’. These are small rectangles at the intersection of two lines. Dragging these will change the shape of the region whilst dragging from inside of the region will move the whole region it’s self. Page 3 ImageMap ________________________________________________________________________ Tool bars - vertical ———————————————————— When editting an image map the main window is surrounded by two extra tool bars. The vertical tool bar contains all the buttons that act as short cuts for a number of commands. Whilst the borizontal bar displays the dynamic information, such as the current mouse position with in the window. They are; o Rectangle Will draw a rectangular region that will act as a hot spot for the image map. o Circle Will draw a circular region that will act as a hot spot for the image map. o Polygon Will draw a polygonal region that will act as a hot spot for the image map. Unlike the other two drawing tools the polygon tool can create a shape of n > 2 number of sides. o Zoom This tool opens the zoom window so that you can change the zoom factor of the window. o PCA Menu This tool opens a menu of all the PCA server applications that are currently loaded. o Select It is with this that you can move and resize a region as well as selecting it for delete. Page 4 ImageMap ________________________________________________________________________ Tool bars - horizontal —————————————————————— The horizontal tool bar contains; o The current mouse position. This is the current mouse position within the image map. It is calculated from the top left hand corner. o Coordinates box This displays the mouse pointer’s current location in the loaded imagemap. This is taken from the top left hand corner of the window. Page 5 ImageMap ________________________________________________________________________ Editing regions ——————————————— Once a region has been drawn it is possible to edit it, only if it is a polygon. By holding down shift you can copy a region exactly very easily by dragging it from the center of the shape. If you drag a ‘handle’ with shift held down you will create a brand new ‘handle’. This only applies to polynomal areas as you can not add points to rectnagular or circular areas. If you could they would no longer be rectangular or circular. To delete a ‘handle’ you simply have to copy it over another ‘handle’. This only works for polynomal areas though, as you can not delete a point from the circle or rectangle areas. If you could then they would no longer be rectangular or circular. By double-clicking on a region you can alter the URL that the region points to.... ....but if you double-click on a ‘handle’ then you can alter its coordinates directly. Page 6 ImageMap ________________________________________________________________________ Choices window —————————————— The choices window can be accessed from the icon bar menu. Once opened, by selecting the Choices... menu item a window will open. This window has a column of option buttons running down the side of it. This option buttons decide which area of ImageMap you are altering the choices for. The choices themseleves are displayed in the small window pane. There are currently three different sections to the Choices window. o Regions This controls the default settings for a newly created region. It also contains the options for the background of a newly created image map. o Display Controls the setting for the display. o PCA Gives access to the choices offered for controlling the PCA support. This should be the same as offered by any other PCA supporting application. You can chose what type of the dialogue window you wish to use. Risc OS menu / NCOS menu Risc OS button bar / NCOS button bar You can then chose how this dialogue window is sorted. After that you can the enable or disable the in-place editting support that, when enabled, helps save space on the desktop. Page 7 ImageMap ________________________________________________________________________ Saving map files ———————————————— Using ImageMap you can save your newly created image map in five different formats. The formats are... o ImageMap o Imagen Only three of the support formats can be used on the WWW though. As the first two are proprietary formats on used in the RiscOS world. The three formats that can be used on the WWW are... o NSCA o CERN o Client side (HTML) The first format is ImageMap's own internal format which keeps the image and region data together in one format. The Imagen support is there to inable transfering of data between Imagemap and Imagen, an alternative image creator for RiscOS written by Justin Fletcher. NSCA and CERN both use a server side system, while client side maps are supported using the web browsing software. To save the image map you will need to open the main menu by clicking on the window with MENU. By following the Save menu item you will find a smaller submenu being displayed. When you save the image map as a client side file you can save the graphic as well. This will make sure that the links to the graphic are correct. No conversion is currently done to the file so if it was loaded a sprite it will be saved as a sprite. If it was loaded as a JPEG it will be saved as a JPEG [1]. Page 8 ImageMap ________________________________________________________________________ Client Side maps ———————————————— To save a client side image you need to go to the Export submenu and use the save HTML window.In this window are a number of choices. o Save graphic o Save map data only When the former choice is selected, ImageMap will save the base image in the same directory as the HTML is saved. This is always saved as 'imagemap' and will over write any file with the same name. The second choice will only save the map data. This means that only the actual image map data will be saved. Normally when a client side image map is saved ImageMap will create a skelton HTML file so that the data can be loaded in to a web browser and checked if necessery. With this option selected the skeleton is not created. Its useful when you have updated an existing imagemap and go to save the new map data in to the HTML file. Page 9 ImageMap ________________________________________________________________________ Server side maps ———————————————— 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 customers this is NSCA format. Then you need to alter you web page. To the line where you have defined your the graphic for the imagemap, <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. So that you end up with something like the following[1]..... <a href=“http://www.<nodename>.demon.co.uk/cgi-bin/imagemap/main.map”> <img src=“/map.gif” ISMAP> </a> Assuming that both the image and the map file containing the hot spots are in the root directory of the web site. If not then you will need to add the file path in place of main.map for the link, and likewise for the graphic. Page 10 ImageMap ________________________________________________________________________ Error messages —————————————— There are a number of different types of errors - some are nothing more than warnings some are far more serious. Some of the more common and serious ones are listed below. When the title is surrounded by single quotes then this is the text or part of the text that will appear in the warning box. 'ImageMap requires a !ChangeFSI to have been seen by the filing system.' On pre-RiscOS 3.6 machines ImageMap requires ChangeFSI so that it can load JPEG files - on RiscOS 3.6 or above it can use the native JPEG handling code. It will also use ChangeFSI to load any other file format it doesn't understand, incase these are image file formats. 'ImageMap requires a !Scrap directory to have been setup.' When using ChangeFSI, ImageMap has to create a number of temporary files. The standard place for these is in the !Scrap directory. If you have a modern Acorn compatiable boot sequence then the !Scrap folder should be automattically setup. 'Address Exception' These is a terrible error. If this occurs with any application you should save any unsaved documents in to a temporary directory - not over the orginial in case the memory corruption has affected the document and then reset your machine. You should then check each of the files in turn to make sure they are not corrupted. Page 11 ImageMap ________________________________________________________________________ Problems ———————— Below are a list of possible problems you may encounter. If you find a problem that is not below then you can always get help from me via the contact details below. Q: ‘My server side maps will not reload in the ImageMap!’ A: You need to select them in the desktop filer and then set there file type to &259. Once you have done this they should load correctly, but you must have an image loaded first. You can also press F2, when editing a map, and merge two or more files. For an image map to be created, or used, you must have a image loaded. This is a requirement and there is no way around it. You will need to drag a graphic in to ImageMap and then drag your server side map on to the window which opens. This error can also be reported when loading ImageMap files created by older versions or when loading Imagen files, This is because the file may not contain a graphic. Q: ‘When I test my server side map it doesn't work / an error message is reported from the script program!’ A: When using a server side map it is necessary to specify the page to go to either with a full address http://www.<address>.com/<file name> or specify it relative to the root directory of your web site. So a file, data.map, that is in the imagemap/server/ directory on the web site will be defined as /imagemap/server/data.map in the URL item in the Where to go.... window. Q: ‘When I load ImageMap for the first time the screen flashes but if I load it again it doesn't?’ A: This is a problem with the handling of tasks in Risc OS. It appears to affect the majority of applications that use PCA version 2 - as ImageMap does. Page 12 ImageMap ________________________________________________________________________ References —————————— Documentation ————————————— The main technical documentation for ImageMap was; o http://www.w3.org/TR/REC-html32 Test applications ————————————————— Client side maps saved by ImageMap have been tested with; o MS Internet Explorer 2.01 o Netscape Navigator 3.00 o Doggysoft‘ Web browser 1.40 o ANT Fresco 1.71 NSCA Server side maps saved by ImageMap have been tested with; o Doggysoft‘ Web browser (1.36) I have been unable to test CERN output. Page 13 ImageMap ________________________________________________________________________ Copyright & Disclaimer —————————————————————— 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. Unless otherwise stated the whole of the ImageMap package is © David McCormack ImageMap uses the Imagen module written by © Justin Fletcher. ShareWare ————————— ImageMap is ShareWare. This means that you may use ImageMap for only 30 days as a trial period. If, after this time, you decide that you want to continue using ImageMap you must register it by completing the registration form included in the ImageMap distribution package. If you decide not to register ImageMap then you must either destroy all the copies that you have or give way all the copies that you have. Please support Shareware development as without your support a large number of high quality applications will not be written! The single user registration fee is currently just £10. The registration fee includes a disc with a fully registered copy of the latest version of ImageMap, and if you require it the printed Impression manual that is only supplied with registered copies. Please take note that this is not professionally printed manual but is just a copy printed on a bubble jet printer. Page 14 ImageMap ________________________________________________________________________ Licenses ———————— There are currently two types of licence available, each with a different and appropriate price. They currently are; o Single user Priced at £15, this covers any individual person. You may not use this version on a network of more than 3 machines. This includes the right to use ImageMap indefinitely as having the right to use new shareware versions when they are released. o Site License Priced at £30 which allows the user to use ImageMap on 3 or more machines at any one time on a single site. Distribution ———————————— Unregistered copies of ImageMap may be distributed freely so long as the following conditions are met: o ImageMap must be distributed intact, excluding the Impression format manual which must not be distributed. Any alterations made to the program must be removed before distribution. o ImageMap may only be distributed so long as no commercial gain or advantage is made via its distribution, without my prior consent. Distribution ‘costs’ maybe charged so long as they are less than the equivalent of £5.00 UK sterling. o ImageMap may not be distributed on any CD{\151}ROM or with any commercial product without my prior consent. Registered versions of ImageMap may not be distributed at all. They have the licensees name embedded in the software. Licensees of ImageMap may make infinite backups, so long as ImageMap is installed and used according the the type of licence that has been purchased. Page 15 ImageMap ________________________________________________________________________ Contact informaton —————————————————— If you wish to contact me then the details are below. I can be contacted by mail or e-mail at the addresses below, if you can use e-mail as it is much quicker and you stand a higher chance of getting a reply. My web address is below and the latest version of ImageMap can be downloaded from there. David McCormack, 2 Cornwall Avenue, Beeston Rylands, Nottingham, NG9 1NL E Mail davemac@atlantic.oaktree.co.uk WWW http://www.atlantic.oaktree.co.uk/ Page 16