c_w1dltf - Writes the first type of DLTF record to an associate DLTF

SYNTAX

#include "worgen.h"
#include "vll.h"
#include "dltf.h"
FUNCTION c_w1dltf (fd,key,descr,type,asdltf)

     long               *fd;
     char               *key;
     char               *descr;
     char               *type;
     struct   ASDLTF    *asdltf;

PARAMETERS

fd (input, integer)

File descriptor of an opened DLTF file. The file descriptor is set in c_ckdltf() and should not be altered.

key (input, character, length (13))

DLTF entry name. Note that the length of the key is limited to twelve characters even though the file format allows sixteen. This is because LUT numbers are appended to the key value to form the names of the second type of DLTF records. Thus, the twelve characters with the maximum appended three characters plus one for the null become the sixteen character maximum allowed in the key field of label services.

descr (input, character, length (81))

String containing a user specified description of the DLTF entry.

type (input, character, length (3))

String containing the data type of the LUT(s). This can be either B or I2 for BYTE or I*2, respectively.

asdltf (input, ASDLTF)

An ASDLTF structure or a FORTRAN integer array dimensioned to DLTFSZ that contains the DLTF field information. The structure contains the number of bands in the DLTF entry, the actual band numbers, the window (SL, SS, NL, NS) of the image used, the X and Y zoom factors of image planes, the X and Y zoom factors of the graphics planes, the X and Y shift values of the image planes, and the X and Y shift values of the graphics planes.

DESCRIPTION

The c_w1dltf() routine writes the first type of DLTF entry record to a DLTF. The function receives the necessary DLTF fields as parameters and stores them in an associate DLTF.

RETURN VALUE

c_w1dltf() returns

     E_SUCC (0)  --> successful completion 
     E_FAIL (-1) --> operation failed