Revision: 65372
http://sourceforge.net/p/brlcad/code/65372
Author: n_reed
Date: 2015-06-17 23:29:35 +0000 (Wed, 17 Jun 2015)
Log Message:
-----------
add notes on domain intervals
Modified Paths:
--------------
brlcad/branches/brep-debug/doc/docbook/system/implementation/en/bool_eval_development.xml
Modified:
brlcad/branches/brep-debug/doc/docbook/system/implementation/en/bool_eval_development.xml
===================================================================
---
brlcad/branches/brep-debug/doc/docbook/system/implementation/en/bool_eval_development.xml
2015-06-17 22:20:28 UTC (rev 65371)
+++
brlcad/branches/brep-debug/doc/docbook/system/implementation/en/bool_eval_development.xml
2015-06-17 23:29:35 UTC (rev 65372)
@@ -53,7 +53,7 @@
]]>
</synopsis>
<para>
- The intersection curves between the faces of
<parameter>brep1</parameter> and <parameter>brep2</parameter> are found by
<function>get_face_intersection_curves</function>. These curves are used to
split the original surfaces into pieces, each becoming a new trimmed NURBS
face. The <function>categorize_trimmed_faces</function> function is used to
identify which pieces, based on the boolean operation, are part of the
evaluated result. Each <classname>TrimmedFace</classname> whose
m_belong_to_final member is marked <constant>TrimmedFace::BELONG</constant> is
used by <function>ON_Boolean</function> to create the final evaluated result.
+ The intersection curves between the faces of
<parameter>brep1</parameter> and <parameter>brep2</parameter> are found by
<function>get_face_intersection_curves</function>. These curves are used to
split the original surfaces into pieces, each becoming a new trimmed NURBS
face. The <function>categorize_trimmed_faces</function> function is used to
identify which pieces, based on the boolean operation, are part of the
evaluated result. Each <classname>TrimmedFace</classname> whose
<varname>m_belong_to_final</varname> member is marked
<constant>TrimmedFace::BELONG</constant> is used by
<function>ON_Boolean</function> to create the final evaluated result.
</para>
<synopsis>
<![CDATA[
@@ -154,6 +154,21 @@
</para>
</note>
</section>
+ <section>
+ <title>Domain Intervals</title>
+ <para>
+ <classname>ON_Interval</classname> is used to represent the domains
of parametric curves and surfaces. The domain <emphasis>starts</emphasis> at
<varname>m_t[0]</varname> and <emphasis>ends</emphasis> at
<varname>m_t[1]</varname>. These members can be set directly or via
<function>Set(double t0, double t1)</function>.
+ </para>
+ <warning>
+ <para>
+ The start, end, and overall length of the domain are
<emphasis>arbitrary</emphasis>, and <varname>m_t[0]</varname> need not be less
than <varname>m_t[1]</varname>. If the numerically smaller or larger domain
endpoint is needed, these should be accessed via the <function>Min</function>
and <function>Max</function> member functions.
+ </para>
+ </warning>
+
+ <para>
+ The <function>ParameterAt(double x)</function> function translate
a normalized parameter (from a domain starting at 0.0 and ending at 1.0) into a
real parameter. Thus, the start of the domain is at
<varname>domain.ParameterAt(0.0)</varname>, the midpoint is at
<varname>domain.ParameterAt(.5)</varname>, etc.
+ </para>
+ </section>
</section>
<section>
<title>Pitfalls</title>
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
_______________________________________________
BRL-CAD Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits
