rt_band_set_pixel_line()

rt_errorstate rt_band_set_pixel_line	(	rt_band	band,
		int	x,
		int	y,
		void *	vals,
		uint32_t	len
	)

Set values of multiple pixels.

Unlike rt_band_set_pixel, values in vals are expected to be of the band's pixel type as this function uses memcpy.

It is important to be careful when using this function as the number of values being set may exceed a pixel "row". Remember that the band values are stored in a stream (1-D array) regardless of what the raster's width and height might be. So, setting a number of values may cross multiple pixel "rows".

Parameters

band	: the band to set value to
x	: pixel column (0-based)
y	: pixel row (0-based)
vals	: the pixel values to apply
len	: # of elements in vals

Returns

ES_NONE on success, ES_ERROR on error

Unlike rt_band_set_pixel, values in vals are expected to be of the band's pixel type as this function uses memcpy.

It is important to be careful when using this function as the number of values being set may exceed a pixel "row". Remember that the band values are stored in a stream (1-D array) regardless of what the raster's width and height might be. So, setting a number of values may cross multiple pixel "rows".

Parameters

band	: the band to set value to
x	: X coordinate (0-based)
y	: Y coordinate (0-based)
vals	: the pixel values to apply
len	: # of elements in vals

Returns

ES_NONE on success, ES_ERROR on error

Definition at line 853 of file rt_band.c.

  {
        rt_pixtype pixtype = PT_END;
        int size = 0;
        uint8_t *data = NULL;
        uint32_t offset = 0;
 
        assert(NULL != band);
        assert(vals != NULL && len > 0);
 
        RASTER_DEBUGF(3, "length of values = %d", len);
 
        if (band->offline) {
                rterror("rt_band_set_pixel_line not implemented yet for OFFDB bands");
                return ES_ERROR;
        }
 
        pixtype = band->pixtype;
        size = rt_pixtype_size(pixtype);
 
        if (
                x < 0 || x >= band->width ||
                y < 0 || y >= band->height
        ) {
                rterror("rt_band_set_pixel_line: Coordinates out of range (%d, %d) vs (%d, %d)", x, y, band->width, band->height);
                return ES_ERROR;
        }
 
        data = rt_band_get_data(band);
        offset = x + (y * band->width);
        RASTER_DEBUGF(4, "offset = %d", offset);
 
        /* make sure len of values to copy don't exceed end of data */
        if (len > (band->width * band->height) - offset) {
                rterror("rt_band_set_pixel_line: Could not apply pixels as values length exceeds end of data");
                return ES_ERROR;
        }
 
        switch (pixtype) {
                case PT_1BB:
                case PT_2BUI:
                case PT_4BUI:
                case PT_8BUI:
                case PT_8BSI: {
                        uint8_t *ptr = data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                case PT_16BUI: {
                        uint16_t *ptr = (uint16_t *) data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                case PT_16BSI: {
                        int16_t *ptr = (int16_t *) data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                case PT_32BUI: {
                        uint32_t *ptr = (uint32_t *) data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                case PT_32BSI: {
                        int32_t *ptr = (int32_t *) data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                case PT_32BF: {
                        float *ptr = (float *) data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                case PT_64BF: {
                        double *ptr = (double *) data;
                        ptr += offset;
                        memcpy(ptr, vals, size * len);
                        break;
                }
                default: {
                        rterror("rt_band_set_pixel_line: Unknown pixeltype %d", pixtype);
                        return ES_ERROR;
                }
        }
 
#if POSTGIS_DEBUG_LEVEL > 0
        {
                double value;
                rt_band_get_pixel(band, x, y, &value, NULL);
                RASTER_DEBUGF(4, "pixel at (%d, %d) = %f", x, y, value);
        }
#endif
 
        /* set band's isnodata flag to FALSE */
        if (rt_band_get_hasnodata_flag(band))
                rt_band_set_isnodata_flag(band, 0);
 
        return ES_NONE;
}

References ES_ERROR, ES_NONE, PT_16BSI, PT_16BUI, PT_1BB, PT_2BUI, PT_32BF, PT_32BSI, PT_32BUI, PT_4BUI, PT_64BF, PT_8BSI, PT_8BUI, PT_END, RASTER_DEBUGF, rt_band_get_data(), rt_band_get_hasnodata_flag(), rt_band_get_pixel(), rt_band_set_isnodata_flag(), rt_pixtype_size(), and rterror().

Referenced by RASTER_tile(), RASTER_union_transfn(), and rt_raster_from_gdal_dataset().

Here is the call graph for this function:

Here is the caller graph for this function: