Chip Hitware 3/CHIP_HITWARE3.iso/chiphit3/tools/95sclip/sclip.txt

Text File | 1996-08-07 | 25KB | 596 lines

        SuperClip (tm) 3.15, Shareware Edition
     Screen Capture System for MS Windows and DOS

Copyright 1994-96 AndroSoft (tm).  All Rights Reserved.
This distribution includes sclip16.exe for Windows 3.1,
and sclip32.exe for Windows 95 and Windows NT.


                         CONTENTS

Introduction ............................................. 1
Installation - Windows 3.1 ............................... 2
Installation - Windows 95 and Windows NT ................. 2
Capturing the Windows Screen ............................. 3
Capturing the DOS Screen ................................. 4
Cropping the Clipboard Image ............................. 5
File Menu Item: Save as BMP .............................. 6
                Save as GIF .............................. 6
                Save as PCX .............................. 6
                Save as TIF .............................. 6
                Save as TXT .............................. 6
                Open BMP ................................. 6
Main Menu Item: Display .................................. 7
Options Menu  : Capture rectangle ........................ 7
                Clear clipboard .......................... 7
                Enter coordinates ........................ 7
                Invert colors ............................ 7
                Popup mode ............................... 7
                Reverse x-axis ........................... 7
                Reverse y-axis ........................... 8
                Stretch bitmap ........................... 8
                Text colors .............................. 8
                Text to bitmap ........................... 8
                TIF compression .......................... 8
Main Menu Item: Print .................................... 8
Help Menu ................................................ 8
Registration ............................................. 9
Legal Notices ............................................10
AndroSoft Home Page ......................................11
Support for SuperClip on CompuServe ......................11
APPENDIX - VESA modes supported by DosClip ...............12


Introduction

SuperClip is a clipboard viewer that can save all or part of the
image on the clipboard to a graphics file in BMP, GIF, PCX, or
TIF format.  In Windows, the entire screen can be captured to
the clipboard at any time by pressing the PrtSc key (Shift+PrtSc
on 84-key keyboards), or just the currently active window by
pressing Alt+PrtSc.  Text can also be captured to the Windows
clipboard by pressing PrtSc while a DOS program is running full-
screen in text mode.  SuperClip can save clipboard text to an
ASCII file or to a monochrome graphics file.

                           - 2 -

The SuperClip package includes a utility named DosClip that works
in conjunction with SuperClip to capture to the Windows clipboard
the entire screen from a DOS graphical application that is run-
ning full-screen in a DOS session under Windows.


Installation - Windows 3.1

To install SuperClip into Windows 3.1 from a floppy disk, select
"Run" from the File menu of Program Manager and enter "a:setup"
or "b:setup," depending on which floppy disk drive you are using.
To install SuperClip from a ZIP file, un-ZIP SCLIP300.ZIP onto a
floppy disk and install from the floppy as already described.  Or
you may un-ZIP SCLIP300.ZIP into an empty directory on your hard
disk for temporary storage, then select "Run" from the File menu
of Program Manager and enter the full path to setup.exe.  The
name of the default directory into which setup will install the
SuperClip files is SCLIP, which should not be the name of the
directory you're installing from.  Setup will now create the
program group SuperClip in Program Manager, after which you may
delete the files that were temporarily stored in the installation
directory.

To remove SuperClip from your computer, run setup and select the
"Remove" option.


Installation - Windows 95 and Windows NT

To install SuperClip into Windows 95 or Windows NT from a floppy
disk, select "Run" from the Start menu and enter "a:setup" or
"b:setup," depending on which floppy disk drive you are using.
To install SuperClip from a ZIP file, un-ZIP SCLIP300.ZIP onto a
floppy disk and install from the floppy as already described.  Or
you may un-ZIP SCLIP300.ZIP into an empty directory on your hard
disk for temporary storage, then select "Run" from the Start menu
and enter the full path to setup.exe.  The name of the default
directory into which setup will install the SuperClip files is
SCLIP, which should not be the name of the directory you're in-
stalling from.  Setup will now insert the SuperClip icon into the
Programs folder of the Start menu, after which you may delete the
files that were temporarily stored in the installation directory.

To remove SuperClip from your computer, run setup and select the
"Remove" option.

                           - 3 -

Capturing the Windows Screen

SuperClip was designed to run minimized in "popup" mode, mean-
ing it will pop up when you press the PrtSc key to capture the
entire screen, or Alt+PrtSc to capture the currently active
window.  You can then save the entire image or any rectangular
portion.  To return to the application that was interrupted,
simply click on that application's window or minimize SuperClip
again.  You can turn popup mode off by pressing Ctrl+M, or by
clicking on "Popup" in the Options menu, which will remove the
checkmark next to this menu item.

SuperClip does not need to be running in order to make a screen
capture.  Once you have pressed the PrtSc key, you can run Super-
Clip to display the clipboard.  You can then save the entire
image or crop a rectangular area with the mouse or keyboard
before saving to disk.

To save a captured image to disk, choose the desired format from
the File menu.  A dialog box will list the files of the selected
format in the current directory.  You may select one of the files
listed or type a new file name in the edit box.  You may also
switch to another directory or disk drive.

SuperClip will also display text captured to the clipboard by
pressing the PrtSc key while a DOS character-mode application is
running full-screen under Windows.  Two character sets are avail-
able for the display of text, OEM and ANSI, which may be selected
from the Options menu.  Text can be saved to an ASCII file or to
a monochrome graphics file in BMP, GIF, PCX, or TIF format.

While in popup mode, SuperClip will also pop up when another
application puts onto on the clipboard a bitmap that is compa-
tible with SuperClip.  The compatible formats are DDB (Device-
Dependent Bitmap) and DIB (Device-Independent Bitmap), two
commonly-used bitmap formats.  If you attempt to save a clip-
board bitmap whose format is not one of these two, SuperClip
will respond with a dialog box that says "No bitmap exists on
the clipboard."

Because of the internal complexities of the popup feature,
SuperClip will not allow more than one instance of itself to
run.  Clicking on the SuperClip icon will therefore activate a
currently-running instance if one exists, instead of launching
a new instance.  This property can be put to good use if the
SuperClip window should become hidden by another window; click
its icon in the Start menu to make the SuperClip window visible.

                           - 4 -

Capturing the DOS Screen

SuperClip can capture the screen to the Windows clipboard from
either a text or a graphical mode DOS application that is running
full-screen in a Windows DOS session.  Normally, such captures
are made by pressing the PrtSc key.  However, Windows is not
always able to capture the screen to the clipboard from a DOS
application that is displaying a full-screen graphical image.
In that case, Windows displays the message "Unable to copy screen
contents into clipboard."  When this occurs, you can still make
the capture by activating DosClip, a utility that is included
with SuperClip.

Before you can use DosClip, you must make it memory-resident in
the DOS session before running the DOS graphical application.  To
do this, first start a DOS session by clicking on the MS-DOS icon
in Windows.  At the DOS prompt, type dosclip and press Enter.
The directory in which dosclip.exe resides should be included in
the PATH statement of your autoexec.bat file, otherwise you will
have to type the full path to dosclip.exe before pressing Enter.
Dosclip will now display the message "DosClip is now memory-
resident" on the screen.  The message will also indicate whether
or not the VESA BIOS extension is present, as DosClip needs this
extension to capture SVGA screens.  If the VESA BIOS extension is
not present, you will need to insert a line in autoexec.bat that
runs a utility that installs the VESA BIOS extension in RAM.  See
the documentation for your video card for information about this
utility.  For a list of the VESA modes supported by DosClip, see
the Appendix at the end of this document.

After you make DosClip memory-resident in the DOS session, you
can run your graphical DOS application.  Now, if pressing PrtSc
fails to capture a graphical screen to the Windows clipboard, you
can activate DosClip by pressing Ctrl+PrtSc.  DosClip will signal
you with a series of beeps that it is making the capture.  After
the final beep, you may proceed working in the DOS application
and make additional screen captures.  Screen captures are saved
to a series of sequentially-named temporary files, starting with
DSCLP000.BMP.  You can make up to 256 captures in a series before
the file name cycles from DSCLP255.BMP back to DSCLP000.BMP and
starts overwritng files of the same name.

You can switch back to Windows at any time by pressing Alt+Esc.
Your DOS session will now be running minimized so that you can
return to it.  SuperClip will now open the first temporary file,
place the image it contains onto the clipboard, then delete the
file.  It may be necessary to activate SuperClip by clicking on
its title bar, if it is not the currently active window.  You can
now save the clipboard image or do whatever you want with it.

                           - 5 -

To display the next captured image in the series, press Ctrl+N or
select "Next DOS capture" from the "Display" menu.  After the
last capture is displayed, selecting this menu item will display
the message "No more DOS captures."  You may now return to the
DOS session to make additional captures by clicking on the DOS
session icon on the taskbar.  A new temporary series will begin,
starting at DSCLP000.BMP.

The temporary BMP files are stored in the default WINDOWS\TEMP
directory, unless you specify another directory by setting the
TMP environment variable in autoexec.bat.  The temporary BMP
files created by DosClip are not really useful to any other
application besides SuperClip, as the images are inverted.
SuperClip automatically re-inverts the images before displaying
them.  There is a practical reason for this image inversion;
contact the programmer if you need to know the technical details.

Although DosClip was designed to run in a Windows DOS session, it
is possible to use DosClip on a machine that is running only DOS.
In that case, you should include the following line in the DOS
autoexec.bat file:

set TMP=C:\WINDOWS\TEMP

This will enable SuperClip to find and display the DosClip
temporary BMP files when you start Windows and run SuperClip.


Cropping the Clipboard Image

The SuperClip display window can scroll the clipboard image hori-
zontally and vertically by means of the scroll bars.  To mark a
rectangular area for cropping, move the cursor to the top-left
corner of the desired rectangle, depress the left mouse button,
move the cursor to the lower-right corner and release the button.
Repeat this procedure to erase the rectangle and draw a new one.
The width and height of the rectangle in pixel units will be
displayed in the title bar, as will the x,y coordinates of the
upper-left (UL) and lower-right (LR) corners of the rectangle.
The origin of these coordinates is the upper-left corner of the
clipboard image.

You can use the keyboard to modify or enter rectangle coordi-
nates.  To do this, select "Enter coordinates" from the Options
menu.  The dialog box will allow you to specify the position of
the upper-left corner of the rectangle.  You can specify the
position of the lower-right corner by entering the x and y
coordinates or by entering the width and height.

You may save the cropped image directly to disk by means of the
File menu, or you may capture the rectangle to the clipboard by
pressing Ctrl+R or by selecting "Capture rectangle" from the
Options menu.  To erase the rectangle, press Esc or position the
cursor anywhere on the image and click the left mouse button.

                           - 6 -

File Menu Item: Save as BMP

Select this menu item to save the contents of the clipboard to an
uncompressed Windows Bitmap File with the filename extension BMP.
Monochrome, 16-color, 256-color, and 24-bit TrueColor modes are
supported.


File Menu Item: Save as GIF

Select this menu item to save the contents of the clipboard to a
CompuServe Graphics Interchange Format file with the filename ex-
tension GIF.  This format utilizes LZW compression, and supports
monochrome, 16, and 256-color modes.  GIF does not support 24-bit
TrueColor modes.


File Menu Item: Save as PCX

Select this menu item to save the contents of the clipboard to
a PC Paintbrush file with the filename extension PCX.  Mono-
chrome, 16-color, 256-color, and 24-bit TrueColor modes are
supported.


File Menu Item: Save as TIF

Select this menu item to save the contents of the clipboard to
a Tagged Image Format file with the extension TIF.  Three com-
pression modes are available: LZW, PackBits, and no compression,
any one of which may be selected from the Options menu.  The
defaults are LZW for 24-bit TrueColor images, and PackBits for
monochrome and palette color images.


File Menu Item: Save as TXT

Select this menu item to save clipboard text to an ASCII text
file.  Two character sets are available.  The OEM character set
is the DOS-compatible IBM extended ASCII character set.  The ANSI
character set is the one used by Windows.  If you save text to a
file that already exists, the text will be appended to the file.


File Menu Item: Open BMP

Select this item from the File menu to open a BMP file and place
it onto the clipboard.  The image can now be saved in any of the
four available formats, or cropped and then saved.

                           - 7 -

Main Menu Item: Display

This pull-down menu allows you to select which of the available
clipboard formats to display.  Normally, Windows will clear the
clipboard when the PrtSc key is pressed.  However, applications
can place a bitmap or text on the clipboard without first clear-
ing it, so that text and graphics can coexist.  This is the case
when you select Open BMP.  By default, SuperClip will display
the format most recently added to the clipboard.


Main Menu Item: Options
Eleven options are available:

Capture rectangle (Ctrl+R)
  Select this menu item to capture the current rectangle to the
  clipboard.  You must first draw a rectangle with the mouse or
  by entering coordinates from the keyboard.

Clear clipboard (Ctrl+L)
  Select this menu item to empty the clipboard.

Enter coordinates (Ctrl+E)
  Select this menu item to modify or draw a rectangle by entering
  its coordinates from the keyboard.  The values that appear in
  the dialog box are those of the current rectangle, if one has
  been previously entered or drawn with the mouse.  If there is
  no current rectangle, the values default to a rectangle that
  contains the entire client area of the SuperClip window.  Co-
  ordinates may be entered that exceed the boundaries of this
  client area, and may include the entire image on the clipboard,
  up to a full screen.

  The origin of the rectangle coordinates is the upper-left
  corner of the clipboard image.  To erase the rectangle, press
  Esc or click the left mouse button.

Invert colors (Ctrl+I)
  Select this menu item to invert the colors of the image on the
  clipboard, creating a negative image.  The original colors can
  be restored by selecting this menu item again.

Popup mode (Ctrl+M)
  This is the default mode of SuperClip.  When minimized or
  hidden by another window, SuperClip will pop up onto the screen
  whenever a bitmap image or text is put onto the clipboard.
  Select this menu item to turn popup mode off or back on again.

Reverse x-axis (Ctrl+X)
  Select this menu item to reverse the horizontal axis of the
  clipboard image.  This will result in a mirror image.

                           - 8 -

Reverse y-axis (Ctrl+Y)
  Select this menu item to reverse the vertical axis of the
  clipboard image.  The effect is the same as flipping a trans-
  parency over, top-to-bottom, and viewing it from the back.
  To simulate the effect of turning an image upside-down, it
  is necessary to reverse both the x and y axes.

Stretch bitmap (Ctrl+S)
  Select this menu item to stretch or compress the clipboard
  image along the horizontal and/or vertical axes.  Dimension
  limits are 1280 pixels horizontally by 1024 pixels vertically.

Text colors.
  This menu item allows you to choose the displayed colors of
  clipboard text.  The choices are black-on-white (the default)
  and white-on-black.

Text to bitmap (Ctrl+B)
  Select this menu item to convert clipboard text to a monochrome
  bitmap image, so that it can be subjected to any of the trans-
  formation options and/or saved to disk in one of the graphical
  formats.

TIF compression
  This menu item allows you to select the compression scheme
  for TIF files.  The choices are no compression, PackBits, and
  LZW (Lempel, Ziv, & Welch).  In the Windows 95/NT version of
  SuperClip, two modes of LZW compression are available: LZW 8k
  and LZW 16k.  The k refers to the number of kilobytes of raw
  pixel data compressed into each strip.  The conventional strip
  size in TIF files is 8k, but 16k yields better compression.
  The defaults are LZW 8k for 24-bit True-Color images, and Pack-
  Bits for monochrome and palette color images.


Main Menu Item: Print

  Select this menu item to send clipboard text or graphics to the
  printer.  Before printing begins, Windows will first present a
  dialog box that will allow you to select various options, such
  as resolution and intensity, then SuperClip will present a dia-
  log box that will allow you to position the image on the page
  and stretch or compress it vertically and/or horizontally.


Help Menu

Online Help is available to explain the features of SuperClip,
and includes a glossary of terms used in this document.

Select "System info" from the Help menu to display the resolution
and color capability of the Windows screen driver currently run-
ning on your system.

                           - 9 -

Registration

SuperClip (tm) for Windows, Shareware Edition, Version 3.15
Copyright 1994-96 AndroSoft (tm).  All Rights Reserved.

The Professional Edition of SuperClip does not superimpose any
shareware notice or logo on saved or printed images.

To register and receive the Professional Edition, send $40 by
check or money order to:

                      AndroSoft
                      125 N. Prospect St.
                      Washington NJ 07882
                      U.S.A.

NJ residents please include sales tax.

Steven A. Brown, Programmer
E-mail: [e-mail]
Fax   : [phone]

AndroSoft is a growing business and it may become necessary in
the future for us to relocate.  Our postal address, fax and tele-
phone numbers may change, but our e-mail address will stay the
same.  You will therefore still be able to contact us by e-mail,
even though attempts to contact us by other means fail.


CREDIT CARD ORDERS

You may fax or e-mail your order with your name, address, VISA,
MasterCard, or American Express account number, and expiration
date.  Please include your signature on fax orders, and specify
one of the following methods of delivery:

1.  First-class mail on 3.5" disk.

2.  SCLIP-PE.ZIP e-mailed to a CompuServe address.

3.  SCLIP-PE.ZIP e-mailed to an America Online address.

4.  SCLIP-PE.ZIP e-mailed to an Internet address (requires
    Eudora or a MIME decoder to recover ZIP file).

5.  SCLIP-PE.UUE e-mailed to an Internet address (requires
    UUDECODE.EXE utility to recover ZIP file).

The total amount charged to your credit card will be $40.00.
Orders may also be placed by telephone to [phone].

                           - 10 -

SITE LICENSING

A site license for additional workstations is available for the
very reasonable fee of $10 for each additional pc or workstation.
To obtain a site license, fill out and submit with payment the
Order Form in the text file order.frm.


SHAREWARE NOTICE

The Shareware Edition of SuperClip is freely distributed.  You
may use it over a ten-day period to determine its suitability for
your needs.  To continue using SuperClip beyond this evaluation
period, you will be required to purchase the registered Profes-
sional Edition.

Registration fees are the only compensation the programmer re-
ceives for the work and expense of writing this program.  Please
support the shareware concept of quality, "try-before-you-buy"
software.  Registered users are entitled to unlimited technical
support and low-cost upgrades.


DISCLAIMER OF WARRANTY

THIS SOFTWARE IS SOLD "AS IS," WITHOUT WARRANTY AS TO PERFORMANCE
OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR
IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRON-
MENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS
FOR A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING PRO-
CEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-
CRITICAL DATA BEFORE RELYING ON IT.  THE USER MUST ASSUME THE
ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER
WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
PURCHASE PRICE.

                           - 11 -

LZW LICENSE NOTICE

Use of this software is permitted only to the extent reasonably
required to determine whether to purchase the software.

After payment is made, use of this software is limited to use on
only a single personal computer or workstation which is not used
as a server.  An additional payment of $10 is required for each
use on another personal computer or workstation.

Only a single copy may be made of this software solely for backup
or archival purposes.  The software may also be transferred to a
single hard disk.

Any use of this software in violation of the above is not
licensed.

For information concerning licensing the LZW compression and/or
decompression capability, please contact:

          Unisys Corporation
          Welch Licensing Department - C1SW19
          Township Line & Union Meeting Roads
          P.O. Box 500
          Blue Bell, Pennsylvania 19424

Graphics Interchange Format and GIF are service marks of
CompuServe Incorporated.


AndroSoft Home Page

The current version of SuperClip Shareware Edition is always
available for download from the AndroSoft Home Page on the World
Wide Web.  The URL is

http://ourworld.compuserve.com/homepages/andromeda


Support for SuperClip on the CompuServe Information Service

The Shareware Edition of SuperClip can be found in the WINSHARE
Forum on CompuServe, an official distribution and support online
resource for future updates. Search for SCLIP.ZIP.

The Windows Users Group Network [WUGNET], operators of the oldest
and largest independent support resource forum [WINUSER] for
Windows users on CIS with over 1,000,000 active members is
recognized by the press, user groups, developers, and Microsoft
as the foremost resource for shareware publishers on CompuServe
and the Internet.

                           - 12 -

APPENDIX - VESA modes supported by DosClip

In addition to the standard VGA modes, the following VESA SVGA
graphical screen modes are supported by DosClip:

MODE     PIXEL RESOLUTION    NUMBER OF COLORS

100h      640 x  400                256
101h      640 x  480                256
102h      800 x  600                 16
103h      800 x  600                256
104h     1024 x  768                 16
105h     1024 x  768                256
106h     1280 x 1024                 16
107h     1280 x 1024                256
10Fh      320 x  200         16,777,200
112h      640 x  480         16,777,200
115h      800 x  600         16,777,200
118h     1024 x  768         16,777,200
11Bh     1280 x 1024         16,777,200

                           #  #  #