glint — a BRL-CAD geometry checker
glint
uses
librt(3)
to fire an array of parallel rays
at the specified
objects
in the database
model.g
and reports
overlaps,
vacuums,
and potential problems with air regions.
By default, the output consists of single-line reports,
each of which contains a tag identifying the report type
and then other data as appropriate for that type report.
Unless the
-p
option is specified,
the exact formats are:
Consecutive partitions overlap by more than
tol
(see the
-t
option).
The data reported are
the names of the two regions involved,
the length of the overlap along the ray,
and the model coordinates of the ray's entry into and exit from
the overlap.
Consecutive partitions have unlike (nonzero) air codes
and the space between them is less than
tol
(see the
-t
option).
The data reported are
the names and air codes of the two regions involved
and the model coordinates of the point of contiguity.
A partition with nonzero air code
follows or precedes another partition
and the space between them is more than
tol
(see the
-t
option).
The data reported are
the names of the two regions (and solids) involved,
the length of the gap along the ray,
and the model coordinates of the ray's exiting the first partition
and entering the second.
The first partition has a nonzero air code. The data reported are the name and air code of the region involved and the model coordinates of the ray's entering the partition.
The last partition has a nonzero air code. The data reported are the name and air code of the region involved and the model coordinates of the ray's exiting the partition.
The space between consecutive partitions is more than
tol
(see the
-t
option).
The data reported are
the names of the two regions (and solids) involved,
the length of the gap along the ray,
and the model coordinates of the ray's exiting the first partition
and entering the second.
-a azSets the azimuth from which to fire rays to az degrees. The default is 0.
-cSpecifies that one ray should be fired from the center of each grid cell. By default, glint fires a ray from one random point in each cell.
-e elSets the elevation from which to fire rays to el degrees. The default is 0.
-g gridsizeSets the width and height of each grid cell to gridsize millimeters. The default is 100 mm.
-oCauses glint to include in each report the model coordinates of the ray origination point. These appear between the tag and the rest of the data.
-pCauses glint to produce its reports as plot3(5) drawing commands instead of ASCII text. This is useful in conjunction with the "overlay" command of mged.
-r bitsSpecifies which types of reports to produce. If, after an optional minus sign, bits begins with either "0x" or "0X", the remainder is interpreted in hexadecimal. Otherwise, if bits begins with "0", the remainder is interpreted in octal. Otherwise, bits is interpreted in decimal. The meaning of the individual bits is as follows: 1 overlaps 2 contiguous unlike airs 4 unconfined airs 8 air first on rays 16 air last on rays 32 vacuums. If there was no initial minus sign, then bits specifies which report types to produce. The minus sign implies complementation: when it is present, bits specifies which report types not to produce. The default is 1.
-sCauses glint to collect all the overlap reports and sort them before printing them. The reports for a given pair of regions are printed contiguously, and the clusters of reports for the various pairs of regions appear in order of decreasing cumulative overlap length. By default, glint reports overlaps immediately and in the order of their discovery.
-t tolSets the tolerance for overlaps, contiguous and unconfined airs, and vacuums to tol millimeters. The default is 0.
-uSets the useair member of the rt_i structure to 1, which causes librt to report partitions containing air. It is also set implicitly if any air-related reports have been specified. By default, librt ignores air regions.
-x bitsSets the
glint
debug flags to
bits.
See the
-r
option
for more details.
Note that some of the report types have no corresponding diagnostics.
The command
glint -a 35 -e 25 -c -g 1 -r 31 -t 0.01 kitchen.g appliances
fires a ray every millimeter and produces overlap reports and every type of air-related report, but no vacuum reports.