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