rt_raster_copy_band()

int rt_raster_copy_band	(	rt_raster	torast,
		rt_raster	fromrast,
		int	fromindex,
		int	toindex
	)

Copy one band from one raster to another.

Bands are duplicated from fromrast to torast using rt_band_duplicate. The caller will need to ensure that the copied band's data or path remains allocated for the lifetime of the copied bands.

Parameters

torast	: raster to copy band to
fromrast	: raster to copy band from
fromindex	: index of band in source raster, 0-based
toindex	: index of new band in destination raster, 0-based

Returns

The band index of the second raster where the new band is copied. -1 if error

Definition at line 1276 of file rt_raster.c.

  {
        rt_band srcband = NULL;
        rt_band dstband = NULL;
 
        assert(NULL != torast);
        assert(NULL != fromrast);
 
        /* Check raster dimensions */
        if (torast->height != fromrast->height || torast->width != fromrast->width) {
                rtwarn("rt_raster_copy_band: Attempting to add a band with different width or height");
                return -1;
        }
 
        /* Check bands limits */
        if (fromrast->numBands < 1) {
                rtwarn("rt_raster_copy_band: Second raster has no band");
                return -1;
        }
        else if (fromindex < 0) {
                rtwarn("rt_raster_copy_band: Band index for second raster < 0. Defaulted to 0");
                fromindex = 0;
        }
        else if (fromindex >= fromrast->numBands) {
                rtwarn("rt_raster_copy_band: Band index for second raster > number of bands, truncated from %u to %u", fromindex, fromrast->numBands - 1);
                fromindex = fromrast->numBands - 1;
        }
 
        if (toindex < 0) {
                rtwarn("rt_raster_copy_band: Band index for first raster < 0. Defaulted to 0");
                toindex = 0;
        }
        else if (toindex > torast->numBands) {
                rtwarn("rt_raster_copy_band: Band index for first raster > number of bands, truncated from %u to %u", toindex, torast->numBands);
                toindex = torast->numBands;
        }
 
        /* Get band from source raster */
        srcband = rt_raster_get_band(fromrast, fromindex);
 
        /* duplicate band */
        dstband = rt_band_duplicate(srcband);
 
        /* Add band to the second raster */
        return rt_raster_add_band(torast, dstband, toindex);
}

References rt_raster_t::height, rt_raster_t::numBands, rt_band_duplicate(), rt_raster_add_band(), rt_raster_get_band(), rtwarn(), and rt_raster_t::width.

Referenced by RASTER_addBandRasterArray(), RASTER_copyBand(), RASTER_mapAlgebraExpr(), RASTER_union_finalfn(), and rt_raster_from_band().

Here is the call graph for this function:

Here is the caller graph for this function: