diff options
author | bubnikv <bubnikv@gmail.com> | 2018-09-19 12:02:24 +0300 |
---|---|---|
committer | bubnikv <bubnikv@gmail.com> | 2018-09-19 12:02:24 +0300 |
commit | 0558b53493a77bae44831cf87bb0f59359828ef5 (patch) | |
tree | c3e8dbdf7d91a051c12d9ebbf7606d41047fea96 /src/qhull/src/libqhull/qh-user.htm | |
parent | 3ddaccb6410478ad02d8c0e02d6d8e6eb1785b9f (diff) |
WIP: Moved sources int src/, separated most of the source code from Perl.
The XS was left only for the unit / integration tests, and it links
libslic3r only. No wxWidgets are allowed to be used from Perl starting
from now.
Diffstat (limited to 'src/qhull/src/libqhull/qh-user.htm')
-rw-r--r-- | src/qhull/src/libqhull/qh-user.htm | 271 |
1 files changed, 271 insertions, 0 deletions
diff --git a/src/qhull/src/libqhull/qh-user.htm b/src/qhull/src/libqhull/qh-user.htm new file mode 100644 index 000000000..6682f4b2f --- /dev/null +++ b/src/qhull/src/libqhull/qh-user.htm @@ -0,0 +1,271 @@ +<!-- Do not edit with Front Page, it adds too many spaces --> +<html> +<head> +<meta http-equiv="Content-Type" +content="text/html; charset=iso-8859-1"> +<title>user.c -- user-definable operations</title> +</head> + +<body> +<!-- Navigation links --> +<p><a name="TOP"><b>Up:</b></a> <a +href="http://www.qhull.org">Home page</a> for Qhull<br> +<b>Up:</b> <a href="../../html/index.htm#TOC">Qhull manual</a>: Table of Contents <br> +<b>Up:</b> <a href="../../html/qh-quick.htm#programs">Programs</a> +• <a href="../../html/qh-quick.htm#options">Options</a> +• <a href="../../html/qh-opto.htm#output">Output</a> +• <a href="../../html/qh-optf.htm#format">Formats</a> +• <a href="../../html/qh-optg.htm#geomview">Geomview</a> +• <a href="../../html/qh-optp.htm#print">Print</a> +• <a href="../../html/qh-optq.htm#qhull">Qhull</a> +• <a href="../../html/qh-optc.htm#prec">Precision</a> +• <a href="../../html/qh-optt.htm#trace">Trace</a> +• <a href="index.htm">Functions</a><br> +<b>Up:</b> <a href="../../html/qh-code.htm#TOC">Qhull code: Table of Contents</a><br> +<b>To:</b> <a href="index.htm">Qhull functions</a>, macros, and data structures<br> +<b>To:</b> <a href="qh-geom.htm">Geom</a> • <a href="qh-globa.htm">Global</a> +• <a href="qh-io.htm">Io</a> • <a href="qh-mem.htm">Mem</a> +• <a href="qh-merge.htm">Merge</a> • <a href="qh-poly.htm">Poly</a> +• <a href="qh-qhull.htm">Qhull</a> • <a href="qh-set.htm">Set</a> +• <a href="qh-stat.htm">Stat</a> • <a href="qh-user.htm#TOC">User</a> +</p> +<hr> +<h2>user.c -- user-definable operations</h2> +<blockquote> +<p>This section contains functions and constants that the +user may want to change. </p> + +</blockquote> +<p><b>Copyright © 1995-2015 C.B. Barber</b></p> +<hr> +<p><a href="#TOP">»</a> <a href="qh-geom.htm#TOC">Geom</a> +<a name="TOC">•</a> <a href="qh-globa.htm#TOC">Global</a> +• <a href="qh-io.htm#TOC">Io</a> • <a href="qh-mem.htm#TOC">Mem</a> +• <a href="qh-merge.htm#TOC">Merge</a> • <a href="qh-poly.htm#TOC">Poly</a> +• <a href="qh-qhull.htm#TOC">Qhull</a> • <a href="qh-set.htm#TOC">Set</a> +• <a href="qh-stat.htm#TOC">Stat</a> • <b>User</b> +</p> +<h3>Index to <a href="user.c">user.c</a>, <a href="usermem.c">usermem.c</a>, <a href="userprintf.c">userprintf.c</a>, <a href="userprintf_rbox.c">userprintf_rbox.c</a> and +<a href="user.h">user.h</a></h3> +<ul> +<li><a href="#qulllib">qhull library constants</a></li> +<li><a href="#utype">user.h data types and +configuration macros</a> </li> +<li><a href="#ujoggle">joggle constants</a></li> +<li><a href="#uperform">performance related constants</a></li> +<li><a href="#umemory">memory constants</a></li> +<li><a href="#ucond">conditional compilation</a></li> +<li><a href="#umerge">merge constants</a> </li> +<li><a href="#ufunc">user.c functions</a> </li> +<li><a href="#u2func">usermem.c functions</a> </li> +<li><a href="#u3func">userprintf.c functions</a> </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="qulllib">Qhull library constants</a></h3> +<ul> +<li><a href="user.h#filenamelen">FILENAMElen</a> -- max length of TI or TO filename </li> +<li><a href="user.h#msgcode">msgcode</a> -- unique message codes for qh_fprintf </li> +<li><a href="user.h#qh_OPTIONline">qh_OPTIONline</a> -- max length of option line ('FO')</li> +</ul> + + +<h3><a href="qh-user.htm#TOC">»</a><a name="utype">user.h data +types and configuration macros</a></h3> +<ul> +<li><a href="user.h#realT">realT, qh_REAL...</a> size +of floating point numbers </li> +<li><a href="user.h#countT">countT, COUNTmax</a> size +of counts and identifiers, typically 'int' or 'long long' </li> +<li><a href="user.h#CPUclock">qh_CPUclock</a> clock() +function for reporting the total time spent by +Qhull </li> +<li><a href="user.h#RANDOM">qh_RANDOM...</a> random +number generator </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="udef">definition constants</a></h3> +<ul> +<li><a href="user.h#DEFAULTbox">qh_DEFAULTbox</a> +define default box size for rbox, 'Qbb', and 'QbB' (Geomview expects 0.5) </li> +<li><a href="user.h#INFINITE">qh_INFINITE</a> on +output, indicates Voronoi center at infinity </li> +<li><a href="user.h#ORIENTclock">qh_ORIENTclock</a> +define convention for orienting facets</li> +<li><a href="user.h#ZEROdelaunay">qh_ZEROdelaunay</a> +define facets that are ignored in Delaunay triangulations</li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="ujoggle">joggle constants</a></h3> +<ul> +<li><a href="user.h#JOGGLEagain">qh_JOGGLEagain</a> +how often to retry before using qh_JOGGLEmaxincrease +again </li> +<li><a href="user.h#JOGGLEdefault">qh_JOGGLEdefault</a> +default value for qh.JOGGLEmax for 'QP' </li> +<li><a href="user.h#JOGGLEincrease">qh_JOGGLEincrease</a> +factor to increase qh.JOGGLEmax on retrys for +'QPn' </li> +<li><a href="user.h#JOGGLEmaxincrease">qh_JOGGLEmaxincrease</a> max +for increasing qh.JOGGLEmax relative to +qh.MAXwidth </li> +<li><a href="user.h#JOGGLEretry">qh_JOGGLEmaxretry</a> +report error if this many retries </li> +<li><a href="user.h#JOGGLEretry">qh_JOGGLEretry</a> +how often to retry before using qh_JOGGLEmax </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="uperform">performance +related constants</a></h3> +<ul> +<li><a href="user.h#HASHfactor">qh_HASHfactor</a> +total/used hash slots </li> +<li><a href="user.h#INITIALmax">qh_INITIALmax</a> if +dim >= qh_INITIALmax, use min/max coordinate +points for initial simplex </li> +<li><a href="user.h#INITIALsearch">qh_INITIALsearch</a> +if qh.INITIALmax, search points up to this +dimension </li> +<li><a href="user.h#NOtrace">qh_NOtrace</a> disallow +tracing </li> +<li><a href="user.h#VERIFYdirect">qh_VERIFYdirect</a> +'Tv' verifies all <em>points X facets</em> if op +count is smaller </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="umemory">memory constants</a></h3> +<ul> +<li><a href="user.h#MEMalign">qh_MEMalign</a> memory +alignment for qh_meminitbuffers() in global.c </li> +<li><a href="user.h#MEMbufsize">qh_MEMbufsize</a> +size of additional memory buffers </li> +<li><a href="user.h#MEMinitbuf">qh_MEMinitbuf</a> +size of initial memory buffer </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="ucond">conditional compilation</a></h3> +<ul> +<li><a href="user.h#compiler">compiler</a> defined symbols, +e.g., _STDC_ and _cplusplus + +<li><a href="user.h#COMPUTEfurthest">qh_COMPUTEfurthest</a> + compute furthest distance to an outside point instead of storing it with the facet +<li><a href="user.h#KEEPstatistics">qh_KEEPstatistics</a> + enable statistic gathering and reporting with option 'Ts' +<li><a href="user.h#MAXoutside">qh_MAXoutside</a> +record outer plane for each facet +<li><a href="user.h#NOmerge">qh_NOmerge</a> +disable facet merging +<li><a href="user.h#NOtrace">qh_NOtrace</a> +disable tracing with option 'T4' +<li><a href="user.h#QHpointer">qh_QHpointer</a> +access global data with pointer or static structure +<li><a href="user.h#QUICKhelp">qh_QUICKhelp</a> +use abbreviated help messages, e.g., for degenerate inputs +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="umerge">merge +constants</a></h3> +<ul> +<li><a href="user.h#BESTcentrum">qh_BESTcentrum</a> +when does qh_findbestneighbor() test centrums? </li> +<li><a href="user.h#BESTnonconvex">qh_BESTnonconvex</a> +when does qh_findbestneighbor() test nonconvex +ridges only? </li> +<li><a href="user.h#COPLANARratio">qh_COPLANARratio</a> +what is qh.MINvisible? </li> +<li><a href="user.h#DIMreduceBuild">qh_DIMreduceBuild</a> +max dimension for vertex reduction </li> +<li><a href="user.h#DIMmergeVertex">qh_DIMmergeVertex</a> +max dimension for vertex merging </li> +<li><a href="user.h#DISToutside">qh_DISToutside</a> +when is a point clearly outside of a facet for qh_findbestnew and qh_partitionall</li> +<li><a href="user.h#MAXnarrow">qh_MAXnarrow</a> max. +cosine for qh.NARROWhull </li> +<li><a href="user.h#MAXnewcentrum">qh_MAXnewcentrum</a> +when does qh_reducevertices_centrum() reset the +centrum? </li> +<li><a href="user.h#MAXnewmerges">qh_MAXnewmerges</a> +when does qh_merge_nonconvex() call +qh_reducevertices_centrums? </li> +<li><a href="user.h#RATIOnearinside">qh_RATIOnearinside</a> +ratio for retaining inside points for +qh_check_maxout() </li> +<li><a href="user.h#SEARCHdist">qh_SEARCHdist</a> +when is facet coplanar with the best facet for qh_findbesthorizon</li> +<li><a href="user.h#USEfindbestnew">qh_USEfindbestnew</a> +when to use qh_findbestnew for qh_partitionpoint()</li> +<li><a href="user.h#WARNnarrow">qh_WARNnarrow</a> +max. cosine to warn about qh.NARROWhull </li> +<li><a href="user.h#WIDEcoplanar">qh_WIDEcoplanar</a> +what is a wide facet? </li> +<li><a href="user.h#WIDEduplicate">qh_WIDEduplicate</a> +what is a wide ratio on merging duplicate ridges? </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="ufunc">user.c +functions</a></h3> +<ul> +<li><a href="user.c#qhull_template">Qhull template</a> for calling qh_new_qhull from your program</li> +<li><a href="user.c#errexit">qh_errexit</a> report +error and exit qhull()</li> +<li><a href="user.c#errprint">qh_errprint</a> print +information about facets and ridges </li> +<li><a href="user.c#new_qhull">qh_new_qhull</a> call qhull on an array +of points</li> +<li><a href="user.c#printfacetlist">qh_printfacetlist</a> +print all fields of all facets </li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="u2func">usermem.c +functions</a></h3> +<ul> +<li><a href="usermem.c#qh_exit">qh_exit</a> exit program, same as exit(). May be redefined as throw "QH10003.." by libqhullcpp/usermem_r-cpp.cpp</li> +<li><a href="usermem.c#qh_fprintf_stderr">qh_fprintf_stderr</a> print to stderr when qh.ferr is not defined.</li> +<li><a href="usermem.c#qh_free">qh_free</a> free memory, same as free().</li> +<li><a href="usermem.c#qh_malloc">qh_malloc</a> allocate memory, same as malloc()</li> +</ul> + +<h3><a href="qh-user.htm#TOC">»</a><a name="u3func">userprintf.c + and userprintf_rbox,c functions</a></h3> +<ul> +<li><a href="userprintf.c#qh_fprintf">qh_fprintf</a> print +information from Qhull, sames as fprintf(). </li> +<li><a href="userprintf_rbox.c#qh_fprintf_rbox">qh_fprintf_rbox</a> print +information from Rbox, sames as fprintf(). </li> +</ul> + +<p><!-- Navigation links --> </p> +<hr> +<p><b>Up:</b> +<a href="http://www.qhull.org">Home page for +Qhull</a> <br> +<b>Up:</b> <a href="../../html/index.htm#TOC">Qhull manual: Table of Contents</a> <br> +<b>Up:</b> <a href="../../html/qh-quick.htm#programs">Programs</a> +• <a href="../../html/qh-quick.htm#options">Options</a> +• <a href="../../html/qh-opto.htm#output">Output</a> +• <a href="../../html/qh-optf.htm#format">Formats</a> +• <a href="../../html/qh-optg.htm#geomview">Geomview</a> +• <a href="../../html/qh-optp.htm#print">Print</a> +• <a href="../../html/qh-optq.htm#qhull">Qhull</a> +• <a href="../../html/qh-optc.htm#prec">Precision</a> +• <a href="../../html/qh-optt.htm#trace">Trace</a> +• <a href="index.htm">Functions</a><br> +<b>Up:</b> <a href="../../html/qh-code.htm#TOC">Qhull code: Table of Contents</a> <br> +<b>To:</b> <a href="index.htm">Qhull functions</a>, macros, and data structures<br> +<b>To:</b> <a href="qh-geom.htm">Geom</a> • +<a href="qh-globa.htm">Global</a> • <a href="qh-io.htm">Io</a> +• <a href="qh-mem.htm">Mem</a> • <a href="qh-merge.htm">Merge</a> +• <a href="qh-poly.htm">Poly</a> • <a href="qh-qhull.htm#TOC">Qhull</a> +• <a href="qh-set.htm">Set</a> • <a href="qh-stat.htm">Stat</a> +• <a href="qh-user.htm">User</a><br> +</p> +<p><!-- GC common information --> </p> +<hr> +<p><a href="http://www.geom.uiuc.edu/"><img +src="../../html/qh--geom.gif" align="middle" width="40" height="40"></a><i>The +Geometry Center Home Page </i></p> +<p>Comments to: <a href=mailto:qhull@qhull.org>qhull@qhull.org</a> +</a><br> +Created: May 2, 1997 --- <!-- hhmts start --> Last modified: see top <!-- hhmts end --> </p> +</body> +</html> |