[brlcad-commits] CVS: brlcad/doc/html/manuals/mged mged_cmd_index.html, 14.4, 14.5

[Lee B. <lb...@us...>]

Update of /cvsroot/brlcad/brlcad/doc/html/manuals/mged
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv6252

Modified Files:
	mged_cmd_index.html 
Log Message:
added documentation for expand_comb_tree


Index: mged_cmd_index.html
===================================================================
RCS file: /cvsroot/brlcad/brlcad/doc/html/manuals/mged/mged_cmd_index.html,v
retrieving revision 14.4
retrieving revision 14.5
diff -w -u -r14.4 -r14.5
--- mged_cmd_index.html	8 Feb 2006 21:35:59 -0000	14.4
+++ mged_cmd_index.html	23 Sep 2006 16:13:28 -0000	14.5
@@ -177,6 +177,8 @@
 <TD WIDTH="20%" VALIGN="MIDDLE">
 <FONT SIZE=2><P></FONT><A HREF="#export_body"><FONT SIZE=2>export_body</FONT></A></TD>
 <TD WIDTH="22%" VALIGN="MIDDLE">
+<FONT SIZE=2><P></FONT><A HREF="#expand_comb_tree"><FONT SIZE=2>expand_comb_tree</FONT></A></TD>
+<TD WIDTH="21%" VALIGN="MIDDLE">
 <FONT SIZE=2><P></FONT><A HREF="#extrude"><FONT SIZE=2>extrude</FONT></A></TD>
 <TD WIDTH="21%" VALIGN="MIDDLE">
 <FONT SIZE=2><P></FONT><A HREF="#eye_pt"><FONT SIZE=2>eye_pt</FONT></A></TD>
@@ -1542,6 +1544,64 @@
 </FONT><TT><DD>mged&gt;</TT> <B>export_body bin_chars /home/fred/chars</DD>
 </B><DD>-- Copy the contents of &quot;bin_chars&quot; into the file &quot;/home/fred/chars&quot;</DD>
 <DT><HR ALIGN="RIGHT"></DT>
+<DT><b><a name="expand_comb_tree"></a>expand_comb_tree [-c] <i>comb ...</i></DT>
+<DD>The <i>expand_comb_tree</i> will create a combination object for each 
+Boolean node in the boolean tree of a combination.  Each combination
+constructed will contain a single boolean operation of two leaf nodes.  The
+leaf nodes will be named <i>comb</i>_xpand_l and <i>comb</i>_xpand_r for the
+left and right nodes of the tree respectively.  Sub-nodes will have "l" and
+"r" suffixes added based upon whether they are left or right children of the
+node.
+
+If the <b>-c</b> option is specified, then 
+the combination(s) specified are copied to the name 
+<i>comb</i>_xpand and the copy is expanded.
+If the option is not provided, then the original combination(s) are modified
+in place.
+<p>
+Note that regions, combinations and objects created witht the "g" command
+(sometimes colloquially referred to as groups) are all combinations, and 
+can be expanded with this command.
+<p>
+<b>Example:</b>
+<pre>
+<b>mged></b> r foo.r u a - b + c u d + e
+Defaulting item number to 1004
+Creating region id=1003, air=0, GIFTmaterial=1, los=100
+<b>mged></b> l foo.r
+foo.r:  REGION id=1004  (air=0, los=100, GIFTmater=1) --
+   u a
+   - b
+   + c
+   u d
+   + e
+<b>mged></b> tree foo.r
+foo.r/R
+        u a
+        - b
+        + c
+        u d
+        + e
+
+<b>mged></b> expand_comb_tree -c foo.r
+<b>mged></b> l foo.r_xpand
+foo.r_xpand:  REGION id=1003  (air=0, los=100, GIFTmater=1) --
+   u foo.r_xpand_l
+   u foo.r_xpand_r
+<b>mged></b> tree foo.r_xpand
+foo.r_xpand/R
+        u foo.r_xpand_l/R
+                u foo.r_xpand_ll/R
+                        u a
+                        - b
+                + c
+        u foo.r_xpand_r/R
+                u d
+                + e
+</pre>
+</dd>
+
+<DT><HR ALIGN="RIGHT"></DT>
 <B><DT><A NAME="extrude"></A>extrude</B> <I>#### distance</DT>
 </I><DD>The &quot;extrude&quot; command modifies an <A HREF="#ARB">ARB</A> shape by extruding the specified face through the specified <I>distance</I> to determine the position of the opposing face. The face to be extruded is identified by listing its vertex numbers as they are labeled in the MGED display when the <I>ARB</I> is edited.  Note that the face identified is not moved, but the opposite face is adjusted so that it is the specified <I>distance</I> from the specified face.  The order that the vertex numbers are listed determines the direction of the extrusion using the right-hand rule.</DD>
 <FONT SIZE=4><DT>Examples:</DT>