PostGIS  2.4.9dev-r@@SVN_REVISION@@

◆ lwgeom_write_to_buffer()

static int lwgeom_write_to_buffer ( const LWGEOM geom,
TWKB_GLOBALS globals,
TWKB_STATE parent_state 
)
static

Definition at line 411 of file lwout_twkb.c.

References TWKB_STATE::accum_rels, TWKB_STATE::bbox_max, TWKB_STATE::bbox_min, bytebuffer_append_byte(), bytebuffer_append_bytebuffer(), bytebuffer_append_uvarint(), bytebuffer_destroy_buffer(), bytebuffer_getlength(), bytebuffer_init_with_size(), TWKB_GLOBALS::factor, FIRST_BYTE_SET_BBOXES, FIRST_BYTE_SET_EMPTY, FIRST_BYTE_SET_EXTENDED, FIRST_BYTE_SET_IDLIST, FIRST_BYTE_SET_SIZES, TWKB_STATE::geom_buf, TWKB_STATE::header_buf, HIGHER_DIM_SET_HASM, HIGHER_DIM_SET_HASZ, HIGHER_DIM_SET_PRECM, HIGHER_DIM_SET_PRECZ, TWKB_STATE::idlist, LWDEBUG, lwerror(), lwgeom_has_m(), lwgeom_has_z(), lwgeom_is_empty(), lwgeom_ndims(), lwgeom_to_twkb_buf(), lwgeom_twkb_type(), MAX_N_DIMS, TWKB_GLOBALS::prec_m, TWKB_GLOBALS::prec_xy, TWKB_GLOBALS::prec_z, sizeof_bbox(), TWKB_BBOX, TWKB_SIZE, TYPE_PREC_SET_PREC, TYPE_PREC_SET_TYPE, TWKB_GLOBALS::variant, write_bbox(), and zigzag8().

Referenced by lwcollection_to_twkb_buf(), and lwgeom_to_twkb_with_idlist().

