pcx.txt

PCX图形文件格式说明

	}
return(0);
}



FRIEZE Technical Information


FRIEZE Information

FRIEZE is a memory resident utility that allows you to capture and
save graphic images from other programs.  You can then bring these
images into PC Paintbrush for editing and enhancement.  FRIEZE was
rewritten for use in PC Paintbrush Plus, and so the technical
information about FRIEZE has changed dramatically.  To easily provide
technical information for all versions of FRIEZE, we have split this
section of the manual into two parts, one about PRE-7.00 versions of
FRIEZE, and one about the current versions (7.00 or higher).  FRIEZE
7.10 and later can be removed from memory (this can return you almost
85K of DOS RAM, depending on your configuration).  To do this, you can
choose to release FRIEZE from memory in the PCINSTAL menu, or at any
time by changing directories to your P C PAINTBRUSH product directory
and typing the word "FRIEZE."


Pre-7.00 FRIEZE Specifications


FRIEZE Print Option Settings

FRIEZE can easily adapt to incomplete printer cables (missing IBM
specified status lines) and will drive either serial or parallel
devices.  Note that FRIEZE always uses the standard BIOS calls, so a
non-handshaking device will time out, but can be told to ignore such
things as paper out.  The FRIEZE command syntax is: FRIEZE Xnaarr
Where: X = either Parallel or Serial n = port number aa = a two digit
hexadecimal code for which return bits cause an abort rr = a two digit
hexadecimal code for which return bits cause a retry Examples: FRIEZE
P1 - use the default settings of Parallel output, port number 1, abort
mask of 28h, and retry mask of 01h FRIEZE P2 - use printer port #2
FRIEZE S1 - use serial port #1, and Xon/Xoff handshaking FRIEZE P10028
- use printer port #1, abort mask of 00 (nothing is read as an error)
and retry mask of 28h Interpreting the codes: On return from the
parallel printer call, the bit interpretations are: 80h - busy signal
(0=busy) 40h - acknowledge 20h - out of paper 10h - selected 08h - I/O
error 04h - unused 02h - unused 01h - time out


FRIEZE Function Calls

FRIEZE is operated using software interrupt number 10h (the video
interrupt call).  To make a FRIEZE function call, load 75 (decimal)
into the AH register, the function call number into the CL register
and then, either load AL with the function argument or load ES and BX
with a segment and offset which point to the function argument the n
do an int 10h.  FRIEZE will return a result code number in AX--zero
means success, other values show error conditions.  All other
registers are unchanged.

No.	Definition 	Arguments
0	Print Window	AL = mode: 0 - character,
         		1 - normal, 2 - sideways
1	Read Window	ES:BX - string
	        	(filename to read from)
2	Write Window 	ES:BX - string
	        	(filename to write to)
3	Print Width	AL = width in 1/4 inches
4	Print Height	AL = height in 1/4 inches
5	Reserved
6	Set Left Margin	AL = printout margin in 
	        	1/4 inches
7	Set Window Size	ES:BX - 4 element word
	        	vector of window settings:
	        	Xmin, Ymin, Xmax, Ymax
8	Reserved
9	Set Patterns	ES:BX - 16 element vector
	        	of byte values containing the
	         	screen-to-printer color
	        	correspondence
10	Get Patterns	ES:BX - room for 16 bytes as
	        	above
11	Set Mode	AL = mode number
		        (See SETMODE command)
12	Reserved
13	Reserved
14	Reserved
15	Get Window	ES:BX - room for 4 words of
	         	the current window settings
16 	Set Print Options	ES:BX - character string of
	        	printer options.  Same format
	        	as for the FRIEZE command.
17	Initialize	ES:BX - 3 word array
	        	containing data from 
	        	PC Paintbrush Disk 1 file
	        	CARDS.DAT (Hres, Vres,
	        	optional code number)
All character strings are ended by a zero byte (ASCIIZ format).


FRIEZE Error Codes

