home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / turbopas / bonus507.arc / PSCREEN.ARC / PSCREEN.DOC next >
Text File  |  1988-12-13  |  3KB  |  63 lines
  1. PSCREEN - Utility for saving and displaying packed windows
  2. ----------------------------------------------------------
  3. Brian Foley
  4. TurboPower Software
  5. 11/88
  6. Version 5.02
  7. Released to the public domain
  8.  
  9. Overview
  10. ------------------------------------------------------------------------------
  11. PSCREEN is a utility program designed to be used in conjunction with the TPCRT
  12. unit in Turbo Professional 5.0. It operates in either of two modes. In
  13. resident mode, PSCREEN allows you to capture text screens, video attributes
  14. and all, in a packed format and save them to disk. In non-resident mode,
  15. PSCREEN allows you to display a packed window that has previously been saved
  16. to a file. This facility can be used to create colorful batch files, for
  17. example.
  18.  
  19. Using PSCREEN
  20. ------------------------------------------------------------------------------
  21. To run PSCREEN in resident mode, simply enter
  22.  
  23.   PSCREEN
  24.  
  25. at the DOS prompt, with no parameters. When you want to save a packed window
  26. to disk, press the PSCREEN hotkey, Ctrl-LeftShift-P. The cursor will then
  27. change to a blinking block.
  28.  
  29. To select the region of the screen (that is, the 'window') that you want to
  30. save, move the cursor to the top left corner of the region and press <Enter>,
  31. then move the cursor to the bottom right corner and press <Enter> again. As
  32. you move the cursor around, the currently selected portion of the screen will
  33. be repainted to indicate the bounds of the window. If you want to cancel the
  34. operation, press <Esc>. If you want to unload PSCREEN from memory, press
  35. <AltU> instead.
  36.  
  37. Once you've selected a window, you'll be asked to enter the name of the file
  38. to save it in. Again, you can unload PSCREEN by pressing <AltU> when prompted
  39. for a filename, or cancel the operation by pressing <Esc>.
  40.  
  41. To display a packed screen using PSCREEN, enter
  42.  
  43.   PSCREEN filename.ext
  44.  
  45. at the DOS prompt. PSCREEN will simply display the contents of the file and
  46. terminate. It will not attempt to go resident.
  47.  
  48. Possible Enhancements
  49. ------------------------------------------------------------------------------
  50. PSCREEN in its current form has much room for improvement. The following
  51. describes some missing capabilities that you might want to implement yourself:
  52.  
  53. (1) PSCREEN cannot display packed windows stored in LBR files, nor can it save
  54. screens to an LBR file. Adding this capability would be relatively easy,
  55. however, since TPCRT contains all the primitive routines that are needed:
  56. OpenLibrary, ReadWindowFromLibrary, CreateLibrary, AddWindowToLibrary, and
  57. CloseLibrary.
  58.  
  59. (2) PSCREEN does not perform color mapping when it displays a packed window
  60. from a file. You might want to add a command line option like '/M' to request
  61. that colors be mapped if necessary, using MapPackedWindowColors, before the
  62. screen is displayed.
  63.