'\" t
.\"     Title: ART
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD MGED Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "ART" "nged" "08/28/2023" "BRL\-CAD" "BRL\-CAD MGED Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
art \- Executes the BRL\-CAD \fIart\fR program\&.
.SH "SYNOPSIS"
.HP \w'\fBart\fR\ 'u
\fBart\fR [\fIoptions\fR] [\fI\-\-objects\fR]
.SH "DESCRIPTION"
.PP
The
\fIart\fR
command is a new, in\-progress command that performs similar rendering as in
\fBrt\fR, using the open\-source
\fIAppleseed\fR
physically based rendering engine\&. The integration of Appleseed into BRL\-CAD is an ongoing effort to make art production\-ready through enabling as many rt features as possible so that art is a drop\-in replacement\&. The current status of the project has incorporated several, but not all, features of rt, as well as fixing issues with the Appleseed integration with BRL\-CAD, such as z\-up orientation and the orthographic view\&. To run art as one would run rt, simply run bin/art from the command line or, from the MGED raytrace control panel, select "Art" instead of "Raytrace"\&.
.PP
There are some limitations with the current implementation of art\&. One is that it does not yet match the MGED graphics window, and that not all rt options are supported\&. Additionally, art does not support \&.pix output, rt\*(Aqs default; art does not handle non\-region, muliply referenced, or halfspace objects; and art multiframe rendering is untested, which means that memory leaks are currently likely\&.
.PP
The following example commands are performed in mged, but since art is en evolving command, some issues with running the commands may be observed\&.
.SH "EXAMPLES"
.PP
The first example shows the use of the
\fBart\fR
command to run the art program to produce a color\-shaded image\&. The second example shows the use of the
\fBart\fR
command to run the art program to produce a brightened image\&. Both commands use a sample object\&.
.PP
\fBExample\ \&1.\ \&Run the \fIart\fR program to produce a color-shaded image.\fR
.PP

mged>\fB art \-C 255,255,255 \-s 1024 share/db/moss\&.g all\&.g\fR
.PP
Runs the
\fIart\fR
program to produce a color\-shaded image of a sample object\&. The image will be 1024 pixels square and will be displayed on a lingering
\fIX\fR
framebuffer\&.
.PP
\fBExample\ \&2.\ \&Run the \fIart\fR program to produce a brightened image of an object.\fR
.PP

mged>\fBart \-A 2 share/db/moss\&.g all\&.g\fR
.PP
Runs the
\fIart\fR
program to produce a brightened image of the sample object\&. The image will be brightened by a factor of 2\&.
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
