Up: Home page for Qhull
Up: Qhull manual: Table of Contents
Up: Programs • Options • Output • Formats • Geomview • Print • Qhull • Precision • Trace
Up: Qhull code: Table of Contents
To: Qhull functions, macros, and data structures
To: Geom • Global • Io • Mem • Merge • Poly • Qhull • Set • Stat • User

io.c -- input and output operations

Qhull provides a wide range of input and output options. To organize the code, most output formats use the same driver:

    qh_printbegin( fp, format, facetlist, facets, printall );

    FORALLfacet_( facetlist )
      qh_printafacet( fp, format, facet, printall );

    FOREACHfacet_( facets )
      qh_printafacet( fp, format, facet, printall );

    qh_printend( fp, format );

Note the 'printall' flag. It selects whether or not qh_skipfacet() is tested.

Copyright © 1995-2012 C.B. Barber

» Geom • Global • Io • Mem • Merge • Poly • Qhull • Set • Stat • User

Index to io.c and io.h

• io.h constants and types
• User level functions
• Print functions for all output formats
• Text output functions
• Text utility functions
• Geomview output functions
• Geomview utility functions

»io.h constants and types

• qh_MAXfirst maximum length of first two lines of stdin
• qh_WHITESPACE possible values of white space
• printvridgeT function to print results of qh_printvdiagram or qh_eachvoronoi

»User level functions

• qh_copyfilename copy filename identified by qh_skipfilename
• qh_eachvoronoi_all visit each Voronoi ridge of the Voronoi diagram
• qh_prepare_output prepare Qhull for output (called by qh_produce_output())
• qh_printhelp_degenerate prints descriptive message for precision error
• qh_printhelp_singular print help message for singular data
• qh_printsummary print summary ('s')
• qh_produce_output prints out the result of qhull()
• qh_produce_output2 prints out the result of qhull() without calling qh_prepare_output()
• qh_readfeasible read interior point from remainder and qh fin ('H')
• qh_readpoints read input points
• qh_setfeasible set interior point from qh feasible_string ('Hn,n,n')
• qh_skipfilename skip filename in string

»Print functions for all output formats

• qh_countfacets count good facets for printing and set visitid
• qh_markkeep mark good facets that meet qh.KEEParea ('PAn'), qh.KEEPmerge ('PMn'), and qh.KEEPminArea ('PFn')
• qh_order_vertexneighbors order neighbors for a 3-d vertex by adjacency ('i', 'o')
• qh_printafacet print facet in an output format
• qh_printbegin print header for an output format
• qh_printend print trailer for an output format
• qh_printfacetlist print facets in a facetlist
• qh_printfacets print facetlist and/or facet set in an output format
• qh_printneighborhood print neighborhood of one or two facets ('Po')
• qh_produce_output print the results of qh_qhull()
• qh_skipfacet True if not printing this facet ('Pdk:n', 'QVn', 'QGn')
• qh_facetvertices return vertices in a set of facets ('p')

»Text output functions

• qh_eachvoronoi print or visit each Voronoi ridge for an input site of the Voronoi diagram
• qh_printextremes print extreme points by point ID (vertices of convex hull) ('Fx')
• qh_printextremes_2d print 2-d extreme points by point ID ('Fx')
• qh_printextremes_d print extreme points of input sites for Delaunay triangulations ('Fx')
• qh_printfacet print all fields of a facet ('f')
• qh_printfacet2math print 2-d Maple or Mathematica output for a facet ('FM' or 'm')
• qh_printfacet3math print 3-d Maple or Mathematica facet ('FM' or 'm')
• qh_printfacet3vertex print vertices for a 3-d facet ('i', 'o')
• qh_printfacetheader prints header fields of a facet ('f')
• qh_printfacetNvertex_nonsimplicial print vertices for an N-d non-simplicial facet ('i', 'Ft')
• qh_printfacetNvertex_simplicial print vertices for an N-d simplicial facet ('i', 'o', 'Ft')
• qh_printfacetridges prints ridges of a facet ('f')
• qh_printpoints_out prints vertices for facets by their point coordinates ('p')
• qh_printridge print all fields for a ridge ('f')
• qh_printvdiagram print voronoi diagram as Voronoi vertices for each input pair
• qh_printvertex print all fields for a vertex ('f')
• qh_printvertexlist print vertices used by a list or set of facets ('f')
• qh_printvertices print a set of vertices ('f')
• qh_printvneighbors print vertex neighbors of vertices ('FN')
• qh_printvoronoi print voronoi diagram in 'o' or 'G' format

