home *** CD-ROM | disk | FTP | other *** search
/ PC World 1997 November / PCWorld_1997-11_cd.bin / software / sharware / grafika / pcxdump / PCXDUMP.DOC < prev    next >
Text File  |  1996-04-26  |  53KB  |  1,272 lines
  1.                     PCXDUMP   Version 9.30
  2.                    ------------------------
  3.  
  4.  
  5.                   THE screen capture program
  6.                Documentation and technical notes
  7.  
  8.                         July 1st, 1995
  9.  
  10.  
  11.  
  12.                     Copyright 1991-1995 by
  13.                         Viper Software
  14.                       All rights reserved
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21. Disclaimer and warranty
  22. -----------------------
  23. This product is distributed AS IS. The author specifically
  24. disclaims all warranties, expressed or implied, including, but
  25. not limited to, implied warranties of merchantability and
  26. fitness for a particular purpose with respect to defects in the
  27. diskette and documentation, and program license granted herein,
  28. in particular, and without limiting operation of the program
  29. license with respect to any particular application use or
  30. purpose. In no event shall the author be liable for any loss of
  31. profit or any other commercial damage including but not limited
  32. to special, incidental, consequential or other damages.
  33.  
  34.  
  35.  
  36. Licensing agreement
  37. -------------------
  38. PCXDUMP is copyrighted software and all rights are reserved.
  39. PCXDUMP may not be changed or modified in any way except by the
  40. author. PCXDUMP is SHAREWARE and may be freely distributed as
  41. long as it remains in its complete form with all support and
  42. documentation files. It may be used for a 10 day free trial
  43. period. Regardless of how the copy is obtained, it is requested
  44. that all users comply with the following licensing and regi-
  45. stration provisions if they continue to use it after the 10 day
  46. trial period. Should you find this program useful, you must re-
  47. gister it; you will then be provided with the latest releases of
  48. the PCXDUMP system.
  49.  
  50. Registration of PCXDUMP is based on 'personal usage'. Corporate
  51. or organizational users must register all copies used on an
  52. individual basis; a specific person (name) must be explicitly
  53. assigned to each registrant who will be provided with a new
  54. version of PCXDUMP where the name of the specified person will
  55. be seen to indicate registered usage. Registration grants a
  56. specific person (not a juridical person or corporate entity) the
  57. right to 'use' PCXDUMP.
  58.  
  59. Shareware distributors may distribute this program. The "per
  60. disk" charge may not exceed $8 and the shareware distributor
  61. will not change the above license agreement for the end user of
  62. PCXDUMP. End users are still required to register each share-
  63. ware copy of PCXDUMP.
  64.  
  65. The cost as of this writing is $30.00 U.S. per single-user li-
  66. cense. When you register, you receive a copy of the latest
  67. registered version of PCXDUMP, plus any enhancements that have
  68. been added since this document was released. Check "Registra-
  69. tion" for possible discounts. If you obtained this program from
  70. a shareware disk distributor, then you have paid only for the
  71. service of copying this disk, but you have not paid for the
  72. program itself. The author receives no part of the price you may
  73. have paid to a disk distributor for this disk.
  74.  
  75. PC, XT, PC/AT and PS/2 are trademarks, and IBM is a registered
  76. trademark, of International Business Machines Corporation.
  77.  
  78. All other products or services mentioned in this manual,
  79. including: VGA, Paradise, Everex, Trident, Video 7, Tseng Labs,
  80. MS-DOS,PC-DOS, PCX, Windows, Hercules, PC Paintbrush, Word-
  81. Perfect, PageMaker, Ventura, GIF, Compuserve are trademarks,
  82. registered trademarks, service marks, or registered service
  83. marks of their respective companies or organizations.
  84.  
  85.  
  86.  
  87. Overview of PCXDUMP
  88. -------------------
  89. PCXDUMP is a program which saves the images on the screen of
  90. your IBM Personal Computer or compatible PC to a disk file.
  91. PCXDUMP is memory resident, which means that having executed it
  92. once, the program is always waiting in the background, while you
  93. continue to run other programs. You tell PCXDUMP to capture the
  94. image currently displayed on the screen by pressing a
  95. combination of keys which PCXDUMP reserves for itself. The saved
  96. images are put on the disk in the PCX-format. A large variety of
  97. word processors, desktop publishers and paint programs are
  98. capable of importing PCX-files, e.g. WordPerfect, PageMaker,
  99. Ventura Publisher, PaintBrush, almost any Windows program and
  100. many, many more.
  101.  
  102. Many programs, particularly games, prevent capture because they
  103. steal the keyboard interrupt vector and refuse to pass inter-
  104. rupts back to previously installed programs. PCXDUMP is able to
  105. get around this major problem by reprogramming the interrupt
  106. controller to a different set of vectors. When a program steals
  107. the keyboard or timer interrupt it no longer gets first pick,
  108. but a fake hardware interrupt generated by PCXDUMP resident
  109. code. This technique works in all but a few rare instances.
  110. Another implication is that, with some restrictions, screens can
  111. also be captured under Microsoft Windows even though PCXDUMP is
  112. a DOS program.
  113.  
  114. PCXDUMP recognizes a large number of SuperVGA chips, and is able
  115. to use their resolutions as well. PCXDUMP will also recognize the
  116. HiColor extension of several of these SuperVGA cards. If your
  117. SuperVGA adapter is not directly supported by PCXDUMP, PCXDUMP
  118. will recognize and use every VESA mode available (VESA Version
  119. 1.2). PCXDUMP will dump images from every tweaked mode derived
  120. from 320x200, like 320x240, 360x240, 360x480 etc.
  121.  
  122. PCXDUMP is installed with the most user-friendly interface any
  123. screen grabber provides. In the menu you can change things such
  124. as: the hotkey-sequence to activate PCXDUMP, where to put the
  125. PCX-files and several other features.
  126.  
  127. With exclusively use of assembler, you will find PCXDUMP to be
  128. on one of the most compact Terminate and Stay Resident (TSR)
  129. programs you ever load. It can use EMS memory, Upper Memory
  130. Blocks provided by an XMS/UMB driver and normal system memory to
  131. maximum effect. Typical system memory use amounts to under 1.5
  132. Kb (on many systems no conventional memory is used at all!).
  133. When loaded on a PC with no EMS or UMB memory, PCXDUMP will use
  134. 16 Kb of conventional memory.
  135.  
  136. Finally, in the package is included a utility, PCXLAB, which
  137. will show all the images that PCXDUMP can produce (2, 16, 256 or
  138. 16.7 million color PCX files) on any EGA, VGA or SVGA display
  139. adapter (except EGA mono). PCXLAB will also convert PCX-files to
  140. other file formats, convert color PCX-files to monochrome
  141. PCX-files etc.
  142.  
  143.  
  144.  
  145. PCXDUMP requirements
  146. --------------------
  147. To use PCXDUMP, you will need:
  148.  
  149.       a)    An IBM PC, AT, PS/2, or 100% compatible computer.
  150.       b)    At least one floppy diskette drive.
  151.       c)    The IBM-PC DOS (Disk Operating System), or MS-DOS,
  152.             in a version numbered 3.1 or higher.
  153.       d)    An EGA graphics adapter card or better.
  154.  
  155. A Mouse System compatible mouse will also be convenient.
  156.  
  157. You can NOT use PCXDUMP on XT's or on CGA or Hercules graphics
  158. adapters!
  159.  
  160.  
  161.  
  162. What PCXDUMP is able to capture
  163. -------------------------------
  164. PCXDUMP is capable of capturing graphic images on systems
  165. equipped with any of the following video display adapters:
  166.  
  167.       *  Multicolor Graphics Adapter (MCGA)
  168.       *  Enhanced Graphics Adapter (EGA)
  169.       *  Video Gate Array adapter (VGA)
  170.  
  171. PCXDUMP captures images in any of the video modes listed in
  172. the following table, which have been standardized by manufac-
  173. turers of the various video adapters mentioned above:
  174.  
  175.      Video   Graphics                Adapters
  176.      Mode   Resolution  Colors      Supporting
  177.      -----  ----------  ----------  --------------------
  178.  
  179.        4     320 x 200       4        CGA/EGA/VGA  *)
  180.        5     320 x 200       4        CGA/EGA/VGA  *)
  181.        6     640 x 200       2        CGA/EGA/VGA
  182.       13     320 x 200      16        EGA/VGA
  183.       14     640 x 200      16        EGA/VGA
  184.       15     640 x 350       2        EGA/VGA
  185.       16     640 x 350      16        EGA/VGA
  186.       17     640 x 480       2        VGA/MCGA
  187.       18     640 x 480      16        VGA
  188.       19     320 x 200     256        VGA/MCGA
  189.  
  190. *) In these two CGA-modes, PCXDUMP will always use a palette of
  191. Black, Cyan, Magenta and White.
  192.  
  193. Although PCXDUMP can dump images from mode 4, 5 and 6 (which are
  194. CGA modes), you still need at least an EGA or MCGA card to
  195. install PCXDUMP.
  196.  
  197. And if you have any of these SVGA-cards, you are able to
  198. capture screens from their SVGA modes as well!
  199.  
  200. -------------+---------+---------+---------+---------+--------
  201. CHIPSET      | 16 col. | 256 col.| 32k col.| 64k col.| 16M col
  202.              | up to:  | up to:  | up to:  | up to:  | up to:
  203. -------------+---------+---------+---------+---------+--------
  204. Advance Logic|1280x1024|1280x1024| -       |1024x768 | 800x600
  205. Ahead A/B    |1024x768 |1024x768 | -       | -       | -
  206. ATI          |1024x768 |1024x768 | 800x600 | -       | -
  207. Chip & Tech. |1280x1024|1024x768 | -       | -       | -
  208. Compaq       | 800x600 |1280x1024| 640x480 |1024x768 | 640x480
  209. Genoa        |1024x768 | 800x600 | -       | -       | -
  210. Matrox       |1024x768 |1024x768 | -       | -       | -
  211. MXIC         |1024x768 |1024x768 | -       | -       | -
  212. OAK          |1280x1024|1280x1024| 800x600 | 800x600 | 640x480
  213. Paradise     |1024x768 |1024x768 | 800x600 | -       | -
  214. Realtek      |1280x1024|1024x1024| -       | 800x600 | -
  215. Trident      |1024x768 |1024x768 | 800x600 | 800x600 | -
  216. Tseng ET 3000|1024x768 | 800x600 | -       | -       | -
  217. Tseng ET 4000|1280x1024|1024x768 | -       | -       | -
  218. Tseng HiColor|1280x1024|1024x768 | 800x600 | -       | -
  219. Tseng TrueClr|1280x1024|1024x768 | 800x600 | 800x600 | 640x480
  220. VESA         |1280x1024|1280x1024|1280x1024|1280x1024|1280x1024
  221. Video-7      |1024x768 | 800x600 | -       | -       | -
  222. S3           |1280x1024|1280x1024|1280x1024|1280x1024| 800x600
  223. -------------+---------+---------+---------+---------+-------
  224.  
  225. PCXDUMP is not designed to work with high-resolution 4-color
  226. images. If you try to activate PCXDUMP in an unsupported video
  227. mode, PCXDUMP will produce a long deep tone.
  228.  
  229.  
  230.  
  231. Text modes
  232. ----------
  233. PCXDUMP is able to capture screens in at least these text mo-
  234. des:
  235.  
  236.      Video   Text                          Adapters
  237.      Mode   Resolution         Colors      Supporting
  238.      -----  ----------         ----------  ----------------
  239.       0     40x25              16          CGA/EGA/VGA/MCGA
  240.       1     40x25              16          CGA/EGA/VGA/MCGA
  241.       2     80x25              16          CGA/EGA/VGA/MCGA
  242.       3     80x25,80x43,80x50  16          EGA/VGA/MCGA
  243.       7     80x25,80x43         2          EGA/VGA
  244.       -      80x60             16          Some SVGA cards
  245.       -      80x66             16          Some SVGA cards
  246.       -     100x40             16          Some SVGA cards
  247.       -     100x60             16          Some SVGA cards
  248.       -     132x25             16          Some SVGA cards
  249.       -     132x28             16          Some SVGA cards
  250.       -     132x44             16          Some SVGA cards
  251.       -     132x60             16          Some SVGA cards
  252.  
  253. Text screens can be captured in three ways, either to a text
  254. file (.TXT), to a ANSI-file (.ANS) or to a bitmap (graphic) file
  255. (.PCX).
  256.  
  257. To dump a text screen to a text file, press hotkey ALT+SHIFT+T.
  258. Instead of the PCX extension on the file it will be the TXT
  259. extension. These text files can be imported to almost any kind
  260. of wordprocessor or desktop program. When you dump to a text
  261. file, only the characters (no colors) are dumped to file.
  262.  
  263. To dump a text screen to a ANSI-file, press hotkey ALT+SHIFT+A
  264. and PCXDUMP will dump the screen immediately. Instead of the PCX
  265. extension on the file, it will be a ANS extension. These
  266. ANSI-files can be typed (with the DOS command TYPE) and if you
  267. have the device driver ANSI.SYS installed, the correct colors (if
  268. any) will be printed on the screen. If not consult your DOS
  269. manual on how to install this device driver. This option is
  270. great for SysOp's, who wants to capture text screens with colors
  271. for use on their BBS.
  272.  
  273. All other hotkeys will produce a bitmap file (with the PCX
  274. extension). In all modes except mode 7, you can capture the
  275. screen in both color or monochrome. In text mode, PCXDUMP uses
  276. the RAM resident font to convert the screen into a bitmap. This
  277. means that the resulting bitmap represents the captured text
  278. screen exactly as it appears on the screen, even if the program
  279. loads a specialized font (such as an emulated mouse cursor in
  280. text mode). On EGA or better display adapters it is possible to
  281. show 512 different characters at the same time. PCXDUMP is able
  282. to dump such a screen correctly (but only on VGA or better).
  283.  
  284. Note that with Ventura Publisher or WordPerfect 5.1 the size of
  285. the image when incorporated into your document depends on the
  286. size of the frame (VP) or figure (WP). For best results, you
  287. must adjust this size (within VP or WP) so that pixels are not
  288. truncated or compressed. You can calculate the best size for the
  289. image in your document based on the horizontal and vertical
  290. resolution of your printer. Lets say you capture a VGA text mode
  291. screen with 80 columns and 25 lines. The font size in this mode
  292. is 8 by 16 pixels. This means that there are 400 (16 times 25)
  293. scan lines in the image and 640 pixels horizontally (80 times
  294. 8). You must size the image so that the number of pixels in the
  295. image is evenly divisible by the printer resolution. Therefore,
  296. if you have a laser printer or DeskJet printer which prints at a
  297. resolution of 300 dots per inch (both horizontal and vertical),
  298. a frame size of 2.13 inches by 1.33 or 4.27 inches by 2.67
  299. inches would produce non-distorted output. Note that you must
  300. account for the inside border space and border width when sizing
  301. figures in WordPerfect.
  302.  
  303.  
  304.  
  305. Hotkeys
  306. -------
  307. One of the powerful features of PCXDUMP is the number of
  308. hotkeys. Instead of just one hotkey, as ordinary screen grab-
  309. ber provides, PCXDUMP gives you 9 different hotkeys (C,E,N,R,
  310. I,G,H,T,A).
  311. With these hotkeys you control how you want PCXDUMP to dump the
  312. screen.
  313.  
  314. 5 of the 9 hotkeys (C,N,I,G,H) will draw a frame on the screen
  315. when pressed, and you will be able to decide which part of the
  316. screen you want saved by adjusting the size and position of the
  317. frame. You can use both the mouse (if your mouse driver is
  318. installed) or the keyboard to control the frame. Read the
  319. section "Adjusting framesize" for a precise explanation.
  320.  
  321.   ALT+SHIFT+C dumps a color PCX-file.
  322.  
  323.   ALT+SHIFT+E like ALT+SHIFT+C but without the frame.
  324.  
  325.   ALT+SHIFT+N dumps a black/white PCX-file.
  326.  
  327.   ALT+SHIFT+R like ALT+SHIFT+N but without the frame.
  328.  
  329.   ALT+SHIFT+I dumps an inverted black/white PCX-file.
  330.  
  331.   ALT+SHIFT+G dumps a color PCX-file with the image
  332.               converted to grayscale.
  333.  
  334.   ALT+SHIFT+H dumps a color PCX-file with the image
  335.               converted to inverted grayscale.
  336.  
  337.   ALT+SHIFT+T will dump a text screen to a TEXT-file.
  338.  
  339.   ALT+SHIFT+A will dump a text screen to a ANSI-file.
  340.  
  341. This is the default set of hotkeys. It is possible to choose a
  342. custom hotkey sequence (read the section "PCXDUMP installation
  343. options").
  344.  
  345. When dumping a color PCX-file, the video mode (the available
  346. colors on the screen) determines which file format should be
  347. used (1, 4, 8 or 24 bits format), except when dumping a gray
  348. scaled dump in 32768, 65536 or 16.7 million colors, which will
  349. produce a 256 color PCX-file. PCXDUMP will beep once when
  350. activated and (once) again when having finished dumping gra-
  351. phics. If you activate PCXDUMP in an unsupported video mode,
  352. such as a 4 color hires mode, PCXDUMP will emit a long deep
  353. sound. You can only use the C, E, G & H hotkeys when there is at
  354. least 4 colors on the screen. You can only use the T and A
  355. hotkeys in text mode.
  356.  
  357. NOTE: if you activate PCXDUMP in text mode, PCXDUMP will dump
  358. the screen immediately.
  359.  
  360.  
  361.  
  362. Adjusting framesize
  363. -------------------
  364. If you have a mouse and your mouse-driver is installed, you are
  365. able to cut out part of the screen with a on-screen frame
  366. controlled by the mouse. This can also be done by using the
  367. arrow keys and <CTRL> or <ALT>.
  368.  
  369. The frame will appear in GRAPHICS mode only. In text mode the
  370. whole screen is dumped immediately.
  371.  
  372. The size of the frame is shown in upper left corner.
  373.  
  374. MOUSE:
  375.       Press RIGHT button and move mouse to control frame size.
  376.       Press LEFT button and move mouse to control frame posi-
  377.       tion.
  378.       Press MIDDLE button to adjust horizontal panning (descri-
  379.       bed below)
  380.  
  381. KEYBOARD:
  382.       Press the arrow keys to control frame size.
  383.       Press <CTRL> or <ALT> and arrow keys to control frame
  384.       position.
  385.       Press Keypad 5 to adjust horizontal panning (described
  386.       below)
  387.  
  388. BOTH MOUSE and KEYBOARD:
  389.       Press <ENTER> to dump graphic within frame.
  390.       Press <ESC> to cancel
  391.  
  392. You can only adjust the frame size when you have pressed one of
  393. these hotkeys: C,N,I,G,H.
  394.  
  395. Whenever the frame is displayed on the screen, you are able to
  396. press "S" to save the framesize and position and "R" to restore
  397. the framesize and position. Save your favorite framesize and
  398. position just before your first "dump", and re-use the size and
  399. position over and over again just by pressing "R".
  400.  
  401. NOTE for EGA card users: Just a piece of advice. If you capture
  402. a screen in a program (e.g. a paint program) which is also using
  403. the mouse, "noisy" pixels may appear when the mouse is moved. If
  404. you dump the whole picture without using the mouse (hotkey E &
  405. R) and use PCXLAB to show the PCX-file, you can now use the
  406. mouse to cut out the wanted area.
  407.  
  408. HORIZONTAL PANNING: Some programs/games uses horizontal scrol-
  409. ling to improve the graphics. PCXDUMP will know which part of
  410. the graphics is currently shown, except for a "few" pixels (1-7
  411. pixels). There is no way to determine these "extra" pixels in a
  412. safe way. If you can see that the frame starts to the left of
  413. the screen, press the middle mousebutton or Keypad 5 to make the
  414. frame position correct. In 16 colors mode the frame can be up to
  415. 7 pixels wrong, in 256 colors up to 3 pixels wrong. You can only
  416. adjust horizontal panning if the program uses horizontal scroll.
  417.  
  418.  
  419.  
  420.  
  421. If the computer is too busy to capture
  422. --------------------------------------
  423. There may be times when you request PCXDUMP to capture your
  424. screen, and nothing seems to happen. This is usually because the
  425. foreground application program is in the middle of a sensitive
  426. task which cannot be interrupted safely. In these cases, PCXDUMP
  427. is aware that you have requested a screen capture, and will pop
  428. up as soon as it becomes safe to do so.
  429.  
  430.  
  431.  
  432. The PCXDUMP environment variable
  433. ------------------------------------
  434. Another supported feature is the environment variable PCXDUMP.
  435. You can write your preferred settings into the variable, so you
  436. don't have to write them every time you start the program. For
  437. example, if you have the PCXDUMP variable set as follows:
  438.  
  439.       SET PCXDUMP=/DIR:C:\PICTURES /MONO /SHIFT:1
  440.  
  441. PCXDUMP will then use these parameters every time it is run,
  442. overriding the defaults so that you only need to type "PCXDUMP"
  443. to access your most used setup.
  444. Note that you still need to write "PCXDUMP /ON" if you do not
  445. want the installation menu to appear. The command line para-
  446. meters will override the environment variable. Thus
  447.  
  448.       PCXDUMP /DIR:C:\TEMP
  449.  
  450. will put all dumped images in C:\TEMP rather than C:\PICTURES.
  451.  
  452.  
  453.  
  454. PCXDUMP installation options
  455. ----------------------------
  456. PCXDUMP is easily installed with the menu that appears, when you
  457. write "PCXDUMP" + <ENTER>. Do not attempt to start PCXDUMP from
  458. a command shell such as Norton Commander or Dosshell.
  459. You can, however, install PCXDUMP with "command line switches"
  460. alone. In this way you will be able to install PCXDUMP from a
  461. batch file, such as AUTOEXEC.BAT.
  462. This section identifies the "command line switches" which
  463. PCXDUMP recognizes and responds to. A command line switch is a
  464. string of characters which you type after the PCXDUMP command
  465. itself.
  466. The purpose of these switches is to allow you to modify the way
  467. PCXDUMP performs certain of its operations. Turning PCXDUMP's
  468. beep sounds off and removing PCXDUMP from memory are just two
  469. examples of functions which the command line switches allow you
  470. to control.
  471. A single command line may contain as many switches as you desire,
  472. in any order, in either uppercase or lowercase letters. Please
  473. note that DOS limits the maximum line length to 127 characters.
  474.  
  475. Option: /ON
  476. -----------
  477.       Installs PCXDUMP. This option is only necessary if no
  478.       other options are given.
  479.  
  480.  
  481. Option: /OFF
  482. ------------
  483.       This option removes PCXDUMP from the memory. This is only
  484.       possible if the interrupt vectors used by PCXDUMP still
  485.       point to its resident code. Normally this will be where
  486.       PCXDUMP was the last TSR program loaded. Note that any
  487.       other command line switches or parameters will be ignored
  488.       if this option is present. Users are advised NOT to use
  489.       TSR release programs such as MARK and RELEASE. Only
  490.       PCXDUMP can remove itself from memory correctly.
  491.  
  492.  
  493. Option: /ANIMATE:number
  494. -----------------------
  495.       With this option is is possible to dump the screen auto-
  496.       matically every time a certain number of seconds has elapsed.
  497.       If you set /ANIMATE:10, PCXDUMP will dump the screen every 10
  498.       seconds. While PCXDUMP is dumping the screen, time is stopped.
  499.       The screen will be saved immediately and PCXDUMP will automa-
  500.       tically determine whether to save the images to a color
  501.       PCX-file or to a black&white PCX-file. If PCXDUMP is installed
  502.       with the /TIME then PCXDUMP will start the animated dump AFTER
  503.       it has installed itself with the /TIME. If you install PCXDUMP
  504.       with:
  505.  
  506.       PCXDUMP /ANIMATE:5 /TIME:30
  507.  
  508.       PCXDUMP will install itself after 30 seconds and THEN dump the
  509.       screen every 5 sec.
  510.  
  511.  
  512. Option: /AUTODUMP
  513. -----------------
  514.       This option has no effect unless it is used in conjunction
  515.       with the /TIME option. If you install PCXDUMP with
  516.       "/TIME:10 /AUTODUMP" this is what happens: after 10 seconds
  517.       PCXDUMP will install its own keyboard routine and will
  518.       immediately start dumping the screen.
  519.       It is not possible to make a grey scaled auto-dump of a color
  520.       image.
  521.  
  522.  
  523. Option: /BATCH
  524. --------------
  525.       This option can only be used from command-line. When this
  526.       option is used, PCXDUMP will not write a status screen
  527.       after installation. This option is for registered users
  528.       only!
  529.  
  530.  
  531. Option: /CHIPSET:number
  532. -----------------------
  533.       If PCXDUMP somehow fails to recognize your video card
  534.       (which is on the list below) the /CHIPSET option is used to
  535.       force PCXDUMP to use the correct videocard. The number must
  536.       be in the range 2-44:
  537.  
  538.       Number  Chipset             Number    Chipset
  539.       ----------------------     -------------------
  540.          0  UNSUPPORTED             23  Realtek
  541.          1  RESERVED                24  Matrox
  542.          2  EGA card                25  OAK-57
  543.          3  VGA card                26  OAK-83
  544.          4  ATI card                27  OAK-87
  545.          5  Trident                 28  S3-911
  546.          6  Genoa                   29  S3-924
  547.          7  Paradise                30  S3-928
  548.          8  Tseng ET 3000           31  S3-801/805
  549.          9  Tseng ET 4000           32  S3-864
  550.         10  Tseng ET 4000 HiColor   33  S3-964
  551.         11  OAK-37                  34  Compaq Qvision
  552.         12  OAK-67                  35  ChipTech 450
  553.         13  Video 7                 36  ChipTech 455
  554.         14  Ahead A                 37  ChipTech 456
  555.         15  Ahead B                 38  ChipTech 457
  556.         16  ChipTech 451            39  ChipTech 65520
  557.         17  ChipTech 452            40  ChipTech 65530
  558.         18  ChipTech 453            41  ChipTech 65510
  559.         19  VESA                    42  ChipTech 64200
  560.         20  Tseng ET 4000 TrueColor 43  ChipTech 64300
  561.         21  OAK-77                  44  Advance Logic
  562.         22  MXIC
  563.  
  564.  
  565. Option: /DIR:directory
  566. ----------------------
  567.       This option places the PCX-files (DUMP????.PCX) in the
  568.       specified directory instead of the current directory. Many
  569.       programs have some data in other directories than the
  570.       startup directory, and this option saves you the trouble
  571.       of tracking down the PCX-files after capturing the images.
  572.       Example:
  573.  
  574.       PCXDUMP /DIR:C:\     (Will place files in C:\)
  575.  
  576.       PCXDUMP /DIR:C:\PCX\ (If C:\PCX\ exist files will be put
  577.                             here)
  578.  
  579.       Instead of writing /DIR:C:\PCX\ you can write /DIR:C:\PCX
  580.  
  581.       The /NAME option will allow you to change the name of
  582.       files that PCXDUMP will dump the images to. See /NAME.
  583.  
  584.  
  585. Option: /GAMMA:number
  586. ---------------------
  587.       This option can be used to control the light intensity of
  588.       the palette. This will only have an effect on grayscaled
  589.       PCX-files (hotkey G or H).
  590.       A value of 100 is default, a smaller value will make the
  591.       image darker and a greater value will make the image
  592.       brighter. This value must be in the range 20-400, other-
  593.       wise it will be ignored. Lets say you want to dump a
  594.       picture to a gray scale PCX-file so you can print it out
  595.       to a laser printer. You then discover that the printed
  596.       image is too dark. Now just (re)install PCXDUMP will a new
  597.       (and higher) GAMMA value.
  598.       I have found a GAMMA value near 170 good when dumping
  599.       textscreens (and graphics screens too) for printing on
  600.       laser printers.
  601.  
  602. Option: /HELP
  603. -------------
  604.       Clears the screen and prints all available command-line
  605.       switches.
  606.  
  607.  
  608. Option: /H
  609. ----------
  610.       Same as /HELP.
  611.  
  612.  
  613. Option: /HOTKEY:scancode
  614. ------------------------
  615.       Instead of using the default set of hotkeys (C,E,N,R,I,G,
  616.       H,T,A), you can tell PCXDUMP to use a custom hotkey. When
  617.       doing so all other hotkeys will be disabled and you will no
  618.       longer be able to use the mouse or keyboard to cut out a
  619.       piece of the screen. The image will be saved immediately
  620.       and PCXDUMP will automatically determine whether to dump a
  621.       color or a monochrome image. The scancode must be in the
  622.       range 1-88.
  623.  
  624.  
  625. Option: /INT:number
  626. -------------------
  627.       Use this option if you want to call PCXDUMP from other
  628.       programs. You will be able to call PCXDUMP from your own
  629.       program via an interrupt, which you specify here. This
  630.       interrupt may be any interrupt in the following list:
  631.  
  632.                5, 78,  99, 129, 134, 140, 242, 247
  633.               50, 79, 100, 130, 135, 141, 243, 249
  634.               69, 96, 101, 131, 137, 142, 244, 252
  635.               76, 97, 102, 132, 138, 143, 245, 253
  636.               77, 98, 105, 133, 139, 241, 246
  637.  
  638.       If you have chosen, say, interrupt 5, you can call
  639.       PCXDUMP from your own program, if you enter this piece of
  640.       code in your program:
  641.  
  642.       TURBO PASCAL 4.0 - 5.5 CODE:
  643.       ----------------------------
  644.       Uses Dos;
  645.       Procedure DumpScreen(Func:Word);
  646.       Var
  647.         Reg : Registers;
  648.       begin
  649.         Reg.AX := $1234;
  650.         Reg.BX := Func;
  651.         Intr(5,Reg);
  652.         Delay(60); (* Remember this delay *)
  653.       end;
  654.  
  655.       TURBO PASCAL 6.0 CODE:
  656.       ----------------------
  657.       Procedure DumpScreen(Func:Word);
  658.       begin
  659.         ASM
  660.           MOV AX,1234h
  661.           MOV BX,Func
  662.           INT 5
  663.         END;
  664.         Delay(60); (* Remember this delay *)
  665.       end;
  666.  
  667.       The AX register must be $1234 or 1234h (hexadecimal), as
  668.       this tells PCXDUMP that this interrupt is meant to dump
  669.       the screen. PCXDUMP is not called directly, but will pop
  670.       up (if it is safe to do so) within the next 6/100 of a
  671.       second (that is the reason for the delay). If AX does not
  672.       equal 1234h, PCXDUMP will ignore the interrupt and call
  673.       the old interrupt. If you use interrupt 5 as the inter-
  674.       rupt to call PCXDUMP and press the PrintScreen key which
  675.       normally activates interrupt 5, PCXDUMP will not be
  676.       activated since register AX is not $1234 (PCXDUMP will
  677.       call the original interrupt which prints text screen to
  678.       the printer). The BX register holds the function, you want
  679.       performed. BX = 0 equals first hotkey "C", BX=1 equals
  680.       hotkey "E" etc. BX = 5 equals hotkey "G".
  681.  
  682.       Therefore BX must be in the range 0-8 ("C" - "A").
  683.  
  684.       It is possible to check if PCXDUMP is installed and which
  685.       version (again in Turbo Pascal code):
  686.  
  687.       Uses Dos;
  688.       Var
  689.         Reg               : Registers;
  690.         Pcxdump_Installed : Boolean;
  691.         Pcxdump_Version   : Word;
  692.         Pcxdump_Interrupt : Byte;
  693.       Begin
  694.         Pcxdump_Installed := False;
  695.         Reg.AX:=$9999;
  696.         Intr($28,Reg);
  697.         if Reg.AX=$AAAA then
  698.         begin
  699.           Pcxdump_Installed := True;
  700.           Pcxdump_Version   := Reg.CX; {Major in CH, Minor in
  701.                                         CL}
  702.           Pcxdump_Interrupt := Reg.DL;
  703.         end;
  704.         if NOT Pcxdump_Installed then
  705.         begin
  706.           Writeln('PCXDUMP is not installed!');
  707.           Halt(1);
  708.         end;
  709.         Writeln('PCXDUMP version ',Pcxdump_Version/100:4:2,
  710.                 ' is installed');
  711.         if Pcxdump_Interrupt<>0 then
  712.           Writeln('PCXDUMP uses user-interrupt ',
  713.                    Pcxdump_Interrupt);
  714.       end.
  715.  
  716.  
  717. Option: /MEMORY:number
  718. ----------------------
  719.       PCXDUMP will search your computer for available UMB or EMS
  720.       to put most of its code. If your system has 16 Kb of free
  721.       UMB, PCXDUMP will install itself there and use no
  722.       conventional memory. If you do not have 16 Kb free UMB but
  723.       you have EMS available, PCXDUMP will use 16 Kb of EMS and
  724.       only just under 1.5 Kb of conventional memory. With this
  725.       option you can tell PCXDUMP if it is allowed to search for
  726.       upper memory.
  727.  
  728.       /MEMORY:0       (use only conventional memory)
  729.       /MEMORY:1       (search for UMB memory)
  730.       /MEMORY:2       (search for EMS memory)
  731.       /MEMORY:3       (search for both UMB and EMS memory)
  732.  
  733.  
  734. Option: /MONO
  735. -------------
  736.       The installation menu for PCXDUMP contains a lot of
  737.       colors. On color monitors they should not be a problem.
  738.       However, on notebook PC's or other computers equipped with
  739.       a Black & White monitor it may be difficult to tell the
  740.       different colors apart. Applying this option from the
  741.       command-line forces PCXDUMP to use Black & White only in the
  742.       installation menu. This option can only be used from
  743.       command-line.
  744.  
  745.  
  746. Option: /MOUSE
  747. --------------
  748.       Normally you will activate PCXDUMP from the keyboard. But
  749.       if you use this option (by setting it to ON in the in-
  750.       stallation menu), you will be able to capture the screen
  751.       by using the mouse only.
  752.       When PCXDUMP is installed, you can make PCXDUMP dump the
  753.       screen by pressing LEFT and RIGHT mouse button AT THE SAME
  754.       TIME. PCXDUMP will save the screen immediately and will
  755.       automatically determine whether to dump the image in color
  756.       or Black & White. As usually PCXDUMP will beep when it is
  757.       activated and when it is finished.
  758.  
  759.  
  760. Option: /NAME:name
  761. ------------------
  762.       Usually PCXDUMP will dump the screens to files with the
  763.       name: "DUMP0000.PCX". You can change this with the /NAME
  764.       option. If you set /NAME:GAMES, PCXDUMP will dump to file
  765.       "GAMES000.PCX", "GAMES001.PCX" etc. You can only specifi-
  766.       fy a name up to 8 characters, and the name must consist of
  767.       letters only, no digits or others characters is allowed.
  768.       As the filenumber is increased, it may overwrite some of
  769.       the last letters in the name. Example:
  770.  
  771.       PCXDUMP /NAME:TESTING
  772.  
  773.       will produce TESTING0.PCX - TESTING9.PCX and the next will
  774.       be named TESTIN10.PCX.
  775.       If a file with a particular name already exists, it will
  776.       not be overwritten unless PCXDUMP is instructed to. See
  777.       /OVERWRITE
  778.  
  779.  
  780. Option: /NOSOUND
  781. ----------------
  782.       Tells PCXDUMP to be quiet.
  783.  
  784.  
  785. Option: /OFFSET:number
  786. ----------------------
  787.       Normally PCXDUMP will save the images to files starting
  788.       at offset 0000 (i.e. with the file "DUMP0000.PCX"). But
  789.       by specifying a file-offset, you can tell PCXDUMP to save
  790.       the images to files starting at a specific offset. If you
  791.       install PCXDUMP with this option:
  792.  
  793.       PCXDUMP /OFFSET:20
  794.  
  795.       PCXDUMP will save the first image to the file
  796.       "DUMP0020.PCX", the next image to "DUMP0021.PCX" etc.
  797.  
  798.  
  799. Option: /OVERWRITE
  800. ------------------
  801.       PCXDUMP will not overwrite existing files in the default
  802.       configuration. Instead the next available filename will
  803.       be used.
  804.       If you install PCXDUMP and the files DUMP0000.PCX,
  805.       DUMP0001.PCX and DUMP0003.PCX (assuming that PCXDUMP uses
  806.       the default name for files) already exists in the
  807.       destination directory (read elsewhere about the /DIR
  808.       option, which will allow you to put the dumped images in a
  809.       specific directory), PCXDUMP will dump the first image to
  810.       the file DUMP0002.PCX and the next image to the file
  811.       DUMP0004.PCX etc.
  812.       But if you install PCXDUMP with the /OVERWRITE option,
  813.       PCXDUMP will overwrite any existing file with the same name
  814.       as the file PCXDUMP wants to save.
  815.  
  816.  
  817. Option: /SHIFT:number
  818. ---------------------
  819.       Instead of using the default hotkey sequence which is
  820.       ALT+SHIFT+<some hotkey>, you can tell PCXDUMP to use any
  821.       combination of the ALT, SHIFT and CTRL keys.
  822.  
  823.       Number    Effect on hotkey sequence
  824.       -----------------------------------
  825.       0        No shift keys
  826.       1        Press SHIFT
  827.       2        Press ALT
  828.       3        Press ALT + SHIFT
  829.       4        Press CTRL
  830.       5        Press SHIFT + CTRL
  831.       6        Press ALT + CTRL
  832.       7        Press SHIFT + ALT + CTRL
  833.  
  834.  
  835. Option: /SKIPVESA
  836. -----------------
  837.       When PCXDUMP tries to identify your video card it will
  838.       always treat your video card as a VESA card if you have a
  839.       VESA-driver installed because the very first thing PCXDUMP
  840.       checks, is the presence of a VESA-driver. If you install
  841.       PCXDUMP with this option no check for a VESA-driver is
  842.       performed.
  843.       If you have a VESA driver installed some programs will take
  844.       advantage of the VESA driver and some programs will not. If
  845.       a program uses the VESA driver, you must install PCXDUMP
  846.       with VESA capabilities. If a programs does not use the VESA
  847.       driver and instead uses the video card directly, you must
  848.       install PCXDUMP with the /SKIPVESA switch to make PCXDUMP
  849.       ignore the VESA driver. The problem is not PCXDUMP, but
  850.       whether a program uses the VESA driver or not.
  851.       If you have a VESA driver installed and are using EMM386
  852.       (or QEMM) as your memory manager, PCXDUMP may sometimes
  853.       cause an exception error. If you use this option it should
  854.       fix this problem, but then PCXDUMP will not recognize any
  855.       VESA mode. See KNOWN PROBLEMS for another solution.
  856.  
  857.       NOTE: This option can only be used from the command line.
  858.  
  859.  
  860. Option: /STEALTH:number
  861. -----------------------
  862.       Many programs, particularly games, prevent capture because
  863.       they steal the keyboard interrupt vector and refuse to pass
  864.       interrupts back to previously installed programs. PCXDUMP
  865.       is able to get around this major problem by reprogramming
  866.       the interrupt controller to a different set of vectors.
  867.       When a program steals the keyboard or timer interrupt it no
  868.       longer gets first pick, but a fake hardware interrupt
  869.       generated by PCXDUMP resident code.
  870.       But PCXDUMP will only reprogram the interrupt controller if
  871.       you invoke it with the /STEALTH option. For this purpose
  872.       PCXDUMP need a base interrupt vector. This vector must be
  873.       in the range 120-224.
  874.       PCXDUMP requires a consecutive run of eight unused
  875.       interrupt vectors, and it is VERY important that the ones
  876.       chosen do not conflict with other software packages or
  877.       hardware devices. The range 120-224 is chosen since it is
  878.       typically where the unused interrupt vectors can be found.
  879.       You are not likely to come across conflicts unless special
  880.       hardware is being used. Software packages rarely use
  881.       interrupts in this region. If they do it should be
  882.       documented. If you ever suffer from system crashes or
  883.       hardware lock-ups, suspect this base interrupt value first.
  884.       If in any doubt try booting your PC from minimal system
  885.       floppy disk.
  886.  
  887.       Please consult Appendix A for an visual explanation of
  888.       the /STEALTH technique.
  889.  
  890.  
  891. Option: /STEALTH
  892. ----------------
  893.       Same as /STEALTH:216, see /STEALTH:number!
  894.  
  895.  
  896. Option: /TIME:number
  897. --------------------
  898.       Use this option to "delay" the installation of INT 09h (INT
  899.       09h is the hardware keyboard interrupt, remember). Many
  900.       programs (e.g. games like "4D STUNT DRIVE") will take complete
  901.       control of INT 09h when loading and never call the original
  902.       INT 09h. For that reason PCXDUMP's own INT 09h will not be
  903.       called. This obstacle can be overcomed by using the /TIME
  904.       option. If it takes your program, say, about 20 seconds to
  905.       start up, it is a good idea to delay the installation about
  906.       30 seconds. PCXDUMP uses the hardware clock interrupt at INT
  907.       08h to keep track of time.
  908.  
  909.       PCXDUMP /TIME:60
  910.  
  911.       will install PCXDUMP, and PCXDUMP will be waiting 60 seconds
  912.       before grabbing INT 09h.
  913.  
  914.       Bear in mind that when you use this option, you are not able
  915.       to use PCXDUMP after exiting the program (or game) you wished
  916.       to save images from. The reason for this is that the interrupted
  917.       program remembers the "old" INT 09h address, and when you exit
  918.       this program it restores INT 09h and thereby overwrites
  919.       PCXDUMP's INT 09h address.
  920.  
  921.       If you want to use PCXDUMP again, you do not have to reboot:
  922.       simply remove PCXDUMP from memory by writing:
  923.  
  924.       PCXDUMP /OFF
  925.  
  926.       and then install PCXDUMP again.
  927.  
  928.       NOTE: When using the /TIME option to delay the installation,
  929.             PCXDUMP will beep twice when it installs itself. This
  930.             is a great help, since you now will know if it was
  931.             possible for PCXDUMP to take over INT 09h.
  932.  
  933.  
  934. Option: /VIDEO:number
  935. ---------------------
  936.       Usually PCXDUMP will detect the current video mode cor-
  937.       rectly. But sometimes this detections fails. This happens
  938.       very seldom, I have experienced this in one game, COMANCHE:
  939.       MAXIMUM OVERKILL, a 32-bit protected mode game. By using
  940.       this option you can explicitly tell PCXDUMP which video
  941.       mode to use. You may need the manual for your video card to
  942.       determine the video mode number, since these mode numbers
  943.       differs from videocard to videocard. E.g. mode 1024x768x256
  944.       on a Tseng ET 4000 card will have mode number 56 (38 hex),
  945.       but on an Trident card this mode has the number 96 (62 hex)
  946.       and on a Realtek it is 40 (28 hex) and so on. Once you have
  947.       told PCXDUMP to use a certain video mode, it will continue
  948.       to use this video mode every time you activate it. You need
  949.       to un-install PCXDUMP and re-install it to make it
  950.       autodetect the video mode again.
  951.  
  952.       Actually, to dump images from COMANCHE, I had to use the
  953.       /VIDEO option and the /MOUSE option.
  954.       Since COMANCHE can not cope the the reprogramming of the
  955.       interrupt controller (see Appendix A), you can NOT use
  956.       the /STEALTH option with this game.
  957.  
  958.       As COMANCHE monopolizes the keyboard it is not possible to
  959.       dump images from this game using the keyboard! However,
  960.       COMANCHE does not use the mouse and this way (by using the
  961.       /MOUSE option) it was possible to dump some screenshots. I
  962.       also used the /VIDEO option (for the reasons mentioned
  963.       above) to dump the right video mode. COMANCHE runs in mode
  964.       X (320x240), which is derived from mode 19 (13 hex) =
  965.       320x200 pixels with 256 colors. Therefore to dump screens
  966.       from COMANCHE, PCXDUMP was installed with these options:
  967.  
  968.       PCXDUMP /VIDEO:19 /MOUSE
  969.  
  970.       Screens were then captured by pressing both left and
  971.       right mousebutton at the same time.
  972.  
  973.       NOTE: On some Genoa cards PCXDUMP cannot recognize the
  974.       extended graphics video modes. But you can force PCXDUMP
  975.       to dump from these modes with the VIDEO option. Below is a
  976.       table with the video modes and the corresponding mode
  977.       number for Genoa cards:
  978.  
  979.       GENOA:       Mode no.    Color    Resolution
  980.       --------------------------------------
  981.                    92 (5C hex)   256      640x480
  982.                    94 (5E hex)   256      800x600
  983.                    95 (5F hex)    16     1024x768
  984.                   108 (6C hex)   256      800x600
  985.                   115 (73 hex)    16      640x480
  986.                   121 (79 hex)    16      800x600
  987.                   125 (7D hex)   256      512x512
  988.                   126 (7E hex)   256      640x400
  989.  
  990.  
  991. Option: /WIDE:number
  992. --------------------
  993.       If a program uses smooth scroll (that is, defines a
  994.       virtual screen bigger than physical display), e.g. like
  995.       the COMMANDER KEEN series, you can use the /WIDE option,
  996.       and PCXDUMP will try to dump the virtual screen instead of
  997.       the physical screen (which is default). Since PCXDUMP
  998.       automatically determines the logical screen width (which
  999.       is bigger than the physical display width), but has no way
  1000.       of calculating the logical screen height, you have to
  1001.       specify how many times higher than the physical display
  1002.       height the logical screen height is. Let us say you want
  1003.       to capture the full logical screen of COMMANDER KEEN 4.
  1004.       This game runs in 320x200 pixels with 16 colors. You do
  1005.       not have to worry about the logical screen width, since
  1006.       PCXDUMP will take care of that (actually 512 pixels in
  1007.       this game). The logical screen height is approx. 600
  1008.       pixels. Therefore, to dump the logical screen, you should
  1009.       install PCXDUMP with these options:
  1010.  
  1011.       PCXDUMP /WIDE:3    (since 200*3 = 600)
  1012.  
  1013.       If you have access to this game you should try it! To
  1014.       have any effect, the WIDE values must be in the range
  1015.       1-5.
  1016.  
  1017.       NOTE: This option will not have any effect on an EGA
  1018.       card.
  1019.  
  1020.  
  1021. Option: /?
  1022. ----------
  1023.       Same as /HELP
  1024.  
  1025.  
  1026.  
  1027. Use Under Microsoft Windows
  1028. ---------------------------
  1029.       PCXDUMP will work under MS Windows even though it is a DOS
  1030.       program, with certain limitations. Windows versions prior
  1031.       to 3.0 are not supported. In order to capture the complete
  1032.       screen (including active menus, the cursor etc.), you must
  1033.       run Windows in Standard Mode or Real Mode with the WIN /S
  1034.       (or /R) command and you MUST install PCXDUMP with the
  1035.       /STEALTH option BEFORE running Windows. The same capture
  1036.       hotkeys work as before, although you may wish to choose a
  1037.       hotkey which does not conflict with any Windows
  1038.       application accelerator keys. Also be cautious about Super
  1039.       VGA cards which are supplied with Windows drivers but
  1040.       which PCXDUMP does not yet support in high resolution
  1041.       modes. When capturing the Windows screen you will get a
  1042.       distorted dump if you move the mouse during the grabbing.
  1043.  
  1044.       If you attempt to run Windows in 386 Enhanced Mode with
  1045.       PCXDUMP resident and using the /STEALTH option, a message
  1046.       will appear after the Windows logo asking you to use the
  1047.       /S switch or to remove PCXDUMP from memory. Once up and
  1048.       running in 386 Enhanced Mode (PCXDUMP is not installed),
  1049.       PCXDUMP can be run from within a DOS box. However, the
  1050.       capture hotkey is only active when the DOS window has
  1051.       focus, and then only the contents of the window are
  1052.       captured. When PCXDUMP is run from a DOS-box under
  1053.       Windows, it is not possible to use the /STEALTH option.
  1054.  
  1055.  
  1056.  
  1057. System crashes
  1058. --------------
  1059.       If PCXDUMP crashes your machine when run, or when you
  1060.       attempt to grab a screen, you should first suspect the
  1061.       STEALTH base interrupt setting (see /STEALTH for more
  1062.       details). This is by far the most likely cause of a system
  1063.       crash, and you can work around it by specifying a
  1064.       different base interrupt vector or turning STEALTH off.
  1065.  
  1066.  
  1067.  
  1068. PCXDUMP and EMM386.EXE, QEMM386.EXE or other memory managers.
  1069. ------------------------------------------------------------
  1070.       If you use PCXDUMP together with a resident VESA-driver,
  1071.       AND you're using a memory manager like EMM386 or QEMM, you
  1072.       may sometimes get an exception error from your memory
  1073.       manager. It is because QEMM (or EMM386) does something
  1074.       weird with the Video BIOS. In order to fix this problem,
  1075.       you should use the QEMM 'exclude' options to exclude the
  1076.       Video BIOS area. Do this by including the following in the
  1077.       QEMM options:
  1078.             EXCLUDE=C000-C1FF
  1079.       This problem does not seem to appear with the 386Max
  1080.       memory manager.
  1081.  
  1082.       On some systems using EMM386.EXE (from Microsoft) or
  1083.       QEMM386.EXE (from Quaterdeck) PCXDUMP will generate an
  1084.       exception error #12 (stack under/overflow) when activated.
  1085.       The most likely cause is your CONFIG.SYS configuration!
  1086.       If you have the following line:
  1087.  
  1088.       STACKS = 0,0
  1089.  
  1090.       in your CONFIG.SYS file and you get an exception error
  1091.       from your memory manager, try to increase stacks to:
  1092.  
  1093.       STACKS = 8,256
  1094.  
  1095.       This will leave 2 Kb RAM less for applications, but
  1096.       will save you a lot of trouble in the future!
  1097.  
  1098.  
  1099.  
  1100. PCXDUMP and VESA-drivers
  1101. ------------------------
  1102.       In case you experience any problem with PCXDUMP and the
  1103.       VESA-driver for your videocard, I recommend you to get the
  1104.       great Universal VESA VBE driver by Kendall Bennett. You
  1105.       can probably download the latest shareware version of the
  1106.       Universal VESA-package from your local BBS, or you via the
  1107.       internet using ftp from Simtel20 or garbo. However the
  1108.       absolute latest version will always be available from the
  1109.       following ftp sites:
  1110.  
  1111.       ftp.scitechsoft.com
  1112.       oak.oakland.edu under /SimTelmsdos/graphics/univbe??.zip
  1113.  
  1114.       Kendall Bennett
  1115.       Internet:       KendallB@scitechsoft.com
  1116.       Compuserve:     100237,2213
  1117.       www:            http://www.scitechsoft.com
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Known problem
  1123. -------------
  1124.       On some Genoa cards PCXDUMP cannot recognize the extended
  1125.       graphics video modes. But you can force PCXDUMP to dump
  1126.       from these modes with the VIDEO option. Please read the
  1127.       section about the /VIDEO option to see a table over the
  1128.       extended Genoa video modes.
  1129.  
  1130.  
  1131.  
  1132. Where to get PCXDUMP
  1133. --------------------
  1134. The latest shareware issue of PCXDUMP, which includes the most
  1135. up-to-date information on pricing and new features, is always
  1136. posted for downloading in these places:
  1137.  
  1138. *     Ftp sites:
  1139.       wuarchive.wustl.edu in /mirrors/msdos/graphics/pcxdmp??.zip
  1140.       oak.oakland.edu in /SimTel/msdos/graphics/pcxdmp??.zip
  1141.       nic.funet.fi in /pub/msdos/graphics/graphics/pcxdmp??.zip
  1142.       garbo.uwasa.fi in /pc/graphics/pcxdmp??.zip
  1143.  
  1144. *     Public Software Library
  1145.       P.O. Box 35705
  1146.       Houston, Texas 77235-5705
  1147.       U.S.A.
  1148.  
  1149. *     CDV Software
  1150.       Postfach 2749
  1151.       D-76014 Karlsruhe
  1152.       GERMANY
  1153.  
  1154. *     Danish users:
  1155.       JOSTI-BBS,       Phone: 4738 0524, N81
  1156.       RAM-SOFT BSS,    Phone: 3314 5914, N81
  1157.       plus several other BBSs around the country.
  1158.  
  1159. If this document is more than nine months old when you receive
  1160. it, it might not be current. To make sure that you have the
  1161. latest information on pricing and availability of new features,
  1162. contact the author or look for the latest shareware release of
  1163. PCXDUMP in one of the places listed above.
  1164.  
  1165.  
  1166.  
  1167. Getting in contact with the author
  1168. ----------------------------------
  1169. If you have any questions, suggestions or you find any bugs,
  1170. please contact me at the following address:
  1171.  
  1172.       Viper Software
  1173.       Ny Banegaardsgade 51, 3th
  1174.       DK-8000 Aarhus C
  1175.       DENMARK
  1176.  
  1177.       Email: jesperf@daimi.aau.dk
  1178.  
  1179.  
  1180.  
  1181. Special thanks goes to:
  1182. -----------------------
  1183. Helle for being understanding.
  1184.  
  1185. Soren for testing, finding bugs, inventing new features and
  1186. correcting misspelled words.
  1187.  
  1188. Finn Thoegersen and Kendall Bennett for providing information on
  1189. various SuperVGA adapters.
  1190.  
  1191.  
  1192.  
  1193.  
  1194. APPENDIX A
  1195. ----------
  1196. This appendix shortly describes the /STEALTH technique and why it
  1197. sometimes is necessary to reprogram the interrupt controller and
  1198. how this is done. Basic knowledge about interrupts is assumed.
  1199.  
  1200. PCXDUMP uses INT 8 (the timer) and INT 9 (the keyboard) to check
  1201. the keyboard for the hotkey-sequence. If INT 8 or INT 9 for some
  1202. reason no longer points to PCXDUMP's code, it will not be
  1203. possible to activate PCXDUMP.
  1204.  
  1205.  
  1206.   Without /STEALTH  (nice programs)
  1207.   ---------------------------------
  1208.                  Intr. table
  1209.                  ┌────────┐     ┌────────────┐    ┌───────────┐
  1210.                  │ ....   │     │            │    │  Some     │
  1211.   ┌─────┐     ┌─>│ INT 8  │────>│  PCXDUMP   │───>│  program  │
  1212.   │     │  ┌──┴─>│ INT 9  │────>│            │───>│           │
  1213.   │ CPU │──┘     │ ....   │     └────────────┘    └───────────┘
  1214.   │     │        │ ....   │
  1215.   └─────┘        │ ....   │
  1216.                  │        │
  1217.  
  1218.   Without /STEALTH  (unfriendly programs)
  1219.   ---------------------------------------
  1220.                  Intr. table
  1221.                  ┌────────┐     ┌────────────┐
  1222.                  │ ....   │     │            │
  1223.   ┌─────┐     ┌─>│ INT 8  │───┐ │  PCXDUMP   │
  1224.   │     │  ┌──┴─>│ INT 9  │─┐ │ │            │    ┌───────────┐
  1225.   │ CPU │──┘     │ ....   │ │ │ └────────────┘    │  Some     │
  1226.   │     │        │ ....   │ │ └──────────────────>│  program  │
  1227.   └─────┘        │ ....   │ └────────────────────>│           │
  1228.                  │        │                       └───────────┘
  1229.  
  1230.  
  1231. The unfriendly program stole the INT 8 and INT 9 from PCXDUMP and
  1232. PCXDUMP cannot be activated. Many games takes complete control
  1233. over INT 8 and INT 9, as they like to monopolize the system
  1234. resources.
  1235. If you install PCXDUMP with the /STEALTH option, things look a
  1236. bit different. PCXDUMP has reprogrammed the interrupt controller
  1237. to a different set of vectors. When a program steals the keyboard
  1238. or timer interrupt it no longer gets first pick, but a fake
  1239. hardware interrupt generated by PCXDUMP resident code.
  1240.  
  1241. Lets see the situation with the unfriendly program again:
  1242.  
  1243.   With /STEALTH:216
  1244.   -----------------
  1245.  
  1246.                  Intr. table
  1247.                  ┌────────┐         ┌───────────┐
  1248.                  │ ....   │         │ Some      │
  1249.               ╔═>│ INT 8  │────────>│ program   │
  1250.               ╠═>│ INT 9  │────────>│           │
  1251.   ┌─────┐     ║  │ ....   │         └───────────┘
  1252.   │     │     ║  │ ....   │
  1253.   │ CPU │──┐  ║  │ ....   │    ┌───────────┐
  1254.   │     │  │  ╚════════════════│           │
  1255.   └─────┘  │     │ ....   │    │  PCXDUMP  │
  1256.            └──┬─>│ INT 216│───>│           │
  1257.               └─>│ INT 217│───>└───────────┘
  1258.                  │ ....   │
  1259.                  │ ....   │
  1260.  
  1261.  
  1262. You now see the beauty of it! No matter how much a program tries
  1263. to take over INT 8 and INT 9, PCXDUMP will always have first
  1264. pick, since PCXDUMP has instructed the interrupt controller to
  1265. send the timer and keyboard interrupt to INT 216 and INT 217
  1266. instead of INT 8 and INT 9. PCXDUMP will fake the original INT 8
  1267. and INT 9 code AFTER processing the interrupt. This way PCXDUMP
  1268. is always first in the interrupt chain.
  1269.  
  1270.  
  1271. ------------------- End of document ------------------------
  1272.