home *** CD-ROM | disk | FTP | other *** search
/ Clip-Art Cornucopeia / Clip-Art_Cornucopeia_CD-ROM_February_1994.iso / mac / UTILS / PICEM.DOC next >
Text File  |  1992-01-24  |  15KB  |  411 lines
  1.  
  2.  
  3.  PICEM is a general purpose picture view program which also allows you to
  4. adjust the brightness and contrast in your pictures and save them back out.
  5.  
  6.  PICEM is not shareware, it is freeware, meaning that you can copy and
  7. distribute PICEM on a non-profit basis (you cannot sell it).
  8.  
  9.  
  10.  .PIC    images are PC Paint and PICTOR images. PC Paint is published by MSC
  11.     tech, (previously named "Mouse Systems"). PICTOR is the Paint program
  12.     which is part of the GRASP package published by Paul Mace Software.
  13.  
  14.  .PCX    images are PC Paintbrush format images. PC Paintbrush is published
  15.     by Z-Soft.
  16.  
  17.  .GIF    images are Graphics Interchange Format, a generalized picture format
  18.     supported by Compuserve,  The PICS Trilogy of Forums on Compuserve
  19.     is one of the best places to obtain an assortment of image files
  20.     including some stunning hiresolution 256 color images (ideal
  21.     for VGA and SuperVGA cards).
  22.  
  23.  
  24. Keys available in PICEM when in the picture select list screen:
  25. -------------------------------------------------------------------------------
  26. Arrow keys  - scroll around picture list to select picture filenames
  27. SPACE       - mark/unmark image names for display
  28. *           - mark all image names for display
  29. RETURN      - display the current selected picture and any others selected
  30.               with SPACE
  31. ESC         - exit program
  32.  
  33.  
  34. Keys available in PICEM while viewing images:
  35. -------------------------------------------------------------------------------
  36. Arrow keys  - scroll around picture (if image is larger than screen)
  37. *           - reset to original contrast and brightness
  38. +           - increase contrast, (bring out colors in a flat image)
  39. -           - decrease contrast, (reduce washed-out dark colors in pale image)
  40. Ins         - increase brightness, (bring up details hidden in darkness)
  41. Del         - decrease brightness, (reduce the overexposed effect of a high
  42.               contrast setting)
  43. 1,2...8,9,0 - set speed for +,-,Ins and Del, (how fast contrast and brightness
  44.               controls function with 1 slowest and 0 fastest
  45. SPACE       - skip to the next picture selected
  46. RETURN      - exactly the same as SPACE
  47. TAB         - Scale image to exactly screen size (great for large images
  48.               that don't fit on screen, favorite of users of standard
  49.               VGAs that use mode W for viewing 640x480 images)
  50. W           - write picture to disk as BAS PIC GIF PCX or IMG
  51. BACKSPACE   - display test pattern (in 256 color modes only)
  52. ESC         - exit program
  53.  
  54.  
  55. Command line Parameters for PICEM
  56. -------------------------------------------------------------------------------
  57.  
  58. PICEM {/k /l /w:t /v:vmode{,xsize,ysize,vnum} /d:x,y /m /c} fname ...
  59.  
  60. /k          - do not wait for a keypress between pictures
  61.  
  62. /l          - display pictures in continous loop
  63.  
  64. /s          - scale all images to screen size (like TAB key)
  65.  
  66. /w:t        - Wait t number of 1/100ths of a second after each picture
  67.  
  68. /n          - Don't sort list of filenames
  69.  
  70. /e          - Don't clear screen on exit (leave image on screen)
  71.  
  72. /d:x,y      - set lower left hand coordinates to display picture
  73.  
  74. /d          - force centering of image (default)
  75.  
  76. /m          - multi-picture display prevents palette switch between
  77.               display of multiple images
  78.  
  79. /c          - clear the screen
  80.  
  81. /v:vnum
  82.       vnum  - BIOS video mode number to set (vmode defaults to 'L')
  83.               this is the short order version of the full /v: option
  84.               it is intended for SuperVGA modes.
  85.  
  86. /v:vmode{,xsize,ysize,vnum}
  87.       vmode - video mode most similar to the mode you are choosing:
  88.  
  89.  A = CGA 4 color                      N = Hercules InColor 720x348 16 color
  90.  B = PCjr/Tandy 16 color              O = VGA/MCGA 640x480 2 color
  91.  C = CGA 640x200 2 color              P = EGA/VGA 800x600 2 color
  92.  D = EGA 640x200 16 color             Q = EGA/VGA 800x600 16 color
  93.  E = EGA 640x350 2 color              R = S-VGA 640x400 256 color
  94.  F = EGA 640x350 4 color              S = S-VGA 640x480 256 color
  95.  G = EGA 640x350 16 color             T = S-VGA 800x600 256 color
  96.  H = Hercules 720x348 2 color         U = S-VGA 1024x768 2 color
  97.  I = VGA 640x350 16 color             V = S-VGA 1024x768 16 color
  98.  J = EGA 320x200 16 color             W = VGA 360x480 256 color
  99.  K = AT&T/Toshiba 640x400 2 color     X = S-VGA 1024x768 256 color          
  100.  L = VGA/MCGA 320x200 256 color       Y = S-VGA 1280x1024 16 color
  101.  M = VGA 640x480 16 color             Z = S-VGA 1280x1024 256 color
  102.  
  103.       xsize - optional width of the video mode you have chosen in pixels
  104.       ysize - optional height of the video mode you have chosen in pixels
  105.       vnum  - the BIOS video mode number for the mode you have chosen
  106.  
  107.  
  108.  
  109.  PICEM supports a wide variety of Video boards, with a primary emphasis on
  110. VGA/SuperVGA boards.  On VGA boards PICEM defaults to /V:W which is
  111. 360x480 256 colors (a non-standard mode, but it's the best 256 color mode
  112. available on a standard VGA). On SuperVGA boards PICEM defaults to /V:R
  113. which is 640x350/640x400 256 colors on boards with only 256k, and /V:S
  114. which is 640x480 256 colors on boards that have 512k or more.
  115.  Some boards such as the ATI and Orchid may be capable of 800x600 256
  116. colors, but since many monitors will not handle this mode, I don't
  117. default to it, you can manually select it with /V:T.
  118.  Also if your board has a odd resolution 256 color mode that you would like
  119. to take advantage of (such as the Everex 512x480 mode, or the Genoa 720x512
  120. mode) you can manually override the BIOS mode used. For instance to set
  121. 512x480 on a Everex  board we would do PICEM /V:0x15 (the 0x means hexidecimal,
  122. the way most bios mode numbers are written in manuals, the same number in
  123. decimal would be PICEM /V:21).
  124.  
  125.  
  126. here is a list of VGA Chipset producers and their BIOS mode numbers:
  127.  
  128. ===============================================================================
  129.  
  130. ACUMOS
  131. ------
  132.         width        height        colors        Direct Mode
  133.         -----        ------        ------        -----------
  134. 0x59          800           600             2             P
  135. 0x58          800           600            16             Q
  136. 0x5e          640           400           256             R
  137. 0x5f          640           480           256               S
  138. 0x5c          800           600           256             T
  139. 0x5d         1024           768            16             V
  140.  
  141. AX=MODE
  142.  
  143. ===============================================================================
  144.  
  145. AHEAD
  146. -----
  147.         width        height        colors        Direct Mode
  148.         -----        ------        ------        -----------
  149. 0x6A          800           600            16             Q
  150. 0x71          800           600            16             Q
  151. 0x74         1024           768            16             V
  152. 0x60          640           400           256             R
  153. 0x61          640           480           256               S
  154. 0x62          800           600           256               T
  155. 0x63         1024           768           256             X
  156.  
  157. AX=MODE
  158.  
  159. ===============================================================================
  160.  
  161. ATI
  162. ---
  163.         width        height        colors        Direct Mode
  164.         -----        ------        ------        -----------
  165. 0x54          800           600            16             Q
  166. 0x65         1024           768            16             V
  167. 0x61          640           400           256             R
  168. 0x62          640           480           256               S
  169. 0x63          800           600           256               T
  170. 0x64         1024           768           256             X
  171.  
  172. AX=MODE
  173.  
  174. ===============================================================================
  175.  
  176. CHIPS & TECH
  177. ------------
  178.         width        height        colors        Direct Mode
  179.         -----        ------        ------        -----------
  180. 0x70          800           600            16             Q
  181. 0x72         1024           768            16             V
  182. 0x78          640           400           256             R
  183. 0x79          640           480           256               S
  184. 0x7b          800           600           256               T
  185.  
  186. AX=MODE
  187.  
  188. ===============================================================================
  189.  
  190. EVEREX
  191. ------
  192.         width        height        colors        Direct Mode
  193.         -----        ------        ------        -----------
  194. 0x01          752           410            16
  195. 0x02          800           600            16             Q
  196. 0x11         1280           350             4
  197. 0x12         1280           600             4
  198. 0x13          640           350           256
  199. 0x14          640           400           256             R
  200. 0x15          512           480           256
  201. 0x20         1024           768            16             V
  202. 0x30          640           480           256             S
  203. 0x31          800           600           256             T
  204. 0x32         1024           768           256             X
  205.  
  206. AX=0x70 BL=MODE
  207.  
  208. ===============================================================================
  209.  
  210. GENOA GVGA
  211. ----------
  212.         width        height        colors        Direct Mode
  213.         -----        ------        ------        -----------
  214. 0x7c              512           512            16
  215. 0x59              720           512            16
  216. 0x79 or 0x6a      800           600            16             Q
  217. 0x7d              512           512            256
  218. 0x5b              640           350            256
  219. 0x7e              640           400            256             R
  220. 0x5c              640           480            256             S
  221. 0x5d              720           512            256
  222. 0x5e or 0x6c      800           600            256             T
  223. 0x7f             1024           768            4
  224. 0x5f             1024           768            16             V
  225.  
  226. AX=MODE
  227.  
  228. ===============================================================================
  229.  
  230. NCR
  231. ---
  232.         width        height        colors        Direct Mode
  233.         -----        ------        ------        -----------
  234. 0x59          800           600             2             P
  235. 0x58          800           600            16             Q
  236. 0x5e          640           400           256             R
  237. 0x5f          640           480           256               S
  238. 0x5c          800           600           256               T
  239. 0x5a         1024           768             2             U
  240. 0x5d         1024           768            16             V
  241.  
  242. AX=MODE
  243.  
  244. ===============================================================================
  245.  
  246. OAK TECH
  247. --------
  248.         width        height        colors        Direct Mode
  249.         -----        ------        ------        -----------
  250. 0x52          800           600            16             Q
  251. 0x53          640           480           256               S
  252. 0x54          800           600           256               T
  253. 0x56         1024           768            16             V
  254. 0x59         1024           768           256             X
  255. 0x58         1280          1024            16             Y
  256.  
  257. AX=MODE
  258.  
  259. ===============================================================================
  260.  
  261. PARADISE
  262. --------
  263.         width        height        colors        Direct Mode
  264.         -----        ------        ------        -----------
  265. 0x59          800           600             2             P
  266. 0x58          800           600            16             Q
  267. 0x5e          640           400           256             R
  268. 0x5f          640           480           256               S
  269. 0x5d         1024           768            16             V
  270. 0x5c          800           600           256             T
  271.  
  272. AX=MODE
  273.  
  274. ===============================================================================
  275.  
  276. TRIDENT
  277. -------
  278.         width        height        colors        Direct Mode
  279.         -----        ------        ------        -----------
  280. 0x5b          800           600            16             Q
  281. 0x5f         1024           768            16             V
  282. 0x5c          640           400           256             R
  283. 0x5d          640           480           256               S
  284. 0x5e          800           600           256               T
  285.  
  286. AX=MODE
  287.  
  288. ===============================================================================
  289.  
  290. TRIDENT 8900
  291. ------------
  292.         width        height        colors        Direct Mode
  293.         -----        ------        ------        -----------
  294. 0x5b          800           600            16             Q
  295. 0x5c          640           400           256             R
  296. 0x5d          640           480           256               S
  297. 0x5e          800           600           256               T
  298. 0x60         1024           768             4
  299. 0x5f         1024           768            16             V
  300. 0x62         1024           768           256             X
  301.  
  302. AX=MODE
  303.  
  304. ===============================================================================
  305.  
  306. TSENG  (Genoa, Orchid, Willow)
  307. -----
  308.         width        height        colors        Direct Mode
  309.         -----        ------        ------        -----------
  310. 0x29          800           600            16             Q
  311. 0x37         1024           768            16             V
  312. 0x2d          640           350           256             R
  313. 0x2e          640           480           256               S
  314. 0x2f          720           512           256
  315. 0x30          800           600           256               T
  316.  
  317. AX=MODE
  318.  
  319. ===============================================================================
  320.  
  321. TSENG 4000
  322. ----------
  323.         width        height        colors        Direct Mode
  324.         -----        ------        ------        -----------
  325. 0x29          800           600            16             Q
  326. 0x37         1024           768            16             V
  327. 0x2d          640           350           256
  328. 0x2f          640           400           256             R
  329. 0x2e          640           480           256               S
  330. 0x30          800           600           256               T
  331. 0x38         1024           768           256               X
  332.  
  333. AX=MODE
  334.  
  335. ===============================================================================
  336.  
  337. VIDEO7
  338. ------
  339.         width        height        colors        Direct Mode
  340.         -----        ------        ------        -----------
  341. 0x60          752           410            16
  342. 0x61          720           540            16
  343. 0x62          800           600            16             Q
  344. 0x63         1024           768             2             U
  345. 0x64         1024           768             4
  346. 0x65         1024           768            16             V
  347. 0x66          640           400           256             R
  348. 0x67          640           480           256               S
  349. 0x68          720           540           256
  350. 0x69          800           600           256               T
  351. 0x6A         1024           768           256             X
  352.  
  353. AX=0x6f05 BL=MODE
  354.  
  355. ===============================================================================
  356.  
  357.  
  358.  
  359.  For any bug reports I can be contacted on CIS (Compuserve) ID:73307,606 in
  360. the PICS Forum, To enter the PICS forum on Compuserve just type "GO PICS"
  361. from any prompt.
  362.  
  363.  
  364. John Bridges 10/9/1991
  365.  
  366.  
  367.  
  368. Bug fixes:
  369.  
  370. 10/09/91 -   /d:0,0 will now work (it used to center the image)
  371.  
  372. 10/11/91 -   /d with no colon resets to centering images
  373.              and the /d: and /d parm can be mixed with filenames
  374.              to display images at different positions.
  375.  
  376. 10/12/91 -   oops, the multiple /d: and /d parms were skipping
  377.              filenames.
  378.  
  379. 10/14/91 -   /c is new command line option to force screen to clear.
  380.              /m is new command line option to prevent palette change
  381.              between images.
  382.          the first /d: and /d parms MUST be just before the
  383.              first filename after all other parms. This applies
  384.              to all parms that can be mixed in with filenames
  385.          (right now this is /d: /d /c and /m).
  386.              @filename on the command line allows a list of command
  387.              line parms to be read it from a file.
  388.          New tiny version of picem called TPICEM.EXE is now
  389.              available. It removed the image selection screen, the
  390.              palette manipulation (brightness/contrast), the test
  391.              screen, the help screens and the image save.
  392.  
  393. 10/19/91 -   support for OAK Tech OTI-077 chipset is in
  394.               
  395. 10/24/91 -   better accuracy and overflow checking in brightness and
  396.              contrast control code, it's completely rewritten, much
  397.              smoother.
  398.  
  399. 10/25/91 -   * key selects all pictures when in picture list display.
  400.  
  401. 1/20/92  -   new version number because support for ACUMOS and ATI are
  402.              added, and some other library bugs are fixed.
  403.  
  404. 1/24/92  -   GIF load code corrected to handle extension blocks at the
  405.              beginning of images.
  406.  
  407.  
  408.               
  409.  
  410.  
  411.