DBReadBinary()

Description

DBReadBinary() is used to read binary (type 180) segment data from a GDB data set.

Call Signature

void DBReadBinary ( int/string filespec, int segment_num, int offset, int size, any ptr buffer )

Return Value

void

This has no return value.

Arguments

int/string filespec:

This can either be the handle returned by DBOpen(), or the name of an open file.

int segment_num:

The segment number containing the binary data to be read.

int offset:

The offset within the binary segment to start reading. Use zero to start at the beginning.

int size:

The number of bytes of data to read.

any ptr buffer:

An array of at least size bytes into which the binary data can be read. The buffer doesn't have be of type byte, but the size is in terms of bytes and should be at least 512, or a multiple of 512.

Remarks

Note that DBReadBinary() can be used for any segment type within PCIDSK files, though it is really intended only for use with binary segments. Very few GDB formats implement the binary segment type, which is used (among other things) to store satellite models.

See also

GDB file functions

DBWriteBinary()