home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / graphics / pcxdump.zip / PCXLAB.DOC < prev    next >
Text File  |  1993-05-15  |  17KB  |  354 lines

  1.  
  2.                             PCXLAB 1.03
  3.  
  4.                     Copyright (c) Jesper Frandsen
  5.  
  6.                            May 15th, 1993
  7.  
  8.                   =================================
  9.  
  10.  
  11.  
  12.   DISCLAIMER
  13.   ----------
  14.   This product is distributed AS IS. The author specifically disclaims all
  15.   warranties, expressed or implied, including, but not limited to, implied
  16.   warranties of merchantability and fitness for a particular purpose with
  17.   respect to defects in the diskette and documentation, and program license
  18.   granted herein, in particular, and without limiting operation of the
  19.   program license with respect to any particular application use or purpose.
  20.   In no event shall the author be liable for any loss of profit or any other
  21.   commercial damage including but not limited to special, incidental,
  22.   consequential or other damages.
  23.  
  24.  
  25.   LICENSING AGREEMENT
  26.   -------------------
  27.   PCXLAB is copyrighted software and all rights are reserved. PCXLAB may
  28.   not be changed or modified in any way except by the author. PCXLAB is
  29.   part of the PCXDUMP system. The PCXDUMP system is SHAREWARE and may be
  30.   freely distributed as long as it remains in its complete form with all
  31.   support and documentation files. It may be used for a 10 day free trial
  32.   period. Regardless of how the copy is obtained, it is requested that all
  33.   users comply with the following licensing and registration provisions if
  34.   they continue to use it after the 10 day trial period. Should you find
  35.   this program useful, you must register it; you will then be provided with
  36.   the latest releases of the PCXDUMP system.
  37.  
  38.  
  39.   OVERVIEW OF PCXLAB
  40.   -------------------
  41.   * It can be used on any color EGA, VGA or SVGA display card (except
  42.     EGA mono).
  43.  
  44.   * It can show any 2, 16, 256 and 16.7 million (24 bit) color PCX file
  45.     in both 16 and 256 color modes. However viewing real 256-color and
  46.     24 bit pictures in 16 color will only give you a hint of the picture.
  47.     Viewing 24 bit pictures in 256 color is acceptable.
  48.     If the images displayed is bigger than the current resolution you can
  49.     scroll the images around FAST with the arrowkeys and PgDn & PgUp. You
  50.     can also change resolution with '+' or '-'.
  51.  
  52.   * It detects these SuperVGA card and uses their HiRes modes in 16 or
  53.     256 colors:
  54.     ATI-VGA, Trident, Genoa, Paradise, Tseng 3000, Tseng 4000, MXIC, Realtek
  55.     OAK-37, OAK-67, OAK-77, Video7, Ahead A/B, Chips & Tech 451/452/453 and
  56.     VESA compatible cards.
  57.  
  58.   * On HiColor or TrueColor cards, you can view 24 bit colors PCX files in
  59.     32768 colors or 16.7 million colors (TrueColor card needed for this).
  60.     PCXLAB will use the HiColor extensions on these cards:
  61.     Tseng ET 4000, Paradise, Realtek, OAK-77, Trident, ATI, VESA.
  62.     With the proper VESA-driver, you will be able to show images in
  63.     16.7 million colors (if supported by videoadapter).
  64.  
  65.   * It has a neat file browser, so you can walk through your whole harddisk
  66.     without leaving PCXLAB. There is a limit of 2000 PCX-files per
  67.     directory (you are not likely to hit this limit!). You simply use the
  68.     cursor arrows or PgUp or PgDn to select the file you want to see. Press
  69.     Enter to view file.
  70.  
  71.   * The PCX-files must be no larger that 3800 pixels wide, which should be
  72.     more than enough.
  73.  
  74.   * You can easily set up a slideshow by tagging a number of files and then
  75.     hitting F8 (to start the slideshow). You must tag at least 2 files to
  76.     have a slideshow.
  77.  
  78.   * PCXLAB will detect which video modes your videocard can use, and you
  79.     can easily switch between these modes by pressing F2 (or + & -).
  80.  
  81.   * It is FAST! PCXLAB is written in a high level language and assembler
  82.     for all the screen and unpacking operations.
  83.     Compared with the great shareware fileviewer VPIC (which can show a large
  84.     number of formats, not only PCX), PCXLAB is 30%-700% faster with an
  85.     average about 2 times faster as VPIC!
  86.  
  87.   * Converts PCX-files to other fileformats: Postscript, Windows BMP, Amiga LBM
  88.     TIFF, Targa TGA, Wordperfect WPG.
  89.  
  90.   * Manipulate PCX-files:
  91.     1) Convert color files to monochrome with Floyd/Steinberg or Burkes
  92.        dithering.
  93.     2) Reduces 256 or 16.7 million color PCX-files to 16 or 256 colors.
  94.     3) Converts color PCX-files to gray scaled PCX-files.
  95.  
  96.   * Shows both PCX-files and ANS-files (ANSI text files)
  97.  
  98.   * Shows images from command line.
  99.  
  100.  
  101.   USAGE
  102.   -----
  103.   USAGE: PCXLAB [/CHIPSET=number] [/AUTO] [/SKIPVESA] [file1 [file2] ...]
  104.  
  105.        If one or more arguments are valid filenames on PCX- or ANS-files,
  106.        these will be showed. Otherwise the PCXLAB will start as usually.
  107.  
  108.        If PCXLAB somehow fails to recognize your video adapter that you
  109.        know is on the list below, you can force PCXLAB to use it with the
  110.        /CHIPSET switch.
  111.        The number must be in the range 2-23:
  112.  
  113.           Number  Chipset              Number    Chipset
  114.           ----------------------       -------------------
  115.               0   UNSUPPORTED              12    OAK-67
  116.               1   RESERVED                 13    Video 7
  117.               2   EGA card                 14    Ahead A
  118.               3   VGA card                 15    Ahead B
  119.               4   ATI Wonder               16    Chips & Technology 451
  120.               5   Trident                  17    Chips & Technology 452
  121.               6   Genoa                    18    Chips & Technology 453
  122.               7   Paradise                 19    VESA
  123.               8   Tseng ET 3000            20    Tseng ET 4000 TrueColor
  124.               9   Tseng ET 4000            21    OAK-77
  125.              10   Tseng ET 4000 HiColor    22    MXIC
  126.              11   OAK-37                   23    Realtek
  127.  
  128.        By forcing PCXLAB to use your adapter you will not be able to use
  129.        your videocards HiColor extension (if it has any)!
  130.  
  131.        If you invoke PCXLAB with argument /AUTO, PCXLAB goes to AUTO,
  132.        which automatically selects a resolution which will display the
  133.        whole picture.
  134.  
  135.        When PCXLAB tries to identify your video card it will always
  136.        treat your video card as a VESA card if you have a VESA-driver
  137.        installed because the very first thing PCXLAB checks, is the
  138.        presence of a VESA-driver. If you install PCXLAB with the
  139.        /SKIPVESA option no check for a VESA-driver is performed.
  140.  
  141.  
  142.  
  143.  
  144.   FILE CONVERSION - F3
  145.   --------------------
  146.        WPG FILES - MAXIMUM BITS: 8 (OR MAYBE 4)
  147.        ----------------------------------------
  148.        These are the native import graphic files for WordPerfect. These
  149.        files can contain both bitmaps and line art, or vector graphics.
  150.        PCXLAB will only generate the bitmapped part of them.
  151.        PCXLAB will deal with WPG files having one, four or eight bits of
  152.        color information, that is, monochrome files, sixteen-color files
  153.        and 256-color files.
  154.        The WPG specification allows for 256-color files. As of this writing,
  155.        WordPerfect itself would not read them. If you wish to use 256-color
  156.        images in a WordPerfect document, you might want to either reduce
  157.        them to sixteen colors or dither them to monochrome, depending upon
  158.        what you will be outputting them to.
  159.  
  160.        BMP FILES - MAXIMUM BITS: 24
  161.        ----------------------------
  162.        These are the files which are used as "wallpaper" under Windows
  163.        3. They can be created using the version of PC Paintbrush
  164.        supplied with Windows.
  165.        BMP files use no image compression, as the intention appears to
  166.        be to make them fast to load. Plan on your BMP files being very
  167.        large.
  168.        There is a very important aspect of color BMP files which you
  169.        should bear in mind when you use this format. Windows uses a
  170.        fixed palette which Windows Paint cannot go about changing, as
  171.        doing so would make the screen and border colors change too.
  172.        This means that transferring an image to the BMP format will
  173.        generally result in some color shifts when BMP files are
  174.        imported into Windows applications.
  175.        The BMP format can support 24-bit files, which PCXLAB does
  176.        generate. However, as of this writing importing a 24-bit BMP image
  177.        into Windows Paint results in a noticeable color shift.
  178.        This appears to be a peculiarity of Windows Paint.
  179.  
  180.        EPS FILES - MAXIMUM BITS: 8
  181.        ---------------------------
  182.        The EPS format... encapsulated PostScript... is not really a
  183.        bitmapped format at all. However, it may contain bitmapped data.
  184.        PostScript cannot be interpreted directly by most PC
  185.        applications. As such, an EPS file which is to be imported into
  186.        an application such as Ventura Publisher or PageMaker also
  187.        includes a "preview". A preview is a small black and white TIFF
  188.        image which will show you a rough idea of what the EPS file will
  189.        look like. PCXLAB will not generate a preview.
  190.        If you import an EPS file into Ventura, for example, the screen
  191.        image you see will be the preview but the data printed to your
  192.        printer will be the PostScript data itself.
  193.        PCXLAB can transform PCX-files with between 1 and 24 bits of
  194.        color information... between two and 16.7 million colors...
  195.        into EPS files. Images with more than two colors will be turned
  196.        into PostScript halftones.
  197.        Please note that the EPS files which PCXLAB creates are only
  198.        intended to be printed. You cannot read them into applications
  199.        such as Corel Draw or Adobe Illustrator. These applications
  200.        will not accept the large mounts of bitmapped data which a
  201.        PCXLAB EPS file contains.
  202.        For the most part, using EPS files in this way is no longer
  203.        necessary. Applications which import EPS files will usually allow
  204.        you to import TIFF files as well, which will provide you with
  205.        much better halftoning and screen control.
  206.  
  207.        TIFF FILES - MAXIMUM BITS: 24
  208.        -----------------------------
  209.        PCXLAB generates 1, 4, 8 or 24 bit TIFF files.
  210.        Color TIFF files are useful in Corel Draw, among other places.
  211.        Corel Draw 3.0 will import color TIFF files for inclusion in
  212.        CDR graphics.
  213.        Due to the complicated nature of TIFF-files PCXLAB will only
  214.        dump uncompressed TIFF. This will allow almost any TIFF-reader
  215.        to read the files generated by PCXLAB without choking.
  216.  
  217.        IFF/LBM FILES - MAXIMUM BITS: 24
  218.        --------------------------------
  219.        These started out on the Amiga. The IFF file standard is
  220.        extremely flexible, and allows all sorts of things besides
  221.        images to be stored in IFF files. IFF files are found on the PC
  222.        having been ported from Amiga systems. They are also created on
  223.        the PC by several applications such as Electronic Arts' Deluxe
  224.        Paint package and Digital Vision's Computer Eyes video scanner
  225.        board. In the first case they are given the extension LBM. In
  226.        the second they are given the extension CE. The basic file
  227.        structure is the same, however.
  228.        The standard form for IFF image files is called ILBM,
  229.        compressing all images as planes. This is much slower, but it
  230.        means that files thus compressed will be readable by pretty well
  231.        all IFF readers... even if you port them back to the Amiga. This
  232.        is how PCXLAB creates IFF files. Unfortunately, there is a problem
  233.        with old versions of Deluxe Paint which will occasionally cause
  234.        them to stop reading one of these files part way through the image.
  235.        This happens to IFF files from sources other than PCXLAB, so it is
  236.        probably a bug in these versions of Deluxe Paint.
  237.  
  238.        TGA FILES - MAXIMUM BITS: 24
  239.        ----------------------------
  240.        The Truevision Targa format is used by several high end paint
  241.        programs and things like ray tracing packages. It can handle
  242.        images with up to sixteen million unique colors.
  243.        PCXLAB will generate 1, 4, 8, or 24 bit TGA files. As with
  244.        TIFF files, PCXLAB will only generate uncompressed TGA files.
  245.  
  246.  
  247.   DITHERING - F4
  248.   --------------
  249.        Dithering is a sort of magical process by which color images can
  250.        be converted into pretty attractive black and white versions for
  251.        reproduction on a monochrome screen or a black and white laser
  252.        printer.
  253.        Note that source files for dithering must have more than one bit
  254.        of color information.
  255.        Dithering often works a lot better if you scale the original
  256.        image up. PCXLAB lets you dither with images from "size as" up to
  257.        300 percent expansion.
  258.        Note that the F4 function only dithers to monochrome. Color
  259.        dithering is handled by one of the functions of the F5 key.
  260.        Dithering is a fairly slow process, and the better the dithering
  261.        algorithm, the slower it gets.
  262.        If you have PCXLAB dither a file, it will create a new file for
  263.        you of the type selected and with "$" as the first char in the name.
  264.        Thus PICTURE.PCX could be dithered to $ICTURE.PCX, for example.
  265.        PICTURE.PCX would be left untouched.
  266.        The two dithering algorithms use what is called "error diffusion".
  267.        These produce really nice looking dithers, but they are quite slow.
  268.        The fastest... and least attractive... is Floyd-Steinberg. The
  269.        better... and slower... is Burkes (in my opinion).
  270.        It is possible to adjust the brightness and contrast of dithered
  271.        image with the GAMMA and CONTRAST values. Also it is possible to
  272.        invert the dithered image.
  273.  
  274.  
  275.   COLOR REDUCTION - F5
  276.   --------------------
  277.        This function allows you to create destination files with fewer
  278.        colors than the source files they are derived from. You can use
  279.        this function, for example, to reduce a 256-color file down to a
  280.        16-color one. It is particularly useful for reducing 24-bit files
  281.        down to 256-color files.
  282.        Whenever you reduce the number of colors in a file, some image
  283.        information will get lost. The simplest form of color reduction
  284.        is "remapping". This simply means that the destination image will
  285.        have the best color palette it can, and that all the pixels in
  286.        it will be replaced with colors from that palette. The results
  287.        are not usually very attractive.
  288.  
  289.        Color dithering, also available in this function, can produce
  290.        decidedly better results. With color dithering, you can reduce
  291.        24-bit files down to eight bits with very little loss of detail
  292.        or color resolution.
  293.        If you have PCXLAB color dither a file, it will create a new file
  294.        for you of the type selected and with "!" as the first char in the
  295.        name. Thus PICTURE.PCX could be dithered to !ICTURE.PCX, for example.
  296.        PICTURE.PCX would be left untouched.
  297.  
  298.        Gray scale
  299.        ----------------
  300.        This function creates a gray scale destination image from a
  301.        color source image. The number of bits of color will remain the
  302.        same, although when grayscaling a 24-bit image, the destination
  303.        image will be a 8-bit image.
  304.        If you have PCXLAB dither a file, it will create a new file for
  305.        you of the type selected and with "#" as the first char in the name.
  306.        Thus PICTURE.PCX could be dithered to #ICTURE.PCX, for example.
  307.        PICTURE.PCX would be left untouched.
  308.  
  309.  
  310.   PRINTING - F6
  311.   -------------
  312.        You can print PCX-files to a EPSON compatible printer with PCXLAB.
  313.        However your PCX-file must satisfy the following conditions:
  314.  
  315.        1) It must a monochrome PCX-file
  316.        2) It must be no wider than 640 pixels.
  317.  
  318.        You can only print only file at a time, no matter how many you have
  319.        tagged. You will be asked if you want to invert the output, the
  320.        density on the printer and which printer port (1, 2 or 3).
  321.  
  322.  
  323.   AUTO/LOCK - F7
  324.   --------------
  325.        Pressing F7 goes to AUTO, which automatically selects a resolution
  326.        which will display the whole picture.
  327.        Pressing F7 goes back to LOCK, which forces the default resolution
  328.        (above) no matter what the file size.
  329.  
  330.  
  331.   VIEW SLIDESHOW - F8
  332.   -------------------
  333.        Pressing F8 will do a slide show of the tagged files until ESC is
  334.        pressed.
  335.        Alt+D prompts for a new slide delay time in seconds.
  336.        You must tag at least 2 files to start the slideshow.
  337.  
  338.  
  339.   RESCAN DIRECTORY - F9
  340.   ---------------------
  341.        Pressing F9 will cause PCXLAB to rescan the current directory for
  342.        PCX and ANS-files. If you activate PCXDUMP from within PCXLAB, PCXDUMP
  343.        will create new PCX-files that does not appear in the file selection
  344.        window. If you press F9 PCXLAB will scan the directory and the new files
  345.        will appear in the file selection window.
  346.  
  347.  
  348.   CHANGE DRIVE - F10
  349.   ------------------
  350.        Press F10 to change drive.
  351.  
  352.  
  353.   --------------------------- End of document --------------------------------
  354.