home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 505.dms / 505.adf / DOCS / PicFind.Doc < prev    next >
Text File  |  1989-09-09  |  8KB  |  186 lines
  1.                            PicFind 
  2.  
  3.                             Topics 
  4.  
  5.                    1.   History. 
  6.  
  7.                    2.   Usage. 
  8.  
  9.                    3.   Copyright. 
  10.  
  11.                    4.   Distribution.   
  12.  
  13.                    5.   BUG reports. 
  14.  
  15.                    6.   Donations. 
  16.  
  17. 1. History. 
  18.  
  19. This program has been developed when I upgraded from my old A-1000
  20. to the new A-2000 Rev6. Since this one has 1MB of ChipMem, quite a
  21. number of SlideShow programs just didn't work anymore.  Leaving me
  22. with a large amount of picture disks that just crashed  when tried
  23. to run. Therefore I needed a quick and easy way to display all the
  24. pictures on those disks to see if any were worth salvaging.  Hence
  25. PicFind. This program checks a (user-specified) directory  for IFF
  26. ILBM files.  Any such files found will be automatically displayed.
  27. (The time they are displayed defaults to 5 seconds, but may be set
  28. by the user on running PicFind.)
  29.  
  30. Version History : V 1.0, August 1989
  31.                   Lattice C, Some problems that crept up in PicFind
  32.                              during development have been solved as
  33.                              well as enhancements made.
  34.                              - Interlace problem solved. 
  35.                              - Extra-HalfBrite support added. Needs 
  36.                                a CAMG chunk in the file though. If 
  37.                                no CAMG chunk then HAM mode is set.
  38.                                ( See the IFF specs on 'Fish 185'. )
  39.                                There should be A CAMG chunk in all
  40.                                ILBM's.
  41.                              - HiRes OverScan problem not solved. 
  42.                                Seems to be Systems bug.  
  43.  
  44. 2. Usage      
  45.  
  46. Usage : PicFind <DIRECTORY> [<DURATION>]  
  47.  
  48. How to use this program? Well it is fairly simple. You may specify
  49. the duration the picture is on the screen in seconds. If you don't
  50. specify the duration, the program defaults to 5 seconds. As stated
  51. above, the user has to specify a directory, which will be searched
  52. for IFF ILBM files. Any such files found, will be displayed by the
  53. program.  It will tell you which file it is displaying, as well as
  54. give a message if no IFF ILBM files could be found. 
  55.  
  56. To clarify this I will give some examples. 
  57.  
  58. Display all pictures in the directory DF0:Pics for 9 seconds each.
  59.  
  60. Command line  : PicView DF0:Pics 9 
  61.  
  62. Display pictures on drive df1: for 5 seconds each.
  63. (Remember : 5 seconds is the program's default displaytime).
  64.  
  65. Command line  : PicView df1: 
  66.  
  67. Requirements: 
  68.  
  69. - A standard Amiga with 512KByte of memory will suffice. Make sure
  70.   though, that there is enough  free memory or the program aborts.
  71.  
  72. The program should support all regular  Amiga devices. I tested it 
  73. with DF0: to DF3:, VD0:, VDK:, RAM:, CARD: and DH0: to DH2:. It is 
  74. compatible with both  WorkBench 1.2 and 1.3. I haven not tested it 
  75. with 1.1 though. It also works on Amiga 2000 with 1 MB of ChipMem.
  76. (Rev 6 and higher.) 
  77.  
  78. NOTICE: 
  79.  
  80. This software is  supplied as is, and  neither the  author nor the 
  81. distributor is liable or responsible for any  damage to either the 
  82. computer or any pheripherals or media this software is used on. 
  83.  
  84. 3. Copyright. 
  85.  
  86. This program is considered FreeWare. It may be copied freely. When
  87. doing so please adhere to the following rules.
  88.  
  89. - The program may not be used or bundled by any software retailing
  90.   over US$ 10.00 (British £ 3.00), or it's equivalent in any other 
  91.   currency, without prior written permission from the author. 
  92.  
  93. - This document must always accompany the program. 
  94.  
  95. - This document may not be altered.
  96.  
  97. - The author  retains the right to  remove this  program  from the 
  98.   Public Domain at any time, without prior notification. 
  99.  
  100. 4. Distribution. 
  101.  
  102. Distribution rights are  hereby, of course,  granted to Fred Fish, 
  103. and any other non-profit organisation.  Persons wanting to include 
  104. this program andd / or it's  source on any disk retailing over US$ 
  105. 10.00 ( British £3.00 ), or it's equivalent in any other currency,
  106. must first obtain written permission for this from the author. 
  107.  
  108. 5. BUG-Reports. 
  109.  
  110. Known Bugs:
  111.  
  112. - PAL HiRes Overscan is not fully supported.  The 'PAL' section of
  113.   the screen stays black.  (On an Amiga 1000, as well as the 2000)
  114.   Irritating.  This should not happen.  Seems to be a systems bug,
  115.   since more programs seem to suffer from this. (wait for 1.4?)
  116.  
  117. Send Report To:
  118.  
  119. Accidents will happen and I'm only human. If you find a bug or you 
  120. think you  might have found a bug, please  print out the following 
  121. form on you printer,  fill in the  neccessary details, and sent it 
  122. to the address mentioned on it. Thanks! 
  123.  
  124. ------------------- Cut Here Please ------------------------------ 
  125.  
  126. +----------------------------------------------------------------+ 
  127. |                           BUG Report                           | 
  128. +----------------------------------------------------------------+ 
  129. | Program     : PicFind         Version     : 1.0                | 
  130. +----------------------------------------------------------------+ 
  131. | Bug         :                                                  | 
  132. |                                                                | 
  133. |                                                                | 
  134. |                                                                | 
  135. |                                                                | 
  136. |                                                                | 
  137. |                                                                | 
  138. +----------------------------------------------------------------+ 
  139. | Additional information                                         | 
  140. | Error code  :                                                  | 
  141. |                                                                | 
  142. |                                                                | 
  143. |                                                                | 
  144. |                                                                | 
  145. |                                                                | 
  146. |                                                                | 
  147. +----------------------------------------------------------------+ 
  148. | Sent to:    P. Kolenbrander                                    | 
  149. |             <BUG-Report PicFind 1.0>                           | 
  150. |             Turfveldenstraat 37                                | 
  151. |             NL-5632 XH  EINDHOVEN                              | 
  152. |             The NETHERLANDS                                    | 
  153. |                                                                | 
  154. +----------------------------------------------------------------+ 
  155.        
  156. ------------------- Cut Here Please ------------------------------ 
  157.  
  158. 6. Donations. 
  159.  
  160. This program is considered Freeware. Meaning that if you find this
  161. program useful, you are kindly requested to make this noted to the 
  162. author.  Preferably by means of a (cash!) donation or other useful
  163. token of appreciation.  This is not mandatory as is with Shareware 
  164. programs however.
  165.  
  166. If you have any cash to spare, it is always welcome. Unfortunately 
  167. I have my expenses also. Donations in other form, like disks, (PD) 
  168. software, Sonix Scores!, home-built programs / hardware  etc,  are
  169. of course also welcome. Remember: 
  170.  
  171.             'It is better to give than to receive!' 
  172.   (I've given you this program, so now it's you turn, isn't it?) 
  173.  
  174. Enjoy the program! 
  175.  
  176. My address is: P. Kolenbrander 
  177.                Turfveldenstraat 37 
  178.                NL-5632 XH  EINDHOVEN 
  179.                HOLLAND 
  180.  
  181. No phone, not since some guy woke me at  04:00 AM ( My local time, 
  182. not his!). So, if you feel it is that  urgent to call me you won't   
  183. mind taking the trouble of finding out my phonenumber. But PLEASE! 
  184. check the  time-differences. I can get  pretty  uncooperative when 
  185. called out of bed in the middle of the night!
  186.