412 {
413  int i, is_empty, has_z, has_m, ndims;
414  size_t bbox_size = 0, optional_precision_byte = 0;
415  uint8_t flag = 0, type_prec = 0;
416  bytebuffer_t header_bytebuffer, geom_bytebuffer;
417 
418  TWKB_STATE child_state;
419  memset(&child_state, 0, sizeof(TWKB_STATE));
420  child_state.header_buf = &header_bytebuffer;
421  child_state.geom_buf = &geom_bytebuffer;
422  child_state.idlist = parent_state->idlist;
423 
424  bytebuffer_init_with_size(child_state.header_buf, 16);
425  bytebuffer_init_with_size(child_state.geom_buf, 64);
426 
427  /* Read dimensionality from input */
428  has_z = lwgeom_has_z(geom);
429  has_m = lwgeom_has_m(geom);
430  ndims = lwgeom_ndims(geom);
431  is_empty = lwgeom_is_empty(geom);
432 
433  /* Do we need extended precision? If we have a Z or M we do. */
434  optional_precision_byte = (has_z || has_m);
435 
436  /* Both X and Y dimension use the same precision */
437  globals->factor[0] = pow(10, globals->prec_xy);
438  globals->factor[1] = globals->factor[0];
439 
440  /* Z and M dimensions have their own precisions */
441  if ( has_z )
442  globals->factor[2] = pow(10, globals->prec_z);
443  if ( has_m )
444  globals->factor[2 + has_z] = pow(10, globals->prec_m);
445 
446  /* Reset stats */
447  for ( i = 0; i < MAX_N_DIMS; i++ )
448  {
449  /* Reset bbox calculation */
450  child_state.bbox_max[i] = INT64_MIN;
451  child_state.bbox_min[i] = INT64_MAX;
452  /* Reset acumulated delta values to get absolute values on next point */
453  child_state.accum_rels[i] = 0;
454  }
455 
456  /* TYPE/PRECISION BYTE */
457  if ( abs(globals->prec_xy) > 7 )
458  lwerror("%s: X/Z precision cannot be greater than 7 or less than -7", __func__);
459 
460  /* Read the TWKB type number from the geometry */
461  TYPE_PREC_SET_TYPE(type_prec, lwgeom_twkb_type(geom));
462  /* Zig-zag the precision value before encoding it since it is a signed value */
463  TYPE_PREC_SET_PREC(type_prec, zigzag8(globals->prec_xy));
464  /* Write the type and precision byte */
465  bytebuffer_append_byte(child_state.header_buf, type_prec);
466 
467  /* METADATA BYTE */
468  /* Set first bit if we are going to store bboxes */
469  FIRST_BYTE_SET_BBOXES(flag, (globals->variant & TWKB_BBOX) && ! is_empty);
470  /* Set second bit if we are going to store resulting size */
471  FIRST_BYTE_SET_SIZES(flag, globals->variant & TWKB_SIZE);
472  /* There will be no ID-list (for now) */
473  FIRST_BYTE_SET_IDLIST(flag, parent_state->idlist && ! is_empty);
474  /* Are there higher dimensions */
475  FIRST_BYTE_SET_EXTENDED(flag, optional_precision_byte);
476  /* Empty? */
477  FIRST_BYTE_SET_EMPTY(flag, is_empty);
478  /* Write the header byte */
479  bytebuffer_append_byte(child_state.header_buf, flag);
480 
481  /* EXTENDED PRECISION BYTE (OPTIONAL) */
482  /* If needed, write the extended dim byte */
483  if( optional_precision_byte )
484  {
485  uint8_t flag = 0;
486 
487  if ( has_z && ( globals->prec_z > 7 || globals->prec_z < 0 ) )
488  lwerror("%s: Z precision cannot be negative or greater than 7", __func__);
489 
490  if ( has_m && ( globals->prec_m > 7 || globals->prec_m < 0 ) )
491  lwerror("%s: M precision cannot be negative or greater than 7", __func__);
492 
493  HIGHER_DIM_SET_HASZ(flag, has_z);
494  HIGHER_DIM_SET_HASM(flag, has_m);
495  HIGHER_DIM_SET_PRECZ(flag, globals->prec_z);
496  HIGHER_DIM_SET_PRECM(flag, globals->prec_m);
497  bytebuffer_append_byte(child_state.header_buf, flag);
498  }
499 
500  /* It the geometry is empty, we're almost done */
501  if ( is_empty )
502  {
503  /* If this output is sized, write the size of */
504  /* all following content, which is zero because */
505  /* there is none */
506  if ( globals->variant & TWKB_SIZE )
507  bytebuffer_append_byte(child_state.header_buf, 0);
508 
509  bytebuffer_append_bytebuffer(parent_state->geom_buf, child_state.header_buf);
511  bytebuffer_destroy_buffer(child_state.geom_buf);
512  return 0;
513  }
514 
515  /* Write the TWKB into the output buffer */
516  lwgeom_to_twkb_buf(geom, globals, &child_state);
517 
518  /*If we have a header_buf, we know that this function is called inside a collection*/
519  /*and then we have to merge the bboxes of the included geometries*/
520  /*and put the result to the parent (the collection)*/
521  if( (globals->variant & TWKB_BBOX) && parent_state->header_buf )
522  {
523  LWDEBUG(4,"Merge bboxes");
524  for ( i = 0; i < ndims; i++ )
525  {
526  if(child_state.bbox_min[i]<parent_state->bbox_min[i])
527  parent_state->bbox_min[i] = child_state.bbox_min[i];
528  if(child_state.bbox_max[i]>parent_state->bbox_max[i])
529  parent_state->bbox_max[i] = child_state.bbox_max[i];
530  }
531  }
532 
533  /* Did we have a box? If so, how big? */
534  bbox_size = 0;
535  if( globals->variant & TWKB_BBOX )
536  {
537  LWDEBUG(4,"We want boxes and will calculate required size");
538  bbox_size = sizeof_bbox(&child_state, ndims);
539  }
540 
541  /* Write the size if wanted */
542  if( globals->variant & TWKB_SIZE )
543  {
544  /* Here we have to add what we know will be written to header */
545  /* buffer after size value is written */
546  size_t size_to_register = bytebuffer_getlength(child_state.geom_buf);
547  size_to_register += bbox_size;
548  bytebuffer_append_uvarint(child_state.header_buf, size_to_register);
549  }
550 
551  if( globals->variant & TWKB_BBOX )
552  write_bbox(&child_state, ndims);
553 
554  bytebuffer_append_bytebuffer(parent_state->geom_buf,child_state.header_buf);
555  bytebuffer_append_bytebuffer(parent_state->geom_buf,child_state.geom_buf);
556 
558  bytebuffer_destroy_buffer(child_state.geom_buf);
559  return 0;
560 }
#define FIRST_BYTE_SET_EMPTY(flag, bool)
Definition: lwout_twkb.h:57
float factor[4]
Definition: lwout_twkb.h:82
#define HIGHER_DIM_SET_PRECM(flag, prec)
Definition: lwout_twkb.h:73
#define TYPE_PREC_SET_TYPE(flag, type)
Macros for manipulating the &#39;type_precision&#39; int.
Definition: lwout_twkb.h:66
void bytebuffer_append_bytebuffer(bytebuffer_t *write_to, bytebuffer_t *write_from)
Writes a uint8_t value to the buffer.
Definition: bytebuffer.c:224
uint8_t variant
Definition: lwout_twkb.h:78
static int lwgeom_to_twkb_buf(const LWGEOM *geom, TWKB_GLOBALS *globals, TWKB_STATE *ts)
Definition: lwout_twkb.c:366
void bytebuffer_append_byte(bytebuffer_t *s, const uint8_t val)
Writes a uint8_t value to the buffer.
Definition: bytebuffer.c:197
static uint8_t lwgeom_twkb_type(const LWGEOM *geom)
Definition: lwout_twkb.c:31
#define LWDEBUG(level, msg)
Definition: lwgeom_log.h:83
static void write_bbox(TWKB_STATE *ts, int ndims)
Writes the bbox in varints in the form: xmin, xdelta, ymin, ydelta.
Definition: lwout_twkb.c:89
#define HIGHER_DIM_SET_HASZ(flag, bool)
Definition: lwout_twkb.h:69
size_t bytebuffer_getlength(const bytebuffer_t *s)
Returns the length of the current buffer.
Definition: bytebuffer.c:377
int lwgeom_has_z(const LWGEOM *geom)
Return LW_TRUE if geometry has Z ordinates.
Definition: lwgeom.c:885
int lwgeom_ndims(const LWGEOM *geom)
Return the number of dimensions (2, 3, 4) in a geometry.
Definition: lwgeom.c:899
int8_t prec_z
Definition: lwout_twkb.h:80
uint8_t zigzag8(int8_t val)
Definition: varint.c:182
bytebuffer_t * header_buf
Definition: lwout_twkb.h:88
static size_t sizeof_bbox(TWKB_STATE *ts, int ndims)
Calculates the size of the bbox in varints in the form: xmin, xdelta, ymin, ydelta.
Definition: lwout_twkb.c:72
int64_t accum_rels[MAX_N_DIMS]
Definition: lwout_twkb.h:95
const int64_t * idlist
Definition: lwout_twkb.h:92
#define FIRST_BYTE_SET_SIZES(flag, bool)
Definition: lwout_twkb.h:54
void bytebuffer_append_uvarint(bytebuffer_t *b, const uint64_t val)
Writes a unsigned varInt to the buffer.
Definition: bytebuffer.c:252
int8_t prec_xy
Definition: lwout_twkb.h:79
#define FIRST_BYTE_SET_BBOXES(flag, bool)
Header true/false flags.
Definition: lwout_twkb.h:53
int8_t prec_m
Definition: lwout_twkb.h:81
#define TYPE_PREC_SET_PREC(flag, prec)
Definition: lwout_twkb.h:67
#define MAX_N_DIMS
Definition: lwout_twkb.h:43
#define HIGHER_DIM_SET_PRECZ(flag, prec)
Definition: lwout_twkb.h:72
#define TWKB_BBOX
Definition: liblwgeom.h:2091
void bytebuffer_init_with_size(bytebuffer_t *s, size_t size)
Allocate just the internal buffer of an existing bytebuffer_t struct.
Definition: bytebuffer.c:71
#define FIRST_BYTE_SET_EXTENDED(flag, bool)
Definition: lwout_twkb.h:56
int64_t bbox_max[MAX_N_DIMS]
Definition: lwout_twkb.h:94
#define TWKB_SIZE
Definition: liblwgeom.h:2092
#define HIGHER_DIM_SET_HASM(flag, bool)
Definition: lwout_twkb.h:70
int lwgeom_is_empty(const LWGEOM *geom)
Return true or false depending on whether a geometry is an "empty" geometry (no vertices members) ...
Definition: lwgeom.c:1346
bytebuffer_t * geom_buf
Definition: lwout_twkb.h:89
unsigned char uint8_t
Definition: uthash.h:79
int lwgeom_has_m(const LWGEOM *geom)
Return LW_TRUE if geometry has M ordinates.
Definition: lwgeom.c:892
#define FIRST_BYTE_SET_IDLIST(flag, bool)
Definition: lwout_twkb.h:55
void lwerror(const char *fmt,...)
Write a notice out to the error handler.
Definition: lwutil.c:190
void bytebuffer_destroy_buffer(bytebuffer_t *s)
Free the bytebuffer_t and all memory managed within it.
Definition: bytebuffer.c:104
int64_t bbox_min[MAX_N_DIMS]
Definition: lwout_twkb.h:93
Here is the call graph for this function:
Here is the caller graph for this function: