home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / GRAPHICS / MISC / PCXDMP50.ZIP / PCXDUMP.DOC < prev    next >
Encoding:
Text File  |  1992-05-21  |  36.9 KB  |  851 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                              PCXDUMP   Version 5.00
  28.                             ------------------------
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                            THE screen capture program
  35.                         Documentation and technical notes
  36.  
  37.                                   May 21, 1992
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                 Copyright 1992 by
  46.                                  Jesper Frandsen
  47.  
  48.  
  49.                        Email address : jesperf@daimi.aau.dk
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           DISCLAIMER AND WARRANTY
  71.           -----------------------
  72.  
  73.           This product is distributed AS IS. The author specifically
  74.           disclaim all warranties, expressed or implied, including, but
  75.           not limited to, implied warranties of merchantability and fitness
  76.           for a particular purpose with respect to defects in the diskette
  77.           and documentation, and program license granted herein, in particular,
  78.           and without limiting operation of the program license with respect
  79.           to any particular application use or purpose. In no event shall
  80.           the author be liable for any loss of profit or any other commercial
  81.           damage including but not limited to special, incidental, consequen-
  82.           tial or other damages.
  83.  
  84.  
  85.  
  86.  
  87.           LICENSING AGREEMENT
  88.           -------------------
  89.  
  90.           You may use this program for a 10 DAY TRIAL PERIOD.  Should you
  91.           find this program useful, you MUST register it; you will then be
  92.           provided with the latest releases of the PCXDUMP system (see last
  93.           section of this manual). The cost as of this writing is $25.00 U.S.
  94.           per single-user license. When you register, you receive a copy of the
  95.           latest registered version of PCXDUMP, plus any enhancements that have
  96.           been added since this document was released.
  97.           If you obtained this program from a shareware disk distributor, then
  98.           you have paid only for the service of copying this disk, but you have
  99.           not paid for the program itself. The author receives no part of the
  100.           price you may have paid to a disk distributor for this disk.
  101.  
  102.           +-----------------------------------------------------------------+
  103.           |                                                                 |
  104.           |   Notice to Distributors, Publishers and User's Groups:         |
  105.           |   ------------------------------------------------------        |
  106.           |   Please consult the last page of this document for important   |
  107.           |   license information and restrictions.                         |
  108.           |                                                                 |
  109.           +-----------------------------------------------------------------+
  110.  
  111.           PC, XT, PC/AT and PS/2 are trademarks, and IBM is a registered
  112.           trademark, of International Business Machines Corporation.
  113.           Hercules is a registered trademark of Hercules Computer Technology
  114.           PC Paintbrush is a registered trademark of Zsoft Corporation.
  115.           WordPerfect is a registered trademark of WordPerfect Corporation.
  116.           PageMaker is a registered trademark of Aldus Corporation.
  117.           Ventura Publisher is a registered trademark of Ventura Software Inc.
  118.           GIF is a trademark of CompuServe Inc.
  119.  
  120.  
  121.  
  122.  
  123.           OVERVIEW OF PCXDUMP
  124.           -------------------
  125.  
  126.           PCXDUMP is a program that saves the images on the screen of your
  127.           IBM Personal Computer or compatible PC to a disk file.
  128.           PCXDUMP is memory-resident, which means that after you start it,
  129.           the program is always waiting in the background, while you con-
  130.           tinue to run other programs. You tell PCXDUMP to capture the image
  131.           currently being displayed on the screen by pressing a combination
  132.           of keys which PCXDUMP reserves for itself.
  133.           The saved images is put on the disk in the PCX-format. A large
  134.           variety of word processors, desktop publishers and paint programs
  135.           are capable of importing PCX-files, e.g. WordPerfect, PageMaker,
  136.           Ventura Publisher, PaintBrush and many many more.
  137.  
  138.           The PCX-files will be put in the current directory unless
  139.           specified (see the /DIR= switch under INSTALLATION OPTIONS),
  140.           and named DUMP_000.PCX, DUMP_001.PCX etc. (up to DUMP_999.PCX).
  141.  
  142.           If anyone wants the pictures in another format (eg. GIF), use a
  143.           converter program like the GRAPHIC WORKSHOP or VPIC.
  144.           (available from "wuarchive.wustl.edu" or "wsmr-simtel20.army.mil")
  145.  
  146.  
  147.  
  148.  
  149.           9 GOOD REASONS TO USE PCXDUMP
  150.           -----------------------------
  151.  
  152.           THE PRICE           - PCXDUMP will only cost you 25.00 $.
  153.  
  154.           THE SIZE            - PCXDUMP will use less than 9900 bytes of
  155.                                 conventional memory (and no EMS or XMS).
  156.  
  157.           THE SPEED           - ALL pixel writes/read are direct to the
  158.                                 video memory and hence really fast!
  159.  
  160.           SUPER-VGA           - PCXDUMP recognizes a large number of SuperVGA
  161.                                 chips, and are able to use their resolutions
  162.                                 as well.
  163.  
  164.           IT'S EASY TO USE    - Just press the hotkey and use the mouse or
  165.                                 keyboard to control which part of the screen
  166.                                 to save.
  167.                                 Some capture programs requires the user to
  168.                                 convert the output to a widely used graphic
  169.                                 format like GIF or PCX. PCXDUMP converts the
  170.                                 images directly to the PCX-format.
  171.  
  172.           FLEXIBLE            - You can customize the hotkeys to a hotkey of
  173.                                 your own choice.
  174.  
  175.           -                     PCXDUMP offers a couple of ways to "delay" the
  176.                                 installation. Read about it in "PCXDUMP INSTAL-
  177.                                 LATION OPTIONS". This means in short that you
  178.                                 will be able to capture screens, which you
  179.                                 normally wouldn't be able to capture.
  180.  
  181.           -                     A lot of (specially new) games push the EGA
  182.                                 or VGA-card to the limit and use undocumented
  183.                                 videomodes to get smooth scrool and smooth
  184.                                 animation. PCXDUMP will now handle these modes.
  185.                                 However, since the registers are write-only
  186.                                 (can't be read) on EGA-cards, PCXDUMP can not
  187.                                 detect and use these modes, unless you have a
  188.                                 least a VGA-card !
  189.  
  190.           IT'S NOT CRIPPLED   - And last, but not least. It's not crippled in
  191.                                 any way. PCXDUMP is a program to capture
  192.                                 graphic screens, and it will work in all the
  193.                                 videomodes that it can handle. But if you re-
  194.                                 gister, you will get the "text capturing" func-
  195.                                 toin as a bonus !
  196.  
  197.  
  198.  
  199.  
  200.           PCXDUMP REQUIREMENTS
  201.           --------------------
  202.  
  203.           To use PCXDUMP, you will need:
  204.  
  205.                     a)  an IBM PC, XT, AT, PS/2, or 100% compatible computer;
  206.  
  207.                     b)  at least one floppy diskette drive; and
  208.  
  209.                     c)  the IBM-PC DOS (Disk Operating System), or
  210.                          MS-DOS, in a version numbered 2.0 or higher.
  211.  
  212.           Besides a Mouse Systems compatible mouse will be convenient.
  213.  
  214.           You can use PCXDUMP with either a color or a monochrome EGA or VGA
  215.           display card (and naturally with a SuperVGA display card).
  216.  
  217.  
  218.  
  219.  
  220.           WHAT PCXDUMP CAN CAPTURE
  221.           ------------------------
  222.  
  223.           PCXDUMP is capable of capturing graphic images on systems equipped
  224.           with any of the following video display adapters:
  225.  
  226.             *  Multicolor Graphics Adapter (MCGA)
  227.             *  Enhanced Graphics Adapter (EGA)
  228.             *  Video Gate Array adapter (VGA)
  229.  
  230.           Although PCXDUMP can dump images from mode 4,5 and 6 (which is CGA
  231.           modes), you will still need mininum an EGA or MCGA card to install
  232.           PCXDUMP.
  233.  
  234.           No Hercules support, sorry ! If anyone have a desperate need for
  235.           using PCXDUMP on Hercules (mono) systems, please (e)mail me.
  236.           Then *maybe* I'll think about it!
  237.  
  238.           PCXDUMP captures all of the video modes listed in the following
  239.           chart, which have been standardized by manufacturers of the various
  240.           video adapters mentioned above:
  241.  
  242.                Video   Graphics                Adapters
  243.                Mode   Resolution  Colors      Supporting
  244.                -----  ----------  ----------  --------------------
  245.  
  246.                 04     320 x 200       4        CGA/EGA/VGA  *)
  247.                 05     320 x 200       4        CGA/EGA/VGA  *)
  248.                 06     640 x 200       2        CGA/EGA/VGA
  249.                 13     320 x 200      16        EGA/VGA
  250.                 14     640 x 200      16        EGA/VGA
  251.                 15     640 x 350       2        EGA/VGA
  252.                 16     640 x 350      16        EGA/VGA
  253.                 17     640 x 480       2        VGA/MCGA
  254.                 18     640 x 480      16        VGA
  255.                 19     320 x 200     256        VGA/MCGA
  256.  
  257.                 *) In these two CGA-modes, PCXDUMP will always use a palette
  258.                    of Black, Cyan, Magenta and White.
  259.  
  260.           And if you have any of these SVGA-cards, you will be able to use
  261.           their SVGA-modes as well !!
  262.  
  263.                 - ATI-WONDER       (up to 1024x768x256,
  264.                                            640x480x32768)
  265.                 - TRIDENT          (up to 1024x768x256)
  266.                 - GENOA            (up to 1024x768x16, 800x600x256)
  267.                 - PARADISE         (up to 1024x768x256,
  268.                                            800x600x32768)
  269.                 - TSENG ET 3000    (up to 1024x768x16, 800x600x256)
  270.                 - TSENG ET 4000    (up to 1024x768x256)
  271.                 - TSENG HiColor    (up to 1280x1024x16,
  272.                                           1024x768x256
  273.                                            800x600x32768)
  274.                 - OAK-037C         (up to  800x600x16)
  275.                 - OAK-067          (up to 1024x768x16, 800x600x256)
  276.                 - VIDEO-7          (up to 1024x768x16, 800x600x256)
  277.                                    (incl.  720x540x16, 720x540x256)
  278.                 - CHIP & TECH.     (up to 1024x768x16, 800x600x256)
  279.                 - AHEAD A/B        (up to 1024x768x256)
  280.                 - VESA CARDS       (up to 1280x1024x256)
  281.  
  282.           PCXDUMP is not designed to work with high-resolution 4-color
  283.           images.
  284.  
  285.           NOTE: On the TSENG HiColor card (and the other cards that can show
  286.                 32768 colors), when you're capturing graphics in 32768 colors
  287.                 be aware that although VPIC is able to show 24-bit Targa pic-
  288.                 tures, it can't show 24-bit PCX (VPIC version 4.6). However I
  289.                 have seen ALCHEMY 1.5.1 (from Handmade Software, Inc.) show
  290.                 24-bit PCX correctly.
  291.  
  292.  
  293.  
  294.           TEXT MODES
  295.           ----------
  296.  
  297.           In the registrated version of PCXDUMP, you will also be able to
  298.           capture screens in these text-modes:
  299.  
  300.                Video   Text                    Adapters
  301.                Mode   Resolution  Colors      Supporting
  302.                -----  ----------  ----------  --------------------
  303.                 03    80x25           16        EGA/VGA/MCGA
  304.                 03    80x43           16        EGA
  305.                 03    80x50           16        VGA/MCGA
  306.                 07    80x25            2        EGA/VGA
  307.                 07    80x43            2        EGA/VGA
  308.                 -    132x25           16        Some SVGA-cards
  309.                 -    132x28           16        Some SVGA-cards
  310.                 -    132x44           16        Some SVGA-cards
  311.                 -    100x40           16        Some SVGA-cards
  312.                 -    100x60           16        Some SVGA-cards
  313.                 -     80x66           16        Some SVGA-cards
  314.                 -     80x60           16        Some SVGA-cards
  315.  
  316.           In all modes except mode 07, you can capture the screen in both color
  317.           or monochrome.
  318.           In text mode, PCXDUMP uses the RAM resident font to convert the
  319.           screen to a bitmap. This means that the resulting bitmap represents
  320.           the captured text screen exactly as it appears on the screen, even
  321.           if the program loads a specialized font.
  322.  
  323.           Note that with Ventura Publisher or WordPerfect 5.1, the size of the
  324.           image when incorporated into your document is dependent on the size
  325.           of the frame (VP) or figure (WP). For best results, you must adjust
  326.           this size (within VP or WP) so that pixels are not truncated or
  327.           compressed. You can calculate the best size for the image in your
  328.           document based on the horizontal and vertical resolution of your
  329.           printer. For example lets say you capture a VGA text mode screen that
  330.           has 80 columns and 25 lines. The font size in this mode is 8 by 16
  331.           pixels. This means that there are 400 (16 times 25) scan lines in the
  332.           image and it is 640 pixels horizontally (80 times 8). You must size
  333.           the image so that the number of pixels in the image is evenly divisi-
  334.           ble by the printer resolution. Therefore, if you have a laser printer
  335.           or DeskJet printer that prints at a resolution of 300 dots per inch
  336.           (both horizontal and vertical), a frame size of 2.13 inches by 1.33,
  337.           or 4.27 inches by 2.67 inches would produce non-distorted output.
  338.           Note that you must account for the inside border space and border
  339.           width when sizing figures in WordPerfect.
  340.  
  341.           NOTE: If you capture a color screen on a plain EGA card, the colors
  342.                 may not seen right when you try to view it. PCXDUMP dumps the
  343.                 color text-screen in a 256-colors PCX-file. Any program that
  344.                 shows 256 color files to an EGA-screen must try to find the
  345.                 best colors since EGA can only show 16 out of 64 colors. And if
  346.                 the program that you use to show the PCX-files isn't good
  347.                 enough, the result may be funny colors.
  348.                 A solution is to remap the PCX-files to 16 colors. This can be
  349.                 done with e.g. PICLAB or GRAPHIC WORKSHOP (both shareware).
  350.  
  351.  
  352.  
  353.           HOT-KEYS
  354.           --------
  355.  
  356.           When PCXDUMP is installed, you can use these hotkeys:
  357.  
  358.           ALT+SHIFT+N gives a 2 color PCX-file
  359.           ALT+SHIFT+I gives a inverted 2 color PCX-file
  360.           ALT+SHIFT+C gives a 256 color PCX-file
  361.           ALT+SHIFT+R dumps the whole screen in 2 colors   (dumps immediately)
  362.           ALT+SHIFT+E dumps the whole screen in 256 colors (dumps immediately)
  363.  
  364.           PCXDUMP will give a beep when activated and (a higher) one when it
  365.           has finished dumping graphics. If you activate PCXDUMP in an un-
  366.           supported videomode, such as a 4 color hires mode, PCXDUMP will a
  367.           long deep tone.
  368.  
  369.           You can only use the C & E hotkeys when there's at least 16
  370.           colors on the screen.
  371.  
  372.           It's possible change the hotkeys, read about it in "PCXDUMP
  373.           INSTALLATION OPTIONS"
  374.  
  375.  
  376.  
  377.  
  378.           ADJUSTING FRAMESIZE
  379.           -------------------
  380.  
  381.           If you own a mouse and have your mouse-driver installed, you will
  382.           be able to cut out part of the screen with a on-screen frame,
  383.           controlled by the mouse.
  384.           This can also be done by using the arrowkeys plus <SPACE>.
  385.  
  386.           You will only be able to cut/clip in graphics mode. In textmode
  387.           the whole screen will be saved immediately. This is also the case
  388.           in a "tricky" video, like mode X (320x240x256) or in a mode with
  389.           smooth scrool.
  390.  
  391.           The size of the frame will be shown in upperleft corner.
  392.  
  393.           MOUSE:
  394.           Press RIGHT button and move mouse to control frame-size.
  395.           Press LEFT button and move mouse to control frame-position.
  396.  
  397.           KEYBOARD:
  398.           Press the arrowkeys to control frame-size.
  399.           Press <SPACE> plus the arrowkeys to control frame-position.
  400.  
  401.           BOTH MOUSE and KEYBOARD:
  402.           Press <ENTER> to dump graphic within frame.
  403.           Press <ESC> to cancel
  404.  
  405.           You can only adjust the framesize, when using the N, I & C hotkeys.
  406.  
  407.  
  408.  
  409.           HOW FAST IS PCXDUMP ?
  410.           ---------------------
  411.  
  412.           Direct memory read/write will be performed in ALL modes,
  413.           2, 16, 256 and 32768 colors mode. So the program is pretty fast !!
  414.           I'm using a 386sx/20 Mhz system (and a Tseng ET4000 card),
  415.           and this is my measurements:
  416.  
  417.                picture       sec (approx.)
  418.           --------------------------------
  419.            320 x 200 x 256         1-1.5
  420.            640 x 480 x 256         6
  421.            800 x 600 x 256         9
  422.           1024 x 768 x 256         14
  423.            640 x 480 x 16          11
  424.            800 x 600 x 16          17
  425.           1024 x 768 x 16          27
  426.            640 x 480 x 32768       23
  427.  
  428.           In 16-colors mode, things take a little longer, because it's more
  429.           complicated to read and write pixels than in 256 colors mode....
  430.  
  431.           Due to the 24-bit coding in PCX-files, capturing of graphics in
  432.           32768 colors mode involves 3 readings of every pixel and therefore
  433.           making capturing of these mode slower than other modes.
  434.  
  435.           If it's a simple picture, things will go faster since PCXDUMP
  436.           don't have to write so much information to the disk.
  437.  
  438.  
  439.  
  440.  
  441.           IF THE COMPUTER IS TOO BUSY TO CAPTURE
  442.           --------------------------------------
  443.  
  444.           There may be times when you request PCXDUMP to capture your screen,
  445.           but nothing, at first, seems to happen. This is usually because
  446.           the foreground application program is in the middle of a sensitive
  447.           task which cannot be interrupted.
  448.           In these cases, PCXDUMP is aware that you have requested a screen
  449.           capture, and will pop up as soon as it becomes safe to do so.
  450.  
  451.  
  452.  
  453.  
  454.           PCXDUMP INSTALLATION OPTIONS
  455.           ----------------------------
  456.  
  457.           This section identifies the "command line switches" which PCXDUMP
  458.           recognizes and responds to. A command line switch is a string of
  459.           characters which you type after the PCXDUMP command itself.
  460.  
  461.           The purpose of these switches is to allow you to modify the way
  462.           PCXDUMP performs certain of its operations. Turning PCXDUMP's beep
  463.           sounds off and removing PCXDUMP from then memory are just two
  464.           examples of functions which the command line switches allow you to
  465.           control.
  466.  
  467.           A single command line may contain as many switch options as you
  468.           desire, in any order, in either uppercase or lowercase letters.
  469.  
  470.  
  471.           Option:   /ON
  472.           -------------
  473.           Usage:  PCXDUMP /ON
  474.  
  475.                   Installs PCXDUMP. This option is only necessary if no other
  476.                   options are given.
  477.  
  478.  
  479.  
  480.           Option:   /OFF
  481.           --------------------------
  482.           Usage:  PCXDUMP /OFF
  483.  
  484.                   This option removes PCXDUMP from the memory.
  485.  
  486.                   Don't use this switch if PCXDUMP not is the last TSR loaded.
  487.                   If another resident program is loaded AFTER PCXDUMP and
  488.                   you use this option, the memory may be messed up and you
  489.                   may have to reboot.
  490.  
  491.  
  492.  
  493.           Option:   /NOSOUND
  494.           ------------------
  495.           Usage:  PCXDUMP [other options] /NOSOUND
  496.  
  497.                   Tells PCXDUMP to turn off sound.
  498.  
  499.  
  500.  
  501.           Option:   /TIME=number
  502.           ----------------------
  503.           Usage:  PCXDUMP [other options] /TIME=number
  504.  
  505.                   Use this option to "delay" the installation of INT 09h.
  506.                   Many programs (e.g. games like "4D STUNT DRIVE") will take
  507.                   complete control over INT 09h at startup (INT 09h is the
  508.                   hardware keyboard interrupt, remember) and doesn't call
  509.                   the original INT 09h. For that reason PCXDUMP's own INT 09h
  510.                   will not be called at all. This obstacle can be overcome by
  511.                   using this option. If your program takes, say, about 20
  512.                   seconds to start up, it's a good idea to delay the instal-
  513.                   lation about 30 seconds. PCXDUMP uses the hardware clock
  514.                   interrupt at INT 08h to keep track of time.
  515.  
  516.                   Example:
  517.  
  518.                   PCXDUMP /time=60
  519.  
  520.                   Installs PCXDUMP, and PCXDUMP waits 60 seconds before it
  521.                   grabs INT 09h.
  522.  
  523.                   Keep in mind that when you use this option, you will not be
  524.                   able to use PCXDUMP after exiting the program (or game) you
  525.                   wished to save images from. The reason for this is that the
  526.                   interrupted program remembers the "old" INT 09h address, and
  527.                   when you exit the program it restores INT 09h and thereby
  528.                   overwrites your INT 09h address. But since you now have
  529.                   saved all the images you wanted, you couldn't care less.
  530.                   If you want to use PCXDUMP again, you don't have to reboot.
  531.                   Remove PCXDUMP from the memory by writing:
  532.  
  533.                     PCXDUMP /OFF
  534.  
  535.                   and then install PCXDUMP again.
  536.  
  537.                   NOTE: when using the /TIME or /DISK options to delay the
  538.                   installation, PCXDUMP will now beep twice when it installs
  539.                   itself. This is a great help, since you now will know if it
  540.                   was possible for PCXDUMP to take over INT 09h.
  541.  
  542.  
  543.  
  544.           Option:   /DISK=number
  545.           ----------------------
  546.           Usage:  PCXDUMP [other options] /DISK=number
  547.  
  548.                   This is another way to "delay" the installation of INT 09H.
  549.                   In fact this option "delays" the installation of both INT
  550.                   08h and INT 09h.
  551.  
  552.                   In some programs (I have seen this in the WING COMMANDER
  553.                   game) it's not possible to gain access to the keyboard even
  554.                   with the /TIME option. The reason for this is that the WING
  555.                   COMMANDER game takes complete control over both INT 08h and
  556.                   INT 09h WITHOUT calling the original interrupt procedures.
  557.  
  558.                   My way of handling this is a bit tricky and may be unstable,
  559.                   but this is the only way I've come up with so far:
  560.  
  561.                   Instead of counting how many seconds it takes before the
  562.                   program is ready, you count how many times the program reads
  563.                   from the disk during startup (that is: how many times INT
  564.                   13h is called). I have included a little TSR-program that
  565.                   count exactly how many times INT 13h is called. This program
  566.                   is "GETINT13.EXE".
  567.                   You run "GETINT13.EXE". Start the program you wish to save
  568.                   images from. When it's loaded, exit the program. Out in the
  569.                   DOS again you press the hotkey to activate GETINT13 ->
  570.                   ALT+SHIFT+2 and GETINT13 will tell you how many times
  571.                   INT 13h was called.
  572.  
  573.                   Example:
  574.  
  575.                   When I wanted to save the logo from WING COMMANDER, I did
  576.                   this:
  577.  
  578.                   C:\>GETINT13 <+ENTER>
  579.                   C:\>WC       <+ENTER to start WING COMMANDER>
  580.                                As soon as I could I quit WING COMMANDER by
  581.                                pressing ALT+X (I think).
  582.  
  583.                   Out in the DOS again I pressed ALT+SHIFT+2 to see how many
  584.                   times INT 13h was called (about 190 as I remember).
  585.  
  586.                   I then installed PCXDUMP:
  587.  
  588.                   C:\>PCXDUMP /DISK=150 /SHIFT=0 /HOTKEY=14
  589.  
  590.                   and started WING COMMANDER again.
  591.                   When the logo appeared I pressed BackSpace which was the
  592.                   new hotkey for PCXDUMP.
  593.  
  594.                   Well back in DOS again, it's no longer possible to activate
  595.                   PCXDUMP (for the same reasons as with the /TIME option).
  596.                   But you can remove PCXDUMP from the memory with the option
  597.                   /OFF and the re-install PCXDUMP.
  598.  
  599.                   Keep in mind that you have to be a little desperate to use
  600.                   this option. Not that your computer can be harmed in any way
  601.                   but the risk for the computer to "hang" is present.
  602.                   But what the heck, at least you have now a chance to save
  603.                   your precious image.
  604.  
  605.                   As you noticed, WING COMMANDER called INT 13h about 190 times
  606.                   but I gave PCXDUMP the option /DISK=150. Remember that
  607.                   any program will load a lot data when you start it, at
  608.                   least it loads itself, but doesn't save the same amount of
  609.                   data when exiting, so use a smaller number than GETINT13
  610.                   tells you, since GETINT13 count the total calls of INT 13h.
  611.  
  612.  
  613.  
  614.           Option:   /SHIFT=number
  615.           -----------------------
  616.           Usage:  PCXDUMP [other options] /SHIFT=number
  617.  
  618.                   Instead of using the default hotkey sequence which is
  619.                   ALT+SHIFT+<some hotkey>, you can tell PCXDUMP to use
  620.                   any combination of the ALT, Left SHIFT and CTRL keys.
  621.  
  622.                   number    Effect on hotkey sequence
  623.                   -----------------------------------
  624.                    0        No shift keys
  625.                    1        Press (Left) SHIFT
  626.                    2        Press ALT
  627.                    3        Press ALT + (Left) SHIFT
  628.                    4        Press CTRL
  629.                    5        Press (Left) SHIFT + CTRL
  630.                    6        Press ALT + CTRL
  631.                    7        Press (Left) SHIFT + ALT + CTRL
  632.  
  633.  
  634.  
  635.           Option:   /HOTKEY=scancode
  636.           --------------------------
  637.           Usage:  PCXDUMP [other options] /HOTKEY=scancode
  638.  
  639.                   Instead of using the default hotkeys (C,E,R,N,I), you can
  640.                   tell PCXDUMP to use a custom hotkey.
  641.                   When doing that all other hotkeys will be disabled and you
  642.                   will no longer be able to use the mouse. The image will be
  643.                   saved immediately and PCXDUMP will automatically determine
  644.                   whether to dump a color or monochrome image.
  645.  
  646.                   In Appendix A you will find a list of possible hotkey-
  647.                   scancode.
  648.  
  649.                   If you don't have a standard keyboard or you want to use a
  650.                   hotkey not listed in Appendix A, I've included a program
  651.                   "SCANCODE.EXE" which will help you.
  652.                   Just run the program, press the key you want as the hotkey
  653.                   and remember the scancode number (in decimal). Press ESC to
  654.                   exit the program. Use the scancode number you just saw when
  655.                   installing PCXDUMP.
  656.  
  657.                   The scancode must be in the range 1-90.
  658.  
  659.                   If you try to install PCXDUMP when it's allready installed,
  660.                   you will hear a beep and the current hotkey combination will
  661.                   be display on the screen. You will also see the message:
  662.                   "PCXDUMP is already installed!".
  663.  
  664.  
  665.  
  666.           Option:   /DIR=directory
  667.           --------------------------
  668.           Usage:  PCXDUMP [other options] /DIR=directory
  669.  
  670.                   This option will place the PCX-files (DUMP_000.PCX etc)
  671.                   in the specified directory instead of the current directory.
  672.                   Many programs will have some data in other directories than
  673.                   the up-start directory, and this option saves you for the
  674.                   trouble of tracking down the PCX-files after capturing the
  675.                   graphics.
  676.  
  677.                   Example:
  678.  
  679.                   PCXDUMP /DIR=C:\          (* Will place files in C:\ *)
  680.                   PCXDUMP /DIR=C:\PCX\      (* If C:\PCX\ exist then files
  681.                                                will be put here *)
  682.  
  683.                   Instead of writing /DIR=C:\PCX\ you can also write
  684.                   /DIR=C:\PCX
  685.  
  686.  
  687.  
  688.           Option:   /CHIPSET=number
  689.           --------------------------
  690.           Usage:  PCXDUMP [other options] /CHIPSET=number
  691.  
  692.                   If PCXDUMP somehow fails to recognize your video-adapter,
  693.                   which you know is on the list, this is a way to force
  694.                   PCXDUMP to use it.
  695.                   The number must be in the range 2-19:
  696.  
  697.                    Number  Chipset               Number    Chipset
  698.                    ----------------------       -------------------
  699.                       0   UNSUPPORTED             10   Tseng 4000 HiColor
  700.                       1   RESERVED                11   OAK-37
  701.                       2   EGA-card                12   OAK-67
  702.                       3   VGA-card                13   Video 7
  703.                       4   ATI-vga                 14   Ahead A
  704.                       5   Trident                 15   Ahead B
  705.                       6   Genoa                   16   Chips & Technology 451
  706.                       7   Paradise                17   Chips & Technology 452
  707.                       8   Tseng 3000              18   Chips & Technology 453
  708.                       9   Tseng 4000              19   VESA
  709.  
  710.  
  711.  
  712.           Option:   /NOPEL
  713.           --------------------------
  714.           Usage:  PCXDUMP [other options] /NOPEL
  715.  
  716.                   This option will prevent PCXDUMP to read a certain re-
  717.                   gister on the graphics card (the horizontal pel panning
  718.                   register). Reading of this register sometimes blanks the
  719.                   screen while PCXDUMP is dumping graphics (normally the
  720.                   screen reappears when PCXDUMP is finished). This register
  721.                   determines exactly where the screen starts if there is
  722.                   smooth scrool involved (in a 16 color mode). If you explicitly
  723.                   tell PCXDUMP not to read this register, PCXDUMP will dump a
  724.                   picture which is 8 pixels wider than the physical display.
  725.                   Later you can cut out precisely the part of the picture
  726.                   you're interested in. This option has no effect, unless you
  727.                   have at least a VGA-card.
  728.  
  729.  
  730.  
  731.           APPENDIX A
  732.           ----------
  733.  
  734.           These are the codes you may use with PCXDUMP's "/HOTKEY=scancode"
  735.           parameter to change the hotkeys.
  736.  
  737.             Key  Code      Key  Code      Key    Code      Key           Code
  738.             ---------      ---------      -----------      ------------------
  739.              A    30        1    02        F1     59       Keypad plus    78
  740.              B    48        2    03        F2     60       Keypad minus   74
  741.              C    46        3    04        F3     61       Keypad 5       76
  742.              D    32        4    05        F4     62       Space          57
  743.              E    18        5    06        F5     63       Backspace      14
  744.              F    33        6    07        F6     64       Enter          28
  745.              G    34        7    08        F7     65
  746.              H    35        8    09        F8     66
  747.              I    23        9    10        F9     67
  748.              J    36        0    11       F10     68
  749.              K    37                      F11     87
  750.              L    38        `    41       F12     88
  751.              M    50        -    12
  752.              N    49        =    13       Tab     15
  753.              O    24        ,    51       Esc     01
  754.              P    25        .    52
  755.              Q    16        /    53
  756.              R    19        ;    39
  757.              S    31        '    40
  758.              T    20        [    26
  759.              U    22        ]    27
  760.              V    47        \    43
  761.              W    17
  762.              X    45
  763.              Y    21
  764.              Z    44
  765.  
  766.  
  767.  
  768.  
  769.           REGISTRATION
  770.           ------------
  771.  
  772.           REGISTRATION OF PCXDUMP IS BASED ON 'PERSONAL USAGE'. CORPORATE OR
  773.           ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  774.           BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  775.           REGISTRANT WHO WILL BE PROVIDED WITH A NEW VERSION OF PCXDUMP WHERE
  776.           THE NAME OF THE SPECIFIED PERSON WILL BE SEEN TO INDICATE REGISTERED
  777.           USAGE. REGISTRATION GRANTS A SPECIFIC PERSON (NOT A JURIDICAL PERSON
  778.           OR CORPORATE ENTITY) THE RIGHT TO 'USE' PCXDUMP.
  779.  
  780.           ┌───────────────────────────────────────────────────────────────────┐
  781.           │ ALTHOUGH I WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS, │
  782.           │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  783.           └───────────────────────────────────────────────────────────────────┘
  784.  
  785.  
  786.  
  787.  
  788.           ORDERING INFORMATION
  789.           ---------------------
  790.  
  791.           The prices of the registered PCXDUMP packages are subject to change
  792.           after January 1, 1993. The latest shareware issue of PCXDUMP, which
  793.           includes the most up-to-date information on pricing and new features,
  794.           is always posted for downloading in these places:
  795.  
  796.            *   American users:
  797.  
  798.                The migthy simtel base.
  799.                FTP-address: wsmr-simtel20.army.mil in pd1:<msdos.graphics>
  800.                and it's mirror-site
  801.                FTP-address: wuarchive.wustl.edu in /mirrors/msdos/graphics
  802.  
  803.            *   European users:
  804.  
  805.                FTP-address: nic.funet.fi    in /pub/msdos/graphics/graphics
  806.                FTP-address: garbo.uwasa.fi  in /pc/graphics
  807.  
  808.           If this document is more than nine months old when you receive it,
  809.           it might not be current. To make sure you have the latest informa-
  810.           tion on pricing and availability of new features, contact the author
  811.           or look for the latest shareware release of PCXDUMP in one of the
  812.           places listed above.
  813.  
  814.           You can use a check or money order to receive latest release of
  815.           PCXDUMP.
  816.  
  817.           To obtain registered release of the PCXDUMP system, register by
  818.           sending the order form below with your check or money order for
  819.           $25.00 U.S. per copy, payable to Jesper Frandsen.
  820.           Send your order to:
  821.  
  822.  
  823.                               Jesper Frandsen
  824.                               Fredens Torv 7, 2. Sal
  825.                               8000 Aarhus C
  826.                               DENMARK
  827.  
  828.  
  829.  
  830.      +---------------------------------------------------------------------+
  831.      |                                                                     |
  832.      |  I wish to license _____ copy/copies of the latest release of the   |
  833.      |  PCXDUMP program. I have enclosed $25.00 for each single-user       |
  834.      |  license, as indicated. (Prices subject to change.)                 |
  835.      |                                                                     |
  836.      |  I have also enclosed extra $4.00 for shipping and handling.        |
  837.      |                                                                     |
  838.      |  Name ___________________________________________________________   |
  839.      |                                                                     |
  840.      |  Company (if applicable) ________________________________________   |
  841.      |                                                                     |
  842.      |  Address ________________________________________________________   |
  843.      |                                                                     |
  844.      |  City _______________________________  State ______  Zip ________   |
  845.      |                                                                     |
  846.      |  Country _____________________                                      |
  847.      |                                                                     |
  848.      |  I prefer:  _____ 3-1/2" disk;  _____ 5-1/4" disk                   |
  849.      |                                                                     |
  850.      +---------------------------------------------------------------------+
  851.