PostGIS  2.5.7dev-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.

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

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

Here is the call graph for this function:
Here is the caller graph for this function: