Revision: 57342
http://sourceforge.net/p/brlcad/code/57342
Author: tbrowder2
Date: 2013-08-30 20:25:23 +0000 (Fri, 30 Aug 2013)
Log Message:
-----------
adding missing chunks; start whipping into readable shape
Modified Paths:
--------------
brlcad/trunk/doc/docbook/presentations/en/brlcad-app-devel.xml
Modified: brlcad/trunk/doc/docbook/presentations/en/brlcad-app-devel.xml
===================================================================
--- brlcad/trunk/doc/docbook/presentations/en/brlcad-app-devel.xml
2013-08-30 19:29:14 UTC (rev 57341)
+++ brlcad/trunk/doc/docbook/presentations/en/brlcad-app-devel.xml
2013-08-30 20:25:23 UTC (rev 57342)
@@ -1,41 +1,23 @@
<?xml version="1.0" encoding="us-ascii"?>
-<article version="5.0"
- xml:lang="en"
- xmlns="http://docbook.org/ns/docbook";
->
+<article xmlns="http://docbook.org/ns/docbook"; version="5.0" xml:lang="en">
<info>
<title>Building Applications</title>
</info>
- <!-- Next 'div' was a 'draw:page'. -->
+<section>
+<title>Application Development with BRL-CAD</title>
- <!-- Next 'div' is a draw:frame. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
- <orderedlist><listitem>
- <para> Application Development with BRL-CAD</para>
- </listitem>
- </orderedlist>
- <!-- Next 'div' was a 'draw:page'. -->
+<para>WARNING Code Intensive Presentation</para>
- <para><orderedlist><listitem>
- <para> WARNING Code Intensive Presentation</para>
- </listitem>
-</orderedlist>
- <!-- Next 'div' was a 'draw:text-box'. -->
-<orderedlist><listitem>
- <para> For Code Warriors Only!</para>
- <para>non-programmers will need atropine, caffeine, and
electro-shock therapy</para>
- <para>(run, do not walk, to the nearest exit)</para>
- </listitem>
-</orderedlist></para>
+<para>For Code Warriors Only! Non-programmers will need atropine,
+caffeine, and electro-shock therapy (run, do not walk, to the nearest
+exit)</para>
-<!-- Next 'div' was a 'draw:page'. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
-<orderedlist><listitem>
- <para> Overview</para>
- </listitem>
-</orderedlist> <!-- Next 'div' is a draw:frame. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
+</section>
+
+<section>
+<title>Overview</title>
+
<itemizedlist>
<listitem>
<para>Header files</para>
@@ -59,19 +41,15 @@
<para>Modifying Geometry</para>
</listitem>
</itemizedlist>
+
+</section>
+
<!-- Next 'div' was a 'draw:page'. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
-<orderedlist><listitem>
- <para>Header Files</para>
- </listitem>
-</orderedlist> <!-- Next 'div' is a draw:frame. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
-<itemizedlist>
- <listitem>
+<section>
+ <title>Header Files</title>
+
<para>The Big-6</para>
- </listitem>
- </itemizedlist>
- <!-- Next 'div' is a draw:frame. -->
+
<informaltable frame="none">
<tgroup cols="2">
<colspec colname="c1" colwidth="50*"/>
@@ -150,16 +128,12 @@
</tbody>
</tgroup>
</informaltable>
- <!-- Next 'div' was a 'draw:page'. -->
-<!-- Next 'div' is a draw:frame. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
-<orderedlist><listitem>
- <para> Prototype Application: rtexample.c</para>
- </listitem>
-</orderedlist> <!-- Next 'div' is a draw:frame. -->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+<section>
+ <para>Prototype Application: rtexample.c</para>
+
<itemizedlist>
<listitem>
<para>Opens a database</para>
@@ -177,19 +151,24 @@
<para>See source tree: rt/rtexample.c</para>
</listitem>
</itemizedlist>
+
+</section>
+
+
<!-- Next 'div' was a 'draw:page'. -->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Necessary Headers</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+<section>
+
+ <para>Necessary Headers</para>
+
+<programlisting>
+#include "conf.h" /* compilation macros */
+#include <stdio.h>
+#include <math.h>
+#include "machine.h" /* machine specific definitions */
+#include "vmath.h" /* vector math macros */
+#include "raytrace.h" /* librt interface definitions */
+</programlisting>
+
<itemizedlist>
<listitem>
<para>The conf.h and machine.h are ubiquitous in almost all BRLCAD
apps</para>
@@ -211,30 +190,27 @@
</para>
</listitem>
</itemizedlist>
- <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+
<!--
Next 'div' was a 'draw:page'.
-->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para> Opening the Database</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+<section>
+
+<para>Opening the Database</para>
+
+<programlisting>
+static struct rt_i *rtip; /* librt Instance structure */
+/* rt_dirbuild() performs many functions for us */
+rtip = rt_dirbuild(argv[1], buf, sizeof(buf));
+if (rtip == RTI_NULL) {
+ fprintf(stderr,"rtexample: rt_dirbuild failure\n");
+ exit(2);
+}
+</programlisting>
+
<itemizedlist>
<listitem>
<para>Opens database file</para>
@@ -246,58 +222,35 @@
<para>Allows us to retrieve individual objects</para>
</listitem>
</itemizedlist>
- <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+<!-- Next 'div' was a 'draw:page'. -->
+
<orderedlist><listitem>
<para> Reading Geometry</para>
</listitem>
-</orderedlist> <!-- Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+</orderedlist>
+
+<programlisting>
+if (rt_gettree(rtip, argv[2]) < 0)
+ fprintf(stderr,"rt_gettree(%s) FAILED\n", argv[2]);
+</programlisting>
+
<itemizedlist>
<listitem>
<para>Retrieves tree top specified by argv[2] into a working set used
by librt</para>
</listitem>
</itemizedlist>
- <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Preparing Geometry for Raytracing</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Preparing Geometry for Raytracing</para>
+
+<programlisting>
+rt_prep_parallel(rtip,1);
+</programlisting>
+
<itemizedlist>
<listitem>
<para>Pre-computes useful terms for each primitive</para>
@@ -318,30 +271,24 @@
<para>Builds space partition tree to accelerate ray-trace</para>
</listitem>
</itemizedlist>
- <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Application Struct and Shot</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Application Struct and Shot</para>
+
+<programlisting>
+struct application ap;
+ap.a_rt_i = rtip;
+VSET(ap.a_ray.r_pt, 0, 0, 10000);
+VSET(ap.a_ray.r_dir, 0, 0, -1);
+ap.a_hit = hit; /* where to go on a hit */
+ap.a_miss = miss; /* where to go on a miss */
+
+(void)rt_shootray(&); /* do it */
+</programlisting>
+
<itemizedlist>
<listitem>
<para>The application struct contains information about the
@@ -349,47 +296,35 @@
results.</para>
</listitem>
</itemizedlist>
- <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!-- Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+<!-- Next 'div' was a 'draw:page'. -->
+
<orderedlist><listitem>
<para>Application Struct</para>
</listitem>
-</orderedlist> <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Miss Routine</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+</orderedlist>
+
+<para>Excerpts of application struct from raytrace.h:</para>
+
+<programlisting>
+struct application {
+
+ struct xray a_ray; /* Actual ray to be shot */
+ int (*a_hit)(struct application *,
+ struct partition *,
+ struct seg *);
+ int (*a_miss) (struct application *);
+ int a_onehit; /* flag to stop on first hit */
+
+ struct rt_i *a_rt_i; /* this librt instance */
+};
+</programlisting>
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Miss Routine</para>
+
<itemizedlist>
<listitem>
<para>Called when ray does not hit any geometry</para>
@@ -404,22 +339,14 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Hit Routine</para>
+
<orderedlist><listitem>
- <para>Hit Routine</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
<para>hit(register struct application *ap, /* see raytrace.h */</para>
<para>struct partition *PartHeadp) /* see raytrace.h */</para>
<para>{</para>
@@ -451,13 +378,13 @@
<para>}</para>
</listitem>
</orderedlist>
+
+</section>
+
<!-- Next 'div' was a 'draw:page'. -->
-<!-- Next 'div' is a draw:frame. -->
-<orderedlist><listitem>
- <para> Hit Routine Breakdown</para>
- </listitem>
-</orderedlist>
-<!-- Next 'div' is a draw:frame. -->
+<section>
+ <para>Hit Routine Breakdown</para>
+
<itemizedlist>
<listitem>
<para>Partition Structure contains information about intervals
@@ -467,60 +394,27 @@
<para>Hit structure contains information about an individual
boundary/ray intersection</para>
</listitem>
</itemizedlist>
- <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para> Partition Structure</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Partition Structure</para>
+
<itemizedlist>
<listitem>
<para>From h/raytrace.h</para>
</listitem>
</itemizedlist>
+
+</section>
+
+<section>
+ <para>Hit Structure</para>
+
<!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<orderedlist><listitem>
- <para>Hit Structure</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
<para> struct hit {</para>
<para>long hit_magic;</para>
<para>fastf_t hit_dist; /* dist from r_pt to hit_point */</para>
@@ -532,31 +426,15 @@
<para>struct xray *hit_rayp; /* pointer to defining ray */</para>
<para>};</para>
</listitem>
-</orderedlist> <!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+</orderedlist>
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Hit Routine (Again)</para>
+
<orderedlist><listitem>
- <para> Hit Routine (Again)</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
<para> hit(register struct application *ap, /* see raytrace.h */</para>
<para>struct partition *PartHeadp) /* see raytrace.h */</para>
<para>{</para>
@@ -588,21 +466,15 @@
<para>}</para>
</listitem>
</orderedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Using the RTUIF</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Using the RTUIF</para>
+
+<!-- Next 'div' is a draw:frame. -->
+
<itemizedlist>
<listitem>
<para>Makes shooting grids of rays easy.</para>
@@ -617,21 +489,17 @@
<para>Simplest example shown in rt/viewdummy.c in source tree</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>The 5 RTUIF Functions</para>
+
+<!-- Next 'div' is a draw:frame. -->
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>The 5 RTUIF Functions</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>view_init</para>
@@ -649,9 +517,12 @@
<para>view_end</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
@@ -686,64 +557,49 @@
<para>Called at the beginning of a frame. Called by</para>
<para>do_frame() just before raytracing starts.</para>
</listitem>
-</orderedlist><!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+</orderedlist>
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>RTUIF Routines2</para>
+
<orderedlist><listitem>
- <para>RTUIF Routines2</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
<para> int rayhit(struct application *ap, struct partition
*PartHeadp);</para>
<para>Called via a_hit linkage from rt_shootray() when ray hits.</para>
<para>int raymiss(struct application *ap);</para>
<para>Called via a_miss linkage from rt_shootray() when ray
misses.</para>
</listitem>
-</orderedlist><!--
-Next 'div' was a 'draw:page'.
--->
+</orderedlist>
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>RTUIF Routines3</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
<orderedlist><listitem>
- <para>RTUIF Routines3</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
<para> void view_pixel(struct application *ap);</para>
<para>Called by worker() after the end of proccessing for</para>
<para>each pixel.</para>
<para>void view_end(struct application *ap);</para>
<para>Called in do_frame() at the end of a frame, just after
raytracing completes.</para>
</listitem>
-</orderedlist> <!--
-Next 'div' was a 'draw:page'.
--->
+</orderedlist>
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>So Much for the Trivialities</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>So Much for the Trivialities</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Now we look at actual geometry</para>
@@ -775,9 +631,13 @@
<para>Doing anything useful with it</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+</section>
+
+
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
@@ -835,24 +695,17 @@
</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
-<!--
-Next 'div' is a draw:frame.
--->
+
+</section>
+
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>On-Disk Representation</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>On-Disk Representation</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Space Efficient</para>
@@ -899,21 +752,16 @@
</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Internal Representation</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Internal Representation</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Convenient editing form</para>
@@ -940,21 +788,16 @@
<para>Combination (and hence region) structure defined in
raytrace.h</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Prepped Representation</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para> Prepped Representation</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>The form that is actually raytraced</para>
@@ -991,21 +834,16 @@
</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+</section>
+
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Simple Database Application</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Simple Database Application</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Necessary headers</para>
@@ -1020,19 +858,14 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Opening The Database</para>
+
<!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Opening The Database</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' added for floating.
--->
- <!--
Next 'div' is a draw:frame.
-->
<!--
@@ -1077,21 +910,17 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para> Getting Geometry</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para> Getting Geometry</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>To retrieve geometry, we have to get an internal
representation</para>
@@ -1152,21 +981,16 @@
</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+</section>
+
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Putting Geometry Back</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Putting Geometry Back</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Database I/O layer converts from internal to external
format.</para>
@@ -1181,21 +1005,15 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<section>
+ <para>Building Boolean Trees</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Building Boolean Trees</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Regions/combinations used to store boolean trees.</para>
@@ -1253,50 +1071,31 @@
</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Constructing Boolean List</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Constructing Boolean List</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Build the list of elements first:</para>
</listitem>
</itemizedlist>
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Regions/Combinations</para>
+
<!--
-Next 'div' added for floating.
--->
- <!--
-Next 'div' is a draw:frame.
--->
- <!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Regions/Combinations</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Constructing the actual combination record</para>
@@ -1326,21 +1125,13 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Retrieving A Combination</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Retrieving A Combination</para>
+
<itemizedlist>
<listitem>
<para>Simple retrieval only gets:</para>
@@ -1371,21 +1162,16 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Combination Write-Back</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Combination Write-Back</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Modify the boolean tree</para>
@@ -1403,21 +1189,16 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Combination Tree Info</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Combination Tree Info</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Need to prep the tree to obtain geometry</para>
@@ -1442,21 +1223,16 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Processing combination tree</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Processing combination tree</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Now to retrieve a treetop and prep:</para>
@@ -1474,21 +1250,16 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Accessing Prepped Regions</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Accessing Prepped Regions</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>rtip has list of regions</para>
@@ -1509,21 +1280,16 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Making Temporary Changes</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Making Temporary Changes</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Changes that only last for 1 application run</para>
@@ -1532,21 +1298,16 @@
<para>Changes do not reside in on-disk database</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Dynamic Geometry</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Dynamic Geometry</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Involves special inmem database</para>
@@ -1576,21 +1337,16 @@
<para>Writes to inmem arranged though special wdb_dbopen() call</para>
</listitem>
</itemizedlist>
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Accessing inmem database</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Accessing inmem database</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>small difference in wdb_dbopen call</para>
@@ -1608,21 +1364,17 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
+
+</section>
+
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Closing the Database</para>
+
<!--
Next 'div' was a 'draw:text-box'.
-->
-<orderedlist><listitem>
- <para>Closing the Database</para>
- </listitem>
-</orderedlist> <!--
-Next 'div' is a draw:frame.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
<itemizedlist>
<listitem>
<para>Important to flush data and purge data structures!</para>
@@ -1637,21 +1389,19 @@
<!--
Next 'div' was a 'draw:text-box'.
-->
-<!--
-Next 'div' was a 'draw:page'.
--->
- <!--
-Next 'div' was a 'draw:text-box'.
--->
-<orderedlist><listitem>
- <para>Thank you</para>
- </listitem>
-</orderedlist>
- <!-- Next 'div' is a draw:frame. -->
- <!-- Next 'div' was a 'draw:text-box'. -->
+
+</section>
+
+<!-- Next 'div' was a 'draw:page'. -->
+<section>
+ <para>Thank you</para>
+
<orderedlist><listitem>
<para>Lee A. Butler</para>
<para>John Anderson</para>
</listitem>
</orderedlist>
+
+</section>
+
</article>
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more!
Discover the easy way to master current and previous Microsoft technologies
and advance your career. Get an incredible 1,500+ hours of step-by-step
tutorial videos with LearnDevNow. Subscribe today and save!
http://pubads.g.doubleclick.net/gampad/clk?id=58040911&iu=/4140/ostg.clktrk
_______________________________________________
BRL-CAD Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits
