PostGIS  2.4.9dev-r@@SVN_REVISION@@

◆ 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 58 of file rt_band.c.

References ovdump::band, ovdump::data, rt_band_t::data, ES_NONE, FALSE, rt_band_t::hasnodata, rt_band_t::height, rt_band_t::isnodata, rt_band_t::mem, rt_band_t::nodataval, rt_band_t::offline, rt_band_t::ownsdata, rt_band_t::pixtype, rt_band_t::raster, RASTER_DEBUGF, rt_band_destroy(), rt_band_set_nodata(), rt_pixtype_name(), rtalloc(), rterror(), and rt_band_t::width.

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().

63  {
64  rt_band band = NULL;
65 
66  assert(NULL != data);
67 
68  band = rtalloc(sizeof(struct rt_band_t));
69  if (band == NULL) {
70  rterror("rt_band_new_inline: Out of memory allocating rt_band");
71  return NULL;
72  }
73 
74  RASTER_DEBUGF(3, "Created rt_band @ %p with pixtype %s", band, rt_pixtype_name(pixtype));
75 
76  band->pixtype = pixtype;
77  band->offline = 0;
78  band->width = width;
79  band->height = height;
80  band->hasnodata = hasnodata ? 1 : 0;
81  band->isnodata = FALSE; /* we don't know what is in data, so must be FALSE */
82  band->nodataval = 0;
83  band->data.mem = data;
84  band->ownsdata = 0; /* we do NOT own this data!!! */
85  band->raster = NULL;
86 
87  RASTER_DEBUGF(3, "Created rt_band with dimensions %d x %d", band->width, band->height);
88 
89  /* properly set nodataval as it may need to be constrained to the data type */
90  if (hasnodata && rt_band_set_nodata(band, nodataval, NULL) != ES_NONE) {
91  rterror("rt_band_new_inline: Could not set NODATA value");
92  rt_band_destroy(band);
93  return NULL;
94  }
95 
96  return band;
97 }
rt_errorstate rt_band_set_nodata(rt_band band, double val, int *converted)
Set nodata value.
Definition: rt_band.c:600
rt_raster raster
Definition: librtcore.h:2275
rt_pixtype pixtype
Definition: librtcore.h:2265
band
Definition: ovdump.py:57
void rterror(const char *fmt,...)
Wrappers used for reporting errors and info.
Definition: rt_context.c:199
void * rtalloc(size_t size)
Wrappers used for managing memory.
Definition: rt_context.c:171
data
Definition: ovdump.py:103
uint16_t height
Definition: librtcore.h:2268
union rt_band_t::@6 data
int8_t ownsdata
Definition: librtcore.h:2273
double nodataval
Definition: librtcore.h:2272
#define RASTER_DEBUGF(level, msg,...)
Definition: librtcore.h:299
uint16_t width
Definition: librtcore.h:2267
void rt_band_destroy(rt_band band)
Destroy a raster band.
Definition: rt_band.c:242
int32_t offline
Definition: librtcore.h:2266
int32_t isnodata
Definition: librtcore.h:2270
#define FALSE
Definition: dbfopen.c:168
const char * rt_pixtype_name(rt_pixtype pixtype)
Definition: rt_pixel.c:110
void * mem
Definition: librtcore.h:2278
int32_t hasnodata
Definition: librtcore.h:2269
Here is the call graph for this function:
Here is the caller graph for this function: