---
name: "VistaIOSetBandInterp"
section: "3"
platform: "linux"
package: "libvistaio-dev"
version: "1.2.19-3+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/VistaIOSetBandInterp"
---

# VistaIOSetBandInterp(3)

set image band interpretation attributes

## NAME

VistaIOSetBandInterp - set image band interpretation attributes

## SYNOPSIS

```
#include <vistaio.h>
```

**VistaIOBoolean VistaIOSetBandInterp (VistaIOImage** *image***,** **VistaIOBandInterp** *frame\_interp***, int** *nframes***,** **VistaIOBandInterp** *viewpoint\_interp***, int** *nviewpoints***,** **VistaIOBandInterp** *color\_interp***, int** *ncolors***,** **VistaIOBandInterp** *component\_interp***, int** *ncomponents***);**

```

```

## ARGUMENTS

- *image*

  *Specifies the image whose attributes are to be set.*

- *frame\_interp*, *nframes*

  - *viewpoint\_interp*, *nviewpoints*

  - *color\_interp*, *ncolors*

  - *component\_interp*, *ncomponents*

  *Specify values for various band interpretation attributes.*

## DESCRIPTION

**VistaIOSetBandInterp** *provides a convenient way to simultaneously set all of* *the standard attributes describing how an image's bands are to be* *interpreted.*

*The frame\_interp, viewpoint\_interp, color\_interp and* *component\_interp arguments supply values for the* *correspondingly-named attributes. If any of these values is the constant* **VistaIOBandInterpNone***, the corresponding attribute is omitted from the* *image.*

*Similarly, the nframes, nviewpoints, ncolors, and* *ncomponents arguments supply values for other correspondingly-named* *attributes. The product of these values should equal the total number of* *bands in the image.*

## RETURN VALUES

**VistaIOSetBandInterp** *returns*  **TRUE** *if successful, and*  **FALSE** *on encountering an error.*

## SEE ALSO

[**VistaIOBandInterp**(3)](/VistaIOBandInterp/3.md), [**VistaIOImage**(3)](/VistaIOImage/3.md),

## DIAGNOSTICS

- \`\`No. bands conflicts with no. of frames, etc.''

  *The product of the numbers of frames, viewpoints, colors, and components* *specified is isn't equal to the number of bands in the image.*

## AUTHOR

*Art Pope \<pope@cs.ubc.ca\>*

*Adaption to vistaio: Gert Wollny \<gw.fossdev@gmail.com\>*