rt_raster_add_band()

int rt_raster_add_band	(	rt_raster	raster,
		rt_band	band,
		int	index
	)

Add band data to a raster.

Parameters

raster	: the raster to add a band to
band	: the band to add, ownership left to caller. Band dimensions are required to match with raster ones.
index	: the position where to insert the new band (0 based)

Returns

identifier (position) for the just-added raster, or -1 on error

Definition at line 405 of file rt_raster.c.

                                                              {
    rt_band *oldbands = NULL;
    rt_band oldband = NULL;
    rt_band tmpband = NULL;
    uint16_t i = 0;
 
    assert(NULL != raster);
                assert(NULL != band);
 
    RASTER_DEBUGF(3, "Adding band %p to raster %p", band, raster);
 
    if (band->width != raster->width || band->height != raster->height) {
        rterror("rt_raster_add_band: Can't add a %dx%d band to a %dx%d raster",
                band->width, band->height, raster->width, raster->height);
        return -1;
    }
 
    if (index > raster->numBands)
        index = raster->numBands;
 
    if (index < 0)
        index = 0;
 
    oldbands = raster->bands;
 
    RASTER_DEBUGF(3, "Oldbands at %p", oldbands);
 
    raster->bands = (rt_band*) rtrealloc(raster->bands,
            sizeof (rt_band)*(raster->numBands + 1)
            );
 
    RASTER_DEBUG(3, "Checking bands");
 
    if (NULL == raster->bands) {
        rterror("rt_raster_add_band: Out of virtual memory "
                "reallocating band pointers");
        raster->bands = oldbands;
        return -1;
    }
 
    RASTER_DEBUGF(4, "realloc returned %p", raster->bands);
 
    for (i = 0; i <= raster->numBands; ++i) {
        if (i == index) {
            oldband = raster->bands[i];
            raster->bands[i] = band;
        } else if (i > index) {
            tmpband = raster->bands[i];
            raster->bands[i] = oldband;
            oldband = tmpband;
        }
    }
 
                band->raster = raster;
 
    raster->numBands++;
 
    RASTER_DEBUGF(4, "Raster now has %d bands", raster->numBands);
 
    return index;
}

References RASTER_DEBUG, RASTER_DEBUGF, rterror(), and rtrealloc().

Referenced by convert_raster(), cu_add_band(), RASTER_addBandOutDB(), RASTER_clip(), RASTER_tile(), rt_raster_colormap(), rt_raster_copy_band(), rt_raster_generate_new_band(), and test_band_metadata().

Here is the call graph for this function:

Here is the caller graph for this function: