c_egroup - Groups several image files

SYNTAX

#include "las.h"

FUNCTION c_egroup (fdarray, gdesc, buffer, buffersz)

     int                 *fdarray;
     int                 *gdesc;
     unsigned char       *buffer;
     long                *buffersz;

PARAMETERS

fdarray (input, integer array, null terminated)

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

gdesc (output, integer)

Group descriptor to be used internally by the image I/O subroutines and passed to the c_estep() routine. The calling routine should pass by reference an integer of the machine's word size. From C this is an int. program.

buffer (input, byte array)

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

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