home *** CD-ROM | disk | FTP | other *** search
/ 1st Canadian Shareware Disc / 1st_Canadian_Shareware_Disc_1991.ISO / graphics / tiffany / readme.txt next >
Text File  |  1989-01-04  |  19KB  |  396 lines
  1.  
  2.  
  3.           ________________________________________________________________
  4.           |                                                              |
  5.           |                                                              |
  6.           |                           TIFFANY                            |
  7.           |                                                              |
  8.           |                                                              |
  9.           |                         User Manual                          |
  10.           |                                                              |
  11.           |                         Version 1.0                          |
  12.           |                                                              |
  13.           |                                                              |
  14.           |              Copyright (c) 1989, Alan Anderson               |                           |
  15.           |                                                              |
  16.           |                                                              |
  17.           |______________________________________________________________|
  18.            
  19.  
  20.  
  21.                                   1. INTRODUCTION
  22.  
  23.            Tiffany records any part, or all, of the Windows display
  24.            using the "Tag Image File Format" (TIFF).  The image file can
  25.            then be used in a variety of desktop publishing or image
  26.            manipulation applications.
  27.  
  28.            TIFF, the Tag Image File Format, is a versatile file standard
  29.            for recording and transferring raster images.  Many image
  30.            manipulation programs, desktop publication systems, and
  31.            scanners support this popular image file format.
  32.  
  33.            As the Windows operating environment is utilized by more
  34.            applications and people, the need to capture screen images
  35.            for use in other programs becomes increasingly important.
  36.            This is especially critical for software developers, who
  37.            require screen images in their product documentation.  There
  38.            are utilities to copy screen bitmaps to the windows
  39.            clipboard.  Unfortunately due the large memory requirements
  40.            for storing a sizeable bitmap image, these RAM hungry
  41.            utilities are often unable to capture large portions of
  42.            today's high resolution screen images.  Also, these "bitmap
  43.            clippers" are useless for transferring images to non-Windows
  44.            environments.
  45.  
  46.  
  47.                               2. PRODUCT REGISTRATION
  48.  
  49.            Tiffany is distributed as shareware.  Feel free to look over
  50.            the Tiffany software and determine if it is useful for you or
  51.            your organization.  If you do use Tiffany please send a $10
  52.            registration/license fee to help support its struggling
  53.            author and his continuing quest to produce high-quality, low-
  54.            cost software.  Please include your name and address if you
  55.            wish to be informed when future versions of Tiffany become
  56.            available.  Send your registration fee, suggestions, and
  57.            comments to:
  58.                Alan Anderson
  59.                Suite #408
  60.                3511 Camino Del Rio South
  61.                San Diego, CA 92108
  62.  
  63.            For a 5.25" disk containing the Tiffany executable files,
  64.            source code, and printed documemtation send $20 to the above
  65.            address.
  66.  
  67.  
  68.                         3. USING TIFFANY: A QUICK OVERVIEW
  69.  
  70.            1.  Copy TIFFANY.EXE and TIFFLIB.EXE to your working disk.
  71.  
  72.            2.  Start Windows and run TIFFANY.EXE.
  73.  
  74.            3.  Select the File Name command from the File menu.  Type a
  75.                name for the image file into the dialog box and press
  76.                <Enter>.
  77.  
  78.            4.  Using the Region menu, specify the area of the display
  79.                you want to capture.
  80.  
  81.            5.  Note the activation (hot) key selected in the Activation
  82.                menu.
  83.  
  84.            6.  Get the Tiffany window out of your way by shrinking it
  85.                down to an icon with the Minimize command.
  86.  
  87.            7.  Bring the desired image on the screen.
  88.  
  89.            8.  Press the activation key to begin creating the TIFF file.
  90.                The cursor changes to an hourglass,  wait while the file
  91.                is being created.
  92.  
  93.            9.  When all of the sand has flowed into the bottom chamber
  94.                of the hourglass, a message box appears to indicate
  95.                completion of the image capture.  Press <Enter> to close
  96.                the dialog box and continue using windows.
  97.  
  98.  
  99.                               4. SYSTEM REQUIREMENTS
  100.  
  101.            An IBM PC, XT, AT, or PS2 compatible computer running
  102.            Microsoft Windows (version 2.0 or later) is required to use
  103.            Tiffany.  A hard disk is strongly recommended.   Images from
  104.            any graphics card supported by a Windows screen driver can be
  105.            captured by Tiffany.
  106.  
  107.  
  108.                            5. USING TIFFANY: THE DETAILS
  109.  
  110.  
  111.            5.1 STARTING TIFFANY
  112.  
  113.            Two files are required to run Tiffany: TIFFANY.EXE and
  114.            TIFFLIB.EXE.  Copy these files to your windows drive and
  115.            directory.  TIFFANY.EXE is the main program file; TIFFLIB.EXE
  116.            contains library routines used by Tiffany.  Run Tiffany like
  117.            most Windows applications.  Start Microsoft Windows.  Using
  118.            the MS-DOS Executive window change to the drive and directory
  119.            holding the files TIFFANY.EXE and TIFFLIB.EXE.   Use the
  120.            direction keys to highlight TIFFANY.EXE and press <Enter>;
  121.            or, with the mouse double click on TIFFANY.EXE.
  122.  
  123.  
  124.            5.2 MENUS
  125.  
  126.            The Tiffany menu bar contains five drop-down menus: File,
  127.            Activation, Region, GrayLevels, and Effects.
  128.  
  129.            5.2.1 File Menu
  130.  
  131.            The File menu contains two commands: File Name and About.
  132.            File Name displays a dialog box allowing you to specify the
  133.            file name for storing the next image.  The file extension
  134.            .TIF indicates a TIFF raster image file.  Specify a file name
  135.            before capturing an image file.  If an existing file name is
  136.            specified the old file will be overwritten by the TIFF
  137.            capture process.
  138.  
  139.            The About command displays a dialog box with program version,
  140.            copyright, and registration information.
  141.  
  142.            5.2.2 Activation Menu
  143.  
  144.            The Activation menu lets you choose one of six keys for
  145.            initiating the TIFF screen capture (activation keys are also
  146.            known as "hot" keys).  Select a key that you will not need
  147.            while using your other windows applications.  The default key
  148.            is <F3>.  A checkmark is displayed next to the current
  149.            setting.  If you want to capture an image containing a drop-
  150.            down menu do not select an Activation key that uses <Alt> in
  151.            conjunction with another key, because pressing <Alt> will
  152.            cause an open menu to close!
  153.  
  154.            Selecting Off from the Activation menu will disable TIFF
  155.            screen capture without closing the Tiffany window.
  156.  
  157.            5.2.3 Region Menu
  158.  
  159.            The Region menu contains four choices for specifying which
  160.            area of the screen is to be captured when the activation key
  161.            is pressed.  A checkmark is displayed next to the current
  162.            setting.  Before creating an image file select the
  163.            appropriate area.  Since the length of time required to
  164.            create an image file is proportional to the image area, avoid
  165.            capturing any unneeded parts of the screen by choosing the
  166.            correct setting from the Region menu.
  167.  
  168.            Active Window is the entire window of the application being
  169.            used.
  170.  
  171.            Active Client Window is the part of the current application
  172.            window below the menu bar.
  173.  
  174.            Entire Screen is the whole display.
  175.  
  176.            Box allows you to specify a rectangular screen area of the
  177.            screen to be captured with the mouse.  When you select the
  178.            Box command the cursor changes into a crosshair (+).  Move
  179.            the center of the crosshair to one corner of the rectangle to
  180.            be captured and depress the left mouse button.  With the
  181.            mouse button depressed, drag the crosshair cursor to the
  182.            opposite corner of the rectangle to be captured.  Release the
  183.            mouse button;  the cursor returns to its normal shape.  As
  184.            the mouse is being used to specify the capture box, this
  185.            rectangular region is inverted.  Tiffany remembers the box
  186.            and will capture this rectangular section of the display when
  187.            the activation key is pressed.
  188.  
  189.            5.2.4 GrayLevels Menu
  190.  
  191.            The GrayLevels menu lists four options for specifying the
  192.            number of bits to be used for each pixel in the TIFF.  The
  193.            appropriate setting for capturing all possible shades that
  194.            can be produced by you video system is automatically set when
  195.            Tiffany is started.  However you may change this setting to
  196.            meet your own needs.
  197.  
  198.            Many PC systems have color video cards and displays;  yet,
  199.            the vast majority of printers utilized by PC systems cannot
  200.            create colored printouts.  This poses a problem for screen
  201.            capture programs:  should the captured image be colored or
  202.            gray-scale?  Since most TIFF images are ultimately to be
  203.            printed out on non-color printers,  Tiffany was designed to
  204.            convert all screen images to TIFF gray-scales.  The number of
  205.            possible levels of gray can be chosen from the GrayLevels
  206.            menu.
  207.  
  208.            One bit per pixel can create an image with only two levels,
  209.            black and white.
  210.  
  211.            Two bits per pixel can create an image with four levels:
  212.            black, dark gray, light gray, and white.
  213.  
  214.            Four bits per pixel can create an image with up to 16 gray
  215.            levels.
  216.  
  217.            Eight bits per pixel can create an image with up to 256 gray
  218.            levels.
  219.  
  220.            There is no reason to select a gray level setting higher than
  221.            the default set by Tiffany.  If you display system is only
  222.            capable of producing 16 different colors/shades, you will not
  223.            get a better image by specifying a 8 bit gray scale.
  224.            Selecting a gray level setting lower than the default set by
  225.            Tiffany may result in the lose of some screen information,
  226.            but it will decrease the size of the image file.
  227.  
  228.            5.2.5 Effects Menu
  229.  
  230.            The Effects menu contains commands for adding special effects
  231.            to the image file.  In the current version of Tiffany the
  232.            Effect menu contains only one item:  Invert.  Selecting
  233.            Invert causes a negative TIFF image being saved.  The invert
  234.            command is a toggle; a checkmark is displayed beside this
  235.            menu items when image inversion is turned on.  To change back
  236.            to a normal (positive) image choose the command once again.
  237.  
  238.  
  239.            5.3 CAPTURING AN IMAGE
  240.  
  241.            After setting the desired options from the menus, get the
  242.            Tiffany window out of your way by shrinking it down to an
  243.            icon with the Minimize command.  If you are capturing the
  244.            entire screen and do not want the Tiffany icon to appear in
  245.            your image, hide Tiffany underneath another window.  After
  246.            setting up the desired screen image press the activation key.
  247.            The cursor changes to an hourglass, and Tiffany begins
  248.            creating the image file.  You can estimate the progress of
  249.            the TIFF save by watching the amount of sand in the two
  250.            chambers of the hourglass cursor.  Wait while the file is
  251.            being created.  When all of the sand has flowed into the
  252.            bottom chamber of the hourglass, a beep sounds and a message
  253.            box appears to indicate completion of the image capture.
  254.            Press <Enter> to close the message box and continue using
  255.            windows.
  256.  
  257.            If you want to recapture to the same file name, press the
  258.            activation key again; the old file contents will be
  259.            overwritten.  To create another TIFF file, use the File Name
  260.            command to specify a new file name before pressing the
  261.            activation key.
  262.  
  263.  
  264.            5.4 QUITTING TIFFANY
  265.  
  266.            Select Close from the control menu to deactivate Tiffany and
  267.            close the Tiffany window.
  268.  
  269.  
  270.                                 6. IMAGE FILE SIZE
  271.  
  272.            Image files created by Tiffany can be very large.
  273.            Fortunately the TIFF data in can be compressed to much
  274.            smaller sizes with most file archive utilities.  Most TIFF
  275.            files can be compressed 90 to 95 percent using PKPAK program
  276.            by PKWARE.
  277.  
  278.  
  279.                                     7. ARCHIVES
  280.  
  281.            The archive file TIFFANY.ARC contains the executable files
  282.            (TIFFANY.EXE and TIFFLIB.EXE) and the documentation for
  283.            Tiffany (README.TXT).  The archive file TIFFANYS.ARC contains
  284.            the source code for Tiffany in addition to the executable
  285.            files and the documentation.
  286.  
  287.  
  288.                               8. TIFFANY SOURCE CODE
  289.  
  290.            The Tiffany program is documented with detailed comments in
  291.            the source code.  An brief overview of the program is given
  292.            below.
  293.  
  294.            Tiffany is a small model Windows application written in
  295.            Microsoft C, version 5.1.  The Windows software development
  296.            kit version 2.1 and a Microsoft Macro Assembler version 5 are
  297.            also required to create Tiffany.  The Tiffany application
  298.            requires two executable modules: TIFFANY.EXE and TIFFLIB.EXE.
  299.  
  300.            TIFFANY.EXE is the main program file.  It contains all of the
  301.            program functions other than the activation (hot) key
  302.            detection routines.  Two files TIFFMAIN.C and TIFFCAP.C
  303.            contain the C source code for this module.
  304.  
  305.            TIFFLIB.EXE is the dyna-link library used by Tiffany.  The
  306.            library contains activation key detection functions.  Tiffany
  307.            uses a keyboard hook to watch for the activation key.  In
  308.            order for hook functions to work properly on EMS systems they
  309.            need to be contained in a dyna-link library module.  TIFFLIB
  310.            exports one function to be used by the main module:
  311.  
  312.            SetHotKey(WORD vkNewHotKey, BOOL bAltPressRqd, HWND hWnd);
  313.  
  314.            The window specified during the SetHotKey call is sent a
  315.            message when the specified Hot key is pressed.  The library
  316.            code is very generic; it is an excellent foundation for any
  317.            Windows program requiring a hot key.
  318.  
  319.            In a "normal" Windows development environment the following
  320.            commands will create the TIFFANY executable files:
  321.                MAKE TIFFANY<Enter>
  322.                MAKE TIFFLIB<Enter>
  323.  
  324.            The following four files are used to create the library
  325.            module (TIFFLIB.EXE):
  326.  
  327.            TIFFLIB.        Library MAKE file.
  328.            TIFFLIB.DEF     Module definition file.
  329.            TIFFLIB.C       C source code for the library.
  330.            TIFFINIT.ASM    Assembly code that starts the library.
  331.            
  332.  
  333.            The following seven program files and 14 cursor files are
  334.            used to create the main program module (TIFFANY.EXE):
  335.  
  336.            TIFFANY.        Main program MAKE file.
  337.            TIFFMAIN.C      C source code for initialization and message
  338.                            polling & processing functions.
  339.            TIFFCAP.C       C source code for TIFF capture routines.
  340.            TIFFANY.DEF     Module definition file.
  341.            TIFFANY.H       Header file with global definitions.
  342.            TIFFANY.RC      Resource definition file.
  343.            TIFFANY.ICO     The icon resource.
  344.            XHAIR.CUR       The crosshair cursor resource.
  345.            HG0.CUR to HG12.CUR  Cursors for the dynamic hourglass display.
  346.  
  347.            For more information about the Tiffany program see the source
  348.            code comments.
  349.  
  350.  
  351.                              9. BUREAUCRATIC NONSENSE
  352.  
  353.  
  354.            9.1 LICENSE AGREEMENT AND DISCLAIMERS
  355.  
  356.            Take a moment to read the following software license
  357.            agreement and disclaimer.
  358.  
  359.            This software is protected by United States copyright law and
  360.            international treaties.  A limited license is granted to all
  361.            users of Tiffany to make copies of and distribute the archive
  362.            files, TIFFANY.ARC or TIFFANYS.ARC, if the following
  363.            conditions are meet:
  364.  
  365.            1.  The files/documentation/programs may not be distributed
  366.                in modified form.  The license agreements, disclaimers,
  367.                shareware information, and copyright notices must be
  368.                distributed with Tiffany in unaltered form.
  369.  
  370.            2.  No fee, or other consideration, can be charged for
  371.                copying or distributing any or all or Tiffany, without
  372.                the express written consent of Alan Anderson.
  373.  
  374.            3.  All software files and documentation may be may be copied
  375.                for archival purposes only.
  376.  
  377.            The author of Tiffany provide no warranties, expressed or
  378.            implied, about the functionality, usability, or suitability
  379.            of this software for any purpose.  Furthermore, the author of
  380.            Tiffany is not liable for any damages that may result from
  381.            its use, or for problems resulting from the use of software
  382.            that utilizes all or part of the Tiffany source code.
  383.  
  384.            No part of this publication or the Tiffany software, may be
  385.            reproduced or transmitted, except as outlined above, by any
  386.            means without the prior written consent of and Alan Anderson.
  387.  
  388.  
  389.            9.2 ACKNOWLEDGEMENTS
  390.  
  391.            Microsoft is a registered trademark of Microsoft Corporation.
  392.  
  393.            IBM and IBM AT are registered trademarks of International
  394.            Business Machines Corporation.
  395.  
  396.