home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / falcon / graphics / icdrawup / icdraw1.txt < prev    next >
Text File  |  1994-05-18  |  37KB  |  749 lines
  1. ----------------------------------------------
  2. ICDRAW  :  Icon Editor for the Falcon030
  3. Ver.    :  1.41
  4. Date    :  15 May 1994
  5. Author  :  W.D.Parks/Dr. Bobware
  6. ----------------------------------------------
  7. v1.42 05/18/94  Now works in 800x600 mode.
  8. v1.41 05/15/94  CharXY and ICO export CURED!
  9.  
  10. v1.40 05/08/94  Release version.
  11. v1.34 05/06/94  added all kinds of stuff!
  12.  
  13. v1.3  04/30/94  added menu bar and 'things'
  14.  
  15. v1.2  04/23/94  (added MS\Windows ICO i/o)
  16.                 
  17. v1.1+ 04/13/94  (window & more functions added)
  18.                 
  19. v1.1  04/12/94  (no bugs, just more functions)  
  20. v1.0  04/08/94 
  21. ----------------------------------------------
  22.  
  23.  
  24.                               ICDRAW  v1.42
  25.                         
  26.                          SHAREWARE from Dr. Bob
  27.  
  28.                              FALCON030  ONLY
  29.  
  30.  
  31.        "Wowee- what a spiffy-keeno little computer this Falcon is.
  32.      Sure wish I could have some different icons for the desktop."
  33.      
  34.        I said that over a year ago, in February 1993 when I first
  35.      powered up the Falcon. Time has past and still no sign of any-
  36.      thing that fits the bill.
  37.  
  38.        After a common fit of complaining about this and about that 
  39.      (we US devs do that a lot;-), I decided I'd sit down and write an
  40.      icon editor myself. But... Other projects took up my time. I still
  41.      kept an eye open for news of an icon editor or something akin to one. 
  42.       More months have come and gone and I'm still locked into using the
  43.      same icons as a year ago.
  44.      
  45.        Like several of my programming projects, this was designed out
  46.      of frustration. That old adage, "If you want something done right,
  47.      do it yourself" kept humming in my mind as I delved into what 
  48.      scant documentation was available for version 4 resource file
  49.      extensions and hammered out a Resource Viewer. With that I was
  50.      able to pinpoint exactly what and where the color icons were and
  51.      what format they were in and what that pseudo-C sample code was
  52.      trying to say. 
  53.  
  54.        From that comes ICDRAW.
  55.        
  56.        But before we get too involved in ICDRAW's biography, let's
  57.      take a moment to review a remedial step in this wide wonderful
  58.      world of computing:
  59.  
  60.       **************************************************************  
  61.                    KEEP A BACKUP of your important files.
  62.       **************************************************************
  63.          In this case we're talking about DESKICON.RSC. And, for
  64.          your convenience, backup the NEWDESK.INF along with it.
  65.       **************************************************************  
  66.  
  67.  
  68.        Ok, let's get back to our main story. When we last saw Dr. Bob
  69.      he was being held captive by the evil princess and her amazons
  70.      in the jungles of ... whoops! Sorry, wrong story.
  71.  
  72.        
  73.        There are some things you should know about how TOS4 works
  74.      before you start editing away:
  75.      
  76.        TOS 4 reads a file called DESKICON.RSC when it powers up. In
  77.      this file, among other things, are all the color and mono icons
  78.      that can be displayed on the desktop. TOS only reads this file
  79.      when it starts up (at power-on or after a reset). Any changes
  80.      made to the DESKICON.RSC file will not take effect until the
  81.      Falcon is reset.
  82.        TOS 4 determines which type of icons to use by checking the
  83.      video resolution.  Mono icons are used for all mono modes and
  84.      for 4-color modes.  The 16-color icons are used for all modes
  85.      with 16 or more colors  (ie 16-color mode, 256-color mode and
  86.      32k-color modes).
  87.  
  88.      
  89.      Unlike the normal mono icons, color icons are twin icons. The
  90.      first icon is what you normally see on your desktop. The second
  91.      is the 'selected' mode of the icon- it's displayed when the
  92.      icon is selected (officially called 'animation' [I just love it])
  93.      But you already know this- you've seen it on your Falcon.
  94.      
  95.       Desktop icons are 32x32 pixels... today. Tomorrow they may be
  96.      larger but I have no need for larger icons today and there is
  97.      no documentation that says, one way or another, whether todays
  98.      desktop _can_ or _cannot_ handle larger icons.
  99.      
  100.       The DESKICON.RSC file is theoretically capable of storing 4,
  101.      8, and 16 plane icons (even more... theoretically). As it comes,
  102.      with the Falcon, DESKICON.RSC contains only mono and 4-plane
  103.      icons. TOS converts these 4-plane icons for use in 8-plane modes
  104.      and for true-color modes. They work quite well too!
  105.       Some may claim that 256-color icons would be a big feather in
  106.      anyone's cap but on a 16MHz machine, I'll skip the feathers-
  107.      thank you very much ;-)
  108.      
  109.       DESKICON.RSC can also hold gobs of icons. As it comes with the
  110.      Falcon, there are 33 from which you can choose (notice the lack
  111.      of a dangling preposition;).
  112.  
  113.      
  114.       ICDRAW fits into those parameters. It can read a version 4 RSC
  115.      file and can edit any of the color icons found within. It does
  116.      NOT offer to ADD icons to the file nor to delete icons from it
  117.      (use RSC-XPAND for that).
  118.      It edits only icons that are the normal 32x32 pixels (both mono
  119.      and 4-plane [16-color] icons).
  120.      
  121.        To avoid any other compatibility issues, ICDRAW uses only the
  122.      VDI routines for drawing/editing. You'll notice the redraw time
  123.      is lengthy... well... lengthier than my normal custom editing
  124.      routines... thank the VDI for that, not me ;-)
  125.  
  126.       
  127.        update:  to speed up the fat-bit display, direct video writes
  128.                 have supplanted the older vdi vr_recfl routines in
  129.                 ICDRAW and have dramatically reduced the time needed
  130.                 to redraw the displays. So much so that I can't go
  131.                 back to the old way.
  132.      
  133.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  134.                   End preamble and long-winded oratory
  135.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  136.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  137.                    Start documentation and operation
  138.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  139.  
  140.      *****************************************************************
  141.       The standard caution: SAVE A COPY OF YOUR ORIGINAL DESKICON.RSC
  142.       file before you modify it.  If you later decide that the old
  143.       original icons better suit your needs then... you'll have them.
  144.      *****************************************************************
  145.  
  146.  
  147.  
  148.       With ICDRAW v1.3, a menubar is used. Many buttons have disappeared
  149.       from the edit dialog and now reside only in the menus.
  150.       
  151.              
  152.       ICDRAW starts up in edit mode.
  153.       
  154.       EDIT mode:
  155.       
  156.       Two large cells are displayed that will hold the icon and its
  157.       mask in a "fat-bit" or "zoomed" form.
  158.        
  159.       A 16-color palette is available from which to select pen colors.
  160.       
  161.       Three buffers are readily available for editing, two for color
  162.       and the last for mono. They are imaginitively labelled  MAIN, 
  163.       SELD and MONO. 
  164.       
  165.       A fourth buffer is used for copy/paste functions (it holds both
  166.       the icon and its mask).
  167.       
  168.       Since, when you first run ICDRAW, there are no icons in any of 
  169.       the buffers, you'll see none on the screen (wow! this is smart.)
  170.       
  171.       The lower left corner holds various common icon editing functions
  172.       such as clear mask/icon, fill mask/icon and cover mask. There are
  173.       also the standard flip, flop and rotate functions.
  174.       (as of v1.3, their location has moved but their functions remain)
  175.       The arrow buttons scroll... left, right, up or down by one pixel.
  176.  
  177.       (is this getting boring?)
  178.  
  179.       
  180.       Ok, let's move onto the big red buttons:
  181.                       ... and the blue buttons
  182.                       ... and the green buttons
  183.                       ... and the little teeny tiny grey buttons
  184.                       ... and the slightly red but still grey buttons
  185.                       ... (enter own Pythonish phrase here)
  186.  
  187.       Ohoh! The 'big buttons' are now gone. All file i/o is done via
  188.       the menus, including import/export, load/save, loadrsc,saversc,
  189.       grab/put and the new load_paste.
  190.       
  191.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  192.                             *****************
  193.                             ICON EDIT DIALOG:
  194.                             *****************
  195.  
  196.       RESOURCE FILE  Icon Extract/Replace
  197.       -----------------------------------
  198.       
  199.      (All file in/out routines are from the menu selections)
  200.      
  201.       GRAB <- RSC:    Will extract a set of icons from the desired RSC
  202.                       file (if none is selected then the file selector
  203.                       is provided). All three icons of the group are
  204.                       placed into the edit buffers (Main,Seld,Mono).
  205.                       Once a RSC file is loaded, it is retained in memory.
  206.       
  207.       STORE->RSC:     Will allow you to put the icon(s) back into the
  208.                       RSC file. The labels 'MAIN SELD and MONO' are
  209.                       active and indicate which icons will be stored.
  210.                       Usually, you'll want to store all three but if
  211.                       you want to only store one then you can de-select
  212.                       these buttons, writing only the desired icons
  213.                       back to the RSC file in memory.
  214.                       Point and click to the set of icons to be
  215.                       replaced with your newly edited ones.
  216.                       Once the icon is stored, you'll be placed back
  217.                       in GRAB mode, ready to select another icon to edit.
  218.                       If you want to continue editing the same icon,
  219.                       simply select cancel (ie [EDIT]).
  220.                       (Alt-Click on [STORE->RSC] will return to edit mode
  221.                        once the icon is stored without the need to click
  222.                        on cancel in the resource dialog.)
  223.                        
  224.       LOAD DESKICON:  Provides direct LOAD and SAVE of the DESKICON.RSC
  225.       SAVE DESKICON:  file. After loading a deskicon.rsc file, you'll
  226.                       remain in the resource dialog... ready to pick one
  227.                       of its icons for editing.
  228.                       If no resource file was loaded, you will not be able
  229.                       to SAVE DESKICON (of course)... even though the menu
  230.                       item still shows as if it is active.
  231.  
  232.  
  233.  
  234.       ICON(s)  Save/Load/Export/Import
  235.       --------------------------------
  236.  
  237.        SAVE ICON:     Save the currently selected icon (MAIN,SELD or
  238.                       MONO) to a diskfile for later use.
  239.        SAVE GROUP:    Save all three icons (Main,Seld and Mono) to a
  240.                       disk file for later use.
  241.  
  242.        LOAD ICON:     Load a single saved icon (from disk) into the
  243.                       currently selected buffer (MAIN,SELD,MONO). 
  244.        LOAD GROUP:    Load a group of three icons (as saved above).
  245.        
  246.        LOAD PASTE:    Will load an IBI (ie single icon) file into the
  247.                       paste buffer... this can save effort instead of
  248.                       loading an icon, copying it to the paste buffer
  249.                       and then loading another icon or group for
  250.                       editing.
  251.  
  252.        EXPORT:        Allows you to save single icons (and its mask)
  253.                       to a disk file. Options let you export the icon
  254.                       to either an assembly source file (both icon and
  255.                       mask data and both with their own MFDBs) or to a
  256.                       binary version in either the standard format or the
  257.                       device specific format of MFDBs.
  258.            (v1.2)      A binary CICON structure can also be exported.
  259.                       This format is identical to that used in the
  260.                       extended section of the DESKICON.RSC file.
  261.            (v1.2)      Exports current icon/mask to a Microsoft Windows
  262.                       ICO icon file. The Falcon's colors may not be an
  263.                       exact match for Windows colors (particularly the
  264.                       'darker' colors but they will be close to the Win
  265.                       defaults).
  266.                        Version 1.41 fixes a bug in the constructed ICO
  267.                       file. The height specified in the DIB heading is
  268.                       now doubled to 64 (instead of the expected 32).
  269.                        
  270.                       Note:
  271.                        'Device specific' indicates a video style format.
  272.                        'standard' indicates separate contiguous planes.
  273.                        If these terms confuse you then export an icon
  274.                        to both assembly source formats and view them.
  275.                        You'll see the difference in the way the image
  276.                        is stored. One is directly blit-able to a 4-plane
  277.                        video screen. The other has each plane stored
  278.                        separately.
  279.                       Note:
  280.                        In each export form, the mask is stored in its
  281.                        single plane or mono format (the MFDBs are set
  282.                        this way too... of course).
  283.  
  284.        IMPORT:        Only one import format is implemented in v1.2,
  285.                       the ICO Windows icon file format.
  286.                       This is preliminary and will only import the
  287.                       standard 766 byte ICO files with the correct
  288.                       header information (ie 1 icon, 32x32 pixels,
  289.                       and 16 colors... all presumed 'important colors').
  290.                       The RGBQUADS of the ICO icon are ignored (this
  291.                       _is_ a preliminary;-) and the default Window
  292.                       colors are used. 
  293.                       note: You may witness a slight difference in the
  294.                             'darker' colors when importing ICOs.
  295.  
  296.  
  297.  
  298.  
  299.       EDIT Tools
  300.       ----------
  301.  
  302.        COPY:          Copy the current icon (and mask) to the copy/paste
  303.                       buffer. Below the 'COPY' button, you'll see the
  304.                       icon that is now ready for pasting.
  305.        PASTE:         Take the icon (and mask) from the copy/paste buffer
  306.                       and paste it into the current icon (and mask).
  307.                       * see notes on pasting a color icon to a mono icon.
  308.       
  309.        FLIP H:        Flip the icon and mask Left-to-Right.
  310.        FLIP V:        Flip the icon and mask Top-to-Bottom.
  311.        ROTATE:        Rotate the icon and mask (on its center) by
  312.                       90 degrees, CCW.
  313.  
  314.        (arrows):      Scroll the icon and its mask 1 pixel, up, down,
  315.                       left or right.
  316.        
  317.        COVER:         Use the pixels in the icon to build a mask.
  318.                       Any non-white pixel found in the icon has its
  319.                       cooresponding pixel in the mask set to black.
  320.                       Likewise, all white pixels in the icon set the
  321.                       mask pixels to white.
  322.        OVERLAY:       Similar to COVER but only sets colors. White does
  323.                       not erase a bit in the mask.
  324.        .AND.          Use MASK as a mask <grin> to block-in the icon image.
  325.                       Any pixel in the icon image that is not covered by
  326.                       the mask will be erased.  
  327.        (mask)
  328.        CLEAR MASK:    Set all bits in the mask to white (ie no mask).
  329.        FILL MASK:     Fill all bits in mask with black (ie solid mask).
  330.  
  331.        (these have been relegated to the menu bar only)
  332.        FILL ICON:     Fill all bits in icon with black (ie black square).
  333.        CLEAR ICON:    Set all bits in the icon to white (ie no icon).
  334.        CLEAR BOTH:    Erase both icon and mask (ie neither).
  335.  
  336.  
  337.  
  338.        v1.1           Version 1.1 introduced the following items:
  339.        
  340.        ECHO:          Echo icon pixels in the mask. Gives a representation
  341.                       of the icon's pixels in the mask display, letting you
  342.                       easily see which mask pixels 'should' be set to black.
  343.  
  344.        GRID:          Displays a grid of points in both the icon cell and
  345.                       the mask cell, showing the exact pixel boundaries.
  346.  
  347.        CHG:           Allows you to change one color in an icon to another.
  348.                       A new dialog pops up over the icon cell and offers
  349.                       two color palettes. One for the color to be changed
  350.                       and one for the color it should be changed to.
  351.                       (drat- another dangling preposition)
  352.                       note:
  353.                       Attempting to change a color to itself confuses _me_
  354.                       but ICDRAW catches it and cancels the function ;-)
  355.  
  356.        BLK:  (v1.2)   Active only during MONO icon edit. Similar to above,
  357.                       will change all color pixels to black. 
  358.  
  359.        SWAP: (v1.2)   Swap MAIN and SELD icons (and masks). 
  360.  
  361.        CHXY: (v1.2)   Set CHAR x,y position in Icon. Draws a marquee
  362.                       Box that is movable with the mouse. Left click
  363.                       to set new position or right-click to cancel.
  364.                       
  365.                       Use the Alt-key and CHXY to bring up the manual
  366.                       edit mode for the parameters of the CICON header.
  367.                       You can edit the CHAR xy, the CHAR foreground and
  368.                       background colors, the ICON xy and the text label
  369.                       xy.
  370.                        At least in TOS 4.1, you must set the background
  371.                       to 0 (white). Other combinations are not condusive
  372.                       to a mello experience.
  373.                       The [RESET] button will fill all the parameters 
  374.                       with the default settings in case things get out
  375.                       of hand.
  376.                       The [MOUSE] button will let you use a drag box
  377.                       to place the CHAR xy (as without the Alt-key).
  378.                       (this info also stored in the saved icon files)
  379.                       
  380.                        The char xy, need NOT be set in most icons as
  381.                       TOS only uses it for icons assigned to a disk
  382.                       unit (A:,B:,C:,D:,E: etc). New icons default the
  383.                       char xy to 16,16 (icon center).  
  384.                        Even so, the original icons found in DESKICON.RSC
  385.                       already have their char xy set... no need to bother
  386.                       unless you want it moved.
  387.                        * v1.4, with its larger fat-bit display improperly
  388.                          calculated the X,Y. This is fixed in v1.41
  389.  
  390.   GREY/WHT/BLK/PATT:  Defines the background style for the icon group
  391.                       display (the set of 3 icons; lower right of form).
  392.                       Allows you to view all the icons on different types
  393.                       of backgrounds.
  394.                       GREY is the light grey (as in the form), WHT shows
  395.                       a white background, BLK shows a black background
  396.                       and PATT shows a 50:50 pattern (in color black to
  397.                       simulate mono mode but also shows an adequate pattern
  398.                       for color patterned desktops).
  399.                       
  400.                        Note: Some icons will look good (even fantastic) on
  401.                        the grey background but you'll find that many users
  402.                        use a pattern desktop even in color modes. Try to
  403.                        make your icon look good on the pattern background
  404.                        or make two sets of icons. One for desktops with
  405.                        a solid desktop background and one for a patterned
  406.                        background.
  407.  
  408.        TOOLS: (v1.34)  Provides for more tools, less frequently used than
  409.                        those in the main edit dialog (T is the keypress
  410.                        equivalent).
  411.                        
  412.                        
  413.             INVERT:    M RVS will invert the mask (black to white and
  414.                        white to black).
  415.                        I RVS will invert the icon.
  416.                        DK <--> LT will effectively exchange the dark
  417.                        and light colors in the icon (ie Bright red
  418.                        becomes Dark red and Dark red becomes bright
  419.                        red... the same for all hues)
  420.            
  421.             COMBINE:   FRONT will copy the icon that resides in the
  422.                        paste buffer over top of the current icon.
  423.                        White is not copied, only colors 1-15.
  424.                        BACK will copy the icon that resides in the
  425.                        paste buffer 'behind' the current icon.
  426.                        White is not copied, only colors 1-15.
  427.                        Only those pixels that are blank in the 'current'
  428.                        icon receive the pixels from the paste buffer's
  429.                        icon... in other words, as I said, it copies
  430.                        BEHIND the current icon ;-)
  431.                        
  432.             INS/DEL:   INSERT or DELETE a row or column from BOTH the
  433.                        icon and the mask. When inserting rows, the
  434.                        bottom row will be scrolled into oblivion. 
  435.                        Likewise when inserting columns, the rightmost
  436.                        column will be transported to Neverneverland.
  437.                        When deleting, the bottom row or rightmost 
  438.                        column will be blank white.
  439.  
  440.             LINE:      Will provide a rubber-banding tool to draw a
  441.                        line into the icon using the currently selected
  442.                        color. The right mouse button (or esc or UNDO)
  443.                        will cancel the operation.
  444.                        
  445.             FRAME:     Will provide a rubber-banding tool to draw a
  446.                        frame (ie open box) into the icon using the 
  447.                        currently selected color. The right mouse button
  448.                         (or esc or UNDO) will cancel the operation.
  449.  
  450.             BOX:       Will provide a rubber-banding tool to draw a
  451.                        a filled box into the icon using the currently
  452.                        selected color. The right mouse button will
  453.                        cancel the operation (as will UNDO or ESC).
  454.  
  455.             CIRCLE:    Will provide a rubber-banding tool to draw a
  456.                        circle (transparent) into the icon using the 
  457.                        currently selected color. The right mouse button
  458.                        will cancel the operation (as will UNDO or ESC).
  459.  
  460.             DISC:      Will provide a rubber-banding tool to draw a
  461.                        filled circle (ie disc) into the icon using the 
  462.                        currently selected color. The right mouse button
  463.                        will cancel the operation (as will UNDO or ESC).
  464.  
  465.                        Keypress equivalents are set for these tools so
  466.                        you can call them without hassle if you want.
  467.                                       F1:  LINE
  468.                                       F2:  FRAME
  469.                                       F3:  BOX
  470.                                       F4:  ______ (to be announced)
  471.                                       F5:  CIRCLE
  472.                                       F6:  DISC
  473.  
  474.  
  475.            When editing an icon, the number keys 0 through 9 and the
  476.          alpha keys "A" through "F" (or "a" through "f") will select
  477.          the colors 0 through 15.
  478.  
  479.  
  480.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  481.                            ***********************
  482.                            RESOURCE SELECTOR mode:
  483.                            ***********************
  484.                          (GRAB <- RSC  in Edit Menu)
  485.   
  486.        Five groups of icons are displayed at one time. The arrows will
  487.        scroll through the resource file (I know. I'm getting boring
  488.        again, aren't I?).
  489.        
  490.        Selecting any icon will copy the group (Main, Seld and Mono) to
  491.        the buffers of the icon editor and voila! You're ready to edit.
  492.        
  493.        The ascii text displayed with each icon is not editable. This
  494.        text is stored within the resoure file but is, of course, not
  495.        used in the desktop icon (the application name is, remember?).
  496.        The text is displayed only for reference.
  497.  
  498.  
  499.   RESOURCE PUT mode:     (from: PUT-> RSC in Edit Menu)
  500.   - - - - - - - - -
  501.  
  502.        Similar to the selection mode, 5 groups of icons are displayed.
  503.        
  504.        At the top of the form, you'll see your new icons displayed
  505.        next to the large message box.
  506.        
  507.        PAY ATTENTION TO THAT LARGE MESSAGE BOX! It changes, depending
  508.        on the function to be performed (grab/put).
  509.        
  510.        Below each of the new icons is a little down-pointing arrow. By
  511.        default, all three are highlighted. This means that all three 
  512.        icons will be written to the RSC file in memory.  You can opt to
  513.        write any or all to the RSC file by turning the little arrows
  514.        on or off (off=white arrow, black text. on=dark arrow, white 
  515.        text... you know, the normal on/off of all type of buttons;).
  516.        
  517.        Selecting any one of a group in the display box will replace that
  518.        group with your newly edited icons.
  519.        
  520.  
  521. notes:
  522.  
  523.      *  The third buffer is dedicated for the Mono icon of the group.
  524.         Transparent to the user, this buffer is the same size as that
  525.         needed for a color icon.
  526.  
  527.         If pasting a COLOR icon to the MONO buffer, the color data is
  528.         NOT converted to mono. It will still display as color. It will
  529.         NOT be saved as color either!
  530.         The colors are kept and displayed for reference only. Over-
  531.         draw the color pixels with black to ensure a good mono icon.
  532.         (when writing it back to the resource, ICDRAW copies only the
  533.         first plane. Some colors may or may not set pixels in the
  534.         first plane. BLACK sets pixels in all planes).
  535.         You can avoid the pixel-by-pixel coloring by using CHG to change
  536.         one color to another (in this case, to black). See CHG above.
  537.         As of v1.2, you can use BLK to set all colors (save for white)
  538.         to black.
  539.  
  540.      *  ICDRAW uses common-sense when calling the file selector:
  541.         o  File extensions are automatically added! 
  542.         o  File extensions are automatically added! (intentional duplicate)
  543.            A resource file always gets '.RSC' added.
  544.            A saved file always gets the proper extension: '.IBI' or 'IB3'
  545.            An export file always gets the proper file extension: '.S' '.BIN'
  546.            'CIC' or 'ICO'.
  547.            It is good practice to always type the correct file extension
  548.            but with ICDRAW it isn't necessary. (ICDRAW makes it easy)
  549.            
  550.         o  Three path buffers are kept. One for the resource file directory
  551.            one for the load/save directory and one for the export/import
  552.            directory. This way, exported icons don't end up in the same 
  553.            folder as your DESKICON.RSC file (and visca-versca, as Popeye
  554.            would say).
  555.  
  556.            DESKICON.RSC is the default filename on powerup. No drive
  557.            indicator is set; the current drive and path are used.
  558.  
  559.      *  The keypress equivalents for load and save of icons are NOT
  560.         single key strokes. ALT-L or ALT-S will load or save a GROUP
  561.         and SHIFT-L or SHIFT-S will load or save a single icon file.
  562.         The single keypresses of "L" and "S" (or "l" and "s") will prompt
  563.         you with an alert box as to which type of icon(s) you wish to
  564.         Load or Save (single, group or cancel).
  565.         The last selected type (in each alert) is remembered and is used
  566.         as the default the next time the alert is called.
  567.         
  568.  
  569.      *  ICDRAW is 100% assembly.
  570.         (with a tip-o-the-hat to the folks at Hisoft)
  571.         And now with the custom fat-bit display routines to replace
  572.         the VDI calls, it REALLY Flies!
  573.  
  574.  
  575.      *  Included with ICDRAW is RSC-XPAND, the deskicon.rsc file
  576.         expander. It will let you increase the number of icons in
  577.         your resource file from 33 to 50...199.
  578.         Also included are a small collection of icons. Some new and
  579.         some old-but-modified:
  580.         Cityscape, Christmas, SF Com Badge, Envelope, Cash, Bullion,
  581.         File Presser, Zipper, Ohio, Sopwith's evil twin, Button, Fuji,
  582.         Picnic, Speed55, Yield, Ohio, Eyes, Bandaids, Meatgrinder,
  583.         Unpacker, FileType icons, Quarter, Cherries, Address book,
  584.         Notepad, a variety of tidied icons from the originals, a few
  585.         extra colored disks, a few icons for specific applications and
  586.         more (the complete list of icons in beyond the scope of this
  587.         documentation).
  588.  
  589.  
  590.       **************************************************************
  591.       As always, KEEP A BACKUP of your important files. In this case
  592.       we're talking about DESKICON.RSC.  And for convenience sake, 
  593.       backup the NEWDESK.INF along with it.
  594.       **************************************************************  
  595.  
  596.  
  597.          
  598.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  599. Revision history: ICDRAW.prg
  600.  
  601. v1.42 05/18/94   Added:   Support for 800x600 16-color video mode.
  602.  
  603. v1.41 05/15/94   Fixed:   ICO export format now doubles height spec
  604.                           in the DIB header (Windows presumes the icon
  605.                           height to be 1/2 the value specified. the
  606.                           other half is presumed for the mask).
  607.                  Fixed:   CHAR_XY. New, larger fat-bit display of v1.4
  608.                           was not accounted for in calculating the
  609.                           true char x,y.
  610.                                            
  611. v1.4  05/08/94   Added:   Draw circle/filled circle, keypress equivs
  612.                           for GRAB/PUT, and a general cleanup then
  613.                           ate some Ho-Hos and was feeling great!
  614.  
  615. v1.34 05/06/94   Added:   Tidied-up new buttons and location. Removed
  616.                           GRID/ECHO buttons (left in menubar). Custom
  617.                           fat-bit video display (MUCH faster!). Keys
  618.                           0-1 and a-f select colors. Fixed invert ICON
  619.                           function in TOOLS.
  620.                  Added:   TOOLS: COMBINE 1,2,3. INSERT/DELETE ROW/COLUMN.
  621.                                  Invert function 3, exchange dark/light
  622.                                  colors in icon.
  623.                                  DRAW LINE. DRAW FRAME.
  624.                            LOAD PASTE buffer from IBI.
  625.                            UNDO, button/menu/key.
  626. v1.3  04/05/94   fixed:   RSC-XPAND. Placed dialog in window to
  627.                           alleviate wm_redraw headaches.                                 
  628. v1.3  04/30/94   Added:   Menubar functions. Removed file i/o from
  629. (beta)                    edit dialog. Removed CLR/FILL data from
  630.                           same and left to reside in menu bar.
  631. v1.2  04/25/94   Added:   Extra functions (.AND.,Overlay,Inverts)
  632. v1.2  04/22/94   Added:   ICO Export
  633. v1.2  04/21/94   Added:   ICO Import
  634. v1.2  04/16/94   Added:   Window, SWAP(main/seld), goto BLACK,
  635.                           Export CICON format, and CHARX/Y/Parms edit.
  636.                  Changed: "HUE" button to "CHG" (change) and
  637.                           resize when editing mono icon to allow
  638.                           for 'goto black' function.
  639.                  Removed: ADD-to-RSC function.
  640.                           Created, instead, RSCXPAND to expand the
  641.                           RSC file external from ICDRAW.
  642.                  Fixed:   2nd load of RSC file would appear garbled,
  643.                           now zeroes count before loading 2nd RSC.
  644.                 
  645. v1.1a 04/12/94   Added:   ADD Icon to RSC... (experiment failed. TOS
  646.                           requires a totally reconstructed RSC file
  647.                           when an icon is ADDED)
  648.  
  649. v1.1  04/12/94   Added:   backdrop styles, echo, grid toggle, 
  650.                           arrows in STORE, and color change.
  651.                        
  652. v1.0  04/09/94   Original release
  653.  
  654.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  655.  
  656.       **************************************************************
  657.       As always, KEEP A BACKUP of your important files. In this case
  658.       we're talking about DESKICON.RSC.  And for convenience sake, 
  659.       backup the NEWDESK.INF along with it.
  660.       **************************************************************  
  661.  
  662.  
  663. *************************************************************************
  664. {insert RSCXPAND docs here}
  665. {nevermind, just read the RSCXPAND.TXT file. It's easier that way.}
  666.   
  667. *************************************************************************
  668.  
  669.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  670. *************************************************************************
  671.  
  672. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  673.  
  674.                          ICDRAW is shareware.
  675.  
  676.                      RSCXPAND is a part of ICDRAW
  677.                    (and is therefor also shareware)
  678.  
  679.   ICDRAW may be freely distributed as long as this documentation is
  680.   included as as long as neither are modified (that includes all my
  681.   spelling errors). It must not be represented as anything other
  682.   than Shareware.
  683.  
  684.  
  685.   ICDRAW\RSCXPAND is shareware. Try it out. If you don't care for it
  686.   then don't waste your disk space- erase it, upload it, whatever.
  687.  
  688.   If you do like it then a small donation will keep me in groceries
  689.   and living indoors (two serious addictions that I just can't seem
  690.   to break).
  691.   It will also tell me that perhaps a new version with more features
  692.   might be appreciated.
  693.  
  694.   I can already think of new features. The ability to ADD to a RSC
  695.   file, import icons from other formats, capture icons from the 
  696.   screen, export to other formats... there's a lot that can be done.
  697.  
  698.  
  699.  Note: I will refuse to accept more than $15.00 US as a donation.
  700.        This is a small utility. $10.00 is suggested and $15.00
  701.        is a good pat-on-the-back. $20.00 is right-out, I'll have
  702.        to send you change and I can't break a twenty right now ;-)
  703.  
  704.  
  705. {retrospect: "hmmmmm should I up the price?  It seems kinda low
  706.               for all the work I've put into this... should I ask
  707.               concientious users to make up for those more akin
  708.               to pirates or for those who just rationalize their
  709.               use of shareware? Should I, shouldn't I? Awww what
  710.               the heck... let's leave it the way it is and see how
  711.               it flies. If it falls into oblivion then it'll tell
  712.               me just what kind of market this really is. Or that
  713.               perhaps they're still waiting for Atari to produce 
  714.               an icon editor.  Yeah. Right. Uh-huh. Sure. :) " 
  715. }
  716.  
  717.  
  718.  
  719.  
  720. Send donations and/or comments to:
  721.  
  722.  W. David Parks
  723.  180 N. Hazeltine Avenue
  724.  Campbell, OH 44405-1024
  725.  
  726. \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  727.  
  728. other methods of contact:
  729.  
  730.  voice phone: 216 743-4712
  731.  
  732.  GEnie:       W.PARKS3
  733.  
  734.  
  735.  
  736.  -/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/
  737.  (this last anecdote not included due to its possible inflamatory nature
  738.   and its ability to offend persons whom are easily offended by anecdotes
  739.   or small furry critters especially when they wee-wee on the floor...
  740.   not the persons, the small furry critters. whoops- that's an anecdote,
  741.   oh no. guess I'll just have to contend with it. send mail to W.PARKS3)
  742.  -/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/-/
  743.  
  744.  
  745.  
  746. Bye: Dr. Bob   18 May 1994
  747. -------------------------------------------------------------------------
  748. End ICDRAW.TXT
  749.