home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / graphics / picem301.zip / PICEM.DOC next >
Text File  |  1993-07-21  |  13KB  |  284 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). You may use
  8. PICEM to display images in a commercial circumstance. For instance you
  9. can use PICEM to show sample images at a trade show, or give away PICEM
  10. to show some example images in a book on fractals. But you cannot sell
  11. a book on "creating presentations with PICEM" and include PICEM (as a
  12. widely unlikely example (grin)). And you cannot sell a "Swimsuit Calendar"
  13. with PICEM as the engine which drives it.
  14.  
  15.  If you are unsure if your particular use of PICEM does not fall under
  16. the free-use description above, contact me for clarification.
  17.  
  18.  
  19.  .PIC    images are PC Paint and PICTOR images. PC Paint is published by MSC
  20.     tech, (previously named "Mouse Systems"). PICTOR is the Paint program
  21.     which is part of the GRASP package published by Paul Mace Software.
  22.  
  23.  .PCX    images are PC Paintbrush format images. PC Paintbrush is published
  24.     by Z-Soft.
  25.  
  26.  .GIF    images are Graphics Interchange Format, a generalized picture format
  27.     supported by Compuserve,  The PICS Series of Forums on Compuserve
  28.     is one of the best places to obtain an assortment of image files
  29.     including some stunning high resolution 256 color images (ideal
  30.     for VGA and SuperVGA cards).
  31.  
  32.  .TGA    images are Targa HiColor format images. Originally created for the
  33.         AT&T Targa series of video cards for IBMPC's. The two types of
  34.         Targa files PICEM accepts are Targa 16 files (which are actually
  35.         15 bits per pixel), and Targa 24 files.
  36.  
  37.  
  38. Keys available in PICEM when in the picture select list screen:
  39. -------------------------------------------------------------------------------
  40. Arrow keys  - scroll around picture list to select picture filenames
  41. SPACE       - mark/unmark image names for display
  42. *           - mark all image names for display
  43. RETURN      - display the current selected picture and any others selected
  44.               with SPACE
  45. ESC         - exit program
  46.  
  47.  
  48. Keys available in PICEM while viewing images:
  49. -------------------------------------------------------------------------------
  50. Arrow keys  - scroll around picture (if image is larger than screen)
  51. *           - reset to original contrast and brightness
  52. +           - increase contrast, (bring out colors in a flat image)
  53. -           - decrease contrast, (reduce washed-out dark colors in pale image)
  54. Ins         - increase brightness, (bring up details hidden in darkness)
  55. Del         - decrease brightness, (reduce the overexposed effect of a high
  56.               contrast setting)
  57. 1,2...8,9,0 - set speed for +,-,Ins and Del, (how fast contrast and brightness
  58.               controls function with 1 slowest and 0 fastest
  59. SPACE       - skip to the next picture selected
  60. RETURN      - exactly the same as SPACE
  61. TAB         - Scale image to exactly screen size (great for large images
  62.               that don't fit on screen, favorite of users of standard
  63.               VGAs that use mode W for viewing 640x480 images)
  64. W           - write picture to disk as BAS PIC GIF PCX or IMG
  65. BACKSPACE   - display test pattern (in 256 color modes only)
  66. ESC         - exit program
  67.  
  68.  
  69. Command line Parameters for PICEM
  70. -------------------------------------------------------------------------------
  71.  
  72. PICEM {/k /l /w:t /v:vmode{,xsize,ysize,vnum} /d:x,y /m /c} fname ...
  73.  
  74. /k          - do not wait for a keypress between pictures
  75.  
  76. /l          - display pictures in continous loop
  77.  
  78. /s          - scale all images to screen size (like TAB key)
  79.  
  80. /w:t        - Wait t number of 1/100ths of a second after each picture
  81.  
  82. /n          - Don't sort list of filenames
  83.  
  84. /e          - Don't clear screen on exit (leave image on screen)
  85.  
  86. /d:x,y      - set lower left hand coordinates to display picture
  87.  
  88. /d          - force centering of image (default)
  89.  
  90. /m          - multi-picture display prevents palette switch between
  91.               display of multiple images
  92.  
  93. /c          - clear the screen
  94.  
  95. /v:vnum
  96.       vnum  - BIOS video mode number to set (vmode defaults to 'L')
  97.               this is the short order version of the full /v: option
  98.               it is intended for SuperVGA modes.
  99.  
  100. /v:vmode{,xsize,ysize,vnum}
  101.       vmode - video mode most similar to the mode you are choosing:
  102.  
  103. A   CGA 4 color                         B   PCjr/Tandy 16 color                         
  104. C   CGA 640x200 2 color                 D   EGA 640x200 16 color                         
  105. E   EGA 640x350 2 color                 F   EGA 640x350 4 color                         
  106. G   EGA 640x350 16 color                H   Hercules 720x348 2 color                         
  107. I   VGA 640x350 16 color                J   EGA 320x200 16 color                         
  108. K   AT&T/Toshiba 640x400 2 color        L   VGA/MCGA 320x200 256 color                         
  109. M   VGA 640x480 16 color                N   Hercules InColor 720x348 16 color                         
  110. O   VGA/MCGA 640x480 2 color            P   EGA/VGA 800x600 2 color                         
  111. Q   EGA/VGA 800x600 16 color            R   S-VGA 640x400 256 color                         
  112. S   S-VGA 640x480 256 color             T   S-VGA 800x600 256 color                         
  113. U   S-VGA 1024x768 2 color              V   S-VGA 1024x768 16 color                         
  114. W   VGA 360x480 256 color               X   S-VGA 1024x768 256 color                         
  115. Y   S-VGA 1280x1024 16 color            Z   S-VGA 1280x1024 256 color                         
  116. L1  S-VGA 320x200 HiColor 15            S1  S-VGA 640x480 HiColor 15                         
  117. T1  S-VGA 800x600 HiColor 15            X1  S-VGA 1024x768 HiColor 15                         
  118. Z1  S-VGA 1280x1024 HiColor 15          L2  S-VGA 320x200 HiColor 16                         
  119. S2  S-VGA 640x480 HiColor 16            T2  S-VGA 800x600 HiColor 16                         
  120. X2  S-VGA 1024x768 HiColor 16           Z2  S-VGA 1280x1024 HiColor 16                         
  121. L3  S-VGA 320x200 HiColor 24            S3  S-VGA 640x480 HiColor 24                         
  122. T3  S-VGA 800x600 HiColor 24            X3  S-VGA 1024x768 HiColor 24                         
  123. Z3  S-VGA 1280x1024 HiColor 24
  124.  
  125.       xsize - optional width of the video mode you have chosen in pixels
  126.       ysize - optional height of the video mode you have chosen in pixels
  127.       vnum  - the BIOS video mode number for the mode you have chosen
  128.  
  129.  
  130. Other command line options:
  131.  
  132. /vesa       - Only test for VESA VBE support, do not do any low level
  133.               SVGA chipset detect (which can cause problems on some
  134.               video cards).
  135.  
  136. /nosvga     - Disable all SVGA testing/support including VESA VBE support.
  137.               This option may be required on old or unusual hardware which
  138.               may react badly to SVGA detect or even the VESA Video Bios
  139.               Extensions detect call.
  140.  
  141. /biospal    - Forces PICEM to use the standard Video BIOS function call for
  142.               setting the VGA color palette. This may be required on some
  143.               Local Bus video card that do not handle high speed direct
  144.               writes to the palette RAMDAC. The symptom is generally random
  145.               errors in the image (some colors are wrong). This can also
  146.               happen on some early VGA clones which had bugs in their palette
  147.               support.
  148.  
  149. /noems      - Disable use of EMS for swapping
  150.  
  151. /noxms      - Disable use of XMS for swapping
  152.  
  153. /nodisk     - Disable use of a Read/Write Swapfile on the current drive.
  154.  
  155.  
  156.  PICEM accepts wildcard filenames, so you could:
  157.  
  158.         PICEM \PICS\*.GIF
  159. or
  160.  
  161.         PICEM /V:W /W:50 \CIS\*.GIF
  162.  
  163. or
  164.         PICEM /V:L /K /D:20,30 FRAME??.PIC
  165.  
  166. or
  167.         PICEM /V:S1 *.TGA
  168.  
  169.  
  170.  PICEM supports a wide variety of Video boards, with a primary emphasis on
  171. VGA/SuperVGA boards.  On VGA boards PICEM defaults to /V:W which is
  172. 360x480 256 colors (a non-standard mode, but it's the best 256 color mode
  173. available on a standard VGA). On SuperVGA boards PICEM defaults to /V:R
  174. which is 640x350/640x400 256 colors on boards with only 256k, and /V:S
  175. which is 640x480 256 colors on boards that have 512k or more.
  176.  Some boards such as the ATI and Orchid may be capable of 800x600 256
  177. colors, but since many monitors will not handle this mode, I don't
  178. default to it, you can manually select it with /V:T.
  179.  Also if your board has a odd resolution 256 color mode that you would like
  180. to take advantage of (such as the Everex 512x480 mode, or the Genoa 720x512
  181. mode) you can manually override the BIOS mode used. For instance to set
  182. 512x480 on a Everex  board we would do PICEM /V:0x15 (the 0x means hexidecimal,
  183. the way most bios mode numbers are written in manuals, the same number in
  184. decimal would be PICEM /V:21).
  185.  
  186.  For any bug reports I can be contacted on CIS (Compuserve) ID:75300,2137 in
  187. the PICS Forum, To enter the PICS forum on Compuserve just type "GO PICS"
  188. from any prompt.
  189.  
  190.  
  191. John Bridges 7/21/1993
  192.  
  193.  
  194.  
  195. Bug fixes:
  196.  
  197. 10/09/91 -   /d:0,0 will now work (it used to center the image)
  198.  
  199. 10/11/91 -   /d with no colon resets to centering images
  200.              and the /d: and /d parm can be mixed with filenames
  201.              to display images at different positions.
  202.  
  203. 10/12/91 -   oops, the multiple /d: and /d parms were skipping
  204.              filenames.
  205.  
  206. 10/14/91 -   /c is new command line option to force screen to clear.
  207.              /m is new command line option to prevent palette change
  208.              between images.
  209.          the first /d: and /d parms MUST be just before the
  210.              first filename after all other parms. This applies
  211.              to all parms that can be mixed in with filenames
  212.          (right now this is /d: /d /c and /m).
  213.              @filename on the command line allows a list of command
  214.              line parms to be read it from a file.
  215.          New tiny version of picem called TPICEM.EXE is now
  216.              available. It removed the image selection screen, the
  217.              palette manipulation (brightness/contrast), the test
  218.              screen, the help screens and the image save.
  219.  
  220. 10/19/91 -   support for OAK Tech OTI-077 chipset is in
  221.       
  222. 10/24/91 -   better accuracy and overflow checking in brightness and
  223.              contrast control code, it's completely rewritten, much
  224.              smoother.
  225.  
  226. 10/25/91 -   * key selects all pictures when in picture list display.
  227.  
  228.  1/20/92 -   new version number because support for ACUMOS and ATI are
  229.              added, and some other library bugs are fixed.
  230.  
  231.  1/24/92 -   GIF load code corrected to handle extension blocks at the
  232.              beginning of images.
  233.  
  234. 10/26/92 -   I removed the long list of chipset makers and video mode
  235.              numbers. This information is still available in VGAKIT.
  236.  
  237.  6/25/93 -   Rewritten to use new virtual memory system I created for
  238.              Multi-Media GRASP 5.0
  239.  
  240.              EMS/XMS and disk swapping support
  241.  
  242.              HiColor video modes (15 and 16 bit)
  243.  
  244.              New 32bit bitblit code (on 386/486 processors)
  245.  
  246.              High speed scaling
  247.  
  248.              Uncompressed Targa and TIFF images support
  249.  
  250.              Better support of odd text modes (VESA VBE ones in particular)
  251.  
  252.       
  253.  7/20/93 -   New command line options to control EMS/XMS/Disk swapping.
  254.  
  255.              New command line options /NOSVGA, /VESA, and /BIOSPAL
  256.      
  257.              Support for automatic conversion of 256 color for display in
  258.              HiColor modes (including scaling).
  259.  
  260.              Auto conversion of 24 bit, 16 bit and 15 bit images to any
  261.              HiColor mode (including scaling).
  262.  
  263.              New hispeed scaling code for HiColor video modes.
  264.  
  265.              HiColor images can be displayed in 256 color modes, there is
  266.              a slight delay while the lookup table is generated, and
  267.              the current palette is used (which is useually not an optimum
  268.              palette).
  269.  
  270.              List of modes in help is now limited to detected available
  271.              video modes (making the list more readable, and allowing
  272.              HiColor modes to be listed).
  273.  
  274.  7/20/93 -   Fixed 256 color display of Hicolor 16 and 24 bit images, and
  275.              sped up scrolling/scaling of Hicolor images in 256 color mode.
  276.  
  277.  7/21/93 -   VGA 16 color modes weren't working in 3.01 and 3.01b, ooops.
  278.  
  279.  
  280.       
  281.  
  282.  
  283.  
  284.