home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_PAS / TPPCX256.ZIP / PCV_READ.ME < prev    next >
Text File  |  1993-12-21  |  10KB  |  186 lines
  1. (I know you hate to (I do to), but PLEASE ... read. This file contains a
  2. couple of important things to successfully evaluate the enclosed code.)
  3.  
  4.   TPPCX-VGA256 v1.0
  5.     All material Copyright (C) 1993; Mark D.Rafn, MDRUtils
  6.     All rights reserved
  7.     All objects and code compiled under Borland Pascal v7.0
  8.     PCX image file format by ZSoft Corporation
  9.  
  10. ------------------------------------------------------------------------------
  11.   GENERAL
  12. ------------------------------------------------------------------------------
  13. ■ TPPCX-VGA256 contains objects designed for Borland Pascal v7.0 OOP programmers
  14.   allowing for the display and creation of ZSoft's PCX format images in high
  15.   resolution and 256 glorious colors! Up to 1024 x 768 x 256 display mode is
  16.   supported in this version. Although specifically created for 256 color PCX
  17.   files, the code also works with 16 color images. The code runs under all
  18.   display modes, from 320x200 to 1024x768, 16 color to 256 color.
  19.  
  20. ■ This version is retricted to VGA only. Additionally, in order to display
  21.   high resolution (up to 1024x768), your system must support VESA extensions.
  22.   VESA (Video Electronics Standards Association) is attempting to standardize
  23.   the Super VGA's. Many of the standards now exist and card manufacturers are
  24.   providing the BIOS extensions and drivers for their cards. If your card is
  25.   VESA compatible then loading the VESA BIOS extensions will enable you to
  26.   fully utilize the code in this utility. ( Support VESA! )
  27.  
  28. ■ To better enable you to evaluated the code within, a VESA 256 BGI driver and
  29.   VGA 256 BGI driver are enclosed. Although pictures can be displayed without
  30.   either driver, without them you would not have graph functions to create
  31.   lines, text, rectangles, etc. The VESA256.BGI driver is included with
  32.   permission from Jones Computer Supplies; Peter F. Jones. Please read the
  33.   JCS_READ.ME file (included) for more info and registration. Please note
  34.   that this VESA driver is his crippled version. The VGA256.BGI driver was
  35.   obtained from Borland's CompuServ BPROGA forum and allows graphic functions
  36.   in hex mode 13 only (320x200x256).
  37.  
  38. ■ Features
  39.   . Decode/view and encode/create PCX format images in 16 color mode.
  40.   . Decode/view and encode/create PCX format images in 256 color mode.
  41.   . Display image to user defined coordinates.
  42.   . Clip the image to a user defined window.
  43.   . Supports all standard Vga display modes including 256 color, mode 13h.
  44.   . Supports all VESA 256 color display modes up to 1024 x 768.
  45.   . Supports VESA 16 color modes.
  46.   . Includes Vga palette manipulation procedures.
  47.   . Includes VESA initialization procedures and controls.
  48.   . and more!
  49.  
  50. ■ Files contained in this archive
  51.  
  52.   UPCXVGA.TPU     compiled unit for PCX decoding, encoding. (crippled)
  53.   UVESA.TPU       compiled unit for VESA functions
  54.   UVGA.TPU        compiled unit for VGA functions
  55.   UPAL256.TPU     compiled unit for palette constants
  56.   UEGA.TPU        compiled unit for EGA functions
  57.   PCXPLAY.PAS     sample run program for PCX viewing (creating).
  58.   PALPLAY.PAS     sample run program for VGA palette methods.
  59.   VESA256.BGI     crippled VESA BGI driver for graph routines
  60.   VGA256.BGI      VGA BGI driver for mode $13 graph routines
  61.   JCS_READ.ME     VESA256.BGI info and registration information
  62.   PCV_READ.ME     this file.
  63.   THECOVER.PCX    Sample PCX file, 256 gray scale (the manual's cover)
  64.   COLOR16.PCX     Sample PCX file, 16 colors
  65.   COLOR256.PCX    Sample PCX file, 256 color
  66.   SHAREWRE.TXT    Shareware information
  67.   ------------
  68.   15 files
  69.  
  70. ------------------------------------------------------------------------------
  71. REGISTRATION
  72. ------------------------------------------------------------------------------
  73. ■ Please read SHAREWRE.TXT
  74.  
  75. ■ As the author of these programs/units, I have spent CONSIDERABLE time in
  76.   their development. In the spirit of shareware, am I requesting a modest
  77.   registration fee for the use of the enclosed material. Because this material
  78.   must be registered, the files within this archive are for evaluation
  79.   purposes only and as such, they are crippled with respect to limited calls
  80.   for compiled code and limited documentation. Documentation is limited to
  81.   sample program comments only.
  82.  
  83. ■ There are two types of registration:
  84.  
  85.   1. The first type provides you with fully functional compiled code ONLY,
  86.   plus sample run programs. This code can be used as is or modified through
  87.   extensions for use in your programs. The cost of this registration is
  88.   $10.00 ( This includes S&H, overseas please add $1.00)
  89.  
  90.   2. The second type of registration contains the above plus all the source
  91.   code used in the compiled programs/units. The cost for this registration is
  92.   $20.00. ( This includes S&H, overseas please add $1.00)
  93.  
  94.   When registered . . .
  95.   In continuing to provide a quality product, I will be providing a compact,
  96.   professionally published, 44-page reference manual to both types of
  97.   registered users. This is something new for me and if successful, I will
  98.   continue to provide this service. Registration will also entitle you to
  99.   update notification when and if they occur as well as telephone support
  100.   ( I would be glad to hear from you ).I have thoroughly tested these
  101.   programs/units before releasing and you should find them bug free,
  102.   however . . .
  103.  
  104.   Upon writing the documentation for the objects contained in TPPCX-VGA256
  105.   I am continuing to use the format Borland has established in their Turbo
  106.   Vision manual. I have copied this style of documentation in past code I've
  107.   distributed and will continue with this method as I believe it to be clear
  108.   and concise. <I sincerely hope Borland is not offended>.
  109.  
  110. ■ Also, ( I have to say this, argg! ) as with all shareware or freeware, the
  111.   programs are for use as is. You may use them, distribute them, etc. but the
  112.   author is not responsible for any problems incurred from their use, in part
  113.   or in whole. If you distribute them please leave the contents as received.
  114.  
  115. ■ All the enclosed compiled code was written and compiled using Borland's
  116.   Turbo Pascal 6.0 language compiler and as such all Borland license statements
  117.   must be respected.
  118.  
  119. For direct order -
  120. Send Registration to:      Mark D. Rafn (MDRUtils)
  121.                            Rt1 Box138A
  122.                            Two Harbors, MN 55616
  123.                            USA
  124.                            tel: (218) 834-5154
  125.                            CIS: 71530,2307
  126.  
  127. ------------------------------------------------------------------------------
  128.   RUNNING SAMPLES
  129. ------------------------------------------------------------------------------
  130. ■ Two sample programs have been included to show some of the capabilities of
  131.   the enclosed code. PCXPLAY.PAS shows decoding and encoding methods.
  132.   (Encoding has been commented out). PALPLAY.PAS shows some basic Vga
  133.   palette techniques necessary when dealing with 256 color PCX files.
  134.   Palettes will undoubtedly create the biggest problem in your programs.
  135.   Reading a PCX file's palette entries into the color registers will change
  136.   all the colors you are use to dealing with. The TPPCX-VGA256 manual
  137.   explains in detail how you can remap your BGI colors and with minimal
  138.   experimentation can retain the standard colors for use by the rest of your
  139.   program.
  140.  
  141. ■ IMPORTANT STUFF
  142.   For those of you not familiar with utilizing a user driver (VESA.BGI or
  143.   VGA256.BGI), the driver MUST reside in the current working directory. ie:
  144.   If you load Turbo Pascal from the directory C:\TP and load the sample
  145.   file PCXPLAY from a directory called C:\TP\TEST (without changing to that
  146.   directory), then the BGI drivers must reside in C:\TP. If you change
  147.   directory within the IDE to C:\TP\TEST, then the driver must be in
  148.   C:\TP\TEST.
  149.  
  150.   The best way to run the sample program is to:
  151.     1. Create a temporary directory.
  152.     2. Copy all the TPPCX-VGA256 files to that directory.
  153.     3. Load Turbo Pascal.
  154.     4. Change to the temporary directory from within the IDE.
  155.        (Files, Change Dir, <temp dir>)
  156.     5. Load sample files and run.
  157.  
  158. ■  You can change the constant declarations at the beginning of the PCXPLAY
  159.    sample to name a differant PCX file for viewing.
  160.  
  161. ■  To utilize the high resolution capabilities, don't forget to load your
  162.    VESA Extension software obtained from the graphics card manufacturer.
  163.    Without it you will be limited to 320 x 200 Vga mode (not very exciting).
  164.  
  165. ■ TPPCX-VGA256 v1.0 has been tested satisfactorily under the following
  166.   conditions (a check indicates passed):
  167.  ────────────────┬─────┬────────┬─────────┬───────────┬───────
  168.                  │Image│  Full  │ Clipped │ Bleed-Off │ Large
  169. Mode             │Type │  Image │ Image   │ Image     │ Image (>1Mb)
  170.  ────────────────┼─────┼────────┼─────────┼───────────┼───────
  171. VGA  320x200x256 │ 1,2 │   √    │  √      │  √        │  √
  172. VGA  640x400x16  │ 1,2 │   √    │  √      │  √        │  √
  173. VGA  640x350x16  │ 1,2 │   √    │  √      │  √        │  √
  174. VGA  640x480x16  │ 1,2 │   √    │  √      │  √        │  √
  175. VESA 640x400x256 │ 1,2 │   √    │  √      │  √        │  √
  176. VESA 640x480x256 │ 1,2 │   √    │  √      │  √        │  √
  177. VESA 800x600x256 │ 1,2 │   √    │  √      │  √        │  √
  178. VESA 1024x768x256│ 1,2 │   √    │  √      │  √        │  √
  179. VESA 800x600x16  │ 1,2 │   √    │  √      │  √        │  √
  180. VESA 1024x768x16 │ 1,2 │   √    │  √      │  √        │  √
  181.  ────────────────┴─────┴────────┴─────────┴───────────┴───────
  182.  1 = Planar image; 16 color, 1 bit per pixel
  183.  2 = Packed image; 256 color, 8 bits per pixel
  184.  
  185. Thank You - your cooperation is appreciated.
  186.