'\" t
.\"     Title: PUT_COMB
.\"    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 "PUT_COMB" "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"
put_comb \- Insert combinations and regions \- allows definition of both boolean expressions and standard attribute values\&.
.SH "SYNOPSIS"
.HP \w'\fBput_comb\fR\ 'u
\fBput_comb\fR {\fIcomb_name\fR} [is_Region\ [[id]\ |\ [air]\ |\ [material]\ |\ [los]]] {\fIcolor\fR} {\fIshader\fR} {\fIinherit\fR} {\fIboolean_expr\fR}
.SH "DESCRIPTION"
.PP
Command for inserting regions and combinations with attributes set using a single line command \- useful in scripting situations\&.
.SH "EXAMPLES"
.PP
The
\fBput_comb\fR
expects one of two particular forms of input \- combination or region\&.
.PP
\fBExample\ \&1.\ \&Specifying a combination using put_comb\fR
.PP

mged>\fBput_comb test\&.c n 255/255/255 plastic n "u sph\&.s u arb8\&.s"\fR
.PP
Creates a combination that is not a region, using the plastic shader, consisting of the union of sph\&.s and arb8\&.s"\&.
.sp
.if n \{\
.RS 4
.\}
.nf
mged> l test\&.c
test\&.c:  \-\-
Shader \*(Aqplastic\*(Aq
   u sph\&.s
   u arb8\&.s
mged> attr get test\&.c
oshader {plastic}
.fi
.if n \{\
.RE
.\}
.PP
\fBExample\ \&2.\ \&Specifying a region using put_comb\fR
.PP

mged>\fBput_comb test\&.r y 1001 0 32 1 255/255/255 plastic y "u sph\&.s u arb8\&.s"\fR
.PP
Creates a combination that is a region, with region id 1001, air flag off, material 32, los 1, white in color, using the plastic shader, inheriting, consisting of the union of sph\&.s and arb8\&.s"
.sp
.if n \{\
.RS 4
.\}
.nf
mged> l test\&.r
test\&.r:  REGION id=1001 (air=0, los=1, GIFTmater=32) \-\-
Shader \*(Aqplastic\*(Aq
(These material properties override all lower ones in the tree)
   u sph\&.s
   u arb8\&.s
mged> attr get test\&.r
region {R} inherit {1} oshader {plastic} region_id {1001}
material_id {32} los {1}
.fi
.if n \{\
.RE
.\}
.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
