home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / grspman.zip / CAP.MAN next >
Text File  |  1986-08-20  |  12KB  |  433 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                      C A P     
  18.  
  19.             PCPAINT-Compatible Picture and Clipping Capture Utility
  20.  
  21.       Written by John Bridges and Doug Wolfgram for Microtex Indutstries
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                          Another USEware product from:
  51.  
  52.                            Microtex Industries, Inc.
  53.                           2091 Business Center Drive
  54.                               Irvine, Ca.  92715
  55.                                 (714) 476-0777
  56.  
  57.                   (714) 545-8100 - PCPaint Picture Swap Line
  58.  
  59.        Current release number: 1.1B          Current release date: 08/86
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                  WHAT IS CAP?
  73.  
  74.  
  75.       CAP is a utility to aid GRASP users in capturing clippings and pict-
  76.       ures from programs  other  than  PCPAINT  PLUS(tm).    With  CAP, a
  77.       user can capture images from virtually any other program and quickly
  78.       move images  into presentations  running under  GRASP. The pictures
  79.       and  clippings  created  by  CAP  are  completely PCPAINT PLUS(tm),
  80.       GRASP(tm)  and  ARTOOLS(tm)  compatible.  CAP  is  memory  resident
  81.       and occupies approximately 26K of memory.
  82.  
  83.  
  84.                                 HOW TO RUN CAP
  85.  
  86.       To run  CAP, just  be sure  that CAP.COM  is either  on the current
  87.       drive and directory, or is accessible by your PATH statement. If this
  88.       isn't clear, the put the GRASP distribution disk into drive A, close
  89.       the door, and type the following:
  90.  
  91.       A: {enter}
  92.       CAP {enter}
  93.  
  94.       You should see a message that looks like:
  95.  
  96.  
  97.       Resident Capture Utility v1.1
  98.       Written by John Bridges
  99.       Microtex Industries, Inc. 1986
  100.       Press ALT rightSHIFT to capture screen
  101.  
  102.       CAP is now loaded and ready for use.
  103.  
  104.  
  105.  
  106.       WARNING:  Please do NOT  run  CAP  twice.  Sometimes,  depending on
  107.       your machine,  it will  cause the  system to  hang.   Keep track of
  108.       whether you have loaded CAP or not and  only load  it once.  If you
  109.       need to remove it, use the procedure below, REMOVING CAP.
  110.  
  111.  
  112.                                 BRINGING UP CAP
  113.  
  114.       To activate  CAP, hold  down the  ALT key  and press  the shift key
  115.       that is on the right side  of  the  keyboard  (opposite  from ALT).
  116.       Release both  keys and  you should see a flashing crosshairs in the
  117.       center of the screen. At this point, you would do whatever you want
  118.       to do  inside CAP  (see USING  CAP for more details), then quit CAP
  119.       by pressing ESC.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                  CAP - Resident Capture Utility for GRASP(tm)
  126.                                    Page:  1
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                  REMOVING CAP
  134.  
  135.       If CAP is the LAST memory resident utility you loaded, and you want
  136.       to free up the memory it occupies, just press CTRL-Q while you have
  137.       the CAP crosshairs on the screen. In other  words, where  you would
  138.       normally press  ESC to quit CAP, press CTRL-Q to quit and remove it
  139.       from memory instead.
  140.  
  141.  
  142.                              CHANGING THE CAP KEYS
  143.  
  144.       As was stated before, to bring up CAP you press the ALT  and right-
  145.       SHIFT keys  together. If  this particular key arrangement conflicts
  146.       with your application software, you may change it. There are 4 keys
  147.       available, of which you must choose 2. The 4 keys are:
  148.  
  149.       C - Control                            L - Left-side Shift Key
  150.       A - ALT                                R - Right-side Shift Key
  151.  
  152.       If you want to use any combination 2 of these 4, just specify so on
  153.       the command line when you first run CAP.  For example,  if you want
  154.       the 2 shift keys together to being up CAP, type:
  155.  
  156.       CAP /k:LR
  157.  
  158.       Or if  you want  Control ALT  (the same as Sidekick - be careful!),
  159.       type:
  160.  
  161.       CAP /k:AC
  162.  
  163.       That's all there is to it!  Remember you  must use  2 keys.  If you
  164.       specify just 1 key, no keys, or invalid keys, CAP will use its default
  165.       keys, AR.
  166.  
  167.                                USING INTERRUPTS
  168.  
  169.       One other thing you can do is to  enable a  user interrupt  for CAP
  170.       initialization. This is very useful if the software you are using is
  171.       being particularly stubborn about allowing you to capture screens. To
  172.       assign a user interrupt to CAP, use the /i: parameter as follows:
  173.        
  174.       CAP /i:x
  175.        
  176.       where x  is the number of the interrupt you want enabled. For exam-
  177.       ple, if you want to invoke CAP with the SHIFT-PrtSc  key, interrupt
  178.       5, you would type:
  179.        
  180.       CAP /i:5
  181.  
  182.  
  183.  
  184.  
  185.  
  186.                  CAP - Resident Capture Utility for GRASP(tm)
  187.                                    Page:  2
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                    USING CAP
  195.  
  196.  
  197.                                 Saving Pictures
  198.  
  199.       The simplest way to save a picture is to use the following procedure:
  200.  
  201.       Assuming you  have already  run CAP and are now in your application
  202.       program...
  203.  
  204.       1) Set the screen set up the way you want with your application pro-
  205.       gram.
  206.  
  207.       2) Bring  up CAP  by pressing  ALT rightSHIFT. You will see the CAP
  208.       crosshairs in the middle of the screen.
  209.  
  210.       3) Press ENTER. You will see the top lines of  the screen disappear
  211.       and be replaced with the prompt:
  212.  
  213.       PIC name:
  214.  
  215.       Enter up  to 8 characters for your picture name and press enter. If
  216.       you want to use an extension other than  .PIC, you  must specify it
  217.       here. The drive will spin and your picture will be saved.
  218.  
  219.       4) You  should now see your screen with the crosshairs again. Press
  220.       ESC to go back to running your application.
  221.  
  222.  
  223.       You picture is now save and  you can  go on  using your application
  224.       program. If you need to capture another screen, just repeat this pro-
  225.       cedure.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                  CAP - Resident Capture Utility for GRASP(tm)
  248.                                    Page:  3
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                                Saving Clippings
  256.  
  257.       Saving a clipping is much like saving a picture, except that you must
  258.       first tell CAP which portion of the screen you want to be your clipp-
  259.       ing. This is done using the arrow keys  to move  the crosshairs and
  260.       the SPACEBAR to tell CAP to start a new clipping. Here is the proc-
  261.       edure:
  262.  
  263.  
  264.       Assuming you have already run CAP and are  now in  your application
  265.       program...
  266.  
  267.       1) Set the screen set up the way you want with your application pro-
  268.       gram.
  269.  
  270.       2) Bring up CAP by pressing  ALT rightSHIFT.  You will  see the CAP
  271.       crosshairs in the middle of the screen.
  272.  
  273.       3) Move the crosshairs using the arrow keys. You will see a rectangle
  274.       being created. This is the boundary of your clipping. When the cross-
  275.       hairs gets to one of the corners of what you want to be your clipp-
  276.       ing, press SPACEBAR. This tells CAP to start  a clipping definition
  277.       from here.
  278.  
  279.       4) Move the crosshairs to the opposite corner of the region you want
  280.       to be your clipping.
  281.  
  282.       5) Press ENTER. You will see the top lines of  the screen disappear
  283.       and be replaced with the prompt:
  284.  
  285.       CLP name:
  286.  
  287.       Enter up to 8 characters for your clipping name and press enter. If
  288.       you want to use an extension other than  .CLP, you  must specify it
  289.       here. The drive will spin and your clipping will be saved.
  290.  
  291.       IMPORTANT  NOTE:  The  way  that  CAP  decides  whether you want to
  292.       save a picture or a clipping is that if there is a rectangular area
  293.       defined, CAP  will save  a clipping. If not, it will save the whole
  294.       screen. If you start to define a clipping with the arrow keys, then
  295.       change your  mind and  want a picture, just press SPACEBAR to clear
  296.       current clipping definition and the press  ENTER to  save the whole
  297.       screen as a picture. 
  298.  
  299.       Also note  that when  CAP saves  a clipping,  it saves the rows and
  300.       columns of points UNDER the rectangle as part of the clipping. This
  301.       is consistent  with the  way the  'edit-box' or  'marquee' works in
  302.       PCPAINT PLUS(tm).
  303.  
  304.  
  305.  
  306.  
  307.  
  308.                  CAP - Resident Capture Utility for GRASP(tm)
  309.                                    Page:  4
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.                                Special Features
  317.  
  318.  
  319.  
  320.       CTRL-B  ...  BSAVE mode - After  you bring  up CAP  and are looking
  321.       at the  crosshairs, pressing  CTRL-B will  toggle BSAVE on and off.
  322.       You cannot BSAVE multiple bit-plane screens like EGA 16 color mode.
  323.       BSAVE  is  really  only  useful  for  mode  A,  or CGA 4 color mode
  324.       screens that you may want to  load into  a BASIC  program. Pressing
  325.       CTRL-B again will return to packed page format.
  326.  
  327.  
  328.  
  329.       CTRL-V   ...   Forced Video  Mode -  After you bring up CAP and are
  330.       looking at the crosshairs, pressing CTRL-V will enable forced video
  331.       mode. You  will be  prompted to  enter a video mode letter and then
  332.       CAP will try to save  the  current  screen  in  the  format  of the
  333.       requested  video  mode.  Video  modes  are  the same as for PCPAINT
  334.       PLUS(tm) and GRASP(tm). For  example, if  you are  in EGA  16 color
  335.       hi-resolution mode, but the program you are running didn't set it up
  336.       properly according to BIOS, just  force video  mode G  and CAP will
  337.       save out a 16 color hi-resolution screen.
  338.  
  339.       Please  note  that  modes  0,  1  and  2 are text modes and are not
  340.       available in PCPAINT PLUS(tm). Also note that H1 and H2  only refer
  341.       to CAP.  PCPAINT PLUS(tm)  and GRASP  both use  Hercules page 1 and
  342.       the video mode is set with just the letter H.
  343.  
  344.       Valid Video Modes for Forced Video Over-ride
  345.  
  346.           0  - 40 column color text
  347.           1  - 80 column color text
  348.           2  - 80 column monochrome text
  349.           A  - 320x200 4 color CGA
  350.           B  - 320x200 16 color PCjr / STB / TANDY 1000
  351.           C  - 640x200 2 color CGA
  352.           D  - 640x200 16 color CGA
  353.           E  - 640x350 2 color EGA
  354.           F  - 640x350 4 color EGA
  355.           G  - 640x350 16 color EGA
  356.           H  - 720x348 2 color Hercules/AST Preview - page 1
  357.           H1 - (same as H)
  358.           H2 - 720x348 2 color Hercules/AST Preview - page 2
  359.           I  - 320x200 16 color Plantronics/AST CGPLUS
  360.           J  - 320x200 16 color EGA
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.                  CAP - Resident Capture Utility for GRASP(tm)
  370.                                    Page:  5
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.       ;  ...   Seek a clipping - During the clipping definition process, if the
  378.       rectangle you  are stretching  completely surrounds  the object you
  379.       want to grab, and lies entirely in a region of a single color, pressing
  380.       the ; key will cause all 4 edges of the rectangle to seek inward until
  381.       an edge is found. This is useful for isolating objects when you don't
  382.       want a lot of extra 'white space' surrounding your object. Try a few
  383.       tests to get the feel of it.
  384.  
  385.       .  ...  Change active corner - During the clipping definition process,
  386.       you are dragging one of the corners of the rectangle. This corner is
  387.       called the 'active corner'. To change the active corner, press the .
  388.       key. You will notice that the corsshairs moves around in a clockwise
  389.       direction to the adjacent corner. This is useful for altering regions
  390.       without having to start a new one.
  391.  
  392.       1-0 ... Change crosshairs step - by pressing one of the number keys
  393.       at the  top of  the keyboard  while the  crosshairs is  up, you can
  394.       change  the  number  of  points  the crosshairs moves each time you
  395.       press an arrow key. Pressing 1 means move the crosshairs  one point
  396.       for each arrow key press. 0 means move the crosshairs 10 points for
  397.       each arrow key press. This is useful for moving more quickly or finer
  398.       adjustments.
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.                  CAP - Resident Capture Utility for GRASP(tm)
  431.                                    Page:  6
  432.  
  433.