dig_externs.h

Go to the documentation of this file.

#include <grass/gis.h>

#ifndef  DIG___EXTERNS___
#define DIG___EXTERNS___


/*!
  \file include/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();

/* 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();
struct P_line *dig_alloc_line();
void *dig_alloc_topo(char);
struct P_area *dig_alloc_area();
struct P_isle *dig_alloc_isle();
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__ */