rt_band_new_inline()

rt_band rt_band_new_inline	(	uint16_t	width,
		uint16_t	height,
		rt_pixtype	pixtype,
		uint32_t	hasnodata,
		double	nodataval,
		uint8_t *	data
	)

Create an in-db rt_band with no data.

Parameters

width	: number of pixel columns
height	: number of pixel rows
pixtype	: pixel type for the band
hasnodata	: indicates if the band has nodata value
nodataval	: the nodata value, will be appropriately truncated to fit the pixtype size.
data	: pointer to actual band data, required to be aligned accordingly to rt_pixtype_aligment(pixtype) and big enough to hold raster width*height values. Data will NOT be copied, ownership is left to caller which is responsible to keep it allocated for the whole lifetime of the returned rt_band.

Returns

an rt_band or NULL on failure

Parameters

width	: number of pixel columns
height	: number of pixel rows
pixtype	: pixel type for the band
hasnodata	: indicates if the band has nodata value
nodataval	: the nodata value, will be appropriately truncated to fit the pixtype size.
data	: pointer to actual band data, required to be aligned accordingly to rt_pixtype_aligment(pixtype) and big enough to hold raster width*height values. Data will NOT be copied, ownership is left to caller which is responsible to keep it allocated for the whole lifetime of the returned rt_band.

Returns

an rt_band, or 0 on failure

Definition at line 63 of file rt_band.c.

  {
        rt_band band = NULL;
 
        assert(NULL != data);
 
        band = rtalloc(sizeof(struct rt_band_t));
        if (band == NULL) {
                rterror("rt_band_new_inline: Out of memory allocating rt_band");
                return NULL;
        }
 
        RASTER_DEBUGF(3, "Created rt_band @ %p with pixtype %s", band, rt_pixtype_name(pixtype));
 
        band->pixtype = pixtype;
        band->offline = 0;
        band->width = width;
        band->height = height;
        band->hasnodata = hasnodata ? 1 : 0;
        band->isnodata = FALSE; /* we don't know what is in data, so must be FALSE */
        band->nodataval = 0;
        band->data.mem = data;
        band->ownsdata = 0; /* we do NOT own this data!!! */
        band->raster = NULL;
 
        RASTER_DEBUGF(3, "Created rt_band with dimensions %d x %d", band->width, band->height);
 
        /* properly set nodataval as it may need to be constrained to the data type */
        if (hasnodata && rt_band_set_nodata(band, nodataval, NULL) != ES_NONE) {
                rterror("rt_band_new_inline: Could not set NODATA value");
                rt_band_destroy(band);
                return NULL;
        }
 
        return band;
}

References ovdump::band, ovdump::data, ES_NONE, FALSE, RASTER_DEBUGF, rt_band_destroy(), rt_band_set_nodata(), rt_pixtype_name(), rtalloc(), and rterror().

Referenced by cu_add_band(), rt_band_duplicate(), rt_band_reclass(), rt_raster_gdal_rasterize(), rt_raster_generate_new_band(), test_band_metadata(), test_band_pixtype_16BSI(), test_band_pixtype_16BUI(), test_band_pixtype_1BB(), test_band_pixtype_2BUI(), test_band_pixtype_32BF(), test_band_pixtype_32BSI(), test_band_pixtype_32BUI(), test_band_pixtype_4BUI(), test_band_pixtype_64BF(), test_band_pixtype_8BSI(), test_band_pixtype_8BUI(), and test_raster_replace_band().

Here is the call graph for this function:

Here is the caller graph for this function: