Iread_band

[ XITE Reference Manual | XITE home ]

Name

Iread_band - read a BIFF band from file

Syntax

 #include <xite/biff.h>

 BiffStatus Iread_band( IMAGE i, int bandnr );

Description

Read band number bandnr from file into image i. The byte order of the stored band is compared to the byte order of the host computer. If they don't match, the bytes are swapped after reading.

Restrictions

Image i must be open (connected to a file). This is done by calling Iopen_image. 1 <= bandnr <= Inbands(i)

See also

Iread_image(5), Iopen_image(5), Iclose_image(5), Init_band(5), Init_image(5), Iwrite_band(5), Iband_status(5), biff_swap(3), biffswap(1)

Return value

status

Author

Tor Lønnestad, BLAB, Ifi, UiO