When FRIEZE is called using interrupt 10 hex, it will return an error
code in the AX register.  A value of zero shows that there was no
error.  A nonzero result means there was an error.  These error codes
are explained below.

0	No Error
1	Printout was stopped by user with the ESC key
2	Reserved
3	File read error
4	File write error or printer error
5	File not found
6	Invalid Header or can't create file
	(not a picture or wrong screen mode)
7	File close error
8	Disk error - usually drive door open
9	Not used
10	Invalid command - CL was set to call a nonexistent 
	FRIEZE function
11	Not used
12	Not used


7.00 and Later FRIEZE

The newer versions of FRIEZE have a different number of parameters on
its command line.  The new FRIEZE command line format is:

FRIEZE {PD} {Xnaarr} {flags} {video} {hres} {vres} {vnum}

Where:

{PD}	Printer driver filename (without the .PDV extension)
{Xnaarr}
		X=S for Serial Printer X=P for Parallel Printer
		n = port number
		aa = Two digit hex code for which return bits cause
			 an abort
		rr = Two digit hex code for which return bits cause
			a retry
{flags}	Four digit hex code
			First Digit controls Length Flag
			Second Digit controls Width Flag
			Third Digit controls Mode Flag
			Fourth Digit controls BIOS Flag
NOTE:	The length, width and mode flags are printer driver specific.
		See PRINTERS.DAT on disk 1 for correct use.  In 
		general width flag of 1 means wide carriage, and 
		0 means standard width.  Length flag of 0 and 
		mode flag of 0 means use standard printer driver 
		settings.
{video} Video driver combination, where the leading digit
		signifies the high level video driver and the rest
		signifies the low level video driver
		Example = 1EGA - uses DRIVE1 and EGA.DEV
{hres}	Horizontal resolution of the desired graphics mode
{vres}	Vertical resolution of the desired graphics mode
{vnum}	Hardware specific parameter (usually number of color planes)
Note: The last four parameters can be obtained from the CARDS.DAT file, on Disk 1 of your PC Paintbrush diskettes.
Parallel printer return codes:
	80h - Busy Signal (0=busy)
	40h - Acknowledge
	20h - Out of paper
	10h - Selected
	08h - I/O error
	04h - Unused
	02h - Unused
	01h - Time out


FRIEZE Function Calls

FRIEZE is operated using software interrupt number 10h (the video
interrupt call).  To make a FRIEZE function call, load 75 (decimal)
into the AH register, the function number into the CL register and
then, either load AL with the function argument or load ES and BX with
a segment and offset which point to the function argument then do an
int 10h.  FRIEZE will return a result code number in AX--zero means
success, other values show error conditions.  All other registers are
unchanged.

No.	Definition 	Arguments
0	Reserved
1	Load Window	ES:BX - string
        		(filename to read from)
2	Save Window 	ES:BX - string
	        	(filename to write to)
3	Reserved
4	Reserved	
6	Reserved	
7	Set Window Size	ES:BX - 4 element word
         		vector of window settings:
	        	Xmin, Ymin, Xmax, Ymax
8	Reserved
9	Set Patterns	ES:BX - 16 element vector
	        	of byte values containing the
	        	screen-to-printer color
	        	correspondence
10	Get Patterns	ES:BX - room for 16 bytes as
	        	above
11	Set Mode	AL = mode number
	        	(See SETMODE command)
12	Reserved
13	Reserved
14	Reserved
15	Get Window	ES:BX - room for 4 words of
		        the current window settings
16 	Set Print Options	ES:BX - character string of
         		printer options.  Same format
	        	as for the FRIEZE command.
17	Reserved
18	Reserved
19	Reserved
20	Get FRIEZE Version.	AH gets the whole number portion 
           		and AL gets the decimal portion of
	                the version number.  If AH=0, it
	         	can be assumed that it is a 
          		pre-7.00 version of FRIEZE.
