home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 505.dms / in.adf / DOCS / PicView.Doc < prev    next >
Encoding:
Text File  |  1989-09-09  |  8.4 KB  |  200 lines
  1.                            PicView 
  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, using 'plop' as a base, to enable
  20. me to display the HAM Overscan pictures I created with 'DigiView'.
  21. This program will display most resolutions, both NTSC and PAL.  At
  22. the moment however the HiRes Overscan resolution is not supported.
  23.  
  24.  
  25. Version History : V 0.89L, March 1989.
  26.                   Lattice C, Some problems with the screen (Flash)
  27.                              ported source from Aztec  to Lattice.
  28.                              Needed  some polishing to satisfy the
  29.                              worlds pickiest Compiler.
  30.                   V 0.90L, April 1989.
  31.                   Lattice C, Solved screen flashing. Conformed the
  32.                              source to the ANSI C standard!. (more
  33.                              or less anyway). Exchanged the printf
  34.                              statements for a function  Schrijf(),
  35.                              which conserves memory and is just as
  36.                              fast anyway.
  37.                   V 0.91, May 1989
  38.                   Lattice C, Found problems with Overscan and 1.3.
  39.                              Overscan wasn't recognized. Solved by
  40.                              using RemakeDisplay() after setting
  41.                              correct overscan values.
  42.                   V 1.0, August 1989
  43.                   Lattice C, Some problems that crept up have been
  44.                              solved, as well as enhancements made.
  45.                              - Interlace problem solved. 
  46.                              - Extra-HalfBrite support added. Needs 
  47.                                a CAMG chunk in the file though. If 
  48.                                no CAMG chunk then HAM mode is set.
  49.                                ( See the IFF specs on 'Fish 185'. )
  50.                                There should be A CAMG chunk in all
  51.                                ILBM's.
  52.                              - HiRes OverScan problem not solved. 
  53.                                Seems to be Systems bug.  
  54.  
  55. 2. Usage      
  56.  
  57. Usage : PicView [<DURATION>] <FILENAME>.....<FILENAME> 
  58.  
  59. How to use this program? Well it is fairly simple. You may specify
  60. the duration the picture is on the screen in seconds. If you don't
  61. specify the duration, the program defaults to a 5 second duration.
  62. For every picture specify it's filename.  If the picture is not in
  63. the current directory you must also specify it's complete path.  
  64.  
  65. To clarify this I will give some examples. 
  66.  
  67. Display pictures  pic_a pic_b pic_c pic_d and pic_e in the current
  68. directory for 10 seconds each.
  69.  
  70. Command line  : PicView 10 pic_a pic_b pic_c pic_d pic_e
  71.  
  72. Display pictures pic_a pic_b and Pic_c on drive df1: for 5 seconds
  73. each. (Remember : 5 seconds is the program's default displaytime).
  74.  
  75. Command line  : PicView df1:pic_a df1:pic_b df1:pic_c
  76.  
  77. Display pictures pic_a on drive df1:Pictures and pic_b in df2:show
  78. for 20 seconds each.
  79.  
  80. Command line  : PicView 20 df1:Pictures/pic_a df2:show/pic_b
  81.  
  82. Requirements: 
  83.  
  84. - A standard Amiga with 512KByte of memory will suffice. Make sure
  85.   though, that there is enough  free memory or the program aborts.
  86.  
  87. The program should support all regular  Amiga devices. I tested it 
  88. with DF0: to DF3:, VD0:, VDK:, RAM:, CARD: and DH0: to DH2:. It is 
  89. compatible with both  WorkBench 1.2 and 1.3. I haven not tested it 
  90. with 1.1 though. It also works on Amiga 2000 with 1 MB of ChipMem.
  91. (Rev 6 and higher.) 
  92.  
  93. NOTICE: 
  94.  
  95. This software is  supplied as is, and  neither the  author nor the 
  96. distributor is liable or responsible for any  damage to either the 
  97. computer or any pheripherals or media this software is used on. 
  98.  
  99. 3. Copyright. 
  100.  
  101. This program is considered FreeWare. It may be copied freely. When
  102. doing so please adhere to the following rules.
  103.  
  104. - The program may not be used or bundled by any software retailing
  105.   over US$ 10.00 (British £ 3.00), or it's equivalent in any other 
  106.   currency, without prior written permission from the author. 
  107.  
  108. - This document must always accompany the program. 
  109.  
  110. - This document may not be altered.
  111.  
  112. - The author  retains the right to  remove this  program  from the 
  113.   Public Domain at any time, without prior notification. 
  114.  
  115. 4. Distribution. 
  116.  
  117. Distribution rights are  hereby, of course,  granted to Fred Fish, 
  118. and any other non-profit organisation.  Persons wanting to include 
  119. this program andd / or it's  source on any disk retailing over US$ 
  120. 10.00 ( British £3.00 ), or it's equivalent in any other currency,
  121. must first obtain written permission for this from the author. 
  122.  
  123. 5. BUG-Reports. 
  124.  
  125. Known Bugs:
  126.  
  127. - PAL HiRes Overscan is not fully supported.  The 'PAL' section of
  128.   the screen stays black.  (On an Amiga 1000, as well as the 2000)
  129.   Irritating. This should not happen. Seems to be a systems bug. 
  130.  
  131. Send Report To:
  132.  
  133. Accidents will happen and I'm only human. If you find a bug or you 
  134. think you  might have found a bug, please  print out the following 
  135. form on you printer,  fill in the  neccessary details, and sent it 
  136. to the address mentioned on it. Thanks! 
  137.  
  138. ------------------- Cut Here Please ------------------------------ 
  139.  
  140. +----------------------------------------------------------------+ 
  141. |                           BUG Report                           | 
  142. +----------------------------------------------------------------+ 
  143. | Program     : PicView         Version     : 1.0                | 
  144. +----------------------------------------------------------------+ 
  145. | Bug         :                                                  | 
  146. |                                                                | 
  147. |                                                                | 
  148. |                                                                | 
  149. |                                                                | 
  150. |                                                                | 
  151. |                                                                | 
  152. +----------------------------------------------------------------+ 
  153. | Additional information                                         | 
  154. | Error code  :                                                  | 
  155. |                                                                | 
  156. |                                                                | 
  157. |                                                                | 
  158. |                                                                | 
  159. |                                                                | 
  160. |                                                                | 
  161. +----------------------------------------------------------------+ 
  162. | Sent to:    P. Kolenbrander                                    | 
  163. |             <BUG-Report PicView 1.0>                           | 
  164. |             Turfveldenstraat 37                                | 
  165. |             NL-5632 XH  EINDHOVEN                              | 
  166. |             The NETHERLANDS                                    | 
  167. |                                                                | 
  168. +----------------------------------------------------------------+ 
  169.        
  170. ------------------- Cut Here Please ------------------------------ 
  171.  
  172. 6. Donations. 
  173.  
  174. This program is considered Freeware. Meaning that if you find this
  175. program useful, you are kindly requested to make this noted to the 
  176. author.  Preferably by means of a (cash!) donation or other useful
  177. token of appreciation.  This is not mandatory as is with Shareware 
  178. programs however.
  179.  
  180. If you have any cash to spare, it is always welcome. Unfortunately 
  181. I have my expenses also. Donations in other form, like disks, (PD) 
  182. software, Sonix Scores!, home-built programs / hardware  etc,  are
  183. of course also welcome. Remember: 
  184.  
  185.             'It is better to give than to receive!' 
  186.   (I've given you this program, so now it's you turn, isn't it?) 
  187.  
  188. Enjoy the program! 
  189.  
  190. My address is: P. Kolenbrander 
  191.                Turfveldenstraat 37 
  192.                NL-5632 XH  EINDHOVEN 
  193.                HOLLAND 
  194.  
  195. No phone, not since some guy woke me at  04:00 AM ( My local time, 
  196. not his!). So, if you feel it is that  urgent to call me you won't   
  197. mind taking the trouble of finding out my phonenumber. But PLEASE! 
  198. check the  time-differences. I can get  pretty  uncooperative when 
  199. called out of bed in the middle of the night!
  200.