diff options
author | Thomas Abthorpe <tabthorpe@FreeBSD.org> | 2008-02-09 01:59:37 +0000 |
---|---|---|
committer | Thomas Abthorpe <tabthorpe@FreeBSD.org> | 2008-02-09 01:59:37 +0000 |
commit | 6ceda39d6b4366c1568f0ff288a09381da9b9ae3 (patch) | |
tree | 8c9a49da731c7fb561f8512e1a0bc49886e08f17 /math/rapid/files | |
parent | 616049a8e54a7390d6a5db423f85c219ac0005b3 (diff) | |
download | ports-6ceda39d6b4366c1568f0ff288a09381da9b9ae3.tar.gz ports-6ceda39d6b4366c1568f0ff288a09381da9b9ae3.zip |
Notes
Diffstat (limited to 'math/rapid/files')
-rw-r--r-- | math/rapid/files/pkg-message.in | 6 | ||||
-rw-r--r-- | math/rapid/files/rapid.1 | 102 |
2 files changed, 108 insertions, 0 deletions
diff --git a/math/rapid/files/pkg-message.in b/math/rapid/files/pkg-message.in new file mode 100644 index 000000000000..b1130e7a471e --- /dev/null +++ b/math/rapid/files/pkg-message.in @@ -0,0 +1,6 @@ + +*********************************************************************** +Redistribution of RAPID in any form is strictly prohibited without the +permission of UNC. +*********************************************************************** + diff --git a/math/rapid/files/rapid.1 b/math/rapid/files/rapid.1 new file mode 100644 index 000000000000..38eb2576ad58 --- /dev/null +++ b/math/rapid/files/rapid.1 @@ -0,0 +1,102 @@ +.TH RAPID 1 +.SH NAME \" Section header +.PP + +RAPID -- Robust and Accurate Polygon Interference Detection + +\" Convention: +\" Underline anything that is typed verbatim - commands, etc. +.SH SYNOPSIS +.PP +.nf +.na +#include <RAPID/RAPID.H> +c++ -I/usr/local/include program.c++ -L/usr/local/lib -lRAPID -lm +.ad +.fi + +.SH "DESCRIPTION" + +.B RAPID +is a robust and accurate polygon interference detection library for +large environments composed of unstructured models. + +It is applicable to polygon soups - models which contain no adjacency +information, and obey no topological constraints. The models may +contain cracks, holes, self-intersections, and nongeneric (e.g. +coplanar and collinear) configurations. + +It is numericaly robust - the algorithm is not subject to conditioning +problems, and requires no special handling of nongeneric cases (such as +parallel faces). + +The RAPID library is free for non-commercial use. Please use this +request form to download the latest version. It has a very simple user +interface: the user need noncommerial use. be familiar with only about +five function calls. A C++ sample client program illustrates its use. + +The current version of RAPID is version 2.01. The previous version was +1.04 - the change in version designation from 1.xx to 2.xx reflects a +moderate alteration in the library's interface (mostly just name +changes). The following changes from version 1.04 have been made: + +Use include file "RAPID.H": The RAPID API now requires only that you +include "RAPID.H" and link to "libRAPID.a" to be able to use the +library. + +Standalone library: RAPID no longer uses the SVM library. RAPID only +depends on the standard math library, "libm.a", which you probably link +to anyway. + +Use object "RAPID_model" instead of "box": The C++ object into which +you load polygons is now called "RAPID_model". Previous versions used +"box," which was a holdover from prerelease implementations, and was +not a suitable identifier for the API. + +Consistent use of "RAPID_" prefix: All the globals, such as those +which began with "OBBT_" now use the prefix "RAPID_". Note, also, that +the old constants "ALL_CONTACTS" and "FIRST_CONTACT" have been replaced +with the symbols "RAPID_ALL_CONSTACTS" and "RAPID_FIRST_CONTACT" in +RAPID 2.00. + +No explicit library initialization: Previous versions required the +client to call 'box::initialize()' before any other RAPID library call. +This was a common but unnecessary source of client bugs (people forgot +to call this routine). RAPID 2.00 no longer requires this, since all +API routines check to see if the library has been initialized. This +extra check has had a negligible performance impact. + +Revision of model construction interface: RAPID 2.00 requires calls to +BeginModel() and EndModel() to enclose the AddTri() calls for building +objects. This more resembles the OpenGL interface, with which many +clients will likely be familiar. Generally, preprocessing of the +objects will take place when EndModel() is called. Later versions of +RAPID will allow special procedures to be placed after the BeginModel() +call but before the first AddTri() call to give the client more control +over how the models are preprocessed. + +Faster preprocessing: The preprocessing for RAPID has been greatly +improved in terms of speed. RAPID 2.00 is generally 5 times faster than +previous versions in preprocessing models. The quality of the +hierarchies have theoretically been affected, in some ways for the +better and in some ways for the worse, but we have not conducted a +thorough study to gauge overall impact of our changes. In a later +release, we intend to provide an alternative preprocessing algorithm +which will be computationally expensive but which will build better +hierarchies. + +No support for plain C: Some clients may not consider this an +improvement, but support for plain C has been discontinued. Of course, +clients are still able to construct their own plain C wrappers for the +C++ functions in RAPID. This change has made the implementation of +RAPID more clean. + +.SH "SEE ALSO" +dtiquery(1) + +.SH AUTHOR +.nf +.na +UNC Research Group on Modeling +http://www.cs.unc.edu/~geom/OBB/OBBT.html + |