21	Set Parameters	ES:BX points to an 8 word table 
	        	(16 bytes) of parameter settings: 
         		TopMargin, LeftMargin, HSize,VSize,
         		Quality/Draft Mode, PrintHres, 
        		PrintVres, Reserved.	
         		Margins and sizes are specified in 
	        	hundredths of inches.
         		Q/D mode parameter values:
	        	0 - draft print mode
	        	1 - quality print mode
	         	2 - use Hres, Vres for output 
	         	resolution.  Print resolutions are 
		        specified in DPI.  Any parameter
          		which should be left unchanged may	
	        	be filled with a (-1) (0FFFF hex).  
          		The reserved setting should be filled
	        	with a (-1).
22	Get Parameters	ES:BX points to an 8 word table 
	        	(16 bytes) where parameter settings
	        	are held.
23	Get Printer Res	ES:BX points to a 12 word table
	         	(24 bytes) where printer resolution
	         	pairs (6 pairs) are held.
NOTE: All character strings are ended by a zero byte 
	(ASCIIZ format).


FRIEZE Error Codes

When FRIEZE is called using interrupt 10 hex, it will return an error
code in the AX register.  A value of zero shows that there was no
error.  A nonzero result means there was an error.  These error codes
are explained below.

0	No Error
1	Printout was stopped by user with the ESC key
2	Reserved
3	File read error
4	File write error
5	File not found
6	Invalid Header - not an image, wrong screen mode
7	File close error
8	Disk error - usually drive door open
9	Printer error - printer is off or out of paper
10	Invalid command - CL was set to call a nonexistent 
	FRIEZE function
11	Can't create file - write protect tab or disk is full
12	Wrong video mode - FRIEZE cannot capture text screens.



The PCX Programmer's Toolkit

The .MDBO/PCX Programmer's Toolkit.MDNM/, by Genus Microprogramming,
allows developers to create applications with the ability to display,
save, capture, and manipulate PCX format images.  Because it supports
the most common display adapters and compilers , the toolkit can be
used in a wide variety of areas.  Besides the library interfaces, many
utility programs are provided for displaying and capturing screens,
creating windows, inspecting image headers and locating coordinates.
Over 35 routines for displaying and saving images from buffers and
files, setting palettes, accessing image headers, and more.

   Written in Assembler for maximum display speed

   Fast enough for animation

   Image library manager saves disk space and makes portability easy
   (group multiple PCX images in a single library file)

   Display images within database applications

Displays Supported:

    All Modes of the Hercules, CGA, EGA, and VGA graphics adapters.

Compilers Supported:

    Linkable libraries are provided for Microsoft C, Turbo C, QuickC,
    Lattice C, QuickBasic, Turbo Pascal, and Clipper.  Quick libraries
    are provided for the Microsoft integrated compilers, and a unit is
    provided for Turbo Pascal.  Small, Medium, and Large model
    libraries are included for compilers that support multiple memory
    models.

Software Supported:

    Paint packages such as ZSoft's PC Paintbrush and Microsoft
    Paintbrush are directly compatible.  Desktop Publishing packages
    supported include Xerox Ventura Publisher and Aldus PC PageMaker.

What the Toolkit Requires:

    An IBM PC/XT/AT or 100% compatible, 120disk drive, an IBM
    CGA/EGA/VGA, or Hercules adapter (or 100% compatible), and DOS 2.0
    or above.


Only $89.95!!!

Order direct from:
ZSoft Corporation
450 Franklin Rd., Suite 100
Marietta, GA.  30057
[phone]

Microsoft, Microsoft C, QuickC, QuickBasic, and Microsoft Paintbrush
are trademarks of Microsoft Corporation. Turbo C, Turbo Basic, and
Turbo Pascal are trademarks of Borland International.  Clipper is a
trademark of Nantucket Software.  Lattice C is a trademark of Lattice
Corporation.  Hercules is a trademark of Hercules Corporation.  Other
software packages are trademarks of their respective companies.