home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Graphics / Graphics.zip / PMCAMERA.ZIP / PMCAMERA.HLP (.txt) < prev    next >
OS/2 Help File  |  1992-06-07  |  14KB  |  420 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PM Camera ΓòÉΓòÉΓòÉ
  3.  
  4. The PM Camera is a tool by which you can take pictures of OS/2 PM windows, 
  5. screens or screen parts. The pictures may be 
  6.  
  7.  o put into the Clipboard for use by other applications 
  8.  o saved as OS/2 Bitmap files 
  9.  o saved as PSEG38PP or PSEG3820 files for inclusion into BookMaster files 
  10.  o saved as PostScript files for color or b/w printing on (color) PostScript 
  11.    devices. 
  12.  
  13.  The most important facts about using PM Camera are described in a how to use 
  14.  section. 
  15.  
  16.  The menus of PM Camera are ordered by the following main topics: 
  17.  
  18.  o Grab 
  19.  o Options 
  20.  o Help 
  21.  
  22.  
  23. ΓòÉΓòÉΓòÉ 1.1. How To Use PMCAMERA ΓòÉΓòÉΓòÉ
  24.  
  25. Selecting Output Formats 
  26.  
  27. There are four output formats supported ( OS/2 Clipboard , OS/2 BMP Bitmap , 
  28. PSEG38PP/PSEG3820  and PostScript ). For each one checked, the system will 
  29. generate the appropriate output into the clipboard or into a file. Files have 
  30. the extensions '.BMP', '.PSE', '.PS' or '.EPS'. 
  31.  
  32. Automatic Numbering of Files 
  33.  
  34. PM Camera was designed to be used like a camera, allowing to capture a sequence 
  35. of images. In this case the system automatically takes the first six letters of 
  36. the filename and appends a 2 digit number. The number is automatically 
  37. increased after a picture is taken. 
  38.  
  39. This mode can be turned off, allowing you to enter an 8 letter filename. 
  40.  
  41. Note:  PM Camera writes over existing files without warning. 
  42.  
  43. Grabbing Fullscreen and Active Windows 
  44.  
  45. Select the Grab item in the grab menu (fullscreen only), or press the 
  46. PrintScreen key. 
  47.  
  48. Grabbing Partial Screens 
  49.  
  50. Upon pressing the PrintScreen key a large cross-hair cursor and a rubberband 
  51. box at the location of the last partial grab (default full screen) is 
  52. displayed. To select a new box, move the cursor to a corner of the desired 
  53. screen part, press button 1 and drag it open to the size desired and release 
  54. button 1. 
  55.  
  56. Pressing button 2 inside the box allows the box to be dragged around. 
  57.  
  58. The cross-hair cursor will also display the size of the current box. 
  59.  
  60. Pressing <ENTER> grabs the selected part, pressing <ESC> cancels the grab. 
  61.  
  62. Using PSEGS in Publications 
  63.  
  64. Once you have grabbed a binary '*.PSE' file, you must upload this file binary 
  65. to the host (using e.g. almcopy, this is favored over using the native 
  66. communication manager file transfer ). On the host the binary PSE file must be 
  67. converted into a real PSEG38PP file. The PBIN2PSE EXEC from the PBRUSHUT 
  68. PACKAGE on PCTOOLS does this for you. The resulting PSEG38PP file can now be 
  69. imbedded into a script file with the '.si' command, or into a BookMaster file 
  70. with the ':artwotk' tag. 
  71.  
  72. Note:  PSEG38PP and PSEG3820 files are identical, they can be converted into 
  73. each other by renaming. 
  74.  
  75. Scaling PSEGS 
  76.  
  77. To generate nice black and white pictures from colorful PM screens, a 
  78. halfetoning process has to be applied to the images. PM Camera allows the 
  79. images to be scaled during this halftone operation. The scaling factor is 
  80. applied to the pixels. That means for the usual 92 pixels per inch (ppi) on a 
  81. screen a scale factor of 2.6 would have to be applied to obtain a page segment 
  82. the same size as the image on the screen on a 240 ppi printer (like 3820, 3812 
  83. ...). A default of 2.0 was chosen, as in my experience this has lead to the 
  84. most useful illustration size for publications. 
  85.  
  86. Scaling PostScript 
  87.  
  88. The default scale for PostScript is 0.7 as this gives approximate the same size 
  89. pictures as onscreen (92 ppi on screen -> 72ppi postscript mapping). Optionally 
  90. you may specify fit to page, which scales the picture to fill the page 
  91. (currently only A4 supported) as well as possible by retaining the aspect 
  92. ratio. 
  93.  
  94.  
  95. ΓòÉΓòÉΓòÉ 1.2. Save File Path ΓòÉΓòÉΓòÉ
  96.  
  97. The directory where the file should be saved. Default is the current directory 
  98. where PM Camera is started. 
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 1.3. Save File Name ΓòÉΓòÉΓòÉ
  102.  
  103. The filename which is used to saved the grabbed images. When automatic file 
  104. numbering is used, the file name consists of up to 6 letters and 2 digits. The 
  105. digits are incremented automatically in this case. If file numbering is 
  106. inactive, the file name may consist of up to 8 characters. 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 1.4. Save File Number ΓòÉΓòÉΓòÉ
  110.  
  111. This controls whether or not files are numbered automatically and allows the 
  112. setting of the current file nbr. Automatic numbering is similar to a camera, 
  113. where each picture you take increments the film counter. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 1.5. Grab Type ΓòÉΓòÉΓòÉ
  117.  
  118. PM Camera allows three types of screen shots: 
  119.  
  120.  Full Screen 
  121.    An image the size of the display screen is generated. 
  122.  
  123.  Partial Screen 
  124.    This is the most soffisticated option. It allows the selection of a a screen 
  125.    part. A large cross-hair cursor and a rubberband box at the location of the 
  126.    last partial grab (default full screen) is displayed. To select a new box, 
  127.    move the cursor to a corner of the desired screen part, press button 1 and 
  128.    drag it open to the size desired and release button 1. 
  129.  
  130.    Pressing button 2 inside the box allows the box to be dragged arround. 
  131.  
  132.    The cross-hair cursor will also display the size of the current box. 
  133.  
  134.    Pressing <ENTER> grabs the selected part, pressing <ESC> cancels the grab. 
  135.  
  136.  Active Window 
  137.    Grabs the currently active window. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 1.6. Sound ΓòÉΓòÉΓòÉ
  141.  
  142. The system generates per default audio feedback about the grabbing process. A 
  143. short beep is emited a the begining of the save thread and indicates that the 
  144. screen was grabed succesfully and that svaing to a file has started. Two short 
  145. and one longer beep indicate the succesful save of the image. Theis audio 
  146. feedback may be turned off. 
  147.  
  148.  
  149. ΓòÉΓòÉΓòÉ 1.7. Grab Mouse Pointer ΓòÉΓòÉΓòÉ
  150.  
  151. Per default the mouse pointer is grabbed along with the image. It may be turned 
  152. off, such that the mouse pointer is hidden before the grab is taken. 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 1.8. OS/2 Clipboard ΓòÉΓòÉΓòÉ
  156.  
  157. A grab can be saved to the OS/2 Clipboard in a 1.1 OS/2 BMP format with 1, 4 or 
  158. 8 bit(s) per pixel depending on the display capabilities. 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 1.9. OS/2 Bitmap (1.1) ΓòÉΓòÉΓòÉ
  162.  
  163. These files have the extension *.bmp. 
  164.  
  165. OS/2 Bitmap files are saved in a 1.1 format with 1, 4 or 8 bit(s) per pixel 
  166. depending on the display capabilities. 
  167.  
  168.  
  169. ΓòÉΓòÉΓòÉ 1.10. PSEG38PP, PSEG3820 ΓòÉΓòÉΓòÉ
  170.  
  171. These files have the extension *.pse. 
  172.  
  173. PSE files are binary equivalent to PSEG38PP or PSEG3820 files on the host. They 
  174. are especially useful for inclusion into BookMaster Documents. To include them 
  175. into host documents, upload the .pse files binary to the host and convert them 
  176. into a real PSEG38PP or PSEG3820 by using the PBIN2PSE EXEC (PSEG38PP and 
  177. PSEG3820 files are identical, they can be converted into each other by 
  178. renaming). 
  179.  
  180. To generate a PSE file, a halftoning process has to be applied. It is possible 
  181. to select among 
  182.  
  183.  o three sizes (4x4, 6x6 and 8x8) 
  184.  
  185.    and 
  186.  o 4 types (Diagonal, Diamond, Circle and Square) of dither matrices. 
  187.  
  188.  The output may be scaled by an aribtrary factor between 0.1 and 10.0 during 
  189.  the halftone operation. Default is a factor of 2.0. 
  190.  
  191.  Note:  This process may take quite some time. 
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ 1.11. PostScript ΓòÉΓòÉΓòÉ
  195.  
  196. These files have the extension *.ps, or *.eps. 
  197.  
  198. PostScript files are either generated as color-images, black and white images 
  199. or by using a special technique which prints on either color or black and white 
  200. PostScript printers. The special technique maps each pixel to a colored square. 
  201. This method is used to generate pictures when it is not known whether a color 
  202. printer is available or not, however printing such pictures is extremly slow 
  203. and can take up to several hours!!! for larger pictures. 
  204.  
  205. PostScripts file can be generated in two flavors: 
  206.  
  207.  o PS which is printable and 
  208.  o EPS which is for inclusion into other PostScript files (e.g. via Page 
  209.    Maker). 
  210.  
  211.  The pictures may be scaled by an arbitrary factor between 0.01 and 10.00 or 
  212.  fit to the page (the program determines the scaling factor). Default is a 
  213.  factor of 0.7. 
  214.  
  215.  Optionally the pictures can be rotated (Landscape) by 90 degrees if needed. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 1.12. Command Line Syntax ΓòÉΓòÉΓòÉ
  219.  
  220. PMCAMERA [/option] [/option] ...
  221.  
  222. The options are:
  223.  /PATH=...                     to choose the path for the file to be saved
  224.  /FILE=...                     to choose the filename of the file to be saved
  225.                                (a file name of the form XXXXXXnn will take
  226.                                 XXXXXX as the name and nn as the initial
  227.                                 file number)
  228.  /NONBR                        supresses incremntal file numbering
  229.  /FULL or /PART or /ACTive     grab the full screen, a part of it or
  230.                                the active window
  231.  
  232.  /CLIPboard or /NOCLIPboard    enable/disable save of picture to clipboard
  233.  
  234.  /BMP or /NOBMP                enable/disable save of picture as OS/2 bitmap
  235.  
  236.  /PSEG38pp or /NOPSEG38pp      enable/disable save of picture as PSEG
  237.  /PSEGSCale=...                choose scaling factor between 0.1 and 10.0
  238.  
  239.  /PS or /NOPS                  enable/disable save of picture as PostScript
  240.  /PSSCale=...                  choose scaling factor between 0.1 and 10.0
  241.  /PSFIT or /PSNOFIT            enable/disable fit to page
  242.  /PSPS or /PSEPs               save as printable (PS) file or as one for
  243.                                inclusion into other PostScript files (EPS)
  244.  /PSLAndscape or /PSPOrtrait   enable/disable rotation of picture by 90 degrees
  245.  /PSCOlor, /PSBW or /PSBOth    save in Color PostScript, PostScript (black and
  246.                                white) or a special form which uses squares to
  247.                                represent pixels and prints on either color or
  248.                                black and white printers (however very slow)
  249.  
  250.  /SOUnd or /NOSOUnd            enable/disable beep when picture is taken
  251.  /MOUse or /NOMOUse            enable/disable capturing of mouse pointer
  252.  
  253.  /DSIze=...                    select size of dither matrix: 4, 6 or 8
  254.  /DMAtrix=...                  select type of dither matrix:
  255.                                DIAGonal, DIAMond, CIrcle or SQuare
  256.  /PRIority=...                 select the priority of saving the image
  257.                                IDLe or NORmal
  258.  /MIN                          minimize PMCamera after start
  259.  
  260. the default settings are:
  261. /PATH='current directory' /FILE=PMGRAB00 /BMP /FULL
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ 1.13. The Grab Menu ΓòÉΓòÉΓòÉ
  265.  
  266. The grab menu can be used to stop an ongoing grab, or to exit this program. 
  267.  
  268.  o Grab 
  269.  o Stop Saving 
  270.  o eXit this program 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 1.13.1. Grab ΓòÉΓòÉΓòÉ
  274.  
  275. Alternate form to the <PrintScreen> key to start the grabbing action. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 1.13.2. Stop Saving ΓòÉΓòÉΓòÉ
  279.  
  280. Stops the saving of the current grab. The files are deleted. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 1.13.3. eXit ΓòÉΓòÉΓòÉ
  284.  
  285. Quits this program. 
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 1.14. The Options Menu ΓòÉΓòÉΓòÉ
  289.  
  290. The options menu allows the selection and setting of several general 
  291. attributes, reset to defaults and the saving and loading of the options. 
  292.  
  293.  o Defaults 
  294.  o Dither Matrices 
  295.  o Save Priorites 
  296.  o Save Options 
  297.  o Load Options 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 1.14.1. Defaults ΓòÉΓòÉΓòÉ
  301.  
  302. Sets all the options of PM Camera back to the following defaults: 
  303.  
  304.  PATH      current directory 
  305.  NAME      PMGRAB00 
  306.  NBR       on, starting with 00 
  307.  GRAB      full screen 
  308.  CLIP      off 
  309.  BMP       on 
  310.  PSEG      off, scale 2.00 
  311.  PS        off, scale 0.70, PostScript, Landscape, Color 
  312.  BEEP      on 
  313.  MOUSE     on 
  314.  
  315.  
  316. ΓòÉΓòÉΓòÉ 1.14.2. Dither Matrices ΓòÉΓòÉΓòÉ
  317.  
  318. To generate a PSE file, a halftoning process has to be applied. It is possible 
  319. to select among 
  320.  
  321.  o three sizes (4x4, 6x6 and 8x8) 
  322.  
  323.    and 
  324.  o 4 types (Diagonal, Diamond, Circle and Square) of dither matrices. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 1.14.3. Save Thread Priorities ΓòÉΓòÉΓòÉ
  328.  
  329. The grabing off a screen or part takes only a short amount of time and is done 
  330. immediately. Saving this grabbed image to disk however may take quite some 
  331. time, especially for PSEG's and PostScript files. During this time no other 
  332. grabs can be invoked. To allow for other activities during this saving period, 
  333. the priority of the save thrad may be varied: 
  334.  
  335. Idle 
  336.  
  337. Saving takes only place only when there is unused processor type. The use of 
  338. other programs and user activites takes precedence and allows users to do their 
  339. work uninterrupted. This is the default setting. 
  340.  
  341. Note:  If there is enough activity on the system, the save thread may not be 
  342. working at all. 
  343.  
  344. Normal 
  345.  
  346. The save thread has a normal priorty and gets thus his normal share of 
  347. processor time. This is much faster than idle saves, may however limit the 
  348. responsiveness of the system to users requests. 
  349.  
  350.  
  351. ΓòÉΓòÉΓòÉ 1.14.4. Save / Load Options ΓòÉΓòÉΓòÉ
  352.  
  353. Save 
  354.  
  355. All the options and settings of PM Camera may be saved in a PMCAMERA.INI file 
  356. and read back to be taken as defaults whenever a PM Camera session is started. 
  357. The file will be saved in the current directory. 
  358.  
  359. Load 
  360.  
  361. The options are restored to the saved settings. 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 1.15. The Help Menu ΓòÉΓòÉΓòÉ
  365.  
  366. The help menu contains choices for fast access to special sections of this help 
  367. information. The following choices are available: 
  368.  
  369.  o Help for help 
  370.  o Extended Help 
  371.  o Keys Help 
  372.  o Help Contents 
  373.  o About 
  374.  
  375.  
  376. ΓòÉΓòÉΓòÉ 1.15.1. Help for help ΓòÉΓòÉΓòÉ
  377.  
  378. Explains how to use the help facility. 
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ 1.15.2. Extended help ΓòÉΓòÉΓòÉ
  382.  
  383. Explains the working of this program, its options and how to use PM Camera. 
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ 1.15.3. Help for Keys ΓòÉΓòÉΓòÉ
  387.  
  388.  <F1>      Accelerator for getting help about this program 
  389.  
  390.  <F3>      Accelerator to exit this program 
  391.  
  392.  <PrintScreen> Accelerator for starting the capture of a window, the screen, or 
  393.            part thereof 
  394.  
  395.  
  396. ΓòÉΓòÉΓòÉ 1.15.4. Contents of the Help Document ΓòÉΓòÉΓòÉ
  397.  
  398. Displays the contents of this help document. 
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 1.15.5. About PM Camera ΓòÉΓòÉΓòÉ
  402.  
  403. This choice shows a panel with information about the version of PM Camera and 
  404. its author. 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  408.  
  409. The communications manager file transfer is quite cumbersome, and its defaults 
  410. often lead to undesirable side effects. Especially the default of using fixed 
  411. record length to upload binary files adds undesired padding bytes to the last 
  412. record. This in turn leads to an error message of the PBIN2PSE EXEC, which 
  413. states that there is invalid data in the file (which is true: the padding bytes 
  414. are superfluous). The output PSEG38PP file however is usually correct (despite 
  415. the error message). 
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  419.  
  420. The PBIN2PSE EXEC can be obtained from the PBRUSHUT PACKAGE from PCTOOLS.