home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / graphic / pmcamera / pmcam2.doc < prev    next >
Encoding:
Text File  |  1992-12-17  |  7.3 KB  |  144 lines
  1.  
  2.                      Availability Notice for PM Camera /2
  3.                         (C) Copyright IBM Corp., 1992
  4.                      ====================================
  5.  
  6. Author: J. von Kaenel
  7.  
  8. Requirements:
  9. -------------
  10. - This version of PM CAMERA /2 requires at least IBM OS/2 version 2.0.
  11.  
  12. Abstract:
  13. ---------
  14. PM Camera /2 has the ability to take screen shots of OS/2 Presentation Manager
  15. screens, screen parts  or active  windows.  The pictures taken may be saved in
  16. OS/2 BMP (1.1), PSEG38PP, PostScript and  Encapsulated PostScript file format.
  17. Additionally it may also be put into the Clipboard for use by other
  18. applications.
  19.  
  20. BMP files are saved in  OS/2 1.1 file format  with 8, 4 or 1 bit(s)  per pixel
  21. depending on the display capabilities.
  22.  
  23. PSE files are binary equivalent to PSEG38PP or PSEG3820 files on host systems.
  24. They are especially useful for inclusion into BookMaster Documents. To include
  25. them into host documents, upload the .pse file binary to  the host and convert
  26. them into a real PSEG38PP or PSEG3820 by using the PBIN2PSE EXEC (PSEG38PP and
  27. PSEG3820 files are  identical, they can be  converted into  each other by just
  28. renaming them).
  29. To generate  a PSE file,  a halftoning process  is applied.  It is possible to
  30. select  among  4 types (Diagonal, Diamond, Circle and Square) and  three sizes
  31. (4x4, 6x6 and 8x8)  of  dither  matrices.  The  output  may  be  scaled  by an
  32. arbitrary  factor between  0.1 and 10.0  during the  halftone operation.  This
  33. process may take quite some time.
  34.  
  35. PostScript files are  generated as color images, black and white images, or by
  36. using a special technique, where each pixel is mapped to a colored square. The
  37. special technique  is useful when  it is not clear  whether a color printer is
  38. available or not (Note: this may however require  several hours to print large
  39. images!).  The  PostScript file can  be generated in  two flavors: PS which is
  40. printable, and  EPS which is for  inclusion into  other PostScript files (e.g.
  41. via Page Maker).  They may be  scaled by an arbitrary  factor between 0.01 and
  42. 10.00  or  fit to  the  page  (the  program  determines  the  scaling factor).
  43. Optionally the picture can be rotated (Landscape) by 90 degrees if needed.
  44.  
  45. How to install:
  46. ---------------
  47. After 'unzipping' PMCAM2.ZIP you should have the following files:
  48. (The CONFIG.SYS column indicates which symbols must be changed to
  49. include access to the location where you have installed PM Camera).
  50.  
  51. ┌─────────────────────────┬─────────────────────────────┬─────────────┐
  52. │ File                    │ Description                 │ CONFIG.SYS  │
  53. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  54. │PMCAM2.ABS               │ Short Abstract              │ -           │
  55. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  56. │PMCAM2.DOC               │ This documentation          │ -           │
  57. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  58. │ASIS.TXT                 │ The Licence Agreement       │ -           │
  59. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  60. │PMCAMERA.EXE             │ PMCAMERA Program            │ PATH        │
  61. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  62. │PMCAMERA.DLL             │ Hotkey Code                 │ LIBPATH     │
  63. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  64. │PMCAMERA.HLP             │ Online Help                 │ HELP        │
  65. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  66. │POSTPROC.CMD             │ Example Post Processor      │ PATH        │
  67. ├─────────────────────────┼─────────────────────────────┼─────────────┤
  68. │PBIN2PSE EXEC            │ VM/370 EXEC for PSEG38PP    │ -           │
  69. └─────────────────────────┴─────────────────────────────┴─────────────┘
  70.  
  71. Put the PMCAMERA.HLP, PMCAMERA.DLL and PMCAMERA.EXE files
  72. to any directory you like and make sure that the PMCAMERA.DLL file lies
  73. somewhere on your LIBPATH.
  74.  
  75. The PBIN2PSE EXEC is a VM host exec used to convert the stream oriented binary
  76. .PSE files generated by PM Camera /2 into record oriented host page segments.
  77. If you do not have a mainfraime with BookMaster, this exec is not needed.
  78.  
  79. You can add an entry for PM Camera in a Desktop Manager Group.  Be sure to
  80. specify the complete path where you've placed PMCAMERA.EXE.
  81.  
  82. Command Line Syntax:
  83. --------------------
  84.  
  85. PMCAMERA [/option] [/option] ...
  86.  
  87. The options are:
  88.  /PATH=...                     to choose the path for the file to be saved
  89.  /FILE=...                     to choose the filename of the file to be saved
  90.                                (a file name of the form XXXXXXnn will take
  91.                                 XXXXXX as the name and nn as the initial
  92.                                 file number)
  93.  /NONBR                        suppresses incremental file numbering
  94.  /FULL or /PART or /ACTive     grab the full screen, a part of it or
  95.                                the active window
  96.  
  97.  /CLIPboard or /NOCLIPboard    enable/disable save of picture to clipboard
  98.  
  99.  /BMP or /NOBMP                enable/disable save of picture as OS/2 bitmap
  100.  
  101.  /PSEG38pp or /NOPSEG38pp      enable/disable save of picture as PSEG
  102.  /PSEGSCale=...                choose scaling factor between 0.1 and 10.0
  103.  /PSEGINVert                   invert black and white on a page segment
  104.  
  105.  /PS or /NOPS                  enable/disable save of picture as PostScript
  106.  /PSSCale=...                  choose scaling factor between 0.1 and 10.0
  107.  /PSFIT or /PSNOFIT            enable/disable fit to page
  108.  /PSFITA4 or /PSFITLETTER      fit to A4 or Letter sized paper
  109.  /PSPS or /PSEPs               save as printable (PS) file or as one for
  110.                                inclusion into other PostScript files (EPS)
  111.  /PSLAndscape or /PSPOrtrait   enable/disable rotation of picture by 90 degrees
  112.  /PSCOlor, /PSBW or /PSBOth    save in Color PostScript, PostScript (black and
  113.                                white) or a special form which uses squares to
  114.                                represent pixels and prints on either color or
  115.                                black and white printers (however very slow)
  116.  
  117.  /SOUnd or /NOSOUnd            enable/disable beep when picture is taken
  118.  /MOUse or /NOMOUse            enable/disable capturing of mouse pointer
  119.  
  120.  /DSIze=...                    select size of dither matrix: 4, 6 or 8
  121.  /DMAtrix=...                  select type of dither matrix:
  122.                                DIAGonal, DIAMond, CIrcle or SQuare
  123.  
  124.  /PRIority=...                 select the priority of saving the image
  125.                                LOW or NORmal
  126.  
  127.  /MIN                          minimize PM Camera /2 after start
  128.  
  129.  /CMDfile=...                  specify the name of a .cmd file which will be
  130.                                invoked after the files are saved. See the
  131.                                POSTPROC.CMD file which comes as an example
  132.                                with this package.
  133.  
  134.  /LOGo or /NOLogo              do or do not display a logo panel (default is
  135.                                taken from system settings)
  136.  
  137. the default settings are:
  138. /PATH='current directory' /FILE=PMGRAB00 /BMP /FULL
  139.  
  140. Known Limitations:
  141. ------------------
  142. - The 'fit to page' option for PostScript output assumes an A4 or Letter
  143.   sized page
  144.