QRAY
nged
BRL-CAD
BRL-CAD User Commands

# qray

Gets/sets query ray characteristics.

        qray
       subcommand

## DESCRIPTION

Gets/sets query ray characteristics. Without a subcommand, the usage message is printed. The qray command accepts the following subcommands:

`vars`

  Prints a list of all query ray variables.

`basename` [str]

  If str is specified, then set basename to str. Otherwise, return the basename. Note that the basename is the name used to create the fake shape names corresponding to the query ray. There will be one fake shape for every color used along the ray.

`effects`[t|g|b]

  Set or get the type of effects that will occur when firing a query ray. The effects of firing a ray can be either t for textual output, g for graphical output, or b for both textual and graphical.

`echo` [0|1]

  Sets or gets the value of echo. If set to 1, the actual `nirt` command used will be echoed to the screen.

`oddcolor` [r g b]

  Sets or gets the color of odd partitions.

`evencolor` [r g b]

  Sets or gets the color of even partitions.

`voidcolor` [r g b]

  Sets or gets the color of areas where the ray passes through nothing.

`overlapcolor` [r g b]

  Sets or gets the color of areas that overlap.

`fmt` [r|h|p|f|m|o [str]]

  Sets or gets the format string(s). See the man page of `nirt` for more details.

`script` [str]

  Sets or gets the `nirt` script string.

`help`

  Prints the usage message.

## EXAMPLES

The four examples show the use of the `qray` command without a subcommand and with three of the listed subcommands.

### Print the usage message.

mged>`qray`

Prints the usage message.

### Return the overlap format string.

mged>`qray fmt o`

Returns the overlap format string.

### Return the rgb color used to color odd partitions.

mged>`qray oddcolor`

Returns the rgb color used to color odd partitions.

### Set the odd partition color to red.

mged>`qray oddcolor 255 0 0`

Sets the odd partition color to red.

## AUTHOR

BRL-CAD Team

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.