rt_raster_get_band()

rt_band rt_raster_get_band	(	rt_raster	raster,
		int	bandNum
	)

Return Nth band, or NULL if unavailable.

Parameters

raster	: the raster
bandNum	: 0-based index of the band to return

Return band at specified index or NULL if error

Definition at line 381 of file rt_raster.c.

References rt_raster_t::bands, and rt_raster_t::numBands.

Referenced by _rt_raster_geotransform_warn_offline_band(), _rti_colormap_arg_destroy(), _rti_iterator_arg_populate(), convert_raster(), cu_free_raster(), RASTER_bandIsNoData(), RASTER_bandmetadata(), RASTER_clip(), RASTER_colorMap(), raster_destroy(), RASTER_dumpAsPolygons(), RASTER_dumpValues(), RASTER_getBandNoDataValue(), RASTER_getBandPath(), RASTER_getBandPixelType(), RASTER_getBandPixelTypeName(), RASTER_getPixelPolygons(), RASTER_getPixelValue(), RASTER_histogram(), RASTER_histogramCoverage(), RASTER_mapAlgebra2(), RASTER_mapAlgebraExpr(), RASTER_mapAlgebraFct(), RASTER_mapAlgebraFctNgb(), RASTER_nearestValue(), RASTER_neighborhood(), RASTER_nMapAlgebra(), RASTER_nMapAlgebraExpr(), RASTER_pixelOfValue(), RASTER_quantile(), RASTER_quantileCoverage(), RASTER_reclass(), RASTER_setBandIsNoData(), RASTER_setBandNoDataValue(), RASTER_setPixelValue(), RASTER_setPixelValuesArray(), RASTER_setPixelValuesGeomval(), RASTER_summaryStats(), RASTER_summaryStats_transfn(), RASTER_summaryStatsCoverage(), RASTER_tile(), RASTER_union_finalfn(), RASTER_union_transfn(), RASTER_valueCount(), RASTER_valueCountCoverage(), rt_band_load_offline_data(), rt_raster_colormap(), rt_raster_copy_band(), rt_raster_from_gdal_dataset(), rt_raster_gdal_polygonize(), rt_raster_gdal_rasterize(), rt_raster_gdal_warp(), rt_raster_get_perimeter(), rt_raster_intersects(), rt_raster_iterator(), rt_raster_replace_band(), rt_raster_surface(), rt_raster_to_gdal_mem(), rtpg_union_arg_destroy(), test_gdal_to_raster(), test_gdal_warp(), test_raster_colormap(), test_raster_replace_band(), and test_raster_wkb().

                                            {
        assert(NULL != raster);

        if (n >= raster->numBands || n < 0)
                return NULL;

        return raster->bands[n];
}