NAME

DsRasterWrite − Write a raster object to a file

SYNOPSIS

C:

DtInt DsRasterWrite(raster, filename)
DtObject raster;
DtPtr filename;

FORTRAN:

INTEGER∗4 DSRSW(RASTER, FNAME, FLEN)
INTEGER∗4 RASTER
INTEGER∗4 FLEN
CHARACTER∗FLEN FNAME

DESCRIPTION

DsRasterWrite takes a raster object and writes it out to a file. 

The parameter raster is a handle to the raster object.  The parameter filename is the name of the file. 

DsRasterWrite returns -1 if an error occurs (see below), otherwise DsRasterWrite returns 0. 

FORTRAN SPECIFIC

The parameter FNAME is a filename that is FLEN characters long. 

ERRORS

DsRasterWrite will fail if raster is not a valid raster object. 

[WARNING - invalid or deleted object]

DsRasterWrite will fail if the raster object data is not one of the standard Doré types. 

[WARNING - unimplemented function. Cannot write DcRasterSpecial.] DsRasterWrite will fail if the file cannot be opened. 

[WARNING - io error.  Could not open file filename for writing.]

SEE ALSO

DoRaster(3D), DsInqRaster(3D)

September 02, 1992