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

# VistaIOBandInterp(3)

image band interpretation

## NAME

VistaIOImageFrameInterp, VistaIOImageViewpointInterp, VistaIOImageColorInterp, VistaIOImageComponentInterp - image band interpretation

## SYNOPSIS

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

**VistaIOBandInterp VistaIOImageFrameInterp (VistaIOImage *image*)**

**VistaIOBandInterp VistaIOImageViewpointInterp (VistaIOImage *image*)**

**VistaIOBandInterp VistaIOImageColorInterp (VistaIOImage *image*)**

**VistaIOBandInterp VistaIOImageComponentInterp (VistaIOImage *image*)**

**typedef enum {**\
 	**VistaIOBandInterpNone,	/\* no interpretation \*/**\
 	**VistaIOBandInterpOther,	/\* unknown interpretation \*/**\
 	**VistaIOBandInterpStereoPair,	/\* describing camera viewpoints \*/**\
 	**VistaIOBandInterpRGB,	/\* describing color channels \*/**\
 	**VistaIOBandInterpComplex,	/\* describing vector components \*/**\
 	**VistaIOBandInterpGradient,**\
 	**VistaIOBandInterpIntensity,**\
 	**VistaIOBandInterpOrientation** **} VistaIOBandInterp;**

## ARGUMENTS

- *image*

  **Specifies an image for which band interpretation information is sought.**

## DESCRIPTION

**These four routines return information about how an image's bands are to be**  **interpreted. Each reports on one of four band interpretation dimensions:**  **motion sequence frame, camera viewpoint, color channel, or vector**  **component.**

## RETURN VALUES

**Each routine examines the size of its respective dimension (e.g.,**  **nframes), plus any band interpretation attribute for its dimension**  **(e.g., frame\_interp) and returns a value based on them. Specifically:**

- •

  **if the size of the dimension is 1 and there is no band interpretation** **attribute, it returns VistaIOBandInterpNone**

- •

  **VistaIOImageViewpointInterp returns VistaIOBandInterpStereoPair if** *image* **is a standard stereo pair (i.e., nviewpoints: 2 and** **viewpoint\_interp: stereo\_pair)**

- •

  **VistaIOImageColorInterp returns VistaIOBandInterpRGB if** *image* **is a** **standard RGB color image (i.e., ncolors: 3 and color\_interp:** **rgb)**

- •

  **VistaIOImageComponentInterp returns VistaIOBandInterpComplex if** *image*  **is a standard complex image (i.e., ncomponents: 2 and**  **component\_interp: complex)**

- •

  **VistaIOImageComponentInterp returns VistaIOBandInterpGradient if** *image* **is a standard gradient image (i.e., ncomponents: 1 or** **2, and component\_interp: gradient)**

- •

  **VistaIOImageComponentInterp returns VistaIOBandInterpIntensity if**  *image* **is a standard intensity image (i.e., ncomponents: 1 and**  **component\_interp: intensity)**

- •

  **VistaIOImageComponentInterp returns VistaIOBandInterpOrientation if**  *image* **is a standard orientation image (i.e., ncomponents: 1**  **and component\_interp: orientation)**

- •

  **each routine returns VistaIOBandInterpOther otherwise**

## SEE ALSO

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

## DIAGNOSTICS

**A warning is issued and VistaIOBandInterpOther is returned if a dimension's size**  **(e.g., ncolors) and the corresponding band interpretation attribute**  **(e.g., color\_interp) are inconsistent.**

**A warning is also issued if the product of the four dimension's sizes does** **not equal the total number of bands in the image.**

## AUTHOR

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

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