dig_externs.h

Go to the documentation of this file.

#include <grass/gis.h>
 
#ifndef DIG___EXTERNS___
#define DIG___EXTERNS___
 
/*!
   \file include/grass/vect/dig_externs.h
 
   \brief Function prototypes for diglib (part of vector library)
 */
 
/* allocation.c */
void *dig_alloc_space(int, int *, int, void *,
                      int); /* exits on error, calls _alloc_space () */
void *
dig__alloc_space(int, int *, int, void *,
                 int); /* returns NULL on error, calls calloc(), _frealloc() */
void *dig_falloc(int, int); /* exits on error, calls _falloc () */
void *dig_frealloc(void *, int, int,
                   int);     /* exits on error, calls _frealloc () */
void *dig__falloc(int, int); /* returns NULL on error, calls calloc () */
void *dig__frealloc(void *, int, int,
                    int); /* returns NULL on error, calls calloc () */
 
/* angle.c */
float dig_calc_begin_angle(const struct line_pnts *, double);
float dig_calc_end_angle(const struct line_pnts *, double);
int dig_line_degenerate(const struct line_pnts *);
int dig_is_line_degenerate(const struct line_pnts *, double);
 
/* box.c */
int dig_box_copy(struct bound_box *, struct bound_box *);
int dig_box_extend(struct bound_box *, struct bound_box *);
int dig_line_box(const struct line_pnts *, struct bound_box *);
 
/*
   int dig_line_set_box(struct Plus_head *, plus_t, struct bound_box *);
   int dig_line_get_box(struct Plus_head *, plus_t, struct bound_box *);
 
   int dig_area_bound_box(struct Map_info *, struct P_area *);
   int dig_bound_box2(struct line_pnts *, double *, double *, double *, double
   *, long);
 */
 
/* category index */
/* cindex.c */
int dig_cidx_init(struct Plus_head *);
void dig_cidx_free(struct Plus_head *);
int dig_cidx_add_cat(struct Plus_head *, int, int, int, int);
int dig_cidx_add_cat_sorted(struct Plus_head *, int, int, int, int);
int dig_cidx_del_cat(struct Plus_head *, int, int, int, int);
void dig_cidx_sort(struct Plus_head *);
 
/* cindex_rw.c */
int dig_write_cidx_head(struct gvfile *, struct Plus_head *);
int dig_read_cidx_head(struct gvfile *, struct Plus_head *);
int dig_write_cidx(struct gvfile *, struct Plus_head *);
int dig_read_cidx(struct gvfile *, struct Plus_head *, int);
 
/* file.c */
/* file loaded to memory; mostly unused */
off_t dig_ftell(struct gvfile *file);
int dig_fseek(struct gvfile *file, off_t offset, int whence);
void dig_rewind(struct gvfile *file);
int dig_fflush(struct gvfile *file);
size_t dig_fread(void *ptr, size_t size, size_t nmemb, struct gvfile *file);
size_t dig_fwrite(const void *ptr, size_t size, size_t nmemb,
                  struct gvfile *file);
void dig_file_init(struct gvfile *file);
int dig_file_load(struct gvfile *file);
void dig_file_free(struct gvfile *file);
 
/* frmt.c */
int dig_write_frmt_ascii(FILE *, struct Format_info *, int);
int dig_read_frmt_ascii(FILE *, struct Format_info *);
 
/* head.c */
int dig__write_head(struct Map_info *);
int dig__read_head(struct Map_info *);
 
/* inside.c */
double dig_x_intersect(double, double, double, double, double);
 
/* linecross.c */
int dig_test_for_intersection(double, double, double, double, double, double,
                              double, double);
int dig_find_intersection(double, double, double, double, double, double,
                          double, double, double *, double *);
 
/* line_dist.c */
double dig_distance2_point_to_line(double, double, double, double, double,
                                   double, double, double, double, int,
                                   double *, double *, double *, double *,
                                   int *);
int dig_set_distance_to_line_tolerance(double);
 
