c_egroup - Groups several image files

SYNTAX

#include "las.h"

int c_egroup (fdarray, gdesc, buffer, buffersz)

     struct FDESC        *fdarray[];
     struct GDESC        **gdesc;
     unsigned char       *buffer;
     long                *buffersz;

PARAMETERS

fdarray (input, struct FDESC pointer array, null terminated)

A null terminated array containing the individual file descriptors, created by calling c_eopens() each image file.

gdesc (output, pointer to struct GDESC pointer)

Pointer to the group descriptor pointer to be used internally by the image I/O subroutines and passed to the c_estep() routine.

buffer (input, byte array)

Address of the memory area to be used by I/O for the group.

Note: This buffer must be allocated by using the c_ealloc(), otherwise the buffer will not be properly sized for compressed images.

buffersz (input, integer)

Size of the memory area (buffer) in bytes.

DESCRIPTION

The c_egroup() call is used to group several files into a single file group to be processed by c_estep()

RETURN VALUE

c_egroup() returns

     E_SUCC (0)  --> success 
     E_FAIL (-1) --> failure