include/libqhull/io.h

0001 /*<html><pre>  -<a                             href="qh-io.htm"
0002   >-------------------------------</a><a name="TOP">-</a>
0003
0004    io.h
0005    declarations of Input/Output functions
0006
0007    see README, libqhull.h and io.c
0008
0009    Copyright (c) 1993-2020 The Geometry Center.
0010    $Id: //main/2019/qhull/src/libqhull/io.h#3 $$Change: 2953 $
0011    $DateTime: 2020/05/21 22:05:32 $$Author: bbarber $
0012 */
0013
0014 #ifndef qhDEFio
0015 #define qhDEFio 1
0016
0017 #include "libqhull.h"
0018
0019 /*============ constants and flags ==================*/
0020
0021 /*-<a                             href="qh-io.htm#TOC"
0022   >--------------------------------</a><a name="qh_MAXfirst">-</a>
0023
0024   qh_MAXfirst
0025     maximum length of first two lines of stdin
0026 */
0027 #define qh_MAXfirst  200
0028
0029 /*-<a                             href="qh-io.htm#TOC"
0030   >--------------------------------</a><a name="qh_MINradius">-</a>
0031
0032   qh_MINradius
0033     min radius for Gp and Gv, fraction of maxcoord
0034 */
0035 #define qh_MINradius 0.02
0036
0037 /*-<a                             href="qh-io.htm#TOC"
0038   >--------------------------------</a><a name="qh_GEOMepsilon">-</a>
0039
0040   qh_GEOMepsilon
0041     adjust outer planes for 'lines closer' and geomview roundoff.
0042     This prevents bleed through.
0043 */
0044 #define qh_GEOMepsilon 2e-3
0045
0046 /*-<a                             href="qh-io.htm#TOC"
0047   >--------------------------------</a><a name="qh_WHITESPACE">-</a>
0048
0049   qh_WHITESPACE
0050     possible values of white space
0051 */
0052 #define qh_WHITESPACE " \n\t\v\r\f"
0053
0054
0055 /*-<a                             href="qh-io.htm#TOC"
0056   >--------------------------------</a><a name="RIDGE">-</a>
0057
0058   qh_RIDGE
0059     to select which ridges to print in qh_eachvoronoi
0060 */
0061 typedef enum
0062 {
0063     qh_RIDGEall= 0, qh_RIDGEinner, qh_RIDGEouter
0064 }
0065 qh_RIDGE;
0066
0067 /*-<a                             href="qh-io.htm#TOC"
0068   >--------------------------------</a><a name="printvridgeT">-</a>
0069
0070   printvridgeT
0071     prints results of qh_printvdiagram
0072
0073   see:
0074     <a href="io.c#printvridge">qh_printvridge</a> for an example
0075 */
0076 typedef void (*printvridgeT)(FILE *fp, vertexT *vertex, vertexT *vertexA, setT *centers, boolT unbounded);
0077
0078 /*============== -prototypes in alphabetical order =========*/
0079
0080 void    qh_dfacet(unsigned int id);
0081 void    qh_dvertex(unsigned int id);
0082 int     qh_compare_facetarea(const void *p1, const void *p2);
0083 int     qh_compare_facetvisit(const void *p1, const void *p2);
0084 int     qh_compare_nummerge(const void *p1, const void *p2);
0085 void    qh_copyfilename(char *filename, int size, const char* source, int length);
0086 void    qh_countfacets(facetT *facetlist, setT *facets, boolT printall,
0087               int *numfacetsp, int *numsimplicialp, int *totneighborsp,
0088               int *numridgesp, int *numcoplanarsp, int *numnumtricoplanarsp);
0089 pointT *qh_detvnorm(vertexT *vertex, vertexT *vertexA, setT *centers, realT *offsetp);
0090 setT   *qh_detvridge(vertexT *vertex);
0091 setT   *qh_detvridge3(vertexT *atvertex, vertexT *vertex);
0092 int     qh_eachvoronoi(FILE *fp, printvridgeT printvridge, vertexT *atvertex, boolT visitall, qh_RIDGE innerouter, boolT inorder);
0093 int     qh_eachvoronoi_all(FILE *fp, printvridgeT printvridge, boolT isUpper, qh_RIDGE innerouter, boolT inorder);
0094 void    qh_facet2point(facetT *facet, pointT **point0, pointT **point1, realT *mindist);
0095 setT   *qh_facetvertices(facetT *facetlist, setT *facets, boolT allfacets);
0096 void    qh_geomplanes(facetT *facet, realT *outerplane, realT *innerplane);
0097 void    qh_markkeep(facetT *facetlist);
0098 setT   *qh_markvoronoi(facetT *facetlist, setT *facets, boolT printall, boolT *isLowerp, int *numcentersp);
0099 void    qh_order_vertexneighbors(vertexT *vertex);
0100 void    qh_prepare_output(void);
0101 void    qh_printafacet(FILE *fp, qh_PRINT format, facetT *facet, boolT printall);
0102 void    qh_printbegin(FILE *fp, qh_PRINT format, facetT *facetlist, setT *facets, boolT printall);
0103 void    qh_printcenter(FILE *fp, qh_PRINT format, const char *string, facetT *facet);
0104 void    qh_printcentrum(FILE *fp, facetT *facet, realT radius);
0105 void    qh_printend(FILE *fp, qh_PRINT format, facetT *facetlist, setT *facets, boolT printall);
0106 void    qh_printend4geom(FILE *fp, facetT *facet, int *num, boolT printall);
0107 void    qh_printextremes(FILE *fp, facetT *facetlist, setT *facets, boolT printall);
0108 void    qh_printextremes_2d(FILE *fp, facetT *facetlist, setT *facets, boolT printall);
0109 void    qh_printextremes_d(FILE *fp, facetT *facetlist, setT *facets, boolT printall);
0110 void    qh_printfacet(FILE *fp, facetT *facet);
0111 void    qh_printfacet2math(FILE *fp, facetT *facet, qh_PRINT format, int notfirst);
0112 void    qh_printfacet2geom(FILE *fp, facetT *facet, realT color[3]);
0113 void    qh_printfacet2geom_points(FILE *fp, pointT *point1, pointT *point2,
0114                                facetT *facet, realT offset, realT color[3]);
0115 void    qh_printfacet3math(FILE *fp, facetT *facet, qh_PRINT format, int notfirst);
0116 void    qh_printfacet3geom_nonsimplicial(FILE *fp, facetT *facet, realT color[3]);
0117 void    qh_printfacet3geom_points(FILE *fp, setT *points, facetT *facet, realT offset, realT color[3]);
0118 void    qh_printfacet3geom_simplicial(FILE *fp, facetT *facet, realT color[3]);
0119 void    qh_printfacet3vertex(FILE *fp, facetT *facet, qh_PRINT format);
0120 void    qh_printfacet4geom_nonsimplicial(FILE *fp, facetT *facet, realT color[3]);
0121 void    qh_printfacet4geom_simplicial(FILE *fp, facetT *facet, realT color[3]);
0122 void    qh_printfacetNvertex_nonsimplicial(FILE *fp, facetT *facet, int id, qh_PRINT format);
0123 void    qh_printfacetNvertex_simplicial(FILE *fp, facetT *facet, qh_PRINT format);
0124 void    qh_printfacetheader(FILE *fp, facetT *facet);
0125 void    qh_printfacetridges(FILE *fp, facetT *facet);
0126 void    qh_printfacets(FILE *fp, qh_PRINT format, facetT *facetlist, setT *facets, boolT printall);
0127 void    qh_printhyperplaneintersection(FILE *fp, facetT *facet1, facetT *facet2,
0128                    setT *vertices, realT color[3]);
0129 void    qh_printline3geom(FILE *fp, pointT *pointA, pointT *pointB, realT color[3]);
0130 void    qh_printneighborhood(FILE *fp, qh_PRINT format, facetT *facetA, facetT *facetB, boolT printall);
0131 void    qh_printpoint(FILE *fp, const char *string, pointT *point);
0132 void    qh_printpointid(FILE *fp, const char *string, int dim, pointT *point, int id);
0133 void    qh_printpoint3(FILE *fp, pointT *point);
0134 void    qh_printpoints_out(FILE *fp, facetT *facetlist, setT *facets, boolT printall);
0135 void    qh_printpointvect(FILE *fp, pointT *point, coordT *normal, pointT *center, realT radius, realT color[3]);
0136 void    qh_printpointvect2(FILE *fp, pointT *point, coordT *normal, pointT *center, realT radius);
0137 void    qh_printridge(FILE *fp, ridgeT *ridge);
0138 void    qh_printspheres(FILE *fp, setT *vertices, realT radius);
0139 void    qh_printvdiagram(FILE *fp, qh_PRINT format, facetT *facetlist, setT *facets, boolT printall);
0140 int     qh_printvdiagram2(FILE *fp, printvridgeT printvridge, setT *vertices, qh_RIDGE innerouter, boolT inorder);
0141 void    qh_printvertex(FILE *fp, vertexT *vertex);
0142 void    qh_printvertexlist(FILE *fp, const char* string, facetT *facetlist,
0143                          setT *facets, boolT printall);
0144 void    qh_printvertices(FILE *fp, const char* string, setT *vertices);
0145 void    qh_printvneighbors(FILE *fp, facetT* facetlist, setT *facets, boolT printall);
0146 void    qh_printvoronoi(FILE *fp, qh_PRINT format, facetT *facetlist, setT *facets, boolT printall);
0147 void    qh_printvnorm(FILE *fp, vertexT *vertex, vertexT *vertexA, setT *centers, boolT unbounded);
0148 void    qh_printvridge(FILE *fp, vertexT *vertex, vertexT *vertexA, setT *centers, boolT unbounded);
0149 void    qh_produce_output(void);
0150 void    qh_produce_output2(void);
0151 void    qh_projectdim3(pointT *source, pointT *destination);
0152 int     qh_readfeasible(int dim, const char *curline);
0153 coordT *qh_readpoints(int *numpoints, int *dimension, boolT *ismalloc);
0154 void    qh_setfeasible(int dim);
0155 boolT   qh_skipfacet(facetT *facet);
0156 char   *qh_skipfilename(char *filename);
0157
0158 #endif /* qhDEFio */