NAME

FdPicCreat− create and open a picture file
FdPicSetPsize− set size of a picture
FdPicSetTsize− set tile size of a picture
FdPicSetPformat− set format of a picture
FdPicSetPstorage− set a picture storage flag
FdPicSetPmatting− set a picture matting indicator
FdPicSetOffset− set a picture’s offset
FdPicSetForce− set force a picture file overwrite
FdPicSetLabel− label a picture
FdPicOpen− open a picture file
FdPicFind− open a picture file, searching for it using PIXPATH

SYNOPSIS

#include <fdpicio.h>

PFILE
∗FdPicCreat(filename, mode)
char ∗filename;
int mode;

FdPicSetPsize(Pwidth,Pheight)
int Pwidth,Pheight;

FdPicSetTsize(Twidth,Theight)
int Twidth,Theight;

FdPicSetPformat(FdPictureFormat)
int FdPictureFormat;

FdPicSetPstorage(FdPictureStorage)
int FdPictureStorage;

FdPicSetPmatting(FdPictureMatting)
int FdPictureMatting;

FdPicSetOffset(Xoffset,Yoffset)
int Xoffset,Yoffset;

FdPicSetForce(ForcedRemovalFlag)
int ForcedRemovalFlag;

FdPicSetLabel(labelptr)
char ∗labelptr;

PFILE
∗FdPicOpen(filename, type)
char ∗filename, ∗type;

PFILE
∗FdPicFind(filename, type)
char ∗filename, ∗type;

char ∗FdPicFindName;

DESCRIPTION

FdPicCreat creates a new picture file or prepares to rewrite an existing file called filename, and associates a picture descriptor (PFILE) with it.  FdPicCreat returns a pointer to identify the picture descriptor in subsequent operations.  The argument mode, is ignored. 

The picture width (512), picture height (488), tile width (512), tile height (488), picture format (PF_RGBA), picture storage flag (PS_8BIT), picture matting indicator (PM_MTB), and picture offsets (0,0) (see <fdpicio.h>) are all stored in the picture descriptor associated with this channel.  The default values are shown in parentheses; these can be changed with calls to the various FdPicSet...  routines. 

An ASCII picture label is written if FdPicSetLabel has been called, passing a label pointer. 

The picture format must be PF_RGBA corresponding to a 4 channel image.  The picture storage should normally be PS_8DUMP to indicate an 8-bit per channel dumped format.  The format PS_12DUMP indicates a 12-bit per channel dumped format. 

FdPicOpen opens the picture named by filename and associates a channel with it.  FdPicOpen returns a pointer to be used to identify the picture descriptor in subsequent operations. 

Type is a character string having one of the following values: “r”open for reading “w”open for writing “r+”open for both “w+”create and open for both. 

FdPicFind is just like FdPicOpen, except that it searches PIXPATH to find filename before opening it.  The global FdPicFindName is a char pointer pointing to the full specification of the opened file. 

LIBRARY

libfdpicio.a

SEE ALSO

libfdpicio (3H), open(2), creat(2), fopen(3)
FdPicClose (3H), FdPicLabel (3H), FdPicRead (3H), FdPicDecode (3H), FdPicEncode (3H).

DIAGNOSTICS

FdPicCreat, FdPicOpen and FdPicFind return the pointer NULL if filename cannot be accessed.  FdPicCreat will return the pointer NULL if the header information is illegal. 

Release β  —  Last change: 8/3/88