rtexample 1 BRL-CAD BRL-CAD User Commands
rtexample shoots a single ray at objects in a geometry database
`rtexample` model.g objects

## DESCRIPTION

            This is an example of a program that uses librt to shoot a single ray at some
            geometry in a geometry (.g) database.

            librt is a big library with lots of code, but basically all that the programmer
            needs to do is include `raytrace.h` and specify the following:
              a_rt_i    a raytrace instance, from 'rt_dirbuild()'
              a_ray     ray origin and direction
              a_hit     function to be called if ray hits something
              a_miss    function to be called if ray misses everything

            rtexample defines simple functions for a_hit and a_miss which simply
            output information about hit region (if hit) and log misses. Applications will
            typically define more complex tasks to fo if the ray hits, such as describing a
            reflected ray.

## EXAMPLE

`rtexample` car.g wheel door

Here, a single ray will be shot at the geometry database car.g and hit reports generated if the ray hits the specified objects.

## SEE ALSO

mged 1 , rt 1 , librt 3

## AUTHORS

BRL-CAD Team

## COPYRIGHT

This software is Copyright (c) 2004-2024 United States Government as represented by the U.S. Army Research Laboratory.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org