home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / GRAPHICS / DVPEG30J.ZIP / READ.ME < prev    next >
Text File  |  1994-01-09  |  15KB  |  342 lines
  1.                         DVPEG 3.0f read.me file
  2.                         -----------------------
  3.  
  4. This is an explanation of the function of the various programs that are
  5. in the DVPEG ZIP archive.
  6.  
  7.  
  8. Vidsetup.exe
  9. ------------
  10. IF YOU HAVE A PARADISE VIDEO CARD RUN THIS PROGRAM BEFORE YOU RUN DVPEG
  11. AND DO NOT RUN THE AUTODETECTION (type N).
  12.  
  13. The video setup program is the only way to edit the list of video modes
  14. that DVPEG uses.  This program allows you to change and save options that
  15. DVPEG uses.  These options can be changed in DVPEG but not saved.  The
  16. main purpose of this program is to test video modes and remove those that
  17. do not work on your video card.  Any video cards and modes that are in
  18. the user list are shown in red.
  19.  
  20.  
  21.  
  22.   Problems
  23.   --------
  24.     24 bit graphics
  25.     ---------------
  26. If the colors are not right look under F7 and change the RGB to BGR.
  27. For cards that use the Tseng 4000 chips there are several 24 bit modes.
  28. The Diamond Speed Star uses 2048 bytes/line while most others use 1920.
  29. Try the various modes in vidsetup and only keep those that work.
  30.  
  31.     Other graphics
  32.     --------------
  33. ***  If your moniter goes blank or the display is not stable when trying
  34. to display a picture, hit ESC immediately and do not use that video mode.
  35. If you find that the moniter does not display a stable picture in certain
  36. video modes then use this program to delete them.  Unfortunately the S/W
  37. has no way to know what video mode works with your card.  In some cases I
  38. can not even identify the SVGA video card although DVPEG supports it.  To
  39. solve any video related problems you must use this program.
  40.  
  41. It is best if you start off with the manual for your video card.  That
  42. should tell you what works and what does not.
  43.  
  44. I am sorry that the vidsetup.exe program could not be made more easy to
  45. use.  Future versions of DVPEG will use much more extensive S/W to identify
  46. the video card and detect its version number, amount of memory, etc and
  47. avoid this whole problem.
  48.  
  49.  
  50.         VGA or 16 Color Graphics
  51.         ------------------------
  52. This is partially supported.  It will work well for JPEGs but the
  53. quality for GIF, Targa and PNM pictures is not the best.
  54.  
  55. *************************************************************************
  56. Note:  If your video card is not supported with DVPEG directly you may
  57.        be able to get it working with a "universal" VESA driver like the
  58.        univbe VESA driver.  It supports more cards than DVPEG does and is
  59.        available at most major internet sites.
  60. *************************************************************************
  61.  
  62.   When the program starts up it will detect what type of video card you have
  63. and automatically enter all of the modes for that card in the user list.  You
  64. should find the hi-lighted card on the right of the screen is the same as
  65. the video card that is in your system.  The list of modes is in the lower
  66. right hand side of the screen.  Hit enter twice and you will get to that
  67. "window" (ESC will back you out).
  68.   If you have your video card manual, delete (delete key) any modes that are
  69. not listed in your manual.  If some modes that your card supports were not
  70. entered into the list then arrow to the mode you want to add and hit INS.
  71. You can also add custom modes, if you know a lot about your video card, with
  72. the C key (poking thru the source code to DVPEG helps - ie the modes.h file).
  73.   To test a video mode, move to the card you want to test (up/down arrows) and
  74. then hit <enter>. This will put you onto the upper right window where you can
  75. pick from the list of video modes that that card may support.  With the
  76. up/down arrow move to the video mode that you want to test and hit space.  You
  77. should see a series of vertical bars that fade in color as they go from left
  78. to right.  If you can not see the bars or the image is junk then dvpeg will
  79. not work with that mode.
  80.   When you find what card/mode combo's work with your system you can enter it
  81. into the list by hitting <insert> when you are in the upper right mode menu.
  82. To delete an item from the list hit enter until you get to the lower right
  83. user list menu.  With the up/down arrow move to the mode you want to delete
  84. and hit <delete>.
  85.   <enter> will move you "deeper" into the menu's while <escape> will more you
  86. back out.  When you are at the video card menu and you hit <escape> you will
  87. exit the video setup program.
  88.   At this point it will ask you if you want to save the information.  If you
  89. have correctly made a list of working modes for your system then hit <y> and
  90. the file dvpeg.cfg will be created for dvpeg to use.  It contains the list of
  91. working modes and a few other things (future features).
  92.  
  93.   I hope that this makes sense and you find it usable.  This is the worst
  94. part of my viewer and it will be improved in newer versions.
  95.  
  96.      Advanced features
  97.      -----------------
  98.     Using the 'F' command you can set a color to fill the screen with (any
  99.     combination of red, green, blue).  This is good for testing to see if a
  100.     newer video mode (15/16/24 bit) is properly supported.
  101.  
  102.  
  103. dvpeg286.exe (the 286 viewer)
  104. -----------------------------
  105. This is a 286 version of dvpeg. It is slightly slower but otherwise identical
  106. to the 386 version.
  107.  
  108. dvpeg.exe (the viewer)
  109. ----------------------
  110.   The first time this program is run it will look for the dvpeg.cfg file
  111. (configuration file from vidsetup.exe).  If it does not exist it will run
  112. vidsetup.  This can present a problem with some video cards.
  113.  
  114.   F1: help  (always check this as I update the program more than I do this file)
  115.  
  116.  
  117.   Advanced features
  118.   -----------------
  119.   You can save the tint, contrast, bright setting for automatic setting the
  120.   next time a file is loaded.  Use E to view the file instead of ENTER,
  121.   adjust the tint, bright, contast to your liking and hit S to save them.
  122.   To delete the settings for the picture you are viewing hit D.  These
  123.   settings are saved in the file dvpeg.vu
  124.  
  125.   4DOS file descriptions should be read and printed after the file name
  126.   If the Titles are turned on the 4DOS description will be printed.
  127.  
  128.  
  129.   Selecting (toggling) Options
  130.   ----------------------------
  131.   Generally one letter in each line will be in upper case.  When that key
  132.   is hit the option will toggle or change.
  133.  
  134.  
  135.   file_selection screen
  136.   ---------------------
  137.   You will always see subdirectors in the file listing and can move thru the
  138.             directory tree by hitting enter when over a subdirectory or .. which will
  139.      move you out one level.
  140.  
  141.   arrow keys: move around on the list of files/directories/drives
  142.   Pg Up, Pg Dn: move up/down one screen full of files
  143.   Home: move to the top of the list of files
  144.   End: move to the end of the list of files
  145.   ESC: exit the program
  146.   Enter: view the file or
  147.             move into / outof the current directory
  148.   F1: help
  149.   F2: change drive - just type a single letter  ie  d
  150.   F3: change viewing defaults (dithering, show menu, smoothing ...)
  151.   F4: change mask - type in *.gif, *.jpg ... (max. of 5 masks)
  152.   F5: change sort order (ie by name, file size, date ...)
  153.   F6: type in a new directory
  154.   F7: change some less frequently used defaults
  155.     there is lots of stuff under this including:
  156.     - enabling 50 line text mode
  157.     - turning the beep on/off
  158.     - turning error messages on/off
  159.     - changing the slide show delay
  160.     - enabling the screen clear before draw (some video cards don't clear it)
  161.     - change file buffer size for speed or to reduce memory usage
  162.     - twiddle - this controls the video screen size picked if a picture is 640 * 481
  163.       DVPEG will not use the 640 * 480 but will go to 800 * 600.  If twiddle > 1 then
  164.       the 640 * 480 screen is used - thing of it as a "slop" factor
  165.     - ......
  166.   space: select a file for slideshow viewing (turns filename red)
  167.   A:  select all files for slide show
  168.   s:  start slideshow
  169.   S:  run slideshow in a continous loop (ESC exits current picture and goes
  170.          to the next, any other key causes an exit after the current picture)
  171.   Del:  deletes the file that the cursor is on
  172.  
  173.  
  174.   pre_picture_viewing screen
  175.   --------------------------
  176.   F1: help - check this since it will be more accurate than this list
  177.   Enter: view the picture
  178.   ESC: exit to pick another file
  179.   A: switch between high/medium JPEG quality
  180.   E: turn off end of picture beep
  181.   M: toggle this menu on/off
  182.   L: lockout SVGA (256 color modes) ie only leave hi-color or better
  183.   W: lockout SVGA modes that are smaller than the smallest 15/16/24 bit mode
  184.   G: greyscale viewing of JPEGs (faster than color)
  185.   S: change/enable shrinking of the picture to fit (only works when panning is off)
  186.   D: toggle dithering on/off
  187.   Q: toggle between 1 or 2 pass quantization
  188.   P: toggle panning on/off if the picture needs it (this can take several megs
  189.          of memory [main or disk])
  190.   K: lock in a resolution ie if you are on 640 * 480 all pictures will use
  191.       that size screen until you turn it off (note size not type [8/15/16/24 bit])
  192.   arrows: select a video mode (default should be the right size)
  193.  
  194.  
  195.   as the picture is decoding
  196.   --------------------------
  197.   ESC: exit back to the file selection menu
  198.   N or Enter: goto the next picture
  199.   P: goto the previous picture
  200.  
  201.  
  202.   picture_painted screen  (some of these work with hi_color modes)
  203.   ----------------------
  204.   ESC: exit to file selection screen
  205.   arrows: pan across the picture (if the picture is > screen)
  206.   -,+: shrink, expand the picture (if the picture is > screen)
  207.   Pg Up: turn brightness up
  208.   Pg Dwn: turn bightness down
  209.   Home: contrast increase
  210.   End: contrast decrease
  211.   Shift (keypad) 7,4,1 adjust red tint (increase, reset, decrease)
  212.   Shift (keypad) 8,5,2 adjust green tint
  213.   Shift (keypad) 9,6,3 adjust blue tint
  214.   F1 ... F10 multiply all panning and color controls ie F2 is *2, F8 is *8
  215.   S: save the bright, contrast, tint controls to be used next time this
  216.          picture is viewed (does not work for 15/16/24 bit JPEGs)
  217.   D: delete any stored tint ...  settings for the current picture
  218.   R: re-init video mode and redraw with all tint controls reset
  219.   r: re-init video mode and redraw
  220.   P: goto the previous picture
  221.   Enter: goto to next picture
  222.   N: goto the next picture
  223.  
  224.  
  225.  
  226. Sounds
  227. ------
  228.  
  229. A low frequency beep is an error indication.  This can not be turned off.
  230. When you hear such a beep the program will pause until you hit a key.
  231.  
  232. A high frequency beep is a sign that the picture is all loaded and drawn.
  233. This can be turned off under the F7 menu from the main screen.
  234.  
  235.  
  236.  
  237. Files Generated by Using DVPEG
  238. ------------------------------
  239.  
  240.     dvpeg.cfg
  241.     ---------
  242. Vidsetup will create called dvpeg.cfg  This file stores you viewing defaults
  243. and describes your video card.  It can only be edited with vidsetup.  This
  244. file will be stored in the directory that vidsetup.exe was found in.  If you
  245. wish to have multiple copies (for different video cards, different defaults)
  246. then copy the original to the directory where you want to make a custom one.
  247. Go into the directory and run vidsetup.  If vidsetup finds a dvpeg.cfg file
  248. in the local directory it will read it and write the replacement there.
  249.  
  250.  
  251.     dvpeg.vu
  252.     ---------
  253. This file is created and updated by the viewing program.  It has a list of
  254. tint/bright/contrast defaults for individual pictures.  This file will be
  255. created in the directory that the pictures are in.  If one is not found
  256. there the program will search in the directory that the executables are in.
  257. Any new defaults will be written where-ever the file is.  If you have the
  258. pictures on CD-ROM or read-only media then you will have to:
  259.   1) Make a dvpeg.vu file on a writable directory
  260.   2) copy a dvpeg.vu file to the directory that holds the executable
  261.  
  262. This is a binary file and you should be able to merge multiples together.
  263.  
  264.  
  265.  
  266. Closing comments
  267. ----------------
  268.   Please do tell me about any problems.  Yes vidsetup could be made much
  269.   easier to use but that would take a lot of time getting information from
  270.   the video card mfg's.  I welcome any information that people can forward
  271.   to me so that I may support more video cards.
  272.  
  273.   If you are interested in the latest executables or source code you can
  274.   reach me thru my addresses.  FTP to sunee.uwaterloo.ca in directory
  275.   pub/jpeg/viewers is the easiest way to get the latest version.  If you
  276.   do not have internet access I will send out copies thru the mail.  Just
  277.   send me a letter with a donation to cover postage and disks.  Don't
  278.   forget to tell me why type of disk (5.25" or 3.5" and the format ie
  279.   360k, 1.2M, 1.44M).
  280.  
  281.  
  282.   Updates
  283.   -------
  284.   This program undergoes rapid changes at times when I have nothing better
  285.   to do.  The easiest way to get the most recent version is thru the
  286.   internet.  I work on whatever interests me at the time.  The biggest
  287.   problem is the lack of information on video cards.  I add what I can
  288.   when I get the information.  Of course I can only test the S/W on the
  289.   machine that I have (currently a Trident 8900 video card) and so offer
  290.   no guarantees.  If you make any changes I would appreciate hearing
  291.   about it so that I can offer it in future versions.
  292.  
  293.  
  294.   Donation
  295.   --------
  296.   If you find this program usefull or are requesting an update thru the mail
  297.   I do not turn down cash offers  ;-)
  298.  
  299.  
  300.   Acknowledgements
  301.   ----------------
  302.   Thanks to:
  303.     Tom Lane and the IJG for their JPEG code which is the core of my viewer.
  304.         (Simtel: graphic/JPEG4386.ZIP)
  305.  
  306.     John Bridge's VGAKIT52.ZIP
  307.         (Simtel: vga/vgakit52.zip)
  308.  
  309.     Kendall Bennett (kjb@citri.edu.au)
  310.         (Simtel: vga/SVGAKT32.ZIP)
  311.  
  312.     Finn Thoegersen's VGADOC2.ZIP
  313.         (Simtel: vga/vgadoc2.zip)
  314.  
  315.     and many others for testing and providing information to make this
  316.      program what it is.
  317.  
  318.  
  319.   I can be reached thru the internet at:
  320.       praetzel@sunee.uwaterloo.ca
  321.  
  322.   or by mail at:
  323.       137 Oprington Crt.
  324.       Kitchener, Ontario
  325.       Canada
  326.       N2N 3E2
  327.  
  328.  
  329.  
  330. Copyrights, Lefts and Centers
  331. -----------------------------
  332.  
  333. Yes everything is copyrighted.
  334.  
  335. I have taken the notice from the IJG software, and put it into the readme.ijg
  336. file that is with the source code.
  337.  
  338. I copyright my own work since eveyone else seems to be doing it  ;-)
  339. Basically.  If you want to make money off of my work I would like a
  340. piece of the action.  Otherwise feel free to use and modify the program
  341. for any personal use.
  342.