/* list.c */
int dig_init_boxlist(struct boxlist *, int);
int dig_boxlist_add(struct boxlist *, int, const struct bound_box *);
 
/* plus.c */
int dig_init_plus(struct Plus_head *);
void dig_free_plus_nodes(struct Plus_head *);
void dig_free_plus_lines(struct Plus_head *);
void dig_free_plus_areas(struct Plus_head *);
void dig_free_plus_isles(struct Plus_head *);
void dig_free_plus(struct Plus_head *);
int dig_load_plus(struct Plus_head *, struct gvfile *, int);
int dig_write_plus_file(struct gvfile *, struct Plus_head *);
int dig_write_nodes(struct gvfile *, struct Plus_head *);
int dig_write_lines(struct gvfile *, struct Plus_head *);
int dig_write_areas(struct gvfile *, struct Plus_head *);
int dig_write_isles(struct gvfile *, struct Plus_head *);
 
/* plus_area.c */
int dig_add_area(struct Plus_head *, int, plus_t *, struct bound_box *);
int dig_area_add_isle(struct Plus_head *, int, int);
int dig_area_del_isle(struct Plus_head *, int, int);
int dig_del_area(struct Plus_head *, int);
int dig_add_isle(struct Plus_head *, int, plus_t *, struct bound_box *);
int dig_del_isle(struct Plus_head *, int);
int dig_build_area_with_line(struct Plus_head *, plus_t, int, plus_t **);
int dig_angle_next_line(struct Plus_head *, plus_t, int, int, float *);
int dig_node_angle_check(struct Plus_head *, int, int);
int dig_area_get_box(struct Plus_head *, plus_t, struct bound_box *);
int dig_isle_get_box(struct Plus_head *, plus_t, struct bound_box *);
 
/* plus_line.c */
int dig_add_line(struct Plus_head *, int, const struct line_pnts *,
                 const struct bound_box *, off_t);
int dig_restore_line(struct Plus_head *, int, int, const struct line_pnts *,
                     const struct bound_box *, off_t);
int dig_del_line(struct Plus_head *, int, double, double, double);
plus_t dig_line_get_area(struct Plus_head *, plus_t, int);
int dig_line_set_area(struct Plus_head *, plus_t, int, plus_t);
 
/* plus_node.c */
int dig_add_node(struct Plus_head *, double, double, double);
int dig_which_node(struct Plus_head *, double, double, double);
 
int dig_node_add_line(struct Plus_head *, int, int, const struct line_pnts *,
                      int);
float dig_node_line_angle(struct Plus_head *, int, int);
 
/* plus_struct.c */
int dig_Rd_P_node(struct Plus_head *, int i, struct gvfile *);
int dig_Wr_P_node(struct Plus_head *, int i, struct gvfile *);
int dig_Rd_P_line(struct Plus_head *, int i, struct gvfile *);
int dig_Wr_P_line(struct Plus_head *, int i, struct gvfile *);
int dig_Rd_P_area(struct Plus_head *, int i, struct gvfile *);
int dig_Wr_P_area(struct Plus_head *, int i, struct gvfile *);
int dig_Rd_P_isle(struct Plus_head *, int i, struct gvfile *);
int dig_Wr_P_isle(struct Plus_head *, int i, struct gvfile *);
int dig_Rd_Plus_head(struct gvfile *, struct Plus_head *);
int dig_Wr_Plus_head(struct gvfile *, struct Plus_head *);
 
/* poly.c */
int dig_find_area_poly(struct line_pnts *, double *);
double dig_find_poly_orientation(struct line_pnts *);
int dig_get_poly_points(int, struct line_pnts **, int *, struct line_pnts *);
 
/* portable.c */
void dig_init_portable(struct Port_info *, int);
int dig__byte_order_out(void);
 
/* int dig__set_cur_head (struct dig_head *); */
int dig_set_cur_port(struct Port_info *);
 
