home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / falcon / graphics / icdrawup / rscxpand.txt < prev    next >
Text File  |  1994-05-09  |  15KB  |  333 lines
  1.                                  RSC-XPAND
  2.                              from Dr. Bobware
  3.                             (c) 1994 W.D.Parks
  4.                             All rights reserved
  5.  
  6. *************************************************************************
  7.                                  RSCXPAND
  8.                              Resource Expander
  9.                                   v 1.01
  10.  
  11.  ICDRAW will edit the existing icons in your DESKICON.RSC file but what
  12.  if you want MORE icons... you want to keep all the ones you have and
  13.  still need another one?
  14.  
  15.  RSCXPAND will let you increase the number of icons in that file; from
  16.  the original 33 to 50... or to 64... or all the way up to 199 which
  17.  gets to be quite a hefty RSC file (up there at 386k). Such a huge file
  18.  will take a bit of time during the boot process... a tad more than the
  19.  original 64k resource file that came with your Falcon. It's not an
  20.  extremely lengthy period but it also takes up more of your Falcon's
  21.  memory (note: I do not recommend using such a huge file if your machine
  22.  has only 1 meg of ram).
  23.  
  24.  RSCXPAND is simple.
  25.   Its dialog also shows all the information in your resource file header
  26.  as reference. (I like information.) You can ignore it if you want or read
  27.  it if you like. It does not affect the operation of RSCXPAND- there are no
  28.  buttons in it or any that will alter the info.
  29.  
  30.  
  31.  Three main buttons exist. LOAD will, of course, load the desired RSC file.
  32.  CANCEL will, of course, exit the program. EXPAND will do the work.
  33.  
  34.  There is also an array of radio buttons on the right from which you can
  35.  select the number of icons you want room for in your DESKICON.RSC file
  36.  (sorry, the number is not user editable). 
  37.  Selections are 50, 64, 80, 100, 128, 150 and 199 icons.
  38.  
  39.  To keep RSCXPAND simple in operation, it will only EXPAND your resource
  40.  file. It does not offer to SHRINK it. If your RSC file already has, say,
  41.  64 icons in it then the [50] and [64] buttons will be disabled.
  42.  After all, its name is rscXPAND, isn't it? 
  43.  
  44.  (there isn't enough room in the filename to fit RSCXPANDORSHRINK.prg :-)
  45.  
  46.  
  47.  
  48.       **************************************************************
  49.       As always, KEEP A BACKUP of your important files. In this case
  50.       we're talking about DESKICON.RSC.  And for convenience sake, 
  51.       backup the NEWDESK.INF along with it.
  52.       **************************************************************  
  53.  
  54.  
  55.  
  56.  **************************************************************************
  57.                                OPERATION
  58.  **************************************************************************
  59.  
  60.  1) MAKE A BACKUP of your original DESKICON.RSC file. Save it to
  61.     floppy for your assurance. BACKUP ALSO your NEWDESK.INF file.
  62.     
  63.  2) Run RSCXPAND.prg
  64.  
  65.  3) Click on the [LOAD] button and select the DESKICON.RSC file you
  66.     want to expand. It will be read and its header info displayed
  67.     for your viewing pleasure.
  68.     ALSO, you'll be told how many icons it already contains in the
  69.     grey box (with the yellow text, it's easy to see).
  70.  
  71.  4) Here's the tough part....
  72.  
  73.     Decide how many icons you want your file to hold and click on
  74.     the proper button.
  75.  
  76.      (the clicking part is easy. the decision part is what's hard...
  77.       "Do I want 100 icons or maybe only 80? Gosh."
  78.       "Maybe I'll try the full 199."  "Oh. I dunno. I'm no good at
  79.        this decision making stuff."
  80.       "Let's see. I was born on a Thursday so I'll pick 112. What?
  81.        Why can't I have 112?" )
  82.     
  83.     Let me help.
  84.     Select 50. This will give you 17 additional icons in your
  85.     resource file. That's enough to get started. Trust me, I'm a doctor.
  86.  
  87.  5) Click on [EXPAND] and then select the same filename as the one
  88.     you loaded (you _did_ back it up, right?). The fileselector will
  89.     still have the same name ready for you so all you need to do is
  90.     click on its [Ok] and away we go. 
  91.     
  92.  6) Click on [Cancel] and you're back at the desktop (or launcher).
  93.  
  94.  
  95.  
  96.     What RSCXPAND does for you:
  97.     
  98.     It increases the size of your DESKICON.RSC file so it can hold
  99.     more than its original 33 icons. It does this legitimately; there's
  100.     no tricks or shortcuts.
  101.  
  102.     (it completely dissassembles the file and reconstructs it anew with
  103.     the extra space for additional icons. this is not as simple as it
  104.     may sound- it's more than simply appending icons to the end of
  105.     the file. icons have to be added all over the place and pointers
  106.     and definition blocks and, oh my... in the end, though, it does it!
  107.     let's not get too techie here. this is supposed to be a simple
  108.     explanation and I've spent more time explaining this than it does
  109.     to reconstruct the file)
  110.     
  111.  
  112.     It retains the existing icons in the file. (Well I should hope so!)
  113.     
  114.  
  115.     In the additional spaces (the new icon locations) RSCXPAND places
  116.     a simple shaded box into each of the 4 icon locations (main, seld,
  117.     and mono). They are color and mono icons and masks and are put there
  118.     for cosmetic purposes only. If they weren't put there then all the
  119.     new icons would be white rectangles with a blank mask. It just looks
  120.     better this way.
  121.     
  122.     In the new icons, text color is set to black, background to white,
  123.     and the position of the character (for any drive id) is centered.
  124.     
  125.     That's it.
  126.     
  127.     Now you're ready to use ICDRAW and import new icons into those
  128.     slots, or draw your own, and have fun.
  129.     
  130.     Note: RSCXPAND is NOT required to run ICDRAW. It simply expands
  131.     the number of available icon slots in your resource file so that
  132.     both you and ICDRAW can have more room to play with.
  133.  
  134.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  135.  
  136.  
  137.    Due to some internal buffer dimensions in TOS, it is highly recommended
  138.  to power-up your system with FOLDRXXX.PRG in your auto-folder. This will
  139.  increase the "Internal System Memory" and alleviate many problems.
  140.    Without FOLDRXXX, you'll find that many applications will give you an
  141.  error message... "Out of Internal Memory. System Halted. Use FolderXXX
  142.  and reboot." 
  143.    Unfortunately, there is no other solution. TOS in ROM has a fixed buffer
  144.  size set aside for internal use and will be overpowered by all the extra
  145.  icons. 
  146.  
  147.    FOLDRXXX.PRG should be renamed to FOLDR100.PRG (if you've expanded your
  148.   deskicon.rsc file to have 200 icons then use a higher number such as
  149.   FOLDR200.PRG).
  150.  
  151.  
  152.  
  153.  
  154.   
  155.                                  RSC-XPAND
  156.                              from Dr. Bobware
  157.                             (c) 1994 W.D.Parks
  158.                             All rights reserved
  159.  
  160. ---------------------------------------------------------------------------
  161.                              RSCXPAND Addendum
  162. ---------------------------------------------------------------------------
  163.                                  05/06/94
  164. ---------------------------------------------------------------------------
  165.  
  166.   RSC-XPAND, will icrease the icon capacity of your Falcon030 desktop's
  167.  DESKICON.RSC file. In short, you can have more than the stock 33 icons
  168.  available to you and your applications.
  169.  
  170.   With the release of ICDRAW, custom color icons have become available
  171.  for your Falcon desktop. You can have zippers for ZIP files, packing
  172.  boxes for archivers, desk calendars for appointment apps, logo icons
  173.  for your favorite software... the possibilities abound.
  174.  
  175.   Suddenly, you have gobs and gobs of icons... but you can only assign
  176.  from the 33 in your deskicon.rsc file. What a shame! ICDRAW offers all
  177.  those spiffy looking widgets, gadgets and thingamajigs but your resource
  178.  file can only fit 33... AND you don't want to give up that nice looking
  179.  blue diskette icon, and the folder icons are fine and the toolbox icon
  180.  is your favorite...
  181.  
  182.   Enter RSC-XPAND!  Now you can increase the number of icons that your
  183.  deskicon.rsc file can hold... all the way up to 199 if you want.
  184.  (200 is the maximum theoretical number of icons in an RSC).
  185.  
  186.  
  187.   "Well, gosh! Why hasn't this been released sooner?", you ask.
  188.   
  189.  
  190.   RSC-XPAND was completed over a month ago and has been giving me pleasure
  191.  ever since. But there was a problem and it ocurred with two of my favorite
  192.  applications at that.
  193.  
  194.   TOS4 has a fixed limit on its internal memory buffer. I often wonder if
  195.  anyone anywhere knows what all that buffer is used for anymore. Its size
  196.  _IS_ important though and when you increase your deskicon.rsc file that
  197.  buffer soon becomes too small. Applications will fail to run and that most
  198.  dreaded alert, "Out of internal memory. System halted.", rears its ugly
  199.  head and we all grit our teeth and shudder.
  200.  
  201.   "Oh. That's why RSC-XPAND hasn't been released yet.", you say.
  202.   
  203.   "Yep.", says I.
  204.   
  205.   This is not a problem with any of the applications nor is it a bug in
  206.  RSC_XPAND.  It is due to the fixed buffer limit in TOS. So, it is not
  207.  really a bug in TOS either... just a hard-coded buffer size limit.
  208.   You'll run into this same 'limitation' with the stock deskicon.rsc
  209.  file too if your newdesk.inf file goes over 4k. (please, no critizism
  210.  on why one would have a 4k INF file :)
  211.   I'm told that this limitation was lifted in some version of MultiTos.
  212.  Perhaps all versions, perhaps not. I don't know from MultiTos. :-)
  213.  
  214.   
  215.    Finally I found that old utility, FOLDRXXX.PRG. You know which one
  216.   that is: the one named in the Falcon030 owner's manual... that isn't
  217.   on any of the Falcon diskettes and nowhere on the harddrive.  The same
  218.   one that's mentioned in THE error message, "Folder100"... see page B12
  219.   in your owner's manual.
  220.   
  221.    Well, the 'folders' that FOLDRXXX creates are part of that 'internal
  222.   memory'. Either they free up some of a catch-all buffer or the 'folders'
  223.   are used by other functions of TOS as well.  Whatever the technical
  224.   aspect of it is, your internal memory is increased and you're ready to
  225.   rock-and-roll... or ready to classic ...or punk ...or rapp ...whatever.
  226.  
  227.               FOLDRXXX cures this problem. It's gone! Poof!
  228.  
  229.    Pure and simple, if you increase the number of icons then use FOLDRXXX
  230.   in your AUTO folder. Renaming it to FOLDR200.PRG will do you just fine.
  231.   Less than that and, well... I haven't tested the minimum to any extent
  232.   yet but FOLDR200 will do it... and besides, what's 26k among friends? :)
  233.   
  234.   
  235.    I can say that without FOLDRXXX, do NOT increase your resource file
  236.   beyond 100 icons... the DESKTOP will not be able to boot.
  237.  
  238.  
  239.   *********************************************************************  
  240.   And... as always, KEEP A BACKUP of your important files. In this case
  241.   we're talking about DESKICON.RSC and for convenience sake, backup the
  242.   NEWDESK.INF along with it.
  243.   *********************************************************************  
  244.   
  245.  
  246.  
  247.   
  248.  
  249.  Expanding your resource is easy with RSCXPAND. There are two main things
  250.  to consider when doing so:
  251.  
  252.  1) How much longer will the boot process take with a large deskicon.rsc?
  253.  
  254.     ans: Practically imperceptable. Certainly not enough to be even close
  255.          to an 'annoying' comment. In fact, I was surprised. I had expected
  256.          a visible delay with a 190k deskicon.rsc file but it wasn't there.
  257.  
  258.  2) How much additional memory will be used by this enlarged deskicon.rsc?
  259.  
  260.     ans: An icon (group of 3) in the file uses approximately 1940 bytes.
  261.          Exactly how much of the RSC file is retained by the DESKTOP is
  262.          not documented anywhere but you can presume that it's retained
  263.          in its entirety. So expect a 100k rsc file to use up 100k +/-.
  264.          If this amount worries you then don't expand your deskicon.rsc
  265.          file. The normal rsc file is 64k already. I feel quite confortable
  266.          increasing it by another 40k or, heck, even doubling it in size.
  267.  
  268.  
  269.  
  270.  
  271. ---------------------------------------------------------------------------
  272.                         An addendum to the addendum:
  273. ---------------------------------------------------------------------------
  274.                                  05/07/94
  275.                                BOOTUP Notes
  276. ---------------------------------------------------------------------------
  277.  
  278.  
  279.   The stock DESKICON.RSC file contains only mono and 16-color icons.
  280.  ICDRAW and RSC-XPAND, also, create only these two types (ICDRAW creates
  281.  all three of a group while RSC-XPAND creates icons only as place-holders
  282.  but 'creates' them nonetheless).
  283.  
  284.   During the boot process, TOS4 determines which icons will most closely
  285.  match the default resolution and will use either the mono icons (for mono
  286.  and 4-color modes) or the 16-color icons for modes with 16 or more colors.
  287.  
  288.   In 16-color modes, the conversion time is essentially nill. In 256-color
  289.  modes the conversion process takes a little longer (3-4 sec.), still
  290.  within an acceptable range.  But when booting in 32k-color modes the time
  291.  icreases quite a bit!
  292.  
  293.   With 200 icons (which I'm using for testing at this time... I, myself,
  294.  will probably go back to 100 or 128 for my own use) the conversion time
  295.  at bootup becomes annoyingly lengthy... to the point where one starts
  296.  to wonder if something's gone wrong or not. Expect up to 30 seconds delay
  297.  while TOS converts all the 16-color icons to true-color format.
  298.   While this is not terribly deficient, it's nothing I'd want to admit to
  299.  MS\Windows users... they scoff at me enough as it is :)
  300.  
  301.  
  302. ---------------------------------------------------------------------------
  303. End Addendum     07 May 1994   W.D.Parks
  304. ---------------------------------------------------------------------------
  305.  
  306.      This is a message that always bears repeating. For any utility.
  307.      
  308.      **************************************************************
  309.      As always, KEEP A BACKUP of your important files. In this case
  310.      we're talking about DESKICON.RSC.  And for convenience sake, 
  311.      backup the NEWDESK.INF along with it.
  312.      **************************************************************  
  313.  
  314. ---------------------------------------------------------------------------
  315. The Real End.
  316.  (Honest.  No, really. This is it. That's all she wrote. There is no more
  317. to read. "End of file".  Terminated.  Listen... don't you hear her singing?
  318. It's over now that it's over.  Zip.  Nada.  Case closed.  End of the road.
  319. Running on empty.  Finished.  The End.  Leads nowhere.  Fini.  "I feel so
  320. breakup I want to go home".  All done.  All gone.  No more.  And then there
  321. were none.  Poof!  Sofit.  Press any key when done.  Stop.  Don't call us,
  322. we'll call you.  Thank you very much.  We'll get back to you.  If a man
  323. answers, hang up.  No reply.  Disconnected.  "Please hang up and try your
  324. call again"  Goodbye.  Take it easy.  Take care.  Seeya later alligator.
  325. After while, crocodile.  Hit the road.  Seeyas.  Don't forget to write.
  326. So long.  Bon voyage.  Later.  Exit.  Off.  No outlet.  No loitering.
  327. Cast off.  Take off.  Out of gas.  Closed door.  Nothing left.  Nothing
  328. right.  Completed.  Dissipated.  The final curtain.  Halted.  K.O.  Brought
  329. to an end.  Expiration date: Now.  Ceased and desisted.  Period.  Tail end.
  330. ...and in conclusion,
  331. Bye: Dr. Bob :)
  332.  
  333.