home *** CD-ROM | disk | FTP | other *** search
/ PC & Mediji 1996 March / PCM_9603.iso / programi / pcxdump / pcxlab.doc < prev    next >
Text File  |  1995-07-01  |  16KB  |  363 lines

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