home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / netdor3.zip / DISK_12 / IMAGE11.ZIP / HELP / PMCAMERA.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-05-11  |  21KB  |  508 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PM Camera /2 ΓòÉΓòÉΓòÉ
  3.  
  4. The PM Camera /2 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 /2 are described in a how to use 
  14. section. 
  15.  
  16. The menus of PM Camera /2 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 PM Camera /2 ΓòÉΓòÉΓòÉ
  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 /2 was designed to be used like a camera, allowing to capture a 
  35. sequence of images. In this case the system automatically takes the first six 
  36. letters of the filename and appends a 2 digit number. The number is 
  37. automatically 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 /2 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 will do this for you. 
  68. The resulting PSEG38PP file can now be imbedded into a script file with the 
  69. '.si' command, or into a BookMaster file with the ':artwork' tag. 
  70.  
  71. Note:  PSEG38PP and PSEG3820 files are identical, they can be converted into 
  72. each other by renaming. 
  73.  
  74. Scaling PSEGS 
  75.  
  76. To generate nice black and white pictures from colorful PM screens, a 
  77. halftoning process has to be applied to the images. PM Camera /2 allows the 
  78. images to be scaled during this halftone operation. The scaling factor is 
  79. applied to the pixels. That means for the usual 92 pixels per inch (ppi) on a 
  80. screen a scale factor of 2.6 would have to be applied to obtain a page segment 
  81. the same size as the image on the screen on a 240 ppi printer (like 3820, 3812 
  82. ...). A default of 2.0 was chosen, as in my experience this has lead to the 
  83. most useful illustration size for publications. 
  84.  
  85. Scaling PostScript 
  86.  
  87. The default scale for PostScript is 0.7 as this gives approximate the same size 
  88. pictures as onscreen (92 ppi on screen -> 72ppi postscript mapping). Optionally 
  89. you may specify fit to page, which scales the picture to fill the page 
  90. (currently only A4 supported) as well as possible by retaining the aspect 
  91. ratio. 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 1.2. Save File Path ΓòÉΓòÉΓòÉ
  95.  
  96. The directory where the file should be saved. Default is the current directory 
  97. where PM Camera /2 is started. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 1.3. Save File Name ΓòÉΓòÉΓòÉ
  101.  
  102. The filename which is used to saved the grabbed images. When automatic file 
  103. numbering is used, the file name consists of up to 6 letters and 2 digits. The 
  104. digits are incremented automatically in this case. If file numbering is 
  105. inactive, the file name may consist of up to 8 characters. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 1.4. Save File Number ΓòÉΓòÉΓòÉ
  109.  
  110. This controls whether or not files are numbered automatically and allows the 
  111. setting of the current file nbr. Automatic numbering is similar to a camera, 
  112. where each picture you take increments the film counter. 
  113.  
  114.  
  115. ΓòÉΓòÉΓòÉ 1.5. Grab Type ΓòÉΓòÉΓòÉ
  116.  
  117. PM Camera /2 allows three types of screen shots: 
  118.  
  119. Full Screen 
  120.   An image the size of the display screen is generated. 
  121.  
  122. Partial Screen 
  123.   This is the most sophisticated option. It allows the selection of a a screen 
  124.   part. A large cross-hair cursor and a rubberband box at the location of the 
  125.   last partial grab (default full screen) is displayed. To select a new box, 
  126.   move the cursor to a corner of the desired screen part, press button 1 and 
  127.   drag it open to the size desired and release button 1. 
  128.  
  129.   Pressing button 2 inside the box allows the box to be dragged around. 
  130.  
  131.   The cross-hair cursor will also display the size of the current box. 
  132.  
  133.   Pressing <ENTER> grabs the selected part, pressing <ESC> cancels the grab. 
  134.  
  135. Active Window 
  136.   Grabs the currently active window. 
  137.  
  138.  
  139. ΓòÉΓòÉΓòÉ 1.6. Sound ΓòÉΓòÉΓòÉ
  140.  
  141. The system generates per default audio feedback about the grabbing process. A 
  142. short beep is emitted a the beginning of the save thread and indicates that the 
  143. screen was grabbed successfully and that saving to a file has started. Two 
  144. short and one longer beep indicate the successful save of the image. This audio 
  145. feedback may be turned off. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 1.7. Grab Mouse Pointer ΓòÉΓòÉΓòÉ
  149.  
  150. Per default the mouse pointer is grabbed along with the image. It may be turned 
  151. off, such that the mouse pointer is hidden before the grab is taken. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 1.8. OS/2 Clipboard ΓòÉΓòÉΓòÉ
  155.  
  156. A grab can be saved to the OS/2 Clipboard in a 1.1 OS/2 BMP format with 1, 4 or 
  157. 8 bit(s) per pixel depending on the display capabilities. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 1.9. OS/2 Bitmap (1.1) ΓòÉΓòÉΓòÉ
  161.  
  162. These files have the extension *.bmp. 
  163.  
  164. OS/2 Bitmap files are saved in a 1.1 format with 1, 4 or 8 bit(s) per pixel 
  165. depending on the display capabilities. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 1.10. PSEG38PP, PSEG3820 ΓòÉΓòÉΓòÉ
  169.  
  170. These files have the extension *.pse. 
  171.  
  172. PSE files are binary equivalent to PSEG38PP or PSEG3820 files on the host. They 
  173. are especially useful for inclusion into BookMaster Documents. To include them 
  174. into host documents, upload the .pse files binary to the host and convert them 
  175. into a real PSEG38PP or PSEG3820 by using the PBIN2PSE EXEC (PSEG38PP and 
  176. PSEG3820 files are identical, they can be converted into each other by 
  177. renaming). 
  178.  
  179. To generate a PSE file, a halftoning process has to be applied. It is possible 
  180. to select among 
  181.  
  182. o three sizes (4x4, 6x6 and 8x8) 
  183.  
  184.   and 
  185. o 4 types (Diagonal, Diamond, Circle and Square) of dither matrices. 
  186.  
  187. The invert option allows a black and white inversion. 
  188.  
  189. The output may be scaled by an arbitrary factor between 0.1 and 10.0 during the 
  190. halftone operation. Default is a factor of 2.0. 
  191.  
  192. Note:  This process may take quite some time. 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 1.11. PostScript ΓòÉΓòÉΓòÉ
  196.  
  197. These files have the extension *.ps, or *.eps. 
  198.  
  199. PostScript files are either generated as color-images, black and white images 
  200. or by using a special technique which prints on either color or black and white 
  201. PostScript printers. The special technique maps each pixel to a colored square. 
  202. This method is used to generate pictures when it is not known whether a color 
  203. printer is available or not, however printing such pictures is extremely slow 
  204. and can take up to several hours!!! for larger pictures. 
  205.  
  206. PostScript files can be generated in two flavors: 
  207.  
  208. o PS which is printable and 
  209. o EPS which is for inclusion into other PostScript files (e.g. via Page Maker). 
  210.  
  211. The pictures may be scaled by an arbitrary factor between 0.01 and 10.00 or fit 
  212. to the page (the program determines the scaling factor). Default is a factor of 
  213. 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                        suppresses incremental 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.  /PSEGINVert                   invert black and white on a page segment
  239.  
  240.  /PS or /NOPS                  enable/disable save of picture as PostScript
  241.  /PSSCale=...                  choose scaling factor between 0.1 and 10.0
  242.  /PSFIT or /PSNOFIT            enable/disable fit to page
  243.  /PSFITA4 or /PSFITLETTER      fit to A4 or Letter sized paper
  244.  /PSPS or /PSEPs               save as printable (PS) file or as one for
  245.                                inclusion into other PostScript files (EPS)
  246.  /PSLAndscape or /PSPOrtrait   enable/disable rotation of picture by 90 degrees
  247.  /PSCOlor, /PSBW or /PSBOth    save in Color PostScript, PostScript (black and
  248.                                white) or a special form which uses squares to
  249.                                represent pixels and prints on either color or
  250.                                black and white printers (however very slow)
  251.  
  252.  /SOUnd or /NOSOUnd            enable/disable beep when picture is taken
  253.  /MOUse or /NOMOUse            enable/disable capturing of mouse pointer
  254.  
  255.  /DSIze=...                    select size of dither matrix: 4, 6 or 8
  256.  /DMAtrix=...                  select type of dither matrix:
  257.                                DIAGonal, DIAMond, CIrcle or SQuare
  258.  
  259.  /PRIority=...                 select the priority of saving the image
  260.                                LOW or NORmal
  261.  
  262.  /MIN                          minimize PM Camera /2 after start
  263.  
  264.  /CMDfile=...                  specify the name of a .cmd file which will be
  265.                                invoked after the files are saved. See the
  266.                                POSTPROC.CMD file which comes as an example
  267.                                with this package.
  268.  
  269.  /LOGo or /NOLogo              do or do not display a logo panel (default is
  270.                                taken from system settings)
  271.  
  272. the default settings are:
  273. /PATH='current directory' /FILE=PMGRAB00 /BMP /FULL
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ 1.13. The Grab Menu ΓòÉΓòÉΓòÉ
  277.  
  278. The grab menu can be used to stop an ongoing grab, or to exit this program. 
  279.  
  280. o Grab 
  281. o Stop Saving 
  282. o eXit this program 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 1.13.1. Grab ΓòÉΓòÉΓòÉ
  286.  
  287. Alternate form to the <PrintScreen> key to start the grabbing action. 
  288.  
  289.  
  290. ΓòÉΓòÉΓòÉ 1.13.2. Stop Saving ΓòÉΓòÉΓòÉ
  291.  
  292. Stops the saving of the current grab. The files are deleted. 
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 1.13.3. eXit ΓòÉΓòÉΓòÉ
  296.  
  297. Quits this program. 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 1.14. The Options Menu ΓòÉΓòÉΓòÉ
  301.  
  302. The options menu allows the selection and setting of several general 
  303. attributes, reset to defaults and the saving and loading of the options. 
  304.  
  305. o Defaults 
  306. o Dither Matrices 
  307. o Save Priorities 
  308. o Paper Size 
  309. o Save Options 
  310. o Load Options 
  311.  
  312.  
  313. ΓòÉΓòÉΓòÉ 1.14.1. Defaults ΓòÉΓòÉΓòÉ
  314.  
  315. Sets all the options of PM Camera /2 back to the following defaults: 
  316.  
  317. PATH      current directory 
  318. NAME      PMGRAB00 
  319. NBR       on, starting with 00 
  320. GRAB      full screen 
  321. CLIP      off 
  322. BMP       on 
  323. PSEG      off, scale 2.00 
  324. PS        off, scale 0.70, PostScript, Landscape, Color 
  325. BEEP      on 
  326. MOUSE     on 
  327.  
  328.  
  329. ΓòÉΓòÉΓòÉ 1.14.2. Dither Matrices ΓòÉΓòÉΓòÉ
  330.  
  331. To generate a PSE file, a halftoning process has to be applied. It is possible 
  332. to select among 
  333.  
  334. o three sizes (4x4, 6x6 and 8x8) 
  335.  
  336.   and 
  337. o 4 types (Diagonal, Diamond, Circle and Square) of dither matrices. 
  338.  
  339.  
  340. ΓòÉΓòÉΓòÉ 1.14.3. Save Thread Priorities ΓòÉΓòÉΓòÉ
  341.  
  342. The grabbing off a screen or part takes only a short amount of time and is done 
  343. immediately. Saving this grabbed image to disk however may take quite some 
  344. time, especially for PSEG's and PostScript files. During this time no other 
  345. grabs can be invoked. To allow for other activities during this saving period, 
  346. the priority of the save thread may be varied: 
  347.  
  348. Low 
  349.  
  350. Saving takes only place only when there is unused processor type. The use of 
  351. other programs and user activities takes precedence and allows users to do 
  352. their work uninterrupted. This is the default setting. 
  353.  
  354. Note:  If there is enough activity on the system, the save thread may not be 
  355. working at all. 
  356.  
  357. Normal 
  358.  
  359. The save thread has a normal priority and gets thus his normal share of 
  360. processor time. This is much faster than low saves, may however limit the 
  361. responsiveness of the system to users requests. 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 1.14.4. Paper Size ΓòÉΓòÉΓòÉ
  365.  
  366. When grabbing PostScript images with fit to page selected, then this option 
  367. will determine the size of the paper to fit to. Either A4 or Letter size is 
  368. available. A border of about 0.6 inches (15mm) will be kept around the paper. 
  369.  
  370.  
  371. ΓòÉΓòÉΓòÉ 1.14.5. Save / Load Options ΓòÉΓòÉΓòÉ
  372.  
  373. Save 
  374.  
  375. All the options and settings of PM Camera /2 may be saved in a PMCAMERA.INI 
  376. file and read back to be taken as defaults whenever a PM Camera /2 session is 
  377. started. The file will be saved in the current directory. 
  378.  
  379. Load 
  380.  
  381. The options are restored to the saved settings. 
  382.  
  383.  
  384. ΓòÉΓòÉΓòÉ 1.15. The Help Menu ΓòÉΓòÉΓòÉ
  385.  
  386. The help menu contains choices for fast access to special sections of this help 
  387. information. The following choices are available: 
  388.  
  389. o Help for help 
  390. o Extended Help 
  391. o Keys Help 
  392. o Help Contents 
  393. o About 
  394.  
  395.  
  396. ΓòÉΓòÉΓòÉ 1.15.1. Help for help ΓòÉΓòÉΓòÉ
  397.  
  398. Explains how to use the help facility. 
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 1.15.2. Extended help ΓòÉΓòÉΓòÉ
  402.  
  403. Explains the working of this program, its options and how to use PM Camera /2. 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ 1.15.3. Help for Keys ΓòÉΓòÉΓòÉ
  407.  
  408. <F1>      Accelerator for getting help about this program 
  409.  
  410. <F3>      Accelerator to exit this program 
  411.  
  412. <PrintScreen> Accelerator for starting the capture of a window, the screen, or 
  413.           part thereof 
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ 1.15.4. Contents of the Help Document ΓòÉΓòÉΓòÉ
  417.  
  418. Displays the contents of this help document. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 1.15.5. Product Information ΓòÉΓòÉΓòÉ
  422.  
  423. This choice shows a panel with information about the version of PM Camera /2 
  424. and its author. 
  425.  
  426.  
  427. ΓòÉΓòÉΓòÉ 2. IBM License Agreement for OS/2 Tools ΓòÉΓòÉΓòÉ
  428.  
  429. IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. 
  430.  
  431. International Business Machines Corporation grants you a license to use the 
  432. Program only in the country where you acquired it. The Program is copyrighted 
  433. and licensed (not sold). We do not transfer title to the Program to you. You 
  434. obtain no rights other than those granted you under this license. 
  435.  
  436. Under this license, you may: 
  437.  
  438.  1. use the Program on one or more machines at a time; 
  439.  2. make copies of the Program for use or backup purposes within your 
  440.     Enterprise; 
  441.  3. modify the Program and merge it into another program; and 
  442.  4. make copies of the original file you downloaded and distribute it, provided 
  443.     that you transfer a copy of this license to the other party. The other 
  444.     party agrees to these terms by its first use of the Program. 
  445.  
  446. You must reproduce the copyright notice and any other legend of ownership on 
  447. each copy or partial copy, of the Program. 
  448.  
  449. You may NOT: 
  450.  
  451.  1. sublicense, rent, lease, or assign the Program; and 
  452.  2. reverse assemble, reverse compile, or otherwise translate the Program. 
  453.  
  454. We do not warrant that the Program is free from claims by a third party of 
  455. copyright, patent, trademark, trade secret, or any other intellectual property 
  456. infringement. 
  457.  
  458. Under no circumstances are we liable for any of the following: 
  459.  
  460.  1. third-party claims against you for losses or damages; 
  461.  2. loss of, or damage to, your records or data; or 
  462.  3. economic consequential damages (including lost profits or savings) or 
  463.     incidental damages, even if we are informed of their possibility. 
  464.  
  465. Some jurisdictions do not allow these limitations or exclusions, so they may 
  466. not apply to you. 
  467.  
  468. We do not warrant uninterrupted or error free operation of the Program. We have 
  469. no obligation to provide service, defect correction, or any maintenance for the 
  470. Program. We have no obligation to supply any Program updates or enhancements to 
  471. you even if such are or later become available. 
  472.  
  473. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES 
  474. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
  475.  
  476. Some jurisdictions do not allow the exclusion of implied warranties, so the 
  477. above exclusion may not apply to you. 
  478.  
  479. You may terminate this license at any time. We may terminate this license if 
  480. you fail to comply with any of its terms. In either event, you must destroy all 
  481. your copies of the Program. 
  482.  
  483. You are responsible for the payment of any taxes resulting from this license. 
  484.  
  485. You may not sell, transfer, assign, or subcontract any of your rights or 
  486. obligations under this license. Any attempt to do so is void. 
  487.  
  488. Neither of us may bring a legal action more than two years after the cause of 
  489. action arose. 
  490.  
  491. If you acquired the Program in the United States, this license is governed by 
  492. the laws of the State of New York. If you acquired the Program in Canada, this 
  493. license is governed by the laws of the Province of Ontario. Otherwise, this 
  494. license is governed by the laws of the country in which you acquired the 
  495. Program. 
  496.  
  497. 3/92 
  498.  
  499.  
  500. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  501.  
  502. The communications manager file transfer is quite cumbersome, and its defaults 
  503. often lead to undesirable side effects. Especially the default of using fixed 
  504. record length to upload binary files adds undesired padding bytes to the last 
  505. record. This in turn leads to an error message of the PBIN2PSE EXEC, which 
  506. states that there is invalid data in the file (which is true: the padding bytes 
  507. are superfluous). The output PSEG38PP file however is usually correct (despite 
  508. the error message).