fg_makepcx()

Win32 DirectX Fastgraph/Light

Prototype

int fg_makepcx (int minx, int maxx, int miny, int maxy, char *filename);

Function fg_makepcx (ByVal minx As Long, ByVal maxx As Long, ByVal miny As Long, ByVal maxy As Long, ByVal filename As String) As Long

function fg_makepcx (minx, maxx, miny, maxy : integer; filename : string) : integer;

Description

The fg_makepcx() function creates a PCX file from the specified rectangular region of the active virtual buffer. The region's extremes are expressed in screen space units. For 256-color virtual buffers, fg_makepcx() creates 256-color PCX files; for direct color virtual buffers, it creates 24-bit PCX files.

Parameters

minx is the x coordinate of the region's left edge.

maxx is the x coordinate of the region's right edge. It must be greater than or equal to minx.

miny is the y coordinate of the region's top edge.

maxy is the y coordinate of the region's bottom edge. It must be greater than or equal to miny.

filename is the name of the PCX file to create. A device and path name may be included as part of the file name. The file name must be terminated by a null character (that is, a zero byte). If an identically named file already exists, it is overwritten.

Return value

0 = Success

1 = The PCX file was not created

2 = Error allocating memory

Restrictions

none

See also

fg_imagebuf(), fg_makebmp(), fg_showpcx()

Examples

Image, ImgProc