int dig__fread_port_D(double *, size_t, struct gvfile *);
int dig__fread_port_F(float *, size_t, struct gvfile *);
int dig__fread_port_O(off_t *, size_t, struct gvfile *, size_t);
int dig__fread_port_L(long *, size_t, struct gvfile *);
int dig__fread_port_S(short *, size_t, struct gvfile *);
int dig__fread_port_I(int *, size_t, struct gvfile *);
int dig__fread_port_P(plus_t *, size_t, struct gvfile *);
int dig__fread_port_C(char *, size_t, struct gvfile *);
int dig__fwrite_port_D(const double *, size_t, struct gvfile *);
int dig__fwrite_port_F(const float *, size_t, struct gvfile *);
int dig__fwrite_port_O(const off_t *, size_t, struct gvfile *, size_t);
int dig__fwrite_port_L(const long *, size_t, struct gvfile *);
int dig__fwrite_port_S(const short *, size_t, struct gvfile *);
int dig__fwrite_port_I(const int *, size_t, struct gvfile *);
int dig__fwrite_port_P(const plus_t *, size_t, struct gvfile *);
int dig__fwrite_port_C(const char *, size_t, struct gvfile *);
 
/* port_init.c */
 
/* port_test.c */
 
/* prune.c */
int dig_prune(struct line_pnts *, double);
 
/* spatial index */
/* spindex.c */
int dig_spidx_init(struct Plus_head *);
void dig_spidx_free_nodes(struct Plus_head *);
void dig_spidx_free_lines(struct Plus_head *);
void dig_spidx_free_areas(struct Plus_head *);
void dig_spidx_free_isles(struct Plus_head *);
void dig_spidx_free(struct Plus_head *);
 
int dig_spidx_add_node(struct Plus_head *, int, double, double, double);
int dig_spidx_add_line(struct Plus_head *, int, const struct bound_box *);
int dig_spidx_add_area(struct Plus_head *, int, const struct bound_box *);
int dig_spidx_add_isle(struct Plus_head *, int, const struct bound_box *);
 
int dig_spidx_del_node(struct Plus_head *, int);
int dig_spidx_del_line(struct Plus_head *, int, double, double, double);
int dig_spidx_del_area(struct Plus_head *, int);
int dig_spidx_del_isle(struct Plus_head *, int);
 
int dig_select_nodes(struct Plus_head *, const struct bound_box *,
                     struct ilist *);
int dig_select_lines(struct Plus_head *, const struct bound_box *,
                     struct boxlist *);
int dig_select_areas(struct Plus_head *, const struct bound_box *,
                     struct boxlist *);
int dig_select_isles(struct Plus_head *, const struct bound_box *,
                     struct boxlist *);
int dig_find_node(struct Plus_head *, double, double, double);
int dig_find_line_box(struct Plus_head *, int, struct bound_box *);
int dig_find_area_box(struct Plus_head *, int, struct bound_box *);
int dig_find_isle_box(struct Plus_head *, int, struct bound_box *);
 
/* spindex_rw.c */
int dig_Rd_spidx_head(struct gvfile *, struct Plus_head *);
int dig_Wr_spidx_head(struct gvfile *, struct Plus_head *);
int dig_Wr_spidx(struct gvfile *, struct Plus_head *);
int dig_Rd_spidx(struct gvfile *, struct Plus_head *);
 
int dig_dump_spidx(FILE *, const struct Plus_head *);
 
int rtree_search(struct RTree *, struct RTree_Rect *, SearchHitCallback, void *,
                 struct Plus_head *);
 
/* struct_alloc.c */
int dig_node_alloc_line(struct P_node *, int);
int dig_alloc_nodes(struct Plus_head *, int);
int dig_alloc_lines(struct Plus_head *, int);
int dig_alloc_areas(struct Plus_head *, int);
int dig_alloc_isles(struct Plus_head *, int);
struct P_node *dig_alloc_node(void);
struct P_line *dig_alloc_line(void);
void *dig_alloc_topo(char);
struct P_area *dig_alloc_area(void);
struct P_isle *dig_alloc_isle(void);
void dig_free_node(struct P_node *);
void dig_free_line(struct P_line *);
void dig_free_area(struct P_area *);
void dig_free_isle(struct P_isle *);
int dig_alloc_points(struct line_pnts *, int);
int dig_alloc_cats(struct line_cats *, int);
int dig_area_alloc_line(struct P_area *, int);
int dig_area_alloc_isle(struct P_area *, int);
int dig_isle_alloc_line(struct P_isle *, int);
int dig_out_of_memory(void);
 
