rt_band_new_offline()

rt_band rt_band_new_offline	(	uint16_t	width,
		uint16_t	height,
		rt_pixtype	pixtype,
		uint32_t	hasnodata,
		double	nodataval,
		uint8_t	bandNum,
		const char *	path
	)

Create an out-db rt_band.

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.
bandNum	: 0-based band number in the external file to associate this band with.
path	: NULL-terminated path string pointing to the file containing band data. The string 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.
bandNum	: 0-based band number in the external file to associate this band with.
path	: NULL-terminated path string pointing to the file containing band data. The string 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 283 of file rt_band.c.

  {
        rt_band band = NULL;
        int pathlen = 0;
 
        assert(NULL != path);
 
        band = rtalloc(sizeof(struct rt_band_t));
        if (band == NULL) {
                rterror("rt_band_new_offline: 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 = 1;
        band->width = width;
        band->height = height;
        band->hasnodata = hasnodata ? 1 : 0;
        band->nodataval = 0;
        band->isnodata = FALSE; /* we don't know if the offline band is NODATA */
        band->ownsdata = 0; /* offline, flag is useless as all offline data cache is owned internally */
        band->raster = NULL;
 
        /* 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_offline: Could not set NODATA value");
                rt_band_destroy(band);
                return NULL;
        }
 
        band->data.offline.bandNum = bandNum;
 
        /* memory for data.offline.path is managed internally */
        pathlen = strlen(path);
        band->data.offline.path = rtalloc(sizeof(char) * (pathlen + 1));
        if (band->data.offline.path == NULL) {
                rterror("rt_band_new_offline: Out of memory allocating offline path");
                rt_band_destroy(band);
                return NULL;
        }
        memcpy(band->data.offline.path, path, pathlen);
        band->data.offline.path[pathlen] = '\0';
 
        band->data.offline.mem = NULL;
 
        return band;
}

References ES_NONE, FALSE, RASTER_DEBUGF, rt_band_destroy(), rt_band_set_nodata(), rt_pixtype_name(), rtalloc(), and rterror().

Referenced by convert_raster(), RASTER_tile(), rt_band_duplicate(), rt_band_new_offline_from_path(), and test_band_metadata().

Here is the call graph for this function:

Here is the caller graph for this function: