home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1213 / read_me.txt < prev    next >
Encoding:
Text File  |  1993-12-29  |  10.2 KB  |  236 lines
  1.  
  2.  
  3.         ▄▄▄▄▄  ▄▄▄▄▄  ▄▄▄▄▄  ▄▄▄▄▄  ▄▄▄▄▄  ▄  ▄       ▄
  4.         █   ▀  █   █  █   █  █      █      █   ▀▄   ▄▀
  5.         █      █▄▄▄█  █▄▄▄█  █▄▄▄   █▄▄▄   █     ▀▄▀
  6.         █  ▀█  █▀▄    █   █  █      █      █    ▄▀ ▀▄
  7.         █▄▄▄█  █  ▀▄  █   █  █      █      █  ▄▀     ▀▄ (TM)
  8.         FOR WINDOWS AND DOS  ▀      ▀ SHAREWARE EDITION
  9.  
  10.       Copyright 1994 ANDROMEDA SOFTWARE.  All rights reserved.
  11.  
  12. This is the shareware release of GRAFFIX 2.3, a major revision
  13. that extends the screen-capture capabilities of GRAFFIX for DOS
  14. to Microsoft Windows.  This release includes two separate and
  15. distinct executable program files, DGFX.EXE for DOS applications,
  16. and WGFX.EXE for Windows applications.
  17.  
  18. The DOS program can be run alone for full-screen text and gra-
  19. phics screen captures from within DOS applications running in
  20. DOS or Windows, while the Windows program can be run alone for
  21. full-screen or single-window captures from within Windows appli-
  22. cations.  DGFX.EXE and WGFX.EXE can also run simultaneously on
  23. the same computer for the ultimate flexibility in screen capture
  24. from within both Windows and DOS applications running in Windows.
  25. For simplicity, the explanations that follow focus first on the
  26. Windows version of GRAFFIX, then on the DOS version.
  27.  
  28.  
  29. GRAFFIX for Windows
  30.  
  31. GRAFFIX writes the contents of the clipboard to a graphics file.
  32. In Windows, the entire screen can be captured to the clipboard at
  33. any time by pressing the PrtSc key (Shift-PrtSc on 84-key key-
  34. boards), or just the currently active window can be saved to the
  35. clipboard by pressing Alt-PrtSc.  GRAFFIX does not need to be
  36. running in order to do this.  GRAFFIX can then be opened to save
  37. the clipboard to disk in BMP, GIF, or PCX format.  Simply choose
  38. the appropriate item from the main menu, and respond to the
  39. prompt for a file name.  You can include a drive letter and
  40. directory specification in the filename edit box, such as
  41.  
  42. d:\pictures\filename.bmp
  43.  
  44. or just a filename to save to the current drive and directory.
  45.  
  46. After the file is written to disk, you can close GRAFFIX or
  47. minimize the GRAFFIX window to an icon.  When minimized, GRAFFIX
  48. is still active in "popup" mode, which means a dialog-box will
  49. pop up onto the screen whenever a graphics bitmap is placed on
  50. the clipboard.  The dialog box asks if you want to save the con-
  51. tents of the clipboard to a graphics file, or cancel and continue
  52. with the current application.  You can turn popup mode off by
  53. clicking on the "popup" item in the Options menu, which will
  54. remove the checkmark next to this menu item.
  55.  
  56. In popup mode, GRAFFIX will pop up when you press the PrtSC key
  57. OR when another application places a bitmap on the clipboard
  58. that is compatible with GRAFFIX.  The compatible formats are
  59. DDB (Device-Dependent Bitmap) and DIB (Device-Independent Bitmap),
  60. the two most commonly-used bitmap formats.  If you attempt to
  61. save a clipboard bitmap whose format is not one of these two,
  62. GRAFFIX will respond with a dialog box that says "No bitmap
  63. exists on the clipboard."  The Windows Clipboard Viewer can be
  64. used to examine the contents of the clipboard prior to invoking
  65. GRAFFIX.
  66.  
  67.  
  68. Main Menu Item: BMP
  69.  
  70. Select this menu item to save the contents of the clipboard to an
  71. uncompressed Windows Bitmap File with the filename extension BMP.
  72. 16-color, 256-color, and 24-bit true-color modes are supported.
  73.  
  74.  
  75. Main Menu Item: GIF
  76.  
  77. Select this menu item to save the contents of the clipboard to a
  78. CompuServe Graphics Interchange Format file with the filename ex-
  79. tension GIF.  This format utilizes LZW compression, and supports
  80. 16 and 256-color modes.  GIF does not support 24-bit color modes.
  81.  
  82.  
  83. Main Menu Item: PCX
  84.  
  85. Select this menu item to save the contents of the clipboard to
  86. a PC Paintbrush file with the filename extension PCX.  16-color,
  87. 256-color, and 24-bit true-color modes are supported.
  88.  
  89.  
  90. Main Menu Item: Options
  91. Three options are available:
  92.  
  93. Clear clipboard.  Selecting this menu item empties the clipboard.
  94.  
  95. Popup mode.  This is the default mode of GRAFFIX.  When minimized
  96.   to an icon, GRAFFIX will pop up onto the screen whenever the
  97.   clipboard receives a new bitmap image.  Select this menu item
  98.   to turn popup mode off or back on again.
  99.  
  100. DIB to DDB.  If the clipboard image is in DIB format, GRAFFIX
  101.   creates DDB and palette data structures before saving the
  102.   image to disk.  Enable this option to add these items to the
  103.   clipboard when the file is created.  The Windows Clipboard
  104.   Viewer can provide more accurate color rendition if these
  105.   items are on the clipboard.
  106.  
  107.  
  108. Help Menu
  109.  
  110. Online Help is available to explain the features of GRAFFIX.
  111.  
  112.  
  113. GRAFFIX for DOS is a memory-resident utility that captures gra-
  114. phics and text-mode screens directly to disk files.  It can be
  115. activated from within a running DOS application, such as a video
  116. game, by pressing the "hot key" combination Ctrl-Alt-Space.
  117. Graphics screens can be saved as either GIF or PCX files, and
  118. text screens as ASCII files.  This version of GRAFFIX supports
  119. all EGA, VGA, and SVGA gray-scale and color graphics modes (16-
  120. and 256-color), 640 x 480 24-bit color (VESA mode 112h), mono-
  121. chrome EGA and VGA modes, and text modes up to 132 columns by
  122. 60 rows.  To minimize memory requirements of this TSR, the old
  123. CGA and Hercules graphics modes are not supported.  SVGA modes
  124. are supported for adapters whose BIOS is VESA-compliant, which
  125. includes most SVGA adapters on the market.
  126.  
  127.  
  128. USING GRAFFIX for DOS
  129.  
  130. Super-VGA modes are supported for video cards that have the
  131. VESA BIOS extension.  GRAFFIX looks for this extension when you
  132. make it resident, and prints a message on the screen indicating
  133. whether or not the VESA BIOS extension was found.  Some SVGA
  134. cards, such as the Video Seven WIN.VGA, require that you run
  135. a utility program that installs the VESA BIOS extension in RAM
  136. before an application can make calls to the BIOS extension.
  137.  
  138. In the case of the Video Seven card, this utility is named
  139. V7VESA.COM.  Putting V7VESA on a separate line in your AUTO-
  140. EXEC.BAT file will automatically load this driver every time
  141. you turn on your computer.
  142.  
  143. In the absence of the VESA BIOS extension on SVGA cards, GRAFFIX
  144. supports the standard VGA modes, but will terminate and return to
  145. the application when it encounters a mode it does not recognize.
  146.  
  147. When GRAFFIX is activated in graphics mode, a prompt for a file
  148. name appears at the top of the screen.  The cursor is invisible
  149. in graphics modes, but you can enter a file name as you would
  150. in text mode, and backspace to delete characters you may want
  151. to change.  If no file name is entered before you press RETURN,
  152. GRAFFIX defaults to the file name SCREEN.GIF or SCREEN.PCX,
  153. depending on the format selected, and writes the file to the
  154. current drive and directory.  You may enter the file name with
  155. a drive and directory prefix, such as d:\dir\filename, where d
  156. represents any drive letter and dir any directory or subdirectory
  157. name.  The prompt will accept more than one directory in the pre-
  158. fix, such as d:\dir\subdir\filename, for a total of up to 23
  159. characters.
  160.  
  161. No file name prompt appears in 640 x 480 24-bit mode, as some
  162. adapter cards do not support text output in this mode.  Instead,
  163. the filename defaults to 24BITxxx.PCX in the current directory,
  164. where xxx represents the number in the sequence of files saved.
  165. The GIF format does not support 24-bit color.
  166.  
  167. The time GRAFFIX takes to capture a graphics screen and save it
  168. to disk depends on the speed of your computer, the file format
  169. chosen, and the graphics mode.  A GIF file takes longer to create
  170. than a PCX file, because the compression algorithm is more com-
  171. plex, resulting in a file that is more compact.  The higher the
  172. resolution of the graphics mode, the longer it will take to cre-
  173. ate the file, because of the greater number of pixels that must
  174. be encoded.
  175.  
  176. When the screen capture is completed, GRAFFIX will signal you
  177. with a beep.  During a SVGA screen capture, GRAFFIX will generate
  178. a series of ascending tones; each tone indicates that the video
  179. card has switched to a new page of memory.  This is to reassure
  180. you that the program is indeed processing data, and not hung up
  181. in an endless loop.
  182.  
  183.  
  184. RUNNING DGFX.EXE AND WGFX.EXE
  185.  
  186. Since DGFX.EXE is a TSR, it must be launched from the DOS prompt
  187. BEFORE opening Microsoft Windows.  It cannot be properly in-
  188. stalled in memory from a DOS "shell" activated by clicking a DOS
  189. icon in Windows, nor can it be run from the Windows "Run File"
  190. menu.  However, once DGFX.EXE has been installed as a memory-
  191. resident program, it can be activated from within a DOS program
  192. that was launched from DOS, from Windows, or from a DOS shell in
  193. Windows.  GRAFFIX for DOS is activated by pressing the "hot-key"
  194. combination Ctrl-Alt-Space.  This is the way to save a full-
  195. screen graphic image that is not framed by a window.
  196.  
  197. WGFX.EXE is run the same way as any other Windows program, either
  198. from the "Run File" menu or by clicking on its icon, having first
  199. installed it in a program group window.  The Windows documenta-
  200. tion explains how to add a DOS or Windows program to a group.
  201. In popup mode, WGFX.EXE will only pop up in Windows, not in DOS
  202. or in DOS programs running in Windows.
  203.  
  204.  
  205. GRAFFIX for Windows and DOS, Version 2.3, Shareware Edition
  206. Copyright 1994 ANDROMEDA SOFTWARE.   All rights reserved.
  207.  
  208. To order the Professional Edition of GRAFFIX for Windows and
  209. DOS, send $39 to:
  210.  
  211. ANDROMEDA SOFTWARE
  212. 25 North Prospect St.
  213. Washington NJ 07882
  214.  
  215. NJ residents please include sales tax.
  216.  
  217. Comments, questions, or suggestions about GRAFFIX can
  218. be addressed to Steven A. Brown, the author of GRAFFIX,
  219. on CompuServe at [73140,3340].
  220.  
  221.  
  222.                DISCLAIMER OF WARRANTY
  223.  
  224. THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT
  225. WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY
  226. OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE
  227. OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  228. WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR
  229. A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING
  230. PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED
  231. WITH NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER
  232. MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY
  233. LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO
  234. PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
  235.  
  236.