home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DVPEG30D.ZIP / DVPEG.DOC next >
Text File  |  1993-11-10  |  17KB  |  452 lines
  1.           Dvpeg 3.0a - dvpeg.doc file
  2.             ---------------------------------
  3.  
  4. Use:  Dvpeg is a DOS based (286 or up) JPEG / GIF / Targa / PPM viewer
  5.     that will run under DOS, Windows, OS\2.
  6.  
  7.  
  8.   Limitations
  9.   -----------
  10.   Viewing of JPEG, some Targa and all PPM images require a 15/16/24 bit
  11.   video card for speed and image quality.  JPEG images can be viewed on
  12.   256 color modes but will take longer to decode.  Targa and PPM images
  13.   can be viewed on 256 color modes but they will be in grayscale.  If the
  14.   original image was color the red portion is used to set the brightness.
  15.  
  16.   16 color modes are supported as color or gray.  Nothing less (ie
  17.   monochrome) is supported.
  18.  
  19.  
  20.   Speed
  21.   -----
  22.   For maximum speed set the shrinking to 1:1
  23.   You can always shrink the picture after if the panning is on.
  24.   For faster JPEGs on 16 color modes turn off the quantizing (default).
  25.   For speed on 256 or 16 color card use 1 pass quantize or grayscale viewing.
  26.  
  27.  
  28.   JPEG Image Quality
  29.   ------------------
  30.   For more quality on 256 color modes use 2 pass quantizing.
  31.   For more quality on 16 "color" modes (well gray) turn on the quantizing.
  32.   Best quality for 16 & 256 color video mode JPEGs is 2 pass quantizing.
  33.  
  34.  
  35. To run dvpeg use:
  36.  dvpeg <file_path>\<file_mask>
  37.   ie dvpeg ..\gifs\new\*.jpg
  38.     or
  39.  dvpeg <options> <@file> <picture_file(s)>
  40.   ie dvpeg +mask *.jpg
  41.  
  42. where anything in "<>" is optional
  43.  
  44. For example using:  dvpeg +title "*This is it" stars.gif +exit
  45.   will show the picture file stars.gif with the title 'This is it',
  46.   pause for a keypress and then exit.
  47.  
  48. The @file is called a response file. DOS is limited to lines of 256
  49. characters.  If you wish to have very long files of options then you can
  50. put all of the options into a text file and simply give the viewer the
  51. name of the file.  One option per line of the response file.
  52.  
  53.  
  54. Options on the command line or response file
  55. --------------------------------------------
  56. Each option must start with one of the following characters:
  57.  
  58. ; -> start of a comment line in the response file (line is ignored)
  59. + -> turns an option on
  60. - -> turns an option off
  61. * -> the rest of this arguement is a text string (only used for the
  62.          title to be displayed or the text line; nothing else
  63. Anything else is assumed to be the a filename for viewing
  64.  
  65. For each option you must use at least the first 3 characters.
  66. For each of the lines a # symbol means that a number is expected.
  67.  
  68. NOTE:  There is a difference between response files and command line
  69. options.  For example on the command line you need double quotes around
  70. character strings while they are not required for response files.
  71.   ie on the command line: +name "*copyright message here"
  72.       or the response file: +name *copyright message here
  73.  
  74. All options require a + or - prefix.
  75.  
  76.  
  77. External Control Options (not available in the viewer)
  78. ------------------------------------------------------
  79. config    -> the name of the configuration file must follow this
  80.  
  81. clscreen    -> setup, clear the text screen and print title
  82.  
  83. notext    -> do not return to text screen when exiting DVPEG
  84.     -> this will leave the picture on the screen in graphics mode
  85.  
  86. name    -> with this you can set the name printed in the lower left corner
  87.     -> if a text string follows it will be used as the string to print
  88.     -> otherwise the file name is used
  89.     -> ie -name or +name or +name *This is the file name
  90.  
  91. title    -> this allows you to print a title to the top, center of the screen
  92.     -> if a text string follows it will be used, if there is no string
  93.     -> then the 4DOS file description is the default
  94.  
  95. controls  -> turn pause after decoding picture on/off (on = no pause)
  96.     -> this is reset to pausing after a slideshow
  97.     -> pausing means waiting for a keypress
  98.  
  99. usefiles    -> don't clear the list of files added to the slideshow list
  100.     -> this means the slideshow files will be the only ones on the
  101.     -> file list when it pops up
  102.  
  103. exit    -> this will result in an immediate exit from the viewer, it will
  104.     -> not set the text screen unless the notext option is off!
  105.  
  106.  
  107. Control Options (changable within the viewer)
  108. ---------------------------------------------
  109. nolist -> turn off the file selection list,  The user then has 3 options;
  110.      ESC to exit, RTN and N for next picture, P for previous picture.
  111.      No other options exist.
  112.  
  113. delay #  -> the delay between pictures in the slideshow
  114.  
  115. keypress -> wait for an immediate keypress
  116.  
  117. lock #  -> This will lock/unlock the viewer into using one video resolution
  118.     -> for example +lock 480 will lock it into the 640 * 480 mode for
  119.     -> all pictures, -lock will turn it off -> no number is expected
  120.  
  121. menu  -> this will turn the menu on ie where you can select the video
  122.     -> resolution and change some options like panning
  123.  
  124. beep  -> turn the end of picture beep on or off
  125.  
  126. mask  -> if + add a file mask to the list (maximum 5 currently)
  127.     -> if - then clear the list of file masks
  128.  
  129. tree -> turn file tree on/off
  130.  
  131. drives -> turn list of drives on/off
  132.  
  133. long -> toggle file list between short/long
  134.  
  135. fifty -> turn 50 line text mode on/off
  136.  
  137. clgr -> turn clear_graphics_screen_before_draw on/off
  138.  
  139. path -> set the file drive, path used by the viewer ie d:\pics\new
  140.     -> do not use a \ at the end
  141.     -> other examples:  \\gifs\new  ie hop back to the root but keep drive
  142.     ->  or ..\test\pics ie hop back one branch and add to it
  143.     ->  or pics\new  ie add to the current dir. path (don't need .\)
  144.  
  145.  
  146. Slideshow Options
  147. -----------------
  148. initshow -> initialize the slideshow and clear the list of files
  149.     -> this must be called before any slideshow files are put into
  150.     -> the list
  151.  
  152. addslide -> add a file name to the slideshow
  153.  
  154. slideshow -> start the slideshow of the given file names
  155.      -> it will exit if the user hits ESC or there is a file error
  156.      -> on a severe error the viewer may terminate
  157.      -> the continous slideshow flag is cleared upon exiting the show
  158.  
  159. continous -> if used before slideshow the show will run continously
  160.  
  161.  
  162. Viewing Options
  163. ---------------
  164. -shrink   -> turn automagic shrinking on/off (shrink to fit video mode by
  165. +shrink #    -> using 1/1, 1/2, 1/3, .. 1/6
  166.     -> if the shrinking is being turned on the it must be followed with
  167.     -> a number, 0 = automatic, anything else will lock the shrink ratio
  168.  
  169. panning    -> turn the panning ability on/off
  170.     -> this can use a lot of memory and take time
  171.     -> do not use this when doing a slideshow since the user can not
  172.     -> (currently) do any panning or adjust any controls
  173.  
  174.  
  175. JPEG Options
  176. ------------
  177. grayscale -> turn grayscale viewing for JPEGs on/off
  178.  
  179. quantize    -> turn 2 pass quantizer on/off
  180.  
  181. dithering    -> turn JPEG dithering on/off
  182.  
  183.  
  184.  
  185. Memory requirements
  186. -------------------
  187.   GIF viewing typically requires 190,000 bytes.
  188.   JPEGs take 172,000 + X size * 144  (X size is the width of the picture)
  189.  
  190.   If the image is going to be panned then even more memory (EMS, XMS, ..)
  191.   is required.  In the case of 640 * 480 picture in a 15/16 bit mode
  192.   (ie hi-color) then another 1M of memory is required.  If this can not
  193.   be found the program will use temporary files on the harddrive (slow).
  194.   Extra memory for panning is simply:  X size * Y size * bytes per pixel.
  195.      Where 16, 256 color is 1 byte/pixel
  196.          15/16 bit are 2 bytes/pixel
  197.          24 bit is 3 bytes/pixel
  198.  
  199. Memory Problems with JPEGs
  200. --------------------------
  201.   If you are running out of memory then most likely it is
  202.   the 'low' or below 640k memory.  You will have to remove some drivers or
  203.   other items that are using the lower memory.  One way to free up a bit of
  204.   memory (and speed up viewing) in DVPEG for JPEGs is to:
  205.  - under F7, reduce the buffer to 4k (default is 16k)
  206.  - use the 1 pass quantizer or Greyscale
  207.  - turn off the panning (you can still shrink the image as it shows)
  208.  
  209. Video Problems
  210. --------------
  211.   1) Only 256 color, hi-color (15/16 bit) and true-color (24 bit) video cards
  212.    are supported.  16 color (VGA) is supported as 16 shades of gray only.
  213.   2) CGA, Hercules and anything less than 16 colors is not supported
  214.   3) If your video card is not supported use a VESA TSR or driver.
  215.    The UNIVESA.exe VESA driver can support more video cards than my program.
  216.    If your video card does not seem to be supported by the viewer then
  217.    run UNIVESA.exe to install the universal VESA driver (it stays in
  218.    memory until the computer is reset)
  219.   4) If you find the vidsetup.exe program hard to use:
  220.   4.1) delete the dvpeg.cfg file if it was created
  221.   4.2) run DVPEG
  222.   4.3) If you have problems with pictures not showing properly:
  223.    Run VIDSETUP.exe and
  224.    hit enter twice, arrow to video modes which your card does not
  225.    work with; delete them; hit ESC twice and type Y to save the data
  226.      I am sorry but that is about as easy as it gets
  227.   5) If no images appear on the screen then chances are that the at least
  228.    one of the video modes in the list is not supported by the video card
  229.    you have.  Use vidsetup to test the modes and delete the offending
  230.    one from the list.
  231.    Vidsetup.exe does not have a clue which video modes are supported by
  232.    a certain video card and this is the cause of many problems.
  233.  
  234.  
  235. To find out about options, hit F1 at any time.
  236.  
  237. Check the read.me file for detailed information about vidsetup.exe, dvpeg.exe,
  238. dvpeg286.exe
  239.  
  240. Basically:
  241.  vidsetup.exe  - allows setting of defaults for the viewer (dvpeg) and
  242.     testing of video modes
  243.  dvpeg.exe     - 386/486 viewer
  244.  dvpeg286.exe  - 286 viewer
  245.  dvpeg-re.exe  - 386 JPEG/GIF (only) viewer with reduced features
  246.  
  247. The JPEG conversion code came from the Independant JPEG Group (more
  248.   info is in the source code file) and a lot of the video drivers came from
  249.   the vgakit41.zip.  Their code was free so this is as well.  The UNIVESA.exe
  250.   program is from svgakitXX.zip
  251.  
  252. Please send any comments / suggestions to praetzel@sunee.uwaterloo.ca
  253.  
  254. P.S.  Many thanks to my beta testers and those who shared their knowledge.
  255.         I would also like to thank Tom Lane and the IJG along with various
  256.         people who have compiled video information (VGAKIT, VGADOC) that is on
  257.         most big sites.
  258.  
  259. - Eric (praetzel@sunee.uwaterloo.ca)
  260.  
  261.  
  262. ******************************************************************************
  263.  
  264. Any video card with a VESA driver (TSR or built into the BIOS) should work.
  265. You can get VESA drivers for many video cards.  I have included the
  266. UNIVESA.EXE driver that people with video problems can try.  It has been
  267. replaced by an improved share-ware product.
  268.  
  269. This is a list of the supported cards and modes.
  270. IT IS NOT COMPLETE.  CHECK VIDSETUP FOR THE FULL LIST OF SUPPORTED MODES
  271. (or the file modes.h in the source code).
  272.  
  273. Not all cards from a Mfg will support all of these modes.  In most cases you
  274. will need 1 Meg of video ram for the hi resolution modes and some modes (like
  275. the hi_color ones) are recent additions and only supported by the most recent
  276. cards sold.  To test a certain mode on your video card/moniter setup use
  277. vidsetup.exe  Usually if the mode is not supported the video card locks up
  278. and you can't get back to the text screen.  The only solution is to reset
  279. the computer.
  280.  
  281.  
  282. Diamond SpeedStar 24X, Paradise, WD compatable cards
  283. ----------------------------------------------------
  284.  
  285. ** All modes for this card have to be added by hand.  The card is not
  286. **   automatically detected.
  287.  
  288. All modes for this card should be supported.
  289.  
  290. =============================================================================
  291.  
  292. S3 based cards
  293. --
  294.  
  295. ** All modes for this card have to be added by hand.  The card is not
  296. **   automatically detected.  There are at least three different 24 bit
  297. **   modes being used by versions of video cards with the S3 chips.
  298.  
  299. =============================================================================
  300.  
  301. AHEAD (A & B chipsets)
  302. -----
  303.     width        height        colors        Direct Mode
  304.     -----      ------      ------      -----------
  305. 0x60          640           400           256             R
  306. 0x61          640           480           256               S
  307. 0x62          800           600           256               T
  308. ===============================================================================
  309.  
  310. ATI
  311. ---
  312.         width        height        colors        Direct Mode
  313.         -----        ------        ------        -----------
  314. 0x61          640           400           256             R
  315. 0x62          640           480           256               S
  316. 0x63          800           600           256               T
  317. 0x72 (hi_color)   640              480          32,768
  318. 0x73 (hi_color)   800              600          32,768
  319. 0x75 (24 - bit)  630               480          16 million
  320. ===============================================================================
  321.  
  322. CHIPS & TECH
  323. ------------
  324.         width        height        colors        Direct Mode
  325.         -----        ------        ------        -----------
  326. 0x78          640           400           256             R
  327. 0x79          640           480           256               S
  328. 0x7b          800           600           256               T
  329. ===============================================================================
  330.  
  331. EVEREX
  332. ------
  333.         width        height        colors        Direct Mode
  334.         -----        ------        ------        -----------
  335. 0x13          640           350           256
  336. 0x14          640           400           256             R
  337. 0x15          512           480           256
  338. 0x30          640           480           256             S
  339. 0x31          800           600           256             T
  340. ===============================================================================
  341.  
  342. OAK TECH
  343. --------
  344.         width        height        colors        Direct Mode
  345.         -----        ------        ------        -----------
  346. 0x53          640           480           256               S
  347. 0x54          800           600           256               T
  348. ===============================================================================
  349.  
  350. GENOA GVGA
  351. ----------
  352.         width        height        colors        Direct Mode
  353.         -----        ------        ------        -----------
  354. 0x7d              512           512            256
  355. 0x5b              640           350            256
  356. 0x7e              640           400            256             R
  357. 0x5c              640           480            256             S
  358. 0x5d              720           512            256
  359. 0x5e or 0x6c      800           600            256             T
  360. ===============================================================================
  361.  
  362. NCR
  363. ---
  364.         width        height        colors        Direct Mode
  365.         -----        ------        ------        -----------
  366. 0x5e          640           400           256             R
  367. 0x5f          640           480           256               S
  368. 0x5c          800           600           256               T
  369. ===============================================================================
  370.  
  371. PARADISE
  372. --------
  373.         width        height        colors        Direct Mode
  374.         -----        ------        ------        -----------
  375. 0x5e          640           400           256             R
  376. 0x5f          640           480           256               S
  377.  
  378. 1M card is also supported seperately.  These have to be added by hand with
  379. vidsetup.exe  Do not allow the autodetection program to run (ie hit N to
  380. avoid it when you run vidsetup or else your BIOS setting may be destroyed).
  381.  
  382. ===============================================================================
  383.  
  384. TRIDENT
  385. -------
  386.         width        height        colors        Direct Mode
  387.         -----        ------        ------        -----------
  388. 0x5c          640           400           256             R
  389. 0x5d          640           480           256               S
  390. 0x5e          800           600           256               T
  391. ===============================================================================
  392.  
  393. TRIDENT 8900
  394. ------------
  395.         width        height        colors        Direct Mode
  396.         -----        ------        ------        -----------
  397. 0x5c          640           400           256             R
  398. 0x5d          640           480           256               S
  399. 0x5e          800           600           256               T
  400. 0x62         1024           768           256             X
  401. ===============================================================================
  402.  
  403. TSENG  (Genoa, Orchid, Willow)
  404. -----
  405.         width        height        colors        Direct Mode
  406.         -----        ------        ------        -----------
  407. 0x2d          640           350           256             R
  408. 0x2e          640           480           256               S
  409. 0x2f          720           512           256
  410. 0x30          800           600           256               T
  411. 0x38         1024           768           256             X
  412. ===============================================================================
  413.  
  414. TSENG 4000
  415. ----------
  416.         width        height        colors        Direct Mode
  417.         -----        ------        ------        -----------
  418. 0x2d          640           350           256
  419. 0x2f          640           400           256             R
  420. 0x2e          640           480           256               S
  421. 0x30          800           600           256               T
  422. 0x38         1024           768           256               X
  423. 0x13 (hi_color)   320              200          32,768
  424. 0x2d (hi_color)   640              350          32,768
  425. 0x2f (hi_color)   640              400          32,768
  426. 0x2e (hi_color)   640              480          32,768
  427. 0x30 (hi_color)   800              600          32,768
  428. ===============================================================================
  429.  
  430. VIDEO7
  431. ------
  432.         width        height        colors        Direct Mode
  433.         -----        ------        ------        -----------
  434. 0x66          640           400           256             R
  435. 0x67          640           480           256               S
  436. 0x68          720           540           256
  437. 0x69          800           600           256               T
  438. 0x6A         1024           768           256             X
  439. ===============================================================================
  440.  
  441. VESA
  442. ----
  443.          width           height          colors          Direct Mode
  444. -----        ------        ------        -----------
  445. 0x13              320              200             256
  446. 0x100             640              400             256
  447. 0x101             640              480             256
  448. 0x103             800              600             256
  449. 0x105             1024             768             256
  450. 0x107             1280            1024             256
  451.  
  452.