MAN page from RedHat Other XITE-3.3-3.i386.rpm

CONVERTBAND

Section: C Library Functions (3)
Updated: 16 Mar 1998
Index

NAME

convertBand, mkConvertBand - convert a band to anotherpixel type

SYNTAX

#include <xite/convert.h>

int convertBand( IBAND b1, IBAND b2 );

IBAND mkConvertBand( IBAND b, IPIXTYP pixtyp );

DESCRIPTION

convertBandconverts the data in <b1> into <b2>.Although typed as IBAND above, <b1> and <b2> maybe of any combination of the following pixel types.

  Pixel Type   Band Type   IPIXTYP     IPIXTYP value
----------------------------------------------------
  UNS_BYTE     IUB_BAND    Iu_byte_typ      3
  SIGN_BYTE    ISB_BAND    Is_byte_typ      4
  UNS_SHORT    IUS_BAND    Iu_short_typ     5
  SIGN_SHORT   ISS_BAND    Is_short_typ     6
  INTEGER      II_BAND     Integer_typ      7
  REAL         IR_BAND     Ireal_typ        8
  COMPLEX      IC_BAND     Icomplex_typ     9
  DOUBLE       ID_BAND     Idouble_typ     10
  DCOMPLEX     IDC_BAND    Id_complex_typ  11

Only the overlapping part of the two bands is converted.Conversion is as simple as possible, no scaling is performed.If overflow, the result is set to the closest legal value.

mkConvertBandcreates a new band of the same size asthe input band <b>, but with pixel type <pixtyp>,then converts the data in <b> into the new band,and returns the new band.

BUGS

There is a large number of combinations, the routinesare NOT thoroughly tested!! Please report any problems.

RETURN VALUE

For convertBand:
0 => ok
1 => Can't handle that input pixel type
2 => Can't handle that output pixel type

For mkConvertBand:
The new band => ok
(IBAND) 0 => error

AUTHOR

Tor Loennestad, BLAB, ifi, UiO

This document was created byman2html,using the manual pages.