»Text utility functions

• dfacet print facet by ID
• dvertex print vertex by ID
• qh_compare_facetarea used by qsort() to order facets by area
• qh_compare_facetmerge used by qsort() to order facets by number of merges
• qh_compare_facetvisit used by qsort() to order facets by visit ID or ID
• qh_compare_vertexpoint used by qsort() to order vertices by point ID
• qh_detvnorm determine normal for Voronoi ridge
• qh_detvridge determine Voronoi ridge for an input site
• qh_detvridge3 determine 3-d Voronoi ridge for an input site
• qh_facet2point return two projected temporary vertices for a 2-d facet ('m', 'G')
• qh_markvoronoi mark Voronoi vertices for printing
• qh_printcenter print facet->center as centrum or Voronoi center ('Ft', 'v p', 'FC', 'f')
• qh_printpoint, qh_printpointid, print coordinates of a point ('p', 'o', 'Fp', 'G', 'f')
• qh_printpoint3 prints 2-d, 3-d, or 4-d point as 3-d coordinates ('G')
• qh_printvdiagram2 print voronoi diagram for each ridge of each vertex from qh_markvoronoi
• qh_printvnorm print separating plane of the Voronoi diagram for a pair of input sites
• qh_printvridge print ridge of the Voronoi diagram for a pair of input sites
• qh_projectdim3 project 2-d 3-d or 4-d point to a 3-d point ('G')

»Geomview output functions

• qh_printfacet2geom print facet as a 2-d VECT object
• qh_printfacet2geom_points print points as a 2-d VECT object with offset
• qh_printfacet3geom_nonsimplicial print Geomview OFF for a 3-d nonsimplicial facet.
• qh_printfacet3geom_points prints a 3-d facet as OFF Geomview object.
• qh_printfacet3geom_simplicial print Geomview OFF for a 3-d simplicial facet.
• qh_printfacet4geom_nonsimplicial print Geomview 4OFF file for a 4d nonsimplicial facet
• qh_printfacet4geom_simplicial print Geomview 4OFF file for a 4d simplicial facet
• qh_printhyperplaneintersection print hyperplane intersection as OFF or 4OFF
• qh_printvoronoi print voronoi diagram in 'o' or 'G' format

»Geomview utility functions

• qh_geomplanes return outer and inner planes for Geomview
• qh_printcentrum print centrum for a facet in OOGL format
• qh_printend4geom helper function for qh_printbegin/printend
• qh_printhyperplaneintersection print Geomview OFF or 4OFF for the intersection of two hyperplanes in 3-d or 4-d
• qh_printline3geom prints a line as a VECT
• qh_printpointvect prints a 2-d or 3-d point as 3-d VECT's
• qh_printpointvect2 prints a 2-d or 3-d point as 2 3-d VECT's
• qh_printspheres prints 3-d vertices as OFF spheres

Up: Home page for Qhull
Up: Qhull manual: Table of Contents
Up: Programs • Options • Output • Formats • Geomview • Print • Qhull • Precision • Trace
Up: Qhull code: Table of Contents
To: Qhull functions, macros, and data structures
To: Geom • Global • Io • Mem • Merge • Poly • Qhull • Set • Stat • User

The Geometry Center Home Page

Comments to: qhull@qhull.org
Created: May 2, 1997 --- Last modified: see top