rtshot — fire one ray at an mged model, for debugging
rtshot
fires a single ray at the indicated
objects
in the input
model.g
and produces a printed summary of the geometry that the ray passes through.
The orientation of the ray to be fired is specified by
giving any two of the three options
-a
-d
and
-p.
-d
option is followed by three numbers specifying the direction vector.
-p
option is followed by three numbers specifying the start point.
-a
option is followed by three numbers specifying a point to be fired "at".
-t #specifies the number of triangles per piece for facetted primitives (currently only the BOT). The default value is 4.
-b #specifies the threshold for breaking facetted primitives into pieces. The default is 32.
-x #Set debug flags to (hexadecimal) number.
-U #Set use_air flag.
-v attribute_name1 [attribute_name2 ...]This option specifies a list of attribute names to be listed (along with the appropriate values) for each region hit.
-O # or keywordThis option indicates how overlaps should be handled. The
resolve
or
0
argument is the default (normal BRL-CAD mode, all overlaps are resolved
and no overlaps appear in the output). The
rebuild_fastgen
or
1
argument mimics FASTGEN4 raytracing (plate-mode overlaps appear in the output). The
rebuild_all
or
2
argument rebuilds all overlaps that occurred along the ray (all overlaps appear in the output). The
retain
or
3
argument does not resolve any overlaps (each unique combination of
intersection extent and list of claiming regions produces a single partition).
-n #This option specifies the number of rings to use in a ray bundle (does not include the central ray).
-c #This option specifies the number of rays in each ring. The rays in each ring are not aligned with the rays in the previous ring, they make an outward spiral pattern. A central ray is included.
-R #This option specifies the radius of the ray bundle. Each ring is evenly spaced with the outermost ring at this radius.
The
rtshot
program is a simple front-end to
librt(3)
which can be invoked directly by the user. If a ray bundle is desired, all of the
-n
,
-c
, and
-R
options must be specified. The output from a ray bundle is handled as a single ray.
Any overlaps between rays in the bundle are resolved by favoring rays closer to the
central ray. The default is to fire a single ray.
Numerous error conditions are possible. Descriptive messages are printed on standard error.
Most deficiencies observed while using the rtshot program are usually with the librt(3) package instead.