/* type.c */
/* conversion of types */
int dig_type_to_store(int);
int dig_type_from_store(int);
 
/* update.c */
/* list of updated */
void dig_line_reset_updated(struct Plus_head *);
void dig_line_add_updated(struct Plus_head *, int, off_t);
void dig_node_reset_updated(struct Plus_head *);
void dig_node_add_updated(struct Plus_head *, int);
 
/*********************************************************************
 *                    unused/removed functions
 *********************************************************************/
 
char *color_name(int); /* pass it an int, returns the name of the color */
 
char *dig_float_point(char *, int, double);
 
/* double dig_point_in_area (struct Map_info *, double, double, struct P_area
 * *); */
 
double dig_unit_conversion(void);
 
/* portable data routines  -  only to be called by library routines! */
double *dig__double_convert(double *, double *, int, struct dig_head *);
float *dig__float_convert(float *, float *, int, struct dig_head *);
short *dig__short_convert(short *in, short *out, int, struct dig_head *);
long *dig__long_convert(long *, long *, int, struct dig_head *);
long *dig__int_convert(int *, long *, int, struct dig_head *);
long *dig__plus_t_convert(plus_t *, long *, int, struct dig_head *);
int *dig__long_convert_to_int(long *, int *, int, struct dig_head *);
plus_t *dig__long_convert_to_plus_t(long *, plus_t *, int, struct dig_head *);
char *dig__convert_buffer(int);
 
plus_t **dig_get_cont_lines(struct Map_info *, plus_t, double, int);
plus_t dig_get_next_cont_line(struct Map_info *, plus_t, double, int);
 
struct dig_head *dig_get_head(void);
struct dig_head *dig__get_head(void);
 
/* int dig_check_nodes (struct Map_info *, struct new_node *,
 struct line_pnts *); int dig_in_area_bbox (struct P_area *, double, double); */
int dig_start_clock(long *);
int dig_stop_clock(long *);
char *dig_stop_clock_str(long *);
int dig_write_file_checks(struct gvfile *, struct Plus_head *);
int dig_do_file_checks(struct Map_info *, char *, char *);
 
/* int dig_find_area (struct Map_info *, struct P_area *, double *, double *,
   double *, double); int dig_find_area2 (struct Map_info *, struct P_area *,
   double *); */
 
int dig_map_to_head(struct Map_info *, struct Plus_head *);
int dig_head_to_map(struct Plus_head *, struct Map_info *);
int dig_spindex_init(struct Plus_head *);
 
/* int dig_snap_line_to_node (struct Map_info *, int, int, struct line_pnts *);
 */
 
/* int dig_node_del_line (struct Plus_head *plus, int node, int line);
   int dig_add_line_to_node (int, int, char, struct Map_info *, struct line_pnts
   *); */
int dig_point_to_area(struct Map_info *, double, double);
int dig_point_to_next_area(struct Map_info *, double, double, double *);
int dig_point_to_line(struct Map_info *, double, double, char);
 
/* int dig_in_line_bbox (struct P_line *, double, double); */
int dig_check_dist(struct Map_info *, int, double, double, double *);
int dig__check_dist(struct Map_info *, struct line_pnts *, double, double,
                    double *);
/* int dig_center_check (struct P_line *, int, int, double, double); */
int dig_point_by_line(struct Map_info *, double, double, double, double, char);
/* int dig_by_line_bbox (struct P_line *, double, double, double, double); */
int dig_write_head_ascii(FILE *, struct dig_head *);
int dig_read_head_ascii(FILE *, struct dig_head *);
 
int dig_struct_copy(void *, void *, int);
int dig_rmcr(char *);
 
#endif /* DIG__EXTERNS__ */