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