home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / PACKSCR.ZIP / PSCREEN.DOC next >
Encoding:
Text File  |  1988-08-21  |  2.4 KB  |  56 lines
  1. PSCREEN - Utility for saving and displaying packed screens
  2. ----------------------------------------------------------
  3. Brian Foley
  4. TurboPower Software
  5. 8/88
  6. Version 5.00
  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 the current
  26. contents of the screen to disk, press the PSCREEN hotkey, Ctrl-LeftShift-P,
  27. and enter the name of the file to save it in. You can unload PSCREEN by
  28. pressing <AltU> when prompted for a filename.
  29.  
  30. To display a packed screen using PSCREEN, enter
  31.  
  32.   PSCREEN filename.ext
  33.  
  34. at the DOS prompt. PSCREEN will simply display the contents of the file and
  35. terminate. It will not attempt to go resident.
  36.  
  37. Possible Enhancements
  38. ------------------------------------------------------------------------------
  39. PSCREEN in its current form has much room for improvement. The following
  40. describes some missing capabilities that you might want to implement yourself:
  41.  
  42. (1) PSCREEN cannot display packed windows stored in LBR files, nor can it save
  43. screens to an LBR file. Adding this capability would be relatively easy,
  44. however, since TPCRT contains all the primitive routines that are needed:
  45. OpenLibrary, ReadWindowFromLibrary, CreateLibrary, AddWindowToLibrary, and
  46. CloseLibrary.
  47.  
  48. (2) PSCREEN does not perform color mapping when it displays a packed window
  49. from a file. You might want to add a command line option like '/M' to request
  50. that colors be mapped if necessary, using MapPackedWindowColors, before the
  51. screen is displayed.
  52.  
  53. (3) When saving screens in resident mode, PSCREEN assumes that the entire
  54. screen should be saved. You might want to add a facility for marking a smaller
  55. section of the screen as the window to be saved.
  56.