home *** CD-ROM | disk | FTP | other *** search
/ Windows Shareware GOLD / NuclearComputingVol3No1.cdr / icons / f1347 / iedit.doc < prev    next >
Text File  |  1991-01-31  |  32KB  |  620 lines
  1.  
  2.                                    IEdit
  3.                                 Version 3.2
  4.  
  5.      Welcome to IEdit!  This new version is a minor revision of IEdit,
  6. and I hope you enjoy it.  New features include:
  7.  
  8. (Since IEdit 3.1)
  9.  
  10. * Ability to save an icon as a Windows mouse cursor
  11. * Checkerboarding colors selectable from CHART
  12. * Problem with non-standard icon files fixed
  13. * Minor problem with EXTRACT fixed
  14. * Updated mouse driver code
  15. * Added NEWS.TXT to explain latest features
  16.  
  17. (Since IEdit 3.0)
  18.  
  19. * LOAD now supports the .ico extention as well as .icn
  20. * IExtract is now built into IEdit
  21. * IEdit is now "Windows aware"
  22. * Esc exits at nearly any time
  23. * Marker in corner to denote being called from in Windows
  24. * Checkerboarding of two colors by using both buttons
  25. * Color chart shows combinations of all 16 colors with each other
  26.  
  27. (Since IEdit 2.2)
  28.  
  29. * Line, box and filled box drawing modes
  30. * Alt-H creates a hexadecimal icon text file for programmers
  31. * New license numbering allows the full version of IEdit as Shareware
  32. * Improved Help function is completely mouse driven
  33. * IExtract now allows graphic selection of the icon to extract
  34. * Significantly faster icon drawing during the LOAD function
  35. * 80286 specific code for faster execution throughout
  36.  
  37. (Since IEdit 2.0)
  38.  
  39. * New icon-based function selection
  40. * Invert Mask editing
  41. * Icon scrolling in any direction
  42. * A View function to preview your icon in a Windows-style dialog box
  43. * Graphic Load function lets you pick your icon visually
  44. * A "Best Guess" invert mask function
  45. * An "Undo" function
  46. * A built in file length check guards against viruses
  47. * A "Change a Color" function to alter a color over an entire icon
  48. * "Rotate" turns your icon 90° clockwise
  49. * A Grid for precise icons
  50. * A shell to DOS for quick jumps to the DOS command line
  51. * "Mirror" function makes symmetric icons easier
  52. * "Quick Help" for functions with a single mouse click
  53. * A scroll "Chain" to link or unlink icon and invert mask scrolling
  54.  
  55. *****************************************************************************
  56. * Be sure to try IInject, it allows you to permanently replace the icons in *
  57. * Windows applications with your own.                                       *                                                                           *
  58. *****************************************************************************
  59.  
  60.  
  61. ┌───────────────────────────────────────────────────────────────────────────┐
  62. │Quick Tip #1:                                                              │
  63. │You will find IEdit's Help functions contain much of the information below.│
  64. │IEdit's "Quick Help" pops-up when you click the right button on a function │
  65. │icon.                                                                      │
  66. └───────────────────────────────────────────────────────────────────────────┘
  67.  
  68.                                 Introduction
  69.  
  70.      IEdit is a full featured tool for creating and editing icons for the
  71. Microsoft Windows environment.  IEdit itself however, is a DOS application.
  72. As many users know, IEdit was released in two versions, a Shareware version
  73. (IEDIT.EXE), and an Enhanced version (IEDITE.EXE).  Now IEdit is released as
  74. a single version using License Numbers for registered users.  License numbers
  75. for version 3.0 or 3.0a will work with this version as well.
  76.  
  77.     IEdit was originally created for my own use, but caught on with the
  78. rapid growth of Windows 3.0, and now enjoys users from California to Austria!
  79. If you're curious about the technical aspects of IEdit and icons, read the
  80. Technical Information section at the end of this file.
  81.  
  82.  
  83.                              System Requirements
  84.  
  85. * Dos 3.0 or greater
  86. * A VGA system
  87. * Approximately 150k disk space (depending on number of icons)
  88. * At least 300k of free ram
  89. * 300-500k free disk space for swapping if SHELL feature is used
  90. * A Microsoft compatible mouse
  91. * At least a '286 based computer (AT or better).
  92. * Windows 3.0 (of course) to use your icons.
  93.  
  94. Users who have a different system setup may be able to obtain a special
  95. version of IEdit from me (e.g. An 8088 (XT class) version).
  96.  
  97.  
  98.                                Creating Icons
  99.  
  100.      Right off the bat I'd like to recommend you fire-up IEdit and give it
  101. a whirl.  I try to write programs that a user can figure out without the
  102. use of a manual.  Get a feel for it and come back to read the manual, you
  103. may discover features you never knew existed, but I hope you can figure
  104. the major features out without much trouble.
  105.      
  106.      First, start IEdit by typing "IEDIT" at the DOS prompt, be sure that
  107. you've loaded your mouse's driver program beforehand (Usually MOUSE.COM).
  108.  
  109.  ┌──────────────────────────────────────────────────────────────────────┐
  110.  │Quick Tip #2:                                                         │
  111.  │You can also load an icon into IEdit from the command line by typing: │
  112.  │  IEDIT <Icon-filename>                                               │
  113.  └──────────────────────────────────────────────────────────────────────┘
  114.  
  115.      The left side of your screen will have the main icon editing box.  The
  116. icons you create are actually a square of dots 32 by 32.  Each dot can be
  117. one of 16 colors (including black).  Icons also have another 32 by 32 square
  118. of dots (at the right center of IEdit) called an "invert mask".  You won't
  119. need an invert mask for most icons so we'll cover them later.
  120.  
  121.      Between the main icon area and the invert mask is a color bar
  122. containing the 16 colors you can choose from.  Select a color by moving the
  123. mouse pointer over a color and clicking the left mouse button.  Above the
  124. icon area the upper "Current" color box will reflect your choice.  You can
  125. select a second color with the right button, it will appear in the lower
  126. "Current" box.  The idea here is pick a main (upper) color for drawing with
  127. the left button, and a secondary (lower) color for drawing with the right
  128. button.  I like to choose my icon's background color for the lower color,
  129. that way I can draw with the left button and erase with the right.
  130.  
  131.      You can now move the mouse pointer over to the main icon area and use
  132. the either mouse button to draw a single dot.  You can also hold the button
  133. and move the mouse to draw continuously.  In the upper left corner you'll
  134. notice a tiny version of the main icon area, this is the actual size of the
  135. icon you're drawing.  You'll want to check this box to insure that your
  136. icon isn't too detailed to be seen when it's finished.  If you're trying to
  137. be precise you'll find the coordinate display (also above the main icon
  138. area) helpful, as well as the GRID function which puts a grid over the icon
  139. area (using your current upper color).
  140.  
  141.      When you start drawing, the main icon area is black, so you can erase
  142. any mistakes by choosing the color "Black" from the color bar.  Later
  143. you'll see that you can start with any color you choose as the background,
  144. and then you'll need to use that color to "erase" a mistake.
  145.  
  146.      Once you've created a suitable icon, choose VIEW from the function
  147. icons at the bottom.  You'll see a small Windows-like box in the center of
  148. the screen.  This is the way your icon (including the invert mask, if any)
  149. will look inside Windows, click either mouse button to erase the View box.
  150.  
  151.  
  152.                         Saving and Loading icons
  153.  
  154.      You'll need to save your icon to a file in order to use it in Windows.
  155. If you're editing a previous icon, just choose SAVE and IEdit will
  156. replace the old icon file with the new one you're editing.  If you choose
  157. SAVE TO, or if you haven't previously saved the current one, you'll be
  158. prompted for a file name.  Type a name for your icon and press enter. IEdit
  159. will give your file name the extention "icn" if you don't specify one.  
  160.  
  161.      When you want to edit an icon, choose LOAD from the function bar.
  162. You'll be presented with a screen with all the icons in the current
  163. directory.  Just click on the icon you want to edit.  You can choose
  164. CANCEL to go back without loading an icon.  You can also choose NEW DIR
  165. and you'll be prompted for a new directory path.  BE SURE and give the full
  166. path (i.e. Drive etc.) such as "C:\Windows" or "C:\Icons".  If you know the
  167. name of the icon you want to edit, choose LOAD FROM, it will prompt you for a
  168. specific file name to edit.
  169.  
  170.  
  171.                          More editing functions
  172.  
  173.      IEdit has four drawing modes, DRAW, LINE, BOX and FILLED BOX.  A
  174. summary of each mode is below:
  175.  
  176.  ┌───────┬───────────────┬──────────────┬──────────────┬───────────────────┐
  177.  │MODE ->│ DRAW          │ LINE         │ BOX          │ FILLED BOX        │
  178.  ├───────┼───────────────┼──────────────┼──────────────┼───────────────────┤
  179.  │       │               │      │       │   ┌─┼─┐      │     ┌─┼─┐         │
  180.  │Pointer│ (Arrow)       │  ────┼────   │ ──┼─┼─┼──    │   ──┼─█─┼──       │
  181.  │       │               │      │       │   └─┼─┘      │     └─┼─┘         │
  182.  ├───────┼───────────────┼──────────────┼──────────────┼───────────────────┤
  183.  │Draws  │ Freestyle     │ Line between │ Box between  │ Filled box between│
  184.  │       │               │ two points   │ two corners  │ two corners       │
  185.  ├───────┼───────────────┼──────────────┼──────────────┼───────────────────┤
  186.  │Button │ Left or Right │ Left         │ Left         │ Left              │
  187.  │to use │               │              │              │                   │
  188.  └───────┴───────────────┴──────────────┴──────────────┴───────────────────┘
  189.  
  190.      Notice that your mouse pointer will change to alert you of the current
  191. drawing mode.
  192.  
  193.      The DRAW mode allows you to draw single dots wherever you move the
  194. mouse.  You may use the left button to draw with the upper current
  195. color, or the right button to use the lower current color.  You can also
  196. hold either button to draw continuously.  Hold both buttons to "checker-
  197. board" an area with the upper and lower colors.
  198.  
  199.      The LINE mode lets you draw lines by selecting two points, the first
  200. point will be marked when you click the left button.  When you click the
  201. left button a second time, a line will be drawn between the two points.
  202.  
  203.      The BOX mode lets you draw boxes similar to the line mode except
  204. that instead of selecting points with each mouse click, you are
  205. selecting the corners of a box.
  206.  
  207.      The FILLED BOX mode works exactly like the box mode except that the
  208. box drawn is filled in with the current (upper) color.
  209.  
  210.  ┌──────────────────────────────────────────────────────────────────────┐
  211.  │Quick Tip #3:                                                         │
  212.  │You may change your color choice in the middle of drawing a line, box │
  213.  │or filled box by simply selecting the new color before clicking on the│
  214.  │second point or corner.                                               │
  215.  └──────────────────────────────────────────────────────────────────────┘
  216.  
  217.      The "buttons" along the edges of the main icon area will scroll the
  218. icon toward that edge, click on them to scroll your icon.  Likewise, the
  219. buttons below the invert mask are used to scroll it.  The CHAIN function
  220. allows you to link the two so that when you scroll either the icon or the
  221. invert mask, both will scroll.  Click on the CHAIN icon and you'll see
  222. tiny links appear on it, click again to unlink.
  223.  
  224.      The INVERT function lets you invert the colors in your icon.  The
  225. invert function is easier to use than to explain, so just try it.  You can
  226. un-invert the colors by simply selecting INVERT a second time.
  227.  
  228.      The CLEAR function will clear both the icon and the invert mask,
  229. and start over.  IEdit won't let you lose your work by clearing or loading
  230. without prompting you.  You'll see the message "Abandon this icon ([Y]/N)",
  231. you can press the right button for "Yes" or the left for "No", or press Y
  232. or N.  The CLEAR TO function is similar to the clear function except that it
  233. clears the icon to the "Current" selected color (instead of black).  The
  234. MOUSE icon lets you increase or decrease the sensitivity of your mouse.
  235. Click and hold on the right button to increase the sensitivity, or on the
  236. left button to decrease it.  You'll hear a rising or falling tone also.
  237. You may need to experiment to find the proper setting.
  238.      The CHG A CLR ("Change a color") function is simple.   First, click on
  239. the color in the color bar that you wish to change.  Second click on the
  240. CHG A CLR icon, then click on your new color choice.  The first color will be
  241. replaced by the second throughout the icon.
  242.  
  243.  ┌──────────────────────────────────────────────────────────────────────┐
  244.  │New Feature (to version 3.1):                                         │
  245.  │Now you can "dither" two colors by pressing and holding BOTH mouse    │
  246.  │buttons and filling in an area.  IEdit will alternate between the     │
  247.  │upper and lower current colors, checkerboard style.  Try it!          │
  248.  └──────────────────────────────────────────────────────────────────────┘
  249.                                                
  250.      The ROTATE function simply rotates your icon 90° clockwise.
  251.  
  252.      The MIRROR function erases the right side of your icon and replaces it
  253. with a mirror image of the left side.  By using ROTATE and MIRROR you can
  254. easily make icons that are symmetric horizontally, vertically or both.
  255.  
  256.  ┌───────────────────────────────────────────────────────────────────┐
  257.  │Quick Tip #4:                                                      │
  258.  │If your planning to draw an icon with a symmetric border around it,│
  259.  │the rotate and mirror functions can save you some time.            │
  260.  └───────────────────────────────────────────────────────────────────┘
  261.      The UNDO function returns your icon to its state before the last
  262. function was executed (except LOAD).  You cannot undo manual drawing you have
  263. done.  You can use UNDO again to go back to the state before the first UNDO.
  264.  
  265.      The EXTRACT function lets you extract icons from Windows applications.
  266. Click on the EXTRACT icon, then give the path and filename of the Windows
  267. application whose icon you want.  EXTRACT will search through the file
  268. looking for icons.  When it finds one it will ask if it has found the correct
  269. icon.  If it is, the icon and its invert mask will be copied into IEdit as
  270. if you had drawn it, you can save it to a file, or edit it or whatever.
  271.  
  272.     ┌──────────────────────────────────────────────────────────────────┐
  273.     │New Feature (to version 3.2):                                     │
  274.     │If you choose SAVE TO and give a filename with the extention CUR, │
  275.     │Your icon will be saved as a Windows cursor resource file.  Since │
  276.     │cursors are monochrome, any colors in the icon will be interpreted│
  277.     │as white.  White areas in the invert mask define transparent areas│
  278.     │in a cursor.  You'll need a seperate program to make use of this  │
  279.     │cursor file.                                                      │
  280.     └──────────────────────────────────────────────────────────────────┘
  281.  
  282.      IEdit will recognize any 766-byte 16 color icon file, regardless of
  283. ICO, ICN, etc. extention.  The LOAD function will only display the *.IC?
  284. files.  A file named with an ICO or ICN extention that is NOT 766 bytes will
  285. be displayed as a question mark.
  286.  
  287.      Another program, called IInject, will let you replace the icon in a
  288. Windows application with one of your own.  See the end of this file for
  289. details, or check your local bulletin board.
  290.  
  291.  ┌─────────────────────────────────────────────────────────────────────┐
  292.  │Quick Tip #5:                                                        │
  293.  │Whenever you see the "Abandon this icon (Y/N)?" prompt, you can click│
  294.  │the RIGHT mouse button for "Yes" or the LEFT for "No".               │
  295.  └─────────────────────────────────────────────────────────────────────┘
  296.  
  297.                             About Invert Masks
  298.  
  299.      Invert masks are a smaller version of an icon.  They do not use
  300. colors, each dot in an invert mask is either on (white) or off (black).
  301. When Windows is DISPLAYING (not moving) an icon, it uses the dots as a mask
  302. to determine where on the main icon to invert the colors.  My experience
  303. has been with VGA systems, other (particularly monochrome) systems may
  304. behave differently.  Most often you'll want to make the black portions of
  305. your icon inverted, this will make them the same as the background color
  306. in Windows.  This point bears repeating, if an icon has a black area, you
  307. can make that area transparent by drawing an invert mask for the black
  308. portion.
  309.  
  310.      For example:  Suppose you create two icons, both with red blocks at
  311. the center.  You make them nearly identical two different ways.  You can
  312. put a white background on one (example 1 below), and leave the other black,
  313. but give it an invert mask around the block (example 2).  This will invert the
  314. black to white in Windows.  So, you wind up with two icons that look
  315. identical; until you move them. Then you'll see that the one without the
  316. invert mask has a white area that runs over whatever you're moving over, in
  317. contrast the invert mask icon won't.  In addition, the inverted icon will
  318. change its background to the same as Windows', while the uninverted one will
  319. stay white.  In some cases, the invert mask icon will invert the colors behind
  320. it.  I realize this is difficult, I suggest you make a few icons for yourself
  321. and try them out.
  322.  
  323.      The red tracer will appear to guide you if you manually edit an invert
  324. mask (it moves with you over the main icon).  Be sure and try the GUESS INV
  325. function first.  Also be sure to use the VIEW function, it uses the invert
  326. mask information in its display (The icon in the upper left corner does not).
  327.  
  328.             Example 1          ║           Example 2
  329.                                ║
  330.     ┌─────────┐  ┌─────────┐   ║   ┌─────────┐  ┌─────────┐
  331.     │██White██│  │         │   ║   │ (Black) │  │██White██│
  332.     │█▒▒▒▒▒▒▒█│  │         │   ║   │ ▒▒▒▒▒▒▒ │  │█       █│
  333.     │█▒▒RED▒▒█│  │ (Blank) │   ║   │ ▒▒RED▒▒ │  │█       █│
  334.     │█▒▒▒▒▒▒▒█│  │         │   ║   │ ▒▒▒▒▒▒▒ │  │█       █│
  335.     │█████████│  │         │   ║   │         │  │█████████│
  336.     └─────────┘  └─────────┘   ║   └─────────┘  └─────────┘
  337.        icon      invert mask   ║      icon      invert mask
  338.      ┌──┴─────────────┘        ║        └────────────┴──┐
  339.      │                         ║                        │
  340.      │                         ║                        │
  341.      │    ┌─────────┐          ║         ┌─────────┐    │
  342.      │    │██White██│          ║         │██White██│    │
  343.      │    │█▒▒▒▒▒▒▒█│          ║         │█▒▒▒▒▒▒▒█│    │
  344.      └─>  │█▒▒RED▒▒█│          ║         │█▒▒RED▒▒█│  <─┘
  345.           │█▒▒▒▒▒▒▒█│          ║         │█▒▒▒▒▒▒▒█│
  346.           │█████████│          ║         │█████████│
  347.           └─────────┘          ║         └─────────┘
  348.            resulting           ║          resulting
  349.              icon              ║            icon
  350.    (in Windows or with VIEW)   ║  (in Windows or with VIEW)
  351.                                ║
  352.     ∙ Background always white  ║   ∙ Background same as screen's
  353.  
  354.  ┌────────────────────────────────────────────────────────────────────────┐
  355.  │Programmer's Tip:                                                       │
  356.  │Pressing Alt-H will create a hex text file of the current icon (with the│
  357.  │extention ".HEX").  This may be useful for including an icon within     │
  358.  │source code.                                                            │
  359.  └────────────────────────────────────────────────────────────────────────┘
  360.  
  361.                           About License Numbers
  362.  
  363.      IEdit has changed it's style, instead of distributing a Shareware
  364. version freely and an Enhanced version to registered users, a single
  365. version is distributed and registered users obtain a License number that
  366. removes the "annoyware" displays (and relieves their conscience).
  367.  
  368. Registered users should be aware that the License number is unique to
  369. them and "pirated" versions found will identify the offender.  In
  370. addition, the License number is coded and permanently "installed" in 
  371. IEdit, and cannot be changed.
  372.  
  373.  
  374.                               How to order
  375.  
  376.      First print out the file "ORDER.FRM" and fill it out.  Mail it to
  377. me with a check for $8 (or $10 if you want IEdit shipped).  BE SURE TO
  378. INCLUDE YOUR PHONE NUMBER!  I'll need it (as well as a best-time-to-call)
  379. in order to give you your License number.
  380.  
  381.      If you no longer have the order form, simply send me your name,
  382. address, telephone number and (heh heh) a check, so I can call you and give
  383. you your License number.
  384.  
  385.  
  386.                            Pricing Information
  387.  
  388.           Product     Price
  389.           ───────     ─────
  390.           IEdit        $8       (Add $2 S&H if you don't wish to have
  391.           Updates      $4       me call for your License number.)
  392.  
  393.      Dollar amounts are U.S. funds.  Checks or money orders only; not
  394. responsible for cash lost in shipping.  Add $2 to total for shipping to UK
  395. and Europe.
  396.  
  397.      Minor revision updates (e.g. from 2.0 to 2.2) are free by modem to
  398. registered users.  Registered users are notified when the next major version
  399. is available.  Most orders shipped within 48 hours.  Checks are not cashed
  400. until product is shipped or License number given.  IEdit is guaranteed to
  401. perform reasonably, if you have a problem that cannot be solved, return
  402. any shipped materials within 10 days for a full refund of purchase amount.
  403.  
  404.  
  405.  
  406.                   Notes on recovering from errors and bugs
  407.  
  408. * Mouse trouble...  Since the beginning I've had trouble with mice.  In
  409. every case so far the problem has been one of these two:
  410.  
  411.   1) An "old" mouse driver, If your mouse is truly "Microsoft" compatible,
  412.      you should be able to use Microsoft's MOUSE.COM driver with it.  You
  413.      received a copy of MOUSE.COM with Windows, if you have trouble, use
  414.      the EXPAND utility that also comes with Windows to uncompress and try
  415.      MOUSE.COM.  Or, contact your manufacturer for a mouse driver update.
  416.   2) Mouse Systems mice, by far the most trouble-laden mouse I've seen,
  417.      "standard" calls to its (supposedly compatible) driver simply don't
  418.      work.  Again you could try contacting Mouse Systems for a new driver,
  419.      but I can't justify re-writing major code to accommodate a single
  420.      brand, particularly when el-cheapo $25 mice seem to be able to be
  421.      100% Microsoft compatible.  So there <grin>.
  422.  
  423. IEdit has been tested with the following brands:  Microsoft, Logitech, IBM,
  424. Genius, Emerson, and more.
  425.  
  426. * If you crash or run a TSR during a SHELL, the IEdit swap file will remain
  427. on your disk, it's a hidden file called "$IEDSWAP.AAA".  IEdit places it in
  428. the directory specified by your TEMP environment variable (in your autoexec),
  429. or in the current directory if a TEMP is unavailable.  Be sure and delete this
  430. file if this happens as it will take up about 512k of disk space and will
  431. cause errors the next time you use SHELL.  Use Norton Commander, PC Tools or
  432. a similar product to delete it.  * Be carefull! *  You will lose your work if
  433. you crash the system during a SHELL.
  434.  
  435. * If you're running IEdit from a DOS Window in Windows 3.0, IEdit is now
  436. "Windows aware" and won't allow you to use the SHELL function.
  437.  
  438. * It's possible that you have just enough free memory to load IEdit itself,
  439. but not enough for one of IEdit's functions.  IEdit traps for this, but I've
  440. been unable to test it.  In any case your current icon should be saved as
  441. "IEDITERR.ICN".
  442.  
  443. * Please let me know if you find any other annoyances/bugs.
  444.   ^^^^^^^^^^^^^^^^^^
  445.  
  446.  
  447.                          Notes on Version 3.2
  448.  
  449. * LOAD now recognizes any file with the extention *.ic?, this allows icon
  450. files named .ICN, .ICO, etc.  By the way, in a technical sense, .ICO is the 
  451. proper name for what Windows calls an "icon resource file", to be used when 
  452. compiling a Windows application.  An icon resource file need not be the 
  453. "garden variety" 766-byte file, there are different icon formats and sizes.
  454. This is why IEdit, and at least one other icon editor, use the .ICN 
  455. extention, to designate a 766-byte, 32x32x16 icon file with invert mask.
  456.  
  457. * The upper right-hand corner will be filled in if you run IEdit from
  458. Windows ('386 or Standard mode).  This is just there as a reminder.
  459.  
  460. * A new dithering scheme is available.  Many interesting colors can be
  461. "made" by combining two of the 16 you have to work with.  Since this
  462. "checkerboarding" is tedious, IEdit lets you do it easily.  Simply choose
  463. the two colors you want to draw with (DRAW mode only) and press and hold
  464. BOTH mouse buttons, then move the mouse and fill in the area.
  465.   
  466. * You no longer need be in the same directory as IEdit to call it.  The 
  467. associated .OVL files must be in the same directory as IEdit though.  This 
  468. was a user suggestion that I simply never noticed before (See, your 
  469. suggestions make a difference!).
  470.  
  471. * The annoying flicker of the mouse pointer while in the invert mask area 
  472. was eliminated, but has returned with a vengance for various technical and
  473. generally stupid reasons - I'm working on it.
  474.  
  475. * IEdit is now "Windows Aware", in other words, it knows when it is being run
  476. from a DOS window.  IEdit uses this to prevent the use of the SHELL function, 
  477. which would cause trouble from within a DOS window.
  478.  
  479. * IEdit now allows ESC to exit at nearly any time.  This became useful when
  480. my mouse went on the fritz and I discovered that I had to reboot to exit my 
  481. own program!
  482.  
  483. * The icons-per-directory limit has again been raised, and is now 504.  The
  484. reason for this limit is simply a matter of space.  504 icon filenames times
  485. 13 bytes per name is over 6k of space.  With 504 there is room for 6 pages of
  486. icons.  Again, this was at user suggestion.
  487.  
  488.  
  489.                   Technical and Miscellaneous Information
  490.  
  491. * IEdit itself was created with Microsoft's QuickPascal and now stands at
  492. roughly 3000 lines of code.  Despite the fact that IEdit had to overcome
  493. at least three bugs in QP, I still can't recommend it more highly.  The
  494. editor is very similar to Notepad (and indeed all MS products) and the
  495. Help is amazing (the manual rarely leaves the shelf).
  496.  
  497. * The 766 byte icon file format is tricky at best, it is in three parts.
  498. A 126 byte header tells Windows what it is and color info, bitmap size, etc.
  499. Next is the "main" icon, 512 bytes (2 pixels per byte x 1024 pixels).
  500. Then a 128 byte block (32 x 32 x 1 bit/pixel) defines the invert mask.
  501. An early bug that made it's way into several icon editing programs,
  502. (ICONDRAW in particular apparently started the bug) and one icon
  503. distributed with IEdit v 0.9 (beta) actually caused Windows to give an
  504. "Unrecoverable Application Error" immediately after it was used, but
  505. only in '386 Enhanced mode.  This has been eliminated by the offending
  506. programs, and IEdit's icons are fine.  In fact, IEdit can be used to
  507. "clean" those offending icons, by simply loading the icon and then
  508. saving it back again.  IEdit forces the correct header onto every icon
  509. file it saves.
  510.  
  511. * Why VGA only?  Well not entirely due to a lack of EGA graphic
  512. capabilities, but more due to a lack of similar TEXT modes between the
  513. two.  Keeping 640x480 and 640x350 straight is tricky enough without
  514. dealing with text as well.  Ignoring that, EGA simply looks bad with
  515. 25% less resolution.  Also, most Windows users have a VGA anyway.  The
  516. same applies to mice and '286 specific code.
  517.  
  518. * Astute readers may have figured out that IEDIT3.OVL is really just the
  519. upper menu bar.  It is never executed, but I named it with the .ovl extention
  520. to insure it would be included if someone was copying files around their
  521. hard disk.  IEdit will crash without it.  Also, IEDIT31.OVL is actually a
  522. screen image of the icon function bar.
  523.  
  524. * Why is it so cheap?  I'm a college student (Computer Information
  525. Sciences major, wanna hire me next year?  Please?) and I've done more than
  526. my share of "leeching" the Shareware market, so I priced IEdit so that I
  527. could have afforded to register it.  Also, I love writing software.  But
  528. the best result thus far has been getting letters (and checks) from all over
  529. the WORLD(!).  I'd also like to thank people who called and wrote with
  530. comments and suggestions, they are reflected in this version.
  531.  
  532. * My address: James Bell  4511 Sherwood Trace  Gainesville, Fl  32605.
  533. or call me at (904) 372-3695.
  534.  
  535. * Windows and QuickPascal are TM's of Microsoft Corp.
  536.  
  537. * Many thanks to Tom Wagner and (of course) Dr. Dobbs for the swap-to-
  538. disk ideas and examples.
  539.  
  540.  
  541.               About the "I" series
  542.  
  543.      The "I" program series includes several programs to create, edit,
  544. manage, and even "steal" icons.  IEdit and IDir require a VGA and mouse,
  545. IExtract and IInject require at least an EGA.  All of the "I" series of
  546. programs require an 80286 or better processor.
  547.  
  548.  *   IEdit - The Icon Editor
  549.      -----------------------
  550.      The core of the "I" series, IEdit is a feature-packed icon creation
  551.      and editing tool.  Functions like Mirror, Invert, Grid, and more
  552.      separate IEdit from the other icon editors.  IEdit is being used
  553.      across the U.S. by individuals, corporations, universities, as well
  554.      as in Europe and the U.K.
  555.  
  556.  *   IExtract
  557.      --------
  558.      IExtract lets you look inside of your favorite Windows programs and
  559.      "steal" their icons for editing or use elsewhere.
  560.      This is now been built into IEdit as the EXTRACT function.
  561.  
  562.  *   IInject
  563.      -------
  564.      The companion to IExtract, with IInject you can permanently replace
  565.      the icon in a Windows application with your own.  You can even change
  566.      those annoying "Group" and "DOS" icons in Windows itself.
  567.  
  568.  *   IMenu
  569.      -----
  570.      IMenu lets you use your Windows 3.0 icons to create a DOS menu system.
  571.      No mouse is needed and IMenu supports EGA, VGA and Hercules.  An 8088
  572.      (PC/XT) version is available.
  573.  
  574.  *   IDir
  575.      ----
  576.      IDir gives you point-and-shoot icon file deletion so you can keep
  577.      track of icons easily.
  578.  
  579.  *   ISetCRC, IStrip, and ICheck
  580.      ---------------------------
  581.      For managing icons, these utilities help track down duplicates by using
  582.      a CRC value to find identical icons.
  583.  
  584.  
  585.  
  586.                              Availability
  587.  
  588.     Many of the above programs are available as Shareware from bulletin
  589. boards and Shareware houses.  You'll have to endure some "annoyware" screens
  590. with the Shareware versions, but all of the features are available.
  591.  
  592.     To register any of the "I" series, simply send me a check:
  593.  
  594.     James Bell
  595.     4511 Sherwood Trace
  596.     Gainesville, Fl.  32605
  597.     (904) 372-3695
  598.  
  599.     You can print and use the included file ORDER.FRM for orders, if you
  600.     no longer have it, please be sure to include an address and phone 
  601.     number.
  602.   
  603.  
  604.                               What's next?
  605.  
  606. Any other features added to future versions of IEdit will depend almost
  607. completely on user suggestions.  As-is IEdit has more features than any
  608. other icon program I've seen, and about all that's left is to make it a
  609. Windows application.  But (sigh) I simply don't have the $315 for the
  610. Windows SDK.  So, if you wanted to instantly become my best friend in
  611. the entire world....
  612.  
  613. I am working on a graphic-based manual viewer.  The idea is to let a
  614. program's doc file include instructions for drawing EGA graphics.  The
  615. result will be a doc file with pictures for better explanation, all within
  616. a nice graphic, mouse-aware environment.
  617.  
  618. Thanks again, good luck, and happy Windows-ing!
  619. James Bell                                                     2/19/91
  620.