home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / PHOTO / GRAFFIX / GRAFFIX.TXT < prev    next >
Encoding:
Text File  |  1997-06-24  |  37.8 KB  |  885 lines

  1.  
  2.  
  3.  
  4.  
  5. Graffix (tm) for Windows and DOS, Shareware Edition, v5.50
  6. Copyright 1993-97 AndroSoft (tm).  All Rights Reserved.
  7.  
  8. For logo-free screen captures, become a registered user.
  9.  
  10.  
  11.                           CONTENTS
  12.  
  13. Introduction.............................................. 2
  14. Graffix for Windows....................................... 2
  15. Capturing the Windows Screen.............................. 2
  16. Capturing the DOS Screen with DosClip..................... 3
  17. Cropping the Clipboard Image.............................. 5
  18. File Menu Item: Save as BMP............................... 5
  19.                 Save as GIF............................... 5
  20.                 Save as JPG .............................. 6
  21.                 Save as PCX............................... 5
  22.                 Save as PNG............................... 6
  23.                 Save as TIF............................... 6
  24.                 Save as TXT............................... 6
  25.                 Open BMP.................................. 6
  26. Main Menu Item: Display................................... 7
  27. Options Menu  : Capture cursor............................ 7
  28.                 Capture rectangle......................... 7
  29.                 Clear clipboard........................... 7
  30.                 Enter coordinates......................... 7
  31.                 Interlace GIF............................. 7
  32.                 Interlace JPG............................. 7
  33.                 Interlace PNG............................. 7
  34.                 Invert colors............................. 8
  35.                 Popdown mode.............................. 8
  36.                 Popup mode................................ 8
  37.                 Reverse x-axis............................ 8
  38.                 Reverse y-axis............................ 8
  39.                 Set JPG quality........................... 8
  40.                 Stretch bitmap............................ 8
  41.                 Text colors............................... 8
  42.                 Text to bitmap............................ 9
  43.                 TIF compression........................... 9
  44.                 Transparent GIF........................... 9
  45. Main Menu Item: Print.....................................10
  46. Help Menu.................................................10
  47. Graffix for DOS...........................................10
  48. Using Graffix for DOS.....................................10
  49. Text Mode Screens.........................................12
  50. Installation - Graffix for DOS............................13
  51. Installation - Graffix for Windows........................13
  52. Registration..............................................14
  53. Legal Notices.............................................15
  54. APPENDIX - VESA modes supported by DosClip................17
  55.  
  56.  
  57.                             - 2 -
  58.  
  59. Introduction
  60.  
  61. Graffix is a screen-capture system for Windows and DOS.  This
  62. Shareware Edition includes the following programs:
  63.  
  64. DGFX.EXE    - Graffix for DOS
  65. WGFX16.EXE  - Graffix for Windows 3.1x
  66. WGFX32.EXE  - Graffix for Windows 95 and Windows NT
  67. AB.EXE      - AttriByte, ATF file display utility
  68. DOSCLIP.EXE - DosClip, a DOS-to-Windows capture utility
  69.  
  70. DGFX.EXE is included for compatibility with previous versions of
  71. Graffix.  This program has been superceded by DosClip (DOCLIP
  72. .EXE), a DOS TSR utility that works in conjunction with Graffix
  73. for Windows to capture to the Windows clipboard the entire screen
  74. from graphical DOS applications running full-screen in a DOS
  75. session.  Use of DosClip is explained in the "Capturing the DOS
  76. Screen with DosClip" section of this text file.
  77.  
  78. Graffix for DOS (DGFX.EXE) can capture full-screen text or
  79. graphics from DOS applications running in DOS or under Windows
  80. to a GIF or a PCX file.  Graffix for Windows (WGFX16.EXE or
  81. WGFX32.EXE) can capture the entire screen or any rectangular
  82. portion from Windows applications to a BMP, GIF, JPG, PCX, or
  83. TIF file, or send output directly to the printer.  WGFX32.EXE
  84. also supports the PNG graphical file format.  For simplicity,
  85. the explanations that follow focus first on the Windows version
  86. of Graffix (including DosClip), then on Graffix for DOS.
  87.  
  88.  
  89. Graffix for Windows
  90.  
  91. To run Graffix in Windows 3.1, select "Run" in the Program Mana-
  92. ger "File" menu and enter the path to WGFX16.EXE.  In Windows 95
  93. and Windows NT, click on the "Run" item in the "Start" menu and
  94. enter the path to WGFX32.EXE.
  95.  
  96.  
  97. Capturing the Windows Screen
  98.  
  99. Graffix for Windows was designed to run minimized in "popup"
  100. mode, meaning it will pop up when you press the PrtSc key to
  101. capture the entire screen, or Alt+PrtSc to capture the currently
  102. active window.  You can then save the entire image or any
  103. rectangular portion.  To return to the application that was
  104. interrupted, click on that application's window or minimize
  105. Graffix again.  You can turn popup mode off by pressing Ctrl+M,
  106. or by clicking on "Popup" in the Options menu, which will remove
  107. the checkmark next to this menu item.
  108.  
  109. Graffix does not need to be running in order to make a screen
  110. capture.  Once you have pressed the PrtSc key, you can run
  111. Graffix to display the clipboard.  You can then save the entire
  112. image or crop a rectangular area with the mouse or keyboard
  113. before saving to disk.
  114.  
  115.                             - 3 -
  116.  
  117. To save a captured image to disk, choose the desired format from
  118. the File menu.  A dialog box will list the files of the selected
  119. format in the current directory.  You may select one of the files
  120. listed or type a new file name in the edit box.  You may also
  121. switch to another directory or disk drive.
  122.  
  123. Graffix will also display text captured to the clipboard by
  124. pressing the PrtSc key while a DOS character-mode application is
  125. running full-screen under Windows.  Two character sets are avail-
  126. able for the display of text, OEM and ANSI, which may be selected
  127. from the Options menu.  Text can be saved to an ASCII file or to
  128. a monochrome graphics file in any of the available formats.
  129.  
  130. While in popup mode, Graffix will also pop up when another appli-
  131. cation puts onto on the clipboard a bitmap that is compatible
  132. with Graffix.  The compatible formats are DDB (Device-Dependent
  133. Bitmap) and DIB (Device-Independent Bitmap), two commonly-used
  134. bitmap formats.  If you attempt to save a clipboard bitmap whose
  135. format is not one of these two, Graffix will respond with a
  136. dialog box that says "No bitmap exists on the clipboard."
  137.  
  138. Because of the internal complexities of the popup feature,
  139. Graffix will not allow more than one instance of itself to run.
  140. Clicking on the Graffix icon will therefore activate a currently-
  141. running instance if one exists, instead of launching a new
  142. instance.  This property can be put to good use if the Graffix
  143. window should become hidden by another window; click its icon
  144. in the Start menu to make the Graffix window visible.
  145.  
  146.  
  147. Capturing the DOS Screen with DosClip
  148.  
  149. Graffix can capture the screen to the Windows clipboard from
  150. either a text or a graphical mode DOS application that is running
  151. full-screen in a Windows DOS session.  Normally, such captures
  152. are made by pressing the PrtSc key.  However, Windows is not
  153. always able to capture the screen to the clipboard from a DOS
  154. application that is displaying a full-screen graphical image.
  155. In that case, Windows displays the message "Unable to copy screen
  156. contents into clipboard."  When this occurs, you can still make
  157. the capture by activating DosClip, a utility that is included
  158. with Graffix.
  159.  
  160. Before you can use DosClip, you must make it memory-resident in
  161. the DOS session before running the DOS graphical application.  To
  162. do this, first start a DOS session by clicking on the MS-DOS icon
  163. in Windows.  At the DOS prompt, type dosclip and press Enter.
  164. The directory in which dosclip.exe resides should be included in
  165. the PATH statement of your autoexec.bat file, otherwise you will
  166. have to type the full path to dosclip.exe before pressing Enter.
  167. Dosclip will now display the message "DosClip is now memory-
  168. resident" on the screen.  The message will also indicate whether
  169. or not the VESA BIOS extension is present, as DosClip needs this
  170. extension to capture SVGA screens.  If the VESA BIOS extension is
  171. not present, you will need to insert a line in autoexec.bat that
  172.  
  173.                             - 4 -
  174.  
  175. runs a utility that installs the VESA BIOS extension in RAM.  See
  176. the documentation for your video card for information about this
  177. utility.  For a list of the VESA modes supported by DosClip, see
  178. the Appendix at the end of this document.
  179.  
  180. After you make DosClip memory-resident in the DOS session, you
  181. can run your graphical DOS application.  Now, if pressing PrtSc
  182. fails to capture a graphical screen to the Windows clipboard, you
  183. can activate DosClip by pressing Ctrl+PrtSc.  DosClip will signal
  184. you with one or more beeps, depending on the screen mode, that
  185. it is making the capture.  After the final beep, you may proceed
  186. working in the DOS application and make additional screen cap-
  187. tures.  Screen captures are saved to a series of sequentially-
  188. named temporary files, starting with DSCLP000.BMP.  You can make
  189. up to 256 captures in a series before the file name cycles from
  190. DSCLP255.BMP back to DSCLP000.BMP and starts overwritng files of
  191. the same name.
  192.  
  193. You can switch back to Windows at any time by pressing Alt+Esc.
  194. Your DOS session will now be running minimized so that you can
  195. return to it.  Graffix will now open the first temporary file,
  196. place the image it contains onto the clipboard, then delete the
  197. file.  It may be necessary to activate Graffix by clicking on
  198. its title bar, if it is not the currently active window.  You can
  199. now save the clipboard image, print it, or perform any of the
  200. transformations available in the Options menu.
  201.  
  202. To display the next captured image in the series, press Ctrl+N or
  203. select "Next DOS capture" from the "Display" menu.  After the
  204. last capture is displayed, selecting this menu item will display
  205. the message "No more DOS captures."  You may now return to the
  206. DOS session to make additional captures by clicking on the DOS
  207. session icon on the taskbar.  A new temporary series will begin,
  208. starting with DSCLP000.BMP.
  209.  
  210. The temporary BMP files are stored in the default WINDOWS\TEMP
  211. directory, unless you specify another directory by setting the
  212. TMP environment variable in autoexec.bat.  The temporary BMP
  213. files created by DosClip are not really useful to any other
  214. application besides Graffix, as the images are inverted.  Graffix
  215. automatically re-inverts the images before displaying them.
  216. There is a practical reason for this image inversion; contact
  217. the programmer if you need to know the technical details.
  218.  
  219. Although DosClip was designed to run in a Windows DOS session, it
  220. is possible to use DosClip on a machine that is running only DOS.
  221. In that case, you should include the following line in the DOS
  222. autoexec.bat file:
  223.  
  224. set TMP=C:\WINDOWS\TEMP
  225.  
  226. This will enable Graffix to find and display the DosClip
  227. temporary BMP files when you start Windows and run Graffix.
  228.  
  229.                             - 5 -
  230.  
  231. Cropping the Clipboard Image
  232.  
  233. The Graffix display window can scroll the clipboard image hori-
  234. zontally and vertically by means of the scroll bars.  To mark a
  235. rectangular area for cropping, move the cursor to the top-left
  236. corner of the desired rectangle, depress the left mouse button,
  237. move the cursor to the lower-right corner and release the button.
  238. Repeat this procedure to erase the rectangle and draw a new one.
  239. The width and height of the rectangle in pixel units will be
  240. displayed in the title bar, as will the x (horizontal) and y
  241. (vertical) coordinates of the upper-left (UL) and lower-right
  242. (LR) corners of the rectangle.  The origin of these coordinates
  243. is the upper-left corner of the clipboard image.
  244.  
  245. You can use the keyboard to modify or enter rectangle coordi-
  246. nates.  To do this, select "Enter coordinates" from the Options
  247. menu.  The dialog box will allow you to specify the position of
  248. the upper-left corner of the rectangle.  You can specify the
  249. position of the lower-right corner by entering its x and y
  250. coordinates or by entering the width and height of the desired
  251. rectangle.
  252.  
  253. You may save the cropped image directly to disk by means of the
  254. File menu, or you may capture the rectangle to the clipboard by
  255. pressing Ctrl+R or by selecting "Capture rectangle" from the
  256. Options menu.  To erase the rectangle, press Esc or position the
  257. cursor anywhere on the image and click the left mouse button.
  258.  
  259.  
  260. File Menu Item: Save as BMP
  261.  
  262. Select this menu item to save the contents of the clipboard to an
  263. uncompressed Windows Bitmap File with the filename extension BMP.
  264. Monochrome, 16-color, 256-color, and 24-bit TrueColor modes are
  265. supported.
  266.  
  267.  
  268. File Menu Item: Save as GIF
  269.  
  270. Select this item from the File menu to save the contents of the
  271. clipboard to a CompuServe Graphics Interchange Format file with
  272. the filename extension GIF.  This format utilizes LZW compression,
  273. and supports Monochrome, 16-color and 256-color modes.  The GIF
  274. format does not support more than 256 colors, so if the number of
  275. colors in the image on a 24-bit TrueColor display exceeds that
  276. number, the Windows 3.1 version of Graffix will abort the save,
  277. but the Windows 95/NT version of Graffix will automatically
  278. compute an optimal palette of 256 colors, map the image to those
  279. colors, and save it to a GIF file.
  280.  
  281. Any one of the colors in an image can be selected to be a trans-
  282. parent color in a GIF file.  See "Options - Transparent GIF" for
  283. details.
  284.  
  285. If text is the currently-displayed clipboard format, it will be
  286. converted to a graphic image and saved to a monochrome GIF file.
  287.  
  288.                             - 6 -
  289.  
  290. File Menu Item: Save as JPG
  291.  
  292. Select this item from the File menu to save the contents of the
  293. clipboard to a JPEG file with the filename extension JPG.  This
  294. is a 24-bit TrueColor format that utilizes variable-quality lossy
  295. compression.  Graffix promotes monochrome and palette-based 16
  296. and 256-color images to 24-bit TrueColor before saving to JPG.
  297. The compressed file size is inversely proportional to the quality
  298. setting, which may be set to any value from 1 to 100 in the
  299. Options menu.  The default Q setting is 75.
  300.  
  301.  
  302. File Menu Item: Save as PCX
  303.  
  304. Select this menu item to save the contents of the clipboard to
  305. a PC Paintbrush file with the filename extension PCX.  Mono-
  306. chrome, 16-color, 256-color, and 24-bit TrueColor modes are
  307. supported.
  308.  
  309.  
  310. File Menu Item: Save as PNG (Windows 95 & NT version)
  311.  
  312. Select this menu item to save the contents of the clipboard to
  313. a Portable Network Graphics file with the filename extension PNG.
  314. Monochrome, 16-color, 256-color, and 24-bit TrueColor modes are
  315. supported.
  316.  
  317.  
  318. File Menu Item: Save as TIF
  319.  
  320. Select this menu item to save the contents of the clipboard to
  321. a Tagged Image Format file with the extension TIF.  Three com-
  322. pression modes are available: LZW, PackBits, and no compression,
  323. any one of which may be selected from the Options menu.  The
  324. defaults are LZW for 24-bit TrueColor images, and PackBits for
  325. monochrome and palette color images.
  326.  
  327.  
  328. File Menu Item: Save as TXT
  329.  
  330. Select this menu item to save clipboard text to an ASCII text
  331. file.  Two character sets are available.  The OEM character set
  332. is the DOS-compatible IBM extended ASCII character set.  The ANSI
  333. character set is the one used by Windows.  If you save text to a
  334. file that already exists, the text will be appended to the file.
  335.  
  336. The text that will be saved extends from the top of the Window,
  337. as set by the current vertical scroll position, to the end of the
  338. clipboard text.
  339.  
  340.  
  341. File Menu Item: Open BMP
  342.  
  343. Select this item from the File menu to open a BMP file and place
  344. it onto the clipboard.  The image can now be saved in any of the
  345. four available formats, or cropped and then saved.
  346.  
  347.                             - 7 -
  348.  
  349. Main Menu Item: Display
  350.  
  351. This pull-down menu allows you to select which of the available
  352. clipboard formats to display.  Normally, Windows will clear the
  353. clipboard when the PrtSc key is pressed.  However, applications
  354. can place a bitmap or text on the clipboard without first clear-
  355. ing it, so that text and graphics can coexist.  This is the case
  356. when you select Open BMP.  By default, Graffix will display
  357. the format most recently added to the clipboard.
  358.  
  359.  
  360. Main Menu Item: Options
  361. The following options are available:
  362.  
  363. Capture cursor (Ctrl+U)
  364.   Select this menu item to include the mouse cursor in screen
  365.   images captured by pressing PrtSc.  The cursor is not captured
  366.   when you press Alt+PrtSc to capture the currently-active
  367.   window.
  368.  
  369. Capture rectangle (Ctrl+R)
  370.   Select this menu item to capture the current rectangle to the
  371.   clipboard.  You must first draw a rectangle with the mouse or
  372.   by entering coordinates from the keyboard.
  373.  
  374. Clear clipboard (Ctrl+L)
  375.   Select this menu item to empty the clipboard.
  376.  
  377. Enter coordinates (Ctrl+E)
  378.   Select this menu item to modify or draw a rectangle by entering
  379.   its coordinates from the keyboard.  The values that appear in
  380.   the dialog box are those of the current rectangle, if one has
  381.   been previously entered or drawn with the mouse.  If there is
  382.   no current rectangle, the values default to a rectangle that
  383.   contains the entire client area of the Graffix window.  Co-
  384.   ordinates may be entered that exceed the boundaries of this
  385.   client area, and may include the entire image on the clipboard,
  386.   up to a full screen.
  387.  
  388.   The origin of the rectangle coordinates is the upper-left
  389.   corner of the clipboard image.  To erase the rectangle, press
  390.   Esc or click the left mouse button.
  391.  
  392. Interlace GIF
  393.   Use this menu item to select whether or not GIF files will be
  394.   interlaced.
  395.  
  396. Interlace JPG
  397.   Use this menu item to select whether or not JPG files will be
  398.   interlaced.
  399.  
  400. Interlace PNG (Windows 95 & NT version)
  401.   Use this menu item to select whether or not PNG files will be
  402.   interlaced.
  403.  
  404.                             - 8 -
  405.  
  406. Invert colors (Ctrl+I)
  407.   Select this menu item to invert the colors of the image on the
  408.   clipboard, creating a negative image.  The original colors can
  409.   be restored by selecting this menu item again.
  410.  
  411. Popdown mode (Ctrl+D)
  412.   When this option is selected, Graffix will automatically
  413.   minimize itself after saving an image or text to disk.  This
  414.   feature is independent of popup mode.
  415.  
  416. Popup mode (Windows 3.1 version)
  417.   This is the default mode of Graffix.  When minimized or hidden
  418.   by another window, Graffix will pop up onto the screen whenever
  419.   a bitmap image or text is put onto the clipboard.  Select this
  420.   menu item to turn popup mode off or back on again.
  421.  
  422. Popup mode (Windows 95/NT version)
  423.   The default mode of Graffix is to pop up only when you press
  424.   the PrtSc key.  You may turn popup mode off or select the
  425.   option to pop up on all clipboard events, as the Windows 3.1
  426.   version does.
  427.  
  428. Reverse x-axis (Ctrl+X)
  429.   Select this menu item to flip the clipboard image horizontally.
  430.   This will result in a mirror image.
  431.  
  432. Reverse y-axis (Ctrl+Y)
  433.   Select this menu item to flip the clipboard image vertically.
  434.   The effect is the same as flipping a transparency over, top-to- 
  435.   bottom, and viewing it from the back.  To simulate the effect
  436.   of turning an image upside-down, it is necessary to reverse both
  437.   x and y axes.
  438.  
  439. Set JPG Quality (Ctrl+Q)
  440.   Select this menu item to adjust the quality setting for JPG
  441.   files. The size of the JPG file will be inversely proportional
  442.   to this setting, which may be set anywhere from 1 to 100.
  443.   The default Q setting is 75.
  444.  
  445. Stretch bitmap (Ctrl+S)
  446.   Select this menu item to stretch or compress the clipboard
  447.   image along the horizontal and/or vertical axes.  The
  448.   dimensions of the clipboard image may exceed the dimensions
  449.   of the screen, up to the limits imposed by available system
  450.   memory.
  451.  
  452. Text colors.
  453.   This menu item allows you to choose the displayed colors of
  454.   clipboard text.  The choices are black-on-white (the default)
  455.   and white-on-black.
  456.  
  457.                             - 9 -
  458.  
  459. Text to bitmap (Ctrl+B)
  460.   Select this menu item to convert clipboard text to a monochrome
  461.   bitmap image, so that it can be cropped or subjected to any of
  462.   the other transformation options, and/or saved to disk in any
  463.   of the graphical formats.
  464.  
  465.   The text that will be converted to a graphical image extends
  466.   from the top of the window, as set by the current vertical
  467.   scroll position, to the bottom of a full-screen image.
  468.  
  469. TIF compression
  470.   This menu item allows you to select the compression scheme
  471.   for TIF files.  The choices are no compression, PackBits, and
  472.   LZW (Lempel, Ziv, & Welch).  In the Windows 95/NT version of
  473.  
  474.   Graffix, two modes of LZW compression are available: LZW 8k
  475.   and LZW 16k.  The k refers to the number of kilobytes of raw
  476.   pixel data compressed into each strip.  The conventional strip
  477.   size in TIF files is 8k, but 16k yields better compression.
  478.   The defaults are LZW 8k for 24-bit True-Color images, and Pack-
  479.   Bits for monochrome and palette color images.
  480.  
  481. Transparent GIF
  482.   Select this menu item to turn GIF transparency on.  This will
  483.   make the selected color of subsequent GIF files transparent.
  484.   To select a color to be transparent, point the mouse cursor on
  485.   the image to the color you want to be transparent, then click
  486.   the right mouse button.  It is not necessary to select this
  487.   menu item to turn GIF transparency on; simply select a color to
  488.   be transparent, and this feature will be enabled.  The selected
  489.   color will be the transparent color for all subsequent GIF
  490.   files, until you select a different color or select this menu
  491.   item to turn GIF transparency off, which will remove the check-
  492.   mark next to this menu item.
  493.  
  494.   If you select this menu item to turn GIF transparency back on,
  495.   the previously-selected color will be transparent, unless you
  496.   select a different color.
  497.  
  498.                             - 10 -
  499.  
  500. Main Menu Item: Print
  501.  
  502.   Select this menu item to send clipboard graphics or text to
  503.   the printer.  When printing a graphical image, Windows first
  504.   presents a dialog box that will allow you to select from
  505.   various options, such as resolution and intensity, then
  506.   Graffix presents a dialog box that allows you to position
  507.   the image on the page and stretch or compress it vertically
  508.   and/or horizontally.
  509.  
  510.   When printing text, Graffix first presents a dialog box that
  511.   allows you to specify top and bottom margins, and the number of
  512.   lines of text to print on each page.  Then Windows presents a
  513.   dialog box that allows you to select from various options, and
  514.   to specify how many pages to print.  Printing begins from the
  515.   text at the top of the window, as set by the current vertical
  516.   scroll position.
  517.  
  518.  
  519. Help Menu
  520.  
  521. Online Help is available to explain the features of Graffix,
  522. and includes a glossary of terms used in this document.
  523.  
  524. Select "System info" from the Help menu to display the resolution
  525. and color capability of the Windows screen driver currently run-
  526. ning on your system.
  527.  
  528.  
  529. Graffix for DOS (DGFX.EXE)
  530.  
  531. Graffix for DOS is a memory-resident utility that captures gra-
  532. phics and text-mode screens directly to disk files.  It can be
  533. activated from within a running DOS application by pressing the
  534. "hot key" combination Ctrl+Alt+Space.
  535.  
  536. Graphics screens can be saved to either GIF or PCX files, and
  537. text screens to either ASCII or ATF files.  The ATF format pre-
  538. serves text color attributes.  Graffix supports all EGA, VGA, and
  539. SVGA gray-scale and color graphics modes, including 16 and 256-
  540. color, 24-bit color (VESA modes), monochrome EGA and VGA modes,
  541. and text modes up to 132 columns by 60 rows.  To minimize memory
  542. requirements of this TSR, the old CGA and Hercules graphics modes
  543. are not supported.  SVGA modes are supported for adapters whose
  544. BIOS is VESA-compliant, which includes most SVGA adapters.
  545.  
  546.  
  547. Using Graffix for DOS
  548.  
  549. Super-VGA modes are supported for video cards that have the
  550. VESA BIOS extension.  Graffix looks for this extension when you
  551. make it resident, and prints a message on the screen indicating
  552. whether or not the VESA BIOS extension was found.  Some SVGA
  553. cards, such as the Video Seven WIN.VGA, require that you run
  554.  
  555.                             - 11 -
  556.  
  557. a utility program that installs the VESA BIOS extension in RAM
  558. before an application can make calls to the BIOS extension.
  559. In the case of the Video Seven card, this utility is named
  560. V7VESA.COM.  Putting V7VESA on a separate line in your AUTO-
  561. EXEC.BAT file will automatically load this driver every time
  562. you turn on your computer.
  563.  
  564. In the absence of the VESA BIOS extension on SVGA cards, Graffix
  565. supports the standard VGA modes, but will terminate and return to
  566. the application when it encounters a mode it does not recognize.
  567.  
  568. When Graffix is activated in graphics mode, a prompt for a file
  569. name appears at the top of the screen.  The cursor is invisible
  570. in graphics modes, but you can enter a file name as you would
  571. in text mode, and backspace to delete characters you may want
  572. to change.  If no file name is entered before you press <CR>,
  573. Graffix defaults to the file name SAVE#XXX.GIF/PCX, where XXX is
  574. the sequential number of the file, and writes the file to the
  575. current drive and directory.  You may enter the file name with
  576. a drive and directory prefix, such as d:\dir\filename, where d
  577. represents any drive letter and dir any directory or subdirectory
  578. name.  The prompt will accept more than one directory in the pre-
  579. fix, such as d:\dir\subdir\filename, for a total of up to 23
  580. characters.
  581.  
  582. The file name prompt is drawn with palette number 15 against a
  583. background of palette number 0.  Occasionally, there may be in-
  584. sufficient contrast between these two colors for the prompt to
  585. be visible.  In that case, simply press p or g to select PCX or
  586. GIF, then press <CR> to use the default file name.
  587.  
  588. No file name prompt appears in 24-bit color modes, as some adap-
  589. ter cards do not support text output in these modes.  Instead,
  590. the filename defaults to 24BITxxx.PCX in the current directory,
  591. where xxx represents the number in the sequence of files saved.
  592. The GIF format does not support 24-bit color.
  593.  
  594. Video games sometimes use "tweaked" graphics modes that are not
  595. supported by the BIOS.  Graffix may be unable to capture these
  596. screens correctly.
  597.  
  598. The time Graffix takes to capture a graphics screen and save it
  599. to disk depends on the speed of your computer, the file format
  600. chosen, and the graphics mode.  A GIF file takes longer to create
  601. than a PCX file, because the compression algorithm is more com-
  602. plex, resulting in a file that is more compact.  The higher the
  603. resolution of the graphics mode, the longer it will take to cre-
  604. ate the file, because of the greater number of pixels that must
  605. be encoded.
  606.  
  607. When the screen capture is completed, Graffix will signal you
  608. with a beep.  During a SVGA screen capture, Graffix will generate
  609. a series of ascending tones; each tone indicates that the video
  610. card has switched to a new page of memory.  This is to reassure
  611. you that the program is indeed processing data, and not hung up
  612. in an endless loop.
  613.  
  614.                             - 12 -
  615.  
  616. Text Mode Screens
  617.  
  618. Text can be saved to either an ASCII file or to an Attribute Text
  619. Format file with the extension ATF.  An ATF file contains two
  620. bytes for each character: the ASCII code and the color attribute.
  621. Many DOS applications that run in text mode simulate a graphical
  622. interface by utilizing the extended ASCII character set to draw
  623. multi-colored menus and dialog boxes.  Such a screen can be cap-
  624. tured to an ATF file.
  625.  
  626. Graffix includes a DOS utility named AttriByte (AB.EXE) that can
  627. display an ATF file in its original colors in a graphical screen
  628. mode, so that the Graffix TSR can capture the screen to a GIF or
  629. a PCX file.  When you run AttriByte from the DOS command line,
  630. you will be prompted for the name of an ATF file to display.
  631. AB.EXE will then switch the screen to the most suitable graphics
  632. mode available on your computer and display the ATF file.  Attri-
  633. Byte uses VESA modes to display 132-column text, so the VESA BIOS
  634. extension should be installed on your computer.
  635.  
  636. If the maximum resolution of your monitor is 1024x768, AttriByte
  637. will display 132-column text in VESA BIOS mode 104h, which is
  638. only capable of displaying 128 columns.  Hence, the four columns
  639. on the right of the screen will not be displayed.  On 1280x1024
  640. monitors, the full 132 columns will be displayed in VESA mode
  641. 106h, which is capable of displaying up to 160 columns of text.
  642.  
  643. You can override AttriByte's choice of screen mode by running
  644. AB.EXE with the /x command-line switch.  This will cause Attri-
  645. Byte to display the ATF file in whatever screen mode happens
  646. to be in effect.  Therefore, it is necessary to put the screen
  647. into the desired graphics mode before running AB.EXE with the
  648. /x switch, by means of a screen mode utility such as the one
  649. included on the software disk that came with your video card.
  650.  
  651. When AttriByte displays an ATF file, the image will remain on the
  652. screen while you activate Graffix for DOS by means of the hot key
  653. combination.  After you've saved the screen as either GIF or PCX,
  654. press any key to return to DOS.  If you used the /x switch, the
  655. screen will still be in the mode you selected, and the DOS prompt
  656. will be superimposed on the image that was displayed.  Use the
  657. DOS command CLS to clear the screen, or reset the screen to text
  658. mode 3 by means of your screen mode utility.
  659.  
  660. When you save a text mode screen to an ASCII file, the text will
  661. be appended to a file if you enter the name of a file that al-
  662. ready exists.  If you do this when you save text to an ATF file,
  663. a new file will be created and the existing file deleted.
  664.  
  665.                             - 13 -
  666.  
  667. Installation - Graffix for DOS
  668.  
  669. To install Graffix for DOS onto your hard disk, copy the files
  670. DGFX.EXE and AB.EXE into the directory where you want these files
  671. to reside.  Then, to install the Graffix for DOS TSR into memory,
  672. change to this directory, type DGFX at the DOS prompt and press
  673. <Enter>.  From any other directory, type the full path to DGFX
  674. .EXE at the DOS command line and press <Enter>.  If the "path"
  675. environment variable in your AUTOEXEC.BAT file includes the drive
  676. and directory where DGFX.EXE resides, then you need only type
  677. DGFX at the DOS prompt from within any directory before you press
  678. <Enter>.
  679.  
  680. To make the Graffix for DOS TSR automatically memory-resident
  681. each time you turn on your computer, insert into your AUTOEXEC
  682. .BAT file the DOS command line to launch DGFX.EXE, after the line
  683. that sets the path.
  684.  
  685. Run DGFX.EXE from the DOS prompt to make the TSR memory-resident.
  686. If you do this before launching Windows 3.1 in Enhanced Mode, the
  687. TSR can be activated from within any DOS prompt or DOS applica-
  688. tion running under Windows.  If you run DGFX.EXE from a DOS shell
  689. in Windows 3.1 to make the TSR memory-resident, it can be acti-
  690. vated only from within that shell and not elsewhere in Windows.
  691.  
  692. In Windows 95, it is preferable to run DGFX.EXE from a DOS shell,
  693. in which case the TSR can be activated only from within that
  694. shell.  It is possible to start Windows 95 in DOS mode (see the
  695. Windows documentation), run DGFX.EXE, then type "win" at the
  696. command line to launch the Windows interface.  This will make it
  697. possible to activate the TSR from any DOS application or shell,
  698. but this forces DOS compatibility mode which degrades the per-
  699. formance of Windows 95.
  700.  
  701.  
  702. Installation - Graffix for Windows
  703.  
  704. To install the Graffix icon into a group window in Windows 3.1,
  705. first create a directory on your hard disk where you want the
  706. Graffix files to reside (the DOS manual explains how to do this).
  707. Next, copy the files WGFX16.EXE and WGFX.HLP into that directory.
  708. Now start Windows and open the program group window into which
  709. you want to install the Graffix icon.  Next, pull down the File
  710. menu in Program Manager and click on New.  Select "Program Item"
  711. and click OK.  The "Program Item Properties" dialog box will now
  712. appear.
  713.  
  714. For Description, enter "Graffix."  Press the Tab key, and
  715. for Command Line, enter the full path to WGFX16.EXE, such as
  716. C:\Graffix\WGFX16.EXE.  Press the Tab key, and for Working
  717. Directory, enter the path to the default directory where you
  718. want screen-capture files to be saved.  Now click OK, and
  719. the Graffix icon will be installed into the group window.
  720.  
  721.                             - 14 -
  722.  
  723. To install Graffix into the Windows 95 Start Menu, first click
  724. the "Start" button.  Move the arrow to "Settings."  Click "Task-
  725. bar."  Click "Start Menu Programs," then click "Add."  Now enter
  726. the path to WGFX32.EXE or select "Browse" to locate the file.
  727. Click "Next" and select the folder in which to place the Graffix
  728. icon.
  729.  
  730.  
  731. Registration
  732.  
  733. Graffix (tm) for Windows and DOS, Shareware Edition, v5.50
  734. Copyright 1993-97 AndroSoft (tm).  All Rights Reserved.
  735.  
  736. The Professional Edition of Graffix does not superimpose any
  737. shareware notice or logo on saved or printed images.
  738.  
  739. To register and receive your licensed Professional Edition, fill
  740. out the Order Form and mail, e-mail, or fax to
  741.  
  742.                       AndroSoft
  743.                       125 N. Prospect St.
  744.                       Washington NJ 07882
  745.                       U.S.A.
  746.  
  747. NJ residents please include sales tax.
  748.  
  749. Steven A. Brown, Programmer
  750. E-mail: 73140.3340@compuserve.com
  751. Fax   : 908-689-0047
  752. Tel   : 908-689-4412
  753.  
  754. AndroSoft is a growing business and it may become necessary in
  755. the future for us to relocate.  Our postal address, fax and tele-
  756. phone numbers may change, but our e-mail address will stay the
  757. same.  You will therefore still be able to contact us by e-mail,
  758. even if attempts to contact us by other means fail.
  759.  
  760.                             - 15 -
  761.  
  762. CREDIT CARD ORDERS
  763.  
  764. You may e-mail or fax your order with your name, address, VISA,
  765. MasterCard, or American Express account number, and expiration
  766. date.  Please include your signature on fax orders, and specify
  767. one of the following methods of delivery:
  768.  
  769. 1.  First-class air mail on 3.5" disk.
  770.  
  771. 2.  GRAFFIX.ZIP via e-mail to a CompuServe address.
  772.  
  773. 3.  GRAFFIX.ZIP via e-mail to an America Online address.
  774.  
  775. 4.  GRAFFIX.ZIP via Internet e-mail (requires your e-mail
  776.     software to have MIME capability, indicated by a line in
  777.     your message header that begins with "MIME-version:"
  778.  
  779. Registration fee is $39.00 for one pc, plus $10.00 for each
  780. additional pc or workstation on which Graffix will be used.
  781. Shipping via e-mail: $1.  Via first-class air mail: $1 to North
  782. America, $2 elsewhere.  Additional copies on diskette: $1 each.
  783. Residents of New Jersey please include sales tax.
  784.  
  785. Orders may also be placed by telephone to (908) 689-4412.
  786.  
  787.  
  788. SITE LICENSING
  789.  
  790. A site license for additional workstations is available for the
  791. very reasonable fee of $10 for each additional pc or workstation.
  792. To obtain a site license, fill out the Order Form and submit with
  793. payment.
  794.  
  795.  
  796. SHAREWARE NOTICE
  797.  
  798. The Shareware Edition of Graffix may be freely distributed.
  799. You may use it over a 15-day period to determine its suitability
  800. for your needs.  To continue using Graffix beyond this evaluation
  801. period, you will be required to purchase the registered Profes-
  802. sional Edition.
  803.  
  804. Registration fees are the only compensation the programmer re-
  805. ceives for the work and expense of writing this program.  Please
  806. support the shareware concept of quality, "try-before-you-buy"
  807. software.  Registered users are entitled to unlimited technical
  808. support and low-cost upgrades.
  809.  
  810.  
  811. ACKNOWLEDGEMENT
  812.  
  813. The JPEG file capability of Graffix is based on the work of the
  814. Independent JPEG Group.
  815.  
  816.                             - 16 -
  817.  
  818. DISCLAIMER OF WARRANTY
  819.  
  820. THIS SOFTWARE IS SOLD "AS IS," WITHOUT WARRANTY AS TO PERFORMANCE
  821. OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR
  822. IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRON-
  823. MENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS
  824. FOR A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING PRO-
  825. CEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-
  826. CRITICAL DATA BEFORE RELYING ON IT.  THE USER MUST ASSUME THE
  827. ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER
  828. WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
  829. PURCHASE PRICE.
  830.  
  831.  
  832. LZW LICENSE NOTICE
  833.  
  834. Use of this software is permitted only to the extent reasonably
  835. required to determine whether to purchase the software.
  836.  
  837. After payment is made, use of this software is limited to use on
  838. only a single personal computer or workstation which is not used
  839. as a server.  An additional payment of $10 is required for each
  840. use on another personal computer or workstation.
  841.  
  842. Only a single copy may be made of this software solely for backup
  843. or archival purposes.  The software may also be transferred to a
  844. single hard disk.
  845.  
  846. Any use of this software in violation of the above is not
  847. licensed.
  848.  
  849. For information concerning licensing the LZW compression and/or
  850. decompression capability, please contact:
  851.  
  852.           Unisys Corporation
  853.           Welch Licensing Department - C1SW19
  854.           Township Line & Union Meeting Roads
  855.           P.O. Box 500
  856.           Blue Bell, Pennsylvania 19424
  857.  
  858. Graphics Interchange Format and GIF are service marks of
  859. CompuServe Incorporated.
  860.  
  861.                             - 17 -
  862.  
  863. APPENDIX - VESA modes supported by DosClip
  864.  
  865. In addition to the standard VGA modes, the following VESA SVGA
  866. graphical screen modes are supported by DosClip:
  867.  
  868. MODE     PIXEL RESOLUTION    NUMBER OF COLORS
  869.  
  870. 100h      640 x  400                256
  871. 101h      640 x  480                256
  872. 102h      800 x  600                 16
  873. 103h      800 x  600                256
  874. 104h     1024 x  768                 16
  875. 105h     1024 x  768                256
  876. 106h     1280 x 1024                 16
  877. 107h     1280 x 1024                256
  878. 10Fh      320 x  200         16,777,200
  879. 112h      640 x  480         16,777,200
  880. 115h      800 x  600         16,777,200
  881. 118h     1024 x  768         16,777,200
  882. 11Bh     1280 x 1024         16,777,200
  883.  
  884.                            #  #  #
  885.