Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_GD_GETPIXVALUES

# EOS_GD_GETPIXVALUES

This function reads data from a data field for the specified pixels. It is the pixel subsetting equivalent of EOS_GD_EXTRACTREGION. All entries along the non-geographic dimensions (i.e., NOT XDim and YDim) are returned.

## Examples

To read values from the Spectra field with dimensions, Bands, YDim, and XDim:

bufsiz = EOS_GD_GETPIXVALUES(gridID, 2, rowArr, colArr, $

"Spectra", buffer)

## Syntax

Result = EOS_GD_GETPIXVALUES(gridID, nPixels, pixCol, pixRow, fieldname, buffer)

## Return Value

Returns size of data buffer if successful and FAIL(–1) otherwise.

## Arguments

### gridID

Grid id (long) returned by EOS_GD_CREATE or EOS_GD_ATTACH

### nPixels

Number of pixels (long).

### pixCol

Pixel Columns (long array).

### pixRow

Pixel Rows (long array).

### fieldname

Field (string) from which to extract data values.

### buffer

A named variable that will contain data values.

## Keywords

None

## Version History

5.2 | Introduced