home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 447.lha / IE_v2.0 / IE.doc < prev    next >
Encoding:
Text File  |  1990-12-08  |  15.4 KB  |  366 lines
  1.                ***********************************************************
  2.                * IE - THE COMPLETE ICON EDITOR             (version 2.0) *
  3.                ***********************************************************
  4.  
  5.                                                    by Peter Kiem
  6.                                                       3 Beazley Crescent,
  7.                                                       Calwell A.C.T. 2905
  8.  
  9.  
  10.  
  11.   DISCLAIMER:
  12.  
  13.         You have the right to freely use, copy and distribute this program
  14.   as long as the following conditions are met:
  15.  
  16.         1.  The program and documentation are not modified in any way;
  17.         2.  The program is not used or included in any package for  profit
  18.           unless written consent from the author is obtained.
  19.  
  20.         NOTE: The author does not accept any responsibility for any damage
  21.         that might result from the use of this program.
  22.  
  23.   Please note that this program is now released as SHAREWARE!!!
  24.  
  25.         If  you like this program and use it please send a small  donation
  26.   of  around A$10 to support my programming efforts.  You will then get  a
  27.   registered copy of the program and further updates for free.
  28.  
  29.         Registered users can get a copy of the Source Code for A$20.
  30.  
  31.  
  32.  
  33.   FROM THE AUTHOR:
  34.  
  35.         Now we have dispensed with all the boring legal stuff, we can  now
  36.   get down to the interesting stuff:
  37.         I  am a CSO2 programmer with the Commonwealth  Public  Service.  I
  38.   own  an  Amiga 500 with 3 Meg memory, A590 Hard Drive  and  an  external
  39.   floppy drive.  The compiler I own is Manx Aztec C version 5.0b.
  40.         I  wrote  IE  mainly as an exercise in learning Amiga  C,  but  it
  41.   started  out  with  a dissatisfaction with the  supplied  icon  programs
  42.   (ICONED and ICONMERGE).  I was disgusted with the fact that  dual-render
  43.   icons (icons that change picture when selected) could only be created by
  44.   using ICONED to make two icons and ICONMERGE to join the icons together.
  45.   ICONED also did not allow you to edit the dual-render icons so  created.
  46.   I  also have some large icons from off the public domain which were  too
  47.   large to be edited with ICONED.
  48.         I  then  resolved to create an icon editor with  all  conceiveable
  49.   icon functions with the capability of creating REALLY LARGE  dual-render
  50.   icons.
  51.         I  hope  that you find this program useful and you include  it  on
  52.   your system as a replacement to ICONED.
  53.  
  54.  
  55.  
  56.   FEATURES OF IE:
  57.  
  58.         IE has the following abilities:
  59.  
  60.         - Can create icons up to 640x200 pixels.
  61.         - Handles creation and editing of dual-rendered icons.
  62.         - Uses scroll bars for ease of moving around icon bitmap.
  63.         - Icon preview function allows you to see what your icon will look
  64.           like without leaving the program.  Any changes made to the  icon
  65.           bitmap can be seen immediately in the preview.
  66.         - Detaches from CLI for background running.
  67.         - Able  to  edit miscellaneous aspects of the icon  including  the
  68.           aspects edited by the WorkBench menu item "INFO"
  69.                 - Icon Type (DISK/DRAWER/PROJECT/TOOL/GARBAGE)
  70.                 - Icon Select Highlight (COMPLEMENT/BACKFILL/ALTERNATE PIC)
  71.                 - Position of Icon (including FIND BEST POSITION)
  72.                 - Stack Size (for project and tool icons)
  73.                 - Default Tool (for disk and project icons)
  74.                 - Definitions of up to 10 Tool Type strings
  75.                 - Size  and  placement of opened window (for  disk,  drawer
  76.                   and garbage icons).
  77.         - Flood fill colouring.
  78.         - Iconify to shrink windows.
  79.         - Write Icon as C Code so your programs can write their own icons.
  80.           (Can also be used to generate C Code for images so you can use IE
  81.            to create gadget images and save them as C Code for inclusion in
  82.            your programs).
  83.  
  84.         ADDED IN VERSION 1.1
  85.  
  86.         - Key shortcuts to menus.
  87.         - Read IFF picture into current icon image.
  88.         - Set the colours of the window opened by the icon.
  89.  
  90.         ADDED IN VERSION 1.2
  91.  
  92.         - Write  icon as IFF picture to allow the use of more  sophisicated
  93.           packages' editing (e.g. DPaint).
  94.  
  95.         ADDED IN VERSION 2.0
  96.  
  97.         - Automatically detects how many colours your               ***********************************************************
  98.                * IE - THE COMPLETE ICON EDITOR             (version 2.0) *
  99.                ***********************************************************
  100.  
  101.                                                    by Peter Kiem
  102.                                                       3 Beazley Crescent,
  103.                                                       Calwell A.C.T. 2905
  104.  
  105.  
  106.  
  107.   DISCLAIMER:
  108.  
  109.         You have the right to freely use, copy and distribute this program
  110.   as long as the following conditions are met:
  111.  
  112.         1.  The program and documentation are not modified in any way;
  113.         2.  The program is not used or included in any package for  profit
  114.           unless written consent from the author is obtained.
  115.  
  116.         NOTE: The author does not accept any responsibility for any damage
  117.         that might result from the use of this program.
  118.  
  119.   Please note that this program is now released as SHAREWARE!!!
  120.  
  121.         If  you like this program and use it please send a small  donation
  122.   of  around A$10 to support my programming efforts.  You will then get  a
  123.   registered copy of the program and further updates for free.
  124.  
  125.         Registered users can get a copy of the Source Code for A$20.
  126.  
  127.  
  128.  
  129.   FROM THE AUTHOR:
  130.  
  131.         Now we have dispensed with all the boring legal stuff, we can  now
  132.   get down to the interesting stuff:
  133.         I  am a CSO2 programmer with the Commonwealth  Public  Service.  I
  134.   own  an  Amiga 500 with 3 Meg memory, A590 Hard Drive  and  an  external
  135.   floppy drive.  The compiler I own is Manx Aztec C version 5.0b.
  136.         I  wrote  IE  mainly as an exercise in learning Amiga  C,  but  it
  137.   started  out  with  a dissatisfaction with the  supplied  icon  programs
  138.   (ICONED and ICONMERGE).  I was disgusted with the fact that  dual-render
  139.   icons (icons that change picture when selected) could only be created by
  140.   using ICONED to make two icons and ICONMERGE to join the icons together.
  141.   ICONED also did not allow you to edit the dual-render icons so  created.
  142.   I  also have some large icons from off the public domain which were  too
  143.   large to be edited with ICONED.
  144.         I  then  resolved to create an icon editor with  all  conceiveable
  145.   icon functions with the capability of creating REALLY LARGE  dual-render
  146.   icons.
  147.         I  hope  that you find this program useful and you include  it  on
  148.   your system as a replacement to ICONED.
  149.  
  150.  
  151.  
  152.   FEATURES OF IE:
  153.  
  154.         IE has the following abilities:
  155.  
  156.         - Can create icons up to 640x200 pixels.
  157.         - Handles creation and editing of dual-rendered icons.
  158.         - Uses scroll bars for ease of moving around icon bitmap.
  159.         - Icon preview function allows you to see what your icon will look
  160.           like without leaving the program.  Any changes made to the  icon
  161.           bitmap can be seen immediately in the preview.
  162.         - Detaches from CLI for background running.
  163.         - Able  to  edit miscellaneous aspects of the icon  including  the
  164.           aspects edited by the WorkBench menu item "INFO"
  165.                 - Icon Type (DISK/DRAWER/PROJECT/TOOL/GARBAGE)
  166.                 - Icon Select Highlight (COMPLEMENT/BACKFILL/ALTERNATE PIC)
  167.                 - Position of Icon (including FIND BEST POSITION)
  168.                 - Stack Size (for project and tool icons)
  169.                 - Default Tool (for disk and project icons)
  170.                 - Definitions of up to 10 Tool Type strings
  171.                 - Size  and  placement of opened window (for  disk,  drawer
  172.                   and garbage icons).
  173.         - Flood fill colouring.
  174.         - Iconify to shrink windows.
  175.         - Write Icon as C Code so your programs can write their own icons.
  176.           (Can also be used to generate C Code for images so you can use IE
  177.            to create gadget images and save them as C Code for inclusion in
  178.            your programs).
  179.  
  180.         ADDED IN VERSION 1.1
  181.  
  182.         - Key shortcuts to menus.
  183.         - Read IFF picture into current icon image.
  184.         - Set the colours of the window opened by the icon.
  185.  
  186.         ADDED IN VERSION 1.2
  187.  
  188.         - Write  icon as IFF picture to allow the use of more  sophisicated
  189.           packages' editing (e.g. DPaint).
  190.  
  191.         ADDED IN VERSION 2.0
  192.  
  193.         - Automatically detects how many colours your workbench is  running
  194.           with  and  allows  the   editing/conversion  of  icons  with  the
  195.           appropiate number of bitplanes (2-3 bitplanes).
  196.  
  197.  
  198.  
  199.   CALLING IE:
  200.  
  201.         IE  can  be run from either the workbench or from the CLI.  To  run
  202.   IE from the CLI the following call is used:
  203.  
  204.         IE [filename]
  205.  
  206.   where filename is an optional parameter which is the icon to load.
  207.   NOTE:  IT  IS  NOT NECESSARY TO HAVE THE .INFO IN THE FILENAME.  THIS  IS
  208.   REMOVED BEFORE LOADING THE ICON AS THE SYSTEM ROUTINES DON'T LIKE IT.
  209.  
  210.         When  calling IE from the workbench, if you select a  PROJECT  icon
  211.   before  activating  IE  (via SHIFT KEY-DOUBLE CLICK)  the  icon  will  be
  212.   automatically loaded into IE.
  213.  
  214.   **HINT**  To make a library of icons for use, save the icons as  PROJECTs
  215.   so  you can use the above method to automatically load IE with the  icon.
  216.   The icons can then be changed to the appropiate type and saved to its new
  217.   destination.  As  the  icons are projects you can also  set  the  DEFAULT
  218.   TOOL  to  IE (don't forget the path) and then by DOUBLE CLICKING  on  the
  219.   icon, IE will be loaded with the icon.
  220.  
  221.  
  222.  
  223.   ICONIFY FUNCTION:
  224.  
  225.         By  selecting ICONIFY from the IE menus, all IE windows are  closed
  226.   and  a small window is opened.  This allows you to get IE totally out  of
  227.   the  way temporarily.  This small window can then be dragged to  anywhere
  228.   on  the screen.  To un-iconify IE simply activate the window by  clicking
  229.   the  left  mouse  button  in the window and then click  the  right  mouse
  230.   button.  All IE windows will the be opened in the same place and size  as
  231.   before.
  232.  
  233.  
  234.  
  235.   PREVIEW WINDOW:
  236.  
  237.         By selecting PREVIEW from the IE menus, a preview window is opened.
  238.   This window displays the icon as it will appear on the workbench  screen.
  239.   By clicking the left mouse button in this window, the icon render  images
  240.   change simulating the action of selecting the icon.
  241.  
  242.  
  243.  
  244.   INFO EDIT WINDOW:
  245.  
  246.         By selecting EDIT INFO from the IE menus, a info-editing window  is
  247.   opened.  This  window  allows you to change the icon type,  icon  render,
  248.   tool types, default tool and size of opened window amongst other things.
  249.         In version 1.1 the ability to change the opened window colours  was
  250.   added.  By clicking in the coloured squares under Title Colour and Border
  251.   Colour you can select the colour to use.  Title colour is the colour used
  252.   to  render  the  text  in  the window title  and  Border  colour  is  the
  253.   background colour for the window borders.
  254.   NOTE:  You  must  reload the window containing the icon to  get  the  new
  255.   colours.
  256.  
  257.  
  258.  
  259.   CHANGING THE BITMAP:
  260.  
  261.         By clicking the left mouse button in the bitmap display on the left
  262.   side  of the main window, the selected pixel is changed to  the  selected
  263.   colour.  By  holding down the left mouse button and dragging the  pointer
  264.   you  can continuously draw in the bitmap.
  265.         When  the Flood Fill gadget is on, the action of clicking the  left
  266.   mouse  button  will  change  the area colour under  the  pointer  to  the
  267.   selected  colour.  It  probably is a good idea to save your  icon  BEFORE
  268.   doing a flood fill in case the area you selected wasn't properly  bounded
  269.   and  the  flood  fill  does more than  you  think.  Only  horizontal  and
  270.   vertical connections are checked for flood fill (diagonals are  ignored).
  271.         DON'T FORGET TO TURN OFF THE FLOOD FILL GADGET WHEN FINISHED!!!
  272.  
  273.  
  274.  
  275.   MOVING THE ICON BITMAP:
  276.  
  277.         By  selecting  the arrow gadgets, the icon  image  currently  being
  278.   displayed  is  moved 1 pixel within the bitmap editing display  to  allow
  279.   for expanding the size of the icon.
  280.  
  281.  
  282.  
  283.  
  284.   GENERATING C CODE:
  285.  
  286.         By  selecting  OUTPUT C CODE from the IE menus, the  icon  data  is
  287.   written to a file of your choice in the C language.
  288.         One use of this is for your programs to generate their own icons.
  289.  
  290.  
  291.   The following example shows how to write an icon to a file.  This assumes
  292.   you generated the C Code to a file called "c-code" and are generating the
  293.   icon "test.info":
  294.  
  295.         #include <exec/types.h>
  296.         #include <intuition/intuition.h>
  297.         #include <workbench/workbench.h>
  298.  
  299.         #include <functions.h>
  300.         #include "c-code";
  301.         extern struct IconBase *IconBase;
  302.  
  303.         void main()
  304.  
  305.         {
  306.           IconBase = (struct IconBase *)
  307.                      OpenLibrary("icon.library", LIBRARY_VERSION);
  308.           PutDiskObject("test", &Icon);
  309.           CloseLibrary(IconBase);
  310.           exit();
  311.         }
  312.  
  313.   You  can  also  use the generated C Code for any-size, 2 or  3  bit-plane
  314.   image.
  315.   For  example: you can draw the desired gadget pictures for  your  program
  316.   using  the  IE editor, generate the C Code to a file and  use  the  Image
  317.   definitions that were generated for use in your program.
  318.  
  319.  
  320.  
  321.   READ IFF PICTURE (version 1.1)
  322.  
  323.         By  selecting READ IFF from the IE menus, IFF pictures can then  be
  324.   read  into the icon image you are currently editing.  This can even  read
  325.   DPaint  brushes.  NOTE: If the picture (or brush) you load does not  have
  326.   colours that match the workbench colours, your picture will load with the
  327.   workbench colours and hence may not appear as it did in the IFF picture.
  328.  
  329.  
  330.  
  331.   WRITE IFF PICTURE (version 1.2)
  332.  
  333.         By  selecting WRITE IFF from the IE menus, the icon image  you  are
  334.   editing can be written out as an IFF picture.  You can then load this IFF
  335.   picture  into a package (like DPaint) for the more sophisticated  editing
  336.   controls  that those packages offer.  The IFF picture written  will  have
  337.   the same colours as did workbench.
  338.  
  339.  
  340.  
  341.   EIGHT COLOUR ICONS (version 2.0)
  342.  
  343.         When  IE is started it looks at the workbench to find out how  many
  344.   bitplanes  are  in  operation.  If  your  workbench  is  running  with  3
  345.   bitplanes then you will have up to 8 colours available for icons else you
  346.   will only have the standard 4 colours.
  347.         If  you  load a 2 bitplane icon while in 3 bitplane mode  the  icon
  348.   will be converted to allow the use of more colours.  A requester will  be
  349.   displayed to inform you if this happens.
  350.         If  you  load a 3 bitplane icon while in 2 bitplane mode  the  icon
  351.   will  be converted to use only the 4 standard colours.  A requester  will
  352.   be  displayed to inform you if this happens.  If the icon is  reduced  in
  353.   colours  there  may be a change in some of the icons colours due  to  the
  354.   loss  of the extra bitplane.  This function is useful to fix icons  which
  355.   look OK in 2 bitplanes but are corrupted in 3 bitplanes.
  356.  
  357.  
  358.  
  359.   FINAL NOTE:
  360.  
  361.         The  rest of the program I think is quite self explanatory  but  if
  362.   you require any help just contact me and I will help as much as I can.
  363.         I really hope that this program is of use to you and if you like it
  364.   give it to all of your friends.
  365.         Best wishes and happy Iconing...
  366.