## Name

qray — Gets/sets query ray characteristics.

## Synopsis

`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.

Example 1. Print the usage message.

`mged>``qray`

Prints the usage message.

Example 2. Return the overlap format string.

`mged>``qray fmt o`

Returns the overlap format string.

Example 3. Return the rgb color used to color odd partitions.

`mged>``qray oddcolor`

Returns the rgb color used to color odd partitions.

Example 4. Set the odd partition color to red.

`mged>``qray oddcolor 255 0 0`

Sets the odd partition color to red.

## BUG REPORTS

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