home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / fish / disks / d1099.lha / Programs / IconShow / IconShow.doc < prev    next >
Encoding:
Text File  |  1995-04-04  |  6.5 KB  |  146 lines
  1. *************************************************************************
  2. *                                                          (16-Nov-94)  *
  3. *                  IconShow 0.12ß by Per-Olof Yliniemi                  *
  4. *                                                                       *
  5. *               Copyright © 1994 - All Rights Reserved                  *
  6. *                                                                       *
  7. *************************************************************************
  8. *                                                                       *
  9. * DISCLAIMER: No responsibility can be taken on the part of the  author *
  10. *   for any  consequences  that may  occur  as a result  of using  this *
  11. *   program.  Every part of the  program has been  thoroughly tested to *
  12. *   to its specified limits and any  known specific  limitations of the *
  13. *   the program are stated within this documentation.                   *
  14. *                                                                       *
  15. *************************************************************************
  16. *                                                                       *
  17. * COPYRIGHT: This program is  FREEWARE. No  kind of  contributions  are *
  18. *   required from anyone who  uses  this program,  but if  you want the *
  19. *   assembly  language  source  code for this program, send me one disk *
  20. *   with PD, Shareware,Freeware and other freely distributable programs *
  21. *   plus return postage.                                                *
  22. *                                                                       *
  23. *   This program  may  not be  sold for any profit  (a nominal  fee for *
  24. *   copying is accepted). The program may be freely distributed as long *
  25. *   as all files are distributed and unmodified.                        *
  26. *                                                                       *
  27. *   This program may not be used as a  part of any  commercial packages *
  28. *   without my permission.  The source code for this program may not be *
  29. *   reproduced by disassembling or reversing the development process in *
  30. *   any way.                                                            *
  31. *                                                                       *
  32. *************************************************************************
  33.  
  34. Purpose:
  35. ~~~~~~~~
  36. IconShow is a CLI command that allows you to view icons. This program
  37. was written to allow other programs (directory utilities etc.) to view
  38. icons.
  39.  
  40. Requirements:
  41. ~~~~~~~~~~~~~
  42. This program requires v2.04 or higher of the operating system to run. You
  43. also needs an icon to use it on (included... :-).
  44.  
  45. Usage:
  46. ~~~~~~
  47. IconShow has the following CLI-template:
  48.  
  49. IconShow ICON/A
  50.  
  51. If you type IconShow ?, you'll see the syntax in the CLI window. To use
  52. the program on an icon called "More.info" then you should type
  53.  
  54. IconShow Sys:Utilities/More.info
  55.  
  56. and press return. The program will open a little window showing the icon
  57. image, and when you press the left mouse button over the image it will
  58. change nearly exact (see notes below) as it will when clicked in Workbench.
  59. Close the window or press the ESC key to exit the program.
  60.  
  61. Usage from other programs:
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  63. This program is best used in directory utilities like DiskMaster, DirWork
  64. and Directory Opus. Here's an example on how to make use of it in
  65. DiskMaster:
  66.  
  67. Copy IconShow to your C: directory or another command path in your system.
  68.  
  69. Load your DiskMaster configuration file into any text editor. If you don't
  70. have a configuration file, start DiskMaster and select "Save Config" from
  71. the Project Menu.
  72.  
  73. Insert this line before the "AddAutoCmd TEXT,Read %s" line (it's the second
  74. line from the bottom of the config file):
  75.  
  76. AddAutoCmd ,*.info,Extern IconShow %s
  77.  
  78. Save your config file and start DiskMaster from the Project icon that was
  79. created when you saved the configuration. If DiskMaster could find the file
  80. you just created, it will now skip the About requester at start, else read
  81. the manual for DiskMaster.
  82.  
  83. If you now double-click on any file that ends with ".info" the IconShow
  84. program will try to load it and open a little window on the same screen as
  85. DiskMaster is.
  86.  
  87. To make this program even more useful, load the config file again into your
  88. text editor and insert this line before the "AddCmd ShowPic, 20, ShowPic %s"
  89. line:
  90.  
  91. AddCmd ShowIcon, 20, Extern IconShow %s
  92.  
  93. Save the config file and start DiskMaster again. Now you will have a new
  94. gadget in the window in the middle of the display. It's located just before
  95. the "ShowPic" gadget. To view a bunch of icons with unknown names, select
  96. for example the sys:utilities drawer and press the ShowIcon gadget. The
  97. program will now show all icons it can find in the selected drawer(s). To
  98. make DiskMaster stop, press the ESC key while DiskMaster is searching for
  99. some icons.
  100.  
  101. Read the manual for your directory utility to find out more on how to
  102. configure it.
  103.  
  104. Notes:
  105. ~~~~~~
  106. When viewing icons with only one image, they get rendered a bit different
  107. than they should. This has something to do with the GFLG_GADGHCOMP bit in
  108. the gadget structure of the icon. All other programs like this that I have
  109. tested also have this error. I may fix this in a later version of IconShow.
  110.  
  111. Other programs like this (and an earlier version of this program) also
  112. failed when there was a weird number in the GadgetType field of the gadget
  113. structure. This program eliminates this crash by changing the GadgetType
  114. field to GTYP_BOOLGADGET (all icons should have the GadgetType set to this,
  115. but some icons have another value in here).
  116.  
  117. Developed on:
  118. ~~~~~~~~~~~~~
  119. Amiga 500 Plus
  120. 2MB Chip RAM, 8MB 16-bit Fast RAM, 8MB 32-bit Fast RAM
  121. Microbotics VXL-30, 33MHz / 68882, 25MHz
  122. 260MB Seagate ST3290A harddrive + ICD Trifecta 500 LX controller (SCSI2/IDE)
  123. Commodore 1084S monitor
  124.  
  125. Version:      Changes:                  Size:
  126. ~~~~~~~~      ~~~~~~~~                  ~~~~~
  127.  0.10   First public release.           1004 bytes 
  128.  0.12   A 28 bytes big bug removed...    976 bytes
  129.  
  130.         
  131. ---------------------------------------------------------------------------
  132.  
  133.  All kinds of freely distributable programs (new software...) are accepted
  134.  as a contribution for this program. If you are a programmer, send me some
  135.  of your own code.
  136.  
  137.  Contributions and bug reports for this program should be sent to:
  138.  
  139.  
  140.                       Per-Olof Yliniemi
  141.                       Muoniovaara
  142.                       S-980 64 Muodoslompolo
  143.                       SWEDEN
  144.  
  145. ---------------------------------------------------------------------------
  146.