139 lines
3.6 KiB
C
139 lines
3.6 KiB
C
/**********************************************************************
|
|
*
|
|
* PostGIS - Spatial Types for PostgreSQL
|
|
* http://postgis.net
|
|
*
|
|
* Copyright (C) 2012 Sandro Santilli <strk@kbt.io>
|
|
*
|
|
* This is free software; you can redistribute and/or modify it under
|
|
* the terms of the GNU General Public Licence. See the COPYING file.
|
|
*
|
|
**********************************************************************/
|
|
|
|
#ifndef LWGEOM_CACHE_H_
|
|
#define LWGEOM_CACHE_H_ 1
|
|
|
|
#include "postgres.h"
|
|
#include "fmgr.h"
|
|
|
|
#include "liblwgeom.h"
|
|
#include "lwgeodetic_tree.h"
|
|
#include "lwgeom_pg.h"
|
|
|
|
|
|
#define TOAST_CACHE_ENTRY 0
|
|
#define PREP_CACHE_ENTRY 1
|
|
#define RTREE_CACHE_ENTRY 2
|
|
#define CIRC_CACHE_ENTRY 3
|
|
#define RECT_CACHE_ENTRY 4
|
|
#define SRSDESC_CACHE_ENTRY 5
|
|
#define SRID_CACHE_ENTRY 6
|
|
|
|
#define NUM_CACHE_ENTRIES 7
|
|
|
|
/* Returns the MemoryContext used to store the caches */
|
|
MemoryContext PostgisCacheContext(FunctionCallInfo fcinfo);
|
|
|
|
typedef struct {
|
|
GSERIALIZED *geom;
|
|
uint32_t count;
|
|
} SHARED_GSERIALIZED;
|
|
|
|
SHARED_GSERIALIZED *shared_gserialized_new_nocache(Datum d);
|
|
SHARED_GSERIALIZED *shared_gserialized_new_cached(FunctionCallInfo fcinfo, Datum d);
|
|
SHARED_GSERIALIZED *shared_gserialized_ref(FunctionCallInfo fcinfo, SHARED_GSERIALIZED *ref);
|
|
void shared_gserialized_unref(FunctionCallInfo fcinfo, SHARED_GSERIALIZED *ref);
|
|
bool shared_gserialized_equal(SHARED_GSERIALIZED *r1, SHARED_GSERIALIZED *r2);
|
|
const GSERIALIZED *shared_gserialized_get(SHARED_GSERIALIZED *s);
|
|
|
|
/*
|
|
* A generic GeomCache just needs space for the cache type,
|
|
* the cache keys (GSERIALIZED geometries), the key sizes,
|
|
* and the argument number the cached index/tree is going
|
|
* to refer to.
|
|
*/
|
|
typedef struct {
|
|
uint32_t type;
|
|
uint32 argnum;
|
|
SHARED_GSERIALIZED *geom1;
|
|
SHARED_GSERIALIZED *geom2;
|
|
} GeomCache;
|
|
|
|
/*
|
|
* Other specific geometry cache types are the
|
|
* RTreeGeomCache - lwgeom_rtree.h
|
|
* PrepGeomCache - lwgeom_geos_prepared.h
|
|
*/
|
|
|
|
/**
|
|
* Generic signature for functions to manage a geometry
|
|
* cache structure.
|
|
*/
|
|
typedef struct
|
|
{
|
|
uint32_t entry_number; /* What kind of structure is this? */
|
|
int (*GeomIndexBuilder)(const LWGEOM* lwgeom, GeomCache* cache); /* Build an index/tree and add it to your cache */
|
|
int (*GeomIndexFreer)(GeomCache* cache); /* Free the index/tree in your cache */
|
|
GeomCache* (*GeomCacheAllocator)(void); /* Allocate the kind of cache object you use (GeomCache+some extra space) */
|
|
} GeomCacheMethods;
|
|
|
|
/*
|
|
* Cache retrieval functions
|
|
*/
|
|
GeomCache *GetGeomCache(FunctionCallInfo fcinfo,
|
|
const GeomCacheMethods *cache_methods,
|
|
SHARED_GSERIALIZED *g1,
|
|
SHARED_GSERIALIZED *g2);
|
|
|
|
/******************************************************************************/
|
|
|
|
#define ToastCacheSize 2
|
|
|
|
typedef struct
|
|
{
|
|
Oid valueid;
|
|
Oid toastrelid;
|
|
SHARED_GSERIALIZED *geom;
|
|
} ToastCacheArgument;
|
|
|
|
typedef struct
|
|
{
|
|
int type;
|
|
ToastCacheArgument arg[ToastCacheSize];
|
|
} ToastCache;
|
|
|
|
SHARED_GSERIALIZED *ToastCacheGetGeometry(FunctionCallInfo fcinfo, uint32_t argnum);
|
|
|
|
/******************************************************************************/
|
|
|
|
#define SRSDescCacheSize 1
|
|
typedef struct {
|
|
int32_t srid;
|
|
bool short_mode;
|
|
char *srs;
|
|
} SRSDescCacheArgument;
|
|
|
|
typedef struct {
|
|
int type;
|
|
SRSDescCacheArgument arg[SRSDescCacheSize];
|
|
} SRSDescCache;
|
|
|
|
const char *GetSRSCacheBySRID(FunctionCallInfo fcinfo, int32_t srid, bool short_crs);
|
|
|
|
/******************************************************************************/
|
|
|
|
#define SRIDCacheSize 1
|
|
typedef struct {
|
|
char *srs;
|
|
int32_t srid;
|
|
} SRIDCacheArgument;
|
|
|
|
typedef struct {
|
|
int type;
|
|
SRIDCacheArgument arg[SRIDCacheSize];
|
|
} SRIDCache;
|
|
|
|
int32_t GetSRIDCacheBySRS(FunctionCallInfo fcinfo, const char *srs);
|
|
|
|
#endif /* LWGEOM_CACHE_H_ */
|