home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 627b.lha / IE_v3.0 / IE.Doc.pp / IE.Doc
Text File  |  1992-04-09  |  28KB  |  679 lines
  1.                       IE - The Complete Icon Editor     by Peter Kiem
  2.                                                            6 Romeo Crt
  3.                                                            Sunnybank Hills
  4.                                                            Brisbane 4109
  5.                                                            Australia
  6.  
  7.  
  8.  
  9. ABOUT IE
  10.  
  11.     IE is a shareware program which allows the creation and editing of icons
  12. on the Amiga personal computer.  Using IE you can make icons much larger and
  13. easier than using the supplied icon editor on your system disks.
  14.     IE requires at least 1 Meg of memory (preferably 1 Meg CHIP memory).
  15.  
  16.  
  17.  
  18. DEMONSTRATION VERSION CHANGES
  19.  
  20.     The demonstration version of IE is fully functional so you can test all
  21. the functions of IE and determine if you wish to register or not.  To
  22. encourage you to register IE, the demonstration version also has a few
  23. changes:
  24.  
  25.     -   After starting the demonstration version of IE two requesters will
  26.     be displayed giving information about the demonstration version and
  27.     about obtaining a registered copy of IE.  These requesters will
  28.     disappear after 30 seconds each and you can then continue with IE.
  29.  
  30.     -   The demonstration version will also exit after any "save" operation
  31.     is performed.  This is done so you can see the effects of changing an
  32.     icon with IE rather than totally disabling the save functions as some
  33.     demonstration programs do.
  34.  
  35.     When you register your copy of IE you receive a registration number and
  36. your name is coded into the title bar of IE as proof of your registration.
  37. You will also be entitled to free upgrades if I create new versions of IE.
  38. The source code is only available to registered users.
  39.  
  40.     I am not making a living from writing IE so I have not charged as much
  41. as I could had I marketed it commercially.  A fully registered version of IE
  42. will only cost you AUD$20 and source code another AUD$30 (if you want both -
  43. AUD$50).  Please respect the amount of time and effort I have put into IE
  44. and consider the small fee asked if you continue to use this program.
  45.  
  46.  
  47.  
  48. DISTRIBUTION OF IE
  49.  
  50.     You can freely distribute the DEMONSTRATION version of IE as long as the
  51. following is observed:
  52.  
  53.     -   The program and documentation must be distributed together and are
  54.     not modified in any way.  The only exception is that the program and
  55.     documentation may be compressed into an archive for uploading to
  56.     Bulletin Boards or for other electronic transmission.
  57.  
  58.     -   The program is not used commercially or included in a commercial
  59.     package for profit unless written authorisation from me is obtained
  60.     first.  The demonstration version of IE may be freely included on public
  61.     domain library disks or compilation disks provided only a small fee is
  62.     charged for the service.
  63.  
  64.     A REGISTERED version must NEVER be distributed in ANY way (after all,
  65. you paid for it so why shouldn't others?).
  66.  
  67.  
  68.  
  69. WHAT ARE ICONS?
  70.  
  71.    Icons are the pictures on Workbench that allow you to start a program,
  72. select a document or examine the contents of a disk.  These icons can also
  73. have a second picture which is displayed when the icon is selected giving
  74. the appearance of motion etc.
  75.  
  76.     Icons can also pass information to the tool called through the use of
  77. "Tool Types".  IE will also allow you to edit these and more.
  78.  
  79.     There are five different types of icons representing the different types
  80. of files on the Amiga:
  81.  
  82.     DISK ICON - To represent disks or harddrive partitions.  (NOTE: A disk
  83.     icon will only be displayed when it is named "disk.info" and is in the
  84.     top directory of a disk or HardDrive partition).
  85.  
  86.     DRAWER ICON - To represent a drawer (directory) on a disk.
  87.  
  88.     GARBAGE ICON - To represent the special drawer known as the Trashcan.
  89.  
  90.     TOOL ICON - To represent an executable program.
  91.  
  92.     PROJECT ICON - To represent a document, drawing, picture etc that is
  93.     passed to the tool for being edited.
  94.  
  95.  
  96.  
  97. STARTING IE
  98.  
  99.     The simplest method of starting IE is by double-clicking on the IE icon
  100. from Workbench.  This will start IE ready to create an icon.
  101.  
  102.     Another method of starting IE from Workbench is to single-click on a
  103. project icon, hold down the "shift" key and double-click on the IE icon.
  104. This will start IE and automatically load the project icon for editing.
  105.  
  106.     IE can also be started from the CLI by typing "IE" optionally followed
  107. by the name of the icon to load.  This icon can be of any type and the
  108. ".info" suffix needed not be included in the name.
  109.  
  110.     NOTE: The WINDOW tooltype on the IE icon is required to run IE from
  111. WorkBench under DOS1.2.  On later versions of DOS this tooltype can be
  112. removed safely.
  113.  
  114.  
  115.  
  116. THE ICON DISPLAY WINDOW
  117.  
  118.     On the main IE window there is a large square region on the left hand
  119. side.  In this window the icon being edited is displayed 8 times normal
  120. size.
  121.  
  122.     To see different parts of the icon simply click, or slide, the
  123. horizontal and vertical scroll bars next to the display window.  This allows
  124. you to move quickly around the full 640x200 image. Alternatively you can
  125. click on the four arrow gadgets next to the scroll bars to shift the display
  126. one pixel at a time in the direction of the arrow.
  127.  
  128.     The "H" gadget in the top-right corner of the display window returns the
  129. horizontal and vertical scroll bars quickly to the "Home" position (that is,
  130. with the top-left corner of the icon being displayed).
  131.  
  132.     Underneath the display window are the current coordinates of the pointer
  133. within the icon (up to 640,200) and the name of the icon currently being
  134. edited.
  135.  
  136.  
  137.  
  138. SELECTING THE NUMBER OF BITPLANES
  139.  
  140.     Down the right hand side of the main IE window are the 16 colour
  141. gadgets.  Some of these will probably be disabled due to the number of
  142. bitplanes in use.  To change the number of bitplanes in use, select 1 of the
  143. 4 bitplane gadgets next to these colour gadgets.  The colour gadgets will
  144. enable/disable according to how many bitplanes you select.
  145.  
  146.     For those who don't understand bitplanes the following table may help.
  147.  
  148.     #Planes  #Colours Available
  149.     ----------------------------------------------
  150.     1         2
  151.     2         4 (Standard Workbench configuration)
  152.     3         8
  153.     4        16
  154.  
  155.     The number of colours that can be used in an image on the Amiga is
  156. determined by how many bitplanes are used (the more bitplanes - the more
  157. colours).
  158.  
  159.     Workbench versions up to 1.3 are standard 2 bitplanes giving 4 colours.
  160. This may be increased by programs from the public domain.
  161.  
  162.     Workbench 2.0 can be configured to use up to 4 bitplanes giving 16
  163. colours.
  164.  
  165.     IE will automatically select the number of bitplanes for you, from the
  166. Workbench screen, so you would normally leave it up to IE to choose.  You
  167. can however change it manually if you wish.
  168.  
  169.     Using less bitplanes (and hence less colours) will mean the icons will
  170. use less disk space as less data is needed to create the icon.  Using more
  171. bitplanes (and hence more colours) will mean the icons will use more disk
  172. space as more data is required to create the icon.
  173.  
  174.     Using icons with more bitplanes than the Workbench configuration will
  175. cause unpredictable results.  Workbench will "cut down" the icon bitplanes
  176. and the image may not be displayed correctly.
  177.  
  178.  
  179.  
  180. SELECTING A DRAWING COLOUR
  181.  
  182.     To select a colour to draw in, click on one of the 16 colour gadgets
  183. down the right-hand side of the main IE window.  The brush pointer's tip
  184. will change to the selected colour to remind which colour you are using.
  185.  
  186.  
  187.  
  188. CHANGING THE ICON'S IMAGE
  189.  
  190.     To change the colour of a pixel in the icon's image simply position the
  191. pointer in the display window over the pixel you want to change and click
  192. the left mouse button.  The pixel will then change to the currently selected
  193. colour as denoted by the pointer's brush tip.
  194.  
  195.     By holding down the left mouse button and moving the pointer within the
  196. display window the pointer will continuously draw into the bitmap changing
  197. the pixels moved over into the currently selected colour.
  198.  
  199.  
  200.  
  201. SELECTING WHICH ICON IMAGE TO EDIT/DISPLAY
  202.  
  203.     Icons can be made of one or two images.  The first image is the image
  204. displayed on the Workbench screen before any selection is made and is called
  205. the "Non-Select Image".  The second (optional) image is displayed when the
  206. icon is selected and is called the "Select Image".
  207.  
  208.     To the right of the Home gadget is the Image Select gadget that looks
  209. like a pair of disks with numbers in them.  This gadget allows you to select
  210. which image you are displaying/editing.  Click on this gadget to switch
  211. between the two images.
  212.  
  213.     The disk containing the 1 represents the Non-Select Image and the disk
  214. containing the 2 represents the Select Image. The half of the gadget with
  215. the highlighted background shows which image is the current one.
  216.  
  217.  
  218.  
  219. THE UNDO EDIT GADGET
  220.  
  221.     Just underneath the Select Image gadget is the Undo Edit gadget. As the
  222. name suggests, this gadget will "undo" the last editing operation.  This
  223. enables you to reverse the effects where the edit you performed was
  224. incorrect (e.g. If your Flood-Fill leaked and destroyed your image, then
  225. click on the Undo Edit gadget and the image will be restored to before the
  226. Flood-Fill).
  227.  
  228.     The Undo Edit gadget will only undo the changes of the LAST edit and not
  229. previous ones.  Certain operations likewise will not be able to be undone
  230. and the gadget will be disabled to inform you of this fact.
  231.  
  232.  
  233.  
  234. THE COPY IMAGE GADGET
  235.  
  236.     This gadget will enable you to copy the Non-Select to the Select image
  237. or vice versa.  This gadget will also enable you to swap the images around.
  238. A requester will be displayed for you to choose your options.
  239.  
  240.  
  241.  
  242. THE FLOOD FILL GADGET
  243.  
  244.     This gadget will turn on or off when selected.  When the gadget is on,
  245. a click within the display window will initiate a "flood" paint instead of
  246. changing the selected pixel's colour.
  247.  
  248.     The pixel under the pointer is changed to the currently selected colour
  249. and this continues for all pixels of the same colour "connected" to the
  250. selected one.  Only horizontal and vertical "connections" are checked for
  251. flood fill, diagonals are ignored.  This can be used to quickly fill in an
  252. area instead of painting all of it by hand.
  253.  
  254.     Remember that the Undo-Edit gadget will restore your image if the flood
  255. fill "leaks" and destroys your image but it must be done straight away.
  256.  
  257.  
  258.  
  259. THE WRITE TEXT GADGET
  260.  
  261.     This gadget also turns on or off when selected.  When the gadget is on,
  262. a click within the display window will initiate a text write instead of
  263. changing the selected pixel's colour.  The text will be written in the
  264. currently selected colour as denoted by the pointer's brush tip.
  265.  
  266.     A requester is displayed asking for the text to write into the image.
  267. The string gadget is automatically activated for you so you can just start
  268. typing and press the return key when finished.
  269.  
  270.     If you wish to use a different font than the default (Topaz/8) then you
  271. can click on the Select Font gadget which will then bring up a Font
  272. Requester.  This requester allows you to scroll through the list of
  273. available fonts, select one and apply any combination of the style changes
  274. bold, italic and underline.  The highlighted font name represents the
  275. current font.  A sample text in the selected font and styles can be seen in
  276. the requester to enable you to make your decision before leaving the
  277. requester.  The selected font and style then becomes the default for further
  278. text writes.
  279.  
  280.  
  281.  
  282. THE MOVE IMAGE ARROW GADGETS
  283.  
  284.     These gadgets move the whole icon image in the direction of the gadget.
  285. These are not to be confused with the arrow gadgets next to the scroll bars
  286. as those gadgets are only for fine-tuning the scroll bars.
  287.  
  288.     These gadgets are most useful when you wish to create extra room on top
  289. of, or to the left of, your image in order to do more drawing.  They can
  290. also be used to eliminate "blank" space to the left of your image.
  291.  
  292.     IE will automatically strip the image to the smallest possible size when
  293. saving the icon so it may be faster to save the icon temporarily and reload
  294. it and only use these gadgets to remove the "blank" space that IE could not
  295. remove automatically.
  296.  
  297.  
  298.  
  299. The "PROJECT/NEW" menu item (Right-Amiga N)
  300.  
  301.     This menu item resets IE to it's defaults for creating a new icon.  It
  302. clears the data in both images and resets the InfoEdit window parameters.
  303.  
  304.  
  305.  
  306. The "PROJECT/LOAD" menu item (Right-Amiga L)
  307.  
  308.     This menu item will display the file requester to allow you to select
  309. which icon you wish to load.  See the section on the File Requester for
  310. details.
  311.  
  312.  
  313.  
  314. The "PROJECT/SAVE" menu item (Right-Amiga S)
  315.  
  316.     This menu item will save the current icon, or if you haven't selected
  317. an icon name it will display the file requester for you to select one.  See
  318. the section on the File Requester for details.
  319.  
  320.     IE will automatically strip the imagery you designed for the icon to the
  321. smallest possible size, eliminating as much "blank" space as possible,
  322. before saving.
  323.  
  324.  
  325.  
  326. The "PROJECT/SAVE AS" menu item
  327.  
  328.     This menu item will display the file requester to allow you to select a
  329. different name to save the icon under.  See the section on the File
  330. Requester for details.
  331.  
  332.  
  333.  
  334. The "PROJECT/SAVE & QUIT" menu item (Right-Amiga F)
  335.  
  336.     This menu item will save the current icon, or if you haven't selected
  337. an icon name it will display the file requester for you to select one.  See
  338. the section on the File Requester for details.
  339.  
  340.     After saving the icon IE will then automatically quit.  It is a shortcut
  341. to using the Right-Amiga S and Right-Amiga Q menu items.
  342.  
  343.  
  344.  
  345. The "PROJECT/ABOUT" menu item (Right-Amiga A)
  346.  
  347.     This menu item will display information about the program and show you
  348. where you can contact the author.  Press the "OK" gadget when finished
  349. reading each requester.
  350.  
  351.  
  352.  
  353. The "PROJECT/QUIT" menu item (Right-Amiga Q)
  354.  
  355.     This menu item allows you to quit IE (what else?).
  356.  
  357.  
  358.  
  359. The "ICON/PREVIEW" menu item (Right-Amiga P)
  360.  
  361.     This menu item displays the icon preview window.  This window displays
  362. the icon image exactly as it will be displayed on Workbench.  Clicking the
  363. Left mouse button in this window will toggle the display from the Non-
  364. Select to the Select Image and vice versa.  NOTE - The preview window will
  365. only display alternate renders, the Complement and Backfill select options
  366. are NOT displayed in the preview window.
  367.  
  368.     The preview window is updated with every change you make to the image.
  369. If you resize the Preview window and move it to an area of the screen that
  370. you won't be needing, you can immediately see the effect of any changes you
  371. make to the image in realtime.  Although this can drastically slow down the
  372. continuous drawing function it can be very useful for checking that the
  373. changes you are making look correct.
  374.  
  375.     If the Preview window is left active and you perform other functions
  376. that cause a requester to be displayed, that requester may be covered by the
  377. Preview window.  You may have to resize and/or move the Preview window to
  378. get access to the requester.
  379.  
  380.  
  381.  
  382. The "ICON/EDIT INFO" menu item (Right-Amiga E)
  383.  
  384.     This menu item displays the icon information editing window.  This
  385. window allows you to change the various "non-graphical" options of icons.
  386. These are summarised below:
  387.  
  388.     ICON TYPE - Simply select the gadget corresponding to type of icon you
  389.     wish to create (DISK, DRAWER, TOOL, PROJECT, GARBAGE).
  390.  
  391.     HIGHLIGHTING - Select which type of highlighting the icon should have
  392.     when it is selected from Workbench.  COMPLEMENT is to reverse all the
  393.     icon colours within it's select box.  BACKFILL is to reverse all the
  394.     icon colours but only in the image not the background.  ALT RENDER is
  395.     to use the second image (Select Image).
  396.  
  397.     HORIZONTAL POSITION - Select the FIND BEST gadget if you wish Workbench
  398.     to automatically try to find a place to fit the icon in.  If the FIND
  399.     BEST gadget is turned off then the number in the string gadget specifies
  400.     the exact horizontal placement of the icon.
  401.  
  402.     VERTICAL POSITION - Select the FIND BEST gadget if you wish Workbench
  403.     to automatically try to find a place to fit the icon in.  If the FIND
  404.     BEST gadget is turned off then the number in the string gadget specifies
  405.     the exact vertical placement of the icon.
  406.  
  407.     DEFAULT TOOL - Type the name of the tool (executable program) which this
  408.     icon is associated with.  The effect of double clicking on this icon
  409.     will be the tool is started and the file associated with this icon will
  410.     be passed to the tool.  The file associated with this icon will only be
  411.     passed to the tool if the tool is set up to receive parameters from
  412.     Workbench otherwise the tool will start as if you selected it directly.
  413.     This gadget will only work with DISK or PROJECT icons.  DISK icons
  414.     should specify a disk copy program for their default tool.
  415.  
  416.     TOOL TYPES - Up to 40 tool types can be specified in this area with the
  417.     scrolling controlled by the scroll bar and arrow gadgets.  Tool Types
  418.     are parameters which are passed to the tool such as "PRINTER=LPT".  The
  419.     tool must be written to accept Tool Types and the tool documentation
  420.     should be able to inform you of the format to use.
  421.  
  422.     OPENED WINDOW - This enables you to specify the position and size of
  423.     the window which is displayed when the DISK, DRAWER or GARBAGE icon is
  424.     selected.  It also enables you to select what colours the opened window
  425.     will be displayed in if you are running under DOS1.3.  The colour of the
  426.     opened window relies upon an undocumented "feature" of DOS1.3 and is
  427.     ignored by DOS2.0.  Simply click on the colour gadget and it will cycle
  428.     through the available colours.
  429.  
  430.     STACK SIZE - This enables you to specify the stack size for the tool
  431.     which is started by the TOOL or PROJECT icon.  A stack size of 0 means
  432.     to use the default stack size (around 4000 bytes), otherwise the stack
  433.     size you specify will be used.
  434.  
  435.     NAME OFFSET - This enables you to specify a +/- value with which to
  436.     offset the vertical positioning of the icon name.  By specifying a
  437.     positive value the name is moved downwards.  The more usual use is to
  438.     specify a negative value which moves the name upwards.  This can be
  439.     used to centre the icon name within the image of the icon.  NOTE that
  440.     if the name is moved into the icon image only the image portion ABOVE
  441.     the name can be selected with the mouse.
  442.  
  443.     If any of these parameters are changed, and you are using DOS1.3, then
  444. you must reload the icon to make the changes take effect.  If you were
  445. editing a DISK icon you must remove the disk and then reinsert it.  To
  446. reload an icon of the other types you must close the window containing the
  447. icon and reopen the window.
  448.  
  449.     DOS2.0 has the ability to detect when an icon has been changed and the
  450. icons usually do not have to be reloaded for the change to take effect.
  451. The only exception is that when the Opened Window parameters are changed
  452. the icon has to be reloaded as above.
  453.  
  454.  
  455.  
  456. The "ICON/RECOLOUR" menu item (Right-Amiga R)
  457.  
  458.     This menu item will cause the pixels in colours 1 and 2 (usually black
  459. and white) to be reversed in both icon images.  This is a shortcut to using
  460. the "ICON/SWAP COLOURS" menu item for each image and is provided especially
  461. for changing icons for DOS2.0 usage as DOS2.0 has the colours 1 and 2
  462. reversed.
  463.  
  464.  
  465.  
  466. The "ICON/SWAP COLOURS" menu item (Right-Amiga W)
  467.  
  468.     This menu item will display a requester where you can choose two
  469. colours to be reversed in the CURRENT image being edited (e.g. you can swap
  470. black with white).
  471.  
  472.  
  473.  
  474. The "MISCELLANEOUS/OUTPUT C CODE" menu item (Right-Amiga C)
  475.  
  476.     This menu item will display the file requester to allow you to select
  477. a filename to write the C language code for the icon.  See the section on
  478. the File Requester for details.  One use of this is for your programs to
  479. generate their own icons.
  480.  
  481.     The following code example shows how to write an icon file.  This
  482. assumes you generated the C Code to a file called "c-code" and are
  483. generating the icon "test.info":
  484.  
  485.         #include <exec/types.h>
  486.         #include <intuition/intuition.h>
  487.         #include <workbench/workbench.h>
  488.  
  489.         #include <functions.h>
  490.         #include "c-code";  /*ALTERNATIVELY COPY THE CODE HERE FIRST*/
  491.         extern struct IconBase *IconBase;
  492.  
  493.         void main()
  494.  
  495.         {
  496.           IconBase = (struct IconBase *) OpenLibrary("icon.library", 0);
  497.           PutDiskObject("test", &Icon);
  498.           CloseLibrary(IconBase);
  499.           exit();
  500.         }
  501.  
  502.     Another use for the generated C code is for creating gadgets for your
  503. programs.  You can create the gadget image using IE, or load in an IFF
  504. image into IE, and write the C code to a file.  The image data and image
  505. structure generated can then be copied into your program as the data for the
  506. gadget.  All of IE's gadgets were drawn in IE and the generated code used
  507. in IE's own source code.
  508.  
  509.  
  510.  
  511. The "MISCELLANEOUS/IMPORT IFF" menu item (Right-Amiga I)
  512.  
  513.     This menu item displays the file requester to allow you to choose an
  514. IFF picture file to load into the CURRENT image being edited.  This allows
  515. you to use pictures (generated by packages such as DPaint) in your icon
  516. images.
  517.  
  518.  
  519.  
  520. The "MISCELLANEOUS/EXPORT IFF" menu item (Right-Amiga X)
  521.  
  522.     This menu item displays the file requester to allow you to choose the
  523. name of the IFF picture to be created from the CURRENT image being edited.
  524. This allows you to export your image to packages with more sophisicated
  525. editing features (such as DPaint) to edit your image and then later import
  526. the edited image back into your icon image.
  527.  
  528.     I purposely avoided writing more complex drawing tools such as boxes,
  529. circles, lines, sprays and different size pens.  Everyone usually has access
  530. to a painting package which are designed specifically for IMAGE editing
  531. where IE is meant to be an ICON editor.  The extra functions would mean
  532. larger code size than is necessary.  Instead the IFF import and export menu
  533. items allow users to access the more complex functions in programs
  534. specifically designed for that job.
  535.  
  536.  
  537.  
  538. The "MISCELLANEOUS/IMPORT FROM ICON" menu items
  539.  
  540.     These menu items allow you to grab images directly from other icons.
  541.  
  542.     "NON-SELECT IMAGE" (Right-Amiga 1) allows you to load the Non-Select
  543.     image of an icon into the CURRENT image being edited.
  544.  
  545.     "SELECT IMAGE" (Right-Amiga 2) allows you to load the Select image of
  546.     an icon (if there is one) into the CURRENT image being edited.
  547.  
  548.     "BOTH IMAGES" (Right-Amiga 3) is a shortcut that allows you to load
  549.     both images from an icon into the icon you are currently editing.
  550.  
  551.  
  552.  
  553. FILE REQUESTER
  554.  
  555.     This requester displayed periodically by IE is used when a filename
  556. and drawer are needed for various read/write activities.  The parts of the
  557. file requester are detailed below:
  558.  
  559.     DRAWER STRING GADGET - This gadget is to display the current drawer of
  560.     which the file requester is displaying the names of files in.  You may
  561.     type a new drawer name in here and press return to quickly move to
  562.     another drawer.
  563.  
  564.     FILENAME GADGETS - There are 8 of these gadgets and these display the
  565.     names of the files in the current drawer.  The highlighted gadgets
  566.     represent drawers and the rest are ordinary files.  To select a new
  567.     drawer to examine just click on the gadget with the left mouse button.
  568.     Selecting a filename by clicking the left mouse button will copy the
  569.     filename into the filename string gadget.  Selecting the gadget again
  570.     will act like the OK gadget has been pressed.
  571.  
  572.     FILENAME GADGET SCROLL BAR - As only 8 filenames can be displayed at a
  573.     time this gadget is used to scroll through the list of files.  The
  574.     scroll bar can be selected and dragged with the left mouse button to
  575.     dynamically scroll through the list.
  576.  
  577.     FILENAME STRING GADGET - This gadget displays what the current file is.
  578.     You may type a filename directly in here to quickly select a file or to
  579.     specify the name of a new file.  This gadget is always active and at
  580.     any time you can just start typing in the filename and press return
  581.     when finished.
  582.  
  583.     OK GADGET - If the filename string gadget has a filename in it then the
  584.     OK gadget will end the file requester and pass the current drawer name
  585.     and filename to IE.
  586.  
  587.     PARENT GADGET - This gadget will change the current drawer to it's
  588.     parent drawer (that is, the drawer that contains the current drawer).
  589.     Selecting this gadget when at the top most drawer of a disk will have
  590.     no effect.
  591.  
  592.     VOLUMES GADGET - This gadget will clear the drawer string gadget and
  593.     will cause the file requester to display the list of volumes instead of
  594.     files.  The highlighted gadgets then represent disks or harddrive
  595.     partitions available.  The non-highlighted gadgets represent logical
  596.     volumes created by the use of "assign" statements.  Selecting one of
  597.     these gadgets will set the current drawer to the assigned logical volume
  598.     or disk.
  599.  
  600.     CANCEL GADGET - This gadget will end the file requester and send a
  601.     cancel message back to IE.
  602.  
  603.     The file requester is asynchronous which means you do not have to wait
  604. for it to finish reading the filenames from disk before selecting gadgets.
  605. This makes it slower than in previous versions but for floppy users (or
  606. harddrive users with lots of files in one drawer) you can skip the un-
  607. necessary step of reading all the files when you just want to change drawers
  608. or give a filename that you already know.
  609.  
  610.  
  611.  
  612. IE'S AUTOSAVE FUNCTION
  613.  
  614.     To try to prevent you from losing your work (from power loss, guru, etc)
  615. IE will automatically save your icon into the file "IE.AutoSave.info" five
  616. minutes after a change has been made to an unsaved icon.  This file will be
  617. automatically deleted if IE is exited with the "PROJECT/QUIT" or
  618. "PROJECT/SAVE & QUIT" menu items.
  619.  
  620.     If IE finds the autosave file present when it starts it will ask if you
  621. want to reload the icon from the autosave file restoring your work.
  622.  
  623.     NOTE that the DEMONSTRATION version will automatically exit after an
  624. autosave.
  625.  
  626.  
  627.  
  628. PROJECT ICON HINT
  629.  
  630.     If you have some icons that you use regularly then you can create a
  631. "library" of icons by saving them in a drawer as PROJECT icons.  Then by
  632. clicking on an icon, holding down the shift key and double-clicking on the
  633. IE icon you can start IE and IE will automatically load the icon.  You can
  634. then change the icon type, and other characteristics, and use the
  635. "PROJECT/SAVE AS" menu item to save the icon in the desired place and name.
  636.  
  637.     A better method than click, shift, double-click is to change the PROJECT
  638. icon's default tool string to be the full path and name of IE.  Then you
  639. just have to double-click on the desired icon and IE will start and
  640. automatically load the icon as above.
  641.  
  642.  
  643.  
  644. REMEMBER
  645.  
  646.     If you change an icon's characteristics and save it under DOS1.3 then
  647. the icon HAS to be reloaded for those changes to take effect.  If the icon
  648. was a disk icon then close all windows from the disk, eject the disk and
  649. reinsert the disk.  If the icon is of the other types then close the window
  650. containing the icon and reopen the window.
  651.  
  652.     Under DOS2.0 you do not have to reload the icon except when changing the
  653. Opened Window characteristics.
  654.  
  655.     Also under DOS2.0 the Opened Window colours will NOT work.  This relied
  656. upon an undocumented "feature" of DOS1.3.
  657.  
  658.  
  659.  
  660. A FINAL WORD FROM THE AUTHOR
  661.  
  662.     I designed IE to be as simple to use as possible but still possess all
  663. the features required for the construction of icons.  The Amiga has a far
  664. better icon system than ANY of the other machines available and I hope you
  665. use IE to utilise the Amiga's icon system to it's fullest.  If I can be of
  666. any help in your usage of IE or icons then drop me a line.
  667.  
  668.     If you can think of extra functions that might be of benefit in IE or
  669. some ways IE's interface can be enhanced then please contact me and I will
  670. seriously consider your suggestions.  The best thing about ShareWare
  671. programs are that YOU can make input to them which might make your life,
  672. and somebody elses, a little easier.
  673.  
  674.     If you like IE, or even hate it, please contact me as well as I like to
  675. hear what others think about my efforts.
  676.  
  677.     I hope that this program is of use to you and if you like it give it to
  678. all of your friends.  Best wishes and happy Iconing...
  679.