c_ewrite - Random writes to an image file

SYNTAX

#include "las.h"

FUNCTION c_ewrite (fdesc, eband, eline, euserbuf, nl_blk)

     int                *fdesc;
     long               *eband;
     long               *eline;
     unsigned char      *euserbuf;
     long               *nl_blk;

PARAMETERS

fdesc (input, integer)

File descriptor to be used internally by the image I/O subroutines. The calling routine should pass by reference the integer obtained from c_eopenr().

eband (input, integer)

Band number of the file to be written to.

eline (input, integer)

Line number to be written relative to the starting line the file was opened to. (i.e. 1,2,3...)

euserbuf (input, byte array)

User's buffer from which the data is written.

nl_blk (input, integer)

Number of lines to be written at one time.

DESCRIPTION

The c_ewrite() call is used to write specified line(s) of a specified band to an image file. The amount of data written for a particular line is determined from the ns parameter on the c_eopenr() call and nl_blk parameter. c_ewrite() will return the total number of samples written.

RETURN VALUE

c_ewrite() returns

     Total number of samples written for success
     E_FAIL (-1) -->  failure