Thread: [brlcad-commits] SF.net SVN: brlcad:[32758] brlcad/trunk/doc/docbook
Open Source Solid Modeling CAD
Brought to you by:
brlcad
From: <sta...@us...> - 2008-09-25 03:57:30
|
Revision: 32758 http://brlcad.svn.sourceforge.net/brlcad/?rev=32758&view=rev Author: starseeker Date: 2008-09-25 03:57:20 +0000 (Thu, 25 Sep 2008) Log Message: ----------- remove old book directory in preparation for rename. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Removed Paths: ------------- brlcad/trunk/doc/docbook/book/ Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2008-09-25 03:56:14 UTC (rev 32757) +++ brlcad/trunk/doc/docbook/Makefile.am 2008-09-25 03:57:20 UTC (rev 32758) @@ -1,5 +1,8 @@ -SUBDIRS = system \ - tutorials +SUBDIRS = articles \ + books \ + lessons \ + system + include $(top_srcdir)/misc/Makefile.defs This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2008-09-25 04:16:04
|
Revision: 32760 http://brlcad.svn.sourceforge.net/brlcad/?rev=32760&view=rev Author: starseeker Date: 2008-09-25 04:15:41 +0000 (Thu, 25 Sep 2008) Log Message: ----------- Add books and articles to docbook Added Paths: ----------- brlcad/trunk/doc/docbook/articles/ brlcad/trunk/doc/docbook/articles/Makefile.am brlcad/trunk/doc/docbook/articles/build_pattern/ brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern.xml brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/ brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure1.png brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure2.png brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure3.png brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure4.png brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure5.png brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure6.png brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/inline1.png brlcad/trunk/doc/docbook/articles/build_region/ brlcad/trunk/doc/docbook/articles/build_region/build_region.xml brlcad/trunk/doc/docbook/articles/build_region/build_region_images/ brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure1.png brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure2.png brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure3.png brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure4.png brlcad/trunk/doc/docbook/articles/ebm_primitive/ brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive.xml brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/ brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/figure1.png brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/figure2.png brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/figure3.png brlcad/trunk/doc/docbook/articles/mgedrc/ brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc.xml brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc_images/ brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc_images/figure2.png brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc_images/figure3.png brlcad/trunk/doc/docbook/articles/oed/ brlcad/trunk/doc/docbook/articles/oed/Makefile.am brlcad/trunk/doc/docbook/articles/oed/README brlcad/trunk/doc/docbook/articles/oed/lollipop.png brlcad/trunk/doc/docbook/articles/oed/oed.xml brlcad/trunk/doc/docbook/articles/oed/oed_0001.png brlcad/trunk/doc/docbook/articles/oed/oed_0002.png brlcad/trunk/doc/docbook/articles/oed/oed_0003.png brlcad/trunk/doc/docbook/articles/oed/oed_0004.png brlcad/trunk/doc/docbook/articles/oed/oed_0005.png brlcad/trunk/doc/docbook/articles/oed/oed_0006.png brlcad/trunk/doc/docbook/articles/oed/oed_0007.png brlcad/trunk/doc/docbook/articles/oed/oed_0008.png brlcad/trunk/doc/docbook/articles/oed/oed_0009.png brlcad/trunk/doc/docbook/articles/oed/oed_0010.png brlcad/trunk/doc/docbook/articles/oed/oed_0011.png brlcad/trunk/doc/docbook/articles/oed/oed_0012.png brlcad/trunk/doc/docbook/articles/oed/oed_examples.asc brlcad/trunk/doc/docbook/articles/pipes/ brlcad/trunk/doc/docbook/articles/pipes/pipe_images/ brlcad/trunk/doc/docbook/articles/pipes/pipe_images/figure1.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/figure2.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/figure3.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/figure4.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/figure5.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline1.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline2.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline3.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline4.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline5.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline6.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline7.png brlcad/trunk/doc/docbook/articles/pipes/pipe_images/inline8.png brlcad/trunk/doc/docbook/articles/pipes/pipes.xml brlcad/trunk/doc/docbook/articles/projection_shader/ brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader.xml brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/ brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure1.png brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure2.png brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure3.png brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure4.png brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure5.png brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure6.png brlcad/trunk/doc/docbook/articles/projection_shader/projection_shader_images/figure7.png brlcad/trunk/doc/docbook/articles/tire/ brlcad/trunk/doc/docbook/articles/tire/README brlcad/trunk/doc/docbook/articles/tire/tire.xml brlcad/trunk/doc/docbook/articles/tire/tire_0001.png brlcad/trunk/doc/docbook/articles/tire/tire_0002.png brlcad/trunk/doc/docbook/articles/tire/tire_0003.png brlcad/trunk/doc/docbook/articles/tire/tire_0004.png brlcad/trunk/doc/docbook/articles/tire/tire_0005.png brlcad/trunk/doc/docbook/articles/tire/tire_0006.png brlcad/trunk/doc/docbook/articles/tire/tire_0007.png brlcad/trunk/doc/docbook/articles/tire/tire_0008.png brlcad/trunk/doc/docbook/articles/tire/tire_0009.png brlcad/trunk/doc/docbook/articles/tire/tire_0010.png brlcad/trunk/doc/docbook/articles/tire/tire_0011.png brlcad/trunk/doc/docbook/articles/tire/tire_0012.png brlcad/trunk/doc/docbook/articles/tire/tire_0012.svg brlcad/trunk/doc/docbook/articles/tire/tire_0013.png brlcad/trunk/doc/docbook/articles/tire/tire_0013.svg brlcad/trunk/doc/docbook/articles/tire/tire_0014.png brlcad/trunk/doc/docbook/books/ brlcad/trunk/doc/docbook/books/Makefile.am brlcad/trunk/doc/docbook/books/README brlcad/trunk/doc/docbook/books/tutorial_series/ brlcad/trunk/doc/docbook/books/tutorial_series/Makefile.am brlcad/trunk/doc/docbook/books/tutorial_series/VolumeII.xml brlcad/trunk/doc/docbook/books/tutorial_series/VolumeIII.xml brlcad/trunk/doc/docbook/books/tutorial_series/book_authors.xml brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/ brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure1.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure10.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure11.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure12.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure13.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure14.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure15.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure16.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure17.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure18.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure19.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure2.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure3.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure4.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure5.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure6.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure7.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure8.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/figure9.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/inline1.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/inline2.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/inline3.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/invalidarbs.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/primitive1.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/primitive2.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/primitive3.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/primitive4.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/primitive5.png brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/primitive6.png Added: brlcad/trunk/doc/docbook/articles/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/articles/Makefile.am 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,4 @@ + +SUBDIRS = oed + +include $(top_srcdir)/misc/Makefile.defs Property changes on: brlcad/trunk/doc/docbook/articles/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern.xml (rev 0) +++ brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern.xml 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,300 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"../../resources/standard/dtd/docbookx.dtd"> +<article xmlns:xi="http://www.w3.org/2001/XInclude"> + <articleinfo> + <title>Using the Pipe Primitive</title> + + <xi:include href="../../books/tutorial_series/book_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + + <legalnotice> + <para>Approved for public release; distribution is unlimited</para> + </legalnotice> + </articleinfo> + + <sect1 id="build_pattern_generalinfo"> + <title>General Pattern Information</title> + <para> + As mentioned previously, the Build Pattern tool automates the process of + making copies of existing geometry in rectangular, spherical, or + cylindrical patterns. The user can choose to pattern at any of three + depths of duplication: top, regions, and primitives. + </para> + <para> + The Build Pattern tool is run from the graphical user interface (GUI) + (under the Tools menu); it currently has no command-line equivalent. The + bottom of the pattern control GUI is a usage dialog box that lists + pertinent information about each item on the GUI as the user mouses over + the text. + </para> + <para> + There are many input fields. Some stand alone, and others belong to series + that work together to provide the needed information for a specific + option. Each series is demarked by a diamond-shaped check box. If the + diamond is highlighted red, then all fields in that series are required. + All required fields must be filled in for the pattern tool to work + properly. It is also important to note that all dimensions must be in + millimeters and that no commas should be used in number strings. + </para> + <para> + The Build Pattern tool is designed to work from a prototype geometry + object. That is to say, the object that is patterned is not included in + the resultant pattern. + </para> + </sect1> + + <sect1 id="build_pattern_names"> + <title>Pattern Names</title> + <para> + As shown in Figure E-1, the tool appends three numbers to all patterned + objects (unless you are using the increment option for primitives, in + which case, the numbers for regions and primitives are incremented by the + increment amount). For rectangular patterns, the first number is the + X axis offset, the second is the Y axis offset, and the third is the Z + axis offset. For spherical patterns, the first number references the + azimuth, the second references the elevation, and the third references the + radii. For cylindrical patterns, the first number references the radii, + the second number references the height, and the third number references + the azimuth. + </para> + </sect1> + + <sect1 id="build_pattern_fields"> + <title>Common Fields for all Patterns:</title> + <para> + There are several fields in the pattern tool GUI that are common to all + types of patterns. + </para> + <para> + The Group Name field is for the name of the combination to be created (or + appended to) by a pattern call. + </para> + <para> + The Source String and Replacement String fields must be used together. The + source string is the set of characters in each element of the patterned + object to be changed. The replacement string is the set of characters that + will replace the source string. + </para> + + <figure> + <title>Example of pattern-generated assembly names.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_pattern/build_pattern_images/figure1.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> + The Increment field is only for use when duplicating to the primitive level. + It is added to the leftmost number field of each primitive. To determine the + increment, examine the primitives of the object(s) you wish to pattern and find + the largest span. For example, to create a pattern to the primitive level with + the following primitives (which may or may not be in regions or + assemblies), + <literallayout> +part.s22 part.s22-1 part.s23 part.s24 part.s24+1 part.s24-1 part.s25, + </literallayout> + one needs to determine the span. Note that the leftmost numbers in these + primitives range from 22–25. Thus, as shown in the following expression, the span is + four (inclusively). + + *******NEED FIGURE HERE***** + + If we use an increment of four, we will get the following set of primitives. + <literallayout> +part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29 + </literallayout> + + Although it is acceptable to use a greater increment, gaps in numbers may be + troublesome if one is using this capability extensively. + </para> + + <para> + Finally, the Objects field is used for the names of all the items to be + patterned. + </para> + </sect1> + + <sect1 id="build_pattern_stringsub"> + <title>String Substitution</title> + <para> + It is also possible to create a pattern in which a string of characters in + each element in the object is changed (e.g., "l_" -> "r_"). This is useful + for symmetry applications (e.g., left - right) or series (e.g., 1 - n). + Each element of the object must have the source string so the user must be + thorough and name each primitive, region, and assembly properly. Consider + the following example: + <inlinegraphic fileref="../../tutorials/build_pattern/build_pattern_images/inline1.png" /> + </para> + <para> + Top-level duplications copy the patterned object and reference its entire + structure with matrices, as follows: + <literallayout> +/pattern group + /COPIED assemblies [MATRICES] + /assemblies + /regions + /primitives + </literallayout> + + Region-level duplications copy all assembly and regions and reference from the + region level down with matrices. + + <literallayout> +/pattern group + /COPIED assemblies + /COPIED regions [MATRICES] +/primitives + </literallayout> + + Primitive-level duplications copy the entire tree structure to the primitive + level without matrices using an increment on all primitives. + + <literallayout> +/pattern group + /COPIED assemblies NO MATRICES + /COPIED regions + /COPIED primitives + </literallayout> + </para> + + </sect1> + + <sect1 id="build_pattern_recpatterns"> + <title>Rectangular Patterns</title> + <para> + The rectangular pattern GUI (shown in Figure E-2) is designed to + facilitate one-, two-, or three-dimensional rectangular patterns. The + default X, Y, and Z directions are positive along each axis. In order to + create a rectangle that is not axis aligned, these vectors may be changed + with the condition that each must remain precisely perpendicular to the + other two. If the Use Directions series is checked, the user specifies the + number of copies and the Delta between copies for each axis. If the Use + Lists series is checked, the user can specify a list of deltas along each + axis. + </para> + + <figure> + <title>The user interface for building rectangular patterns.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_pattern/build_pattern_images/figure2.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </sect1> + + <sect1 id="build_pattern_spherical"> + <title>Spherical Patterns</title> + <para> + The spherical pattern GUI (shown in Figure E-3) facilitates sphere-shaped + patterns rotated around a center vertex using user-specified radii with + azimuth and elevation angles. As shown in Figure E-4, the patterned + objects--in this case, a series of arrows--may be oriented as built around + the sphere or rotated by azimuth and/or elevation such that they are + oriented toward the pattern center using the Rotate Azimuth and Rotate + Elevation check boxes. + </para> + + <para> + As shown in Figure E-4, the Pattern Center field is the coordinate at the + center of the pattern. The Object Center field is a user-defined + coordinate used to locate the object(s) relative to the pattern center. It + acts as the key point for any transformations to the pattern object(s). + </para> + + <para> + The Starting Azimuth and Starting Elevation fields follow the same + right-hand-rule Cartesian coordinate conventions as Multi-Device Geometry + Editor (MGED) viewing. The Starting Radius is the distance from the + Pattern Center to the object center at the user-specified azimuths and + elevations. + </para> + + <para> + If the Create Az/El series is checked, the user defines the number of + azimuths and elevations and the deltas between each. If the Use Lists + series is checked, the user must specify a list of azimuths and/or + elevations. + </para> + + <para> + The Create Radii and Use Radii List series define offsets from the + Starting Radius, allowing the user to create a pattern of concentric + spheres. If Create Radii is checked, the user specifies + the Number of Radii and the Radius Delta in order to construct a number of + equally offset sphere patterns. If the Use Radii List is checked, the user + specifies a list of radius offsets. + </para> + + <figure> + <title>The user interface for building spherical patterns.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_pattern/build_pattern_images/figure3.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> + Without the Rotate Azimuth or Rotate Elevation boxes checked, the + patterned objects are oriented as built without any rotations. Notice, for + example, that every arrow in Figure E-5 points to the left. Notice also + that for each patterned arrow, the Object Center (here specified as the + tip of the arrow) is located on the circle outline at a distance of one + Starting Radius from the Pattern Center. If we set the Object Center to + the coordinate at the base of the arrow, the base would then lie on the + circular outline. Wherever the Object Center is set is the point at which + MGED works with the Object Center coordinate to place and rotate patterned + objects. + </para> + + + <figure> + <title>Examples of different spherical pattern orientations.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_pattern/build_pattern_images/figure4.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + + <figure> + <title>Implementation of spherical patterns.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_pattern/build_pattern_images/figure5.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </sect1> + + <sect1 id="build_pattern_cylind"> + <title>Cylindrical Patterns</title> + <para> + The cylindrical pattern GUI (shown in Figure E-6) facilitates the creation + of cylinder-shaped patterns with user-defined center, direction, height, + azimuth, and radii inputs. The Base Center is the vertex of the cylinder + shape. The Object Center is a user-defined coordinate used to locate the + object(s) relative to the Base Center and Height Direction. It acts as the + key point for any transformations to the pattern object(s). The Height + Direction is the vector along which the cylinder runs. The Starting Height + is the offset from the Base Center along the Height Direction that the + pattern will place the Object Center. + </para> + + <figure> + <title>The user interface for building cylindrical patterns.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_pattern/build_pattern_images/figure6.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </sect1> + +</article> Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern.xml ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure1.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure2.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure3.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure4.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure5.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/figure6.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/build_pattern_images/inline1.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: brlcad/trunk/doc/docbook/articles/build_region/build_region.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/build_region/build_region.xml (rev 0) +++ brlcad/trunk/doc/docbook/articles/build_region/build_region.xml 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,143 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"../../resources/standard/dtd/docbookx.dtd"> +<article xmlns:xi="http://www.w3.org/2001/XInclude"> + <articleinfo> + <title>Using the build_region Command</title> + + <xi:include href="../../books/tutorial_series/book_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + + <legalnotice> + <para>Approved for public release; distribution is unlimited</para> + </legalnotice> + </articleinfo> + + <para id="build_region1"> + Just as the Build Pattern tool can help automate the process of building + multiple occurrences of objects, the build_region command can help + automate the process of creating regions. The command (which currently has + no graphical user interface equivalent) uses meaning assigned by the user + in the primitive name based on the intended use of the primitive. + </para> + + <para id="build_region2"> + The user includes the Boolean operation and relational information in the + name of the primitive using a simple naming convention. The naming + convention is designed around the following two assumptions: + </para> + + <itemizedlist id="build_region3"> + <listitem> + <para> + The same text "tag" is used for all primitives in a region. + </para> + </listitem> + <listitem> + <para> + A sequential numbering pattern is used. + </para> + </listitem> + </itemizedlist> + + <para id="build_region4"> + For example, let's say we want to build the four rounded corners of a + "tub" region for a toy metal wagon assembly (see Figure F-1). We could + choose something such as "wgn"--an abbreviated form of "wagon"--as the + tag. This tag is short, easy to type, and representative of the final + assembly name. Our primitives would therefore be of the form wgn.s#. + </para> + + <figure id="build_region5"> + <title>The rounded corners of a toy wagon.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_region/build_region_images/figure1.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="build_region6"> + Next, we create an arb8 for one long side of the wagon tub. It is named + wgn.s1. After that, we create an rcc for one corner of the tub. It is + named wgn.s2. To get a hollow quarter cylinder, we need to subtract a + cylinder and intersect a bounding box (see Figure F-2). In order to relate + the subtraction and intersecting primitives with wgn.s2, they will each + share the same root name, wgn.s2. The subtraction primitive will be named + wgn.s2-1, and the intersecting primitive will be named wgn.s2+1. + </para> + + <figure id="build_region7"> + <title>Arb8, cylinder, and two Boolean primitives.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_region/build_region_images/figure2.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="build_region8"> + Now we have created the following four primitives: + <literallayout> +wgn.s1 wgn.s2 wgn.s2+1 wgn.s2-1 + </literallayout> + If we separate the primitives sequentially as follows, + <literallayout> +wgn.s1 + +wgn.s2 wgn.s2+1 wgn.s2-1, + </literallayout> + we can begin to see the Boolean structure falling out of the naming + convention + <literallayout> +u wgn.s1 + +u wgn.s2 + wgn.s2+1 - wgn.s2-1 + </literallayout> + If we wanted to make a second subtraction from wgn.s2--say, for a drain + hole in the corner of the wagon--we would name that primitive wgn.s2-2 + (see Figure F-3). We can break this name down as follows: + + *****NEED IMAGE HERE***** + </para> + + <figure id="build_region9"> + <title>The region and the subtraction primitives.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_region/build_region_images/figure3.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="build_region10"> + Note that the root name stays the same so we can maintain the + relationship, and the second number (associated with the Boolean + operation) is incremented sequentially. + </para> + + <figure id="build_region11"> + <title>Raytraced image with hole.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/build_region/build_region_images/figure4.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="build_region12"> + Obviously, the overall success or failure of the build_region command + depends on primitives being named properly. But if they are, the command + can organize them in one automated step, creating complex regions in just + a few keystrokes. + </para> + + <para id="build_region13"> + Another modeling benefit of the build_region tool is that it allows the + user to quickly organize primitives. Assume, for example, that we have + used the aforementioned naming convention to construct a complicated + region. If there was a subsection of the region that we needed to, say, + keep out for another assembly, delete from our database, move slightly, or + copy, it would be a simple matter to create a new region with just those + primitives that we needed. + </para> + +</article> Property changes on: brlcad/trunk/doc/docbook/articles/build_region/build_region.xml ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Property changes on: brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure1.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure2.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure3.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/build_region/build_region_images/figure4.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive.xml (rev 0) +++ brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive.xml 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,116 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"../../resources/standard/dtd/docbookx.dtd"> +<article xmlns:xi="http://www.w3.org/2001/XInclude"> + <articleinfo> + <title>Using the Extruded Bitmap Primitive</title> + + <xi:include href="../../books/tutorial_series/book_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + + <legalnotice> + <para>Approved for public release; distribution is unlimited</para> + </legalnotice> + </articleinfo> + + <para id="ebm1"> + The extruded bitmap (ebm) primitive allows the user to make a + three-dimensional (3-D) shape from a two-dimensional black-and-white + image. This feature can be helpful when dealing with complex outlines, + text, or other complicated shapes captured as images. + </para> + + <para id="ebm2"> + For example, the ebm could be used if one wanted to model 3-D letters, + such as in a company name, onto the side of a simulated wall or building. + Note also that the same image used for the projection can, with some extra + processing, form the basis for the ebm (see Figures C-1-C-3). + </para> + + <figure id="ebm3"> + <title>Example of the .bw image used for ebm.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/ebm_primitive/ebm_primitive_images/figure1.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <figure id="ebm4"> + <title>Example of ebm.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/ebm_primitive/ebm_primitive_images/figure2.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <figure id="ebm5"> + <title>Example of the ebm with projection shader added.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/ebm_primitive/ebm_primitive_images/figure3.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="ebm6"> + To make an ebm, the image file must be a black and white (.bw) file. A .bw + image is a grayscale raw image file with only one channel. Each pixel can + be turned on or off, but it has no color data. As shown in Figures C-2 and + C-3, the white part of the image may be extruded in a straight line in the + +Z direction to whatever length the user specifies. Regardless of the + complexity of the geometry, all of the extruded shapes form a single ebm + primitive. + </para> + + <para id="ebm7"> + To enter an ebm in a database, the in command must be used. The arguments + are as shown in the following example: + </para> + + <informaltable frame="all" id="ebm8"> + <tgroup cols='7'> + <tbody> + <row><entry>in</entry><entry>sample.ebm</entry><entry>ebm</entry><entry>image.bw</entry><entry>600</entry><entry>800</entry><entry>1</entry></row> + <row> + <entry>Make a shape.</entry> + <entry>Name it sample.</entry> + <entry>Make it an ebm.</entry> + <entry>Use the image.bw image file.</entry> + <entry>The image is 600 pixels wide.</entry> + <entry>The image is 800 pixels high.</entry> + <entry>Extrude the shape 1 inch (or whatever working units are in effect at the time) in the +Z direction.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <note id="ebm9"> + <title>Points to Remember About the ebm</title> + <itemizedlist mark="bullet"> + <listitem> + <para> + The ebm cannot be created with the make, create, or inside + commands. + </para> + </listitem> + <listitem> + <para> + The desired width and height of the ebm are input as pixel + values, but the extrusion distance can be expressed in any + working units. + </para> + </listitem> + <listitem> + <para> + Extrusions are made in the +Z direction, although after an ebm is + made, the shape can be rotated, translated, or scaled. + </para> + </listitem> + <listitem> + <para> + When extruded, all shapes form a single ebm primitive. + </para> + </listitem> + </itemizedlist> + </note> +</article> Property changes on: brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive.xml ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Property changes on: brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/figure1.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/figure2.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/ebm_primitive/ebm_primitive_images/figure3.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc.xml (rev 0) +++ brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc.xml 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,261 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"../../resources/standard/dtd/docbookx.dtd"> +<article xmlns:xi="http://www.w3.org/2001/XInclude"> + <articleinfo> + <title>Setting Up a .mgedrc File</title> + + <xi:include href="../../books/tutorial_series/book_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + + <legalnotice> + <para>Approved for public release; distribution is unlimited</para> + </legalnotice> + </articleinfo> + + <para id="mgedrc1"> + Similar to the preferences or settings options in other computer + applications, the .mgedrc file is a useful tool to customize the look and + functionality of the U.S. Army Ballistic Research Laboratory - + Computer-Aided Design (BRL-CAD) package and minimize potentially + time-consuming actions. Using Multi-Device Geometry Editor (MGED) commands + and the Tcl/Tk scripting language, users can modify default settings, + specify features to be toggled on or off whenever MGED is started, + establish typing shortcuts for a command or a series of commands, locate + and size the command and geometry windows, and perform a host of other + customizations. + </para> + <para id="mgedrc2"> + The command to create/update a .mgedrc file with the graphical user + interface (GUI) is found under the File drop-down menu. When the + Create/Update .mgedrc command is called, it writes an extensive list (~500 + lines) of default settings and comments representing the default state of + the command and graphics windows. + </para> + <para id="mgedrc3"> + As shown in Figure D-1, there are two basic parts to a .mgedrc file: (1) + the information before the MGEDRC_HEADER and (2) the information after the + MGEDRC_HEADER. The information before the header is any text created by + the user. The information after the MGEDRC_HEADER is written by the + Create/Update .mgedrc command and is a comprehensive list of the default + settings and options for the MGED user interface. If any edits are made to + the .mgedrc text after the header, these changes will be overwritten by + the default settings if the Create/Update .mgedrc command is called again. + The information before the HEADER, however, is not changed. + </para> + + <note id="mgedrc4"> + <para> + Remember that when creating/updating .mgedrc files, if any + conflicting/repeated commands are found, BRL-CAD "obeys" the last + command listed. + </para> + </note> + + <para id="mgedrc5"> + In Figure D-1, note that lines have been added before the header to show + different raytracing options and the commands have been sectioned into + functional divisions separated by comment fields (comment fields are + denoted by the symbol "#"). + </para> + + <figure id="mgedrc6"> + <title>The two basic parts of the .mgedrc file: (1) information before header, and (2) information + after header.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/mgedrc/mgedrc_images/figure1.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="mgedrc7"> + Each command includes the following four basic components: + + <itemizedlist> + <listitem> + <para> + the "proc" (procedure) prefix, + </para> + </listitem> + <listitem> + <para> + a unique name, + </para> + </listitem> + <listitem> + <para> + arguments, and + </para> + </listitem> + <listitem> + <para> + the body (i.e., commands that MGED should execute). + </para> + </listitem> + </itemizedlist> + </para> + + <para id="mgedrc8"> + The symbol ";" signifies command separation (a return), and the symbol "$" + inserts the value of the subsequently named variable. + </para> + <para id="mgedrc9"> + The following text discusses some specific examples of the type of + shortcuts that can be created by users to expedite common operations such + as executing raytraces with particular parameters, accepting and rejecting + edits, setting azimuth and elevation, etc. + </para> + <para id="mgedrc10"> + First, the command to execute a specific kind of raytrace can often be + long and tedious to type. For example, if a user wanted to render an image + in a window 256 pixels high and wide, with a background color of white, + and with the ambient light set to 0.7, the following text would have to be + typed: + + <literallayout> +rt -s256 -C255/255/255 -A.7 + </literallayout> + + However, it is a simple matter to add a line to the user's .mgedrc file to + automate the calling of this instruction. The user's line might be as + follows: + + <literallayout> +proc 256wa {} {rt -s256 -C255/255/255 -A.7} + </literallayout> + + Diagrammed, this line breaks down as follows: + <informaltable> + <tgroup cols='4'> + <tbody> + <row> + <entry>proc</entry> + <entry>256wa</entry> + <entry>{}</entry> + <entry>{rt -s256 -C255/255/255 -A.7}</entry> + </row> + <row> + <entry>Denotes that a Tcl procedure is being created.</entry> + <entry>Names the procedure 256wa.</entry> + <entry>Denotes that there are no arguments.</entry> + <entry>Denotes the MGED command that will be executed. + The rendering will be 256 pixels square size (as + signified by -s), will have a background red-greenblue + value of 255 255 255 (as signified by the -C + option), and will have an ambient light setting of 0.7 + (as signified by the -A option).</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + Now, all the user has to type on the command line to execute a rendering with the previously + listed options is the following procedure name: + + <literallayout> +256wa + </literallayout> + + Note that this name has been intentionally kept short and function-based. It reduces a + 27-character command to a 5-character command and provides the user with an idea of the + action it performs. The 256 stands for the rt square size, the w stands for a white background, + and the a stands for ambient lighting. But this convention is just a suggestion. The user may + choose any name that is unique and does not contain words that are reserved for MGED + commands (e.g., create). + </para> + + <para id="mgedrc11"> + The .mgedrc file can also be used to create shortcuts for other types of command line or GUI + commands. For example, the syntax for creating a shortcut for accepting and rejecting edits + from the command line might be as follows: + + <literallayout> +proc acc {} {press accept} +proc rej {} {press reject} + </literallayout> + + In addition, a possible shortcut for calling a standard viewing geometry might be as follows: + + <literallayout> +proc 145 {} {ae 145 25} + </literallayout> + + And to save the extra selection step when making or copying a primitive, the respective + procedure syntax for combining the make and sed commands and copy and sed commands + might be as follows: + + <literallayout> +proc mks {newprim primtype} {make $newprim $primtype; sed $newprim} + </literallayout> + +and + + <literallayout> +proc cps {oldprim newprim} {cp $oldprim $newprim; sed $newprim} + </literallayout> + + </para> + + <para id="mgedrc12"> + Figure D-2 shows a sample section of a .mgedrc file that allows the user to specify the command + line editor, customize the window size and placement, and toggle the function keys. + </para> + + <figure id="mgedrc13"> + <title>Sample elements and functionality of a .mgedrc file.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/mgedrc/mgedrc_images/figure2.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + + <para id="mgedrc14"> + The diagrammed command for sizing and positioning the command window is as follows: + <informaltable> + <tgroup cols='4'> + <tbody> + <row> + <entry>set mged_default</entry> + <entry>(geom)</entry> + <entry>475 × 250</entry> + <entry>+65 +80</entry> + </row> + <row> + <entry>Sets MGED command window defaults.</entry> + <entry>Specifies command window.</entry> + <entry>Sizes the window width to 475 pixels and the height to 250 pixels.</entry> + <entry>Denotes window location will be 65 pixels from the left side of the + display and 80 pixels from the top edge of the display.</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + + <para id="mgedrc15"> + As illustrated in Figure D-3, to specify the window size, the user inputs + width-by-height dimensions for each window (i.e., 475 × 250). To specify + the placement of the windows on the display, the user specifies offset + distances (i.e., +65 +80) from the edges of the display (as measured in + pixels). The first number defines the distance for the left/right + placement, and the second number is for the up/down placement. The "+" + symbol indicates a distance from the left side of the display to the left + side of the window or from the top of the display to the top of the + window. Alternatively, if a "-" symbol were present (as shown on the right + side of Figure D-3), it would indicate a distance from the right side of + the display to the right side of the window or from the bottom of the + display to the bottom of the window. + </para> + + <figure id="mgedrc16"> + <title>Sample window dimension input and positioning.</title> + <mediaobject> + <imageobject> + <imagedata align = "center" fileref="../../tutorials/mgedrc/mgedrc_images/figure3.png" format="PNG"></imagedata> + </imageobject> + </mediaobject> + </figure> + + +</article> Property changes on: brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc.xml ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Property changes on: brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc_images/figure2.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Property changes on: brlcad/trunk/doc/docbook/articles/mgedrc/mgedrc_images/figure3.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: brlcad/trunk/doc/docbook/articles/oed/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/oed/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/articles/oed/Makefile.am 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,25 @@ + +docbookdir = $(BRLCAD_DATA)/docbook/oed + +docbook_DATA = \ + README \ + lollipop.png \ + oed.xml \ + oed_0001.png \ + oed_0002.png \ + oed_0003.png \ + oed_0004.png \ + oed_0005.png \ + oed_0006.png \ + oed_0007.png \ + oed_0008.png \ + oed_0009.png \ + oed_0010.png \ + oed_0011.png \ + oed_0012.png \ + oed_examples.asc + +EXTRA_DIST = \ + $(docbook_DATA) + +include $(top_srcdir)/misc/Makefile.defs Property changes on: brlcad/trunk/doc/docbook/articles/oed/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/articles/oed/README =================================================================== --- brlcad/trunk/doc/docbook/articles/oed/README (rev 0) +++ brlcad/trunk/doc/docbook/articles/oed/README 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,22 @@ +Docbook processing: + +Tools: + + Editing: Emacs + NXML mode + + Processing: xmlto and fop + +Conversion to pdf using xmlto and Apache FOP: + +xmlto fo oed.xml; fop oed.fo -pdf oed.pdf + +Converstion to html using xsltproc: +XML_CATALOG_FILES="../../catalog.xml" xsltproc -nonet -o oed.xhtml docbook.xsl oed.xml + +Common issues: + + Different systems tend to have different locations for + storing the docbookx.dtd file referenced at the top of + the xml document. Be sure to change this path to the + correct local path for docbookx.dtd before attempting + the above conversion. Property changes on: brlcad/trunk/doc/docbook/articles/oed/README ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Property changes on: brlcad/trunk/doc/docbook/articles/oed/lollipop.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: brlcad/trunk/doc/docbook/articles/oed/oed.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/oed/oed.xml (rev 0) +++ brlcad/trunk/doc/docbook/articles/oed/oed.xml 2008-09-25 04:15:41 UTC (rev 32760) @@ -0,0 +1,878 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"../../resources/standard/dtd/docbookx.dtd"> +<article> + <articleinfo> + <title>Object Editing - the <command>oed</command> Command</title> + <author> + <firstname>Clifford</firstname> + <surname>Yapp</surname> + </author> + + <legalnotice> + <para>Approved for public release; distribution is unlimited.</para> + <para>Date approved: 05/09/2008</para> + </legalnotice> + + </articleinfo> + + <abstract> + <para> The <command>oed</command> command in MGED is used to enter + what is called "object edit mode" + <footnote> + <para>In some places in MGED this will be referred to as "matrix + edit mode" - the terms both refer to the same concept.</para> + </footnote> + - practically speaking, this mode allows transformations on combined + objects (combinations of primitives created with + <command>comb</command>, for example.) These transformations are not + (by default) made to the coordinate information in the primitatives + in question but are stored instead in a <emphasis>transformation + matrix</emphasis>. This article provides a brief overview and + explanation of the behavior of the <command>oed</command> command + and its uses.</para> + </abstract> + + <sect1> + <title><command>oed</command> - Basic Syntax and Operations</title> + + <para> The syntax of <command>oed</command> is fairly + straightforward: + <footnote> + <para>Note: <emphasis>lhs</emphasis> is an abbreviation for left + hand side and rhs similary stands for right hand side, given the + assumption that a path is displayed as an ascii stream with left + to right text orientation (e.g. /toplevel/level-1/level-2/etc.) + </para> + </footnote> + </para> + + <cmdsynopsis> + <command>oed</command> + <arg choice='req'><replaceable>path_lhs</replaceable></arg> + <arg choice='req'><replaceable>path_rhs</replaceable></arg> + </cmdsynopsis> + + <para><command>oed</command> serves primarily to make working with + combinations and regions practical when there are large numbers of + primitives involved. It is of course possible to move primitives + one by one to desired locations, but the process is extremely + tedious for any non-trivial combination of primitives and the + result is inflexible - for example,if the modeler wished to return + the primitives in a combination to their original position after + moving them <emphasis>as primitives</emphasis> the process of + moving them would need to be reversed one by one as well. Barring + being able to do everything perfectly the first time, individual + primitive placement is impractical.</para> + + <para>The notion of <emphasis>path</emphasis> in this context + refers to the tree of objects that traditionally makes up a CSG + model. Primitives will be combined with other primitives to make + groups of objects, and the "path" to any individual shape within + the combinations is described by the series of nodes in the tree + that identify the object of interest. For example, take a simple + model of a lollipop:</para> + + <para> + <screenshot> + <graphic align = "center" fileref="lollipop.png"></graphic> + </screenshot> + </para> + + <para> If we examine the tree structure of this object, we see it + resembles a filesystem - combinations and regions act a bit like + "folders" which can hold other folders and files. + <footnote> + <para> When tree structures are displayed, a "/" suffix denotes + a combination and a "/R" denotes a combination that is a region. + </para> + </footnote> + + <literallayout class="monospaced"> +mged> tree lollipop +lollipop/ + u outer-candy-shell.r/R + u outer-candy-sphere.c/ + u outer-candy-sphere.s + - core.s + - stick.s + u outer-candy-cyl.c/ + u outer-candy-cyl.s + - outer-candy-sphere.s + u stick.r/R + u stick.s + u core.r/R + u core.s + - stick.s + </literallayout> + + In the "filesystem" of a BRL-CAD object combinations can + hold combinations, regions and primitives. Regions + can hold combinations and primitives. + <footnote> + <para>Regions will accept other regions as constructive arguments + if given, but this is not good practice - BRL-CAD assumes a + region is composed of combinations and primitives which share a + material type.</para> + </footnote> + Primitives are always leaves on the tree - they do not "contain" + anything. Combinations, regions, and primitives can have + associated with them transformation data (sort of like metadata in + a filesystem) that tells BRL-CAD how to manipulate the combination, + region, or primitive in question. It is this data that will be + acted upon when the <command>oed</command> command is used. So in + the above example the full "path" of the outer-candy-sphere.c + combination used in lollipop would be: + + <literallayout class="monospaced"> +/lollipop/outer-candy-shell.r/outer-candy-sphere.c + </literallayout> + + Note that if we wish to operate on this combination it is not enough + to specify /lollipop/outer-candy-shell.r for the lhs and + outer-candy-sphere.c for the rhs - <emphasis>combinations and + regions do not themselves have default control points.</emphasis> In + other words, if you want to rotate a combination there must be a + point around which that rotation occurs - a combination will have no + default point assigned. This is the reason the rhs must always end + with a primitive - even though the intent is not to edit the + primitive, information necessary for most operations on the + combination will use information (such as default keypoint settings) + that the primitive <emphasis>does</emphasis> have. So, + + <literallayout class="monospaced">oed /lollipop/outer-candy-shell.r outer-candy-sphere.c</literallayout> + + is not enough. Either + + <literallayout class="monospaced">oed /lollipop/outer-candy-shell.r + outer-candy-sphere.c/outer-candy-sphere.s</literallayout> + + or + + <literallayout class="monospaced">oed /lollipop/outer-candy-shell.r outer-candy-sphere.c/core.s</literallayout> + + or + + <literallayout class="monospaced">oed /lollipop/outer-candy-shell.r outer-candy-sphere.c/stick.s</literallayout> + + + is needed to have <command>oed</command> actually enter edit mode on + lollipop's outer-candy-sphere.c. Because they are primitives in the + outer-candy-sphere.c combination, outer-candy-sphere.s, core.s and + stick.s are all legal - there will be illustrations later of the + consequences of different primitive choices.</para> + + <para>To demonstrate basic <command>oed</command> behavior an + example is in order. + <footnote> + <para>Bear in mind that these examples will be using very basic + primitives for the sake of simplicity and it is not guaranteed + that they will behave well for things like raytracing. In this + document raytraced screenshots are included to aid visualization. + Most of them are simple but there are sometimes a number of extra + steps needed to actually allow the objects to be raytraced with + the results seen here.</para> + </footnote> + <footnote> + <para><emphasis>path_lhs</emphasis> will be set to "/" for these + simple cases - this means either we will be working with + combinations that are not contained within any other combination/region + or the intent is to transform <emphasis>every</emphasis> instance of + the combination/region present regardless of where it appears in the + tree structure. "/" denotes the toplevel lhs path, or the "root of all + trees" in the database. Because every object in the database exists + "on its own" at the top level as well as inside tree structures, + operating on any object with a "/" path_lhs will always edit the matrix + associated with that particular combination/region independently + of any other transformations applied within tree structures.</para> + </footnote> + </para> + + <para> In an empty MGED session, create a new geometry database + called <emphasis>oed_examples.g</emphasis>. Enable the model + coordinate axes display by entering the MGED command + <command>rset ax model_draw 1</command>. Create two primitives: + <footnote> + <para> This document will respect the normal BRL-CAD naming + convention: use the .s extension for primitives, the .c + extension for combinations below regions, and the .r extension + for regions. Combinations above regions have no extension.</para> + </footnote> + + <literallayout class="monospaced">in sphere.s sph 0 0 0 4</literallayout> + <literallayout class="monospaced">in cube.s arb8 5 5 0 8 5 0 8 5 3 5 5 3 5 8 0 8 8 0 8 8 3 5 8 3</literallayout> + + There should now be a sphere and a cube visible on the screen. Next + create a combination of these two primitives: + + <literallayout class="monospaced">comb object1.c u sphere.s u cube.s</literallayout> + + After this command both the primitives and the combination are \ + present in the display, which will result in overlaps. Use the + <command>B</command> command to reduce the display to just the + combination. + <footnote> + <para>The <command>B</command> abbreviation stands for "blast" - + i.e. remove all objects from being displayed, and draw only the + specified objects.</para> +... [truncated message content] |
From: <sta...@us...> - 2008-10-03 02:05:24
|
Revision: 32822 http://brlcad.svn.sourceforge.net/brlcad/?rev=32822&view=rev Author: starseeker Date: 2008-10-03 02:05:13 +0000 (Fri, 03 Oct 2008) Log Message: ----------- Update image links and html install paths to allow both pdf and html to work again. Modified Paths: -------------- brlcad/trunk/doc/docbook/articles/build_pattern/en/Makefile.am brlcad/trunk/doc/docbook/articles/build_pattern/en/build_pattern.xml brlcad/trunk/doc/docbook/articles/build_region/en/Makefile.am brlcad/trunk/doc/docbook/articles/build_region/en/build_region.xml brlcad/trunk/doc/docbook/articles/ebm_primitive/en/Makefile.am brlcad/trunk/doc/docbook/articles/ebm_primitive/en/ebm_primitive.xml brlcad/trunk/doc/docbook/articles/mgedrc/en/Makefile.am brlcad/trunk/doc/docbook/articles/mgedrc/en/mgedrc.xml brlcad/trunk/doc/docbook/articles/oed/en/Makefile.am brlcad/trunk/doc/docbook/articles/oed/en/oed.xml brlcad/trunk/doc/docbook/articles/pipes/en/Makefile.am brlcad/trunk/doc/docbook/articles/pipes/en/pipes.xml brlcad/trunk/doc/docbook/articles/projection_shader/en/Makefile.am brlcad/trunk/doc/docbook/articles/projection_shader/en/projection_shader.xml brlcad/trunk/doc/docbook/articles/tire/en/Makefile.am brlcad/trunk/doc/docbook/articles/tire/en/tire.xml brlcad/trunk/doc/docbook/books/tutorial_series/en/Makefile.am brlcad/trunk/doc/docbook/books/tutorial_series/en/VolumeIII.xml brlcad/trunk/doc/docbook/lessons/mged/en/Makefile.am brlcad/trunk/doc/docbook/lessons/mged/en/assigning_material_properties_and_raytracing.xml brlcad/trunk/doc/docbook/lessons/mged/en/creating_mug.xml brlcad/trunk/doc/docbook/lessons/mged/en/creating_primitive_shapes.xml brlcad/trunk/doc/docbook/lessons/mged/en/creating_toy_truck.xml brlcad/trunk/doc/docbook/lessons/mged/en/globe_in_display_box.xml brlcad/trunk/doc/docbook/lessons/mged/en/goblet_material_properties.xml brlcad/trunk/doc/docbook/lessons/mged/en/goblet_material_properties2.xml brlcad/trunk/doc/docbook/lessons/mged/en/learning_boolean_expressions.xml brlcad/trunk/doc/docbook/lessons/mged/en/learning_viewing_options.xml brlcad/trunk/doc/docbook/lessons/mged/en/modeling_techniques_and_structures.xml brlcad/trunk/doc/docbook/lessons/mged/en/mug_through_gui.xml brlcad/trunk/doc/docbook/lessons/mged/en/placing_shapes_in_3d.xml brlcad/trunk/doc/docbook/lessons/mged/en/placing_shapes_in_3d_2.xml brlcad/trunk/doc/docbook/lessons/mged/en/refining_mug.xml brlcad/trunk/doc/docbook/lessons/mged/en/using_insert_command.xml brlcad/trunk/doc/docbook/system/man1/en/Makefile.am Modified: brlcad/trunk/doc/docbook/articles/build_pattern/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/build_pattern/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/build_pattern/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -build_patternDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/build_pattern +build_patternDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/build_pattern/en build_patternDOCBOOKhtml_DATA = $(BUILTHTML) -build_patternDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/build_pattern +build_patternDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/build_pattern/en build_patternDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/build_pattern/en/build_pattern.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/build_pattern/en/build_pattern.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/build_pattern/en/build_pattern.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -79,7 +79,7 @@ <title>Example of pattern-generated assembly names.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_pattern/build_pattern_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_pattern/build_pattern_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -124,7 +124,7 @@ Each element of the object must have the source string so the user must be thorough and name each primitive, region, and assembly properly. Consider the following example: - <inlinegraphic fileref="../../articles/build_pattern/build_pattern_images/inline1.png" /> + <inlinegraphic fileref="../../../articles/build_pattern/build_pattern_images/inline1.png" /> </para> <para> Top-level duplications copy the patterned object and reference its entire @@ -178,7 +178,7 @@ <title>The user interface for building rectangular patterns.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_pattern/build_pattern_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_pattern/build_pattern_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -232,7 +232,7 @@ <title>The user interface for building spherical patterns.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_pattern/build_pattern_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_pattern/build_pattern_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -255,7 +255,7 @@ <title>Examples of different spherical pattern orientations.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_pattern/build_pattern_images/figure4.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_pattern/build_pattern_images/figure4.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -265,7 +265,7 @@ <title>Implementation of spherical patterns.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_pattern/build_pattern_images/figure5.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_pattern/build_pattern_images/figure5.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -290,7 +290,7 @@ <title>The user interface for building cylindrical patterns.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_pattern/build_pattern_images/figure6.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_pattern/build_pattern_images/figure6.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/build_region/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/build_region/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/build_region/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -build_regionDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/build_region +build_regionDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/build_region/en build_regionDOCBOOKhtml_DATA = $(BUILTHTML) -build_regionDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/build_region +build_regionDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/build_region/en build_regionDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/build_region/en/build_region.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/build_region/en/build_region.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/build_region/en/build_region.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -50,7 +50,7 @@ <title>The rounded corners of a toy wagon.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_region/build_region_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_region/build_region_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -69,7 +69,7 @@ <title>Arb8, cylinder, and two Boolean primitives.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_region/build_region_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_region/build_region_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -103,7 +103,7 @@ <title>The region and the subtraction primitives.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_region/build_region_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_region/build_region_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -118,7 +118,7 @@ <title>Raytraced image with hole.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/build_region/build_region_images/figure4.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/build_region/build_region_images/figure4.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/ebm_primitive/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/ebm_primitive/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/ebm_primitive/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -ebm_primitiveDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/ebm_primitive +ebm_primitiveDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/ebm_primitive/en ebm_primitiveDOCBOOKhtml_DATA = $(BUILTHTML) -ebm_primitiveDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/ebm_primitive +ebm_primitiveDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/ebm_primitive/en ebm_primitiveDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/ebm_primitive/en/ebm_primitive.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/ebm_primitive/en/ebm_primitive.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/ebm_primitive/en/ebm_primitive.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -29,7 +29,7 @@ <title>Example of the .bw image used for ebm.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/ebm_primitive/ebm_primitive_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/ebm_primitive/ebm_primitive_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -38,7 +38,7 @@ <title>Example of ebm.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/ebm_primitive/ebm_primitive_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/ebm_primitive/ebm_primitive_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -47,7 +47,7 @@ <title>Example of the ebm with projection shader added.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/ebm_primitive/ebm_primitive_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/ebm_primitive/ebm_primitive_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/mgedrc/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/mgedrc/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/mgedrc/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -mgedrcDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/mgedrc +mgedrcDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/mgedrc/en mgedrcDOCBOOKhtml_DATA = $(BUILTHTML) -mgedrcDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/mgedrc +mgedrcDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/mgedrc/en mgedrcDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/mgedrc/en/mgedrc.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/mgedrc/en/mgedrc.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/mgedrc/en/mgedrc.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -62,7 +62,7 @@ after header.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/mgedrc/mgedrc_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/mgedrc/mgedrc_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -204,7 +204,7 @@ <title>Sample elements and functionality of a .mgedrc file.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/mgedrc/mgedrc_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/mgedrc/mgedrc_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -252,7 +252,7 @@ <title>Sample window dimension input and positioning.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/mgedrc/mgedrc_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/mgedrc/mgedrc_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/oed/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/oed/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/oed/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -oedDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/oed +oedDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/oed/en oedDOCBOOKhtml_DATA = $(BUILTHTML) -oedDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/oed +oedDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/oed/en oedDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/oed/en/oed.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/oed/en/oed.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/oed/en/oed.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -74,7 +74,7 @@ <para> <screenshot> - <graphic align = "center" fileref="../../articles/oed/oed_images/lollipop.png"></graphic> + <graphic align = "center" fileref="../../../articles/oed/oed_images/lollipop.png"></graphic> </screenshot> </para> @@ -221,7 +221,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0001.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0001.png"></graphic> </screenshot> </para> @@ -284,7 +284,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0002.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0002.png"></graphic> </screenshot> </para> @@ -297,7 +297,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0003.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0003.png"></graphic> </screenshot> </para> @@ -309,7 +309,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0004.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0004.png"></graphic> </screenshot> </para> @@ -360,7 +360,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0005.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0005.png"></graphic> </screenshot> </para> @@ -488,7 +488,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0006.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0006.png"></graphic> </screenshot> </para> @@ -529,7 +529,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0007.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0007.png"></graphic> </screenshot> </para> @@ -601,7 +601,7 @@ <literallayout class="monospaced">accept</literallayout> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0008.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0008.png"></graphic> </screenshot> <literallayout class="monospaced"> @@ -638,7 +638,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0009.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0009.png"></graphic> </screenshot> </para> @@ -688,7 +688,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0010.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0010.png"></graphic> </screenshot> </para> @@ -703,7 +703,7 @@ <para> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0011.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0011.png"></graphic> </screenshot> </para> @@ -769,7 +769,7 @@ <literallayout class="monospaced">B bigobject.r</literallayout> <screenshot> - <graphic align="center" fileref="../../articles/oed/oed_images/oed_0012.png"></graphic> + <graphic align="center" fileref="../../../articles/oed/oed_images/oed_0012.png"></graphic> </screenshot> </para> Modified: brlcad/trunk/doc/docbook/articles/pipes/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/pipes/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/pipes/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -pipesDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/pipes +pipesDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/pipes/en pipesDOCBOOKhtml_DATA = $(BUILTHTML) -pipesDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/pipes +pipesDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/pipes/en pipesDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/pipes/en/pipes.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/pipes/en/pipes.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/pipes/en/pipes.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -81,7 +81,7 @@ <title>Basic pipe with parameters.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/pipes/pipe_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/pipes/pipe_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -90,7 +90,7 @@ <title>Various bend radii.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/pipes/pipe_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/pipes/pipe_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -99,7 +99,7 @@ <title>Example of special uses of the pipe.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/pipes/pipe_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/pipes/pipe_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -182,7 +182,7 @@ <title>Determining the point positions for the copper coil.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/pipes/pipe_images/figure4.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/pipes/pipe_images/figure4.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -283,35 +283,35 @@ <tbody> <row> <entry>- mged>p 500 -500 150</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline1.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline1.png" /></entry> </row> <row> <entry>- mged>p -500 -500 250</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline2.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline2.png" /></entry> </row> <row> <entry>- mged>p -500 500 350</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline3.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline3.png" /></entry> </row> <row> <entry>- mged>p 500 500 450</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline4.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline4.png" /></entry> </row> <row> <entry>- mged>p 500 -500 550</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline5.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline5.png" /></entry> </row> <row> <entry>- mged>p -500 -500 650</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline6.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline6.png" /></entry> </row> <row> <entry>- mged>p -500 500 750</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline7.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline7.png" /></entry> </row> <row> <entry>- mged>p 0 500 800</entry> - <entry><inlinegraphic fileref="../../articles/pipes/pipe_images/inline8.png" /></entry> + <entry><inlinegraphic fileref="../../../articles/pipes/pipe_images/inline8.png" /></entry> </row> </tbody> </tgroup> @@ -325,7 +325,7 @@ <title>Raytraced coil segment.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/pipes/pipe_images/figure5.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/pipes/pipe_images/figure5.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/projection_shader/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/projection_shader/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/projection_shader/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -projection_shaderDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/projection_shader +projection_shaderDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/projection_shader/en projection_shaderDOCBOOKhtml_DATA = $(BUILTHTML) -projection_shaderDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/projection_shader +projection_shaderDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/projection_shader/en projection_shaderDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/projection_shader/en/projection_shader.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/projection_shader/en/projection_shader.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/projection_shader/en/projection_shader.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -28,7 +28,7 @@ <title>The many components of a circuit board.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -167,7 +167,7 @@ <title>Using the Raytrace Control Panel to size the graphics window.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -295,7 +295,7 @@ <title>Fitting the geometry view to the image dimensions.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -333,7 +333,7 @@ <title>Applying the shader settings with the combination editor.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure4.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure4.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -342,7 +342,7 @@ <title>Original image (left) and image with circular cutouts (right).</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure5.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure5.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -367,7 +367,7 @@ <title>The projection shader applied to the front of the circuit board.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure6.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure6.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -380,7 +380,7 @@ <title>The circuit board .prj file.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/projection_shader/projection_shader_images/figure7.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/projection_shader/projection_shader_images/figure7.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/tire/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/tire/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/tire/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -tireDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/tire +tireDOCBOOKhtmldir = $(BRLCAD_DATA)/html/articles/tire/en tireDOCBOOKhtml_DATA = $(BUILTHTML) -tireDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/tire +tireDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/articles/tire/en tireDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/articles/tire/en/tire.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/tire/en/tire.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/articles/tire/en/tire.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -66,7 +66,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0001.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0001.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -185,7 +185,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0002.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0002.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -210,7 +210,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0003.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0003.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -289,7 +289,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0004.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0004.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -309,7 +309,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0005.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0005.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -333,7 +333,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0006.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0006.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -360,7 +360,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0007.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0007.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -385,7 +385,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0008.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0008.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -441,7 +441,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0009.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0009.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -462,7 +462,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0010.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0010.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -488,7 +488,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0011.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0011.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -516,7 +516,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0012.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0012.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -541,7 +541,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0013.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0013.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -598,7 +598,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/tire/tire_images/tire_0014.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../articles/tire/tire_images/tire_0014.png" format="PNG"></imagedata> </imageobject> <caption> <para> Modified: brlcad/trunk/doc/docbook/books/tutorial_series/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/books/tutorial_series/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/books/tutorial_series/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -27,10 +27,10 @@ endif -tutorial_seriesDOCBOOKhtmldir = $(BRLCAD_DATA)/html/books/tutorial_series +tutorial_seriesDOCBOOKhtmldir = $(BRLCAD_DATA)/html/books/tutorial_series/en tutorial_seriesDOCBOOKhtml_DATA = $(BUILTHTML) -tutorial_seriesDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/books/tutorial_series +tutorial_seriesDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/books/tutorial_series/en tutorial_seriesDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/books/tutorial_series/en/VolumeIII.xml =================================================================== --- brlcad/trunk/doc/docbook/books/tutorial_series/en/VolumeIII.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/books/tutorial_series/en/VolumeIII.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -160,7 +160,7 @@ <title>Ballistic penetration model with transparent exterior.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure1.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -169,7 +169,7 @@ <title>External detail commonly used in radar signature models.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure2.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -247,7 +247,7 @@ <title>M-O-D-E-L: the five-stage modeling process.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure3.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -300,7 +300,7 @@ Blueprints/schematics/mechanical drawings/photographs </para> <para> - <inlinegraphic fileref="./volumeIII_images/inline1.png" /> + <inlinegraphic fileref="../volumeIII_images/inline1.png" /> </para> </entry> <entry> @@ -320,7 +320,7 @@ Measurable objects </para> <para> - <inlinegraphic fileref="./volumeIII_images/inline2.png" /> + <inlinegraphic fileref="../volumeIII_images/inline2.png" /> </para> </entry> <entry> @@ -338,7 +338,7 @@ Converted geometry </para> <para> - <inlinegraphic fileref="./volumeIII_images/inline3.png" /> + <inlinegraphic fileref="../volumeIII_images/inline3.png" /> </para> </entry> <entry> @@ -937,7 +937,7 @@ <title>Location-based structure of the radio in Volume II.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure4.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure4.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -945,7 +945,7 @@ <title>Function-based structure of the radio in Volume II.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure5.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure5.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1128,7 +1128,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/primitive1.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/primitive1.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -1156,7 +1156,7 @@ Illegal variations include the following: </para> <para> - <inlinegraphic fileref="./volumeIII_images/invalidarbs.png" /> + <inlinegraphic fileref="../volumeIII_images/invalidarbs.png" /> </para> </listitem> </itemizedlist> @@ -1168,7 +1168,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/primitive2.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/primitive2.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -1201,7 +1201,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/primitive3.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/primitive3.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -1243,7 +1243,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/primitive4.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/primitive4.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -1291,7 +1291,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/primitive5.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/primitive5.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -1333,7 +1333,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/primitive6.png"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/primitive6.png"></imagedata> </imageobject> <caption> <para> @@ -1596,7 +1596,7 @@ <title>Coordinate axes of a turreted ground vehicle.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure6.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure6.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1604,7 +1604,7 @@ <title>Coordinate axes of a nonturreted ground vehicle.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure7.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure7.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1612,7 +1612,7 @@ <title>Coordinate axes of a fixed-wing aircraft.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure8.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure8.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1620,7 +1620,7 @@ <title>Coordinate axes of a rotary-wing aircraft.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure9.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure9.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1660,7 +1660,7 @@ <title>Building multiple occurrences through replication.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure10.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure10.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1669,7 +1669,7 @@ <title>Building multiple occurrences through referencing.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure11.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure11.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1903,7 +1903,7 @@ <title>Target geometry.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure12.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure12.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1911,7 +1911,7 @@ <title>Example of an Overly Large Bounding Primitive.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure13.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure13.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1919,7 +1919,7 @@ <title>Example of a compact bounding primitive.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure14.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure14.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -1957,7 +1957,7 @@ <title>Example of grouping objects for articulation.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure15.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure15.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -2018,7 +2018,7 @@ <title>Sample Boolean operations.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure16.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure16.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -2107,7 +2107,7 @@ <title>Properly (top) and improperly (bottom) ordered regions.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure17.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure17.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -2993,7 +2993,7 @@ <title>Shotline through a tank.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure18.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure18.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -3067,7 +3067,7 @@ <title>Example of overlaps in the graphics window.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure19.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure19.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> @@ -3088,7 +3088,7 @@ <title>Example of an overlap report in the command window.</title> <mediaobject> <imageobject> - <imagedata align = "center" fileref="./volumeIII_images/figure20.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../volumeIII_images/figure20.png" format="PNG"></imagedata> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/lessons/mged/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/Makefile.am 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/Makefile.am 2008-10-03 02:05:13 UTC (rev 32822) @@ -42,10 +42,10 @@ endif -lessonsDOCBOOKhtmldir = $(BRLCAD_DATA)/html/lessons/mged +lessonsDOCBOOKhtmldir = $(BRLCAD_DATA)/html/lessons/mged/en lessonsDOCBOOKhtml_DATA = $(BUILTHTML) -lessonsDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/lessons/mged +lessonsDOCBOOKpdfdir = $(BRLCAD_DATA)/pdf/lessons/mged/en lessonsDOCBOOKpdf_DATA = $(BUILTPDF) BUILT_SOURCES = \ Modified: brlcad/trunk/doc/docbook/lessons/mged/en/assigning_material_properties_and_raytracing.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/assigning_material_properties_and_raytracing.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/assigning_material_properties_and_raytracing.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -168,7 +168,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/assigning_material_properties_and_raytracing_images/commandwindow.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/assigning_material_properties_and_raytracing_images/commandwindow.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -282,7 +282,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/assigning_material_properties_and_raytracing_images/raytracedshapes.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/assigning_material_properties_and_raytracing_images/raytracedshapes.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -333,8 +333,8 @@ <tgroup cols='2'> <tbody> <row> - <entry><inlinegraphic fileref="../../lessons/mged/assigning_material_properties_images/raytracedshapes.png" /></entry> - <entry><inlinegraphic fileref="../../lessons/mged/assigning_material_properties_images/fb_overlay_mode.png" /></entry> + <entry><inlinegraphic fileref="../../../lessons/mged/assigning_material_properties_images/raytracedshapes.png" /></entry> + <entry><inlinegraphic fileref="../../../lessons/mged/assigning_material_properties_images/fb_overlay_mode.png" /></entry> </row> <row> <entry>Framebuffer in Underlay Mode</entry> Modified: brlcad/trunk/doc/docbook/lessons/mged/en/creating_mug.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/creating_mug.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/creating_mug.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -339,7 +339,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_mug_images/mug_wireframe.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_mug_images/mug_wireframe.png" format="PNG"></imagedata> </imageobject> <caption> <para> Modified: brlcad/trunk/doc/docbook/lessons/mged/en/creating_primitive_shapes.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/creating_primitive_shapes.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/creating_primitive_shapes.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -139,7 +139,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_primitive_shapes_images/terminal.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_primitive_shapes_images/terminal.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -177,7 +177,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_primitive_shapes_images/commandwindow.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_primitive_shapes_images/commandwindow.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -190,7 +190,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_primitive_shapes_images/graphicswindow.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_primitive_shapes_images/graphicswindow.png" format="PNG"></imagedata> </imageobject> <caption> <para> Modified: brlcad/trunk/doc/docbook/lessons/mged/en/creating_toy_truck.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/creating_toy_truck.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/creating_toy_truck.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -56,7 +56,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_design.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_design.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -119,7 +119,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_cab1s.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_cab1s.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -206,7 +206,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_cab_cutoff.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_cab_cutoff.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -247,7 +247,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_multipane_1stwheel.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_multipane_1stwheel.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -304,7 +304,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/prim_ed_wheel_well.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/prim_ed_wheel_well.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -326,7 +326,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_2nd_wheel_wheel_place.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_2nd_wheel_wheel_place.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -424,7 +424,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_cab_body.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_cab_body.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -448,7 +448,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_wheel_wells_wireframe.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_wheel_wells_wireframe.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -545,7 +545,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/truck_wheels.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/truck_wheels.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -597,7 +597,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/creating_toy_truck_images/cameo_shader.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/creating_toy_truck_images/cameo_shader.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -777,8 +777,8 @@ <tgroup cols='2' align='center'> <tbody> <row> - <entry><inlinegraphic fileref="../../lessons/mged/creating_toy_truck_images/truck_default_lighting.png" /></entry> - <entry><inlinegraphic fileref="../../lessons/mged/creating_toy_truck_images/truck_ambient_lighting.png" /></entry> + <entry><inlinegraphic fileref="../../../lessons/mged/creating_toy_truck_images/truck_default_lighting.png" /></entry> + <entry><inlinegraphic fileref="../../../lessons/mged/creating_toy_truck_images/truck_ambient_lighting.png" /></entry> </row> <row> <entry>Truck with Default Lighting</entry> Modified: brlcad/trunk/doc/docbook/lessons/mged/en/globe_in_display_box.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/globe_in_display_box.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/globe_in_display_box.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -52,7 +52,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/globe_in_display_box_images/globe_outside_display_box.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/globe_in_display_box_images/globe_outside_display_box.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -74,7 +74,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/globe_in_display_box_images/globe_inside_outside_box.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/globe_in_display_box_images/globe_inside_outside_box.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -117,7 +117,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/globe_in_display_box_images/globe_wireframe.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/globe_in_display_box_images/globe_wireframe.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -193,7 +193,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/globe_in_display_box_images/globe_raytraced.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/globe_in_display_box_images/globe_raytraced.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -292,7 +292,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/globe_in_display_box_images/globe_base_box_wireframe.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/globe_in_display_box_images/globe_base_box_wireframe.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -339,7 +339,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/globe_in_display_box_images/globe_base_box_raytraced.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/globe_in_display_box_images/globe_base_box_raytraced.png" format="PNG"></imagedata> </imageobject> </mediaobject> </informalfigure> Modified: brlcad/trunk/doc/docbook/lessons/mged/en/goblet_material_properties.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/mged/en/goblet_material_properties.xml 2008-10-02 22:21:40 UTC (rev 32821) +++ brlcad/trunk/doc/docbook/lessons/mged/en/goblet_material_properties.xml 2008-10-03 02:05:13 UTC (rev 32822) @@ -38,7 +38,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/goblet_material_properties_images/goblet_mater_complete.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/goblet_material_properties_images/goblet_mater_complete.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -157,7 +157,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/goblet_material_properties_images/goblet_complete_window.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../../lessons/mged/goblet_material_properties_images/goblet_complete_window.png" format="PNG"><... [truncated message content] |
From: <br...@us...> - 2008-10-08 11:22:09
|
Revision: 32882 http://brlcad.svn.sourceforge.net/brlcad/?rev=32882&view=rev Author: brlcad Date: 2008-10-08 10:35:27 +0000 (Wed, 08 Oct 2008) Log Message: ----------- ignore the generated files for a clean svn status Property Changed: ---------------- brlcad/trunk/doc/docbook/articles/build_pattern/en/ brlcad/trunk/doc/docbook/articles/build_region/en/ brlcad/trunk/doc/docbook/articles/ebm_primitive/en/ brlcad/trunk/doc/docbook/articles/mgedrc/en/ brlcad/trunk/doc/docbook/articles/oed/en/ brlcad/trunk/doc/docbook/articles/pipes/en/ brlcad/trunk/doc/docbook/articles/projection_shader/en/ brlcad/trunk/doc/docbook/articles/tire/en/ brlcad/trunk/doc/docbook/books/tutorial_series/en/ brlcad/trunk/doc/docbook/lessons/mged/en/ brlcad/trunk/doc/docbook/system/man1/en/ Property changes on: brlcad/trunk/doc/docbook/articles/build_pattern/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/build_region/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/ebm_primitive/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/mgedrc/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/oed/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/pipes/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/projection_shader/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/articles/tire/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/books/tutorial_series/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/lessons/mged/en ___________________________________________________________________ Added: svn:ignore + *.html Property changes on: brlcad/trunk/doc/docbook/system/man1/en ___________________________________________________________________ Added: svn:ignore + *.1 *.html This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2008-10-22 04:55:50
|
Revision: 33042 http://brlcad.svn.sourceforge.net/brlcad/?rev=33042&view=rev Author: starseeker Date: 2008-10-22 04:55:44 +0000 (Wed, 22 Oct 2008) Log Message: ----------- These tweaks get make distcheck through the doc build. Next up is the failure of dvi Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am brlcad/trunk/doc/docbook/system/man1/en/Makefile.am Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2008-10-22 03:22:23 UTC (rev 33041) +++ brlcad/trunk/doc/docbook/Makefile.am 2008-10-22 04:55:44 UTC (rev 33042) @@ -17,6 +17,7 @@ EXTRA_DIST = \ README \ - catalog.xml + catalog.xml \ + resources include $(top_srcdir)/misc/Makefile.defs Modified: brlcad/trunk/doc/docbook/system/man1/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2008-10-22 03:22:23 UTC (rev 33041) +++ brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2008-10-22 04:55:44 UTC (rev 33042) @@ -71,6 +71,7 @@ $(BUILTMAN_SOURCES) EXTRA_DIST = \ - ${man1DOCBOOK} + ${man1DOCBOOK} \ + ${man1INTRO} include $(top_srcdir)/misc/Makefile.defs This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2008-10-25 20:11:43
|
Revision: 33067 http://brlcad.svn.sourceforge.net/brlcad/?rev=33067&view=rev Author: starseeker Date: 2008-10-25 20:11:39 +0000 (Sat, 25 Oct 2008) Log Message: ----------- Add ignores for docbook - still need to do articles Property Changed: ---------------- brlcad/trunk/doc/docbook/articles/ brlcad/trunk/doc/docbook/books/ brlcad/trunk/doc/docbook/books/tutorial_series/ brlcad/trunk/doc/docbook/books/tutorial_series/en/ brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images/ brlcad/trunk/doc/docbook/lessons/ brlcad/trunk/doc/docbook/lessons/mged/ brlcad/trunk/doc/docbook/lessons/mged/L001_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L002_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L004_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L005_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L006_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L007_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L008_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L009_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L010_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L011_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L012_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L013_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L014_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L015_imgs/ brlcad/trunk/doc/docbook/lessons/mged/L016_imgs/ brlcad/trunk/doc/docbook/lessons/mged/en/ brlcad/trunk/doc/docbook/system/ brlcad/trunk/doc/docbook/system/man1/en/ Property changes on: brlcad/trunk/doc/docbook/articles ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/books ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/books/tutorial_series ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/books/tutorial_series/en ___________________________________________________________________ Modified: svn:ignore - *.html + *.html *.pdf Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/books/tutorial_series/volumeIII_images ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L001_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L002_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L004_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L005_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L006_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L007_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L008_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L009_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L010_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L011_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L012_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L013_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L014_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L015_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/L016_imgs ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/lessons/mged/en ___________________________________________________________________ Modified: svn:ignore - *.html + *.html *.pdf Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/system ___________________________________________________________________ Added: svn:ignore + Makefile.in Makefile Property changes on: brlcad/trunk/doc/docbook/system/man1/en ___________________________________________________________________ Modified: svn:ignore - *.1 *.html + *.1 *.html *.pdf Makefile.in Makefile This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2009-01-12 16:58:15
|
Revision: 33534 http://brlcad.svn.sourceforge.net/brlcad/?rev=33534&view=rev Author: brlcad Date: 2009-01-12 16:58:05 +0000 (Mon, 12 Jan 2009) Log Message: ----------- all text files should have a trailing newline for parsing/portability/consistency. Modified Paths: -------------- brlcad/trunk/doc/docbook/articles/nirt/fo_custom.xsl brlcad/trunk/doc/docbook/books/tutorial_series/book_authors.xml brlcad/trunk/doc/docbook/system/man1/en/bot_face_sort.xml brlcad/trunk/doc/docbook/system/man1/en/color.xml Modified: brlcad/trunk/doc/docbook/articles/nirt/fo_custom.xsl =================================================================== --- brlcad/trunk/doc/docbook/articles/nirt/fo_custom.xsl 2009-01-12 14:30:06 UTC (rev 33533) +++ brlcad/trunk/doc/docbook/articles/nirt/fo_custom.xsl 2009-01-12 16:58:05 UTC (rev 33534) @@ -5,4 +5,4 @@ <xsl:attribute-set name="monospace.properties"> <xsl:attribute name="font-size">7.3</xsl:attribute> </xsl:attribute-set> -</xsl:stylesheet> \ No newline at end of file +</xsl:stylesheet> Modified: brlcad/trunk/doc/docbook/books/tutorial_series/book_authors.xml =================================================================== --- brlcad/trunk/doc/docbook/books/tutorial_series/book_authors.xml 2009-01-12 14:30:06 UTC (rev 33533) +++ brlcad/trunk/doc/docbook/books/tutorial_series/book_authors.xml 2009-01-12 16:58:05 UTC (rev 33534) @@ -119,4 +119,4 @@ </affiliation> </author> </authorgroup> -</bookinfo> \ No newline at end of file +</bookinfo> Modified: brlcad/trunk/doc/docbook/system/man1/en/bot_face_sort.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/bot_face_sort.xml 2009-01-12 14:30:06 UTC (rev 33533) +++ brlcad/trunk/doc/docbook/system/man1/en/bot_face_sort.xml 2009-01-12 16:58:05 UTC (rev 33534) @@ -109,4 +109,4 @@ mail to <de...@br...>, or via the "cadbug.sh" script. </para> </refsect1> -</refentry> \ No newline at end of file +</refentry> Modified: brlcad/trunk/doc/docbook/system/man1/en/color.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/color.xml 2009-01-12 14:30:06 UTC (rev 33533) +++ brlcad/trunk/doc/docbook/system/man1/en/color.xml 2009-01-12 16:58:05 UTC (rev 33534) @@ -108,4 +108,4 @@ mail to <de...@br...>, or via the "cadbug.sh" script. </para> </refsect1> -</refentry> \ No newline at end of file +</refentry> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2009-03-24 04:22:17
|
Revision: 34065 http://brlcad.svn.sourceforge.net/brlcad/?rev=34065&view=rev Author: starseeker Date: 2009-03-24 04:22:14 +0000 (Tue, 24 Mar 2009) Log Message: ----------- Start working on converting http://brlcad.org/OLD/newdb/newdb.html to docbook. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml Added: brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml =================================================================== --- brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml (rev 0) +++ brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml 2009-03-24 04:22:14 UTC (rev 34065) @@ -0,0 +1,265 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"/usr/share/sgml/docbook/xml-dtd-4.5/docbookx.dtd"> +<article class='specification'> + <articleinfo> + <title>BRL-CAD Database Format</title> + <subtitle>Version 5 (DRAFT)</subtitle> + <authorgroup> + <author> + <firstname>Lee</firstname> + <surname>Butler</surname> + <othername role='mi'>A</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Michael</firstname> + <surname>Muuss</surname> + <othername role='mi'>John</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Paul</firstname> + <surname>Tanenbaum</surname> + <othername role='mi'>J</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>John</firstname> + <surname>Anderson</surname> + <othername role='mi'>R</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Robert</firstname> + <surname>Parker</surname> + <othername role='mi'>G</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Ronald</firstname> + <surname>Bowers</surname> + <othername role='mi'>A</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Christopher</firstname> + <surname>Johnson</surname> + <othername role='mi'>T</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Eric</firstname> + <surname>Edwards</surname> + <othername role='mi'>W</othername> + <affiliation> + <shortaffil>SURVICE Engineering Company</shortaffil> + <address> + <street>4695 Millennium Drive</street> + <city>Belcamp</city> + <state>MD</state> + <postcode>21017-1505</postcode> + </address> + </affiliation> + </author> + </authorgroup> + </articleinfo> + + <abstract> + <para> + BRL-CAD software uses its own binary file format to store the geometric information and + other properties required to define CAD models. BRL-CAD used its version 4 (v4) binary + ".g" database format for over 10 years, but a variety of long standing issues with + that format prompted the development of version 5. Issues addressed by the new format + include a machine-independent format, expanding the upper limit of numbers to double + precision floating point, and lifting a 16 character size limit on object names. + </para> + </abstract> + + <section> + <title>Background and Terminology</title> + <para> + BRL-CAD is a constructive solid geometry (CSG) modeling system. Primitive solid shapes + are combined using boolean operations to form regions of homogeneous material. + </para> + <para> + The database is organized as a <emphasis>directed acyclic graph</emphasis> (DAG), which + comprises + + <itemizedlist> + <listitem> + <para>primitive solids - the minimal elements of the DAG.</para> + </listitem> + <listitem> + <para> + combinations - the nonminimal elements of the DAG, + some of which are specially marked as regions. The maximal + elements of the DAG are called tops. + </para> + </listitem> + <listitem> + <para>arcs - contain boolean operators and 4x4 homogeneous transformation matrices.</para> + </listitem> + </itemizedlist> + </para> + <para> + In a slight abuse of terminology, the DAG is often spoken of as a tree or collection + of trees. In this context, the solids are also called <emphasis>leaves</emphasis>. + </para> + <section> + <title>Format of Data Elements/Database External Format</title> + <para> + The external format has several important properties, especially with regard + to the <emphasis>Object_Body</emphasis>: + <itemizedlist> + <listitem> + <para> + Numbers are stored in binary for storage efficiency, for speed of reading + and writing, and for preventing errors from creeping in due to repetitive + conversion between binary and an ASCII string representation. This eliminates + the need to use the old g2asc and asc2g to move databases between machines of + different architectures. + </para> + </listitem> + <listitem> + <para> + All data in the object wrapper are stored in a machine-independent format, + as follows: + <itemizedlist mark='opencircle'> + <listitem> + <para> + All floating point numbers are stored as IEEE double-precision, in + big-endian order, where byte 0 is on the left end of the word. + </para> + </listitem> + <listitem> + <para> + All integers are stored as either <emphasis>unsigned</emphasis> or + <emphasis>twos-complement signed</emphasis> binary numbers in either + 8, 16, 32, or 64 bits, in big-endian order. + </para> + </listitem> + <listitem> + <para> + All character strings are stored in the ASCII 8-bit character set. + A string is stored as an integer followed by an array of 8-bit + characters. The last character in the array is always a null byte. + The integer indicates the number of bytes in the array including the + terminating null. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </itemizedlist> + </para> + </section> + </section> + + <section> + <title>Definition of a Single, Generic Database Object</title> + <para> + The database access library stores <emphasis>objects</emphasis> as a collection + of data with a globally unique name and places no interpretation on the content + of those data. The <emphasis>object</emphasis> is the smallest granularity of + an item in the database; objects must be read from and written to the database + in a single atomic operation. + </para> + <para> + In the case of librt, each database object will contain exactly one combination + node or leaf (solid) node. + </para> + </section> + <section> + <title>How Objects Are Grouped into a Database</title> + <para> + + </para> + </section> + <section> + <title>Details of BRL-CAD-Specific Nongeometric Database Object Types</title> + <para> + + </para> + </section> + <section> + <title>Details of BRL-CAD-Specific Geometric Database Object Types</title> + <para> + + </para> + </section> + <section> + <title>Extensions for Deferred Implementation</title> + <para> + + </para> + </section> + <section> + <title>Community Feedback on the Proposal</title> + <para> + + </para> + </section> + <section> + <title>Database Library Application Programming Interface (API)</title> + <para> + + </para> + </section> + + </article> Property changes on: brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml ___________________________________________________________________ Added: svn:mime-type + text/xml Added: svn:eol-style + native Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-03-23 19:25:12 UTC (rev 34064) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-03-24 04:22:14 UTC (rev 34065) @@ -17,6 +17,7 @@ EXTRA_DIST = \ README \ + BRL-CAD_db_format.xml \ catalog.xml \ resources This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2009-10-21 20:38:27
|
Revision: 36238 http://brlcad.svn.sourceforge.net/brlcad/?rev=36238&view=rev Author: starseeker Date: 2009-10-21 20:38:19 +0000 (Wed, 21 Oct 2009) Log Message: ----------- Eh, what the heck - enable the docbook build of the old v5 .g spec xml translation effort - will make it easier to work on at some point in the future. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/system/en/ brlcad/trunk/doc/docbook/system/en/BRL-CAD_db_format.xml brlcad/trunk/doc/docbook/system/en/images/ Removed Paths: ------------- brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml Deleted: brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml =================================================================== --- brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml 2009-10-21 19:20:09 UTC (rev 36237) +++ brlcad/trunk/doc/docbook/BRL-CAD_db_format.xml 2009-10-21 20:38:19 UTC (rev 36238) @@ -1,1728 +0,0 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" -"/usr/share/sgml/docbook/xml-dtd-4.5/docbookx.dtd"> -<article class='specification'> - <articleinfo> - <title>BRL-CAD Database Format</title> - <subtitle>Version 5 (DRAFT)</subtitle> - <authorgroup> - <author> - <firstname>Lee</firstname> - <surname>Butler</surname> - <othername role='mi'>A</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>Michael</firstname> - <surname>Muuss</surname> - <othername role='mi'>John</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>Paul</firstname> - <surname>Tanenbaum</surname> - <othername role='mi'>J</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>John</firstname> - <surname>Anderson</surname> - <othername role='mi'>R</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>Robert</firstname> - <surname>Parker</surname> - <othername role='mi'>G</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>Ronald</firstname> - <surname>Bowers</surname> - <othername role='mi'>A</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>Christopher</firstname> - <surname>Johnson</surname> - <othername role='mi'>T</othername> - <affiliation> - <shortaffil>U.S. Army Research Laboratory</shortaffil> - <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> - <address> - Aberdeen Proving Ground - <state>MD</state> - <postcode>21005-5068</postcode> - </address> - </affiliation> - </author> - <author> - <firstname>Eric</firstname> - <surname>Edwards</surname> - <othername role='mi'>W</othername> - <affiliation> - <shortaffil>SURVICE Engineering Company</shortaffil> - <address> - <street>4695 Millennium Drive</street> - <city>Belcamp</city> - <state>MD</state> - <postcode>21017-1505</postcode> - </address> - </affiliation> - </author> - </authorgroup> - </articleinfo> - - <abstract> - <para> - BRL-CAD software uses its own binary file format to store the geometric information and - other properties required to define CAD models. BRL-CAD used its version 4 (v4) binary - ".g" database format for over 10 years, but a variety of long standing issues with - that format prompted the development of version 5. Issues addressed by the new format - include a machine-independent format, expanding the upper limit of numbers to double - precision floating point, and lifting a 16 character size limit on object names. - </para> - </abstract> - - <section> - <title>Background and Terminology</title> - <para> - BRL-CAD is a constructive solid geometry (CSG) modeling system. Primitive solid shapes - are combined using boolean operations to form regions of homogeneous material. - </para> - <para> - The database is organized as a <emphasis>directed acyclic graph</emphasis> (DAG), which - comprises - - <itemizedlist> - <listitem> - <para>primitive <emphasis>solids</emphasis> - the minimal elements of the DAG.</para> - </listitem> - <listitem> - <para> - <emphasis>combinations</emphasis> - the nonminimal elements of the DAG, - some of which are specially marked as regions. The maximal - elements of the DAG are called tops. - </para> - </listitem> - <listitem> - <para><emphasis>arcs</emphasis> - contain boolean operators and 4x4 homogeneous transformation matrices.</para> - </listitem> - </itemizedlist> - </para> - <para> - In a slight abuse of terminology, the DAG is often spoken of as a tree or collection - of trees. In this context, the solids are also called <emphasis>leaves</emphasis>. - </para> - <section> - <title>Format of Data Elements/Database External Format</title> - <para> - The external format has several important properties, especially with regard - to the <emphasis>Object_Body</emphasis>: - <itemizedlist> - <listitem> - <para> - Numbers are stored in binary for storage efficiency, for speed of reading - and writing, and for preventing errors from creeping in due to repetitive - conversion between binary and an ASCII string representation. This eliminates - the need to use the old g2asc and asc2g to move databases between machines of - different architectures. - </para> - </listitem> - <listitem> - <para> - All data in the object wrapper are stored in a machine-independent format, - as follows: - <itemizedlist mark='opencircle'> - <listitem> - <para> - All floating point numbers are stored as IEEE double-precision, in - big-endian order, where byte 0 is on the left end of the word. - </para> - </listitem> - <listitem> - <para> - All integers are stored as either <emphasis>unsigned</emphasis> or - <emphasis>twos-complement signed</emphasis> binary numbers in either - 8, 16, 32, or 64 bits, in big-endian order. - </para> - </listitem> - <listitem> - <para> - All character strings are stored in the ASCII 8-bit character set. - A string is stored as an integer followed by an array of 8-bit - characters. The last character in the array is always a null byte. - The integer indicates the number of bytes in the array including the - terminating null. - </para> - </listitem> - </itemizedlist> - </para> - </listitem> - </itemizedlist> - </para> - </section> - </section> - - <section> - <title>Definition of a Single, Generic Database Object</title> - <para> - The database access library stores <emphasis>objects</emphasis> as a collection - of data with a globally unique name and places no interpretation on the content - of those data. The <emphasis>object</emphasis> is the smallest granularity of - an item in the database; objects must be read from and written to the database - in a single atomic operation. - </para> - <para> - In the case of librt, each database object will contain exactly one combination - node or leaf (solid) node. - </para> - <section> - <title>Object Structure</title> - <para> - All objects share certain common properties, which are stored in a standardized - <emphasis>object wrapper</emphasis> consisting of an Object Header and an Object Footer. - </para> - <para> - The Object Header consists of: - <itemizedlist> - <listitem> - <para> - An 8-bit Magic1 element that holds a specific magic number value used for - database integrity checking. - </para> - </listitem> - <listitem> - <para> - A 16-bit Flags element consisting of three 8-bit fields: HFlags, AFlags, - and BFlags, described later. - </para> - </listitem> - <listitem> - <para> - A 16-bit Object_Type element organized into two 8-bit-wide fields: the - Major_Type and the Minor_Type. - </para> - </listitem> - <listitem> - <para> - An Object_Length element that indicates the total number of bytes required - for this object, including the magic numbers. - </para> - </listitem> - <listitem> - <para> - An Object_Name element that is a string holding a name unique to that object - and drawn from a name space that is global to the database. Like other strings, - it consists of two fields, Length and Data. In the case of the Object_Name - element, these are referred to as Name_Length and Name_Data, respectively. - Note: The Object_Name element is mandatory for all allocated storage in the - database. Database free-space managment objects are the only objects for which - the Object_Name element is optional. - </para> - </listitem> - </itemizedlist> - </para> - <para> - The Object Footer consists of: - <itemizedlist> - <listitem> - <para> - Any padding bytes necessary to bring the total size of the object in bytes to an - integral multiple of 8. - </para> - </listitem> - <listitem> - <para> - An 8-bit Magic2 element that holds a specific magic number value used for database - integrity checking. - </para> - </listitem> - </itemizedlist> - </para> - <para> - Objects may store application-specific information in an Object Interior. - <itemizedlist> - <listitem> - <para> - An object may optionally have an Object_Attributes element consisting of a - pair of fields: Attribute_Length and Attribute_Data. From the point of view - of the database interface specification, the names and values of these attributes - are opaque????; a standardized import/export encoding API will be provided. - </para> - </listitem> - <listitem> - <para> - An object may optionally have an Object_Body element consisting of a pair of - fields, Body_Length and Body_Data. From the point of view of the database - interface specification, the format of the data is opaque??. - </para> - </listitem> - </itemizedlist> - </para> - <para> - The on-disk version of each object consists of three distinct parts: Object Header, - Object Interior, and Object Footer. This is called the external format of the object. - </para> - <table frame='all'> - <title>On-Disk BRL-CAD Object Structure</title> - <tgroup cols='3' align='center' colsep='1' rowsep='1'> - <thead> - <row> - <entry>Part</entry> - <entry>Element</entry> - <entry>Comments</entry> - </row> - </thead> - <tbody> - <row> - <entry morerows='4' valign='middle'><para>Object Header:</para><para>(not compressible)</para></entry> - <entry>Magic1</entry> - <entry morerows='2' valign='middle'>Required</entry> - </row> - <row> - <entry>HFlags, AFlags, BFlags</entry> - </row> - <row> - <entry><para>Object_Type</para><para>(Major_Type, Minor_Type)</para></entry> - </row> - <row> - <entry>Object_Length</entry> - <entry>Required</entry> - </row> - <row> - <entry align='center'> - <para> - <informaltable frame='none'> - <tgroup cols='2' align='center'> - <tbody> - <row> - <entry>Object Name:</entry> - <entry> - <para> - <informaltable frame='all'> - <tgroup cols='1' align='center'> - <tbody> - <row><entry>Name_Length</entry></row> - <row><entry>Name_Data</entry></row> - </tbody> - </tgroup> - </informaltable> - </para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </entry> - <entry><para>Conditional on flag bit N,</para><para>Required for Application Data</para></entry> - </row> - <row> - <entry morerows='1' valign='middle'><para>Object Interior:</para><para>(individually compressible)</para></entry> - <entry align='center'> - <para> - <informaltable frame='none'> - <tgroup cols='2' align='center'> - <tbody> - <row> - <entry>Object Attributes:</entry> - <entry> - <para> - <informaltable frame='all'> - <tgroup cols='1' align='center'> - <tbody> - <row><entry>Attribute_Length</entry></row> - <row><entry>Attribute_Data</entry></row> - </tbody> - </tgroup> - </informaltable> - </para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </entry> - <entry><para>Conditional on flag bit A</para><para>(ZZZ compression)</para></entry> - </row> - <row> - <entry align='center'> - <para> - <informaltable frame='none'> - <tgroup cols='2' align='center'> - <tbody> - <row> - <entry>Object Body:</entry> - <entry> - <para> - <informaltable frame='all'> - <tgroup cols='1' align='center'> - <tbody> - <row><entry>Body_Length</entry></row> - <row><entry>Body_Data</entry></row> - </tbody> - </tgroup> - </informaltable> - </para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </entry> - <entry><para>Conditional on flag bit B</para><para>(ZZZ compression)</para></entry> - </row> - <row> - <entry morerows='1' valign='middle'><para>Object Footer:</para><para>(not compressible)</para></entry> - <entry>Padding</entry> - <entry><para>As required to maintain 8-byte</para><para>object boundaries</para></entry> - </row> - <row> - <entry>Magic2</entry> - <entry>Required</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - ????Need a description that says that an object can now have (1) EITHER an attribute OR a - body, (2) BOTH an attribute and a body, or (3) NEITHER an attribute nor a body. - </para> - <para> - The routines db_get_external() and db_put_external() are used to move objects in external - format between memory and the database disk file. The routines db_wrap_external() and - db_unwrap_external() are used to wrap and unwrap the (??? Object_Body or Object_Interior ???) - (already in external form) in a standardized database object's wrapper. - </para> - </section> - - <section> - <title>Flags</title> - <para> - The Flags element consists of three 8-bit fields: HFlags, AFlags, and BFlags. The HFlags - field is 1 byte containing flag bits that pertain to the noncompressible basic header and - the database object as a whole. The AFlags and BFlags fields are each single bytes containing - flag bits that pertain to the (potentially compressed) attributes and body, respectively, in - the object interior. - </para> - <table frame='all'> - <title>BRL-CAD Flags Structure</title> - <tgroup cols='26' align='center'> - <colspec colname='h1'/> - <colspec colname='h2'/> - <colspec colname='h3'/> - <colspec colname='h4'/> - <colspec colname='h5'/> - <colspec colname='h6'/> - <colspec colname='h7'/> - <colspec colname='h8'/> - <colspec colname='s1'/> - <colspec colname='a1'/> - <colspec colname='a2'/> - <colspec colname='a3'/> - <colspec colname='a4'/> - <colspec colname='a5'/> - <colspec colname='a6'/> - <colspec colname='a7'/> - <colspec colname='a8'/> - <colspec colname='s2'/> - <colspec colname='b1'/> - <colspec colname='b2'/> - <colspec colname='b3'/> - <colspec colname='b4'/> - <colspec colname='b5'/> - <colspec colname='b6'/> - <colspec colname='b7'/> - <colspec colname='b8'/> - <thead> - <row> - <entry namest='h1' nameend='h8' align='center'>HFlags</entry> - <entry></entry> - <entry namest='a1' nameend='a8' align='center'>AFlags</entry> - <entry></entry> - <entry namest='b1' nameend='b8' align='center'>BFlags</entry> - </row> - </thead> - <tbody> - <row> - <entry>7</entry> - <entry>6</entry> - <entry>5</entry> - <entry>4</entry> - <entry>3</entry> - <entry>2</entry> - <entry>1</entry> - <entry>0</entry> - <entry morerows='1'> </entry> - <entry>7</entry> - <entry>6</entry> - <entry>5</entry> - <entry>4</entry> - <entry>3</entry> - <entry>2</entry> - <entry>1</entry> - <entry>0</entry> - <entry morerows='1'> </entry> - <entry>7</entry> - <entry>6</entry> - <entry>5</entry> - <entry>4</entry> - <entry>3</entry> - <entry>2</entry> - <entry>1</entry> - <entry>0</entry> - </row> - <row> - <entry namest='h1' nameend='h2'>Wid</entry> - <entry>N</entry> - <entry namest='h4' nameend='h5'>Wid</entry> - <entry>r</entry> - <entry namest='h7' nameend='h8'>DLI</entry> - <entry namest='a1' nameend='a2'>Wid</entry> - <entry>P</entry> - <entry>r</entry> - <entry>r</entry> - <entry namest='a6' nameend='a8'>ZZZ</entry> - <entry namest='b1' nameend='b2'>Wid</entry> - <entry>P</entry> - <entry>r</entry> - <entry>r</entry> - <entry namest='b6' nameend='b8'>ZZZ</entry> - </row> - </tbody> - </tgroup> - </table> - - <section> - <title>Wid Flags</title> - <para> - The length of an object or subelement in the database is recorded using an - unsigned integer. These are variable-width fields based on the magnitude of the - maximum number needed. The Wid bits specify the size of the unsigned integer - employed in each instance. There are four 2-bit width (Wid) flags: Object_Wid - and Name_Wid (stored in HFlags), Attribute_Wid (stored in AFlags), and Body_Wid - (stored in BFlags). The Wid fields are interpreted in this manner: - </para> - - <table frame='all'> - <title>Wid Flag Definitions</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>Wid Bits</entry> - <entry>Width (in bits) of Associated Length Fields</entry> - </row> - </thead> - <tbody> - <row> - <entry>00</entry> - <entry>8</entry> - </row> - <row> - <entry>01</entry> - <entry>16</entry> - </row> - <row> - <entry>10</entry> - <entry>32</entry> - </row> - <row> - <entry>11</entry> - <entry>64</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The Object_Wid flag, at the high end of HFlags, encodes the width of the Object_Length - field. The Name_Wid flag, in bits 3 and 4 of HFlags, encodes the width of the Name_Length - field (when the name element is present; see the N bit, shown later.). Attribute_Wid (or - Body_Wid, as the case may be) encodes the width of the Attribute_Length field (when the - Object_Attributes (or Object_Attributes) element is present. - http://ftp.arl.mil/~mike/papers/brlcad5.0/newdb.html - bbitSee the P bit, below.)??????????. - </para> - <para> - The rationale for allowing the width of the Object_Length field to be specified independently - of the other widths is to save space on objects in which the values in many of the length - fields nearly overflow the specified field width, so that their sum requires a wider field. - For example, for four 255-byte interior fields, the corresponding length fields need be no - more than 8 bits wide, so the choice Interior_Wid=00 suffices, but their combined length of - 1020 bytes would require Object_Wid=01. Because all of the length fields besides Object_Length - must have the same width, the largest of the values stored in these length fields determines - the value of Interior_Wid required. Both Object_Wid and Interior_Wid may vary from object to - object. It is expected that the routines that write an object to the disk will use the - narrowest width possible for each object. - </para> - </section> - - <section> - <title>"r" Bits</title> - <para> - The bits labled as "r" in all three flags are reserved for future design - work assigning additional optional fields in the object. - </para> - </section> - - <section> - <title>HFlags - the DLI Flag</title> - <para> - The DLI flag is a 2-bit flag that indicates whether the object is an Application - Data Object or a Database Layer Internal Object. The bits are interpreted as follows: - </para> - <table frame='all' pgwide='1'> - <title>DLI Flag Structure</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>DLI Bits</entry> - <entry>Meaning</entry> - </row> - </thead> - <tbody> - <row> - <entry>00</entry> - <entry align='left'> - Application Data Object - <para> - The object contains application-specific data. N must be 1. A and B are - determined by what the application presents for storage in the object; both - may be 0 (empty Object_Interior). - </para> - </entry> - </row> - <row> - <entry>01</entry> - <entry align='left'> - Database Layer Internal, Header Object - <para> - A Header Object must be the first object encountered in the database. In - order to support direct concatenation of two existing databases into one new - database, additional header objects may appear elsewhere in the database The - header object has no object name, object attributes, or object body (e.g., - N=0, A=0, B=0). Major_Type=RESERVED, Minor_Type=0. - </para> - </entry> - </row> - <row> - <entry>10</entry> - <entry align='left'> - Database Layer Internal, Free Storage. - <para> - Unused space in the database is kept using a special Free DB Storage object - that has no object name or object attributes. The object body is null-filled - and of the proper size for the storage to be represented. Like all other objects, - the total length of the object will be a multiple of 8 bytes. N=0, A=0, B=1. - Major_Type=RESERVED, Minor_Type=0. - </para> - </entry> - </row> - <row> - <entry>11</entry> - <entry align='left'> - Database Layer Internal, Reserved - <para> - This value is reserved for future use. - </para> - </entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The DLI flag is not available to the higher database access layers. - </para> - <note> - <para> - Implementation note: Before writing a new object into the database in a free area, - the library should read the object header from the database and confirm that the space - is indeed free. Similarly, additions to the end should be checked by ensuring that the - file hasn't been extended. In case the check fails, the database write should fail, the - user should be notified, and the internal library mode (not the operating system file - access permissions) should be changed over to read-only access so that no further attempts - to write will be issued. These checks will provide protection against two or more users - trying to modify the same database simultaneously and accidentally stepping on each - other. In the NFS world, file locking isn't a strong enough assurance. - </para> - </note> - </section> - - <section> - <title>HFlags - the N Bit</title> - <para> - The "N" bit indicates whether the Name element (consisting of Name_Length and Object_Name - fields) is present (1) or absent (0) in the noncompressible basic header immediately following the - Object_Length field. The width of the Name_Length field is specified by the Name_Wid field. - </para> - </section> - - <section> - <title>AFlags/BFlags - the P Bit</title> - <para> - The ``P'' bit indicates whether the Attributes (or, alternatively, Body) element consisting - of Attribute_Length and Attribute_Data (or Body_Length and Body_Data) fields, is present (1) - or absent (0) in the Object_Interior. - </para> - </section> - - <section> - <title>AFlags/BFlags - the ZZZ Flag</title> - <para> - The 3-bit ``ZZZ'' flag indicates the compression, if any, of the object Attributes (or Body): - </para> - <table frame='all'> - <title>ZZZ Flag Definitions</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>ZZZ Bits</entry> - <entry>Compression Algorithm</entry> - </row> - </thead> - <tbody> - <row> - <entry>000</entry> - <entry>None</entry> - </row> - <row> - <entry>001</entry> - <entry>GNU GZIP</entry> - </row> - <row> - <entry>010</entry> - <entry>Burroughs-Wheeler</entry> - </row> - <row> - <entry>011</entry> - <entry>Reserved</entry> - </row> - <row> - <entry>100</entry> - <entry>Reserved</entry> - </row> - <row> - <entry>101</entry> - <entry>Reserved</entry> - </row> - <row> - <entry>110</entry> - <entry>Reserved</entry> - </row> - <row> - <entry>111</entry> - <entry>Reserved</entry> - </row> - </tbody> - </tgroup> - </table> - </section> - </section> - - <section> - <title>Object Type</title> - <para> - The Object_Type element is always 16 bits wide, organized into two 8-bit-wide - fields: the Major_Type and the Minor_Type. - </para> - <table frame='all'> - <title>Object_Type Element Structure</title> - <tgroup cols='16' align='center'> - <colspec colname='0'/> - <colspec colname='1'/> - <colspec colname='2'/> - <colspec colname='3'/> - <colspec colname='4'/> - <colspec colname='5'/> - <colspec colname='6'/> - <colspec colname='7'/> - <colspec colname='8'/> - <colspec colname='9'/> - <colspec colname='10'/> - <colspec colname='11'/> - <colspec colname='12'/> - <colspec colname='13'/> - <colspec colname='14'/> - <colspec colname='15'/> - <thead> - <row> - <entry namest='0' nameend='15' align='center'>Object_Type</entry> - </row> - </thead> - <tbody> - <row> - <entry namest='0' nameend='7' align='center'>Major Type</entry> - <entry namest='8' nameend='15' align='center'>Minor Type</entry> - </row> - <row> - <entry>7</entry> - <entry>6</entry> - <entry>5</entry> - <entry>4</entry> - <entry>3</entry> - <entry>2</entry> - <entry>1</entry> - <entry>0</entry> - <entry>7</entry> - <entry>6</entry> - <entry>5</entry> - <entry>4</entry> - <entry>3</entry> - <entry>2</entry> - <entry>1</entry> - <entry>0</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - Each different Major_Type value is assigned to a different class of database objects. - The following values are defined in this specification: - </para> - <table frame='all'> - <title>Major_Type Values and Meanings</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>Value</entry> - <entry>Object Class</entry> - </row> - </thead> - <tbody> - <row> - <entry>0</entry> - <entry>Reserved</entry> - </row> - <row> - <entry>1</entry> - <entry>BRL-CAD Nongeometry Objects</entry> - </row> - <row> - <entry>2</entry> - <entry>BRL-CAD Geometry Objects</entry> - </row> - <row> - <entry>3</entry> - <entry>Attribute-Only Objects</entry> - </row> - <row> - <entry>8</entry> - <entry>Experimental Binary Objects (Unrecorded Structure) (Minor Type Unspecified)</entry> - </row> - <row> - <entry>9</entry> - <entry>Uniform Array Binary Objects, (Type Described in Minor Type)</entry> - </row> - <row> - <entry>10</entry> - <entry>MIME_Typed Binary Objects (Attribute "mime_type" Describes Format)</entry> - </row> - <row> - <entry>16-31</entry> - <entry>Registered-Type Binary Objects</entry> - </row> - <row> - <entry>128</entry> - <entry>First Non-ARL Type Begins Here</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The remainder are available for extending the types of objects that may be stored in - the database, allowing BRL-CAD users to extend the database for their own particular - purposes far beyond what the "attribute" method permits. - </para> - - <section> - <title>Major_Type = 0: Reserved</title> - <para> - Major Type 0 is illegal. The rationale is to provide the library an opportunity to - detect incompletely filled in data structures. - </para> - </section> - - <section> - <title>Major_Type = 1: BRL-CAD Nongeometry Objects</title> - <para> - This class of objects is private to librt, concerning all nongeometric objects needed by - the library. For this Major_Type, the following Minor_Type values are defined: - </para> - <table frame='all'> - <title>Major_Type = 1: Minor_Type Values and Meanings</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>Minor_Type Value</entry> - <entry>Object Type</entry> - </row> - </thead> - <tbody> - <row> - <entry>0</entry> - <entry>Reserved for sanity check</entry> - </row> - <row> - <entry>1</entry> - <entry>Combination</entry> - </row> - <row> - <entry>2</entry> - <entry>Grip (Nongeometric)</entry> - </row> - <row> - <entry>3</entry> - <entry>Joint (Nongeometric)</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - All other values reserved for future expansion. - </para> - <para> - ?????Should "Grip" and "Joint" objects be of this type, or Major_Type = 2? - </para> - </section> - - <section> - <title>Major_Type = 2: BRL-CAD Geometry Objects</title> - <para> - This class of objects is private to librt, concerning all geometric objects needed - by the library. Typically, there will be one xxx/xxx.c module in librt for each minor type. - For this Major_Type, the following Minor_Type values are defined: - </para> - <table frame='all'> - <title>Major_Type = 2: Minor_Type Values and Meanings</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>Minor_Type Value</entry> - <entry>Object Type</entry> - </row> - </thead> - <tbody> - <row> - <entry>0</entry> - <entry>Reserved for sanity check</entry> - </row> - <row> - <entry>1</entry> - <entry>Torus (TOR)</entry> - </row> - <row> - <entry>2</entry> - <entry>Truncated General Cone (TGC)</entry> - </row> - <row> - <entry>3</entry> - <entry>Ellipsoid (ELL)</entry> - </row> - <row> - <entry>4</entry> - <entry>Generalized ARB. V + 7 vectors</entry> - </row> - <row> - <entry>5</entry> - <entry>ARS</entry> - </row> - <row> - <entry>6</entry> - <entry>Half-Space (HALF)</entry> - </row> - <row> - <entry>7</entry> - <entry>Right Elliptical Cylinder (REC) (TGC special case)</entry> - </row> - <row> - <entry>8</entry> - <entry>Polygonal facted object (Polysolid)</entry> - </row> - <row> - <entry>9</entry> - <entry>B-Spline Solid</entry> - </row> - <row> - <entry>10</entry> - <entry>Sphere (ELL Special Case)</entry> - </row> - <row> - <entry>11</entry> - <entry>n-Manifold Geometry (NMG) solid</entry> - </row> - <row> - <entry>12</entry> - <entry>Extruded bitmap solid</entry> - </row> - <row> - <entry>13</entry> - <entry>Volume (VOL)</entry> - </row> - <row> - <entry>14</entry> - <entry>ARB with N faces (ARBN)</entry> - </row> - <row> - <entry>15</entry> - <entry>Pipe (wire) solid (PIPE)</entry> - </row> - <row> - <entry>16</entry> - <entry>Particle system solid (PART)</entry> - </row> - <row> - <entry>17</entry> - <entry>Right Parabolic Cylinder (RPC)</entry> - </row> - <row> - <entry>18</entry> - <entry>Right Hyperbolic Cylinder (RHC)</entry> - </row> - <row> - <entry>19</entry> - <entry>Elliptical Paraboloid (EPA)</entry> - </row> - <row> - <entry>20</entry> - <entry>Elliptical Hyperboloid (EHY)</entry> - </row> - <row> - <entry>21</entry> - <entry>Elliptical Torus (ETO)</entry> - </row> - <row> - <entry>22</entry> - <entry>Grip Nongeometric</entry> - </row> - <row> - <entry>23</entry> - <entry>Joint Nongeometric</entry> - </row> - <row> - <entry>24</entry> - <entry>Height Field (HF)</entry> - </row> - <row> - <entry>25</entry> - <entry>Displacement Map (DSP)</entry> - </row> - <row> - <entry>26</entry> - <entry>2D Sketch (SKETCH)</entry> - </row> - <row> - <entry>27</entry> - <entry>Solid of extrusion (EXTRUDE)</entry> - </row> - <row> - <entry>28</entry> - <entry>Instanced submodel</entry> - </row> - <row> - <entry>29</entry> - <entry>FASTGEN4 CLINE solid</entry> - </row> - <row> - <entry>30</entry> - <entry>Bag o' triangles (BOT)</entry> - </row> - <row> - <entry>31</entry> - <entry>Combination Record</entry> - </row> - <row> - <entry>32</entry> - <entry>Experimental binary</entry> - </row> - <row> - <entry>33</entry> - <entry>Uniform-array binary</entry> - </row> - <row> - <entry>34</entry> - <entry>MIME-typed binary</entry> - </row> - <row> - <entry>35</entry> - <entry>Superquadratic ellipsoid</entry> - </row> - <row> - <entry>36</entry> - <entry>Metaball</entry> - </row> - <row> - <entry>37</entry> - <entry>Brep object</entry> - </row> - <row> - <entry>38</entry> - <entry>Hyperboloid of one sheet (HYP)</entry> - </row> - <row> - <entry>39</entry> - <entry>Constraint object</entry> - </row> - <row> - <entry>40</entry> - <entry>Solid of revolution</entry> - </row> - <row> - <entry>41</entry> - <entry>Collection of points (PNTS)</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The details of these Minor_Types are provided in Section IV. - </para> - </section> - - <section> - <title>Major_Type = 3: Attribute-Only Objects</title> - <para> - This type of object stores only attributes in the object interior section; it has no - object body elements. - </para> - <para> - For example, if several objects need to have the same shader parameters, it would be - possible to create one attribute-only object to hold these common attributes and serve as a - simple form of "macro". Objects that needed to share these attributes could all reference the - same attribute object. If the attribute object is altered, then all of the objects that - reference it would be updated together. Without this capability, the user would have to - update each element individually to alter the attributes. - </para> - <para> - Conventions will have to be established regarding which attributes of an attribute-only - object will be used when a macro reference is performed. For example, rt shaders will - only be interested in the value of the "oshader=" attribute, while librt's tree-walker - might also be interested in the "rgb=", "giftmater=", "nsn=", "material=", and "los=" - attributes (assuming that a convention was developed so that a combination could - macro-reference an attribute-only object too). - </para> - <para> - An attribute-only object may not have an object body; thus, flag bit B must always be - zero for this type of object. - </para> - <para> - As used by the rt family of applications codes, these attribute-only objects will - contain "macros" for shaders. The shader name and its parameters shall be encoded as a - single ASCII string, which is the value of the "oshader=" attribute. An rt shader named - "macro" (or equivalent) would take a single parameter "obj=", which would specify the - name of the attribute-only object in the database from which the actual shader and - shader parameter information would be extracted. - </para> - <para> - There will be one attribute-only object with a reserved object name of "_GLOBAL" that - will be used to contain various kinds of states that are global to the entire ".g" database - and that had previously been found in the database header itself. There will be the - following BRL-CAD-specific attributes whose meaning is predefined for the _GLOBAL object: - <itemizedlist> - <listitem> - <para> - title = The database "title" string previously found in the database header. - </para> - </listitem> - <listitem> - <para> - units = The most recent editing units, specified as an ASCII string with a - floating point conversion factor. For example, the conversion factor for inches - to millimeters would be 25.4. - </para> - </listitem> - <listitem> - <para> - regionid_colortable = A string that contains a collection of all the information - previously found in "struct material_rec ID_MATERIAL" records. Exact encoding yet - to be determined; it's a collection of integer 5-tuples of the form: - {low, high, r, g, b}. - </para> - </listitem> - </itemizedlist> - </para> - <para> - In addition, the "comment=" attribute of the "_GLOBAL" object may be used to store - human-readable remarks about the database that are not more properly associated with a - specific database item. These might include remarks about data sources, model evolution, - security classification, and release restrictions. In the absense of some outboard - revision-control system, this might also be a place to record modification history, - although such use is discouraged. - </para> - </section> - - <section> - <title>Bulk Binary Objects (Major_Types 8-31)</title> - <para> - This class of objects contains various "bulk" binary data that might otherwise have - been placed in auxiliary files. - </para> - <para> - MGED and standalone commands must be built to store/extract these opaque?? binary - objects between a ".g" file and stdin/stdout/auxiliary files. A user might want to use - those same MGED commands to store/extract the binary object body of any object for external - processing. An easy example to imagine is the importing and exporting of texture maps for - external processing, but the same commands could be used for importing and exporting - solid parameters in their external binary form. - </para> - <para> - These objects may be referenced in combination nodes, for organizational purposes, but - they cannot be drawn in MGED or raytraced, and doing so would result in a warning message - being printed by the tree walker as that arc is traversed. This class may be used by all - applications and layers. - </para> - <para> - The data's purpose may be placed in the "purpose=" attribute. (????????Need a - table/registry of presently known values for this attribute.) - </para> - <para> - Routines that retrieve bulk binary objects should check the minor type and the - "purpose=" attribute and send a warning message in the event of a mismatch, but - best-effort processing of the object should continue. This will permit some degree - of error checking, which should benefit novice users without standing in the way of - "creatively" reusing one set of data, (e.g., using one array of values as both a height - field and a bwtexture). This allows common data perversion practices, such as interpreting - an array of floats as an array of bytes, to continue. - </para> - <para> - Each application will need to have its own syntax for the user to specify whether the data - source is an outboard file or a raw-binary object. For example, the current RT sh_texture - module uses the keyword file="name" to indicate an outboard file; that might be supplemented - with an additional obj="name" possibility for retrieving from an inboard raw-binary object. - </para> - - <section> - <title>Major_Type = 8: Experimental Binary Objects</title> - <para> - This class of objects contains bulk binary data and is intended for experimental - use by applications developers. Each time a database containing objects of this type - is opened, BRL-CAD will issue a user-visible warning. Production software and databases - should not use these objects. Developers should obtain registered 16-bit object types - from the website in order to avoid collisions with other applications. - </para> - </section> - <section> - <title>Major_Type = 9: Uniform Array Binary Objects</title> - <para> - This class of objects contain various "bulk" binary data that might otherwise have - been placed in an auxiliary file. - </para> - <para> - Point of Discussion?????Has ramifications... we have to implement type advising, so - that applications that use these data can compare the type provided in the minor - type code with the type that they're expecting and advise the user (with a warning - message) that there is a potential type mismatch. - </para> - <table frame='all'> - <title>Uniform Array Binary Objects Minor_Type Structure</title> - <tgroup cols='8' align='center'> - <colspec colname='h1'/> - <colspec colname='h2'/> - <colspec colname='h3'/> - <colspec colname='h4'/> - <colspec colname='h5'/> - <colspec colname='h6'/> - <colspec colname='h7'/> - <colspec colname='h8'/> - <thead> - <row> - <entry namest='h1' nameend='h8' align='center'>Minor_Type</entry> - </row> - </thead> - <tbody> - <row> - <entry>7</entry> - <entry>6</entry> - <entry>5</entry> - <entry>4</entry> - <entry>3</entry> - <entry>2</entry> - <entry>1</entry> - <entry>0</entry> - </row> - <row> - <entry>r</entry> - <entry>r</entry> - <entry namest='h3' nameend='h4'>Wid</entry> - <entry>S</entry> - <entry namest='h6' nameend='h8'>Atom</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The 3-bit ``Atom'' flag indicates the fundamental data type of the atomic elements - in the array according to the following scheme: - </para> - <table frame='all'> - <title>Atom Flag Definitions</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>Atom Bits</entry> - <entry>Data Type</entry> - </row> - </thead> - <tbody> - <row> - <entry>000</entry> - <entry>Reserved for sanity check</entry> - </row> - <row> - <entry>001</entry> - <entry>Reserved</entry> - </row> - <row> - <entry>010</entry> - <entry>float (IEEE, network order)</entry> - </row> - <row> - <entry>011</entry> - <entry>double (IEEE, network order)</entry> - </row> - <row> - <entry>100</entry> - <entry>8-bit int</entry> - </row> - <row> - <entry>101</entry> - <entry>16-bit int</entry> - </row> - <row> - <entry>110</entry> - <entry>32-bit int</entry> - </row> - <row> - <entry>111</entry> - <entry>64-bit int</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The ``S'' bit indicates whether an integer type is signed (1) or unsigned (0). - Floats and doubles (i.e., atomic types with the highest atom bit equal to 0) are - explicitly signed, so they will have the ``S'' bit equal to 1. (The bit patterns - corresponding to unsigned floats and doubles are reserved for possible other use.) - </para> - <para> - The 2-bit ``Wid'' flag specifies the length (in atomic elements) of the array elements: - </para> - <table frame='all'> - <title>Wid Flag Definitions</title> - <tgroup cols='2' align='center'> - <thead> - <row> - <entry>Wid Bits</entry> - <entry>Atoms per Array Element</entry> - </row> - </thead> - <tbody> - <row> - <entry>00</entry> - <entry>1</entry> - </row> - <row> - <entry>01</entry> - <entry>2</entry> - </row> - <row> - <entry>10</entry> - <entry>3</entry> - </row> - <row> - <entry>11</entry> - <entry>4</entry> - </row> - </tbody> - </tgroup> - </table> - <para> - The remaining Minor_Type bits ``r'' are reserved for the design committee to use for - other purposes, possibly including extensions of the ``Atom'' and/or ``Wid'' flags. - </para> - <para> - As examples, data in PIX(5) format, which might be used for a texture map, would - have Minor_Type ``0010 0100'', indicating a triple of unsigned char, and CMYK data - might be stored with Minor_Type ``0011 1011'', indicating a quadruple of doubles. - </para> - <para> - The data's purpose (e.g., height field, texture, bump, displacement, etc.) may be - placed in the "purpose=" attribute. ?????Point of Discussion???(Need a table/registry - of presently known values for this attribute.) - </para> - </section> - <section> - <title>Major_Type = 10: MIME-Typed Binary Objects</title> - <para> - This class of objects contains data, the format of which is specified in the - attribute "mime_type". The Minor_Type of these objects should always be zero. - </para> - </section> - <section> - <title>Major_Type = 16-31: Registered-Type Binary Objects</title> - <para> - This class of objects contains application-specific bulk binary data and is intended - for use in production software and databases. Developers can obtain registered 16-bit - object types from the website to identify these objects. The data's purpose, (e.g. height - field, texture, bump, displacement, etc.) may be placed in the "purpose=" attribute. - (Need a table/registry of presently known values for this attribute). - </para> - </section> - </section> - - <section> - <title>Major_Type = 255: Database Layer Internal Objects</title> - <para> - A Minor_Type of 1 indicates that this is a contiguous block of free storage. - </para> - <para> - A Minor_Type of 2 indicates that this is a database header. - </para> - </section> - - </section> - - <section> - <title>Object Length</title> - <para> - The Object Length specifies the number of 8-byte chunks used to store an object. This includes all bytes - from Magic1 through Magic2, inclusive. - </para> - </section> - - <section> - <title>Object Name</title> - <para> - The Object_Name element is a string that holds a name unique to that object and drawn from a name space that - is global to the database. The Object_Name element is mandatory for all allocated storage in the database. - Database free-space managment objects are the only objects for which the Object_Name element is optional. - </para> - <para> - The name is specified in 8-bit ASCII. There is no support for UNICODE. The name is null-terminated, and the - null byte is included in Name_Length. - </para> - <para> - See the section on DLI flags. In the case of Free objects, the name is not retained. Undeleted objects have - a different DLI flag code. - </para> - </section> - - <section> - <title>Object Attributes</title> - <para> - An object may optionally have an Object_Attributes element, which stores an association list - <literallayout> -aname1=value1, aname2=value2, ..., anameN=valueN - </literallayout> - binding attributes to values. - </para> - <para> - These are ASCII strings of unlimited length. These attributes are intended for direct use by programs. - There will be a WWW registry of attribute names presently in use to prevent two application developers - from using the same attribute_name for different purposes. - </para> - <para> - For attribute names and attribute values, The decision was taken to support 8-bit ASCII only. The - on-disk encoding of this will simply be: - <literallayout> -aname1 NULL value1 NULL ... anameN NULL valueN NULL NULL - </literallayout> - where NULL represents a byte with all bits zero. The NULL in place of anameN+1 signals the end of the - attribute data, simplifying the job of the reader. - </para> - <para> - Every object in the database may have zero or more attributes attached to it; the meaning of these attributes - will vary depending on which application or library processes them. - </para> - <para> - There are several aname conventions that all BRL-CAD applications are expected to respect. There will be a - WWW extendable registry of "in-use" anames, so that independent applications developers may select aname - strings for their own use without fear of name conflicts later. The initial registry would include: - <itemizedlist> - <listitem> - <para> - comment = Every object may optionally have a comment that contains a string of an arbitrary number of - newline-terminated lines of text. These are strings for use by humans only. None of the BRL-CAD software - may parse or interpret these strings other than to print them and edit them when requested by the user. - They are provided for the modeler to place notes in. - </para> - </listitem> - <listitem> - <para> - nsn = The American National Stock Number (NSN) for this part, when known. - </para> - </listitem> - <listitem> - <para> - material = The format of this string is not currently defined as there are conflicting naming/coding - conventions employed by the various standards organizations (e.g., ISO, ASME, etc.). - </para> - </listitem> - <listitem> - <para> - region = For combinations, indicates this combination is a region. Boolean. - </para> - </listitem> - <listitem> - <para> - inherit = For combinations, indicates whether attributes from lower combinations in tree will replace - higher ones. Boolean, default=0. - </para> - </listitem> - <listitem> - <para> - oshader = For combinations, read by the "rt" program, optical shader name and parameter string (separated - from each other by white space). Meaningful only at or above a region node, and only on a combination, or - in an attribute-only "macro". - </para> - </listitem> - <listitem> - <para> - rgb = For combinations, when present indicates optical rgb color is specified. - </para> - </listitem> - <listitem> - <para> - region_id = For regions, GIFT compatability. Integer. - </para> - </listitem> - <listitem> - <para> - giftmater = For regions, GIFT compatability. Integer. (Point of Discussion?????Should we use negative values for - air codes, positive for nonair, so we can eliminate air codes?) - </para> - </listitem> - <listitem> - <para> - aircode = For regions, air code. Integer. 0 is the same as attribute not specified. (Point of - Discussion?????Possibly eliminated in favor of negative giftmater values). - </para> - </listitem> - <listitem> - <para> - los = For regions, GIFT compatability. Integer. - </para> - </listitem> - <listitem> - <para> - component = For regions, the name of the MUVES component containing this object. - </para> - </listitem> - <listitem> - <para> - rlist = The proposed BRL-CAD "replacement list" field would be stored on a binary-block attribute - ("rlist="). [deferred implementation] - </para> - </listitem> - <listitem> - <para> - macro = If present, specifies name of an attribute-only object to be consulted for additional attribute values. - </para> - </listitem> - </itemizedlist> - - All other attributes, from whatever source, would be stored similarly, including application-specific and - end-user-created attributes. - </para> - </section> - <section> - <title>Object Body</title> - <para> - The contents of the Object Body are opaque?? to the databaase layer. The contents of this element are interpreted - based upon the Object_Type. The Object_Body is not constrained to start on a chunk boundary. - </para> - </section> - - <section> - <title>Padding and Length Rounding</title> - <para> - The minimal object is a Free object (with no name) 8 bytes long: - <literallayout> - Magic1 (1byte) - HFlags = 000xxxxx (1 byte) - AFlags = 0000xx00 (1 byte) - BFlags = 0000xx00 (1 byte) - ObjType = Free (2 bytes) - ObjLen = 7 (1 byte) - Magic2 (1 byte). - </literallayout> - This is why we have chosen the 8-bit size for our chunks. Pad bytes are inserted as necessary in the Object Footer - immediately before the second magic number so that the final byte of the object is the Magic2 byte. The pad bytes are - not counted as part of the Body_Length, but are counted as part of the Object_Length. - </para> - <para> - The minimal valid object is thus the following Free object: - <literallayout> -Magic1 (1byte) -HFlags = 00000010 (1 byte), Wid=00, N=0, DLI=02 -IFlags????? = 00000000 (1 byte), Wid=00, A=0, B=0, ZZZ=000 -Object_Type = RESERVED (2 bytes) -Object_Length = 1 (1 byte) -Pad (1byte) -Magic2 (1 byte). - </literallayout> - </para> - <para> - The header of the database will always look like this: - <literallayout> -Magic1 (1byte) -HFlags = 000xxx01 (1 byte), Wid=00, N=0, DLI=01 -IFlags????? = 0000x000 (1 byte), Wid=00, A=0, B=0, ZZZ=000 -Object_Type = RESERVED (2 bytes) -Object_Length = 1 (1 byte) -Pad (1byte) -Magic2 (1 byte) -The hex and ASCII dump of this object would look something this: - -76 01 00 00 00 01 00 35 |v......5| - </literallayout> - </para> - <para> - The minimal valid allocated database storage object (with an Object_Name, no Object_Attributes or Object_Body) would thus be: - <literallayout> -Magic1 (1byte) -HFlags = 001xxxxx (1 byte), Wid=00, N=1, DLI=00 -IFlags ?????= 0000xxxx (1 byte), Wid=00, A=0, B=0, ZZZ=000 -Object_Type = OPAQUE?????_BINARY (2 bytes) -Object_Length = 8 (1 byte) -Name_Length = 2 (1 byte) -Object Name (1 character + null byte) (2 bytes) -Pad (6 bytes) -Magic2 (1 byte). - </literallayout> - </para> - <para> - Without the padding, this (rather useless) object would be 10 bytes long. Given the rounding requirements, it is clear that all allocated storage objects in the database must be at least 16 bytes long. A database object with a minimal Object_Body would need 12 bytes, which would need to be padded out to 16 bytes as well: - <literallayout> -Magic1 (1 byte) -HFlags = 001xxxxx (1 byte) -IFlags???? = 00x1xxxx (1 byte) -Object Type (2 bytes) -Object Length = 16 (1 byte) -Name Length = 2 (1 byte) -Object Name (1 character + null byte) (2 bytes) -Body Length = 1 (1 byte) -Body Data (1 byte) -Pad (4 bytes) -Magic2 (1 byte). - </literallayout> - - </para> - <para> - <literallayout> - </literallayout> - </para> - <para> - <literallayout> - </literallayout> - </para> - <para> - <literallayout> - </literallayout> - </para> - - </section> - - - - - <itemizedlist> - <listitem> - <para> - </para> - </listitem> - <listitem> - <para> - </para> - </listitem> - </itemizedlist> - - - - - <section> - <title>How Objects Are Grouped into a Database</title> - <para> - - </para> - </section> - <section> - <title>Details of BRL-CAD-Specific Nongeometric Database Object Types</title> - <para> - - </para> - </section> - <section> - <title>Details of BRL-CAD-Specific Geometric Database Object Types</title> - <para> - - </para> - </section> - <section> - <title>Extensions for Deferred Implementation</title> - <para> - - </para> - </section> - <section> - <title>Community Feedback on the Proposal</title> - <para> - - </para> - </section> - <section> - <title>Database Library Application Programming Interface (API)</title> - <para> - - </para> - </section> - - </article> Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-10-21 19:20:09 UTC (rev 36237) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-10-21 20:38:19 UTC (rev 36238) @@ -367,9 +367,41 @@ +systemDOCBOOK_EN = \ + system/en/BRL-CAD_db_format.xml +systemDOCBOOK_EN_IMAGES = +systemDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/system/en +systemDOCBOOK_ENhtml_DATA = \ + $(BUILTSYSTEMS_ENHTML) +BUILTSYSTEMS_ENHTML = \ + ${systemDOCBOOK_EN:xml=html} + +systemDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/system/en/images +systemDOCBOOK_ENhtmlimages_DATA = \ + $(BUILTSYSTEMS_ENIMAGES) + +BUILTSYSTEMS_ENIMAGES = \ + ${systemDOCBOOK_EN_IMAGES:docpng=png} + + +if BUILD_PDF_DOCS + +BUILTSYSTEMS_ENPDF = ${systemDOCBOOK_EN:xml=pdf} + +endif + +systemDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/system/en +systemDOCBOOK_ENpdf_DATA = $(BUILTSYSTEMS_ENPDF) + + + + + + + man1DOCBOOK_EN = \ system/man1/en/3ptarb.xml \ system/man1/en/B.xml \ @@ -482,6 +514,9 @@ $(BUILTBOOKS_ENIMAGES) \ $(BUILTBOOKS_ENHTML) \ $(BUILTBOOKS_ENPDF) \ + $(BUILTSYSTEMS_ENIMAGES) \ + $(BUILTSYSTEMS_ENHTML) \ + $(BUILTSYSTEMS_ENPDF) \ $(BUILTMAN_ENHTML) \ $(BUILTMAN_ENPDF) @@ -508,7 +543,6 @@ ${man1INTRO_EN} \ README \ books/README \ - BRL-CAD_db_format.xml \ catalog.xml \ resources \ system/man1/mged_cmd_template.xml \ Added: brlcad/trunk/doc/docbook/system/en/BRL-CAD_db_format.xml =================================================================== --- brlcad/trunk/doc/docbook/system/en/BRL-CAD_db_format.xml (rev 0) +++ brlcad/trunk/doc/docbook/system/en/BRL-CAD_db_format.xml 2009-10-21 2... [truncated message content] |
From: <sta...@us...> - 2009-10-21 20:56:54
|
Revision: 36239 http://brlcad.svn.sourceforge.net/brlcad/?rev=36239&view=rev Author: starseeker Date: 2009-10-21 20:56:42 +0000 (Wed, 21 Oct 2009) Log Message: ----------- Move spec from system to specs dir. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/spec/ brlcad/trunk/doc/docbook/spec/en/ brlcad/trunk/doc/docbook/spec/en/BRL_CAD_g_format_V5.xml brlcad/trunk/doc/docbook/spec/en/images/ Removed Paths: ------------- brlcad/trunk/doc/docbook/system/en/ Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-10-21 20:38:19 UTC (rev 36238) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-10-21 20:56:42 UTC (rev 36239) @@ -367,34 +367,34 @@ -systemDOCBOOK_EN = \ - system/en/BRL-CAD_db_format.xml +specDOCBOOK_EN = \ + spec/en/BRL_CAD_g_format_V5.xml -systemDOCBOOK_EN_IMAGES = +specDOCBOOK_EN_IMAGES = -systemDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/system/en -systemDOCBOOK_ENhtml_DATA = \ - $(BUILTSYSTEMS_ENHTML) +specDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/spec/en +specDOCBOOK_ENhtml_DATA = \ + $(BUILTSPECS_ENHTML) -BUILTSYSTEMS_ENHTML = \ - ${systemDOCBOOK_EN:xml=html} +BUILTSPECS_ENHTML = \ + ${specDOCBOOK_EN:xml=html} -systemDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/system/en/images -systemDOCBOOK_ENhtmlimages_DATA = \ - $(BUILTSYSTEMS_ENIMAGES) +specDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/spec/en/images +specDOCBOOK_ENhtmlimages_DATA = \ + $(BUILTSPECS_ENIMAGES) -BUILTSYSTEMS_ENIMAGES = \ - ${systemDOCBOOK_EN_IMAGES:docpng=png} +BUILTSPECS_ENIMAGES = \ + ${specDOCBOOK_EN_IMAGES:docpng=png} if BUILD_PDF_DOCS -BUILTSYSTEMS_ENPDF = ${systemDOCBOOK_EN:xml=pdf} +BUILTSPECS_ENPDF = ${specDOCBOOK_EN:xml=pdf} endif -systemDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/system/en -systemDOCBOOK_ENpdf_DATA = $(BUILTSYSTEMS_ENPDF) +specDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/spec/en +specDOCBOOK_ENpdf_DATA = $(BUILTSPECS_ENPDF) @@ -514,9 +514,9 @@ $(BUILTBOOKS_ENIMAGES) \ $(BUILTBOOKS_ENHTML) \ $(BUILTBOOKS_ENPDF) \ - $(BUILTSYSTEMS_ENIMAGES) \ - $(BUILTSYSTEMS_ENHTML) \ - $(BUILTSYSTEMS_ENPDF) \ + $(BUILTSPECS_ENIMAGES) \ + $(BUILTSPECS_ENHTML) \ + $(BUILTSPECS_ENPDF) \ $(BUILTMAN_ENHTML) \ $(BUILTMAN_ENPDF) Added: brlcad/trunk/doc/docbook/spec/en/BRL_CAD_g_format_V5.xml =================================================================== --- brlcad/trunk/doc/docbook/spec/en/BRL_CAD_g_format_V5.xml (rev 0) +++ brlcad/trunk/doc/docbook/spec/en/BRL_CAD_g_format_V5.xml 2009-10-21 20:56:42 UTC (rev 36239) @@ -0,0 +1,1713 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"/usr/share/sgml/docbook/xml-dtd-4.5/docbookx.dtd"> +<article class='specification'> + <articleinfo> + <title>BRL-CAD Database Format</title> + <subtitle>Version 5 (DRAFT)</subtitle> + <authorgroup> + <author> + <firstname>Lee</firstname> + <surname>Butler</surname> + <othername role='mi'>A</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Michael</firstname> + <surname>Muuss</surname> + <othername role='mi'>John</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Paul</firstname> + <surname>Tanenbaum</surname> + <othername role='mi'>J</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>John</firstname> + <surname>Anderson</surname> + <othername role='mi'>R</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Robert</firstname> + <surname>Parker</surname> + <othername role='mi'>G</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Ronald</firstname> + <surname>Bowers</surname> + <othername role='mi'>A</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Christopher</firstname> + <surname>Johnson</surname> + <othername role='mi'>T</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Eric</firstname> + <surname>Edwards</surname> + <othername role='mi'>W</othername> + <affiliation> + <shortaffil>SURVICE Engineering Company</shortaffil> + <address> + <street>4695 Millennium Drive</street> + <city>Belcamp</city> + <state>MD</state> + <postcode>21017-1505</postcode> + </address> + </affiliation> + </author> + </authorgroup> + </articleinfo> + + <abstract> + <para> + BRL-CAD software uses its own binary file format to store the geometric information and + other properties required to define CAD models. BRL-CAD used its version 4 (v4) binary + ".g" database format for over 10 years, but a variety of long standing issues with + that format prompted the development of version 5. Issues addressed by the new format + include a machine-independent format, expanding the upper limit of numbers to double + precision floating point, and lifting a 16 character size limit on object names. + </para> + </abstract> + + <section> + <title>Background and Terminology</title> + <para> + BRL-CAD is a constructive solid geometry (CSG) modeling system. Primitive solid shapes + are combined using boolean operations to form regions of homogeneous material. + </para> + <para> + The database is organized as a <emphasis>directed acyclic graph</emphasis> (DAG), which + comprises + + <itemizedlist> + <listitem> + <para>primitive <emphasis>solids</emphasis> - the minimal elements of the DAG.</para> + </listitem> + <listitem> + <para> + <emphasis>combinations</emphasis> - the nonminimal elements of the DAG, + some of which are specially marked as regions. The maximal + elements of the DAG are called tops. + </para> + </listitem> + <listitem> + <para><emphasis>arcs</emphasis> - contain boolean operators and 4x4 homogeneous transformation matrices.</para> + </listitem> + </itemizedlist> + </para> + <para> + In a slight abuse of terminology, the DAG is often spoken of as a tree or collection + of trees. In this context, the solids are also called <emphasis>leaves</emphasis>. + </para> + <section> + <title>Format of Data Elements/Database External Format</title> + <para> + The external format has several important properties, especially with regard + to the <emphasis>Object_Body</emphasis>: + <itemizedlist> + <listitem> + <para> + Numbers are stored in binary for storage efficiency, for speed of reading + and writing, and for preventing errors from creeping in due to repetitive + conversion between binary and an ASCII string representation. This eliminates + the need to use the old g2asc and asc2g to move databases between machines of + different architectures. + </para> + </listitem> + <listitem> + <para> + All data in the object wrapper are stored in a machine-independent format, + as follows: + <itemizedlist mark='opencircle'> + <listitem> + <para> + All floating point numbers are stored as IEEE double-precision, in + big-endian order, where byte 0 is on the left end of the word. + </para> + </listitem> + <listitem> + <para> + All integers are stored as either <emphasis>unsigned</emphasis> or + <emphasis>twos-complement signed</emphasis> binary numbers in either + 8, 16, 32, or 64 bits, in big-endian order. + </para> + </listitem> + <listitem> + <para> + All character strings are stored in the ASCII 8-bit character set. + A string is stored as an integer followed by an array of 8-bit + characters. The last character in the array is always a null byte. + The integer indicates the number of bytes in the array including the + terminating null. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </itemizedlist> + </para> + </section> + </section> + + <section> + <title>Definition of a Single, Generic Database Object</title> + <para> + The database access library stores <emphasis>objects</emphasis> as a collection + of data with a globally unique name and places no interpretation on the content + of those data. The <emphasis>object</emphasis> is the smallest granularity of + an item in the database; objects must be read from and written to the database + in a single atomic operation. + </para> + <para> + In the case of librt, each database object will contain exactly one combination + node or leaf (solid) node. + </para> + <section> + <title>Object Structure</title> + <para> + All objects share certain common properties, which are stored in a standardized + <emphasis>object wrapper</emphasis> consisting of an Object Header and an Object Footer. + </para> + <para> + The Object Header consists of: + <itemizedlist> + <listitem> + <para> + An 8-bit Magic1 element that holds a specific magic number value used for + database integrity checking. + </para> + </listitem> + <listitem> + <para> + A 16-bit Flags element consisting of three 8-bit fields: HFlags, AFlags, + and BFlags, described later. + </para> + </listitem> + <listitem> + <para> + A 16-bit Object_Type element organized into two 8-bit-wide fields: the + Major_Type and the Minor_Type. + </para> + </listitem> + <listitem> + <para> + An Object_Length element that indicates the total number of bytes required + for this object, including the magic numbers. + </para> + </listitem> + <listitem> + <para> + An Object_Name element that is a string holding a name unique to that object + and drawn from a name space that is global to the database. Like other strings, + it consists of two fields, Length and Data. In the case of the Object_Name + element, these are referred to as Name_Length and Name_Data, respectively. + Note: The Object_Name element is mandatory for all allocated storage in the + database. Database free-space managment objects are the only objects for which + the Object_Name element is optional. + </para> + </listitem> + </itemizedlist> + </para> + <para> + The Object Footer consists of: + <itemizedlist> + <listitem> + <para> + Any padding bytes necessary to bring the total size of the object in bytes to an + integral multiple of 8. + </para> + </listitem> + <listitem> + <para> + An 8-bit Magic2 element that holds a specific magic number value used for database + integrity checking. + </para> + </listitem> + </itemizedlist> + </para> + <para> + Objects may store application-specific information in an Object Interior. + <itemizedlist> + <listitem> + <para> + An object may optionally have an Object_Attributes element consisting of a + pair of fields: Attribute_Length and Attribute_Data. From the point of view + of the database interface specification, the names and values of these attributes + are opaque????; a standardized import/export encoding API will be provided. + </para> + </listitem> + <listitem> + <para> + An object may optionally have an Object_Body element consisting of a pair of + fields, Body_Length and Body_Data. From the point of view of the database + interface specification, the format of the data is opaque??. + </para> + </listitem> + </itemizedlist> + </para> + <para> + The on-disk version of each object consists of three distinct parts: Object Header, + Object Interior, and Object Footer. This is called the external format of the object. + </para> + <table frame='all'> + <title>On-Disk BRL-CAD Object Structure</title> + <tgroup cols='3' align='center' colsep='1' rowsep='1'> + <thead> + <row> + <entry>Part</entry> + <entry>Element</entry> + <entry>Comments</entry> + </row> + </thead> + <tbody> + <row> + <entry morerows='4' valign='middle'><para>Object Header:</para><para>(not compressible)</para></entry> + <entry>Magic1</entry> + <entry morerows='2' valign='middle'>Required</entry> + </row> + <row> + <entry>HFlags, AFlags, BFlags</entry> + </row> + <row> + <entry><para>Object_Type</para><para>(Major_Type, Minor_Type)</para></entry> + </row> + <row> + <entry>Object_Length</entry> + <entry>Required</entry> + </row> + <row> + <entry align='center'> + <para> + <informaltable frame='none'> + <tgroup cols='2' align='center'> + <tbody> + <row> + <entry>Object Name:</entry> + <entry> + <para> + <informaltable frame='all'> + <tgroup cols='1' align='center'> + <tbody> + <row><entry>Name_Length</entry></row> + <row><entry>Name_Data</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + <entry><para>Conditional on flag bit N,</para><para>Required for Application Data</para></entry> + </row> + <row> + <entry morerows='1' valign='middle'><para>Object Interior:</para><para>(individually compressible)</para></entry> + <entry align='center'> + <para> + <informaltable frame='none'> + <tgroup cols='2' align='center'> + <tbody> + <row> + <entry>Object Attributes:</entry> + <entry> + <para> + <informaltable frame='all'> + <tgroup cols='1' align='center'> + <tbody> + <row><entry>Attribute_Length</entry></row> + <row><entry>Attribute_Data</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + <entry><para>Conditional on flag bit A</para><para>(ZZZ compression)</para></entry> + </row> + <row> + <entry align='center'> + <para> + <informaltable frame='none'> + <tgroup cols='2' align='center'> + <tbody> + <row> + <entry>Object Body:</entry> + <entry> + <para> + <informaltable frame='all'> + <tgroup cols='1' align='center'> + <tbody> + <row><entry>Body_Length</entry></row> + <row><entry>Body_Data</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + <entry><para>Conditional on flag bit B</para><para>(ZZZ compression)</para></entry> + </row> + <row> + <entry morerows='1' valign='middle'><para>Object Footer:</para><para>(not compressible)</para></entry> + <entry>Padding</entry> + <entry><para>As required to maintain 8-byte</para><para>object boundaries</para></entry> + </row> + <row> + <entry>Magic2</entry> + <entry>Required</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + ????Need a description that says that an object can now have (1) EITHER an attribute OR a + body, (2) BOTH an attribute and a body, or (3) NEITHER an attribute nor a body. + </para> + <para> + The routines db_get_external() and db_put_external() are used to move objects in external + format between memory and the database disk file. The routines db_wrap_external() and + db_unwrap_external() are used to wrap and unwrap the (??? Object_Body or Object_Interior ???) + (already in external form) in a standardized database object's wrapper. + </para> + </section> + + <section> + <title>Flags</title> + <para> + The Flags element consists of three 8-bit fields: HFlags, AFlags, and BFlags. The HFlags + field is 1 byte containing flag bits that pertain to the noncompressible basic header and + the database object as a whole. The AFlags and BFlags fields are each single bytes containing + flag bits that pertain to the (potentially compressed) attributes and body, respectively, in + the object interior. + </para> + <table frame='all'> + <title>BRL-CAD Flags Structure</title> + <tgroup cols='26' align='center'> + <colspec colname='h1'/> + <colspec colname='h2'/> + <colspec colname='h3'/> + <colspec colname='h4'/> + <colspec colname='h5'/> + <colspec colname='h6'/> + <colspec colname='h7'/> + <colspec colname='h8'/> + <colspec colname='s1'/> + <colspec colname='a1'/> + <colspec colname='a2'/> + <colspec colname='a3'/> + <colspec colname='a4'/> + <colspec colname='a5'/> + <colspec colname='a6'/> + <colspec colname='a7'/> + <colspec colname='a8'/> + <colspec colname='s2'/> + <colspec colname='b1'/> + <colspec colname='b2'/> + <colspec colname='b3'/> + <colspec colname='b4'/> + <colspec colname='b5'/> + <colspec colname='b6'/> + <colspec colname='b7'/> + <colspec colname='b8'/> + <thead> + <row> + <entry namest='h1' nameend='h8' align='center'>HFlags</entry> + <entry></entry> + <entry namest='a1' nameend='a8' align='center'>AFlags</entry> + <entry></entry> + <entry namest='b1' nameend='b8' align='center'>BFlags</entry> + </row> + </thead> + <tbody> + <row> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + <entry morerows='1'> </entry> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + <entry morerows='1'> </entry> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + </row> + <row> + <entry namest='h1' nameend='h2'>Wid</entry> + <entry>N</entry> + <entry namest='h4' nameend='h5'>Wid</entry> + <entry>r</entry> + <entry namest='h7' nameend='h8'>DLI</entry> + <entry namest='a1' nameend='a2'>Wid</entry> + <entry>P</entry> + <entry>r</entry> + <entry>r</entry> + <entry namest='a6' nameend='a8'>ZZZ</entry> + <entry namest='b1' nameend='b2'>Wid</entry> + <entry>P</entry> + <entry>r</entry> + <entry>r</entry> + <entry namest='b6' nameend='b8'>ZZZ</entry> + </row> + </tbody> + </tgroup> + </table> + + <section> + <title>Wid Flags</title> + <para> + The length of an object or subelement in the database is recorded using an + unsigned integer. These are variable-width fields based on the magnitude of the + maximum number needed. The Wid bits specify the size of the unsigned integer + employed in each instance. There are four 2-bit width (Wid) flags: Object_Wid + and Name_Wid (stored in HFlags), Attribute_Wid (stored in AFlags), and Body_Wid + (stored in BFlags). The Wid fields are interpreted in this manner: + </para> + + <table frame='all'> + <title>Wid Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Wid Bits</entry> + <entry>Width (in bits) of Associated Length Fields</entry> + </row> + </thead> + <tbody> + <row> + <entry>00</entry> + <entry>8</entry> + </row> + <row> + <entry>01</entry> + <entry>16</entry> + </row> + <row> + <entry>10</entry> + <entry>32</entry> + </row> + <row> + <entry>11</entry> + <entry>64</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The Object_Wid flag, at the high end of HFlags, encodes the width of the Object_Length + field. The Name_Wid flag, in bits 3 and 4 of HFlags, encodes the width of the Name_Length + field (when the name element is present; see the N bit, shown later.). Attribute_Wid (or + Body_Wid, as the case may be) encodes the width of the Attribute_Length field (when the + Object_Attributes (or Object_Attributes) element is present. + http://ftp.arl.mil/~mike/papers/brlcad5.0/newdb.html - bbitSee the P bit, below.)??????????. + </para> + <para> + The rationale for allowing the width of the Object_Length field to be specified independently + of the other widths is to save space on objects in which the values in many of the length + fields nearly overflow the specified field width, so that their sum requires a wider field. + For example, for four 255-byte interior fields, the corresponding length fields need be no + more than 8 bits wide, so the choice Interior_Wid=00 suffices, but their combined length of + 1020 bytes would require Object_Wid=01. Because all of the length fields besides Object_Length + must have the same width, the largest of the values stored in these length fields determines + the value of Interior_Wid required. Both Object_Wid and Interior_Wid may vary from object to + object. It is expected that the routines that write an object to the disk will use the + narrowest width possible for each object. + </para> + </section> + + <section> + <title>"r" Bits</title> + <para> + The bits labled as "r" in all three flags are reserved for future design + work assigning additional optional fields in the object. + </para> + </section> + + <section> + <title>HFlags - the DLI Flag</title> + <para> + The DLI flag is a 2-bit flag that indicates whether the object is an Application + Data Object or a Database Layer Internal Object. The bits are interpreted as follows: + </para> + <table frame='all' pgwide='1'> + <title>DLI Flag Structure</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>DLI Bits</entry> + <entry>Meaning</entry> + </row> + </thead> + <tbody> + <row> + <entry>00</entry> + <entry align='left'> + Application Data Object + <para> + The object contains application-specific data. N must be 1. A and B are + determined by what the application presents for storage in the object; both + may be 0 (empty Object_Interior). + </para> + </entry> + </row> + <row> + <entry>01</entry> + <entry align='left'> + Database Layer Internal, Header Object + <para> + A Header Object must be the first object encountered in the database. In + order to support direct concatenation of two existing databases into one new + database, additional header objects may appear elsewhere in the database The + header object has no object name, object attributes, or object body (e.g., + N=0, A=0, B=0). Major_Type=RESERVED, Minor_Type=0. + </para> + </entry> + </row> + <row> + <entry>10</entry> + <entry align='left'> + Database Layer Internal, Free Storage. + <para> + Unused space in the database is kept using a special Free DB Storage object + that has no object name or object attributes. The object body is null-filled + and of the proper size for the storage to be represented. Like all other objects, + the total length of the object will be a multiple of 8 bytes. N=0, A=0, B=1. + Major_Type=RESERVED, Minor_Type=0. + </para> + </entry> + </row> + <row> + <entry>11</entry> + <entry align='left'> + Database Layer Internal, Reserved + <para> + This value is reserved for future use. + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The DLI flag is not available to the higher database access layers. + </para> + <note> + <para> + Implementation note: Before writing a new object into the database in a free area, + the library should read the object header from the database and confirm that the space + is indeed free. Similarly, additions to the end should be checked by ensuring that the + file hasn't been extended. In case the check fails, the database write should fail, the + user should be notified, and the internal library mode (not the operating system file + access permissions) should be changed over to read-only access so that no further attempts + to write will be issued. These checks will provide protection against two or more users + trying to modify the same database simultaneously and accidentally stepping on each + other. In the NFS world, file locking isn't a strong enough assurance. + </para> + </note> + </section> + + <section> + <title>HFlags - the N Bit</title> + <para> + The "N" bit indicates whether the Name element (consisting of Name_Length and Object_Name + fields) is present (1) or absent (0) in the noncompressible basic header immediately following the + Object_Length field. The width of the Name_Length field is specified by the Name_Wid field. + </para> + </section> + + <section> + <title>AFlags/BFlags - the P Bit</title> + <para> + The ``P'' bit indicates whether the Attributes (or, alternatively, Body) element consisting + of Attribute_Length and Attribute_Data (or Body_Length and Body_Data) fields, is present (1) + or absent (0) in the Object_Interior. + </para> + </section> + + <section> + <title>AFlags/BFlags - the ZZZ Flag</title> + <para> + The 3-bit ``ZZZ'' flag indicates the compression, if any, of the object Attributes (or Body): + </para> + <table frame='all'> + <title>ZZZ Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>ZZZ Bits</entry> + <entry>Compression Algorithm</entry> + </row> + </thead> + <tbody> + <row> + <entry>000</entry> + <entry>None</entry> + </row> + <row> + <entry>001</entry> + <entry>GNU GZIP</entry> + </row> + <row> + <entry>010</entry> + <entry>Burroughs-Wheeler</entry> + </row> + <row> + <entry>011</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>100</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>101</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>110</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>111</entry> + <entry>Reserved</entry> + </row> + </tbody> + </tgroup> + </table> + </section> + </section> + + <section> + <title>Object Type</title> + <para> + The Object_Type element is always 16 bits wide, organized into two 8-bit-wide + fields: the Major_Type and the Minor_Type. + </para> + <table frame='all'> + <title>Object_Type Element Structure</title> + <tgroup cols='16' align='center'> + <colspec colname='0'/> + <colspec colname='1'/> + <colspec colname='2'/> + <colspec colname='3'/> + <colspec colname='4'/> + <colspec colname='5'/> + <colspec colname='6'/> + <colspec colname='7'/> + <colspec colname='8'/> + <colspec colname='9'/> + <colspec colname='10'/> + <colspec colname='11'/> + <colspec colname='12'/> + <colspec colname='13'/> + <colspec colname='14'/> + <colspec colname='15'/> + <thead> + <row> + <entry namest='0' nameend='15' align='center'>Object_Type</entry> + </row> + </thead> + <tbody> + <row> + <entry namest='0' nameend='7' align='center'>Major Type</entry> + <entry namest='8' nameend='15' align='center'>Minor Type</entry> + </row> + <row> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + Each different Major_Type value is assigned to a different class of database objects. + The following values are defined in this specification: + </para> + <table frame='all'> + <title>Major_Type Values and Meanings</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Value</entry> + <entry>Object Class</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>1</entry> + <entry>BRL-CAD Nongeometry Objects</entry> + </row> + <row> + <entry>2</entry> + <entry>BRL-CAD Geometry Objects</entry> + </row> + <row> + <entry>3</entry> + <entry>Attribute-Only Objects</entry> + </row> + <row> + <entry>8</entry> + <entry>Experimental Binary Objects (Unrecorded Structure) (Minor Type Unspecified)</entry> + </row> + <row> + <entry>9</entry> + <entry>Uniform Array Binary Objects, (Type Described in Minor Type)</entry> + </row> + <row> + <entry>10</entry> + <entry>MIME_Typed Binary Objects (Attribute "mime_type" Describes Format)</entry> + </row> + <row> + <entry>16-31</entry> + <entry>Registered-Type Binary Objects</entry> + </row> + <row> + <entry>128</entry> + <entry>First Non-ARL Type Begins Here</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The remainder are available for extending the types of objects that may be stored in + the database, allowing BRL-CAD users to extend the database for their own particular + purposes far beyond what the "attribute" method permits. + </para> + + <section> + <title>Major_Type = 0: Reserved</title> + <para> + Major Type 0 is illegal. The rationale is to provide the library an opportunity to + detect incompletely filled in data structures. + </para> + </section> + + <section> + <title>Major_Type = 1: BRL-CAD Nongeometry Objects</title> + <para> + This class of objects is private to librt, concerning all nongeometric objects needed by + the library. For this Major_Type, the following Minor_Type values are defined: + </para> + <table frame='all'> + <title>Major_Type = 1: Minor_Type Values and Meanings</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Minor_Type Value</entry> + <entry>Object Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Reserved for sanity check</entry> + </row> + <row> + <entry>1</entry> + <entry>Combination</entry> + </row> + <row> + <entry>2</entry> + <entry>Grip (Nongeometric)</entry> + </row> + <row> + <entry>3</entry> + <entry>Joint (Nongeometric)</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + All other values reserved for future expansion. + </para> + <para> + ?????Should "Grip" and "Joint" objects be of this type, or Major_Type = 2? + </para> + </section> + + <section> + <title>Major_Type = 2: BRL-CAD Geometry Objects</title> + <para> + This class of objects is private to librt, concerning all geometric objects needed + by the library. Typically, there will be one xxx/xxx.c module in librt for each minor type. + For this Major_Type, the following Minor_Type values are defined: + </para> + <table frame='all'> + <title>Major_Type = 2: Minor_Type Values and Meanings</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Minor_Type Value</entry> + <entry>Object Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Reserved for sanity check</entry> + </row> + <row> + <entry>1</entry> + <entry>Torus (TOR)</entry> + </row> + <row> + <entry>2</entry> + <entry>Truncated General Cone (TGC)</entry> + </row> + <row> + <entry>3</entry> + <entry>Ellipsoid (ELL)</entry> + </row> + <row> + <entry>4</entry> + <entry>Generalized ARB. V + 7 vectors</entry> + </row> + <row> + <entry>5</entry> + <entry>ARS</entry> + </row> + <row> + <entry>6</entry> + <entry>Half-Space (HALF)</entry> + </row> + <row> + <entry>7</entry> + <entry>Right Elliptical Cylinder (REC) (TGC special case)</entry> + </row> + <row> + <entry>8</entry> + <entry>Polygonal facted object (Polysolid)</entry> + </row> + <row> + <entry>9</entry> + <entry>B-Spline Solid</entry> + </row> + <row> + <entry>10</entry> + <entry>Sphere (ELL Special Case)</entry> + </row> + <row> + <entry>11</entry> + <entry>n-Manifold Geometry (NMG) solid</entry> + </row> + <row> + <entry>12</entry> + <entry>Extruded bitmap solid</entry> + </row> + <row> + <entry>13</entry> + <entry>Volume (VOL)</entry> + </row> + <row> + <entry>14</entry> + <entry>ARB with N faces (ARBN)</entry> + </row> + <row> + <entry>15</entry> + <entry>Pipe (wire) solid (PIPE)</entry> + </row> + <row> + <entry>16</entry> + <entry>Particle system solid (PART)</entry> + </row> + <row> + <entry>17</entry> + <entry>Right Parabolic Cylinder (RPC)</entry> + </row> + <row> + <entry>18</entry> + <entry>Right Hyperbolic Cylinder (RHC)</entry> + </row> + <row> + <entry>19</entry> + <entry>Elliptical Paraboloid (EPA)</entry> + </row> + <row> + <entry>20</entry> + <entry>Elliptical Hyperboloid (EHY)</entry> + </row> + <row> + <entry>21</entry> + <entry>Elliptical Torus (ETO)</entry> + </row> + <row> + <entry>22</entry> + <entry>Grip Nongeometric</entry> + </row> + <row> + <entry>23</entry> + <entry>Joint Nongeometric</entry> + </row> + <row> + <entry>24</entry> + <entry>Height Field (HF)</entry> + </row> + <row> + <entry>25</entry> + <entry>Displacement Map (DSP)</entry> + </row> + <row> + <entry>26</entry> + <entry>2D Sketch (SKETCH)</entry> + </row> + <row> + <entry>27</entry> + <entry>Solid of extrusion (EXTRUDE)</entry> + </row> + <row> + <entry>28</entry> + <entry>Instanced submodel</entry> + </row> + <row> + <entry>29</entry> + <entry>FASTGEN4 CLINE solid</entry> + </row> + <row> + <entry>30</entry> + <entry>Bag o' triangles (BOT)</entry> + </row> + <row> + <entry>31</entry> + <entry>Combination Record</entry> + </row> + <row> + <entry>32</entry> + <entry>Experimental binary</entry> + </row> + <row> + <entry>33</entry> + <entry>Uniform-array binary</entry> + </row> + <row> + <entry>34</entry> + <entry>MIME-typed binary</entry> + </row> + <row> + <entry>35</entry> + <entry>Superquadratic ellipsoid</entry> + </row> + <row> + <entry>36</entry> + <entry>Metaball</entry> + </row> + <row> + <entry>37</entry> + <entry>Brep object</entry> + </row> + <row> + <entry>38</entry> + <entry>Hyperboloid of one sheet (HYP)</entry> + </row> + <row> + <entry>39</entry> + <entry>Constraint object</entry> + </row> + <row> + <entry>40</entry> + <entry>Solid of revolution</entry> + </row> + <row> + <entry>41</entry> + <entry>Collection of points (PNTS)</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The details of these Minor_Types are provided in Section IV. + </para> + </section> + + <section> + <title>Major_Type = 3: Attribute-Only Objects</title> + <para> + This type of object stores only attributes in the object interior section; it has no + object body elements. + </para> + <para> + For example, if several objects need to have the same shader parameters, it would be + possible to create one attribute-only object to hold these common attributes and serve as a + simple form of "macro". Objects that needed to share these attributes could all reference the + same attribute object. If the attribute object is altered, then all of the objects that + reference it would be updated together. Without this capability, the user would have to + update each element individually to alter the attributes. + </para> + <para> + Conventions will have to be established regarding which attributes of an attribute-only + object will be used when a macro reference is performed. For example, rt shaders will + only be interested in the value of the "oshader=" attribute, while librt's tree-walker + might also be interested in the "rgb=", "giftmater=", "nsn=", "material=", and "los=" + attributes (assuming that a convention was developed so that a combination could + macro-reference an attribute-only object too). + </para> + <para> + An attribute-only object may not have an object body; thus, flag bit B must always be + zero for this type of object. + </para> + <para> + As used by the rt family of applications codes, these attribute-only objects will + contain "macros" for shaders. The shader name and its parameters shall be encoded as a + single ASCII string, which is the value of the "oshader=" attribute. An rt shader named + "macro" (or equivalent) would take a single parameter "obj=", which would specify the + name of the attribute-only object in the database from which the actual shader and + shader parameter information would be extracted. + </para> + <para> + There will be one attribute-only object with a reserved object name of "_GLOBAL" that + will be used to contain various kinds of states that are global to the entire ".g" database + and that had previously been found in the database header itself. There will be the + following BRL-CAD-specific attributes whose meaning is predefined for the _GLOBAL object: + <itemizedlist> + <listitem> + <para> + title = The database "title" string previously found in the database header. + </para> + </listitem> + <listitem> + <para> + units = The most recent editing units, specified as an ASCII string with a + floating point conversion factor. For example, the conversion factor for inches + to millimeters would be 25.4. + </para> + </listitem> + <listitem> + <para> + regionid_colortable = A string that contains a collection of all the information + previously found in "struct material_rec ID_MATERIAL" records. Exact encoding yet + to be determined; it's a collection of integer 5-tuples of the form: + {low, high, r, g, b}. + </para> + </listitem> + </itemizedlist> + </para> + <para> + In addition, the "comment=" attribute of the "_GLOBAL" object may be used to store + human-readable remarks about the database that are not more properly associated with a + specific database item. These might include remarks about data sources, model evolution, + security classification, and release restrictions. In the absense of some outboard + revision-control system, this might also be a place to record modification history, + although such use is discouraged. + </para> + </section> + + <section> + <title>Bulk Binary Objects (Major_Types 8-31)</title> + <para> + This class of objects contains various "bulk" binary data that might otherwise have + been placed in auxiliary files. + </para> + <para> + MGED and standalone commands must be built to store/extract these opaque?? binary + objects between a ".g" file and stdin/stdout/auxiliary files. A user might want to use + those same MGED commands to store/extract the binary object body of any object for external + processing. An easy example to imagine is the importing and exporting of texture maps for + external processing, but the same commands could be used for importing and exporting + solid parameters in their external binary form. + </para> + <para> + These objects may be referenced in combination nodes, for organizational purposes, but + they cannot be drawn in MGED or raytraced, and doing so would result in a warning message + being printed by the tree walker as that arc is traversed. This class may be used by all + applications and layers. + </para> + <para> + The data's purpose may be placed in the "purpose=" attribute. (????????Need a + table/registry of presently known values for this attribute.) + </para> + <para> + Routines that retrieve bulk binary objects should check the minor type and the + "purpose=" attribute and send a warning message in the event of a mismatch, but + best-effort processing of the object should continue. This will permit some degree + of error checking, which should benefit novice users without standing in the way of + "creatively" reusing one set of data, (e.g., using one array of values as both a height + field and a bwtexture). This allows common data perversion practices, such as interpreting + an array of floats as an array of bytes, to continue. + </para> + <para> + Each application will need to have its own syntax for the user to specify whether the data + source is an outboard file or a raw-binary object. For example, the current RT sh_texture + module uses the keyword file="name" to indicate an outboard file; that might be supplemented + with an additional obj="name" possibility for retrieving from an inboard raw-binary object. + </para> + + <section> + <title>Major_Type = 8: Experimental Binary Objects</title> + <para> + This class of objects contains bulk binary data and is intended for experimental + use by applications developers. Each time a database containing objects of this type + is opened, BRL-CAD will issue a user-visible warning. Production software and databases + should not use these objects. Developers should obtain registered 16-bit object types + from the website in order to avoid collisions with other applications. + </para> + </section> + <section> + <title>Major_Type = 9: Uniform Array Binary Objects</title> + <para> + This class of objects contain various "bulk" binary data that might otherwise have + been placed in an auxiliary file. + </para> + <para> + Point of Discussion?????Has ramifications... we have to implement type advising, so + that applications that use these data can compare the type provided in the minor + type code with the type that they're expecting and advise the user (with a warning + message) that there is a potential type mismatch. + </para> + <table frame='all'> + <title>Uniform Array Binary Objects Minor_Type Structure</title> + <tgroup cols='8' align='center'> + <colspec colname='h1'/> + <colspec colname='h2'/> + <colspec colname='h3'/> + <colspec colname='h4'/> + <colspec colname='h5'/> + <colspec colname='h6'/> + <colspec colname='h7'/> + <colspec colname='h8'/> + <thead> + <row> + <entry namest='h1' nameend='h8' align='center'>Minor_Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + </row> + <row> + <entry>r</entry> + <entry>r</entry> + <entry namest='h3' nameend='h4'>Wid</entry> + <entry>S</entry> + <entry namest='h6' nameend='h8'>Atom</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The 3-bit ``Atom'' flag indicates the fundamental data type of the atomic elements + in the array according to the following scheme: + </para> + <table frame='all'> + <title>Atom Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Atom Bits</entry> + <entry>Data Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>000</entry> + <entry>Reserved for sanity check</entry> + </row> + <row> + <entry>001</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>010</entry> + <entry>float (IEEE, network order)</entry> + </row> + <row> + <entry>011</entry> + <entry>double (IEEE, network order)</entry> + </row> + <row> + <entry>100</entry> + <entry>8-bit int</entry> + </row> + <row> + <entry>101</entry> + <entry>16-bit int</entry> + </row> + <row> + <entry>110</entry> + <entry>32-bit int</entry> + </row> + <row> + <entry>111</entry> + <entry>64-bit int</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The ``S'' bit indicates whether an integer type is signed (1) or unsigned (0). + Floats and doubles (i.e., atomic types with the highest atom bit equal to 0) are + explicitly signed, so they will have the ``S'' bit equal to 1. (The bit patterns + corresponding to unsigned floats and doubles are reserved for possible other use.) + </para> + <para> + The 2-bit ``Wid'' flag specifies the length (in atomic elements) of the array elements: + </para> + <table frame='all'> + <title>Wid Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Wid Bits</entry> + <entry>Atoms per Array Element</entry> + </row> + </thead> + <tbody> + <row> + <entry>00</entry> + <entry>1</entry> + </row> + <row> + <entry>01</entry> + <entry>2</entry> + </row> + <row> + <entry>10</entry> + <entry>3</entry> + </row> + <row> + <entry>11</entry> + <entry>4</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The remaining Minor_Type bits ``r'' are reserved for the design committee to use for + other purposes, possibly including extensions of the ``Atom'' and/or ``Wid'' flags. + </para> + <para> + As examples, data in PIX(5) format, which might be used for a texture map, would + have Minor_Type ``0010 0100'', indicating a triple of unsigned char, and CMYK data + might be stored with Minor_Type ``0011 1011'', indicating a quadruple of doubles. + </para> + <para> + The data's purpose (e.g., height field, texture, bump, displacement, etc.) may be + placed in the "purpose=" attribute. ?????Point of Discussion???(Need a table/registry + of presently known values for this attribute.) + </para> + </section> + <section> + <title>Major_Type = 10: MIME-Typed Binary Objects</title> + <para> + This class of objects contains data, the format of which is specified in the + attribute "mime_type". The Minor_Type of these objects should always be zero. + </para> + </section> + <section> + <title>Major_Type = 16-31: Registered-Type Binary Objects</title> + <para> + This class of objects contains application-specific bulk binary data and is intended + for use in production software and databases. Developers can obtain registered 16-bit + object types from the website to identify these objects. The data's purpose, (e.g. height + field, texture, bump, displacement, etc.) may be placed in the "purpose=" attribute. + (Need a table/registry of presently known values for this attribute). + </para> + </section> + </section> + + <section> + <title>Major_Type = 255: Database Layer Internal Objects</title> + <para> + A Minor_Type of 1 indicates that this is a contiguous block of free storage. + </para> + <para> + A Minor_Type of 2 indicates that this is a database header. + </para> + </section> + + </section> + + <section> + <title>Object Length</title> + <para> + The Object Length specifies the number of 8-byte chunks used to store an object. This includes all bytes + from Magic1 through Magic2, inclusive. + </para> + </section> + + <section> + <title>Object Name</title> + <para> + The Object_Name element is a string that holds a name unique to that object and drawn from a name space that + is global to the database. The Object_Name element is mandatory for all allocated storage in the database. + Database free-space managment objects are the only objects for which the Object_Name element is optional. + </para> + <para> + The name is specified in 8-bit ASCII. There is no support for UNICODE. The name is null-terminated, and the + null byte is included in Name_Length. + </para> + <para> + See the section on DLI flags. In the case of Free objects, the name is not retained. Undeleted objects have + a different DLI flag code. + </para> + </section> + + <section> + <title>Object Attributes</title> + <para> + An object may optionally have an Object_Attributes element, which stores an association list + <literallayout> +aname1=value1, aname2=value2, ..., anameN=valueN + </literallayout> + binding attributes to values. + </para> + <para> + These are ASCII strings of unlimited length. These attributes are intended for direct use by programs. + There will be a WWW registry of attribute names presently in use to prevent two application developers + from using the same attribute_name for different purposes. + </para> + <para> + For attribute names and attribute values, The decision was taken to support 8-bit ASCII only. The + on-disk encoding of this will simply be: + <literallayout> +aname1 NULL value1 NULL ... anameN NULL valueN NULL NULL + </literallayout> + where NULL represents a byte with all bits zero. The NULL in place of anameN+1 signals the end of the + attribute data, simplifying the job of the reader. + </para> + <para> + Every object in the database may have zero or more attributes attached to it; the meaning of these attributes + will vary depending on which application or library processes them. + </para> + <para> + There are several aname conventions that all BRL-CAD applications are expected to respect. There will be a + WWW extendable registry of "in-use" anames, so that independent applications developers may select aname + strings for their own use without fear of name conflicts later. The initial registry would include: + <itemizedlist> + <listitem> + <para> + comment = Every object may optionally have a comment that contains a string of an arbitrary number of + newline-terminated lines of text. These are strings for use by humans only. None of the BRL-CAD software + may parse or interpret these strings other than to print them and edit them when requested by the user. + They are provided for the modeler to place notes in. + </para> + </listitem> + <listitem> + <para> + nsn = The American National Stock Number (NSN) for this part, when known. + </para> + </listitem> + <listitem> + <para> + material = The format of this string is not currently defined as there are conflicting naming/coding + conventions employed by the various standards organizations (e.g., ISO, ASME, etc.). + </para> + </listitem> + <listitem> + <para> + region = For combinations, indicates this combination is a region. Boolean. + </para> + </listitem> + <listitem> + <para> + inherit = For combinations, indicates whether attributes from lower combinations in tree will replace + higher ones. Boolean, default=0. + </para> + </listitem> + <listitem> + <para> + oshader = For combinations, read by the "rt" program, optical shader name and parameter string (separated + from each other by white space). Meaningful only at or above a region node, and only on a combination, or + in an attribute-only "macro". + </para> + </listitem> + <listitem> + <para> + rgb = For combinations, when present indicates optical rgb color is specified. + </para> + </listitem> + <listitem> + <para> + region_id = For regions, GIFT compatability. Integer. + </para> + </listitem> + <listitem> + <para> + giftmater = For regions, GIFT compatability. Integer. (Point of Discussion?????Should we use negative values for + air codes, positive for nonair, so we can eliminate air codes?) + </para> + </listitem> + <listitem> + <para> + aircode = For regions, air code. Integer. 0 is the same as attribute not specified. (Point of + Discussion?????Possibly eliminated in favor of negative giftmater values). + </para> + </listitem> + <listitem> + <para> + los = For regions, GIFT compatability. Integer. + </para> + </listitem> + <listitem> + <para> + component = For regions, the name of the MUVES component containing this object. + </para> + </listitem> + <listitem> + <para> + rlist = The proposed BRL-CAD "replacement list" field would be stored on a binary-block attribute + ("rlist="). [deferred implementation] + </para> + </listitem> + <listitem> + <para> + macro = If present, specifies name of an attribute-only object to be consulted for additional attribute values. + </para> + </listitem> + </itemizedlist> + + All other attributes, from whatever source, would be stored similarly, including application-specific and + end-user-created attributes. + </para> + </section> + <section> + <title>Object Body</title> + <para> + The contents of the Object Body are opaque?? to the databaase layer. The contents of this element are interpreted + based upon the Object_Type. The Object_Body is not constrained to start on a chunk boundary. + </para> + </section> + + <section> + <title>Padding and Length Rounding</title> + <para> + The minimal object is a Free object (with no name) 8 bytes long: + <literallayout> + Magic1 (1byte) + HFlags = 000xxxxx (1 byte) + AFlags = 0000xx00 (1 byte) + BFlags = 0000xx00 (1 byte) + ObjType = Free (2 bytes) + ObjLen = 7 (1 byte) + Magic2 (1 byte). + </literallayout> + This is why we have chosen the 8-bit size for our chunks. Pad bytes are inserted as necessary in the Object Footer + immediately before the second magic number so that the final byte of the object is the Magic2 byte. The pad bytes are + not counted as part of the Body_Length, but are counted as part of the Object_Length. + </para> + <para> + The minimal valid object is thus the following Free object: + <literallayout> +Magic1 (1byte) +HFlags = 00000010 (1 byte), Wid=00, N=0, DLI=02 +IFlags????? = 00000000 (1 byte), Wid=00, A=0, B=0, ZZZ=000 +Object_Type = RESERVED (2 bytes) +Object_Length = 1 (1 byte) +Pad (1byte) +Magic2 (1 byte). + </literallayout> + </para> + <para> + The header of the database will always look like this: + <literallayout> +Magic1 (1byte) +HFlags = 000xxx01 (1 byte), Wid=00, N=0, DLI=01 +IFlags????? = 0000x000 (1 byte), Wid=00, A=0, B=0, ZZZ=000 +Object_Type = RESERVED (2 bytes) +Object_Length = 1 (1 byte) +Pad (1byte) +Magic2 (1 byte) +The hex and ASCII dump of this object would look something this: + +76 01 00 00 00 01 00 35 |v......5| + </literallayout> + </para> + <para> + The minimal valid allocated database storage object (with an Object_Name, no Object_Attributes or Object_Body) would thus be: + <literallayout> +Magic1 (1byte) +HFlags = 001xxxxx (1 byte), Wid=00, N=1, DLI=00 +IFlags ?????= 0000xxxx (1 byte), Wid=00, A=0, B=0, ZZZ=000 +Object_Type = OPAQUE?????_BINARY (2 bytes) +Object_Length = 8 (1 byte) +Name_Length = 2 (1 byte) +Object Name (1 character + null byte) (2 bytes) +Pad (6 bytes) +Magic2 (1 byte). + </literallayout> + </para> + <para> + Without the padding, this (rather useless) object would be 10 bytes long. Given the rounding requirements, it is clear that all allocated storage objects in the database must be at least 16 bytes long. A database object with a minimal Object_Body would need 12 bytes, which would need to be padded out to 16 bytes as well: + <literallayout> +Magic1 (1 byte) +HFlags = 001xxxxx (1 byte) +IFlags???? = 00x1xxxx (1 byte) +Object Type (2 bytes) +Object Length = 16 (1 byte) +Name Length = 2 (1 byte) +Object Name (1 character + null byte) (2 bytes) +Body Length = 1 (1 byte) +Body Data (1 byte) +Pad (4 bytes) +Magic2 (1 byte). + </literallayout> + + </para> + <para> + <literallayout> + </literallayout> + </para> + <para> + <literallayout> + </literallayout> + </para> + <para> + <literallayout> + </literallayout> + </para> + + </section> + + + + <section> + <title>How Objects Are Grouped into a Database</title> + <para> + + </para> + </section> + <section> + <title>Details of BRL-CAD-Specific Nongeometric Database Object Types</title> + <para> + + </para> + </section> + <section> + <title>Details of BRL-CAD-Specific Geometric Database Object Types</title> + <para> + + </para> + </section> + <section> + <title>Extensions for Deferred Implementation</title> + <para> + + </para> + </section> + <section> + <title>Community Feedback on the Proposal</title> + <para> + + </para> + </section> + <section> + <title>Database Library Application Programming Interface (API)</title> + <para> + + </para> + </section> +</section> +</article> Property changes on: brlcad/trunk/doc/docbook/spec/en/BRL_CAD_g_format_V5.xml _____________________________________________________... [truncated message content] |
From: <sta...@us...> - 2009-10-21 21:04:45
|
Revision: 36240 http://brlcad.svn.sourceforge.net/brlcad/?rev=36240&view=rev Author: starseeker Date: 2009-10-21 21:04:35 +0000 (Wed, 21 Oct 2009) Log Message: ----------- Better be consistent - all the other toplevel dir names are spelled out, spell out this one too Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/specifications/ brlcad/trunk/doc/docbook/specifications/en/ brlcad/trunk/doc/docbook/specifications/en/BRL_CAD_g_format_V5.xml brlcad/trunk/doc/docbook/specifications/en/images/ Removed Paths: ------------- brlcad/trunk/doc/docbook/spec/ Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-10-21 20:56:42 UTC (rev 36239) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-10-21 21:04:35 UTC (rev 36240) @@ -367,34 +367,34 @@ -specDOCBOOK_EN = \ - spec/en/BRL_CAD_g_format_V5.xml +specificationsDOCBOOK_EN = \ + specifications/en/BRL_CAD_g_format_V5.xml -specDOCBOOK_EN_IMAGES = +specificationsDOCBOOK_EN_IMAGES = -specDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/spec/en -specDOCBOOK_ENhtml_DATA = \ +specificationsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/specifications/en +specificationsDOCBOOK_ENhtml_DATA = \ $(BUILTSPECS_ENHTML) BUILTSPECS_ENHTML = \ - ${specDOCBOOK_EN:xml=html} + ${specificationsDOCBOOK_EN:xml=html} -specDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/spec/en/images -specDOCBOOK_ENhtmlimages_DATA = \ +specificationsDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/specifications/en/images +specificationsDOCBOOK_ENhtmlimages_DATA = \ $(BUILTSPECS_ENIMAGES) BUILTSPECS_ENIMAGES = \ - ${specDOCBOOK_EN_IMAGES:docpng=png} + ${specificationsDOCBOOK_EN_IMAGES:docpng=png} if BUILD_PDF_DOCS -BUILTSPECS_ENPDF = ${specDOCBOOK_EN:xml=pdf} +BUILTSPECS_ENPDF = ${specificationsDOCBOOK_EN:xml=pdf} endif -specDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/spec/en -specDOCBOOK_ENpdf_DATA = $(BUILTSPECS_ENPDF) +specificationsDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/specifications/en +specificationsDOCBOOK_ENpdf_DATA = $(BUILTSPECS_ENPDF) Added: brlcad/trunk/doc/docbook/specifications/en/BRL_CAD_g_format_V5.xml =================================================================== --- brlcad/trunk/doc/docbook/specifications/en/BRL_CAD_g_format_V5.xml (rev 0) +++ brlcad/trunk/doc/docbook/specifications/en/BRL_CAD_g_format_V5.xml 2009-10-21 21:04:35 UTC (rev 36240) @@ -0,0 +1,1713 @@ +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" +"/usr/share/sgml/docbook/xml-dtd-4.5/docbookx.dtd"> +<article class='specification'> + <articleinfo> + <title>BRL-CAD Database Format</title> + <subtitle>Version 5 (DRAFT)</subtitle> + <authorgroup> + <author> + <firstname>Lee</firstname> + <surname>Butler</surname> + <othername role='mi'>A</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Michael</firstname> + <surname>Muuss</surname> + <othername role='mi'>John</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Paul</firstname> + <surname>Tanenbaum</surname> + <othername role='mi'>J</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>John</firstname> + <surname>Anderson</surname> + <othername role='mi'>R</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Robert</firstname> + <surname>Parker</surname> + <othername role='mi'>G</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Ronald</firstname> + <surname>Bowers</surname> + <othername role='mi'>A</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Christopher</firstname> + <surname>Johnson</surname> + <othername role='mi'>T</othername> + <affiliation> + <shortaffil>U.S. Army Research Laboratory</shortaffil> + <orgdiv>Survivability/Lethality Analysis Directorate</orgdiv> + <address> + Aberdeen Proving Ground + <state>MD</state> + <postcode>21005-5068</postcode> + </address> + </affiliation> + </author> + <author> + <firstname>Eric</firstname> + <surname>Edwards</surname> + <othername role='mi'>W</othername> + <affiliation> + <shortaffil>SURVICE Engineering Company</shortaffil> + <address> + <street>4695 Millennium Drive</street> + <city>Belcamp</city> + <state>MD</state> + <postcode>21017-1505</postcode> + </address> + </affiliation> + </author> + </authorgroup> + </articleinfo> + + <abstract> + <para> + BRL-CAD software uses its own binary file format to store the geometric information and + other properties required to define CAD models. BRL-CAD used its version 4 (v4) binary + ".g" database format for over 10 years, but a variety of long standing issues with + that format prompted the development of version 5. Issues addressed by the new format + include a machine-independent format, expanding the upper limit of numbers to double + precision floating point, and lifting a 16 character size limit on object names. + </para> + </abstract> + + <section> + <title>Background and Terminology</title> + <para> + BRL-CAD is a constructive solid geometry (CSG) modeling system. Primitive solid shapes + are combined using boolean operations to form regions of homogeneous material. + </para> + <para> + The database is organized as a <emphasis>directed acyclic graph</emphasis> (DAG), which + comprises + + <itemizedlist> + <listitem> + <para>primitive <emphasis>solids</emphasis> - the minimal elements of the DAG.</para> + </listitem> + <listitem> + <para> + <emphasis>combinations</emphasis> - the nonminimal elements of the DAG, + some of which are specially marked as regions. The maximal + elements of the DAG are called tops. + </para> + </listitem> + <listitem> + <para><emphasis>arcs</emphasis> - contain boolean operators and 4x4 homogeneous transformation matrices.</para> + </listitem> + </itemizedlist> + </para> + <para> + In a slight abuse of terminology, the DAG is often spoken of as a tree or collection + of trees. In this context, the solids are also called <emphasis>leaves</emphasis>. + </para> + <section> + <title>Format of Data Elements/Database External Format</title> + <para> + The external format has several important properties, especially with regard + to the <emphasis>Object_Body</emphasis>: + <itemizedlist> + <listitem> + <para> + Numbers are stored in binary for storage efficiency, for speed of reading + and writing, and for preventing errors from creeping in due to repetitive + conversion between binary and an ASCII string representation. This eliminates + the need to use the old g2asc and asc2g to move databases between machines of + different architectures. + </para> + </listitem> + <listitem> + <para> + All data in the object wrapper are stored in a machine-independent format, + as follows: + <itemizedlist mark='opencircle'> + <listitem> + <para> + All floating point numbers are stored as IEEE double-precision, in + big-endian order, where byte 0 is on the left end of the word. + </para> + </listitem> + <listitem> + <para> + All integers are stored as either <emphasis>unsigned</emphasis> or + <emphasis>twos-complement signed</emphasis> binary numbers in either + 8, 16, 32, or 64 bits, in big-endian order. + </para> + </listitem> + <listitem> + <para> + All character strings are stored in the ASCII 8-bit character set. + A string is stored as an integer followed by an array of 8-bit + characters. The last character in the array is always a null byte. + The integer indicates the number of bytes in the array including the + terminating null. + </para> + </listitem> + </itemizedlist> + </para> + </listitem> + </itemizedlist> + </para> + </section> + </section> + + <section> + <title>Definition of a Single, Generic Database Object</title> + <para> + The database access library stores <emphasis>objects</emphasis> as a collection + of data with a globally unique name and places no interpretation on the content + of those data. The <emphasis>object</emphasis> is the smallest granularity of + an item in the database; objects must be read from and written to the database + in a single atomic operation. + </para> + <para> + In the case of librt, each database object will contain exactly one combination + node or leaf (solid) node. + </para> + <section> + <title>Object Structure</title> + <para> + All objects share certain common properties, which are stored in a standardized + <emphasis>object wrapper</emphasis> consisting of an Object Header and an Object Footer. + </para> + <para> + The Object Header consists of: + <itemizedlist> + <listitem> + <para> + An 8-bit Magic1 element that holds a specific magic number value used for + database integrity checking. + </para> + </listitem> + <listitem> + <para> + A 16-bit Flags element consisting of three 8-bit fields: HFlags, AFlags, + and BFlags, described later. + </para> + </listitem> + <listitem> + <para> + A 16-bit Object_Type element organized into two 8-bit-wide fields: the + Major_Type and the Minor_Type. + </para> + </listitem> + <listitem> + <para> + An Object_Length element that indicates the total number of bytes required + for this object, including the magic numbers. + </para> + </listitem> + <listitem> + <para> + An Object_Name element that is a string holding a name unique to that object + and drawn from a name space that is global to the database. Like other strings, + it consists of two fields, Length and Data. In the case of the Object_Name + element, these are referred to as Name_Length and Name_Data, respectively. + Note: The Object_Name element is mandatory for all allocated storage in the + database. Database free-space managment objects are the only objects for which + the Object_Name element is optional. + </para> + </listitem> + </itemizedlist> + </para> + <para> + The Object Footer consists of: + <itemizedlist> + <listitem> + <para> + Any padding bytes necessary to bring the total size of the object in bytes to an + integral multiple of 8. + </para> + </listitem> + <listitem> + <para> + An 8-bit Magic2 element that holds a specific magic number value used for database + integrity checking. + </para> + </listitem> + </itemizedlist> + </para> + <para> + Objects may store application-specific information in an Object Interior. + <itemizedlist> + <listitem> + <para> + An object may optionally have an Object_Attributes element consisting of a + pair of fields: Attribute_Length and Attribute_Data. From the point of view + of the database interface specification, the names and values of these attributes + are opaque????; a standardized import/export encoding API will be provided. + </para> + </listitem> + <listitem> + <para> + An object may optionally have an Object_Body element consisting of a pair of + fields, Body_Length and Body_Data. From the point of view of the database + interface specification, the format of the data is opaque??. + </para> + </listitem> + </itemizedlist> + </para> + <para> + The on-disk version of each object consists of three distinct parts: Object Header, + Object Interior, and Object Footer. This is called the external format of the object. + </para> + <table frame='all'> + <title>On-Disk BRL-CAD Object Structure</title> + <tgroup cols='3' align='center' colsep='1' rowsep='1'> + <thead> + <row> + <entry>Part</entry> + <entry>Element</entry> + <entry>Comments</entry> + </row> + </thead> + <tbody> + <row> + <entry morerows='4' valign='middle'><para>Object Header:</para><para>(not compressible)</para></entry> + <entry>Magic1</entry> + <entry morerows='2' valign='middle'>Required</entry> + </row> + <row> + <entry>HFlags, AFlags, BFlags</entry> + </row> + <row> + <entry><para>Object_Type</para><para>(Major_Type, Minor_Type)</para></entry> + </row> + <row> + <entry>Object_Length</entry> + <entry>Required</entry> + </row> + <row> + <entry align='center'> + <para> + <informaltable frame='none'> + <tgroup cols='2' align='center'> + <tbody> + <row> + <entry>Object Name:</entry> + <entry> + <para> + <informaltable frame='all'> + <tgroup cols='1' align='center'> + <tbody> + <row><entry>Name_Length</entry></row> + <row><entry>Name_Data</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + <entry><para>Conditional on flag bit N,</para><para>Required for Application Data</para></entry> + </row> + <row> + <entry morerows='1' valign='middle'><para>Object Interior:</para><para>(individually compressible)</para></entry> + <entry align='center'> + <para> + <informaltable frame='none'> + <tgroup cols='2' align='center'> + <tbody> + <row> + <entry>Object Attributes:</entry> + <entry> + <para> + <informaltable frame='all'> + <tgroup cols='1' align='center'> + <tbody> + <row><entry>Attribute_Length</entry></row> + <row><entry>Attribute_Data</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + <entry><para>Conditional on flag bit A</para><para>(ZZZ compression)</para></entry> + </row> + <row> + <entry align='center'> + <para> + <informaltable frame='none'> + <tgroup cols='2' align='center'> + <tbody> + <row> + <entry>Object Body:</entry> + <entry> + <para> + <informaltable frame='all'> + <tgroup cols='1' align='center'> + <tbody> + <row><entry>Body_Length</entry></row> + <row><entry>Body_Data</entry></row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </entry> + <entry><para>Conditional on flag bit B</para><para>(ZZZ compression)</para></entry> + </row> + <row> + <entry morerows='1' valign='middle'><para>Object Footer:</para><para>(not compressible)</para></entry> + <entry>Padding</entry> + <entry><para>As required to maintain 8-byte</para><para>object boundaries</para></entry> + </row> + <row> + <entry>Magic2</entry> + <entry>Required</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + ????Need a description that says that an object can now have (1) EITHER an attribute OR a + body, (2) BOTH an attribute and a body, or (3) NEITHER an attribute nor a body. + </para> + <para> + The routines db_get_external() and db_put_external() are used to move objects in external + format between memory and the database disk file. The routines db_wrap_external() and + db_unwrap_external() are used to wrap and unwrap the (??? Object_Body or Object_Interior ???) + (already in external form) in a standardized database object's wrapper. + </para> + </section> + + <section> + <title>Flags</title> + <para> + The Flags element consists of three 8-bit fields: HFlags, AFlags, and BFlags. The HFlags + field is 1 byte containing flag bits that pertain to the noncompressible basic header and + the database object as a whole. The AFlags and BFlags fields are each single bytes containing + flag bits that pertain to the (potentially compressed) attributes and body, respectively, in + the object interior. + </para> + <table frame='all'> + <title>BRL-CAD Flags Structure</title> + <tgroup cols='26' align='center'> + <colspec colname='h1'/> + <colspec colname='h2'/> + <colspec colname='h3'/> + <colspec colname='h4'/> + <colspec colname='h5'/> + <colspec colname='h6'/> + <colspec colname='h7'/> + <colspec colname='h8'/> + <colspec colname='s1'/> + <colspec colname='a1'/> + <colspec colname='a2'/> + <colspec colname='a3'/> + <colspec colname='a4'/> + <colspec colname='a5'/> + <colspec colname='a6'/> + <colspec colname='a7'/> + <colspec colname='a8'/> + <colspec colname='s2'/> + <colspec colname='b1'/> + <colspec colname='b2'/> + <colspec colname='b3'/> + <colspec colname='b4'/> + <colspec colname='b5'/> + <colspec colname='b6'/> + <colspec colname='b7'/> + <colspec colname='b8'/> + <thead> + <row> + <entry namest='h1' nameend='h8' align='center'>HFlags</entry> + <entry></entry> + <entry namest='a1' nameend='a8' align='center'>AFlags</entry> + <entry></entry> + <entry namest='b1' nameend='b8' align='center'>BFlags</entry> + </row> + </thead> + <tbody> + <row> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + <entry morerows='1'> </entry> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + <entry morerows='1'> </entry> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + </row> + <row> + <entry namest='h1' nameend='h2'>Wid</entry> + <entry>N</entry> + <entry namest='h4' nameend='h5'>Wid</entry> + <entry>r</entry> + <entry namest='h7' nameend='h8'>DLI</entry> + <entry namest='a1' nameend='a2'>Wid</entry> + <entry>P</entry> + <entry>r</entry> + <entry>r</entry> + <entry namest='a6' nameend='a8'>ZZZ</entry> + <entry namest='b1' nameend='b2'>Wid</entry> + <entry>P</entry> + <entry>r</entry> + <entry>r</entry> + <entry namest='b6' nameend='b8'>ZZZ</entry> + </row> + </tbody> + </tgroup> + </table> + + <section> + <title>Wid Flags</title> + <para> + The length of an object or subelement in the database is recorded using an + unsigned integer. These are variable-width fields based on the magnitude of the + maximum number needed. The Wid bits specify the size of the unsigned integer + employed in each instance. There are four 2-bit width (Wid) flags: Object_Wid + and Name_Wid (stored in HFlags), Attribute_Wid (stored in AFlags), and Body_Wid + (stored in BFlags). The Wid fields are interpreted in this manner: + </para> + + <table frame='all'> + <title>Wid Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Wid Bits</entry> + <entry>Width (in bits) of Associated Length Fields</entry> + </row> + </thead> + <tbody> + <row> + <entry>00</entry> + <entry>8</entry> + </row> + <row> + <entry>01</entry> + <entry>16</entry> + </row> + <row> + <entry>10</entry> + <entry>32</entry> + </row> + <row> + <entry>11</entry> + <entry>64</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The Object_Wid flag, at the high end of HFlags, encodes the width of the Object_Length + field. The Name_Wid flag, in bits 3 and 4 of HFlags, encodes the width of the Name_Length + field (when the name element is present; see the N bit, shown later.). Attribute_Wid (or + Body_Wid, as the case may be) encodes the width of the Attribute_Length field (when the + Object_Attributes (or Object_Attributes) element is present. + http://ftp.arl.mil/~mike/papers/brlcad5.0/newdb.html - bbitSee the P bit, below.)??????????. + </para> + <para> + The rationale for allowing the width of the Object_Length field to be specified independently + of the other widths is to save space on objects in which the values in many of the length + fields nearly overflow the specified field width, so that their sum requires a wider field. + For example, for four 255-byte interior fields, the corresponding length fields need be no + more than 8 bits wide, so the choice Interior_Wid=00 suffices, but their combined length of + 1020 bytes would require Object_Wid=01. Because all of the length fields besides Object_Length + must have the same width, the largest of the values stored in these length fields determines + the value of Interior_Wid required. Both Object_Wid and Interior_Wid may vary from object to + object. It is expected that the routines that write an object to the disk will use the + narrowest width possible for each object. + </para> + </section> + + <section> + <title>"r" Bits</title> + <para> + The bits labled as "r" in all three flags are reserved for future design + work assigning additional optional fields in the object. + </para> + </section> + + <section> + <title>HFlags - the DLI Flag</title> + <para> + The DLI flag is a 2-bit flag that indicates whether the object is an Application + Data Object or a Database Layer Internal Object. The bits are interpreted as follows: + </para> + <table frame='all' pgwide='1'> + <title>DLI Flag Structure</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>DLI Bits</entry> + <entry>Meaning</entry> + </row> + </thead> + <tbody> + <row> + <entry>00</entry> + <entry align='left'> + Application Data Object + <para> + The object contains application-specific data. N must be 1. A and B are + determined by what the application presents for storage in the object; both + may be 0 (empty Object_Interior). + </para> + </entry> + </row> + <row> + <entry>01</entry> + <entry align='left'> + Database Layer Internal, Header Object + <para> + A Header Object must be the first object encountered in the database. In + order to support direct concatenation of two existing databases into one new + database, additional header objects may appear elsewhere in the database The + header object has no object name, object attributes, or object body (e.g., + N=0, A=0, B=0). Major_Type=RESERVED, Minor_Type=0. + </para> + </entry> + </row> + <row> + <entry>10</entry> + <entry align='left'> + Database Layer Internal, Free Storage. + <para> + Unused space in the database is kept using a special Free DB Storage object + that has no object name or object attributes. The object body is null-filled + and of the proper size for the storage to be represented. Like all other objects, + the total length of the object will be a multiple of 8 bytes. N=0, A=0, B=1. + Major_Type=RESERVED, Minor_Type=0. + </para> + </entry> + </row> + <row> + <entry>11</entry> + <entry align='left'> + Database Layer Internal, Reserved + <para> + This value is reserved for future use. + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The DLI flag is not available to the higher database access layers. + </para> + <note> + <para> + Implementation note: Before writing a new object into the database in a free area, + the library should read the object header from the database and confirm that the space + is indeed free. Similarly, additions to the end should be checked by ensuring that the + file hasn't been extended. In case the check fails, the database write should fail, the + user should be notified, and the internal library mode (not the operating system file + access permissions) should be changed over to read-only access so that no further attempts + to write will be issued. These checks will provide protection against two or more users + trying to modify the same database simultaneously and accidentally stepping on each + other. In the NFS world, file locking isn't a strong enough assurance. + </para> + </note> + </section> + + <section> + <title>HFlags - the N Bit</title> + <para> + The "N" bit indicates whether the Name element (consisting of Name_Length and Object_Name + fields) is present (1) or absent (0) in the noncompressible basic header immediately following the + Object_Length field. The width of the Name_Length field is specified by the Name_Wid field. + </para> + </section> + + <section> + <title>AFlags/BFlags - the P Bit</title> + <para> + The ``P'' bit indicates whether the Attributes (or, alternatively, Body) element consisting + of Attribute_Length and Attribute_Data (or Body_Length and Body_Data) fields, is present (1) + or absent (0) in the Object_Interior. + </para> + </section> + + <section> + <title>AFlags/BFlags - the ZZZ Flag</title> + <para> + The 3-bit ``ZZZ'' flag indicates the compression, if any, of the object Attributes (or Body): + </para> + <table frame='all'> + <title>ZZZ Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>ZZZ Bits</entry> + <entry>Compression Algorithm</entry> + </row> + </thead> + <tbody> + <row> + <entry>000</entry> + <entry>None</entry> + </row> + <row> + <entry>001</entry> + <entry>GNU GZIP</entry> + </row> + <row> + <entry>010</entry> + <entry>Burroughs-Wheeler</entry> + </row> + <row> + <entry>011</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>100</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>101</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>110</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>111</entry> + <entry>Reserved</entry> + </row> + </tbody> + </tgroup> + </table> + </section> + </section> + + <section> + <title>Object Type</title> + <para> + The Object_Type element is always 16 bits wide, organized into two 8-bit-wide + fields: the Major_Type and the Minor_Type. + </para> + <table frame='all'> + <title>Object_Type Element Structure</title> + <tgroup cols='16' align='center'> + <colspec colname='0'/> + <colspec colname='1'/> + <colspec colname='2'/> + <colspec colname='3'/> + <colspec colname='4'/> + <colspec colname='5'/> + <colspec colname='6'/> + <colspec colname='7'/> + <colspec colname='8'/> + <colspec colname='9'/> + <colspec colname='10'/> + <colspec colname='11'/> + <colspec colname='12'/> + <colspec colname='13'/> + <colspec colname='14'/> + <colspec colname='15'/> + <thead> + <row> + <entry namest='0' nameend='15' align='center'>Object_Type</entry> + </row> + </thead> + <tbody> + <row> + <entry namest='0' nameend='7' align='center'>Major Type</entry> + <entry namest='8' nameend='15' align='center'>Minor Type</entry> + </row> + <row> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + Each different Major_Type value is assigned to a different class of database objects. + The following values are defined in this specification: + </para> + <table frame='all'> + <title>Major_Type Values and Meanings</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Value</entry> + <entry>Object Class</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>1</entry> + <entry>BRL-CAD Nongeometry Objects</entry> + </row> + <row> + <entry>2</entry> + <entry>BRL-CAD Geometry Objects</entry> + </row> + <row> + <entry>3</entry> + <entry>Attribute-Only Objects</entry> + </row> + <row> + <entry>8</entry> + <entry>Experimental Binary Objects (Unrecorded Structure) (Minor Type Unspecified)</entry> + </row> + <row> + <entry>9</entry> + <entry>Uniform Array Binary Objects, (Type Described in Minor Type)</entry> + </row> + <row> + <entry>10</entry> + <entry>MIME_Typed Binary Objects (Attribute "mime_type" Describes Format)</entry> + </row> + <row> + <entry>16-31</entry> + <entry>Registered-Type Binary Objects</entry> + </row> + <row> + <entry>128</entry> + <entry>First Non-ARL Type Begins Here</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The remainder are available for extending the types of objects that may be stored in + the database, allowing BRL-CAD users to extend the database for their own particular + purposes far beyond what the "attribute" method permits. + </para> + + <section> + <title>Major_Type = 0: Reserved</title> + <para> + Major Type 0 is illegal. The rationale is to provide the library an opportunity to + detect incompletely filled in data structures. + </para> + </section> + + <section> + <title>Major_Type = 1: BRL-CAD Nongeometry Objects</title> + <para> + This class of objects is private to librt, concerning all nongeometric objects needed by + the library. For this Major_Type, the following Minor_Type values are defined: + </para> + <table frame='all'> + <title>Major_Type = 1: Minor_Type Values and Meanings</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Minor_Type Value</entry> + <entry>Object Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Reserved for sanity check</entry> + </row> + <row> + <entry>1</entry> + <entry>Combination</entry> + </row> + <row> + <entry>2</entry> + <entry>Grip (Nongeometric)</entry> + </row> + <row> + <entry>3</entry> + <entry>Joint (Nongeometric)</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + All other values reserved for future expansion. + </para> + <para> + ?????Should "Grip" and "Joint" objects be of this type, or Major_Type = 2? + </para> + </section> + + <section> + <title>Major_Type = 2: BRL-CAD Geometry Objects</title> + <para> + This class of objects is private to librt, concerning all geometric objects needed + by the library. Typically, there will be one xxx/xxx.c module in librt for each minor type. + For this Major_Type, the following Minor_Type values are defined: + </para> + <table frame='all'> + <title>Major_Type = 2: Minor_Type Values and Meanings</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Minor_Type Value</entry> + <entry>Object Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Reserved for sanity check</entry> + </row> + <row> + <entry>1</entry> + <entry>Torus (TOR)</entry> + </row> + <row> + <entry>2</entry> + <entry>Truncated General Cone (TGC)</entry> + </row> + <row> + <entry>3</entry> + <entry>Ellipsoid (ELL)</entry> + </row> + <row> + <entry>4</entry> + <entry>Generalized ARB. V + 7 vectors</entry> + </row> + <row> + <entry>5</entry> + <entry>ARS</entry> + </row> + <row> + <entry>6</entry> + <entry>Half-Space (HALF)</entry> + </row> + <row> + <entry>7</entry> + <entry>Right Elliptical Cylinder (REC) (TGC special case)</entry> + </row> + <row> + <entry>8</entry> + <entry>Polygonal facted object (Polysolid)</entry> + </row> + <row> + <entry>9</entry> + <entry>B-Spline Solid</entry> + </row> + <row> + <entry>10</entry> + <entry>Sphere (ELL Special Case)</entry> + </row> + <row> + <entry>11</entry> + <entry>n-Manifold Geometry (NMG) solid</entry> + </row> + <row> + <entry>12</entry> + <entry>Extruded bitmap solid</entry> + </row> + <row> + <entry>13</entry> + <entry>Volume (VOL)</entry> + </row> + <row> + <entry>14</entry> + <entry>ARB with N faces (ARBN)</entry> + </row> + <row> + <entry>15</entry> + <entry>Pipe (wire) solid (PIPE)</entry> + </row> + <row> + <entry>16</entry> + <entry>Particle system solid (PART)</entry> + </row> + <row> + <entry>17</entry> + <entry>Right Parabolic Cylinder (RPC)</entry> + </row> + <row> + <entry>18</entry> + <entry>Right Hyperbolic Cylinder (RHC)</entry> + </row> + <row> + <entry>19</entry> + <entry>Elliptical Paraboloid (EPA)</entry> + </row> + <row> + <entry>20</entry> + <entry>Elliptical Hyperboloid (EHY)</entry> + </row> + <row> + <entry>21</entry> + <entry>Elliptical Torus (ETO)</entry> + </row> + <row> + <entry>22</entry> + <entry>Grip Nongeometric</entry> + </row> + <row> + <entry>23</entry> + <entry>Joint Nongeometric</entry> + </row> + <row> + <entry>24</entry> + <entry>Height Field (HF)</entry> + </row> + <row> + <entry>25</entry> + <entry>Displacement Map (DSP)</entry> + </row> + <row> + <entry>26</entry> + <entry>2D Sketch (SKETCH)</entry> + </row> + <row> + <entry>27</entry> + <entry>Solid of extrusion (EXTRUDE)</entry> + </row> + <row> + <entry>28</entry> + <entry>Instanced submodel</entry> + </row> + <row> + <entry>29</entry> + <entry>FASTGEN4 CLINE solid</entry> + </row> + <row> + <entry>30</entry> + <entry>Bag o' triangles (BOT)</entry> + </row> + <row> + <entry>31</entry> + <entry>Combination Record</entry> + </row> + <row> + <entry>32</entry> + <entry>Experimental binary</entry> + </row> + <row> + <entry>33</entry> + <entry>Uniform-array binary</entry> + </row> + <row> + <entry>34</entry> + <entry>MIME-typed binary</entry> + </row> + <row> + <entry>35</entry> + <entry>Superquadratic ellipsoid</entry> + </row> + <row> + <entry>36</entry> + <entry>Metaball</entry> + </row> + <row> + <entry>37</entry> + <entry>Brep object</entry> + </row> + <row> + <entry>38</entry> + <entry>Hyperboloid of one sheet (HYP)</entry> + </row> + <row> + <entry>39</entry> + <entry>Constraint object</entry> + </row> + <row> + <entry>40</entry> + <entry>Solid of revolution</entry> + </row> + <row> + <entry>41</entry> + <entry>Collection of points (PNTS)</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The details of these Minor_Types are provided in Section IV. + </para> + </section> + + <section> + <title>Major_Type = 3: Attribute-Only Objects</title> + <para> + This type of object stores only attributes in the object interior section; it has no + object body elements. + </para> + <para> + For example, if several objects need to have the same shader parameters, it would be + possible to create one attribute-only object to hold these common attributes and serve as a + simple form of "macro". Objects that needed to share these attributes could all reference the + same attribute object. If the attribute object is altered, then all of the objects that + reference it would be updated together. Without this capability, the user would have to + update each element individually to alter the attributes. + </para> + <para> + Conventions will have to be established regarding which attributes of an attribute-only + object will be used when a macro reference is performed. For example, rt shaders will + only be interested in the value of the "oshader=" attribute, while librt's tree-walker + might also be interested in the "rgb=", "giftmater=", "nsn=", "material=", and "los=" + attributes (assuming that a convention was developed so that a combination could + macro-reference an attribute-only object too). + </para> + <para> + An attribute-only object may not have an object body; thus, flag bit B must always be + zero for this type of object. + </para> + <para> + As used by the rt family of applications codes, these attribute-only objects will + contain "macros" for shaders. The shader name and its parameters shall be encoded as a + single ASCII string, which is the value of the "oshader=" attribute. An rt shader named + "macro" (or equivalent) would take a single parameter "obj=", which would specify the + name of the attribute-only object in the database from which the actual shader and + shader parameter information would be extracted. + </para> + <para> + There will be one attribute-only object with a reserved object name of "_GLOBAL" that + will be used to contain various kinds of states that are global to the entire ".g" database + and that had previously been found in the database header itself. There will be the + following BRL-CAD-specific attributes whose meaning is predefined for the _GLOBAL object: + <itemizedlist> + <listitem> + <para> + title = The database "title" string previously found in the database header. + </para> + </listitem> + <listitem> + <para> + units = The most recent editing units, specified as an ASCII string with a + floating point conversion factor. For example, the conversion factor for inches + to millimeters would be 25.4. + </para> + </listitem> + <listitem> + <para> + regionid_colortable = A string that contains a collection of all the information + previously found in "struct material_rec ID_MATERIAL" records. Exact encoding yet + to be determined; it's a collection of integer 5-tuples of the form: + {low, high, r, g, b}. + </para> + </listitem> + </itemizedlist> + </para> + <para> + In addition, the "comment=" attribute of the "_GLOBAL" object may be used to store + human-readable remarks about the database that are not more properly associated with a + specific database item. These might include remarks about data sources, model evolution, + security classification, and release restrictions. In the absense of some outboard + revision-control system, this might also be a place to record modification history, + although such use is discouraged. + </para> + </section> + + <section> + <title>Bulk Binary Objects (Major_Types 8-31)</title> + <para> + This class of objects contains various "bulk" binary data that might otherwise have + been placed in auxiliary files. + </para> + <para> + MGED and standalone commands must be built to store/extract these opaque?? binary + objects between a ".g" file and stdin/stdout/auxiliary files. A user might want to use + those same MGED commands to store/extract the binary object body of any object for external + processing. An easy example to imagine is the importing and exporting of texture maps for + external processing, but the same commands could be used for importing and exporting + solid parameters in their external binary form. + </para> + <para> + These objects may be referenced in combination nodes, for organizational purposes, but + they cannot be drawn in MGED or raytraced, and doing so would result in a warning message + being printed by the tree walker as that arc is traversed. This class may be used by all + applications and layers. + </para> + <para> + The data's purpose may be placed in the "purpose=" attribute. (????????Need a + table/registry of presently known values for this attribute.) + </para> + <para> + Routines that retrieve bulk binary objects should check the minor type and the + "purpose=" attribute and send a warning message in the event of a mismatch, but + best-effort processing of the object should continue. This will permit some degree + of error checking, which should benefit novice users without standing in the way of + "creatively" reusing one set of data, (e.g., using one array of values as both a height + field and a bwtexture). This allows common data perversion practices, such as interpreting + an array of floats as an array of bytes, to continue. + </para> + <para> + Each application will need to have its own syntax for the user to specify whether the data + source is an outboard file or a raw-binary object. For example, the current RT sh_texture + module uses the keyword file="name" to indicate an outboard file; that might be supplemented + with an additional obj="name" possibility for retrieving from an inboard raw-binary object. + </para> + + <section> + <title>Major_Type = 8: Experimental Binary Objects</title> + <para> + This class of objects contains bulk binary data and is intended for experimental + use by applications developers. Each time a database containing objects of this type + is opened, BRL-CAD will issue a user-visible warning. Production software and databases + should not use these objects. Developers should obtain registered 16-bit object types + from the website in order to avoid collisions with other applications. + </para> + </section> + <section> + <title>Major_Type = 9: Uniform Array Binary Objects</title> + <para> + This class of objects contain various "bulk" binary data that might otherwise have + been placed in an auxiliary file. + </para> + <para> + Point of Discussion?????Has ramifications... we have to implement type advising, so + that applications that use these data can compare the type provided in the minor + type code with the type that they're expecting and advise the user (with a warning + message) that there is a potential type mismatch. + </para> + <table frame='all'> + <title>Uniform Array Binary Objects Minor_Type Structure</title> + <tgroup cols='8' align='center'> + <colspec colname='h1'/> + <colspec colname='h2'/> + <colspec colname='h3'/> + <colspec colname='h4'/> + <colspec colname='h5'/> + <colspec colname='h6'/> + <colspec colname='h7'/> + <colspec colname='h8'/> + <thead> + <row> + <entry namest='h1' nameend='h8' align='center'>Minor_Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>7</entry> + <entry>6</entry> + <entry>5</entry> + <entry>4</entry> + <entry>3</entry> + <entry>2</entry> + <entry>1</entry> + <entry>0</entry> + </row> + <row> + <entry>r</entry> + <entry>r</entry> + <entry namest='h3' nameend='h4'>Wid</entry> + <entry>S</entry> + <entry namest='h6' nameend='h8'>Atom</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The 3-bit ``Atom'' flag indicates the fundamental data type of the atomic elements + in the array according to the following scheme: + </para> + <table frame='all'> + <title>Atom Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Atom Bits</entry> + <entry>Data Type</entry> + </row> + </thead> + <tbody> + <row> + <entry>000</entry> + <entry>Reserved for sanity check</entry> + </row> + <row> + <entry>001</entry> + <entry>Reserved</entry> + </row> + <row> + <entry>010</entry> + <entry>float (IEEE, network order)</entry> + </row> + <row> + <entry>011</entry> + <entry>double (IEEE, network order)</entry> + </row> + <row> + <entry>100</entry> + <entry>8-bit int</entry> + </row> + <row> + <entry>101</entry> + <entry>16-bit int</entry> + </row> + <row> + <entry>110</entry> + <entry>32-bit int</entry> + </row> + <row> + <entry>111</entry> + <entry>64-bit int</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The ``S'' bit indicates whether an integer type is signed (1) or unsigned (0). + Floats and doubles (i.e., atomic types with the highest atom bit equal to 0) are + explicitly signed, so they will have the ``S'' bit equal to 1. (The bit patterns + corresponding to unsigned floats and doubles are reserved for possible other use.) + </para> + <para> + The 2-bit ``Wid'' flag specifies the length (in atomic elements) of the array elements: + </para> + <table frame='all'> + <title>Wid Flag Definitions</title> + <tgroup cols='2' align='center'> + <thead> + <row> + <entry>Wid Bits</entry> + <entry>Atoms per Array Element</entry> + </row> + </thead> + <tbody> + <row> + <entry>00</entry> + <entry>1</entry> + </row> + <row> + <entry>01</entry> + <entry>2</entry> + </row> + <row> + <entry>10</entry> + <entry>3</entry> + </row> + <row> + <entry>11</entry> + <entry>4</entry> + </row> + </tbody> + </tgroup> + </table> + <para> + The remaining Minor_Type bits ``r'' are reserved for the design committee to use for + other purposes, possibly including extensions of the ``Atom'' and/or ``Wid'' flags. + </para> + <para> + As examples, data in PIX(5) format, which might be used for a texture map, would + have Minor_Type ``0010 0100'', indicating a triple of unsigned char, and CMYK data + might be stored with Minor_Type ``0011 1011'', indicating a quadruple of doubles. + </para> + <para> + The data's purpose (e.g., height field, texture, bump, displacement, etc.) may be + placed in the "purpose=" attribute. ?????Point of Discussion???(Need a table/registry + of presently known values for this attribute.) + </para> + </section> + <section> + <title>Major_Type = 10: MIME-Typed Binary Objects</title> + <para> + This class of objects contains data, the format of which is specified in the + attribute "mime_type". The Minor_Type of these objects should always be zero. + </para> + </section> + <section> + <title>Major_Type = 16-31: Registered-Type Binary Objects</title> + <para> + This class of objects contains application-specific bulk binary data and is intended + for use in production software and databases. Developers can obtain registered 16-bit + object types from the website to identify these objects. The data's purpose, (e.g. height + field, texture, bump, displacement, etc.) may be placed in the "purpose=" attribute. + (Need a table/registry of presently known values for this attribute). + </para> + </section> + </section> + + <section> + <title>Major_Type = 255: Database Layer Internal Objects</title> + <para> + A Minor_Type of 1 indicates that this is a contiguous block of free storage. + </para> + <para> + A Minor_Type of 2 indicates that this is a database header. + </para> + </section> + + </section> + + <section> + <title>Object Length</title> + <para> + The Object Length specifies the number of 8-byte chunks used to store an object. This includes all bytes + from Magic1 through Magic2, inclusive. + </para> + </section> + + <section> + <title>Object Name</title> + <para> + The Object_Name element is a string that holds a name unique to that object and drawn from a name space that + is global to the database. The Object_Name element is mandatory for all allocated storage in the database. + Database free-space managment objects are the only objects for which the Object_Name element is optional. + </para> + <para> + The name is specified in 8-bit ASCII. There is no support for UNICODE. The name is null-terminated, and the + null byte is included in Name_Length. + </para> + <para> + See the section on DLI flags. In the case of Free objects, the name is not retained. Undeleted objects have + a different DLI flag code. + </para> + </section> + + <section> + <title>Object Attributes</title> + <para> + An object may optionally have an Object_Attributes element, which stores an association list + <literallayout> +aname1=value1, aname2=value2, ..., anameN=valueN + </literallayout> + binding attributes to values. + </para> + <para> + These are ASCII strings of unlimited length. These attributes are intended for direct use by programs. + There will be a WWW registry of attribute names presently in use to prevent two application developers + from using the same attribute_name for different purposes. + </para> + <para> + For attribute names and attribute values, The decision was taken to support 8-bit ASCII only. The + on-disk encoding of this will simply be: + <literallayout> +aname1 NULL value1 NULL ... anameN NULL valueN NULL NULL + </literallayout> + where NULL represents a byte with all bits zero. The NULL in place of anameN+1 signals the end of the + attribute data, simplifying the job of the reader. + </para> + <para> + Every object in the database may have zero or more attributes attached to it; the meaning of these attributes + will vary depending on which application or library processes them. + </para> + <para> + There are several aname conventions that all BRL-CAD applications are expected to respect. There will be a + WWW extendable registry of "in-use" anames, so that independent applications developers may select aname + strings for their own use without fear of name conflicts later. The initial registry would include: + <itemizedlist> + <listitem> + <para> + comment = Every object may optionally have a comment that contains a string of an arbitrary number of + newline-terminated lines of text. These are strings for use by humans only. None of the BRL-CAD software + may parse or interpret these strings other than to print them and edit them when requested by the user. + They are provided for the modeler to place notes in. + </para> + </listitem> + <listitem> + <para> + nsn = The American National Stock Number (NSN) for this part, when known. + </para> + </listitem> + <listitem> + <para> + material = The format of this string is not currently defined as there are conflicting naming/coding + conventions employed by the various standards organizations (e.g., ISO, ASME, etc.). + </para> + </listitem> + <listitem> + <para> + region = For combinations, indicates this combination is a region. Boolean. + </para> + </listitem> + <listitem> + <para> + inherit = For combinations, indicates whether attributes from lower combinations in tree will replace + higher ones. Boolean, default=0. + </para> + </listitem> + <listitem> + <para> + oshader = For combinations, read by the "rt" program, optical shader name and parameter string (separated + from each other by white space). Meaningful only at or above a region node, and only on a combination, or + in an attribute-only "macro". + </para> + </listitem> + <listitem> + <para> + rgb = For combinations, when present indicates optical rgb color is specified. + </para> + </listitem> + <listitem> + <para> + region_id = For regions, GIFT compatability. Integer. + </para> + </listitem> + <listitem> + <para> + giftmater = For regions, GIFT compatability. Integer. (Point of Discussion?????Should we use negative values for + air codes, positive for nonair, so we can eliminate air codes?) + </para> + </listitem> + <listitem> + <para> + aircode = For regions, air code. Integer. 0 is the same as attribute not specified. (Point of + Discussion?????Possibly eliminated in favor of negative giftmater values). + </para> + </listitem> + <listitem> + <para> + los = For regions, GIFT compatability. Integer. + </para> + </listitem> + <listitem> + <para> + component = For regions, the name of the MUVES component containing this object. + </para> + </listitem> + <listitem> + <para> + rlist = The proposed BRL-CAD "replacement list" field would be stored on a binary-block attribute + ("rlist="). [deferred implementation] + </para> + </listitem> + <listitem> + <para> + macro = If present, specifies name of an attribute-only object to be consulted for additional attribute values. + </para> + </listitem> + </itemizedlist> + + All other attributes, from whatever source, would be stored similarly, including application-specific and + end-user-created attributes. + </para> + </section> + <section> + <title>Object Body</title> + <para> + The contents of the Object Body are opaque?? to the databaase layer. The contents of this element are interpreted + based upon the Object_Type. The Object_Body is not constrained to start on a chunk boundary. + </para> + </section> + + <section> + <title>Padding and Length Rounding</title> + <para> + The minimal object is a Free object (with no name) 8 bytes long: + <literallayout> + Magic1 (1byte) + HFlags = 000xxxxx (1 byte) + AFlags = 0000xx00 (1 byte) + BFlags = 0000xx00 (1 byte) + ObjType = Free (2 bytes) + ObjLen = 7 (1 byte) + Magic2 (1 byte). + </literallayout> + This is why we have chosen the 8-bit size for our chunks. Pad bytes are inserted as necessary in the Object Footer + immediately before the second magic number so that the final byte of the object is the Magic2 byte. The pad bytes are + not counted as part of the Body_Length, but are counted as part of the Object_Length. + </para> + <para> + The minimal valid object is thus the following Free object: + <literallayout> +Magic1 (1byte) +HFlags = 00000010 (1 byte), Wid=00, N=0, DLI=02 +IFlags????? = 00000000 (1 byte), Wid=00, A=0, B=0, ZZZ=000 +Object_Type = RESERVED (2 bytes) +Object_Length = 1 (1 byte) +Pad (1byte) +Magic2 (1 byte). + </literallayout> + </para> + <para> + The header of the database will always look like this: + <literallayout> +Magic1 (1byte) +HFlags = 000xxx01 (1 byte), Wid=00, N=0, DLI=01 +IFlags????? = 0000x000 (1 byte), Wid=00, A=0, B=0, ZZZ=000 +Object_Type = RESERVED (2 bytes) +Object_Length = 1 (1 byte) +Pad (1byte) +Magic2 (1 byte) +The hex and ASCII dump of this object would look something this: + +76 01 00 00 00 01 00 35 |v......5| + </literallayout> + </para> + <para> + The minimal valid allocated database storage object (with an Object_Name, no Object_Attributes or Object_Body) would thus be: + <literallayout> +Magic1 (1byte) +HFlags = 001xxxxx (1 byte), Wid=00, N=1, DLI=00 +IFlags ?????= 0000xxxx (1 byte), Wid=00, A=0, B=0, ZZZ=000 +Object_Type = OPAQUE?????_BINARY (2 bytes) +Object_Length = 8 (1 byte) +Name_Length = 2 (1 byte) +Object Name (1 character + null byte) (2 bytes) +Pad (6 bytes) +Magic2 (1 byte). + </literallayout> + </para> + <para> + Without the padding, this (rather useless) object would be 10 bytes long. Given the rounding requirements, it is clear that all allocated storage objects in the database must be at least 16 bytes long. A database object with a minimal Object_Body would need 12 bytes, which would need to be padded out to 16 bytes as well: + <literallayout> +Magic1 (1 byte) +HFlags = 001xxxxx (1 byte) +IFlags???? = 00x1xxxx (1 byte) +Object Type (2 bytes) +Object Length = 16 (1 byte) +Name Length = 2 (1 byte) +Object Name (1 character + null byte) (2 bytes) +Body Length = 1 (1 byte) +Body Data (1 byte) +Pad (4 bytes) +Magic2 (1 byte). + </literallayout> + + </para> + <para> + <literallayout> + </literallayout> + </para> + <para> + <literallayout> + </literallayout> + </para> + <para> + <literallayout> + </literallayout> + </para> + + </section> + + + + <section> + <title>How Objects Are Grouped into a Database</title> + <para> + + </para> + </section> + <section> + <title>Details of BRL-CAD-Specific Nongeometric Database Object Types</title> + <para> + + </para> + </section> + <section> + <title>Details of BRL-CAD-Specific Geometric Database Object Types</title> + <para> + + </para> + </section> + <section> + <title>Extensions for Deferred Implementation</title> + <para> + + </para> + </section> + <section> + <title>Community Feedback on the Proposal</title> + <para> + + </para> + </section> + <section> + <title>Database Library Application Programming Interface (API)</title> + <para> + + </para> + </section> +</section> +</article> Property changes on: brlcad/trunk/doc/docbook/specifications/en/BRL_CAD_g_format_V5.xml ___________________________________________________________________ Added: svn:mime-type + text/xml Added: svn:eol-style + native This was sent by the SourceForge.net collaborative development pl... [truncated message content] |
From: <br...@us...> - 2009-10-22 15:03:29
|
Revision: 36245 http://brlcad.svn.sourceforge.net/brlcad/?rev=36245&view=rev Author: brlcad Date: 2009-10-22 15:03:19 +0000 (Thu, 22 Oct 2009) Log Message: ----------- ignore the generated directories Property Changed: ---------------- brlcad/trunk/doc/docbook/ brlcad/trunk/doc/docbook/articles/ brlcad/trunk/doc/docbook/books/ brlcad/trunk/doc/docbook/lessons/ Property changes on: brlcad/trunk/doc/docbook ___________________________________________________________________ Modified: svn:ignore - .deps .libs Makefile Makefile.in tutorials + .deps .libs Makefile Makefile.in Property changes on: brlcad/trunk/doc/docbook/articles ___________________________________________________________________ Modified: svn:ignore - Makefile.in Makefile + Makefile Makefile.in build_pattern build_region ebm_primitive mgedrc nirt oed pipes projection_shader tire Property changes on: brlcad/trunk/doc/docbook/books ___________________________________________________________________ Modified: svn:ignore - Makefile.in Makefile + Makefile Makefile.in tutorial_series Property changes on: brlcad/trunk/doc/docbook/lessons ___________________________________________________________________ Modified: svn:ignore - Makefile.in Makefile + Makefile Makefile.in mged This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2009-10-30 14:59:47
|
Revision: 36356 http://brlcad.svn.sourceforge.net/brlcad/?rev=36356&view=rev Author: starseeker Date: 2009-10-30 14:59:37 +0000 (Fri, 30 Oct 2009) Log Message: ----------- Don't put an empty directory in the svn repository - will re-enable this logic once there are actual specification images. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Removed Paths: ------------- brlcad/trunk/doc/docbook/specifications/en/images/ Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-10-30 13:51:27 UTC (rev 36355) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-10-30 14:59:37 UTC (rev 36356) @@ -371,8 +371,6 @@ specificationsDOCBOOK_EN = \ specifications/en/BRL_CAD_g_format_V5.xml -specificationsDOCBOOK_EN_IMAGES = - specificationsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/specifications/en specificationsDOCBOOK_ENhtml_DATA = \ $(BUILTSPECS_ENHTML) @@ -380,14 +378,6 @@ BUILTSPECS_ENHTML = \ ${specificationsDOCBOOK_EN:xml=html} -specificationsDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/specifications/en/images -specificationsDOCBOOK_ENhtmlimages_DATA = \ - $(BUILTSPECS_ENIMAGES) - -BUILTSPECS_ENIMAGES = \ - ${specificationsDOCBOOK_EN_IMAGES:docpng=png} - - if BUILD_PDF_DOCS BUILTSPECS_ENPDF = ${specificationsDOCBOOK_EN:xml=pdf} @@ -540,7 +530,6 @@ ${lessonsDOCBOOK_EN} \ ${man1DOCBOOK_EN} \ ${man1INTRO_EN} \ - ${specificationsDOCBOOK_EN_IMAGES} \ ${specificationsDOCBOOK_EN} \ README \ articles/en/images/tire_fig12.svg \ @@ -548,7 +537,6 @@ books/README \ books/en/tutorial_series_authors.xml \ catalog.xml \ - html/specifications/en/images \ resources \ system/man1/README \ system/man1/mged_cmd_template.xml This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2009-11-17 02:02:03
|
Revision: 36504 http://brlcad.svn.sourceforge.net/brlcad/?rev=36504&view=rev Author: starseeker Date: 2009-11-17 02:01:44 +0000 (Tue, 17 Nov 2009) Log Message: ----------- rename all the docbook png images to have the correct suffix. Added Paths: ----------- brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig01.png brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig02.png brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig03.png brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig04.png brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig05.png brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig06.png brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig07.png brlcad/trunk/doc/docbook/articles/en/images/build_region_fig01.png brlcad/trunk/doc/docbook/articles/en/images/build_region_fig02.png brlcad/trunk/doc/docbook/articles/en/images/build_region_fig03.png brlcad/trunk/doc/docbook/articles/en/images/build_region_fig04.png brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig01.png brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig02.png brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig03.png brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.png brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig01.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig02.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig03.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig04.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig05.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig06.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig07.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig08.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig09.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig10.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig11.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig12.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig13.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig14.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig15.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig16.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig17.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig18.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig19.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig20.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig21.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig22.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig23.png brlcad/trunk/doc/docbook/articles/en/images/nirt_fig24.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig01.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig02.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig03.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig04.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig05.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig06.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig07.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig08.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig09.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig10.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig11.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig12.png brlcad/trunk/doc/docbook/articles/en/images/oed_fig13.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig01.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig02.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig03.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig04.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig05.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig06.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig07.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig08.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig09.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig10.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig11.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig12.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig13.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig01.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig02.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig03.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig04.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig05.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig06.png brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig07.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig01.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig02.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig03.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig04.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig05.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig06.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig07.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig08.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig09.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig10.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig11.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig12.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig13.png brlcad/trunk/doc/docbook/articles/en/images/tire_fig14.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig01.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig02.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig03.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig04.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig05.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig06.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig07.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig08.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig09.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig10.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig11.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig12.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig13.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig14.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig15.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig16.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig17.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig18.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig19.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig20.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig21.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig22.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig23.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig24.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig25.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig26.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig27.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig28.png brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig29.png brlcad/trunk/doc/docbook/lessons/en/images/mged01_commandwindow.png brlcad/trunk/doc/docbook/lessons/en/images/mged01_graphicswindow.png brlcad/trunk/doc/docbook/lessons/en/images/mged01_terminal.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_coordsys.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_defaultradio.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomin.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomout.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_multipane.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_35_25.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_right.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_top.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_0_0_14.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_270_-90.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_270_90.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_0.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_25.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_60.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_90.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_left.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_rear.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_right.png brlcad/trunk/doc/docbook/lessons/en/images/mged04_commandwindow.png brlcad/trunk/doc/docbook/lessons/en/images/mged04_fb_overlay_mode.png brlcad/trunk/doc/docbook/lessons/en/images/mged04_raytracedshapes.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_combinationeditor.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_intersectionspheres.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytraceddome.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytracedpart1.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytracedpart2.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytracedpart3.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_subtractionspheres.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_twoprimitivespheres.png brlcad/trunk/doc/docbook/lessons/en/images/mged05_unionspheres.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_base_substracted_vol.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_goblet1stsphere.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_gobletbase.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_gobletbasestembasin.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_gobletstem.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_rtgoblet.png brlcad/trunk/doc/docbook/lessons/en/images/mged06_rtgobletaz_35_el_25.png brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_complete_window.png brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_mater_complete.png brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_mirror.png brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_semitransparent.png brlcad/trunk/doc/docbook/lessons/en/images/mged08_comb_editor_window_mater_prop.png brlcad/trunk/doc/docbook/lessons/en/images/mged08_goblet_combeditor.png brlcad/trunk/doc/docbook/lessons/en/images/mged08_goblet_reflectivity_1.png brlcad/trunk/doc/docbook/lessons/en/images/mged08_goblet_reflectivity_2.png brlcad/trunk/doc/docbook/lessons/en/images/mged08_refractive_index.png brlcad/trunk/doc/docbook/lessons/en/images/mged08_spec_vs_diff_reflectivity.png brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_base_box_raytraced.png brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_base_box_wireframe.png brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_inside_outside_box.png brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_outside_display_box.png brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_raytraced.png brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_wireframe.png brlcad/trunk/doc/docbook/lessons/en/images/mged10_mug_wireframe.png brlcad/trunk/doc/docbook/lessons/en/images/mged11_mug_raytraced_norim.png brlcad/trunk/doc/docbook/lessons/en/images/mged11_mug_raytraced_rim.png brlcad/trunk/doc/docbook/lessons/en/images/mged12_cyls_frontview.png brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_gui_finished_raytraced.png brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_handle_frontview.png brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_handle_topview.png brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_rim_frontview.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_comb_ed_checker.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_complete_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_design.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_raytraced_overlay.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_base_candle_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_base_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_eto1_rcc_wireframe_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_eto1_wireframe_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_wireframe_front.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_base_sphere_topview.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_multipane.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_az35el25.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_frontview.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_raytraced.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_topview.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_primitive_editor.png brlcad/trunk/doc/docbook/lessons/en/images/mged14_primitive_selection_dropdown.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_cameo_shader.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_prim_ed_wheel_well.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_2nd_wheel_wheel_place.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_ambient_lighting.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_cab1s.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_cab_body.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_cab_cutoff.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_default_lighting.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_design.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_multipane_1stwheel.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_wheel_wells_wireframe.png brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_wheels.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_casecut_raytrace.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_cut_raytrace.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_cut_wireframe.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_default_components_props.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_new_design.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_transparent.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_wireframe_circ_board.png brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_with_mater_props.png Removed Paths: ------------- brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig05.docpng brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig06.docpng brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig07.docpng brlcad/trunk/doc/docbook/articles/en/images/build_region_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/build_region_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/build_region_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/build_region_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig05.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig06.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig07.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig08.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig09.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig10.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig11.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig12.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig13.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig14.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig15.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig16.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig17.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig18.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig19.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig20.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig21.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig22.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig23.docpng brlcad/trunk/doc/docbook/articles/en/images/nirt_fig24.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig05.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig06.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig07.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig08.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig09.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig10.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig11.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig12.docpng brlcad/trunk/doc/docbook/articles/en/images/oed_fig13.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig05.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig06.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig07.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig08.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig09.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig10.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig11.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig12.docpng brlcad/trunk/doc/docbook/articles/en/images/pipes_fig13.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig05.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig06.docpng brlcad/trunk/doc/docbook/articles/en/images/projection_shader_fig07.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig01.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig02.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig03.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig04.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig05.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig06.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig07.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig08.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig09.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig10.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig11.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig12.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig13.docpng brlcad/trunk/doc/docbook/articles/en/images/tire_fig14.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig01.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig02.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig03.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig04.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig05.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig06.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig07.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig08.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig09.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig10.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig11.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig12.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig13.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig14.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig15.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig16.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig17.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig18.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig19.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig20.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig21.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig22.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig23.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig24.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig25.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig26.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig27.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig28.docpng brlcad/trunk/doc/docbook/books/en/images/tutorial_series_volIII_fig29.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged01_commandwindow.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged01_graphicswindow.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged01_terminal.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_coordsys.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_defaultradio.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomin.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomout.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_multipane.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_35_25.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_right.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_radio_top.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_0_0_14.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_270_-90.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_270_90.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_0.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_25.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_60.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_35_90.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_left.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_rear.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged02_truck_right.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged04_commandwindow.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged04_fb_overlay_mode.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged04_raytracedshapes.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_combinationeditor.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_intersectionspheres.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytraceddome.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytracedpart1.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytracedpart2.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_raytracedpart3.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_subtractionspheres.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_twoprimitivespheres.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged05_unionspheres.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_base_substracted_vol.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_goblet1stsphere.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_gobletbase.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_gobletbasestembasin.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_gobletstem.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_rtgoblet.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged06_rtgobletaz_35_el_25.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_complete_window.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_mater_complete.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_mirror.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged07_goblet_semitransparent.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged08_comb_editor_window_mater_prop.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged08_goblet_combeditor.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged08_goblet_reflectivity_1.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged08_goblet_reflectivity_2.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged08_refractive_index.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged08_spec_vs_diff_reflectivity.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_base_box_raytraced.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_base_box_wireframe.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_inside_outside_box.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_outside_display_box.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_raytraced.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged09_globe_wireframe.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged10_mug_wireframe.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged11_mug_raytraced_norim.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged11_mug_raytraced_rim.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged12_cyls_frontview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_gui_finished_raytraced.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_handle_frontview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_handle_topview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged12_mug_rim_frontview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_comb_ed_checker.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_complete_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_design.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_raytraced_overlay.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_base_candle_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_base_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_eto1_rcc_wireframe_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_eto1_wireframe_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged13_candle_tabletop_wireframe_front.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_base_sphere_topview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_multipane.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_az35el25.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_frontview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_raytraced.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_candle_spheres_topview.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_primitive_editor.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged14_primitive_selection_dropdown.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_cameo_shader.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_prim_ed_wheel_well.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_2nd_wheel_wheel_place.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_ambient_lighting.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_cab1s.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_cab_body.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_cab_cutoff.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_default_lighting.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_design.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_multipane_1stwheel.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_wheel_wells_wireframe.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged15_truck_wheels.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_casecut_raytrace.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_cut_raytrace.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_cut_wireframe.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_default_components_props.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_new_design.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_transparent.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_wireframe_circ_board.docpng brlcad/trunk/doc/docbook/lessons/en/images/mged16_radio_with_mater_props.docpng Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig01.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig01.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig01.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig02.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig02.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig02.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig03.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig03.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig03.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig04.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig04.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig04.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig05.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig05.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig05.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig06.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig06.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig06.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig07.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig07.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_pattern_fig07.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig01.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig01.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig01.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig02.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig02.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig02.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig03.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig03.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig03.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig04.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig04.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/build_region_fig04.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig01.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig01.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig01.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig02.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig02.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig02.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig03.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig03.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/ebm_primitive_fig03.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig01.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig01.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig01.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig02.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig02.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig02.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig03.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig03.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig03.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig04.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig04.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig04.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig05.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig05.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig05.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig06.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig06.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig06.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig07.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig07.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig07.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig08.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig08.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig08.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig09.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig09.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig09.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig10.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig10.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig10.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig11.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig11.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig11.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig12.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig12.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig12.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig13.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig13.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig13.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig14.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig14.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig14.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig15.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig15.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig15.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig16.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig16.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig16.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig17.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig17.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig17.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig18.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig18.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig18.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig19.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig19.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig19.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig20.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig20.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig20.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig21.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig21.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig21.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig22.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig22.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig22.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig23.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig23.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig23.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig24.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig24.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/nirt_fig24.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig01.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig01.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig01.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig02.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig02.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig02.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig03.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig03.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig03.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig04.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig04.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig04.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig05.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig05.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig05.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig06.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig06.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig06.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig07.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig07.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig07.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig08.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig08.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig08.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig09.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig09.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig09.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig10.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig10.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig10.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig11.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig11.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig11.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig12.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig12.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig12.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/oed_fig13.docpng =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/articles/en/images/oed_fig13.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/oed_fig13.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Deleted: brlcad/trunk/doc/docbook/articles/en/images/pipes_fig01.docpng ================================================... [truncated message content] |
From: <sta...@us...> - 2009-12-08 18:32:55
|
Revision: 36839 http://brlcad.svn.sourceforge.net/brlcad/?rev=36839&view=rev Author: starseeker Date: 2009-12-08 18:32:43 +0000 (Tue, 08 Dec 2009) Log Message: ----------- Start splitting up and including Makefile components for docbook Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/articles/en/Makefile.am brlcad/trunk/doc/docbook/books/en/Makefile.am brlcad/trunk/doc/docbook/lessons/en/Makefile.am brlcad/trunk/doc/docbook/specifications/en/Makefile.am brlcad/trunk/doc/docbook/system/man1/en/Makefile.am Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-12-08 17:41:13 UTC (rev 36838) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-12-08 18:32:43 UTC (rev 36839) @@ -18,460 +18,16 @@ .xml.fo: XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) -o $@ $(XSL_FO_STYLESHEET) $? +include $(srcdir)/articles/en/Makefile.am -articlesDOCBOOK_EN = \ - articles/en/build_pattern.xml \ - articles/en/build_region.xml \ - articles/en/ebm_primitive.xml \ - articles/en/mgedrc.xml \ - articles/en/nirt.xml \ - articles/en/oed.xml \ - articles/en/pipes.xml \ - articles/en/projection_shader.xml \ - articles/en/tire.xml +include $(srcdir)/lessons/en/Makefile.am -articlesDOCBOOK_EN_IMAGES = \ - articles/en/images/build_pattern_fig01.png \ - articles/en/images/build_pattern_fig02.png \ - articles/en/images/build_pattern_fig03.png \ - articles/en/images/build_pattern_fig04.png \ - articles/en/images/build_pattern_fig05.png \ - articles/en/images/build_pattern_fig06.png \ - articles/en/images/build_pattern_fig07.png \ - articles/en/images/build_region_fig01.png \ - articles/en/images/build_region_fig02.png \ - articles/en/images/build_region_fig03.png \ - articles/en/images/build_region_fig04.png \ - articles/en/images/ebm_primitive_fig01.png \ - articles/en/images/ebm_primitive_fig02.png \ - articles/en/images/ebm_primitive_fig03.png \ - articles/en/images/mgedrc_fig02.png \ - articles/en/images/mgedrc_fig03.png \ - articles/en/images/nirt_fig01.png \ - articles/en/images/nirt_fig02.png \ - articles/en/images/nirt_fig03.png \ - articles/en/images/nirt_fig04.png \ - articles/en/images/nirt_fig05.png \ - articles/en/images/nirt_fig06.png \ - articles/en/images/nirt_fig07.png \ - articles/en/images/nirt_fig08.png \ - articles/en/images/nirt_fig09.png \ - articles/en/images/nirt_fig10.png \ - articles/en/images/nirt_fig11.png \ - articles/en/images/nirt_fig12.png \ - articles/en/images/nirt_fig13.png \ - articles/en/images/nirt_fig14.png \ - articles/en/images/nirt_fig15.png \ - articles/en/images/nirt_fig16.png \ - articles/en/images/nirt_fig17.png \ - articles/en/images/nirt_fig18.png \ - articles/en/images/nirt_fig19.png \ - articles/en/images/nirt_fig20.png \ - articles/en/images/nirt_fig21.png \ - articles/en/images/nirt_fig22.png \ - articles/en/images/nirt_fig23.png \ - articles/en/images/nirt_fig24.png \ - articles/en/images/oed_fig01.png \ - articles/en/images/oed_fig02.png \ - articles/en/images/oed_fig03.png \ - articles/en/images/oed_fig04.png \ - articles/en/images/oed_fig05.png \ - articles/en/images/oed_fig06.png \ - articles/en/images/oed_fig07.png \ - articles/en/images/oed_fig08.png \ - articles/en/images/oed_fig09.png \ - articles/en/images/oed_fig10.png \ - articles/en/images/oed_fig11.png \ - articles/en/images/oed_fig12.png \ - articles/en/images/oed_fig13.png \ - articles/en/images/pipes_fig01.png \ - articles/en/images/pipes_fig02.png \ - articles/en/images/pipes_fig03.png \ - articles/en/images/pipes_fig04.png \ - articles/en/images/pipes_fig05.png \ - articles/en/images/pipes_fig06.png \ - articles/en/images/pipes_fig07.png \ - articles/en/images/pipes_fig08.png \ - articles/en/images/pipes_fig09.png \ - articles/en/images/pipes_fig10.png \ - articles/en/images/pipes_fig11.png \ - articles/en/images/pipes_fig12.png \ - articles/en/images/pipes_fig13.png \ - articles/en/images/projection_shader_fig01.png \ - articles/en/images/projection_shader_fig02.png \ - articles/en/images/projection_shader_fig03.png \ - articles/en/images/projection_shader_fig04.png \ - articles/en/images/projection_shader_fig05.png \ - articles/en/images/projection_shader_fig06.png \ - articles/en/images/projection_shader_fig07.png \ - articles/en/images/tire_fig01.png \ - articles/en/images/tire_fig02.png \ - articles/en/images/tire_fig03.png \ - articles/en/images/tire_fig04.png \ - articles/en/images/tire_fig05.png \ - articles/en/images/tire_fig06.png \ - articles/en/images/tire_fig07.png \ - articles/en/images/tire_fig08.png \ - articles/en/images/tire_fig09.png \ - articles/en/images/tire_fig10.png \ - articles/en/images/tire_fig11.png \ - articles/en/images/tire_fig12.png \ - articles/en/images/tire_fig13.png \ - articles/en/images/tire_fig14.png +include $(srcdir)/books/en/Makefile.am -articlesDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/articles/en -articlesDOCBOOK_ENhtml_DATA = \ - $(BUILTARTICLES_ENHTML) +include $(srcdir)/specifications/en/Makefile.am -BUILTARTICLES_ENHTML = \ - ${articlesDOCBOOK_EN:xml=html} +include $(srcdir)/system/man1/en/Makefile.am -articlesDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/articles/en/images -articlesDOCBOOK_ENhtmlimages_DATA = \ - $(articlesDOCBOOK_EN_IMAGES) - -if BUILD_PDF_DOCS - -BUILTARTICLES_ENPDF = ${articlesDOCBOOK_EN:xml=pdf} - -endif - -articlesDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/articles/en -articlesDOCBOOK_ENpdf_DATA = $(BUILTARTICLES_ENPDF) - - - - - - -lessonsDOCBOOK_EN = \ - lessons/en/mged01_creating_primitive_shapes.xml \ - lessons/en/mged02_learning_viewing_options.xml \ - lessons/en/mged03_using_insert_command.xml \ - lessons/en/mged04_assign_mat_prop_rt.xml \ - lessons/en/mged05_learning_boolean_expressions.xml \ - lessons/en/mged06_creating_a_goblet.xml \ - lessons/en/mged07_goblet_material_properties.xml \ - lessons/en/mged08_goblet_material_properties2.xml \ - lessons/en/mged09_globe_in_display_box.xml \ - lessons/en/mged10_creating_mug.xml \ - lessons/en/mged11_refining_mug.xml \ - lessons/en/mged12_mug_through_gui.xml \ - lessons/en/mged13_placing_shapes_in_3d.xml \ - lessons/en/mged14_placing_shapes_in_3d_2.xml \ - lessons/en/mged15_creating_a_toy_truck.xml \ - lessons/en/mged16_mod_tech_struct.xml - -lessonsDOCBOOK_EN_IMAGES = \ - lessons/en/images/mged01_commandwindow.png \ - lessons/en/images/mged01_graphicswindow.png \ - lessons/en/images/mged01_terminal.png \ - lessons/en/images/mged02_coordsys.png \ - lessons/en/images/mged02_defaultradio.png \ - lessons/en/images/mged02_flower_zooomin.png \ - lessons/en/images/mged02_flower_zooomout.png \ - lessons/en/images/mged02_multipane.png \ - lessons/en/images/mged02_radio_35_25.png \ - lessons/en/images/mged02_radio_front.png \ - lessons/en/images/mged02_radio_right.png \ - lessons/en/images/mged02_radio_top.png \ - lessons/en/images/mged02_truck_0_0_14.png \ - lessons/en/images/mged02_truck_270_-90.png \ - lessons/en/images/mged02_truck_270_90.png \ - lessons/en/images/mged02_truck_35_0.png \ - lessons/en/images/mged02_truck_35_25.png \ - lessons/en/images/mged02_truck_35_60.png \ - lessons/en/images/mged02_truck_35_90.png \ - lessons/en/images/mged02_truck_front.png \ - lessons/en/images/mged02_truck_left.png \ - lessons/en/images/mged02_truck_rear.png \ - lessons/en/images/mged02_truck_right.png \ - lessons/en/images/mged04_commandwindow.png \ - lessons/en/images/mged04_fb_overlay_mode.png \ - lessons/en/images/mged04_raytracedshapes.png \ - lessons/en/images/mged05_combinationeditor.png \ - lessons/en/images/mged05_intersectionspheres.png \ - lessons/en/images/mged05_raytraceddome.png \ - lessons/en/images/mged05_raytracedpart1.png \ - lessons/en/images/mged05_raytracedpart2.png \ - lessons/en/images/mged05_raytracedpart3.png \ - lessons/en/images/mged05_subtractionspheres.png \ - lessons/en/images/mged05_twoprimitivespheres.png \ - lessons/en/images/mged05_unionspheres.png \ - lessons/en/images/mged06_base_substracted_vol.png \ - lessons/en/images/mged06_goblet1stsphere.png \ - lessons/en/images/mged06_gobletbase.png \ - lessons/en/images/mged06_gobletbasestembasin.png \ - lessons/en/images/mged06_gobletstem.png \ - lessons/en/images/mged06_rtgoblet.png \ - lessons/en/images/mged06_rtgobletaz_35_el_25.png \ - lessons/en/images/mged07_goblet_complete_window.png \ - lessons/en/images/mged07_goblet_mater_complete.png \ - lessons/en/images/mged07_goblet_mirror.png \ - lessons/en/images/mged07_goblet_semitransparent.png \ - lessons/en/images/mged08_comb_editor_window_mater_prop.png \ - lessons/en/images/mged08_goblet_combeditor.png \ - lessons/en/images/mged08_goblet_reflectivity_1.png \ - lessons/en/images/mged08_goblet_reflectivity_2.png \ - lessons/en/images/mged08_refractive_index.png \ - lessons/en/images/mged08_spec_vs_diff_reflectivity.png \ - lessons/en/images/mged09_globe_base_box_raytraced.png \ - lessons/en/images/mged09_globe_base_box_wireframe.png \ - lessons/en/images/mged09_globe_inside_outside_box.png \ - lessons/en/images/mged09_globe_outside_display_box.png \ - lessons/en/images/mged09_globe_raytraced.png \ - lessons/en/images/mged09_globe_wireframe.png \ - lessons/en/images/mged10_mug_wireframe.png \ - lessons/en/images/mged11_mug_raytraced_norim.png \ - lessons/en/images/mged11_mug_raytraced_rim.png \ - lessons/en/images/mged12_cyls_frontview.png \ - lessons/en/images/mged12_mug_gui_finished_raytraced.png \ - lessons/en/images/mged12_mug_handle_frontview.png \ - lessons/en/images/mged12_mug_handle_topview.png \ - lessons/en/images/mged12_mug_rim_frontview.png \ - lessons/en/images/mged13_candle_comb_ed_checker.png \ - lessons/en/images/mged13_candle_complete_front.png \ - lessons/en/images/mged13_candle_design.png \ - lessons/en/images/mged13_candle_raytraced_overlay.png \ - lessons/en/images/mged13_candle_tabletop_base_candle_front.png \ - lessons/en/images/mged13_candle_tabletop_base_front.png \ - lessons/en/images/mged13_candle_tabletop_eto1_rcc_wireframe_front.png \ - lessons/en/images/mged13_candle_tabletop_eto1_wireframe_front.png \ - lessons/en/images/mged13_candle_tabletop_wireframe_front.png \ - lessons/en/images/mged14_candle_base_sphere_topview.png \ - lessons/en/images/mged14_candle_multipane.png \ - lessons/en/images/mged14_candle_spheres_az35el25.png \ - lessons/en/images/mged14_candle_spheres_frontview.png \ - lessons/en/images/mged14_candle_spheres_raytraced.png \ - lessons/en/images/mged14_candle_spheres_topview.png \ - lessons/en/images/mged14_primitive_editor.png \ - lessons/en/images/mged14_primitive_selection_dropdown.png \ - lessons/en/images/mged15_cameo_shader.png \ - lessons/en/images/mged15_prim_ed_wheel_well.png \ - lessons/en/images/mged15_truck_2nd_wheel_wheel_place.png \ - lessons/en/images/mged15_truck_ambient_lighting.png \ - lessons/en/images/mged15_truck_cab1s.png \ - lessons/en/images/mged15_truck_cab_body.png \ - lessons/en/images/mged15_truck_cab_cutoff.png \ - lessons/en/images/mged15_truck_default_lighting.png \ - lessons/en/images/mged15_truck_design.png \ - lessons/en/images/mged15_truck_multipane_1stwheel.png \ - lessons/en/images/mged15_truck_wheel_wells_wireframe.png \ - lessons/en/images/mged15_truck_wheels.png \ - lessons/en/images/mged16_radio_casecut_raytrace.png \ - lessons/en/images/mged16_radio_cut_raytrace.png \ - lessons/en/images/mged16_radio_cut_wireframe.png \ - lessons/en/images/mged16_radio_default_components_props.png \ - lessons/en/images/mged16_radio_new_design.png \ - lessons/en/images/mged16_radio_transparent.png \ - lessons/en/images/mged16_radio_wireframe_circ_board.png \ - lessons/en/images/mged16_radio_with_mater_props.png - - -lessonsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/lessons/en -lessonsDOCBOOK_ENhtml_DATA = \ - $(BUILTLESSONS_ENHTML) - -BUILTLESSONS_ENHTML = \ - ${lessonsDOCBOOK_EN:xml=html} - -lessonsDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/lessons/en/images -lessonsDOCBOOK_ENhtmlimages_DATA = \ - $(lessonsDOCBOOK_EN_IMAGES) - -if BUILD_PDF_DOCS - -BUILTLESSONS_ENPDF = ${lessonsDOCBOOK_EN:xml=pdf} - -endif - -lessonsDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/lessons/en -lessonsDOCBOOK_ENpdf_DATA = $(BUILTLESSONS_ENPDF) - - - - - - - -booksDOCBOOK_EN = \ - books/en/BRL-CAD_Tutorial_Series-VolumeII.xml \ - books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml - -booksDOCBOOK_EN_IMAGES = \ - books/en/images/tutorial_series_volIII_fig01.png \ - books/en/images/tutorial_series_volIII_fig02.png \ - books/en/images/tutorial_series_volIII_fig03.png \ - books/en/images/tutorial_series_volIII_fig04.png \ - books/en/images/tutorial_series_volIII_fig05.png \ - books/en/images/tutorial_series_volIII_fig06.png \ - books/en/images/tutorial_series_volIII_fig07.png \ - books/en/images/tutorial_series_volIII_fig08.png \ - books/en/images/tutorial_series_volIII_fig09.png \ - books/en/images/tutorial_series_volIII_fig10.png \ - books/en/images/tutorial_series_volIII_fig11.png \ - books/en/images/tutorial_series_volIII_fig12.png \ - books/en/images/tutorial_series_volIII_fig13.png \ - books/en/images/tutorial_series_volIII_fig14.png \ - books/en/images/tutorial_series_volIII_fig15.png \ - books/en/images/tutorial_series_volIII_fig16.png \ - books/en/images/tutorial_series_volIII_fig17.png \ - books/en/images/tutorial_series_volIII_fig18.png \ - books/en/images/tutorial_series_volIII_fig19.png \ - books/en/images/tutorial_series_volIII_fig20.png \ - books/en/images/tutorial_series_volIII_fig21.png \ - books/en/images/tutorial_series_volIII_fig22.png \ - books/en/images/tutorial_series_volIII_fig23.png \ - books/en/images/tutorial_series_volIII_fig24.png \ - books/en/images/tutorial_series_volIII_fig25.png \ - books/en/images/tutorial_series_volIII_fig26.png \ - books/en/images/tutorial_series_volIII_fig27.png \ - books/en/images/tutorial_series_volIII_fig28.png \ - books/en/images/tutorial_series_volIII_fig29.png - -booksDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/books/en -booksDOCBOOK_ENhtml_DATA = \ - $(BUILTBOOKS_ENHTML) - -BUILTBOOKS_ENHTML = \ - ${booksDOCBOOK_EN:xml=html} - -booksDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/books/en/images -booksDOCBOOK_ENhtmlimages_DATA = \ - $(booksDOCBOOK_EN_IMAGES) - -if BUILD_PDF_DOCS - -BUILTBOOKS_ENPDF = ${booksDOCBOOK_EN:xml=pdf} - -endif - -booksDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/books/en -booksDOCBOOK_ENpdf_DATA = $(BUILTBOOKS_ENPDF) - - - - -specificationsDOCBOOK_EN = \ - specifications/en/BRL_CAD_g_format_V5.xml - -specificationsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/specifications/en -specificationsDOCBOOK_ENhtml_DATA = \ - $(BUILTSPECS_ENHTML) - -BUILTSPECS_ENHTML = \ - ${specificationsDOCBOOK_EN:xml=html} - -if BUILD_PDF_DOCS - -BUILTSPECS_ENPDF = ${specificationsDOCBOOK_EN:xml=pdf} - -endif - -specificationsDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/specifications/en -specificationsDOCBOOK_ENpdf_DATA = $(BUILTSPECS_ENPDF) - - - -man1DOCBOOK_EN = \ - system/man1/en/3ptarb.xml \ - system/man1/en/B.xml \ - system/man1/en/E.xml \ - system/man1/en/M.xml \ - system/man1/en/Z.xml \ - system/man1/en/adc.xml \ - system/man1/en/ae.xml \ - system/man1/en/alias-pix.xml \ - system/man1/en/all_sf.xml \ - system/man1/en/analyze.xml \ - system/man1/en/anim_cascade.xml \ - system/man1/en/anim_fly.xml \ - system/man1/en/anim_hardtrack.xml \ - system/man1/en/anim_keyread.xml \ - system/man1/en/anim_lookat.xml \ - system/man1/en/anim_offset.xml \ - system/man1/en/anim_orient.xml \ - system/man1/en/animmate.xml \ - system/man1/en/apropos.xml \ - system/man1/en/aproposdevel.xml \ - system/man1/en/aproposlib.xml \ - system/man1/en/arb.xml \ - system/man1/en/arced.xml \ - system/man1/en/area.xml \ - system/man1/en/arot.xml \ - system/man1/en/attach.xml \ - system/man1/en/attr.xml \ - system/man1/en/autoview.xml \ - system/man1/en/bb.xml \ - system/man1/en/bev.xml \ - system/man1/en/bo.xml \ - system/man1/en/bolt.xml \ - system/man1/en/bot_condense.xml \ - system/man1/en/bot_decimate.xml \ - system/man1/en/bot_face_fuse.xml \ - system/man1/en/bot_face_sort.xml \ - system/man1/en/bot_vertex_fuse.xml \ - system/man1/en/build_region.xml \ - system/man1/en/bwscale.xml \ - system/man1/en/c.xml \ - system/man1/en/cat.xml \ - system/man1/en/center.xml \ - system/man1/en/coil.xml \ - system/man1/en/color.xml \ - system/man1/en/comb_color.xml \ - system/man1/en/copyeval.xml \ - system/man1/en/copymat.xml \ - system/man1/en/cp.xml \ - system/man1/en/cpi.xml \ - system/man1/en/d.xml \ - system/man1/en/dall.xml \ - system/man1/en/db.xml \ - system/man1/en/db_glob.xml \ - system/man1/en/dbconcat.xml \ - system/man1/en/debugbu.xml \ - system/man1/en/debugdir.xml \ - system/man1/en/debuglib.xml \ - system/man1/en/debugmem.xml \ - system/man1/en/debugnmg.xml \ - system/man1/en/decompose.xml \ - system/man1/en/delay.xml \ - system/man1/en/dm.xml \ - system/man1/en/gastank.xml \ - system/man1/en/gqa.xml \ - system/man1/en/handle.xml \ - system/man1/en/mged.xml \ - system/man1/en/nirt.xml \ - system/man1/en/picket_fence.xml \ - system/man1/en/rt.xml \ - system/man1/en/rtarea.xml \ - system/man1/en/rtcheck.xml \ - system/man1/en/rtedge.xml \ - system/man1/en/search.xml \ - system/man1/en/tire.xml \ - system/man1/en/window.xml \ - system/man1/en/window_frame.xml \ - system/man1/en/wire.xml - -man1INTRO_EN = \ - system/man1/en/Introduction.xml - -man1DOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/man1/en -man1DOCBOOK_ENhtml_DATA = $(BUILTMAN_ENHTML) - -BUILTMAN_ENHTML = \ - ${man1DOCBOOK_EN:xml=html} \ - ${man1INTRO_EN:xml=html} - -if BUILD_PDF_DOCS - -BUILTMAN_ENPDF = ${man1DOCBOOK_EN:xml=pdf} - -endif - -man1DOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/man1/en -man1DOCBOOK_ENpdf_DATA = $(BUILTMAN_ENPDF) - - BUILT_SOURCES = \ $(BUILTARTICLES_ENHTML) \ $(BUILTARTICLES_ENPDF) \ Added: brlcad/trunk/doc/docbook/articles/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/articles/en/Makefile.am 2009-12-08 18:32:43 UTC (rev 36839) @@ -0,0 +1,119 @@ +articlesDOCBOOK_EN = \ + articles/en/build_pattern.xml \ + articles/en/build_region.xml \ + articles/en/ebm_primitive.xml \ + articles/en/mgedrc.xml \ + articles/en/nirt.xml \ + articles/en/oed.xml \ + articles/en/pipes.xml \ + articles/en/projection_shader.xml \ + articles/en/tire.xml + +articlesDOCBOOK_EN_IMAGES = \ + articles/en/images/build_pattern_fig01.png \ + articles/en/images/build_pattern_fig02.png \ + articles/en/images/build_pattern_fig03.png \ + articles/en/images/build_pattern_fig04.png \ + articles/en/images/build_pattern_fig05.png \ + articles/en/images/build_pattern_fig06.png \ + articles/en/images/build_pattern_fig07.png \ + articles/en/images/build_region_fig01.png \ + articles/en/images/build_region_fig02.png \ + articles/en/images/build_region_fig03.png \ + articles/en/images/build_region_fig04.png \ + articles/en/images/ebm_primitive_fig01.png \ + articles/en/images/ebm_primitive_fig02.png \ + articles/en/images/ebm_primitive_fig03.png \ + articles/en/images/mgedrc_fig02.png \ + articles/en/images/mgedrc_fig03.png \ + articles/en/images/nirt_fig01.png \ + articles/en/images/nirt_fig02.png \ + articles/en/images/nirt_fig03.png \ + articles/en/images/nirt_fig04.png \ + articles/en/images/nirt_fig05.png \ + articles/en/images/nirt_fig06.png \ + articles/en/images/nirt_fig07.png \ + articles/en/images/nirt_fig08.png \ + articles/en/images/nirt_fig09.png \ + articles/en/images/nirt_fig10.png \ + articles/en/images/nirt_fig11.png \ + articles/en/images/nirt_fig12.png \ + articles/en/images/nirt_fig13.png \ + articles/en/images/nirt_fig14.png \ + articles/en/images/nirt_fig15.png \ + articles/en/images/nirt_fig16.png \ + articles/en/images/nirt_fig17.png \ + articles/en/images/nirt_fig18.png \ + articles/en/images/nirt_fig19.png \ + articles/en/images/nirt_fig20.png \ + articles/en/images/nirt_fig21.png \ + articles/en/images/nirt_fig22.png \ + articles/en/images/nirt_fig23.png \ + articles/en/images/nirt_fig24.png \ + articles/en/images/oed_fig01.png \ + articles/en/images/oed_fig02.png \ + articles/en/images/oed_fig03.png \ + articles/en/images/oed_fig04.png \ + articles/en/images/oed_fig05.png \ + articles/en/images/oed_fig06.png \ + articles/en/images/oed_fig07.png \ + articles/en/images/oed_fig08.png \ + articles/en/images/oed_fig09.png \ + articles/en/images/oed_fig10.png \ + articles/en/images/oed_fig11.png \ + articles/en/images/oed_fig12.png \ + articles/en/images/oed_fig13.png \ + articles/en/images/pipes_fig01.png \ + articles/en/images/pipes_fig02.png \ + articles/en/images/pipes_fig03.png \ + articles/en/images/pipes_fig04.png \ + articles/en/images/pipes_fig05.png \ + articles/en/images/pipes_fig06.png \ + articles/en/images/pipes_fig07.png \ + articles/en/images/pipes_fig08.png \ + articles/en/images/pipes_fig09.png \ + articles/en/images/pipes_fig10.png \ + articles/en/images/pipes_fig11.png \ + articles/en/images/pipes_fig12.png \ + articles/en/images/pipes_fig13.png \ + articles/en/images/projection_shader_fig01.png \ + articles/en/images/projection_shader_fig02.png \ + articles/en/images/projection_shader_fig03.png \ + articles/en/images/projection_shader_fig04.png \ + articles/en/images/projection_shader_fig05.png \ + articles/en/images/projection_shader_fig06.png \ + articles/en/images/projection_shader_fig07.png \ + articles/en/images/tire_fig01.png \ + articles/en/images/tire_fig02.png \ + articles/en/images/tire_fig03.png \ + articles/en/images/tire_fig04.png \ + articles/en/images/tire_fig05.png \ + articles/en/images/tire_fig06.png \ + articles/en/images/tire_fig07.png \ + articles/en/images/tire_fig08.png \ + articles/en/images/tire_fig09.png \ + articles/en/images/tire_fig10.png \ + articles/en/images/tire_fig11.png \ + articles/en/images/tire_fig12.png \ + articles/en/images/tire_fig13.png \ + articles/en/images/tire_fig14.png + +articlesDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/articles/en +articlesDOCBOOK_ENhtml_DATA = \ + $(BUILTARTICLES_ENHTML) + +BUILTARTICLES_ENHTML = \ + ${articlesDOCBOOK_EN:xml=html} + +articlesDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/articles/en/images +articlesDOCBOOK_ENhtmlimages_DATA = \ + $(articlesDOCBOOK_EN_IMAGES) + +if BUILD_PDF_DOCS + +BUILTARTICLES_ENPDF = ${articlesDOCBOOK_EN:xml=pdf} + +endif + +articlesDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/articles/en +articlesDOCBOOK_ENpdf_DATA = $(BUILTARTICLES_ENPDF) Property changes on: brlcad/trunk/doc/docbook/articles/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/books/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/books/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/books/en/Makefile.am 2009-12-08 18:32:43 UTC (rev 36839) @@ -0,0 +1,54 @@ +booksDOCBOOK_EN = \ + books/en/BRL-CAD_Tutorial_Series-VolumeII.xml \ + books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml + +booksDOCBOOK_EN_IMAGES = \ + books/en/images/tutorial_series_volIII_fig01.png \ + books/en/images/tutorial_series_volIII_fig02.png \ + books/en/images/tutorial_series_volIII_fig03.png \ + books/en/images/tutorial_series_volIII_fig04.png \ + books/en/images/tutorial_series_volIII_fig05.png \ + books/en/images/tutorial_series_volIII_fig06.png \ + books/en/images/tutorial_series_volIII_fig07.png \ + books/en/images/tutorial_series_volIII_fig08.png \ + books/en/images/tutorial_series_volIII_fig09.png \ + books/en/images/tutorial_series_volIII_fig10.png \ + books/en/images/tutorial_series_volIII_fig11.png \ + books/en/images/tutorial_series_volIII_fig12.png \ + books/en/images/tutorial_series_volIII_fig13.png \ + books/en/images/tutorial_series_volIII_fig14.png \ + books/en/images/tutorial_series_volIII_fig15.png \ + books/en/images/tutorial_series_volIII_fig16.png \ + books/en/images/tutorial_series_volIII_fig17.png \ + books/en/images/tutorial_series_volIII_fig18.png \ + books/en/images/tutorial_series_volIII_fig19.png \ + books/en/images/tutorial_series_volIII_fig20.png \ + books/en/images/tutorial_series_volIII_fig21.png \ + books/en/images/tutorial_series_volIII_fig22.png \ + books/en/images/tutorial_series_volIII_fig23.png \ + books/en/images/tutorial_series_volIII_fig24.png \ + books/en/images/tutorial_series_volIII_fig25.png \ + books/en/images/tutorial_series_volIII_fig26.png \ + books/en/images/tutorial_series_volIII_fig27.png \ + books/en/images/tutorial_series_volIII_fig28.png \ + books/en/images/tutorial_series_volIII_fig29.png + +booksDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/books/en +booksDOCBOOK_ENhtml_DATA = \ + $(BUILTBOOKS_ENHTML) + +BUILTBOOKS_ENHTML = \ + ${booksDOCBOOK_EN:xml=html} + +booksDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/books/en/images +booksDOCBOOK_ENhtmlimages_DATA = \ + $(booksDOCBOOK_EN_IMAGES) + +if BUILD_PDF_DOCS + +BUILTBOOKS_ENPDF = ${booksDOCBOOK_EN:xml=pdf} + +endif + +booksDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/books/en +booksDOCBOOK_ENpdf_DATA = $(BUILTBOOKS_ENPDF) Property changes on: brlcad/trunk/doc/docbook/books/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/lessons/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/lessons/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/lessons/en/Makefile.am 2009-12-08 18:32:43 UTC (rev 36839) @@ -0,0 +1,143 @@ +lessonsDOCBOOK_EN = \ + lessons/en/mged01_creating_primitive_shapes.xml \ + lessons/en/mged02_learning_viewing_options.xml \ + lessons/en/mged03_using_insert_command.xml \ + lessons/en/mged04_assign_mat_prop_rt.xml \ + lessons/en/mged05_learning_boolean_expressions.xml \ + lessons/en/mged06_creating_a_goblet.xml \ + lessons/en/mged07_goblet_material_properties.xml \ + lessons/en/mged08_goblet_material_properties2.xml \ + lessons/en/mged09_globe_in_display_box.xml \ + lessons/en/mged10_creating_mug.xml \ + lessons/en/mged11_refining_mug.xml \ + lessons/en/mged12_mug_through_gui.xml \ + lessons/en/mged13_placing_shapes_in_3d.xml \ + lessons/en/mged14_placing_shapes_in_3d_2.xml \ + lessons/en/mged15_creating_a_toy_truck.xml \ + lessons/en/mged16_mod_tech_struct.xml + +lessonsDOCBOOK_EN_IMAGES = \ + lessons/en/images/mged01_commandwindow.png \ + lessons/en/images/mged01_graphicswindow.png \ + lessons/en/images/mged01_terminal.png \ + lessons/en/images/mged02_coordsys.png \ + lessons/en/images/mged02_defaultradio.png \ + lessons/en/images/mged02_flower_zooomin.png \ + lessons/en/images/mged02_flower_zooomout.png \ + lessons/en/images/mged02_multipane.png \ + lessons/en/images/mged02_radio_35_25.png \ + lessons/en/images/mged02_radio_front.png \ + lessons/en/images/mged02_radio_right.png \ + lessons/en/images/mged02_radio_top.png \ + lessons/en/images/mged02_truck_0_0_14.png \ + lessons/en/images/mged02_truck_270_-90.png \ + lessons/en/images/mged02_truck_270_90.png \ + lessons/en/images/mged02_truck_35_0.png \ + lessons/en/images/mged02_truck_35_25.png \ + lessons/en/images/mged02_truck_35_60.png \ + lessons/en/images/mged02_truck_35_90.png \ + lessons/en/images/mged02_truck_front.png \ + lessons/en/images/mged02_truck_left.png \ + lessons/en/images/mged02_truck_rear.png \ + lessons/en/images/mged02_truck_right.png \ + lessons/en/images/mged04_commandwindow.png \ + lessons/en/images/mged04_fb_overlay_mode.png \ + lessons/en/images/mged04_raytracedshapes.png \ + lessons/en/images/mged05_combinationeditor.png \ + lessons/en/images/mged05_intersectionspheres.png \ + lessons/en/images/mged05_raytraceddome.png \ + lessons/en/images/mged05_raytracedpart1.png \ + lessons/en/images/mged05_raytracedpart2.png \ + lessons/en/images/mged05_raytracedpart3.png \ + lessons/en/images/mged05_subtractionspheres.png \ + lessons/en/images/mged05_twoprimitivespheres.png \ + lessons/en/images/mged05_unionspheres.png \ + lessons/en/images/mged06_base_substracted_vol.png \ + lessons/en/images/mged06_goblet1stsphere.png \ + lessons/en/images/mged06_gobletbase.png \ + lessons/en/images/mged06_gobletbasestembasin.png \ + lessons/en/images/mged06_gobletstem.png \ + lessons/en/images/mged06_rtgoblet.png \ + lessons/en/images/mged06_rtgobletaz_35_el_25.png \ + lessons/en/images/mged07_goblet_complete_window.png \ + lessons/en/images/mged07_goblet_mater_complete.png \ + lessons/en/images/mged07_goblet_mirror.png \ + lessons/en/images/mged07_goblet_semitransparent.png \ + lessons/en/images/mged08_comb_editor_window_mater_prop.png \ + lessons/en/images/mged08_goblet_combeditor.png \ + lessons/en/images/mged08_goblet_reflectivity_1.png \ + lessons/en/images/mged08_goblet_reflectivity_2.png \ + lessons/en/images/mged08_refractive_index.png \ + lessons/en/images/mged08_spec_vs_diff_reflectivity.png \ + lessons/en/images/mged09_globe_base_box_raytraced.png \ + lessons/en/images/mged09_globe_base_box_wireframe.png \ + lessons/en/images/mged09_globe_inside_outside_box.png \ + lessons/en/images/mged09_globe_outside_display_box.png \ + lessons/en/images/mged09_globe_raytraced.png \ + lessons/en/images/mged09_globe_wireframe.png \ + lessons/en/images/mged10_mug_wireframe.png \ + lessons/en/images/mged11_mug_raytraced_norim.png \ + lessons/en/images/mged11_mug_raytraced_rim.png \ + lessons/en/images/mged12_cyls_frontview.png \ + lessons/en/images/mged12_mug_gui_finished_raytraced.png \ + lessons/en/images/mged12_mug_handle_frontview.png \ + lessons/en/images/mged12_mug_handle_topview.png \ + lessons/en/images/mged12_mug_rim_frontview.png \ + lessons/en/images/mged13_candle_comb_ed_checker.png \ + lessons/en/images/mged13_candle_complete_front.png \ + lessons/en/images/mged13_candle_design.png \ + lessons/en/images/mged13_candle_raytraced_overlay.png \ + lessons/en/images/mged13_candle_tabletop_base_candle_front.png \ + lessons/en/images/mged13_candle_tabletop_base_front.png \ + lessons/en/images/mged13_candle_tabletop_eto1_rcc_wireframe_front.png \ + lessons/en/images/mged13_candle_tabletop_eto1_wireframe_front.png \ + lessons/en/images/mged13_candle_tabletop_wireframe_front.png \ + lessons/en/images/mged14_candle_base_sphere_topview.png \ + lessons/en/images/mged14_candle_multipane.png \ + lessons/en/images/mged14_candle_spheres_az35el25.png \ + lessons/en/images/mged14_candle_spheres_frontview.png \ + lessons/en/images/mged14_candle_spheres_raytraced.png \ + lessons/en/images/mged14_candle_spheres_topview.png \ + lessons/en/images/mged14_primitive_editor.png \ + lessons/en/images/mged14_primitive_selection_dropdown.png \ + lessons/en/images/mged15_cameo_shader.png \ + lessons/en/images/mged15_prim_ed_wheel_well.png \ + lessons/en/images/mged15_truck_2nd_wheel_wheel_place.png \ + lessons/en/images/mged15_truck_ambient_lighting.png \ + lessons/en/images/mged15_truck_cab1s.png \ + lessons/en/images/mged15_truck_cab_body.png \ + lessons/en/images/mged15_truck_cab_cutoff.png \ + lessons/en/images/mged15_truck_default_lighting.png \ + lessons/en/images/mged15_truck_design.png \ + lessons/en/images/mged15_truck_multipane_1stwheel.png \ + lessons/en/images/mged15_truck_wheel_wells_wireframe.png \ + lessons/en/images/mged15_truck_wheels.png \ + lessons/en/images/mged16_radio_casecut_raytrace.png \ + lessons/en/images/mged16_radio_cut_raytrace.png \ + lessons/en/images/mged16_radio_cut_wireframe.png \ + lessons/en/images/mged16_radio_default_components_props.png \ + lessons/en/images/mged16_radio_new_design.png \ + lessons/en/images/mged16_radio_transparent.png \ + lessons/en/images/mged16_radio_wireframe_circ_board.png \ + lessons/en/images/mged16_radio_with_mater_props.png + + +lessonsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/lessons/en +lessonsDOCBOOK_ENhtml_DATA = \ + $(BUILTLESSONS_ENHTML) + +BUILTLESSONS_ENHTML = \ + ${lessonsDOCBOOK_EN:xml=html} + +lessonsDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/lessons/en/images +lessonsDOCBOOK_ENhtmlimages_DATA = \ + $(lessonsDOCBOOK_EN_IMAGES) + +if BUILD_PDF_DOCS + +BUILTLESSONS_ENPDF = ${lessonsDOCBOOK_EN:xml=pdf} + +endif + +lessonsDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/lessons/en +lessonsDOCBOOK_ENpdf_DATA = $(BUILTLESSONS_ENPDF) Property changes on: brlcad/trunk/doc/docbook/lessons/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/specifications/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/specifications/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/specifications/en/Makefile.am 2009-12-08 18:32:43 UTC (rev 36839) @@ -0,0 +1,18 @@ +specificationsDOCBOOK_EN = \ + specifications/en/BRL_CAD_g_format_V5.xml + +specificationsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/specifications/en +specificationsDOCBOOK_ENhtml_DATA = \ + $(BUILTSPECS_ENHTML) + +BUILTSPECS_ENHTML = \ + ${specificationsDOCBOOK_EN:xml=html} + +if BUILD_PDF_DOCS + +BUILTSPECS_ENPDF = ${specificationsDOCBOOK_EN:xml=pdf} + +endif + +specificationsDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/specifications/en +specificationsDOCBOOK_ENpdf_DATA = $(BUILTSPECS_ENPDF) Property changes on: brlcad/trunk/doc/docbook/specifications/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/system/man1/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2009-12-08 18:32:43 UTC (rev 36839) @@ -0,0 +1,97 @@ +man1DOCBOOK_EN = \ + system/man1/en/3ptarb.xml \ + system/man1/en/B.xml \ + system/man1/en/E.xml \ + system/man1/en/M.xml \ + system/man1/en/Z.xml \ + system/man1/en/adc.xml \ + system/man1/en/ae.xml \ + system/man1/en/alias-pix.xml \ + system/man1/en/all_sf.xml \ + system/man1/en/analyze.xml \ + system/man1/en/anim_cascade.xml \ + system/man1/en/anim_fly.xml \ + system/man1/en/anim_hardtrack.xml \ + system/man1/en/anim_keyread.xml \ + system/man1/en/anim_lookat.xml \ + system/man1/en/anim_offset.xml \ + system/man1/en/anim_orient.xml \ + system/man1/en/animmate.xml \ + system/man1/en/apropos.xml \ + system/man1/en/aproposdevel.xml \ + system/man1/en/aproposlib.xml \ + system/man1/en/arb.xml \ + system/man1/en/arced.xml \ + system/man1/en/area.xml \ + system/man1/en/arot.xml \ + system/man1/en/attach.xml \ + system/man1/en/attr.xml \ + system/man1/en/autoview.xml \ + system/man1/en/bb.xml \ + system/man1/en/bev.xml \ + system/man1/en/bo.xml \ + system/man1/en/bolt.xml \ + system/man1/en/bot_condense.xml \ + system/man1/en/bot_decimate.xml \ + system/man1/en/bot_face_fuse.xml \ + system/man1/en/bot_face_sort.xml \ + system/man1/en/bot_vertex_fuse.xml \ + system/man1/en/build_region.xml \ + system/man1/en/bwscale.xml \ + system/man1/en/c.xml \ + system/man1/en/cat.xml \ + system/man1/en/center.xml \ + system/man1/en/coil.xml \ + system/man1/en/color.xml \ + system/man1/en/comb_color.xml \ + system/man1/en/copyeval.xml \ + system/man1/en/copymat.xml \ + system/man1/en/cp.xml \ + system/man1/en/cpi.xml \ + system/man1/en/d.xml \ + system/man1/en/dall.xml \ + system/man1/en/db.xml \ + system/man1/en/db_glob.xml \ + system/man1/en/dbconcat.xml \ + system/man1/en/debugbu.xml \ + system/man1/en/debugdir.xml \ + system/man1/en/debuglib.xml \ + system/man1/en/debugmem.xml \ + system/man1/en/debugnmg.xml \ + system/man1/en/decompose.xml \ + system/man1/en/delay.xml \ + system/man1/en/dm.xml \ + system/man1/en/gastank.xml \ + system/man1/en/gqa.xml \ + system/man1/en/handle.xml \ + system/man1/en/mged.xml \ + system/man1/en/nirt.xml \ + system/man1/en/picket_fence.xml \ + system/man1/en/rt.xml \ + system/man1/en/rtarea.xml \ + system/man1/en/rtcheck.xml \ + system/man1/en/rtedge.xml \ + system/man1/en/search.xml \ + system/man1/en/tire.xml \ + system/man1/en/window.xml \ + system/man1/en/window_frame.xml \ + system/man1/en/wire.xml + +man1INTRO_EN = \ + system/man1/en/Introduction.xml + +man1DOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/man1/en +man1DOCBOOK_ENhtml_DATA = $(BUILTMAN_ENHTML) + +BUILTMAN_ENHTML = \ + ${man1DOCBOOK_EN:xml=html} \ + ${man1INTRO_EN:xml=html} + +if BUILD_PDF_DOCS + +BUILTMAN_ENPDF = ${man1DOCBOOK_EN:xml=pdf} + +endif + +man1DOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/man1/en +man1DOCBOOK_ENpdf_DATA = $(BUILTMAN_ENPDF) Property changes on: brlcad/trunk/doc/docbook/system/man1/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2009-12-15 00:49:46
|
Revision: 36907 http://brlcad.svn.sourceforge.net/brlcad/?rev=36907&view=rev Author: starseeker Date: 2009-12-15 00:49:33 +0000 (Tue, 15 Dec 2009) Log Message: ----------- First man3 man page in docbook - add man3 to the system directory and make a new rule to generate .3 man pages. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/system/README brlcad/trunk/doc/docbook/system/man3/ brlcad/trunk/doc/docbook/system/man3/en/ brlcad/trunk/doc/docbook/system/man3/en/Makefile.am brlcad/trunk/doc/docbook/system/man3/en/libfb.xml brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml Removed Paths: ------------- brlcad/trunk/doc/docbook/system/man1/README Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2009-12-15 00:00:56 UTC (rev 36906) +++ brlcad/trunk/doc/docbook/Makefile.am 2009-12-15 00:49:33 UTC (rev 36907) @@ -12,6 +12,11 @@ mkdir -p system/man1/en/ mv '$(@F)' system/man1/en/ +.xml.3: + XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? + mkdir -p system/man3/en/ + mv '$(@F)' system/man3/en/ + .fo.pdf: .xml.fo $(APACHEFOP) -c fop.xconf $? -pdf $@ @@ -28,6 +33,8 @@ include $(srcdir)/system/man1/en/Makefile.am +include $(srcdir)/system/man3/en/Makefile.am + include $(srcdir)/lessons/es/Makefile.am if BUILD_DOCS @@ -43,11 +50,14 @@ $(BUILTSPECS_ENPDF) \ $(BUILTMAN_ENHTML) \ $(BUILTMAN_ENPDF) \ + $(BUILTMAN3_ENHTML) \ + $(BUILTMAN3_ENPDF) \ $(BUILTLESSONS_ESHTML) \ $(BUILTLESSONS_ESPDF) BUILTMAN_EN_SOURCES = \ - ${man1DOCBOOK_EN:xml=1} + ${man1DOCBOOK_EN:xml=1} \ + ${man3DOCBOOK_EN:xml=3} man_MANS = \ $(BUILTMAN_EN_SOURCES) @@ -64,6 +74,7 @@ clean-generic: mostlyclean-generic -rmdir -p system/man1/en + -rmdir -p system/man3/en EXTRA_DIST = \ ${articlesDOCBOOK_EN_IMAGES} \ @@ -85,7 +96,8 @@ catalog.xml \ fop.xconf.in \ resources \ - system/man1/README \ - system/man1/mged_cmd_template.xml + system/README \ + system/man1/mged_cmd_template.xml \ + system/man3/mged_cmd_template.xml include $(top_srcdir)/misc/Makefile.defs Added: brlcad/trunk/doc/docbook/system/README =================================================================== --- brlcad/trunk/doc/docbook/system/README (rev 0) +++ brlcad/trunk/doc/docbook/system/README 2009-12-15 00:49:33 UTC (rev 36907) @@ -0,0 +1,11 @@ +The files in these directories represent per-topic Docbook files in +the style of UNIX man pages, and uses standard man1, man3, etc. +directory layouts for toplevel directory structure. + +The file mged_cmd_template.xml represents a blank template for +converting existing MGED command documentation such as that found +in the mged_cmd_index.html file or Volume II Appendix. It is not +required to use this precise template for all MGED commands - see +search.xml for a more elaborate example - but it should provide +a convenient "container" for what has been the common documentation +format in previous work. Property changes on: brlcad/trunk/doc/docbook/system/README ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Deleted: brlcad/trunk/doc/docbook/system/man1/README =================================================================== --- brlcad/trunk/doc/docbook/system/man1/README 2009-12-15 00:00:56 UTC (rev 36906) +++ brlcad/trunk/doc/docbook/system/man1/README 2009-12-15 00:49:33 UTC (rev 36907) @@ -1,11 +0,0 @@ -The files in these directories represent per-topic Docbook files in -the style of UNIX man pages, and uses standard man1, man3, etc. -directory layouts for toplevel directory structure. - -The file mged_cmd_template.xml represents a blank template for -converting existing MGED command documentation such as that found -in the mged_cmd_index.html file or Volume II Appendix. It is not -required to use this precise template for all MGED commands - see -search.xml for a more elaborate example - but it should provide -a convenient "container" for what has been the common documentation -format in previous work. Added: brlcad/trunk/doc/docbook/system/man3/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/system/man3/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/system/man3/en/Makefile.am 2009-12-15 00:49:33 UTC (rev 36907) @@ -0,0 +1,19 @@ +if EN_DOCS +man3DOCBOOK_EN = \ + system/man3/en/libfb.xml + +man3DOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/man3/en +man3DOCBOOK_ENhtml_DATA = $(BUILTMAN3_ENHTML) + +BUILTMAN3_ENHTML = \ + ${man3DOCBOOK_EN:xml=html} + +if BUILD_PDF_DOCS + +BUILTMAN3_ENPDF = ${man3DOCBOOK_EN:xml=pdf} + +endif + +man3DOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/man3/en +man3DOCBOOK_ENpdf_DATA = $(BUILTMAN3_ENPDF) +endif Property changes on: brlcad/trunk/doc/docbook/system/man3/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/system/man3/en/libfb.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man3/en/libfb.xml (rev 0) +++ brlcad/trunk/doc/docbook/system/man3/en/libfb.xml 2009-12-15 00:49:33 UTC (rev 36907) @@ -0,0 +1,502 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "../../../resources/standard/dtd/docbookx.dtd"> + +<refentry id='libfb'> + +<refmeta> + <refentrytitle>libfb - FrameBuffer Library</refentrytitle> + <manvolnum>3</manvolnum> + <refmiscinfo class='source'>BRL-CAD</refmiscinfo> + <refmiscinfo class='manual'>BRL-CAD Libraries</refmiscinfo> +</refmeta> + +<refnamediv id='name'> + <refname>libfb</refname> + <refpurpose> + multiple device, generic frame buffer library + </refpurpose> +</refnamediv> + +<!-- body begins here --> + +<refsect1 id='libfbgeneric'> + <title>Generic frame buffer routines</title> + <funcprototype> + <funcdef><function>FBIO</function> *fb_open</funcdef> + <paramdef>* <parameter>fbfile</parameter></paramdef> + <paramdef>int fb_close ( fbp ) FBIO * <parameter>fbp</parameter></paramdef> + <paramdef>int fb_read ( fbp , x , y , addr , count ) FBIO * <parameter>fbp</parameter></paramdef> + </funcprototype> + <funcsynopsisinfo> + RGBpixel *addr; + long count; + + </funcsynopsisinfo> + <funcprototype> + <funcdef>int <function>fb_write</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>RGBpixel * <parameter>addr</parameter></paramdef> + <paramdef>long <parameter>count</parameter></paramdef> + <paramdef>int fb_rmap ( fbp , cmap ) FBIO * <parameter>fbp</parameter></paramdef> + <paramdef>ColorMap * <parameter>cmap</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_wmap</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>ColorMap * <parameter>cmap</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_clear</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>RGBpixel * <parameter>colorp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>char *<function>fb_gettype</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_getwidth</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_getheight</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + </funcprototype> +</refsect1> + +<refsect1 id='libfbhardware'> + <title>Hardware specific frame buffer routines</title> + <funcprototype> + <funcdef>int <function>fb_cursor</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>int fb_scursor ( fbp , mode , x , y ) FBIO * <parameter>fbp</parameter></paramdef> + <paramdef>int fb_setcursor ( fbp , bits , xbits , ybits , xorig , yorig ) FBIO * <parameter>fbp</parameter></paramdef> + <paramdef>unsigned char <parameter>bits</parameter>[]</paramdef> + </funcprototype> + <funcsynopsisinfo> + int xbits, ybits; + int xorig, yorig; + + </funcsynopsisinfo> + <funcprototype> + <funcdef>int <function>fb_window</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>int fb_zoom ( fbp , x , y ) FBIO * <parameter>fbp</parameter></paramdef> + <paramdef>/ *Buffered frame buffer I/O: */ int fb_ioinit ( fbp ) FBIO * <parameter>fbp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_seek</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>void fb_tell ( fbp , xp , yp ) FBIO * <parameter>fbp</parameter></paramdef> + <paramdef>int *xp , * <parameter>yp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_rpixel</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>RGBpixel * <parameter>pixelp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_wpixel</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + <paramdef>RGBpixel * <parameter>pixelp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>fb_flush</function></funcdef> + <paramdef>* <parameter>fbp</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>void <function>fb_log</function></funcdef> + <paramdef>format [ <parameter></parameter></paramdef> + <paramdef>arg ] ... <parameter></parameter></paramdef> + </funcprototype> +</refsect1> + +<refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + These routines are designed to provide a device-independent + method of using frame buffers or files containing frame buffer + images. The coordinate system used is first-quadrant (0..width-1, + 0..height-1), with integer addressing. Translation to hardware + coordinate systems is handled by the library. + </para> + + <para> + This version of the library assumes that red, green, and blue + intensities are described by unsigned 8-bit bytes in the range (0..255). + The library interface uses arrays of <emphasis remap='B'>RGBpixel</emphasis>s, + which is a typedef for an array of three unsigned chars (this was + done to avoid structure padding). Note that a pointer to an + <emphasis remap='B'>RGBpixel</emphasis> + is thus the name of the <emphasis remap='B'>RGBpixel</emphasis> + itself, i.e. no ampersand is needed. + </para> + + <para> + The exact interpretation of color maps tends to be somewhat device + specific. The three ColorMap arrays each have 256 entries of unsigned + 16-bit values. In order to accomodate color maps with differing amounts + of output resolution, the color map entries are fixed-point fractions + in the range (0.0..1.0). In integer notation, the range is (0..65525). + For devices with less than 16 bits of output from their color maps, + the left-most portion of each entry is used. + </para> + + <para> + <emphasis remap='I'>Fb_open</emphasis> is used to open a frame buffer + file <emphasis remap='I'>fbfile</emphasis>. The file may be either the + name of a supported frame buffer interface, referenced as "/dev/interface", + or the name of a UNIX file. The routine will try to determine if the + file opened was a real frame buffer by examining the name, and if so + will perform whatever initialization actions are necessary. + If the value of <emphasis remap='I'>fbfile</emphasis> is + <!-- B elided --> + <acronym>NULL</acronym> and the environment variable + <!-- B elided --> + <envar>FB_FILE</envar> is set, then the value of <envar>FB_FILE</envar> + is used; otherwise the default frame buffer device for the system is used. + See below for more details. The <emphasis remap='I'>width</emphasis> + and <emphasis remap='I'>height</emphasis> parameters specify the initial + size of display desired. If these are zero the default sizes for that + device will be used. On a successful open, the frame buffer I/O (FBIO) + structure pointer is returned. This structure contains size you were + actually given, as well as the maximum possible size for the selected + device. A return of FBIO_NULL indicates failure. + </para> + + <para> + <emphasis remap='I'>Fb_close</emphasis> simply closes the frame buffer. + </para> + + <para> + <emphasis remap='I'>Fb_read</emphasis> reads + <emphasis remap='I'>count</emphasis> pixels from the frame buffer + starting at the location specified by <emphasis remap='I'>x</emphasis> + and <emphasis remap='I'>y</emphasis>, and places them at program + memory address specified by <emphasis remap='I'>addr</emphasis>. + <emphasis remap='I'>Fb_read</emphasis> returns the number of + pixels actually read, or -1 on error. + </para> + + <para> + <emphasis remap='I'>Fb_write</emphasis> writes + <emphasis remap='I'>count</emphasis> pixels from program address + <emphasis remap='I'>addr</emphasis> into the frame buffer starting + at the location specified by <emphasis remap='I'>x</emphasis> + and <emphasis remap='I'>y</emphasis>. <emphasis remap='I'>Fb_write</emphasis> + returns the number of pixels actually written, or -1 on error. + </para> + + <para> + <emphasis remap='I'>Fb_rmap</emphasis> + reads in the color map from the frame buffer and + leaves at the location pointed to by + <emphasis remap='I'>cmap</emphasis>. + </para> + + <para> + <emphasis remap='I'>Fb_wmap</emphasis> + writes the color map pointed to by + <emphasis remap='I'>cmap</emphasis> + into the frame buffer. If the value of + <emphasis remap='I'>cmap</emphasis> + is + <!-- B elided --> + <acronym>NULL</acronym> + then a linear color map is used as the default. + </para> + + <para> + <emphasis remap='I'>Fb_clear</emphasis> + erases the frame buffer by setting all pixels to the given + color. If the color pointer is NULL, black will be used. + On a UNIX file, this entails writing the entire file, + which is an expensive operation, whereas on most + frame buffer displays + this can be done in less than a second by a special command. + </para> + + <para> + <emphasis remap='I'>Fb_gettype</emphasis> + returns a pointer to a string describing the frame buffer + specified by the FBIO pointer. + </para> + + <para> + <emphasis remap='I'>Fb_getwidth</emphasis> + and <emphasis remap='I'>Fb_getheight</emphasis> + returns the current size of the FBIO frame buffer. + </para> + + <para> + The following routines work in conjunction with those described above + to provide functions which only apply if the frame buffer + file is actually a hardware frame buffer display. + </para> + + <para> + <emphasis remap='I'>Fb_cursor</emphasis> + places the cursor at the image space coordinates given by + <emphasis remap='I'>x</emphasis> + and + <emphasis remap='I'>y</emphasis>. + If the mode is non-zero, the cursor is made visible, and + if mode is zero, the cursor is turned off. + </para> + + <para> + <emphasis remap='I'>Fb_scursor</emphasis> + is the same as + <emphasis remap='I'>fb_cursor</emphasis> + except that it + places the cursor at the + <emphasis remap='B'>screen</emphasis> + space coordinates given by + <emphasis remap='I'>x</emphasis> + and + <emphasis remap='I'>y</emphasis>. + </para> + + <para> + <emphasis remap='I'>Fb_setcursor</emphasis> + allows the user to set the bitmap used to represent the cursor, + thereby changing the cursor shape. This is not necessarily supported + by all hardware. The argument <emphasis remap='I'>bits</emphasis> + is a pointer to an array of unsigned chars containing the bits of the cursor. + The arguments <emphasis remap='I'>xbits</emphasis> + and <emphasis remap='I'>ybits</emphasis> + specify the size of the cursor bitmap. The number of bytes in the + <varname role='parameter'>bits</varname> array will be the width rounded + up to a mutiple of eight (so that the cursor "scanlines" are byte aligned) + times the height. + <varname role='parameter'>bits</varname>[0] + is the lower left corner, + <varname role='parameter'>bits</varname>[1] + is to the right of it, etc. The next line of the + <varname role='parameter'>bits</varname> + array goes above the current one. Within a byte the most significant + bit is the leftmost. The values + <emphasis remap='I'>xorig</emphasis> + and <emphasis remap='I'>yorig</emphasis> + specify which bit in the bitmap actually gets placed at the location + specified in the cursor move routines. Again, a first quadrant coordinate + system is used. + </para> + + <para> + <emphasis remap='I'>Fb_window</emphasis> + sets the frame buffer window center position to the image space coordinates + given by <emphasis remap='I'>x</emphasis> and <emphasis remap='I'>y</emphasis>. + This command is usually used in conjunction with the + <emphasis remap='I'>fb_zoom</emphasis> routine. + </para> + + <para> + <emphasis remap='I'>Fb_zoom</emphasis> + sets the zoom factor for the X coordinate to + <emphasis remap='I'>x</emphasis> + and the zoom factor for the Y coordinate to + <emphasis remap='I'>y</emphasis>. + Zooming is generally done by pixel replication in hardware. + </para> + + <para> + The following routines work in conjunction with those described above + to provide buffered reading and writing of frame buffer images + either to a real frame buffer or a UNIX file. + The routines use a simple paging strategy to hold “bands” of + the image in core. Since horizontal bands are buffered, the + ideal motion is to scan left to right, then bottom to top. + </para> + + <para> + <emphasis remap='I'>Fb_ioinit</emphasis> + should be called before using any of the other buffered I/O routines and + repeated whenever the frame buffer is reopened. + </para> + + <para> + <emphasis remap='I'>Fb_seek</emphasis> + is used to position the current read/write pointer to + the location to the next position to be read or written. + It is not necessary to do a <emphasis remap='I'>fb_seek</emphasis> + after every read or write since both <emphasis remap='I'>fb_rpixel</emphasis> + and <emphasis remap='I'>fb_wpixel</emphasis> imply an automatic move to + the next pixel. If you read or write the last pixel on a scan line, + the pointer will automatically move to the beginning + of the following scan line. + </para> + + <para> + <emphasis remap='I'>Fb_tell</emphasis> + returns the current location of the read write pointer + in terms of (X,Y) coordinates on the frame buffer. + The X and Y values are returned into the integers pointed to + by <emphasis remap='I'>xp</emphasis> and <emphasis remap='I'>yp</emphasis>. + </para> + + <para> + <emphasis remap='I'>Fb_rpixel</emphasis> + reads the pixel at the current frame buffer location + and returns it into the location specifed + by <emphasis remap='I'>pixelp</emphasis>. + </para> + + <para> + <emphasis remap='I'>Fb_wpixel</emphasis> + writes the pixel pointed to by <emphasis remap='I'>pixelp</emphasis> + at the current frame buffer location. + </para> + + <para> + <emphasis remap='I'>Fb_flush</emphasis> + caused any current buffered frame buffer pages to be written out. + Unnecessary writes are avoided by the use of page reference bits. + </para> + + <para> + The following is a printing routine which this library uses to + indicate errors. + </para> + + <para> + <emphasis remap='I'>Fb_log</emphasis> will convert, format and print its + <emphasis remap='I'>args</emphasis> under control of + <emphasis remap='I'>format</emphasis> to the standard error output. + For more detailed information on the specification of the control string, + see <citerefentry><refentrytitle>printf</refentrytitle> + <manvolnum>3S</manvolnum></citerefentry>. + This function may be supplied by the application if different behavior + is desired. + </para> +</refsect1> + +<refsect1 id='fb_file_devices'> + <title>FB_FILE DEVICES</title> + <para> + The following devices are supported by the library; not all may + be available on any given system. New device support can be + incorporated by the addition of a single module to the library. + </para> + <variablelist remap='TP'> + <varlistentry> + <term><filename>/dev/debug</filename><emphasis remap='I'>[num]</emphasis></term> + <listitem> + <para>The "/dev/debug" interface prints one line to logs each call + to the frame buffer library. + <!-- .br --> + <emphasis remap='I'>num</emphasis> + is a bitvector indicating the levels of verbosity of the output. See + <emphasis remap='B'>fb.h</emphasis> + for the bit definitions.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='I'>filename</emphasis></term> + <listitem> + <para>Disk file interface</para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B'>hostname:</emphasis><emphasis remap='I'>[devicename]</emphasis></term> + <listitem> + <para>TCP-based network links to a remote framebuffer, where + <emphasis remap='I'>devicename</emphasis> + is any from this list, for example, + fictitious.brlcad.org:/dev/ik0 or fictitious.brlcad.org:/dev/sgi. + A <emphasis remap='B'>hostname</emphasis> + with a null<emphasis remap='I'>devicename</emphasis> + will select the default display device on that host. + If explicitly specifying a remote device, + be careful not to omit the colon between the host and device name, + or you will be specifying a local disk file as the result. + Note that for security reasons, it is not permitted to access a + disk file via the remote interface.</para> + </listitem> + </varlistentry> + </variablelist> +</refsect1> + +<refsect1 id='examples'> + <title>EXAMPLES</title> + <para> + <emphasis remap='I'>Libfb</emphasis> + can be loaded with any C program: + </para> + + <literallayout remap='RS'> +<synopsis> +$  <filename>/bin/cc  program.c  -lfb -l\<system-library...\></filename> +</synopsis> + </literallayout> <!-- remap='RE' --> + + <para> + where <emphasis remap='I'><system-library></emphasis> + denotes specific libraries necesary on a particular machine. All machines + with networking will require the "-lpkg" option. Machines which support the + X Windows(tm) system will require the "-lX11" option. + </para> +</refsect1> + +<refsect1 id='return_values'> + <title>RETURN VALUES</title> + <para> + <emphasis remap='I'>fb_close</emphasis>, + <emphasis remap='I'>fb_write</emphasis>, + <emphasis remap='I'>fb_read</emphasis>, + <emphasis remap='I'>fb_wmap</emphasis>, + <emphasis remap='I'>fb_rmap</emphasis>, + <emphasis remap='I'>fb_clear</emphasis>, + <emphasis remap='I'>fb_cursor</emphasis>, + <emphasis remap='I'>fb_scursor</emphasis>, + <emphasis remap='I'>fb_setcursor</emphasis>, + <emphasis remap='I'>fb_window</emphasis>, + <emphasis remap='I'>fb_zoom</emphasis>, + <emphasis remap='I'>fb_ioinit</emphasis>, + <emphasis remap='I'>fb_seek</emphasis>, + <emphasis remap='I'>fb_wpixel</emphasis>, + <emphasis remap='I'>fb_rpixel</emphasis> + and + <emphasis remap='I'>fb_flush</emphasis> + return -1 to indicate failure. + <emphasis remap='I'>Fb_open</emphasis> + returns FBIO_NULL to indicate failure, and a non-null FBIO structure pointer + upon success. + <emphasis remap='I'>fb_read</emphasis>, + and + <emphasis remap='I'>fb_write</emphasis> + return the number of pixels actually read or written. + <emphasis remap='I'>fb_gettype</emphasis> + returns a pointer to a NULL terminated description string. + </para> +</refsect1> + +<refsect1 id='see_also'><title>SEE ALSO</title> +<para><citerefentry><refentrytitle>fbhelp</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>brlcad</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para> +</refsect1> + +<refsect1 id='author'> + <title>AUTHOR</title> + <para>BRLCAD-TEAM</para> +</refsect1> + +<refsect1 id='bug_reports'> + <title>BUG REPORTS</title> + <para> + Reports of bugs or problems should be submitted via electronic + mail to <de...@br...>, or via the "cadbug.sh" script. + </para> +</refsect1> +</refentry> + Property changes on: brlcad/trunk/doc/docbook/system/man3/en/libfb.xml ___________________________________________________________________ Added: svn:mime-type + text/xml Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml (rev 0) +++ brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml 2009-12-15 00:49:33 UTC (rev 36907) @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "../../../resources/standard/dtd/docbookx.dtd"> + +<refentry id=''> + +<refmeta> + <refentrytitle></refentrytitle> + <manvolnum>3</manvolnum> + <refmiscinfo class='source'>BRL-CAD</refmiscinfo> + <refmiscinfo class='manual'>BRL-CAD Libraries</refmiscinfo> +</refmeta> + +<refnamediv id='name'> + <refname></refname> + <refpurpose> + + </refpurpose> +</refnamediv> + +<!-- body begins here --> +<refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command></command> + <arg></arg> + </cmdsynopsis> +</refsynopsisdiv> + +<refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + + </para> +</refsect1> + +<refsect1 id='examples'> + <title>EXAMPLES</title> + <para> + + </para> + <example> + <title></title> + <variablelist> + <varlistentry> + <term><prompt></prompt> <userinput></userinput></term> + <listitem> + <para> + + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><prompt></prompt> <userinput></userinput></term> + <listitem> + <para> + + </para> + </listitem> + </varlistentry> + </variablelist> + </example> + + <example> + <title></title> + <para> + <prompt></prompt><userinput></userinput> + </para> + <para> + + </para> + </example> + +</refsect1> + +<refsect1 id='author'> + <title>AUTHOR</title> + <para>BRLCAD-TEAM</para> +</refsect1> + +<refsect1 id='bug_reports'> + <title>BUG REPORTS</title> + <para> + Reports of bugs or problems should be submitted via electronic + mail to <de...@br...>, or via the "cadbug.sh" script. + </para> +</refsect1> +</refentry> + Property changes on: brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml ___________________________________________________________________ Added: svn:mime-type + text/xml Added: svn:eol-style + native This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <br...@us...> - 2010-02-13 23:38:35
|
Revision: 37627 http://brlcad.svn.sourceforge.net/brlcad/?rev=37627&view=rev Author: brlcad Date: 2010-02-13 23:38:28 +0000 (Sat, 13 Feb 2010) Log Message: ----------- ignore generated docs Property Changed: ---------------- brlcad/trunk/doc/docbook/lessons/en/ brlcad/trunk/doc/docbook/lessons/es/ brlcad/trunk/doc/docbook/system/man1/en/ brlcad/trunk/doc/docbook/system/man3/en/ brlcad/trunk/doc/docbook/system/mann/en/ Property changes on: brlcad/trunk/doc/docbook/lessons/en ___________________________________________________________________ Modified: svn:ignore - *.html + *.html *.pdf Property changes on: brlcad/trunk/doc/docbook/lessons/es ___________________________________________________________________ Added: svn:ignore + *.html *.pdf Property changes on: brlcad/trunk/doc/docbook/system/man1/en ___________________________________________________________________ Modified: svn:ignore - *.1 *.html + *.1 *.html *.pdf Property changes on: brlcad/trunk/doc/docbook/system/man3/en ___________________________________________________________________ Added: svn:ignore + *.3 *.html *.pdf Property changes on: brlcad/trunk/doc/docbook/system/mann/en ___________________________________________________________________ Added: svn:ignore + *.html *.nged *.pdf This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2010-03-29 20:40:48
|
Revision: 38212 http://brlcad.svn.sourceforge.net/brlcad/?rev=38212&view=rev Author: starseeker Date: 2010-03-29 20:37:13 +0000 (Mon, 29 Mar 2010) Log Message: ----------- Needs some checking to make sure mged commands and command line commands are distinct, but this should take care of most of the conversion. Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am brlcad/trunk/doc/docbook/system/man1/en/Makefile.am brlcad/trunk/doc/docbook/system/mann/en/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/system/mann/en/Introduction.xml brlcad/trunk/doc/docbook/system/mann/en/anim_hardtrack.xml brlcad/trunk/doc/docbook/system/mann/en/anim_keyread.xml brlcad/trunk/doc/docbook/system/mann/en/anim_lookat.xml brlcad/trunk/doc/docbook/system/mann/en/anim_offset.xml brlcad/trunk/doc/docbook/system/mann/en/anim_orient.xml brlcad/trunk/doc/docbook/system/mann/en/animmate.xml brlcad/trunk/doc/docbook/system/mann/en/aproposdevel.xml brlcad/trunk/doc/docbook/system/mann/en/aproposlib.xml brlcad/trunk/doc/docbook/system/mann/en/arb.xml brlcad/trunk/doc/docbook/system/mann/en/arced.xml brlcad/trunk/doc/docbook/system/mann/en/area.xml brlcad/trunk/doc/docbook/system/mann/en/arot.xml brlcad/trunk/doc/docbook/system/mann/en/attach.xml brlcad/trunk/doc/docbook/system/mann/en/autoview.xml brlcad/trunk/doc/docbook/system/mann/en/bb.xml brlcad/trunk/doc/docbook/system/mann/en/bev.xml brlcad/trunk/doc/docbook/system/mann/en/bo.xml brlcad/trunk/doc/docbook/system/mann/en/bolt.xml brlcad/trunk/doc/docbook/system/mann/en/bot_condense.xml brlcad/trunk/doc/docbook/system/mann/en/bot_decimate.xml brlcad/trunk/doc/docbook/system/mann/en/bot_face_fuse.xml brlcad/trunk/doc/docbook/system/mann/en/bot_face_sort.xml brlcad/trunk/doc/docbook/system/mann/en/bot_vertex_fuse.xml brlcad/trunk/doc/docbook/system/mann/en/build_region.xml brlcad/trunk/doc/docbook/system/mann/en/c.xml brlcad/trunk/doc/docbook/system/mann/en/center.xml brlcad/trunk/doc/docbook/system/mann/en/color.xml brlcad/trunk/doc/docbook/system/mann/en/comb_color.xml brlcad/trunk/doc/docbook/system/mann/en/copyeval.xml brlcad/trunk/doc/docbook/system/mann/en/copymat.xml brlcad/trunk/doc/docbook/system/mann/en/cpi.xml brlcad/trunk/doc/docbook/system/mann/en/d.xml brlcad/trunk/doc/docbook/system/mann/en/dall.xml brlcad/trunk/doc/docbook/system/mann/en/db_glob.xml brlcad/trunk/doc/docbook/system/mann/en/dbconcat.xml brlcad/trunk/doc/docbook/system/mann/en/debugbu.xml brlcad/trunk/doc/docbook/system/mann/en/debugdir.xml brlcad/trunk/doc/docbook/system/mann/en/debuglib.xml brlcad/trunk/doc/docbook/system/mann/en/debugmem.xml brlcad/trunk/doc/docbook/system/mann/en/debugnmg.xml brlcad/trunk/doc/docbook/system/mann/en/decompose.xml brlcad/trunk/doc/docbook/system/mann/en/delay.xml brlcad/trunk/doc/docbook/system/mann/en/dm.xml brlcad/trunk/doc/docbook/system/mann/en/draw.xml brlcad/trunk/doc/docbook/system/mann/en/dup.xml brlcad/trunk/doc/docbook/system/mann/en/e_command.xml brlcad/trunk/doc/docbook/system/mann/en/e_muves.xml brlcad/trunk/doc/docbook/system/mann/en/eac.xml brlcad/trunk/doc/docbook/system/mann/en/echo.xml brlcad/trunk/doc/docbook/system/mann/en/edcodes.xml brlcad/trunk/doc/docbook/system/mann/en/edcolor.xml brlcad/trunk/doc/docbook/system/mann/en/edcomb.xml brlcad/trunk/doc/docbook/system/mann/en/edgedir.xml brlcad/trunk/doc/docbook/system/mann/en/edmater.xml brlcad/trunk/doc/docbook/system/mann/en/em.xml brlcad/trunk/doc/docbook/system/mann/en/eqn.xml brlcad/trunk/doc/docbook/system/mann/en/erase.xml brlcad/trunk/doc/docbook/system/mann/en/erase_all.xml brlcad/trunk/doc/docbook/system/mann/en/ev.xml brlcad/trunk/doc/docbook/system/mann/en/exit.xml brlcad/trunk/doc/docbook/system/mann/en/expand.xml brlcad/trunk/doc/docbook/system/mann/en/export_body.xml brlcad/trunk/doc/docbook/system/mann/en/extrude.xml brlcad/trunk/doc/docbook/system/mann/en/eye_pt.xml brlcad/trunk/doc/docbook/system/mann/en/facedef.xml brlcad/trunk/doc/docbook/system/mann/en/facetize.xml brlcad/trunk/doc/docbook/system/mann/en/find.xml brlcad/trunk/doc/docbook/system/mann/en/fracture.xml brlcad/trunk/doc/docbook/system/mann/en/g.xml brlcad/trunk/doc/docbook/system/mann/en/garbage_collect.xml brlcad/trunk/doc/docbook/system/mann/en/gastank.xml brlcad/trunk/doc/docbook/system/mann/en/gui.xml brlcad/trunk/doc/docbook/system/mann/en/handle.xml brlcad/trunk/doc/docbook/system/mann/en/help.xml brlcad/trunk/doc/docbook/system/mann/en/helpdevel.xml brlcad/trunk/doc/docbook/system/mann/en/helplib.xml brlcad/trunk/doc/docbook/system/mann/en/hide.xml brlcad/trunk/doc/docbook/system/mann/en/history.xml brlcad/trunk/doc/docbook/system/mann/en/i.xml brlcad/trunk/doc/docbook/system/mann/en/idents.xml brlcad/trunk/doc/docbook/system/mann/en/ill.xml brlcad/trunk/doc/docbook/system/mann/en/in.xml brlcad/trunk/doc/docbook/system/mann/en/inside.xml brlcad/trunk/doc/docbook/system/mann/en/item.xml brlcad/trunk/doc/docbook/system/mann/en/journal.xml brlcad/trunk/doc/docbook/system/mann/en/keep.xml brlcad/trunk/doc/docbook/system/mann/en/keypoint.xml brlcad/trunk/doc/docbook/system/mann/en/kill.xml brlcad/trunk/doc/docbook/system/mann/en/killall.xml brlcad/trunk/doc/docbook/system/mann/en/killtree.xml brlcad/trunk/doc/docbook/system/mann/en/knob.xml brlcad/trunk/doc/docbook/system/mann/en/l.xml brlcad/trunk/doc/docbook/system/mann/en/l_muves.xml brlcad/trunk/doc/docbook/system/mann/en/labelvert.xml brlcad/trunk/doc/docbook/system/mann/en/listeval.xml brlcad/trunk/doc/docbook/system/mann/en/lm.xml brlcad/trunk/doc/docbook/system/mann/en/loadtk.xml brlcad/trunk/doc/docbook/system/mann/en/lookat.xml brlcad/trunk/doc/docbook/system/mann/en/ls.xml brlcad/trunk/doc/docbook/system/mann/en/make.xml brlcad/trunk/doc/docbook/system/mann/en/make_bb.xml brlcad/trunk/doc/docbook/system/mann/en/mater.xml brlcad/trunk/doc/docbook/system/mann/en/matpick.xml brlcad/trunk/doc/docbook/system/mann/en/memprint.xml brlcad/trunk/doc/docbook/system/mann/en/mirface.xml brlcad/trunk/doc/docbook/system/mann/en/mrot.xml brlcad/trunk/doc/docbook/system/mann/en/mv.xml brlcad/trunk/doc/docbook/system/mann/en/mvall.xml brlcad/trunk/doc/docbook/system/mann/en/nmg_collapse.xml brlcad/trunk/doc/docbook/system/mann/en/nmg_simplify.xml brlcad/trunk/doc/docbook/system/mann/en/oed.xml brlcad/trunk/doc/docbook/system/mann/en/opendb.xml brlcad/trunk/doc/docbook/system/mann/en/orientation.xml brlcad/trunk/doc/docbook/system/mann/en/orot.xml brlcad/trunk/doc/docbook/system/mann/en/oscale.xml brlcad/trunk/doc/docbook/system/mann/en/overlay.xml brlcad/trunk/doc/docbook/system/mann/en/p.xml brlcad/trunk/doc/docbook/system/mann/en/pathlist.xml brlcad/trunk/doc/docbook/system/mann/en/paths.xml brlcad/trunk/doc/docbook/system/mann/en/permute.xml brlcad/trunk/doc/docbook/system/mann/en/picket_fence.xml brlcad/trunk/doc/docbook/system/mann/en/plot.xml brlcad/trunk/doc/docbook/system/mann/en/prcolor.xml brlcad/trunk/doc/docbook/system/mann/en/prefix.xml brlcad/trunk/doc/docbook/system/mann/en/press.xml brlcad/trunk/doc/docbook/system/mann/en/preview.xml brlcad/trunk/doc/docbook/system/mann/en/prj_add.xml brlcad/trunk/doc/docbook/system/mann/en/ps.xml brlcad/trunk/doc/docbook/system/mann/en/push.xml brlcad/trunk/doc/docbook/system/mann/en/putmat.xml brlcad/trunk/doc/docbook/system/mann/en/q.xml brlcad/trunk/doc/docbook/system/mann/en/qorot.xml brlcad/trunk/doc/docbook/system/mann/en/qray.xml brlcad/trunk/doc/docbook/system/mann/en/query_ray.xml brlcad/trunk/doc/docbook/system/mann/en/quit.xml brlcad/trunk/doc/docbook/system/mann/en/qvrot.xml brlcad/trunk/doc/docbook/system/mann/en/r.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-blend.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-cap.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-tgc.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-tor.xml brlcad/trunk/doc/docbook/system/mann/en/rcodes.xml brlcad/trunk/doc/docbook/system/mann/en/read_muves.xml brlcad/trunk/doc/docbook/system/mann/en/red.xml brlcad/trunk/doc/docbook/system/mann/en/redraw_vlist.xml brlcad/trunk/doc/docbook/system/mann/en/refresh.xml brlcad/trunk/doc/docbook/system/mann/en/regdebug.xml brlcad/trunk/doc/docbook/system/mann/en/regdef.xml brlcad/trunk/doc/docbook/system/mann/en/regions.xml brlcad/trunk/doc/docbook/system/mann/en/release.xml brlcad/trunk/doc/docbook/system/mann/en/rfarb.xml brlcad/trunk/doc/docbook/system/mann/en/rm.xml brlcad/trunk/doc/docbook/system/mann/en/rmater.xml brlcad/trunk/doc/docbook/system/mann/en/rmats.xml brlcad/trunk/doc/docbook/system/mann/en/rot.xml brlcad/trunk/doc/docbook/system/mann/en/rotobj.xml brlcad/trunk/doc/docbook/system/mann/en/rpp-arch.xml brlcad/trunk/doc/docbook/system/mann/en/rpp-cap.xml brlcad/trunk/doc/docbook/system/mann/en/rrt.xml brlcad/trunk/doc/docbook/system/mann/en/rtwizard.xml brlcad/trunk/doc/docbook/system/mann/en/savekey.xml brlcad/trunk/doc/docbook/system/mann/en/saveview.xml brlcad/trunk/doc/docbook/system/mann/en/sca.xml brlcad/trunk/doc/docbook/system/mann/en/search.xml brlcad/trunk/doc/docbook/system/mann/en/sed.xml brlcad/trunk/doc/docbook/system/mann/en/setview.xml brlcad/trunk/doc/docbook/system/mann/en/shader.xml brlcad/trunk/doc/docbook/system/mann/en/shell.xml brlcad/trunk/doc/docbook/system/mann/en/showmats.xml brlcad/trunk/doc/docbook/system/mann/en/size.xml brlcad/trunk/doc/docbook/system/mann/en/solids.xml brlcad/trunk/doc/docbook/system/mann/en/sph-part.xml brlcad/trunk/doc/docbook/system/mann/en/status.xml brlcad/trunk/doc/docbook/system/mann/en/window.xml brlcad/trunk/doc/docbook/system/mann/en/window_frame.xml brlcad/trunk/doc/docbook/system/mann/en/wire.xml Removed Paths: ------------- brlcad/trunk/doc/docbook/system/man1/en/3ptarb.xml brlcad/trunk/doc/docbook/system/man1/en/B.xml brlcad/trunk/doc/docbook/system/man1/en/E.xml brlcad/trunk/doc/docbook/system/man1/en/Introduction.xml brlcad/trunk/doc/docbook/system/man1/en/M.xml brlcad/trunk/doc/docbook/system/man1/en/Z.xml brlcad/trunk/doc/docbook/system/man1/en/adc.xml brlcad/trunk/doc/docbook/system/man1/en/ae.xml brlcad/trunk/doc/docbook/system/man1/en/alias-pix.xml brlcad/trunk/doc/docbook/system/man1/en/all_sf.xml brlcad/trunk/doc/docbook/system/man1/en/analyze.xml brlcad/trunk/doc/docbook/system/man1/en/anim_cascade.xml brlcad/trunk/doc/docbook/system/man1/en/anim_fly.xml brlcad/trunk/doc/docbook/system/man1/en/anim_hardtrack.xml brlcad/trunk/doc/docbook/system/man1/en/anim_keyread.xml brlcad/trunk/doc/docbook/system/man1/en/anim_lookat.xml brlcad/trunk/doc/docbook/system/man1/en/anim_offset.xml brlcad/trunk/doc/docbook/system/man1/en/anim_orient.xml brlcad/trunk/doc/docbook/system/man1/en/animmate.xml brlcad/trunk/doc/docbook/system/man1/en/aproposdevel.xml brlcad/trunk/doc/docbook/system/man1/en/aproposlib.xml brlcad/trunk/doc/docbook/system/man1/en/arb.xml brlcad/trunk/doc/docbook/system/man1/en/arced.xml brlcad/trunk/doc/docbook/system/man1/en/area.xml brlcad/trunk/doc/docbook/system/man1/en/arot.xml brlcad/trunk/doc/docbook/system/man1/en/attach.xml brlcad/trunk/doc/docbook/system/man1/en/autoview.xml brlcad/trunk/doc/docbook/system/man1/en/bb.xml brlcad/trunk/doc/docbook/system/man1/en/bev.xml brlcad/trunk/doc/docbook/system/man1/en/bo.xml brlcad/trunk/doc/docbook/system/man1/en/bolt.xml brlcad/trunk/doc/docbook/system/man1/en/bot_condense.xml brlcad/trunk/doc/docbook/system/man1/en/bot_decimate.xml brlcad/trunk/doc/docbook/system/man1/en/bot_face_fuse.xml brlcad/trunk/doc/docbook/system/man1/en/bot_face_sort.xml brlcad/trunk/doc/docbook/system/man1/en/bot_vertex_fuse.xml brlcad/trunk/doc/docbook/system/man1/en/build_region.xml brlcad/trunk/doc/docbook/system/man1/en/c.xml brlcad/trunk/doc/docbook/system/man1/en/center.xml brlcad/trunk/doc/docbook/system/man1/en/color.xml brlcad/trunk/doc/docbook/system/man1/en/comb_color.xml brlcad/trunk/doc/docbook/system/man1/en/copyeval.xml brlcad/trunk/doc/docbook/system/man1/en/copymat.xml brlcad/trunk/doc/docbook/system/man1/en/cpi.xml brlcad/trunk/doc/docbook/system/man1/en/d.xml brlcad/trunk/doc/docbook/system/man1/en/dall.xml brlcad/trunk/doc/docbook/system/man1/en/db_glob.xml brlcad/trunk/doc/docbook/system/man1/en/dbconcat.xml brlcad/trunk/doc/docbook/system/man1/en/debugbu.xml brlcad/trunk/doc/docbook/system/man1/en/debugdir.xml brlcad/trunk/doc/docbook/system/man1/en/debuglib.xml brlcad/trunk/doc/docbook/system/man1/en/debugmem.xml brlcad/trunk/doc/docbook/system/man1/en/debugnmg.xml brlcad/trunk/doc/docbook/system/man1/en/decompose.xml brlcad/trunk/doc/docbook/system/man1/en/delay.xml brlcad/trunk/doc/docbook/system/man1/en/dm.xml brlcad/trunk/doc/docbook/system/man1/en/draw.xml brlcad/trunk/doc/docbook/system/man1/en/dup.xml brlcad/trunk/doc/docbook/system/man1/en/e_command.xml brlcad/trunk/doc/docbook/system/man1/en/e_muves.xml brlcad/trunk/doc/docbook/system/man1/en/eac.xml brlcad/trunk/doc/docbook/system/man1/en/echo.xml brlcad/trunk/doc/docbook/system/man1/en/edcodes.xml brlcad/trunk/doc/docbook/system/man1/en/edcolor.xml brlcad/trunk/doc/docbook/system/man1/en/edcomb.xml brlcad/trunk/doc/docbook/system/man1/en/edgedir.xml brlcad/trunk/doc/docbook/system/man1/en/edmater.xml brlcad/trunk/doc/docbook/system/man1/en/em.xml brlcad/trunk/doc/docbook/system/man1/en/eqn.xml brlcad/trunk/doc/docbook/system/man1/en/erase.xml brlcad/trunk/doc/docbook/system/man1/en/erase_all.xml brlcad/trunk/doc/docbook/system/man1/en/ev.xml brlcad/trunk/doc/docbook/system/man1/en/exit.xml brlcad/trunk/doc/docbook/system/man1/en/expand.xml brlcad/trunk/doc/docbook/system/man1/en/export_body.xml brlcad/trunk/doc/docbook/system/man1/en/extrude.xml brlcad/trunk/doc/docbook/system/man1/en/eye_pt.xml brlcad/trunk/doc/docbook/system/man1/en/facedef.xml brlcad/trunk/doc/docbook/system/man1/en/facetize.xml brlcad/trunk/doc/docbook/system/man1/en/find.xml brlcad/trunk/doc/docbook/system/man1/en/fracture.xml brlcad/trunk/doc/docbook/system/man1/en/g.xml brlcad/trunk/doc/docbook/system/man1/en/garbage_collect.xml brlcad/trunk/doc/docbook/system/man1/en/gastank.xml brlcad/trunk/doc/docbook/system/man1/en/gui.xml brlcad/trunk/doc/docbook/system/man1/en/handle.xml brlcad/trunk/doc/docbook/system/man1/en/help.xml brlcad/trunk/doc/docbook/system/man1/en/helpdevel.xml brlcad/trunk/doc/docbook/system/man1/en/helplib.xml brlcad/trunk/doc/docbook/system/man1/en/hide.xml brlcad/trunk/doc/docbook/system/man1/en/history.xml brlcad/trunk/doc/docbook/system/man1/en/i.xml brlcad/trunk/doc/docbook/system/man1/en/idents.xml brlcad/trunk/doc/docbook/system/man1/en/ill.xml brlcad/trunk/doc/docbook/system/man1/en/in.xml brlcad/trunk/doc/docbook/system/man1/en/inside.xml brlcad/trunk/doc/docbook/system/man1/en/item.xml brlcad/trunk/doc/docbook/system/man1/en/journal.xml brlcad/trunk/doc/docbook/system/man1/en/keep.xml brlcad/trunk/doc/docbook/system/man1/en/keypoint.xml brlcad/trunk/doc/docbook/system/man1/en/kill.xml brlcad/trunk/doc/docbook/system/man1/en/killall.xml brlcad/trunk/doc/docbook/system/man1/en/killtree.xml brlcad/trunk/doc/docbook/system/man1/en/knob.xml brlcad/trunk/doc/docbook/system/man1/en/l.xml brlcad/trunk/doc/docbook/system/man1/en/l_muves.xml brlcad/trunk/doc/docbook/system/man1/en/labelvert.xml brlcad/trunk/doc/docbook/system/man1/en/listeval.xml brlcad/trunk/doc/docbook/system/man1/en/lm.xml brlcad/trunk/doc/docbook/system/man1/en/loadtk.xml brlcad/trunk/doc/docbook/system/man1/en/lookat.xml brlcad/trunk/doc/docbook/system/man1/en/ls.xml brlcad/trunk/doc/docbook/system/man1/en/make.xml brlcad/trunk/doc/docbook/system/man1/en/make_bb.xml brlcad/trunk/doc/docbook/system/man1/en/mater.xml brlcad/trunk/doc/docbook/system/man1/en/matpick.xml brlcad/trunk/doc/docbook/system/man1/en/memprint.xml brlcad/trunk/doc/docbook/system/man1/en/mirface.xml brlcad/trunk/doc/docbook/system/man1/en/mrot.xml brlcad/trunk/doc/docbook/system/man1/en/mv.xml brlcad/trunk/doc/docbook/system/man1/en/mvall.xml brlcad/trunk/doc/docbook/system/man1/en/nmg_collapse.xml brlcad/trunk/doc/docbook/system/man1/en/nmg_simplify.xml brlcad/trunk/doc/docbook/system/man1/en/oed.xml brlcad/trunk/doc/docbook/system/man1/en/opendb.xml brlcad/trunk/doc/docbook/system/man1/en/orientation.xml brlcad/trunk/doc/docbook/system/man1/en/orot.xml brlcad/trunk/doc/docbook/system/man1/en/oscale.xml brlcad/trunk/doc/docbook/system/man1/en/overlay.xml brlcad/trunk/doc/docbook/system/man1/en/p.xml brlcad/trunk/doc/docbook/system/man1/en/pathlist.xml brlcad/trunk/doc/docbook/system/man1/en/paths.xml brlcad/trunk/doc/docbook/system/man1/en/permute.xml brlcad/trunk/doc/docbook/system/man1/en/picket_fence.xml brlcad/trunk/doc/docbook/system/man1/en/plot.xml brlcad/trunk/doc/docbook/system/man1/en/prcolor.xml brlcad/trunk/doc/docbook/system/man1/en/prefix.xml brlcad/trunk/doc/docbook/system/man1/en/press.xml brlcad/trunk/doc/docbook/system/man1/en/preview.xml brlcad/trunk/doc/docbook/system/man1/en/prj_add.xml brlcad/trunk/doc/docbook/system/man1/en/ps.xml brlcad/trunk/doc/docbook/system/man1/en/push.xml brlcad/trunk/doc/docbook/system/man1/en/putmat.xml brlcad/trunk/doc/docbook/system/man1/en/q.xml brlcad/trunk/doc/docbook/system/man1/en/qorot.xml brlcad/trunk/doc/docbook/system/man1/en/qray.xml brlcad/trunk/doc/docbook/system/man1/en/query_ray.xml brlcad/trunk/doc/docbook/system/man1/en/quit.xml brlcad/trunk/doc/docbook/system/man1/en/qvrot.xml brlcad/trunk/doc/docbook/system/man1/en/r.xml brlcad/trunk/doc/docbook/system/man1/en/rcc-blend.xml brlcad/trunk/doc/docbook/system/man1/en/rcc-cap.xml brlcad/trunk/doc/docbook/system/man1/en/rcc-tgc.xml brlcad/trunk/doc/docbook/system/man1/en/rcc-tor.xml brlcad/trunk/doc/docbook/system/man1/en/rcodes.xml brlcad/trunk/doc/docbook/system/man1/en/read_muves.xml brlcad/trunk/doc/docbook/system/man1/en/red.xml brlcad/trunk/doc/docbook/system/man1/en/redraw_vlist.xml brlcad/trunk/doc/docbook/system/man1/en/refresh.xml brlcad/trunk/doc/docbook/system/man1/en/regdebug.xml brlcad/trunk/doc/docbook/system/man1/en/regdef.xml brlcad/trunk/doc/docbook/system/man1/en/regions.xml brlcad/trunk/doc/docbook/system/man1/en/release.xml brlcad/trunk/doc/docbook/system/man1/en/rfarb.xml brlcad/trunk/doc/docbook/system/man1/en/rm.xml brlcad/trunk/doc/docbook/system/man1/en/rmater.xml brlcad/trunk/doc/docbook/system/man1/en/rmats.xml brlcad/trunk/doc/docbook/system/man1/en/rot.xml brlcad/trunk/doc/docbook/system/man1/en/rotobj.xml brlcad/trunk/doc/docbook/system/man1/en/rpp-arch.xml brlcad/trunk/doc/docbook/system/man1/en/rpp-cap.xml brlcad/trunk/doc/docbook/system/man1/en/rrt.xml brlcad/trunk/doc/docbook/system/man1/en/rtwizard.xml brlcad/trunk/doc/docbook/system/man1/en/savekey.xml brlcad/trunk/doc/docbook/system/man1/en/saveview.xml brlcad/trunk/doc/docbook/system/man1/en/sca.xml brlcad/trunk/doc/docbook/system/man1/en/search.xml brlcad/trunk/doc/docbook/system/man1/en/sed.xml brlcad/trunk/doc/docbook/system/man1/en/setview.xml brlcad/trunk/doc/docbook/system/man1/en/shader.xml brlcad/trunk/doc/docbook/system/man1/en/shell.xml brlcad/trunk/doc/docbook/system/man1/en/showmats.xml brlcad/trunk/doc/docbook/system/man1/en/size.xml brlcad/trunk/doc/docbook/system/man1/en/solids.xml brlcad/trunk/doc/docbook/system/man1/en/sph-part.xml brlcad/trunk/doc/docbook/system/man1/en/status.xml brlcad/trunk/doc/docbook/system/man1/en/window.xml brlcad/trunk/doc/docbook/system/man1/en/window_frame.xml brlcad/trunk/doc/docbook/system/man1/en/wire.xml Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/Makefile.am 2010-03-29 20:37:13 UTC (rev 38212) @@ -86,9 +86,9 @@ ${lessonsDOCBOOK_ES_IMAGES} \ ${lessonsDOCBOOK_ES} \ ${man1DOCBOOK_EN} \ - ${man1INTRO_EN} \ ${man3DOCBOOK_EN} \ ${mannDOCBOOK_EN} \ + ${mannINTRO_EN} \ ${specificationsDOCBOOK_EN} \ README \ articles/en/Makefile.am \ Deleted: brlcad/trunk/doc/docbook/system/man1/en/3ptarb.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/3ptarb.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/3ptarb.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,166 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<refentry id='3ptarb1'> - -<refmeta> - <refentrytitle>3PTARB</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD User Commands</refmiscinfo> -</refmeta> - -<refnamediv id='name'> - <refname>3ptarb</refname> - <refpurpose> - Build an ARB8 shape by extruding a quadrilateral through a given thickness. - </refpurpose> -</refnamediv> - -<!-- body begins here --> -<refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command>3ptarb</command> - <arg>arb_name</arg> - <arg>x1</arg> - <arg>y1</arg> - <arg>z1</arg> - <arg>x2</arg> - <arg>y2</arg> - <arg>z2</arg> - <arg>x3</arg> - <arg>y3</arg> - <arg>z3</arg> - <arg>x/y/z</arg> - <arg>coord1</arg> - <arg>coord2</arg> - <arg>thickness</arg> - </cmdsynopsis> -</refsynopsisdiv> - -<refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - Build an ARB8 shape by extruding a quadrilateral - through a given thickness. The arguments may be - provided on the command line; if they are not, they - will be prompted for. The x1, y1, and z1 are the - coordinates of one corner of the quadrilateral. - x2, y2, z2, and x3, y3, z3 are the coordinates of - two other corners. Only two coordinates of the - fourth point are specified, and the code calculates - the third coordinate to ensure all four points are - coplanar. The x|y|z parameter indicates which - coordinate of the fourth point will be calculated by - the code. The coord1 and coord2 parameters supply the - other two coordinates. The direction of extrusion for - the quadrilateral is determined from the order of the - four resulting points by the right-hand rule; the - quadrilateral is extruded toward a viewer for whom - the points appear in counter-clockwise order. - </para> -</refsect1> - -<refsect1 id='examples'> - <title>EXAMPLES</title> - <para> - The following are run from the MGED command prompt: - </para> - <example> - <title>3ptarb example with BRL-CAD prompting for information</title> - <variablelist> - <varlistentry> - <term><prompt>mged> </prompt> <userinput>3ptarb</userinput></term> - <listitem> - <para> - Start the <command>3ptarb</command> command. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt>Enter name for this arb: </prompt> <userinput>thing</userinput></term> - <listitem> - <para> - The new ARB8 will be named <emphasis>thing</emphasis>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt>Enter X, Y, Z for point 1: </prompt> <userinput>0 0 0</userinput></term> - <listitem> - <para> - Point one is at the origin. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt>Enter X, Y, Z for point 2: </prompt> <userinput>1 0 0</userinput></term> - <listitem> - <para> - Point two is at (1, 0, 0). - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt>Enter X, Y, Z for point 3: </prompt> <userinput>1 1 0</userinput></term> - <listitem> - <para> - Point three is at (1, 1, 0). - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><prompt>Enter coordinate to solve for (x, y, or z): </prompt> <userinput>z</userinput></term> - <listitem> - <para> - The code will calculate the z coordinate of the fourth point. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt>Enter the X, Y coordinate values: </prompt> <userinput>0 1</userinput></term> - <listitem> - <para> - The x and y coordinates of the fourth point are 0 and 1. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt>Enter thickness for this arb: </prompt> <userinput>3</userinput></term> - <listitem> - <para> - The new ARB8 will be 3 units thick. - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - - <example> - <title>3ptarb command as single line input</title> - <para> - <prompt>mged> </prompt><userinput>3ptarb thing 0 0 0 1 0 0 1 1 0 z 0 1 3</userinput> - </para> - <para> - Same as above example, but with all arguments supplied on the command line. - </para> - </example> - -</refsect1> - -<refsect1 id='author'> - <title>AUTHOR</title> - <para>BRLCAD-TEAM</para> -</refsect1> - -<refsect1 id='bug_reports'> - <title>BUG REPORTS</title> - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> -</refsect1> -</refentry> - Deleted: brlcad/trunk/doc/docbook/system/man1/en/B.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/B.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/B.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,132 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<!-- Copyright (c) 2005-2010 United States Government as represented by --> -<!-- the U.S. Army Research Laboratory. --> -<!-- --> -<!-- Redistribution and use in source (Docbook format) and 'compiled' --> -<!-- forms (PDF, PostScript, HTML, RTF, etc), with or without --> -<!-- modification, are permitted provided that the following conditions --> -<!-- are met: --> -<!-- --> -<!-- 1. Redistributions of source code (Docbook format) must retain the --> -<!-- above copyright notice, this list of conditions and the following --> -<!-- disclaimer. --> -<!-- --> -<!-- 2. Redistributions in compiled form (transformed to other DTDs, --> -<!-- converted to PDF, PostScript, HTML, RTF, and other formats) must --> -<!-- reproduce the above copyright notice, this list of conditions and --> -<!-- the following disclaimer in the documentation and/or other --> -<!-- materials provided with the distribution. --> -<!-- --> -<!-- 3. The name of the author may not be used to endorse or promote --> -<!-- products derived from this documentation without specific prior --> -<!-- written permission. --> -<!-- --> -<!-- THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR "AS IS" AND ANY --> -<!-- EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE --> -<!-- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR --> -<!-- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR --> -<!-- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR --> -<!-- CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT --> -<!-- OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR --> -<!-- BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF --> -<!-- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT --> -<!-- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE --> -<!-- USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF --> -<!-- SUCH DAMAGE. --> - -<refentry id='B'> - - <refmeta> - <refentrytitle>B</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD User Commands</refmiscinfo> - </refmeta> - - <refnamediv id='name'> - <refname>B</refname> - <refpurpose> - Clears the <emphasis>mged</emphasis> display of any currently - displayed objects, then displays the list of objects provided in - the parameter list. - </refpurpose> - </refnamediv> - - <!-- body begins here --> - <refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command>B</command> - <group> - <arg choice='opt'>-A -o</arg> - <arg choice='plain' rep='repeat'><replaceable>attribute name</replaceable> {<replaceable>value</replaceable>}</arg> - </group> - <arg choice='opt'>-s</arg> - <arg choice='opt'>-C#/#/#</arg> - <arg choice='opt'>-R</arg> - <arg choice='opt'><replaceable>objects</replaceable></arg> - </cmdsynopsis> - </refsynopsisdiv> - - <refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - Clears the mged display of any currently displayed objects, then displays the list of - objects provided in the parameter list. Equivalent to the <command>Z</command> command followed by the - command <command>draw</command> <emphasis><objects></emphasis>. The <emphasis>-C</emphasis> option - provides the user a way to specify a color that overrides all other color specifications including - combination colors and region id-based colors. The <emphasis>-A </emphasis>and <emphasis>-o</emphasis> - options allow the user to select objects by attribute. The <emphasis>-s</emphasis> option specifies - that subtracted and intersected objects should be drawn with solid lines rather than dot-dash lines. - The -<I>R</I> option means do not automatically resize the view if no other objects are displayed. - See the <command>draw</command> command for a detailed description of the options. - </para> - </refsect1> - - <refsect1 id='examples'> - <title>EXAMPLES</title> - <para> - The following are run from the MGED command prompt. - </para> - <example> - <title>Display a named object</title> - <variablelist> - <varlistentry> - <term><prompt>mged></prompt> <userinput>B some_object</userinput></term> - <listitem> - <para> - The display clears, and the object named <emphasis>some_object</emphasis> is displayed. - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - - <example> - <title>Draw objects having an attribute with a value </title> - <para> - <prompt>mged></prompt><userinput>B -A -o Comment {First comment} Comment {Second comment}</userinput> - </para> - <para> - The display clears, then draws objects that have a "Comment" attribute with a value of either - "First comment" or "Second comment." - </para> - </example> - </refsect1> - - <refsect1 id='author'> - <title>AUTHOR</title> - <para>BRL-CAD Team</para> - </refsect1> - - <refsect1 id='bug_reports'> - <title>BUG REPORTS</title> - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> - </refsect1> -</refentry> - Deleted: brlcad/trunk/doc/docbook/system/man1/en/E.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/E.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/E.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,109 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<!-- Copyright (c) 2005-2010 United States Government as represented by --> -<!-- the U.S. Army Research Laboratory. --> -<!-- --> -<!-- Redistribution and use in source (Docbook format) and 'compiled' --> -<!-- forms (PDF, PostScript, HTML, RTF, etc), with or without --> -<!-- modification, are permitted provided that the following conditions --> -<!-- are met: --> -<!-- --> -<!-- 1. Redistributions of source code (Docbook format) must retain the --> -<!-- above copyright notice, this list of conditions and the following --> -<!-- disclaimer. --> -<!-- --> -<!-- 2. Redistributions in compiled form (transformed to other DTDs, --> -<!-- converted to PDF, PostScript, HTML, RTF, and other formats) must --> -<!-- reproduce the above copyright notice, this list of conditions and --> -<!-- the following disclaimer in the documentation and/or other --> -<!-- materials provided with the distribution. --> -<!-- --> -<!-- 3. The name of the author may not be used to endorse or promote --> -<!-- products derived from this documentation without specific prior --> -<!-- written permission. --> -<!-- --> -<!-- THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR "AS IS" AND ANY --> -<!-- EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE --> -<!-- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR --> -<!-- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR --> -<!-- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR --> -<!-- CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT --> -<!-- OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR --> -<!-- BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF --> -<!-- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT --> -<!-- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE --> -<!-- USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF --> -<!-- SUCH DAMAGE. --> - -<refentry id='E'> - - <refmeta> - <refentrytitle>E</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD User Commands</refmiscinfo> - </refmeta> - - <refnamediv id='name'> - <refname>E</refname> - <refpurpose> - Display <emphasis>objects</emphasis> in an evaluated form. - </refpurpose> - </refnamediv> - - <!-- body begins here --> - <refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command>E</command> - <arg choice='req'><replaceable>object</replaceable></arg> - <arg choice='opt'>-s</arg> - </cmdsynopsis> - </refsynopsisdiv> - - <refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - Displays objects in an evaluated form. All the Boolean operations indicated - in each object in <emphasis>objects</emphasis> will be performed, and a - resulting faceted approximation of the actual objects will be displayed. - Note that this is usually much slower than using the usual - <command>draw</command> command. The <emphasis>-s</emphasis> option provides - a more accurate, but slower, approximation. - </para> - </refsect1> - - <refsect1 id='examples'> - <title>EXAMPLES</title> - <para> - Display faceted approximation of an object. - </para> - <example> - <title>Display <emphasis>objects</emphasis> in an evaluated form</title> - <variablelist> - <varlistentry> - <term><prompt>mged></prompt> <userinput>E some_object</userinput></term> - <listitem> - <para> - Displays a faceted approximation of <emphasis>some_object</emphasis>. - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - </refsect1> - - <refsect1 id='author'> - <title>AUTHOR</title> - <para>BRL-CAD Team</para> - </refsect1> - - <refsect1 id='bug_reports'> - <title>BUG REPORTS</title> - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> - </refsect1> -</refentry> Deleted: brlcad/trunk/doc/docbook/system/man1/en/Introduction.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/Introduction.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/Introduction.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,18 +0,0 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" -"../../../resources/standard/dtd/docbookx.dtd"> -<article xmlns:xi="http://www.w3.org/2001/XInclude"> - <articleinfo> - <title>MGED Commands - Manual Pages</title> - </articleinfo> - - <para> - This is MGED's help system for commands available at the MGED prompt. - To bring up the manual page for a specific command select it from the - list to the left of this welcome message. - </para> - <para> - These manual pages are written in Docbook format and displayed as HTML - using the tkhtml3 Tk widget. - </para> - -</article> Deleted: brlcad/trunk/doc/docbook/system/man1/en/M.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/M.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/M.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,119 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<!-- Copyright (c) 2005-2010 United States Government as represented by --> -<!-- the U.S. Army Research Laboratory. --> -<!-- --> -<!-- Redistribution and use in source (Docbook format) and 'compiled' --> -<!-- forms (PDF, PostScript, HTML, RTF, etc), with or without --> -<!-- modification, are permitted provided that the following conditions --> -<!-- are met: --> -<!-- --> -<!-- 1. Redistributions of source code (Docbook format) must retain the --> -<!-- above copyright notice, this list of conditions and the following --> -<!-- disclaimer. --> -<!-- --> -<!-- 2. Redistributions in compiled form (transformed to other DTDs, --> -<!-- converted to PDF, PostScript, HTML, RTF, and other formats) must --> -<!-- reproduce the above copyright notice, this list of conditions and --> -<!-- the following disclaimer in the documentation and/or other --> -<!-- materials provided with the distribution. --> -<!-- --> -<!-- 3. The name of the author may not be used to endorse or promote --> -<!-- products derived from this documentation without specific prior --> -<!-- written permission. --> -<!-- --> -<!-- THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR "AS IS" AND ANY --> -<!-- EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE --> -<!-- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR --> -<!-- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR --> -<!-- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR --> -<!-- CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT --> -<!-- OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR --> -<!-- BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF --> -<!-- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT --> -<!-- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE --> -<!-- USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF --> -<!-- SUCH DAMAGE. --> - -<refentry id='M'> - - <refmeta> - <refentrytitle>M</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD User Commands</refmiscinfo> - </refmeta> - - <refnamediv id='name'> - <refname>M</refname> - <refpurpose> - Send an <emphasis>mged</emphasis> mouse event - </refpurpose> - </refnamediv> - - <!-- body begins here --> - <refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command>M</command> - <arg choice='req'>1/0</arg> - <arg choice='req'><replaceable>xpos ypos</replaceable></arg> - </cmdsynopsis> - </refsynopsisdiv> - - <refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - Sends an <emphasis>mged</emphasis> mouse (i.e., defaults to a middle - mouse button) event. The first argument indicates whether the event - should be a button press <emphasis>(1)</emphasis> or release - <emphasis>(0)</emphasis>. The <emphasis>xpos</emphasis> and - <emphasis>ypos</emphasis> arguments specify the mouse position in - <emphasis>mged</emphasis> screen coordinates between -2047 and +2047. - With the default bindings, an <emphasis>mged</emphasis> mouse event while in - the viewing mode moves the view so that the point currently at screen - position (<emphasis>xpos,ypos</emphasis>) is repositioned to the center - of the <emphasis>mged</emphasis> display (compare to the center - command). The <command>M</command> command may also be used in other - editing modes to simulate an <emphasis>mged</emphasis> mouse event. - </para> - </refsect1> - - <refsect1 id='examples'> - <title>EXAMPLES</title> - <para> - Translate the point at specified screen coordinates to the center of the - display. - </para> - <example> - <title>Translate the point at screen coordinates (100,100) to the center of the <emphasis>mged</emphasis> - display.</title> - <variablelist> - <varlistentry> - <term><prompt>mged</prompt> <userinput>M 1 100 100</userinput></term> - <listitem> - <para> - The point at screen coordinates (100,100)is repositioned to the - center of the display. - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - </refsect1> - - <refsect1 id='author'> - <title>AUTHOR</title> - <para>BRL-CAD Team</para> - </refsect1> - - <refsect1 id='bug_reports'> - <title>BUG REPORTS</title> - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> - </refsect1> -</refentry> - Modified: brlcad/trunk/doc/docbook/system/man1/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,213 +1,21 @@ man1DOCBOOK_EN = \ - system/man1/en/3ptarb.xml \ - system/man1/en/B.xml \ - system/man1/en/E.xml \ - system/man1/en/M.xml \ - system/man1/en/Z.xml \ - system/man1/en/adc.xml \ - system/man1/en/ae.xml \ - system/man1/en/alias-pix.xml \ - system/man1/en/all_sf.xml \ - system/man1/en/analyze.xml \ - system/man1/en/anim_cascade.xml \ - system/man1/en/anim_fly.xml \ - system/man1/en/anim_hardtrack.xml \ - system/man1/en/anim_keyread.xml \ - system/man1/en/anim_lookat.xml \ - system/man1/en/anim_offset.xml \ - system/man1/en/anim_orient.xml \ - system/man1/en/animmate.xml \ - system/man1/en/aproposdevel.xml \ - system/man1/en/aproposlib.xml \ - system/man1/en/arb.xml \ - system/man1/en/arced.xml \ - system/man1/en/area.xml \ - system/man1/en/arot.xml \ - system/man1/en/attach.xml \ - system/man1/en/autoview.xml \ - system/man1/en/bb.xml \ - system/man1/en/bev.xml \ - system/man1/en/bo.xml \ - system/man1/en/bolt.xml \ - system/man1/en/bot_condense.xml \ - system/man1/en/bot_decimate.xml \ - system/man1/en/bot_face_fuse.xml \ - system/man1/en/bot_face_sort.xml \ - system/man1/en/bot_vertex_fuse.xml \ - system/man1/en/build_region.xml \ system/man1/en/bwscale.xml \ - system/man1/en/c.xml \ - system/man1/en/center.xml \ system/man1/en/coil.xml \ - system/man1/en/color.xml \ - system/man1/en/comb_color.xml \ - system/man1/en/copyeval.xml \ - system/man1/en/copymat.xml \ - system/man1/en/cpi.xml \ - system/man1/en/d.xml \ - system/man1/en/dall.xml \ system/man1/en/db.xml \ - system/man1/en/db_glob.xml \ - system/man1/en/dbconcat.xml \ - system/man1/en/debugbu.xml \ - system/man1/en/debugdir.xml \ - system/man1/en/debuglib.xml \ - system/man1/en/debugmem.xml \ - system/man1/en/debugnmg.xml \ - system/man1/en/decompose.xml \ - system/man1/en/delay.xml \ - system/man1/en/dm.xml \ - system/man1/en/draw.xml \ - system/man1/en/dup.xml \ - system/man1/en/e_command.xml \ - system/man1/en/e_muves.xml \ - system/man1/en/eac.xml \ - system/man1/en/echo.xml \ - system/man1/en/edcodes.xml \ - system/man1/en/edcolor.xml \ - system/man1/en/edcomb.xml \ - system/man1/en/edgedir.xml \ - system/man1/en/edmater.xml \ - system/man1/en/em.xml \ - system/man1/en/eqn.xml \ - system/man1/en/erase.xml \ - system/man1/en/erase_all.xml \ - system/man1/en/ev.xml \ - system/man1/en/exit.xml \ - system/man1/en/expand.xml \ - system/man1/en/export_body.xml \ - system/man1/en/extrude.xml \ - system/man1/en/eye_pt.xml \ - system/man1/en/facedef.xml \ - system/man1/en/facetize.xml \ - system/man1/en/find.xml \ - system/man1/en/fracture.xml \ - system/man1/en/g.xml \ - system/man1/en/garbage_collect.xml \ - system/man1/en/gastank.xml \ system/man1/en/gqa.xml \ - system/man1/en/gui.xml \ - system/man1/en/handle.xml \ - system/man1/en/help.xml \ - system/man1/en/helpdevel.xml \ - system/man1/en/helplib.xml \ - system/man1/en/hide.xml \ - system/man1/en/history.xml \ - system/man1/en/i.xml \ - system/man1/en/idents.xml \ - system/man1/en/ill.xml \ - system/man1/en/in.xml \ - system/man1/en/inside.xml \ - system/man1/en/item.xml \ - system/man1/en/journal.xml \ - system/man1/en/keep.xml \ - system/man1/en/keypoint.xml \ - system/man1/en/kill.xml \ - system/man1/en/killall.xml \ - system/man1/en/killtree.xml \ - system/man1/en/knob.xml \ - system/man1/en/l.xml \ - system/man1/en/l_muves.xml \ - system/man1/en/labelvert.xml \ - system/man1/en/listeval.xml \ - system/man1/en/lm.xml \ - system/man1/en/loadtk.xml \ - system/man1/en/lookat.xml \ - system/man1/en/ls.xml \ - system/man1/en/make.xml \ - system/man1/en/make_bb.xml \ - system/man1/en/mater.xml \ - system/man1/en/matpick.xml \ - system/man1/en/memprint.xml \ system/man1/en/mged.xml \ - system/man1/en/mirface.xml \ - system/man1/en/mrot.xml \ - system/man1/en/mv.xml \ - system/man1/en/mvall.xml \ system/man1/en/nirt.xml \ - system/man1/en/nmg_collapse.xml \ - system/man1/en/nmg_simplify.xml \ - system/man1/en/oed.xml \ - system/man1/en/opendb.xml \ - system/man1/en/orientation.xml \ - system/man1/en/orot.xml \ - system/man1/en/oscale.xml \ - system/man1/en/overlay.xml \ - system/man1/en/p.xml \ - system/man1/en/pathlist.xml \ - system/man1/en/paths.xml \ - system/man1/en/permute.xml \ - system/man1/en/picket_fence.xml \ - system/man1/en/plot.xml \ - system/man1/en/prcolor.xml \ - system/man1/en/prefix.xml \ - system/man1/en/press.xml \ - system/man1/en/preview.xml \ - system/man1/en/prj_add.xml \ - system/man1/en/ps.xml \ - system/man1/en/push.xml \ - system/man1/en/putmat.xml \ - system/man1/en/q.xml \ - system/man1/en/qorot.xml \ - system/man1/en/qray.xml \ - system/man1/en/query_ray.xml \ - system/man1/en/quit.xml \ - system/man1/en/qvrot.xml \ - system/man1/en/r.xml \ - system/man1/en/rcc-blend.xml \ - system/man1/en/rcc-cap.xml \ - system/man1/en/rcc-tgc.xml \ - system/man1/en/rcc-tor.xml \ - system/man1/en/rcodes.xml \ - system/man1/en/read_muves.xml \ - system/man1/en/red.xml \ - system/man1/en/redraw_vlist.xml \ - system/man1/en/refresh.xml \ - system/man1/en/regdebug.xml \ - system/man1/en/regdef.xml \ - system/man1/en/regions.xml \ - system/man1/en/release.xml \ - system/man1/en/rfarb.xml \ - system/man1/en/rm.xml \ - system/man1/en/rmater.xml \ - system/man1/en/rmats.xml \ - system/man1/en/rot.xml \ - system/man1/en/rotobj.xml \ - system/man1/en/rpp-arch.xml \ - system/man1/en/rpp-cap.xml \ - system/man1/en/rrt.xml \ system/man1/en/rt.xml \ system/man1/en/rtarea.xml \ system/man1/en/rtcheck.xml \ system/man1/en/rtedge.xml \ - system/man1/en/rtwizard.xml \ - system/man1/en/savekey.xml \ - system/man1/en/saveview.xml \ - system/man1/en/sca.xml \ - system/man1/en/sed.xml \ - system/man1/en/setview.xml \ - system/man1/en/shader.xml \ - system/man1/en/shell.xml \ - system/man1/en/showmats.xml \ - system/man1/en/size.xml \ - system/man1/en/solids.xml \ - system/man1/en/sph-part.xml \ - system/man1/en/status.xml \ - system/man1/en/search.xml \ - system/man1/en/tire.xml \ - system/man1/en/window.xml \ - system/man1/en/window_frame.xml \ - system/man1/en/wire.xml + system/man1/en/tire.xml -man1INTRO_EN = \ - system/man1/en/Introduction.xml - man1DOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/man1/en man1DOCBOOK_ENhtml_DATA = $(BUILTMAN_ENHTML) BUILTMAN_ENHTML = \ - ${man1DOCBOOK_EN:xml=html} \ - ${man1INTRO_EN:xml=html} + ${man1DOCBOOK_EN:xml=html} if BUILD_PDF_DOCS Deleted: brlcad/trunk/doc/docbook/system/man1/en/Z.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/Z.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/Z.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,102 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<!-- Copyright (c) 2005-2010 United States Government as represented by --> -<!-- the U.S. Army Research Laboratory. --> -<!-- --> -<!-- Redistribution and use in source (Docbook format) and 'compiled' --> -<!-- forms (PDF, PostScript, HTML, RTF, etc), with or without --> -<!-- modification, are permitted provided that the following conditions --> -<!-- are met: --> -<!-- --> -<!-- 1. Redistributions of source code (Docbook format) must retain the --> -<!-- above copyright notice, this list of conditions and the following --> -<!-- disclaimer. --> -<!-- --> -<!-- 2. Redistributions in compiled form (transformed to other DTDs, --> -<!-- converted to PDF, PostScript, HTML, RTF, and other formats) must --> -<!-- reproduce the above copyright notice, this list of conditions and --> -<!-- the following disclaimer in the documentation and/or other --> -<!-- materials provided with the distribution. --> -<!-- --> -<!-- 3. The name of the author may not be used to endorse or promote --> -<!-- products derived from this documentation without specific prior --> -<!-- written permission. --> -<!-- --> -<!-- THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR "AS IS" AND ANY --> -<!-- EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE --> -<!-- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR --> -<!-- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR --> -<!-- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR --> -<!-- CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT --> -<!-- OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR --> -<!-- BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF --> -<!-- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT --> -<!-- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE --> -<!-- USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF --> -<!-- SUCH DAMAGE. --> - -<refentry id='Z'> - - <refmeta> - <refentrytitle>Z</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD User Commands</refmiscinfo> - </refmeta> - - <refnamediv id='name'> - <refname>Z</refname> - <refpurpose>Clear the <emphasis>mged</emphasis> display. - </refpurpose> - </refnamediv> - - <!-- body begins here --> - <refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command>Z</command> - </cmdsynopsis> - </refsynopsisdiv> - - <refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - Zap (i.e., clear) the <emphasis>mged</emphasis> display. - </para> - </refsect1> - - <refsect1 id='examples'> - <title>EXAMPLES</title> - <para> - Clear the <emphasis>mged</emphasis> display. - </para> - <example> - <title>Enter <command>Z</command> to clear the <emphasis>mged</emphasis> display. - </title> - <variablelist> - <varlistentry> - <term><prompt>mged></prompt> <userinput>Z</userinput></term> - <listitem> - <para>The <emphasis>mged</emphasis> display is clear. - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - </refsect1> - - <refsect1 id='author'> - <title>AUTHOR</title> - <para>BRL-CAD Team</para> - </refsect1> - - <refsect1 id='bug_reports'> - <title>BUG REPORTS</title> - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> - </refsect1> -</refentry> - Deleted: brlcad/trunk/doc/docbook/system/man1/en/adc.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/adc.xml 2010-03-29 18:49:40 UTC (rev 38211) +++ brlcad/trunk/doc/docbook/system/man1/en/adc.xml 2010-03-29 20:37:13 UTC (rev 38212) @@ -1,362 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<!-- Copyright (c) 2005-2010 United States Government as represented by --> -<!-- the U.S. Army Research Laboratory. --> -<!-- --> -<!-- Redistribution and use in source (Docbook format) and 'compiled' --> -<!-- forms (PDF, PostScript, HTML, RTF, etc), with or without --> -<!-- modification, are permitted provided that the following conditions --> -<!-- are met: --> -<!-- --> -<!-- 1. Redistributions of source code (Docbook format) must retain the --> -<!-- above copyright notice, this list of conditions and the following --> -<!-- disclaimer. --> -<!-- --> -<!-- 2. Redistributions in compiled form (transformed to other DTDs, --> -<!-- converted to PDF, PostScript, HTML, RTF, and other formats) must --> -<!-- reproduce the above copyright notice, this list of conditions and --> -<!-- the following disclaimer in the documentation and/or other --> -<!-- materials provided with the distribution. --> -<!-- --> -<!-- 3. The name of the author may not be used to endorse or promote --> -<!-- products derived from this documentation without specific prior --> -<!-- written permission. --> -<!-- --> -<!-- THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR "AS IS" AND ANY --> -<!-- EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE --> -<!-- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR --> -<!-- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR --> -<!-- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR --> -<!-- CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT --> -<!-- OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR --> -<!-- BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF --> -<!-- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT --> -<!-- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE --> -<!-- USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF --> -<!-- SUCH DAMAGE. --> - -<refentry id='adc'> - - <refmeta> - <refentrytitle>adc</refentrytitle> - <manvolnum>1</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD User Commands</refmiscinfo> - </refmeta> - - <refnamediv id='name'> - <refname>adc</refname> - <refpurpose>This command controls the angle/distance cursor. - </refpurpose> - </refnamediv> - - <!-- body begins here --> - <refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command>adc</command> - <arg>-i</arg> - <arg choice='plain'><replaceable>subcommand</replaceable></arg> - </cmdsynopsis> - </refsynopsisdiv> - - <refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - This command controls the angle/distance cursor. The <command>adc</command> command with no - arguments toggles the display of the angle/distance cursor (... [truncated message content] |
From: <sta...@us...> - 2010-04-20 15:31:45
|
Revision: 38629 http://brlcad.svn.sourceforge.net/brlcad/?rev=38629&view=rev Author: starseeker Date: 2010-04-20 15:31:38 +0000 (Tue, 20 Apr 2010) Log Message: ----------- More Docbook image tweakage Modified Paths: -------------- brlcad/trunk/doc/docbook/articles/en/Makefile.am brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.png brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig01.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig02.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig03.png brlcad/trunk/doc/docbook/articles/en/images/pipes_fig04.png brlcad/trunk/doc/docbook/lessons/en/Makefile.am brlcad/trunk/doc/docbook/lessons/en/mged02_learning_viewing_options.xml brlcad/trunk/doc/docbook/lessons/en/mged03_using_insert_command.xml Added Paths: ----------- brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig01.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zoomin.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zoomout.png brlcad/trunk/doc/docbook/lessons/en/images/mged03_shapes_in_command.png brlcad/trunk/doc/docbook/lessons/en/images/mged03_shapes_make_command.png brlcad/trunk/doc/docbook/lessons/en/images/mged03_wireframe_sph.png brlcad/trunk/doc/docbook/lessons/en/images/mged03_wireframe_sph_rcc.png Removed Paths: ------------- brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomin.png brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomout.png Modified: brlcad/trunk/doc/docbook/articles/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/articles/en/Makefile.am 2010-04-20 15:01:32 UTC (rev 38628) +++ brlcad/trunk/doc/docbook/articles/en/Makefile.am 2010-04-20 15:31:38 UTC (rev 38629) @@ -24,6 +24,7 @@ articles/en/images/ebm_primitive_fig01.png \ articles/en/images/ebm_primitive_fig02.png \ articles/en/images/ebm_primitive_fig03.png \ + articles/en/images/mgedrc_fig01.png \ articles/en/images/mgedrc_fig02.png \ articles/en/images/mgedrc_fig03.png \ articles/en/images/nirt_fig01.png \ Added: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig01.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig01.png ___________________________________________________________________ Added: svn:mime-type + image/png Modified: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig02.png =================================================================== (Binary files differ) Modified: brlcad/trunk/doc/docbook/articles/en/images/mgedrc_fig03.png =================================================================== (Binary files differ) Modified: brlcad/trunk/doc/docbook/articles/en/images/pipes_fig01.png =================================================================== (Binary files differ) Modified: brlcad/trunk/doc/docbook/articles/en/images/pipes_fig02.png =================================================================== (Binary files differ) Modified: brlcad/trunk/doc/docbook/articles/en/images/pipes_fig03.png =================================================================== (Binary files differ) Modified: brlcad/trunk/doc/docbook/articles/en/images/pipes_fig04.png =================================================================== (Binary files differ) Modified: brlcad/trunk/doc/docbook/lessons/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/lessons/en/Makefile.am 2010-04-20 15:01:32 UTC (rev 38628) +++ brlcad/trunk/doc/docbook/lessons/en/Makefile.am 2010-04-20 15:31:38 UTC (rev 38629) @@ -22,8 +22,8 @@ lessons/en/images/mged01_terminal.png \ lessons/en/images/mged02_coordsys.png \ lessons/en/images/mged02_defaultradio.png \ - lessons/en/images/mged02_flower_zooomin.png \ - lessons/en/images/mged02_flower_zooomout.png \ + lessons/en/images/mged02_flower_zoomin.png \ + lessons/en/images/mged02_flower_zoomout.png \ lessons/en/images/mged02_multipane.png \ lessons/en/images/mged02_radio_35_25.png \ lessons/en/images/mged02_radio_front.png \ @@ -40,6 +40,10 @@ lessons/en/images/mged02_truck_left.png \ lessons/en/images/mged02_truck_rear.png \ lessons/en/images/mged02_truck_right.png \ + lessons/en/images/mged03_shapes_in_command.png \ + lessons/en/images/mged03_shapes_make_command.png \ + lessons/en/images/mged03_wireframe_sph.png \ + lessons/en/images/mged03_wireframe_sph_rcc.png \ lessons/en/images/mged04_commandwindow.png \ lessons/en/images/mged04_fb_overlay_mode.png \ lessons/en/images/mged04_raytracedshapes.png \ Added: brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zoomin.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zoomin.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zoomout.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zoomout.png ___________________________________________________________________ Added: svn:mime-type + image/png Deleted: brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomin.png =================================================================== (Binary files differ) Deleted: brlcad/trunk/doc/docbook/lessons/en/images/mged02_flower_zooomout.png =================================================================== (Binary files differ) Added: brlcad/trunk/doc/docbook/lessons/en/images/mged03_shapes_in_command.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/lessons/en/images/mged03_shapes_in_command.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/lessons/en/images/mged03_shapes_make_command.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/lessons/en/images/mged03_shapes_make_command.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/lessons/en/images/mged03_wireframe_sph.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/lessons/en/images/mged03_wireframe_sph.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/lessons/en/images/mged03_wireframe_sph_rcc.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/lessons/en/images/mged03_wireframe_sph_rcc.png ___________________________________________________________________ Added: svn:mime-type + image/png Modified: brlcad/trunk/doc/docbook/lessons/en/mged02_learning_viewing_options.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/en/mged02_learning_viewing_options.xml 2010-04-20 15:01:32 UTC (rev 38628) +++ brlcad/trunk/doc/docbook/lessons/en/mged02_learning_viewing_options.xml 2010-04-20 15:31:38 UTC (rev 38629) @@ -245,8 +245,8 @@ <tgroup cols='2' align='center'> <tbody> <row> - <entry><inlinegraphic fileref="../../lessons/en/images/mged02_flower_zoomin.jpg" scale="60" /></entry> - <entry><inlinegraphic fileref="../../lessons/en/images/mged02_flower_zoomout.jpg" /></entry> + <entry><inlinegraphic fileref="../../lessons/en/images/mged02_flower_zoomin.png" scale="60" /></entry> + <entry><inlinegraphic fileref="../../lessons/en/images/mged02_flower_zoomout.png" /></entry> </row> <row> <entry>Zoom In to View Details (small size of view)</entry> Modified: brlcad/trunk/doc/docbook/lessons/en/mged03_using_insert_command.xml =================================================================== --- brlcad/trunk/doc/docbook/lessons/en/mged03_using_insert_command.xml 2010-04-20 15:01:32 UTC (rev 38628) +++ brlcad/trunk/doc/docbook/lessons/en/mged03_using_insert_command.xml 2010-04-20 15:31:38 UTC (rev 38629) @@ -82,7 +82,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/mged/using_insert_command_images/wireframesphere.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../lessons/en/images/mged03_wireframe_sph.png" format="PNG"></imagedata> </imageobject> <caption> <para> @@ -111,7 +111,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../lessons/en/images/mged03_wireframespherecylinder.png" format="PNG"></imagedata> + <imagedata align = "center" fileref="../../lessons/en/images/mged03_wireframe_sph_rcc.png" format="PNG"></imagedata> </imageobject> <caption> <para> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2010-05-11 01:15:31
|
Revision: 39090 http://brlcad.svn.sourceforge.net/brlcad/?rev=39090&view=rev Author: starseeker Date: 2010-05-11 01:15:24 +0000 (Tue, 11 May 2010) Log Message: ----------- Start getting a handle on the standard attributes and how they are named in BRL-CAD. Need to make sure once and for all that all the tools a) set and read values correctly given the new v5 attribute system b) don't do damage through lack of awareness of new attributes (see red bug) and c) correctly read and write attributes to/from files (red is ignoring new values currently - need to fix this, check other tools). Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/system/man5/ brlcad/trunk/doc/docbook/system/man5/en/ brlcad/trunk/doc/docbook/system/man5/en/Makefile.am brlcad/trunk/doc/docbook/system/man5/en/attributes.xml Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2010-05-10 18:18:04 UTC (rev 39089) +++ brlcad/trunk/doc/docbook/Makefile.am 2010-05-11 01:15:24 UTC (rev 39090) @@ -16,6 +16,10 @@ XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir +.xml.5: + XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? + @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir + .xml.nged: XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir @@ -35,6 +39,7 @@ include $(srcdir)/specifications/en/Makefile.am include $(srcdir)/system/man1/en/Makefile.am include $(srcdir)/system/man3/en/Makefile.am +include $(srcdir)/system/man5/en/Makefile.am include $(srcdir)/system/mann/en/Makefile.am if BUILD_DOCS @@ -52,6 +57,8 @@ $(BUILTMAN_ENPDF) \ $(BUILTMAN3_ENHTML) \ $(BUILTMAN3_ENPDF) \ + $(BUILTMAN5_ENHTML) \ + $(BUILTMAN5_ENPDF) \ $(BUILTMANN_ENHTML) \ $(BUILTMANN_ENPDF) \ $(BUILTLESSONS_ESHTML) \ @@ -60,6 +67,7 @@ BUILTMAN_EN_SOURCES = \ ${man1DOCBOOK_EN:xml=1} \ ${man3DOCBOOK_EN:xml=3} \ + ${man5DOCBOOK_EN:xml=5} \ ${mannDOCBOOK_EN:xml=nged} man_MANS = \ @@ -87,6 +95,7 @@ ${lessonsDOCBOOK_ES} \ ${man1DOCBOOK_EN} \ ${man3DOCBOOK_EN} \ + ${man5DOCBOOK_EN} \ ${mannDOCBOOK_EN} \ ${mannINTRO_EN} \ ${specificationsDOCBOOK_EN} \ @@ -108,6 +117,7 @@ system/man1/mged_cmd_template.xml \ system/man3/en/Makefile.am \ system/man3/mged_cmd_template.xml \ + system/man5/en/Makefile.am system/mann/en/Makefile.am include $(top_srcdir)/misc/Makefile.defs Added: brlcad/trunk/doc/docbook/system/man5/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/system/man5/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/system/man5/en/Makefile.am 2010-05-11 01:15:24 UTC (rev 39090) @@ -0,0 +1,17 @@ +man5DOCBOOK_EN = \ + system/man5/en/attributes.xml + +man5DOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/man5/en +man5DOCBOOK_ENhtml_DATA = $(BUILTMAN5_ENHTML) + +BUILTMAN5_ENHTML = \ + ${man5DOCBOOK_EN:xml=html} + +if BUILD_PDF_DOCS + +BUILTMAN5_ENPDF = ${man5DOCBOOK_EN:xml=pdf} + +endif + +man5DOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/man5/en +man5DOCBOOK_ENpdf_DATA = $(BUILTMAN5_ENPDF) Property changes on: brlcad/trunk/doc/docbook/system/man5/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/system/man5/en/attributes.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man5/en/attributes.xml (rev 0) +++ brlcad/trunk/doc/docbook/system/man5/en/attributes.xml 2010-05-11 01:15:24 UTC (rev 39090) @@ -0,0 +1,270 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "../../../resources/standard/dtd/docbookx.dtd"> + +<refentry id='attributes'> + +<refmeta> + <refentrytitle>Standard Attributes</refentrytitle> + <manvolnum>5</manvolnum> + <refmiscinfo class='source'>BRL-CAD</refmiscinfo> + <refmiscinfo class='manual'>BRL-CAD Standard Conventions</refmiscinfo> +</refmeta> + +<refnamediv id='name'> + <refname>attributes</refname> + <refpurpose> + standard attribute conventions in BRL-CAD databases + </refpurpose> +</refnamediv> + +<!-- body begins here --> +<refsect1 id='gift_background'> + <title>BACKGROUND</title> + <para> + Starting with BRL-CAD database format version 5, BRL-CAD supports + the storage of arbitrary attribute/value data on any database object. + Prior to the development of this generic ability, BRL-CAD supported a + set of standard attributes used to hold key information about specific + properties. These conventions predate not only the version 5 + database format but BRL-CAD itself. The purpose of this man page + is to identify the standard attributes, document situations where + two or more attributes are used to identify the same property, + and identify where appropriate what constitutes meaningful values + for an attribute. + </para> + + <para> + The earliest ancestor of BRL-CAD was the MAGIC code, written by + the Mathematical Applications Group, Inc in 1967 to implement geometric + modeling ideas developed by BRL and AMSAA from 1958-1967. That system, + which was entirely non-graphical, was followed some years later by the GIFT program - + Geometric Information From Targets. LIBRT, appearing around 1983, became the successor to GIFT. + Today it is the core library of the BRL-CAD solid modeling package. (For more background + see http://ftp.arl.army.mil/~mike/papers/96thebook/). LIBRT inherited + both geometric primitives and attributes from GIFT - this heritage + is occasionally apparent in attribute names. + </para> + <para> + Note that with the introduction of support for arbitrary attribute/value pairs, + it becomes much simpler for both developers and users to formulate new standards of their + own for storage of metadata in attributes. Attributes should only + be documented in this file if one or more core BRL-CAD tools has implemented + one or more features that require specific attributes to be present. Conventions + for attribute names that do not involve tool support should be documented + in appropriate user-level documentation. In documenting attributes, one + additional distinction is made. Attributes that exist only as post-v5 attribute/value + pairs are referred to as non-core attributes; older + attributes (which may also be represented in core data structures) are referred + to as core attributes. + </para> +</refsect1> + +<refsect1 id='core_attributes'> + <title>CORE ATTRIBUTES</title> + <para> + The following table lists all known core BRL-CAD attributes and + aliases. Any code setting or reading the value of one of these attributes + must handle all aliases, to ensure all functions asking for + the value in question get a consistent answer. + </para> + + <para> + <table> + <title>Core Attributes</title> + <tgroup cols='7'> + <colspec colname='c1' /> + <colspec colname='c2' /> + <colspec colname='c3' /> + <colspec colname='c4' /> + <colspec colname='c5' /> + <colspec colname='c6' /> + <colspec colname='c7' /> + <tbody> + <row> + <entry>Property</entry> + <entry namest="c2" nameend="c6" align="center">Attribute Name(s)</entry> + <entry>Typical Value(s)</entry> + </row> + <row> + <entry>Region Flag</entry> + <entry>region</entry> + <entry>REGION</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>Yes, R or 1</entry> + </row> + <row> + <entry>Region ID Number</entry> + <entry>region_id</entry> + <entry>REGION_ID</entry> + <entry>id</entry> + <entry>ID</entry> + <entry></entry> + <entry>-1, 0, and positive integers</entry> + </row> + <row> + <entry>Material ID Number</entry> + <entry>material_id</entry> + <entry>MATERIAL_ID</entry> + <entry>GIFTmater</entry> + <entry>GIFT_MATERIAL</entry> + <entry>mat</entry> + <entry>0 and positive integers</entry> + </row> + <row> + <entry>Air Flag</entry> + <entry>air</entry> + <entry>AIR</entry> + <entry>AIRCODE</entry> + <entry></entry> + <entry></entry> + <entry>0 or 1</entry> + </row> + <row> + <entry>Line Of Sight</entry> + <entry>los</entry> + <entry>LOS</entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> + <entry>Color (Red Green Blue)</entry> + <entry>rgb</entry> + <entry>RGB</entry> + <entry>COLOR</entry> + <entry></entry> + <entry></entry> + <entry>###/###/###</entry> + </row> + <row> + <entry>Shader Name</entry> + <entry>oshader</entry> + <entry>SHADER</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>string</entry> + </row> + <row> + <entry>Inherit Properties</entry> + <entry>inherit</entry> + <entry>INHERIT</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>Yes or 1</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + + <para> + Given the importance of these attributes, it is appropriate to briefly outline the + meaning and purpose of each of them: + + <variablelist remap='TP'> + <varlistentry> + <term><emphasis remap='B' role='bold'>Region Flag:</emphasis></term> + <listitem> + <para> + The Region Flag identifies a particular geometric combination as being a solid material - + in other words, any geometry below this combination in the tree can overlap without the + overlap being regarded as a non-physical description, since it is the combination of all + descriptions in the region object that define the physical volume in space. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Region ID Flag:</emphasis></term> + <listitem> + <para> + The Region ID Flag identifies a particular region with a unique number. This allows + multiple region objects to be regarded as being the same type of region, without + requiring that they be included in the same combination object. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Material ID Number:</emphasis></term> + <listitem> + <para> + The Material ID Number corresponds to an entry in a DENSITIES table, usually + contained in a text file. This table associates numbers with material names and density + information, used by analytical programs such as rtweight. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Air Flag:</emphasis></term> + <listitem> + <para> + The Air Flag alerts the raytracer that the region in question is modeling air, + which is handled by specialized rules in LIBRT. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Line of Sight:</emphasis></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Color:</emphasis></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Shader Name:</emphasis></term> + <listitem> + <para> + LIBRT can utilize a variety of shaders when rendering - this attribute holds a + text string which corresponds to the name of the shader to be used. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis remap='B' role='bold'>Inherit:</emphasis></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + +</refsect1> + +<refsect1 id='examples'> + <title>EXAMPLES</title> + <para> + </para> +</refsect1> + +<refsect1 id='see_also'><title>SEE ALSO</title> +<para><citerefentry><refentrytitle>attr</refentrytitle><manvolnum>n</manvolnum></citerefentry>.</para> +</refsect1> + +<refsect1 id='author'> + <title>AUTHOR</title> + <para>BRLCAD-TEAM</para> +</refsect1> + +<refsect1 id='bug_reports'> + <title>BUG REPORTS</title> + <para> + Reports of bugs or problems should be submitted via electronic + mail to <de...@br...>, or via the "cadbug.sh" script. + </para> +</refsect1> +</refentry> + Property changes on: brlcad/trunk/doc/docbook/system/man5/en/attributes.xml ___________________________________________________________________ Added: svn:mime-type + text/xml Added: svn:eol-style + native This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2011-01-30 15:51:26
|
Revision: 42767 http://brlcad.svn.sourceforge.net/brlcad/?rev=42767&view=rev Author: starseeker Date: 2011-01-30 15:51:13 +0000 (Sun, 30 Jan 2011) Log Message: ----------- Take the plunge... Docbook 4.5 is getting old and development efforts in the Docbook community have shifted to 5.0, which came out in Feb 2008. Updated docbook-xsl to docbook-xsl-ns (same version, 1.76.1) and convert xml files to Docbook 5. The local copy of the dtd does not appear to be needed any longer. Note that the conversion to Docbook 5 was done automatically using the upgrade tool, so review will be needed - the 'Converted by db4-upgrade' comment has been deliberately left in the files and should only be removed after review to ensure the files are properly set up using Docbook 5.0 Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am brlcad/trunk/doc/docbook/README brlcad/trunk/doc/docbook/articles/en/build_pattern.xml brlcad/trunk/doc/docbook/articles/en/build_region.xml brlcad/trunk/doc/docbook/articles/en/ebm_primitive.xml brlcad/trunk/doc/docbook/articles/en/mgedrc.xml brlcad/trunk/doc/docbook/articles/en/nirt.xml brlcad/trunk/doc/docbook/articles/en/oed.xml brlcad/trunk/doc/docbook/articles/en/pipes.xml brlcad/trunk/doc/docbook/articles/en/projection_shader.xml brlcad/trunk/doc/docbook/articles/en/tire.xml brlcad/trunk/doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeI.xml brlcad/trunk/doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeII.xml brlcad/trunk/doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml brlcad/trunk/doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIV.xml brlcad/trunk/doc/docbook/books/en/tutorial_series_authors.xml brlcad/trunk/doc/docbook/lessons/en/mged01_creating_primitive_shapes.xml brlcad/trunk/doc/docbook/lessons/en/mged02_learning_viewing_options.xml brlcad/trunk/doc/docbook/lessons/en/mged03_using_insert_command.xml brlcad/trunk/doc/docbook/lessons/en/mged04_assign_mat_prop_rt.xml brlcad/trunk/doc/docbook/lessons/en/mged05_learning_boolean_expressions.xml brlcad/trunk/doc/docbook/lessons/en/mged06_creating_a_goblet.xml brlcad/trunk/doc/docbook/lessons/en/mged07_goblet_material_properties.xml brlcad/trunk/doc/docbook/lessons/en/mged08_goblet_material_properties2.xml brlcad/trunk/doc/docbook/lessons/en/mged09_globe_in_display_box.xml brlcad/trunk/doc/docbook/lessons/en/mged10_creating_mug.xml brlcad/trunk/doc/docbook/lessons/en/mged11_refining_mug.xml brlcad/trunk/doc/docbook/lessons/en/mged12_mug_through_gui.xml brlcad/trunk/doc/docbook/lessons/en/mged13_placing_shapes_in_3d.xml brlcad/trunk/doc/docbook/lessons/en/mged14_placing_shapes_in_3d_2.xml brlcad/trunk/doc/docbook/lessons/en/mged15_creating_a_toy_truck.xml brlcad/trunk/doc/docbook/lessons/en/mged16_mod_tech_struct.xml brlcad/trunk/doc/docbook/lessons/es/mged01_crear_figuras_primitivas.xml brlcad/trunk/doc/docbook/lessons/es/mged02_opciones_vistas.xml brlcad/trunk/doc/docbook/lessons/es/mged03_utilizar_comando_in.xml brlcad/trunk/doc/docbook/lessons/es/mged04_prop_materiales.xml brlcad/trunk/doc/docbook/lessons/es/mged05_expresiones_booleanas.xml brlcad/trunk/doc/docbook/lessons/es/mged06_crear_una_copa.xml brlcad/trunk/doc/docbook/lessons/es/mged07_prop_materiales_copa.xml brlcad/trunk/doc/docbook/lessons/es/mged08_prop_materiales_copa2.xml brlcad/trunk/doc/docbook/lessons/es/mged09_esfera_en_caja_exhibidora.xml brlcad/trunk/doc/docbook/lessons/es/mged10_crear_taza.xml brlcad/trunk/doc/docbook/lessons/es/mged11_refinar_taza.xml brlcad/trunk/doc/docbook/lessons/es/mged12_taza_desde_gui.xml brlcad/trunk/doc/docbook/lessons/es/mged13_ubicar_figuras_en_3d.xml brlcad/trunk/doc/docbook/lessons/es/mged14_ubicar_figuras_en_3d_2.xml brlcad/trunk/doc/docbook/lessons/es/mged15_crear_camion_de_juguete.xml brlcad/trunk/doc/docbook/lessons/es/mged16_mod_tech_struct.xml brlcad/trunk/doc/docbook/resources/README brlcad/trunk/doc/docbook/specifications/en/BRL_CAD_g_format_V5.xml brlcad/trunk/doc/docbook/system/man1/en/bwscale.xml brlcad/trunk/doc/docbook/system/man1/en/coil.xml brlcad/trunk/doc/docbook/system/man1/en/db.xml brlcad/trunk/doc/docbook/system/man1/en/gqa.xml brlcad/trunk/doc/docbook/system/man1/en/mged.xml brlcad/trunk/doc/docbook/system/man1/en/nirt.xml brlcad/trunk/doc/docbook/system/man1/en/obj-g.xml brlcad/trunk/doc/docbook/system/man1/en/rt.xml brlcad/trunk/doc/docbook/system/man1/en/rtarea.xml brlcad/trunk/doc/docbook/system/man1/en/rtcheck.xml brlcad/trunk/doc/docbook/system/man1/en/rtedge.xml brlcad/trunk/doc/docbook/system/man1/en/tire.xml brlcad/trunk/doc/docbook/system/man3/en/libfb.xml brlcad/trunk/doc/docbook/system/man5/en/gattributes.xml brlcad/trunk/doc/docbook/system/mann/en/3ptarb.xml brlcad/trunk/doc/docbook/system/mann/en/B.xml brlcad/trunk/doc/docbook/system/mann/en/E.xml brlcad/trunk/doc/docbook/system/mann/en/Introduction.xml brlcad/trunk/doc/docbook/system/mann/en/M.xml brlcad/trunk/doc/docbook/system/mann/en/Z.xml brlcad/trunk/doc/docbook/system/mann/en/adc.xml brlcad/trunk/doc/docbook/system/mann/en/ae.xml brlcad/trunk/doc/docbook/system/mann/en/alias-pix.xml brlcad/trunk/doc/docbook/system/mann/en/all_sf.xml brlcad/trunk/doc/docbook/system/mann/en/analyze.xml brlcad/trunk/doc/docbook/system/mann/en/anim_cascade.xml brlcad/trunk/doc/docbook/system/mann/en/anim_fly.xml brlcad/trunk/doc/docbook/system/mann/en/anim_hardtrack.xml brlcad/trunk/doc/docbook/system/mann/en/anim_keyread.xml brlcad/trunk/doc/docbook/system/mann/en/anim_lookat.xml brlcad/trunk/doc/docbook/system/mann/en/anim_offset.xml brlcad/trunk/doc/docbook/system/mann/en/anim_orient.xml brlcad/trunk/doc/docbook/system/mann/en/animmate.xml brlcad/trunk/doc/docbook/system/mann/en/apropos.xml brlcad/trunk/doc/docbook/system/mann/en/aproposdevel.xml brlcad/trunk/doc/docbook/system/mann/en/aproposlib.xml brlcad/trunk/doc/docbook/system/mann/en/arb.xml brlcad/trunk/doc/docbook/system/mann/en/arced.xml brlcad/trunk/doc/docbook/system/mann/en/area.xml brlcad/trunk/doc/docbook/system/mann/en/arot.xml brlcad/trunk/doc/docbook/system/mann/en/attach.xml brlcad/trunk/doc/docbook/system/mann/en/attr.xml brlcad/trunk/doc/docbook/system/mann/en/autoview.xml brlcad/trunk/doc/docbook/system/mann/en/bb.xml brlcad/trunk/doc/docbook/system/mann/en/bev.xml brlcad/trunk/doc/docbook/system/mann/en/bo.xml brlcad/trunk/doc/docbook/system/mann/en/bolt.xml brlcad/trunk/doc/docbook/system/mann/en/bot_condense.xml brlcad/trunk/doc/docbook/system/mann/en/bot_decimate.xml brlcad/trunk/doc/docbook/system/mann/en/bot_face_fuse.xml brlcad/trunk/doc/docbook/system/mann/en/bot_face_sort.xml brlcad/trunk/doc/docbook/system/mann/en/bot_vertex_fuse.xml brlcad/trunk/doc/docbook/system/mann/en/build_region.xml brlcad/trunk/doc/docbook/system/mann/en/c.xml brlcad/trunk/doc/docbook/system/mann/en/cat.xml brlcad/trunk/doc/docbook/system/mann/en/center.xml brlcad/trunk/doc/docbook/system/mann/en/color.xml brlcad/trunk/doc/docbook/system/mann/en/comb_color.xml brlcad/trunk/doc/docbook/system/mann/en/copyeval.xml brlcad/trunk/doc/docbook/system/mann/en/copymat.xml brlcad/trunk/doc/docbook/system/mann/en/cp.xml brlcad/trunk/doc/docbook/system/mann/en/cpi.xml brlcad/trunk/doc/docbook/system/mann/en/d.xml brlcad/trunk/doc/docbook/system/mann/en/dall.xml brlcad/trunk/doc/docbook/system/mann/en/db.xml brlcad/trunk/doc/docbook/system/mann/en/db_glob.xml brlcad/trunk/doc/docbook/system/mann/en/dbconcat.xml brlcad/trunk/doc/docbook/system/mann/en/debugbu.xml brlcad/trunk/doc/docbook/system/mann/en/debugdir.xml brlcad/trunk/doc/docbook/system/mann/en/debuglib.xml brlcad/trunk/doc/docbook/system/mann/en/debugmem.xml brlcad/trunk/doc/docbook/system/mann/en/debugnmg.xml brlcad/trunk/doc/docbook/system/mann/en/decompose.xml brlcad/trunk/doc/docbook/system/mann/en/delay.xml brlcad/trunk/doc/docbook/system/mann/en/dm.xml brlcad/trunk/doc/docbook/system/mann/en/draw.xml brlcad/trunk/doc/docbook/system/mann/en/dup.xml brlcad/trunk/doc/docbook/system/mann/en/e_command.xml brlcad/trunk/doc/docbook/system/mann/en/e_muves.xml brlcad/trunk/doc/docbook/system/mann/en/eac.xml brlcad/trunk/doc/docbook/system/mann/en/echo.xml brlcad/trunk/doc/docbook/system/mann/en/edcodes.xml brlcad/trunk/doc/docbook/system/mann/en/edcolor.xml brlcad/trunk/doc/docbook/system/mann/en/edcomb.xml brlcad/trunk/doc/docbook/system/mann/en/edgedir.xml brlcad/trunk/doc/docbook/system/mann/en/edmater.xml brlcad/trunk/doc/docbook/system/mann/en/em.xml brlcad/trunk/doc/docbook/system/mann/en/eqn.xml brlcad/trunk/doc/docbook/system/mann/en/erase.xml brlcad/trunk/doc/docbook/system/mann/en/erase_all.xml brlcad/trunk/doc/docbook/system/mann/en/ev.xml brlcad/trunk/doc/docbook/system/mann/en/exit.xml brlcad/trunk/doc/docbook/system/mann/en/expand.xml brlcad/trunk/doc/docbook/system/mann/en/export_body.xml brlcad/trunk/doc/docbook/system/mann/en/extrude.xml brlcad/trunk/doc/docbook/system/mann/en/eye_pt.xml brlcad/trunk/doc/docbook/system/mann/en/facedef.xml brlcad/trunk/doc/docbook/system/mann/en/facetize.xml brlcad/trunk/doc/docbook/system/mann/en/find.xml brlcad/trunk/doc/docbook/system/mann/en/fracture.xml brlcad/trunk/doc/docbook/system/mann/en/g.xml brlcad/trunk/doc/docbook/system/mann/en/garbage_collect.xml brlcad/trunk/doc/docbook/system/mann/en/gastank.xml brlcad/trunk/doc/docbook/system/mann/en/gqa.xml brlcad/trunk/doc/docbook/system/mann/en/gui.xml brlcad/trunk/doc/docbook/system/mann/en/handle.xml brlcad/trunk/doc/docbook/system/mann/en/help.xml brlcad/trunk/doc/docbook/system/mann/en/helpdevel.xml brlcad/trunk/doc/docbook/system/mann/en/helplib.xml brlcad/trunk/doc/docbook/system/mann/en/hide.xml brlcad/trunk/doc/docbook/system/mann/en/history.xml brlcad/trunk/doc/docbook/system/mann/en/i.xml brlcad/trunk/doc/docbook/system/mann/en/idents.xml brlcad/trunk/doc/docbook/system/mann/en/ill.xml brlcad/trunk/doc/docbook/system/mann/en/in.xml brlcad/trunk/doc/docbook/system/mann/en/inside.xml brlcad/trunk/doc/docbook/system/mann/en/item.xml brlcad/trunk/doc/docbook/system/mann/en/journal.xml brlcad/trunk/doc/docbook/system/mann/en/keep.xml brlcad/trunk/doc/docbook/system/mann/en/keypoint.xml brlcad/trunk/doc/docbook/system/mann/en/kill.xml brlcad/trunk/doc/docbook/system/mann/en/killall.xml brlcad/trunk/doc/docbook/system/mann/en/killtree.xml brlcad/trunk/doc/docbook/system/mann/en/knob.xml brlcad/trunk/doc/docbook/system/mann/en/l.xml brlcad/trunk/doc/docbook/system/mann/en/l_muves.xml brlcad/trunk/doc/docbook/system/mann/en/labelvert.xml brlcad/trunk/doc/docbook/system/mann/en/listeval.xml brlcad/trunk/doc/docbook/system/mann/en/lm.xml brlcad/trunk/doc/docbook/system/mann/en/loadtk.xml brlcad/trunk/doc/docbook/system/mann/en/lookat.xml brlcad/trunk/doc/docbook/system/mann/en/ls.xml brlcad/trunk/doc/docbook/system/mann/en/make.xml brlcad/trunk/doc/docbook/system/mann/en/make_bb.xml brlcad/trunk/doc/docbook/system/mann/en/mater.xml brlcad/trunk/doc/docbook/system/mann/en/matpick.xml brlcad/trunk/doc/docbook/system/mann/en/memprint.xml brlcad/trunk/doc/docbook/system/mann/en/mirface.xml brlcad/trunk/doc/docbook/system/mann/en/mrot.xml brlcad/trunk/doc/docbook/system/mann/en/mv.xml brlcad/trunk/doc/docbook/system/mann/en/mvall.xml brlcad/trunk/doc/docbook/system/mann/en/nirt.xml brlcad/trunk/doc/docbook/system/mann/en/nmg_collapse.xml brlcad/trunk/doc/docbook/system/mann/en/nmg_simplify.xml brlcad/trunk/doc/docbook/system/mann/en/oed.xml brlcad/trunk/doc/docbook/system/mann/en/opendb.xml brlcad/trunk/doc/docbook/system/mann/en/orientation.xml brlcad/trunk/doc/docbook/system/mann/en/orot.xml brlcad/trunk/doc/docbook/system/mann/en/oscale.xml brlcad/trunk/doc/docbook/system/mann/en/overlay.xml brlcad/trunk/doc/docbook/system/mann/en/p.xml brlcad/trunk/doc/docbook/system/mann/en/pathlist.xml brlcad/trunk/doc/docbook/system/mann/en/paths.xml brlcad/trunk/doc/docbook/system/mann/en/permute.xml brlcad/trunk/doc/docbook/system/mann/en/picket_fence.xml brlcad/trunk/doc/docbook/system/mann/en/plot.xml brlcad/trunk/doc/docbook/system/mann/en/prcolor.xml brlcad/trunk/doc/docbook/system/mann/en/prefix.xml brlcad/trunk/doc/docbook/system/mann/en/press.xml brlcad/trunk/doc/docbook/system/mann/en/preview.xml brlcad/trunk/doc/docbook/system/mann/en/prj_add.xml brlcad/trunk/doc/docbook/system/mann/en/ps.xml brlcad/trunk/doc/docbook/system/mann/en/push.xml brlcad/trunk/doc/docbook/system/mann/en/put_comb.xml brlcad/trunk/doc/docbook/system/mann/en/putmat.xml brlcad/trunk/doc/docbook/system/mann/en/q.xml brlcad/trunk/doc/docbook/system/mann/en/qorot.xml brlcad/trunk/doc/docbook/system/mann/en/qray.xml brlcad/trunk/doc/docbook/system/mann/en/query_ray.xml brlcad/trunk/doc/docbook/system/mann/en/quit.xml brlcad/trunk/doc/docbook/system/mann/en/qvrot.xml brlcad/trunk/doc/docbook/system/mann/en/r.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-blend.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-cap.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-tgc.xml brlcad/trunk/doc/docbook/system/mann/en/rcc-tor.xml brlcad/trunk/doc/docbook/system/mann/en/rcodes.xml brlcad/trunk/doc/docbook/system/mann/en/read_muves.xml brlcad/trunk/doc/docbook/system/mann/en/red.xml brlcad/trunk/doc/docbook/system/mann/en/redraw_vlist.xml brlcad/trunk/doc/docbook/system/mann/en/refresh.xml brlcad/trunk/doc/docbook/system/mann/en/regdebug.xml brlcad/trunk/doc/docbook/system/mann/en/regdef.xml brlcad/trunk/doc/docbook/system/mann/en/regions.xml brlcad/trunk/doc/docbook/system/mann/en/release.xml brlcad/trunk/doc/docbook/system/mann/en/rfarb.xml brlcad/trunk/doc/docbook/system/mann/en/rm.xml brlcad/trunk/doc/docbook/system/mann/en/rmater.xml brlcad/trunk/doc/docbook/system/mann/en/rmats.xml brlcad/trunk/doc/docbook/system/mann/en/rot.xml brlcad/trunk/doc/docbook/system/mann/en/rotobj.xml brlcad/trunk/doc/docbook/system/mann/en/rpp-arch.xml brlcad/trunk/doc/docbook/system/mann/en/rpp-cap.xml brlcad/trunk/doc/docbook/system/mann/en/rrt.xml brlcad/trunk/doc/docbook/system/mann/en/rt.xml brlcad/trunk/doc/docbook/system/mann/en/rtcheck.xml brlcad/trunk/doc/docbook/system/mann/en/rtwizard.xml brlcad/trunk/doc/docbook/system/mann/en/savekey.xml brlcad/trunk/doc/docbook/system/mann/en/saveview.xml brlcad/trunk/doc/docbook/system/mann/en/sca.xml brlcad/trunk/doc/docbook/system/mann/en/search.xml brlcad/trunk/doc/docbook/system/mann/en/sed.xml brlcad/trunk/doc/docbook/system/mann/en/setview.xml brlcad/trunk/doc/docbook/system/mann/en/shader.xml brlcad/trunk/doc/docbook/system/mann/en/shell.xml brlcad/trunk/doc/docbook/system/mann/en/showmats.xml brlcad/trunk/doc/docbook/system/mann/en/size.xml brlcad/trunk/doc/docbook/system/mann/en/solids.xml brlcad/trunk/doc/docbook/system/mann/en/sph-part.xml brlcad/trunk/doc/docbook/system/mann/en/status.xml brlcad/trunk/doc/docbook/system/mann/en/summary.xml brlcad/trunk/doc/docbook/system/mann/en/sv.xml brlcad/trunk/doc/docbook/system/mann/en/sync.xml brlcad/trunk/doc/docbook/system/mann/en/t.xml brlcad/trunk/doc/docbook/system/mann/en/t_muves.xml brlcad/trunk/doc/docbook/system/mann/en/ted.xml brlcad/trunk/doc/docbook/system/mann/en/title.xml brlcad/trunk/doc/docbook/system/mann/en/tol.xml brlcad/trunk/doc/docbook/system/mann/en/tops.xml brlcad/trunk/doc/docbook/system/mann/en/tor-rcc.xml brlcad/trunk/doc/docbook/system/mann/en/tra.xml brlcad/trunk/doc/docbook/system/mann/en/track.xml brlcad/trunk/doc/docbook/system/mann/en/translate.xml brlcad/trunk/doc/docbook/system/mann/en/tree.xml brlcad/trunk/doc/docbook/system/mann/en/units.xml brlcad/trunk/doc/docbook/system/mann/en/vars.xml brlcad/trunk/doc/docbook/system/mann/en/vdraw.xml brlcad/trunk/doc/docbook/system/mann/en/view.xml brlcad/trunk/doc/docbook/system/mann/en/viewsize.xml brlcad/trunk/doc/docbook/system/mann/en/vnirt.xml brlcad/trunk/doc/docbook/system/mann/en/vquery_ray.xml brlcad/trunk/doc/docbook/system/mann/en/vrmgr.xml brlcad/trunk/doc/docbook/system/mann/en/vrot.xml brlcad/trunk/doc/docbook/system/mann/en/wcodes.xml brlcad/trunk/doc/docbook/system/mann/en/whatid.xml brlcad/trunk/doc/docbook/system/mann/en/which_shader.xml brlcad/trunk/doc/docbook/system/mann/en/whichair.xml brlcad/trunk/doc/docbook/system/mann/en/whichid.xml brlcad/trunk/doc/docbook/system/mann/en/who.xml brlcad/trunk/doc/docbook/system/mann/en/window.xml brlcad/trunk/doc/docbook/system/mann/en/window_frame.xml brlcad/trunk/doc/docbook/system/mann/en/wire.xml brlcad/trunk/doc/docbook/system/mann/en/wmater.xml brlcad/trunk/doc/docbook/system/mann/en/x.xml brlcad/trunk/doc/docbook/system/mann/en/xpush.xml brlcad/trunk/doc/docbook/system/mann/en/zoom.xml Removed Paths: ------------- brlcad/trunk/doc/docbook/catalog.xml brlcad/trunk/doc/docbook/resources/standard/dtd/ Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/Makefile.am 2011-01-30 15:51:13 UTC (rev 42767) @@ -2,26 +2,25 @@ XSL_XHTML_STYLESHEET=$(top_srcdir)/doc/docbook/resources/standard/xsl/xhtml-1_1/docbook.xsl XSL_MAN_STYLESHEET=$(top_srcdir)/doc/docbook/resources/standard/xsl/manpages/docbook.xsl XSL_FO_STYLESHEET=$(top_srcdir)/doc/docbook/resources/standard/xsl/fo/docbook.xsl -XML_CATALOG_FILES=$(top_srcdir)/doc/docbook/catalog.xml .xml.html: @mkdir -p $$(dirname $@) - XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) -o $@ $(XSL_XHTML_STYLESHEET) $? + $(XSLTPROC) $(XSLTPROC_FLAGS) -o $@ $(XSL_XHTML_STYLESHEET) $? .xml.1: - XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? + $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir .xml.3: - XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? + $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir .xml.5: - XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? + $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir .xml.nged: - XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? + $(XSLTPROC) $(XSLTPROC_FLAGS) $(XSL_MAN_STYLESHEET) $? @dir="$$(dirname $@)" && mkdir -p $$dir && mv '$(@F)' $$dir .fo.pdf: .xml.fo @@ -29,7 +28,7 @@ .xml.fo: @mkdir -p $$(dirname $@) - XML_CATALOG_FILES=$(XML_CATALOG_FILES) $(XSLTPROC) $(XSLTPROC_FLAGS) -o $@ $(XSL_FO_STYLESHEET) $? + $(XSLTPROC) $(XSLTPROC_FLAGS) -o $@ $(XSL_FO_STYLESHEET) $? include $(srcdir)/articles/en/Makefile.am Modified: brlcad/trunk/doc/docbook/README =================================================================== --- brlcad/trunk/doc/docbook/README 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/README 2011-01-30 15:51:13 UTC (rev 42767) @@ -1,11 +1,8 @@ -This directory contains (as of Sept. 2008) the current docbook work on -Volume II and Volume II of the BRL-CAD Tutorial Series, as well as the oed -and tire articles. It also holds the current test examples of the new -docbook based manual page conversions. +This directory holds the Docbook documentation for BRL-CAD - over time, +this should become the repository for all tutorials, man pages, and other +non-autogenerated, formatted documentation for BRL-CAD. -The default dtd and xsl stylesheets for docbook 4.5 are present -in the resources directory, and it is these copies that are -referenced in the docbook files. +The xsl stylesheets for docbook are present in the resources directory. The current structure is as follows: @@ -24,7 +21,7 @@ lessons that made up Volume II. resources/ - The DocBook 4.5 dtd and xsl files are contained within the + The DocBook xsl files are contained within the "standard" subdirectory. Custom files will be organized under this directory in the future. @@ -44,6 +41,11 @@ a definition is updated for one document, re-generation of other documents will incorporate the update as well without requiring redundant editing. +Caution - the BRL-CAD build logic is not aware of the interlinking of +various xml files using xinclude. This means that a change on one document +may make other output files out of date, and this will not trigger a +re-build of those file automatically. + Notes: * When rendered to html output and placed on a server, there may arise Modified: brlcad/trunk/doc/docbook/articles/en/build_pattern.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/en/build_pattern.xml 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/articles/en/build_pattern.xml 2011-01-30 15:51:13 UTC (rev 42767) @@ -1,18 +1,18 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" -"../../resources/standard/dtd/docbookx.dtd"> -<article xmlns:xi="http://www.w3.org/2001/XInclude"> - <articleinfo> - <title>Using the Build Pattern Tool</title> +<!-- Converted by db4-upgrade version 1.0 --> - <xi:include href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> +<article xmlns="http://docbook.org/ns/docbook" version="5.0"> + <info><title>Using the Build Pattern Tool</title> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + <legalnotice> <para>Approved for public release; distribution is unlimited</para> </legalnotice> - </articleinfo> + </info> - <sect1 id="build_pattern_generalinfo"> - <title>General Pattern Information</title> + <section xml:id="build_pattern_generalinfo"><info><title>General Pattern Information</title></info> + <para> As mentioned previously, the Build Pattern tool automates the process of making copies of existing geometry in rectangular, spherical, or @@ -40,10 +40,10 @@ object. That is to say, the object that is patterned is not included in the resultant pattern. </para> - </sect1> + </section> - <sect1 id="build_pattern_names"> - <title>Pattern Names</title> + <section xml:id="build_pattern_names"><info><title>Pattern Names</title></info> + <para> As shown in Figure E-1, the tool appends three numbers to all patterned objects (unless you are using the increment option for primitives, in @@ -56,10 +56,10 @@ the second number references the height, and the third number references the azimuth. </para> - </sect1> + </section> - <sect1 id="build_pattern_fields"> - <title>Common Fields for all Patterns:</title> + <section xml:id="build_pattern_fields"><info><title>Common Fields for all Patterns:</title></info> + <para> There are several fields in the pattern tool GUI that are common to all types of patterns. @@ -75,11 +75,11 @@ will replace the source string. </para> - <figure> - <title>Example of pattern-generated assembly names.</title> + <figure><info><title>Example of pattern-generated assembly names.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_pattern_fig01.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig01.png" format="PNG"/> </imageobject> </mediaobject> </figure> @@ -91,7 +91,7 @@ the largest span. For example, to create a pattern to the primitive level with the following primitives (which may or may not be in regions or assemblies), - <literallayout> + <literallayout class="normal"> part.s22 part.s22-1 part.s23 part.s24 part.s24+1 part.s24-1 part.s25, </literallayout> one needs to determine the span. Note that the leftmost numbers in these @@ -101,7 +101,7 @@ *******NEED FIGURE HERE***** If we use an increment of four, we will get the following set of primitives. - <literallayout> + <literallayout class="normal"> part.s26 part.s26-1 part.s27 part.s28 part.s28+1 part.s28-1 part.s29 </literallayout> @@ -113,23 +113,23 @@ Finally, the Objects field is used for the names of all the items to be patterned. </para> - </sect1> + </section> - <sect1 id="build_pattern_stringsub"> - <title>String Substitution</title> + <section xml:id="build_pattern_stringsub"><info><title>String Substitution</title></info> + <para> It is also possible to create a pattern in which a string of characters in - each element in the object is changed (e.g., "l_" -> "r_"). This is useful + each element in the object is changed (e.g., "l_" -> "r_"). This is useful for symmetry applications (e.g., left - right) or series (e.g., 1 - n). Each element of the object must have the source string so the user must be thorough and name each primitive, region, and assembly properly. Consider the following example: - <inlinegraphic fileref="../../articles/en/images/build_pattern_fig07.png" /> + <inlinemediaobject><imageobject><imagedata fileref="../../articles/en/images/build_pattern_fig07.png"/></imageobject></inlinemediaobject> </para> <para> Top-level duplications copy the patterned object and reference its entire structure with matrices, as follows: - <literallayout> + <literallayout class="normal"> /pattern group /COPIED assemblies [MATRICES] /assemblies @@ -140,7 +140,7 @@ Region-level duplications copy all assembly and regions and reference from the region level down with matrices. - <literallayout> + <literallayout class="normal"> /pattern group /COPIED assemblies /COPIED regions [MATRICES] @@ -150,7 +150,7 @@ Primitive-level duplications copy the entire tree structure to the primitive level without matrices using an increment on all primitives. - <literallayout> + <literallayout class="normal"> /pattern group /COPIED assemblies NO MATRICES /COPIED regions @@ -158,10 +158,10 @@ </literallayout> </para> - </sect1> + </section> - <sect1 id="build_pattern_recpatterns"> - <title>Rectangular Patterns</title> + <section xml:id="build_pattern_recpatterns"><info><title>Rectangular Patterns</title></info> + <para> The rectangular pattern GUI (shown in Figure E-2) is designed to facilitate one-, two-, or three-dimensional rectangular patterns. The @@ -174,19 +174,19 @@ axis. </para> - <figure> - <title>The user interface for building rectangular patterns.</title> + <figure><info><title>The user interface for building rectangular patterns.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_pattern_fig02.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig02.png" format="PNG"/> </imageobject> </mediaobject> </figure> - </sect1> + </section> - <sect1 id="build_pattern_spherical"> - <title>Spherical Patterns</title> + <section xml:id="build_pattern_spherical"><info><title>Spherical Patterns</title></info> + <para> The spherical pattern GUI (shown in Figure E-3) facilitates sphere-shaped patterns rotated around a center vertex using user-specified radii with @@ -228,11 +228,11 @@ specifies a list of radius offsets. </para> - <figure> - <title>The user interface for building spherical patterns.</title> + <figure><info><title>The user interface for building spherical patterns.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_pattern_fig03.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig03.png" format="PNG"/> </imageobject> </mediaobject> </figure> @@ -251,29 +251,29 @@ </para> - <figure> - <title>Examples of different spherical pattern orientations.</title> + <figure><info><title>Examples of different spherical pattern orientations.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_pattern_fig04.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig04.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <figure> - <title>Implementation of spherical patterns.</title> + <figure><info><title>Implementation of spherical patterns.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_pattern_fig05.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig05.png" format="PNG"/> </imageobject> </mediaobject> </figure> - </sect1> + </section> - <sect1 id="build_pattern_cylind"> - <title>Cylindrical Patterns</title> + <section xml:id="build_pattern_cylind"><info><title>Cylindrical Patterns</title></info> + <para> The cylindrical pattern GUI (shown in Figure E-6) facilitates the creation of cylinder-shaped patterns with user-defined center, direction, height, @@ -286,15 +286,15 @@ pattern will place the Object Center. </para> - <figure> - <title>The user interface for building cylindrical patterns.</title> + <figure><info><title>The user interface for building cylindrical patterns.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_pattern_fig06.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_pattern_fig06.png" format="PNG"/> </imageobject> </mediaobject> </figure> - </sect1> + </section> </article> Modified: brlcad/trunk/doc/docbook/articles/en/build_region.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/en/build_region.xml 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/articles/en/build_region.xml 2011-01-30 15:51:13 UTC (rev 42767) @@ -1,17 +1,17 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" -"../../resources/standard/dtd/docbookx.dtd"> -<article xmlns:xi="http://www.w3.org/2001/XInclude"> - <articleinfo> - <title>Using the build_region Command</title> +<!-- Converted by db4-upgrade version 1.0 --> - <xi:include href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> +<article xmlns="http://docbook.org/ns/docbook" version="5.0"> + <info><title>Using the build_region Command</title> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + <legalnotice> <para>Approved for public release; distribution is unlimited</para> </legalnotice> - </articleinfo> + </info> - <para id="build_region1"> + <para xml:id="build_region1"> Just as the Build Pattern tool can help automate the process of building multiple occurrences of objects, the build_region command can help automate the process of creating regions. The command (which currently has @@ -19,13 +19,13 @@ in the primitive name based on the intended use of the primitive. </para> - <para id="build_region2"> + <para xml:id="build_region2"> The user includes the Boolean operation and relational information in the name of the primitive using a simple naming convention. The naming convention is designed around the following two assumptions: </para> - <itemizedlist id="build_region3"> + <itemizedlist xml:id="build_region3"> <listitem> <para> The same text "tag" is used for all primitives in a region. @@ -38,7 +38,7 @@ </listitem> </itemizedlist> - <para id="build_region4"> + <para xml:id="build_region4"> For example, let's say we want to build the four rounded corners of a "tub" region for a toy metal wagon assembly (see Figure F-1). We could choose something such as "wgn"--an abbreviated form of "wagon"--as the @@ -46,16 +46,16 @@ assembly name. Our primitives would therefore be of the form wgn.s#. </para> - <figure id="build_region5"> - <title>The rounded corners of a toy wagon.</title> + <figure xml:id="build_region5"><info><title>The rounded corners of a toy wagon.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_region_fig01.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_region_fig01.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="build_region6"> + <para xml:id="build_region6"> Next, we create an arb8 for one long side of the wagon tub. It is named wgn.s1. After that, we create an rcc for one corner of the tub. It is named wgn.s2. To get a hollow quarter cylinder, we need to subtract a @@ -65,29 +65,29 @@ wgn.s2-1, and the intersecting primitive will be named wgn.s2+1. </para> - <figure id="build_region7"> - <title>Arb8, cylinder, and two Boolean primitives.</title> + <figure xml:id="build_region7"><info><title>Arb8, cylinder, and two Boolean primitives.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_region_fig02.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_region_fig02.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="build_region8"> + <para xml:id="build_region8"> Now we have created the following four primitives: - <literallayout> + <literallayout class="normal"> wgn.s1 wgn.s2 wgn.s2+1 wgn.s2-1 </literallayout> If we separate the primitives sequentially as follows, - <literallayout> + <literallayout class="normal"> wgn.s1 wgn.s2 wgn.s2+1 wgn.s2-1, </literallayout> we can begin to see the Boolean structure falling out of the naming convention - <literallayout> + <literallayout class="normal"> u wgn.s1 u wgn.s2 + wgn.s2+1 - wgn.s2-1 @@ -99,38 +99,38 @@ *****NEED IMAGE HERE***** </para> - <figure id="build_region9"> - <title>The region and the subtraction primitives.</title> + <figure xml:id="build_region9"><info><title>The region and the subtraction primitives.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_region_fig03.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_region_fig03.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="build_region10"> + <para xml:id="build_region10"> Note that the root name stays the same so we can maintain the relationship, and the second number (associated with the Boolean operation) is incremented sequentially. </para> - <figure id="build_region11"> - <title>Raytraced image with hole.</title> + <figure xml:id="build_region11"><info><title>Raytraced image with hole.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/build_region_fig04.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/build_region_fig04.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="build_region12"> + <para xml:id="build_region12"> Obviously, the overall success or failure of the build_region command depends on primitives being named properly. But if they are, the command can organize them in one automated step, creating complex regions in just a few keystrokes. </para> - <para id="build_region13"> + <para xml:id="build_region13"> Another modeling benefit of the build_region tool is that it allows the user to quickly organize primitives. Assume, for example, that we have used the aforementioned naming convention to construct a complicated Modified: brlcad/trunk/doc/docbook/articles/en/ebm_primitive.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/en/ebm_primitive.xml 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/articles/en/ebm_primitive.xml 2011-01-30 15:51:13 UTC (rev 42767) @@ -1,58 +1,58 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" -"../../resources/standard/dtd/docbookx.dtd"> -<article xmlns:xi="http://www.w3.org/2001/XInclude"> - <articleinfo> - <title>Using the Extruded Bitmap Primitive</title> +<!-- Converted by db4-upgrade version 1.0 --> - <xi:include href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> +<article xmlns="http://docbook.org/ns/docbook" version="5.0"> + <info><title>Using the Extruded Bitmap Primitive</title> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + <legalnotice> <para>Approved for public release; distribution is unlimited</para> </legalnotice> - </articleinfo> + </info> - <para id="ebm1"> + <para xml:id="ebm1"> The extruded bitmap (ebm) primitive allows the user to make a three-dimensional (3-D) shape from a two-dimensional black-and-white image. This feature can be helpful when dealing with complex outlines, text, or other complicated shapes captured as images. </para> - <para id="ebm2"> + <para xml:id="ebm2"> For example, the ebm could be used if one wanted to model 3-D letters, such as in a company name, onto the side of a simulated wall or building. Note also that the same image used for the projection can, with some extra processing, form the basis for the ebm (see Figures C-1-C-3). </para> - <figure id="ebm3"> - <title>Example of the .bw image used for ebm.</title> + <figure xml:id="ebm3"><info><title>Example of the .bw image used for ebm.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/ebm_primitive_fig01.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/ebm_primitive_fig01.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <figure id="ebm4"> - <title>Example of ebm.</title> + <figure xml:id="ebm4"><info><title>Example of ebm.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/ebm_primitive_fig02.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/ebm_primitive_fig02.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <figure id="ebm5"> - <title>Example of the ebm with projection shader added.</title> + <figure xml:id="ebm5"><info><title>Example of the ebm with projection shader added.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/ebm_primitive_fig03.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/ebm_primitive_fig03.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="ebm6"> + <para xml:id="ebm6"> To make an ebm, the image file must be a black and white (.bw) file. A .bw image is a grayscale raw image file with only one channel. Each pixel can be turned on or off, but it has no color data. As shown in Figures C-2 and @@ -62,13 +62,13 @@ primitive. </para> - <para id="ebm7"> + <para xml:id="ebm7"> To enter an ebm in a database, the in command must be used. The arguments are as shown in the following example: </para> - <informaltable frame="all" id="ebm8"> - <tgroup cols='7'> + <informaltable frame="all" xml:id="ebm8"> + <tgroup cols="7"> <tbody> <row><entry>in</entry><entry>sample.ebm</entry><entry>ebm</entry><entry>image.bw</entry><entry>600</entry><entry>800</entry><entry>1</entry></row> <row> @@ -84,8 +84,8 @@ </tgroup> </informaltable> - <note id="ebm9"> - <title>Points to Remember About the ebm</title> + <note xml:id="ebm9"><info><title>Points to Remember About the ebm</title></info> + <itemizedlist mark="bullet"> <listitem> <para> Modified: brlcad/trunk/doc/docbook/articles/en/mgedrc.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/en/mgedrc.xml 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/articles/en/mgedrc.xml 2011-01-30 15:51:13 UTC (rev 42767) @@ -1,17 +1,17 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" -"../../resources/standard/dtd/docbookx.dtd"> -<article xmlns:xi="http://www.w3.org/2001/XInclude"> - <articleinfo> - <title>Setting Up a .mgedrc File</title> +<!-- Converted by db4-upgrade version 1.0 --> - <xi:include href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> +<article xmlns="http://docbook.org/ns/docbook" version="5.0"> + <info><title>Setting Up a .mgedrc File</title> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../books/en/tutorial_series_authors.xml" xpointer="Intro_MGED_Tutorial_Series_III_authors"/> + <legalnotice> <para>Approved for public release; distribution is unlimited</para> </legalnotice> - </articleinfo> + </info> - <para id="mgedrc1"> + <para xml:id="mgedrc1"> Similar to the preferences or settings options in other computer applications, the .mgedrc file is a useful tool to customize the look and functionality of the U.S. Army Ballistic Research Laboratory - @@ -23,14 +23,14 @@ and size the command and geometry windows, and perform a host of other customizations. </para> - <para id="mgedrc2"> + <para xml:id="mgedrc2"> The command to create/update a .mgedrc file with the graphical user interface (GUI) is found under the File drop-down menu. When the Create/Update .mgedrc command is called, it writes an extensive list (~500 lines) of default settings and comments representing the default state of the command and graphics windows. </para> - <para id="mgedrc3"> + <para xml:id="mgedrc3"> As shown in Figure D-1, there are two basic parts to a .mgedrc file: (1) the information before the MGEDRC_HEADER and (2) the information after the MGEDRC_HEADER. The information before the header is any text created by @@ -42,7 +42,7 @@ The information before the HEADER, however, is not changed. </para> - <note id="mgedrc4"> + <note xml:id="mgedrc4"> <para> Remember that when creating/updating .mgedrc files, if any conflicting/repeated commands are found, BRL-CAD "obeys" the last @@ -50,24 +50,24 @@ </para> </note> - <para id="mgedrc5"> + <para xml:id="mgedrc5"> In Figure D-1, note that lines have been added before the header to show different raytracing options and the commands have been sectioned into functional divisions separated by comment fields (comment fields are denoted by the symbol "#"). </para> - <figure id="mgedrc6"> - <title>The two basic parts of the .mgedrc file: (1) information before header, and (2) information - after header.</title> + <figure xml:id="mgedrc6"><info><title>The two basic parts of the .mgedrc file: (1) information before header, and (2) information + after header.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/mgedrc_fig01.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/mgedrc_fig01.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="mgedrc7"> + <para xml:id="mgedrc7"> Each command includes the following four basic components: <itemizedlist> @@ -94,24 +94,24 @@ </itemizedlist> </para> - <para id="mgedrc8"> + <para xml:id="mgedrc8"> The symbol ";" signifies command separation (a return), and the symbol "$" inserts the value of the subsequently named variable. </para> - <para id="mgedrc9"> + <para xml:id="mgedrc9"> The following text discusses some specific examples of the type of shortcuts that can be created by users to expedite common operations such as executing raytraces with particular parameters, accepting and rejecting edits, setting azimuth and elevation, etc. </para> - <para id="mgedrc10"> + <para xml:id="mgedrc10"> First, the command to execute a specific kind of raytrace can often be long and tedious to type. For example, if a user wanted to render an image in a window 256 pixels high and wide, with a background color of white, and with the ambient light set to 0.7, the following text would have to be typed: - <literallayout> + <literallayout class="normal"> rt -s256 -C255/255/255 -A.7 </literallayout> @@ -119,13 +119,13 @@ automate the calling of this instruction. The user's line might be as follows: - <literallayout> + <literallayout class="normal"> proc 256wa {} {rt -s256 -C255/255/255 -A.7} </literallayout> Diagrammed, this line breaks down as follows: <informaltable> - <tgroup cols='4'> + <tgroup cols="4"> <tbody> <row> <entry>proc</entry> @@ -151,7 +151,7 @@ Now, all the user has to type on the command line to execute a rendering with the previously listed options is the following procedure name: - <literallayout> + <literallayout class="normal"> 256wa </literallayout> @@ -163,19 +163,19 @@ commands (e.g., create). </para> - <para id="mgedrc11"> + <para xml:id="mgedrc11"> The .mgedrc file can also be used to create shortcuts for other types of command line or GUI commands. For example, the syntax for creating a shortcut for accepting and rejecting edits from the command line might be as follows: - <literallayout> + <literallayout class="normal"> proc acc {} {press accept} proc rej {} {press reject} </literallayout> In addition, a possible shortcut for calling a standard viewing geometry might be as follows: - <literallayout> + <literallayout class="normal"> proc 145 {} {ae 145 25} </literallayout> @@ -183,37 +183,37 @@ procedure syntax for combining the make and sed commands and copy and sed commands might be as follows: - <literallayout> + <literallayout class="normal"> proc mks {newprim primtype} {make $newprim $primtype; sed $newprim} </literallayout> and - <literallayout> + <literallayout class="normal"> proc cps {oldprim newprim} {cp $oldprim $newprim; sed $newprim} </literallayout> </para> - <para id="mgedrc12"> + <para xml:id="mgedrc12"> Figure D-2 shows a sample section of a .mgedrc file that allows the user to specify the command line editor, customize the window size and placement, and toggle the function keys. </para> - <figure id="mgedrc13"> - <title>Sample elements and functionality of a .mgedrc file.</title> + <figure xml:id="mgedrc13"><info><title>Sample elements and functionality of a .mgedrc file.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/mgedrc_fig02.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/mgedrc_fig02.png" format="PNG"/> </imageobject> </mediaobject> </figure> - <para id="mgedrc14"> + <para xml:id="mgedrc14"> The diagrammed command for sizing and positioning the command window is as follows: <informaltable> - <tgroup cols='4'> + <tgroup cols="4"> <tbody> <row> <entry>set mged_default</entry> @@ -233,7 +233,7 @@ </informaltable> </para> - <para id="mgedrc15"> + <para xml:id="mgedrc15"> As illustrated in Figure D-3, to specify the window size, the user inputs width-by-height dimensions for each window (i.e., 475 × 250). To specify the placement of the windows on the display, the user specifies offset @@ -248,11 +248,11 @@ display to the bottom of the window. </para> - <figure id="mgedrc16"> - <title>Sample window dimension input and positioning.</title> + <figure xml:id="mgedrc16"><info><title>Sample window dimension input and positioning.</title></info> + <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/mgedrc_fig03.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/mgedrc_fig03.png" format="PNG"/> </imageobject> </mediaobject> </figure> Modified: brlcad/trunk/doc/docbook/articles/en/nirt.xml =================================================================== --- brlcad/trunk/doc/docbook/articles/en/nirt.xml 2011-01-30 15:48:27 UTC (rev 42766) +++ brlcad/trunk/doc/docbook/articles/en/nirt.xml 2011-01-30 15:51:13 UTC (rev 42767) @@ -1,28 +1,16 @@ -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" -"../../resources/standard/dtd/docbookx.dtd"> -<article> - <articleinfo> - <title>Interactive Raytracing: The <command>nirt</command> Command</title> - <author> - <firstname>Clifford</firstname> - <surname>Yapp</surname> - </author> - </articleinfo> +<!-- Converted by db4-upgrade version 1.0 --> - <abstract> - <para> The <command>nirt</command> command casts individual rays according to user-specified - options, and reports back a wide variety of information about the model - along the specified ray. It is extremely useful for tasks such as measuring - the thickness of objects and identifying gaps between objects. When used - within the <application>MGED</application> environment, <application>NIRT</application> will produce a visible - ray path, coloring the ray according to the geometry encountered - along the ray. It is also scriptable, allowing users to develop their - own custom analysis routines.</para> - </abstract> +<article xmlns="http://docbook.org/ns/docbook" version="5.0"> + <info><title>Interactive Raytracing: The <command>nirt</command> Command</title> + + <author><personname><firstname>Clifford</firstname><surname>Yapp</surname></personname></author> + </info> + - <sect1> - <title>About <application>NIRT</application></title> + + <section><info><title>About <application>NIRT</application></title></info> + <para> The <application>NIRT</application> (Natalie's Interactive Ray-Tracer) command line tool provides a user-level interface to the low-level routines defining the ray tracing logic, allowing a user to specify and cast an individual ray @@ -32,11 +20,11 @@ resulting in wireframe visualization of ray paths and the Query Ray Control Panel. </para> - </sect1> + </section> - <sect1> - <title><application>NIRT</application>: Basic Syntax and Operations</title> + <section><info><title><application>NIRT</application>: Basic Syntax and Operations</title></info> + <para> There are two environments within which <application>NIRT</application> can be used - inside the <application>MGED</application> interactive geometry editor and within its own command line @@ -45,7 +33,7 @@ command prompt, and <application>MGED</application> command prompt. The convention used here will be: <informaltable> - <tgroup cols='2' align='center'> + <tgroup cols="2" align="center"> <colspec colwidth="1*"/> <colspec colwidth="1*"/> <tbody> @@ -71,8 +59,8 @@ </para> - <sect2> - <title>Command Line Help</title> + <section><info><title>Command Line Help</title></info> + <para> <application>NIRT</application> provides an <emphasis>h</emphasis> option which prints out a list of available options and command syntax: @@ -96,10 +84,10 @@ </literallayout> </para> - </sect2> + </section> - <sect2> - <title>Loading a Model</title> + <section><info><title>Loading a Model</title></info> + <para> There will be a number of models used to illustrate various <application>NIRT</application> @@ -113,7 +101,7 @@ <informalfigure> <mediaobject> <imageobject> - <imagedata align = "center" fileref="../../articles/en/images/nirt_fig01.png" format="PNG"></imagedata> + <imagedata align="center" fileref="../../articles/en/images/nirt_fig01.png" format="PNG"/> </imageobject> <caption> <para> @@ -130,10 +118,10 @@ Although there are many <command>nirt</command> options available, only the database name and objects are essential to get started: - <cmdsynopsis> + <cmdsynopsis sepchar=" "> <command>nirt</command> - <arg choice='req'><replaceable>model.g</replaceable></arg> - <arg choice='req'><replaceable>objects</replaceable></arg> + <arg choice="req" rep="norepeat"><replaceable>model.g</replaceable></arg> + <arg choice="req" rep="norepeat"><replaceable>objects</replaceable></arg> </cmdsynopsis> where <emphasis>objects</emphasis> is a list of objects in the database @@ -169,7 +157,7 @@ Database title: 'Example BRL-CAD Database' Database units: 'mm' model_min = (-1, -1, -1) model_max = (1, 1, 1) -nirt> +nirt> </literallayout> The first three lines identify the release number, tool @@ -180,16 +168,16 @@ <literal>model_max</literal>, are the outer bounds of the objects specified. </para> - </sect2> + </section> - <sect2> - <title>Shooting a Ray</title> + <section><info><title>Shooting a Ray</title></info> + <para> With the example loaded into <application>NIRT</application>, the <command>s</command> interactive command is used to shoot a ray: <literallayout class="monospaced"> -nirt> s +nirt> s Origin (x y z) = (0.00000000 0.00000000 0.00000000) (h v d) = (0.0000 0.0000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_in Attrib @@ -200,7 +188,7 @@ the structure of the report: <informaltable> - <tgroup cols='2' align='center'> + <tgroup cols="2" align="center"> <colspec colwidth="1*"/> <colspec colwidth="3*"/> <tbody> @@ -253,9 +241,9 @@ <application>NIRT</application> was only supplied with <emphasis>center_cube.r</emphasis> for a target object to begin with.) Many examples of real world <application>NIRT</application> usage will have much more complex geometries and hence longer reports. </para> - </sect2> - <sect2> - <title>Moving the Origination Point</title> + </section> + <section><info><title>Moving the Origination Point</title></info> + <para> If we move the origin to some point other than the sphere center, a different ray is cast and the reported intersections change. The @@ -263,12 +251,12 @@ accepts a list of points to change the origin: <literallayout class="monospaced"> -nirt> xyz +nirt> xyz (x, y, z) = (0.00, 0.00, 0.00) -nirt> xyz 0 0 .5 -nirt> xyz +nirt> xyz 0 0 .5 +nirt> xyz (x, y, z) = (0.00, 0.00, 0.50) -nirt> s +nirt> s Origin (x y z) = (0.00000000 0.00000000 0.50000000) (h v d) = (0.0000 0.5000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_in Attrib @@ -276,9 +264,9 @@ </literallayout> </para> - </sect2> - <sect2> - <title>Backing Out of a Model</title> + </section> + <section><info><title>Backing Out of a Model</title></info> + <para> Although in both previous cases the ray's origin was inside the cube, <application>NIRT</application> backed up to the point of first intersection along the @@ -300,7 +288,7 @@ and after backout: <literallayout class="monospaced"> -nirt> q +nirt> q Quitting... user@machine ~ $ nirt nirt_example.g left_and_right_cubes.r @@ -315,13 +303,13 @@ Database title: 'Example BRL-CAD Database' Database units: 'mm' model_min = (-3, -1, -1) model_max = (3, 1, 1) -nirt> s +nirt> s Origin (x y z) = (0.00000000 0.00000000 0.00000000) (h v d) = (0.0000 0.0000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_in Attrib left_and_right_cubes.r ( -1.0000 0.0000 0.0000) 2.0000 0.0000 -nirt> backout 1 -nirt> s +nirt> backout 1 +nirt> s Origin (x y z) = (6.63324958 0.00000000 0.00000000) (h v d) = (0.0000 0.0000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_in Attrib @@ -352,42 +340,42 @@ example: <literallayout class="monospaced"> -nirt> backout 0 -nirt> xyz +nirt> backout 0 +nirt> xyz (x, y, z) = (0.00, 0.00, 0.00) -nirt> xyz 0 0 .5 -nirt> s +nirt> xyz 0 0 .5 +nirt> s Origin (x y z) = (0.00000000 0.00000000 0.50000000) (h v d) = (0.0000 0.5000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_in Attrib left_and_right_cubes.r ( -1.0000 0.0000 0.5000) 2.0000 0.0000 -nirt> backout 1 -nirt> xyz +nirt> backout 1 +nirt> xyz (x, y, z) = (0.00, 0.00, 0.50) -nirt> backout 0 -nirt> xyz +nirt> backout 0 +nirt> xyz (x, y, z) = (0.00, 0.00, 0.50) -nirt> backout 1 -nirt> xyz 0 0 .8 -nirt> s +nirt> backout 1 +nirt> xyz 0 0 .8 +nirt> s Origin (x y z) = (6.63324958 0.00000000 0.80000000) (h v d) = (0.0000 0.8000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_in Attrib left_and_right_cubes.r ( 3.0000 0.0000 0.8000) 2.0000 0.0000 left_and_right_cubes.r ( -1.0000 0.0000 0.8000) 2.0000 0.0000 -nirt> backout 0 -nirt> s +nirt> backout 0 +nirt> s Origin (x y z) = (0.00000000 0.00000000 0.80000000) (h v d) = (0.0000 0.8000 0.0000) Direction (x y z) = (-1.00000000 0.00000000 0.00000000) (az el) = (0.00000000 0.00000000) Region Name Entry (x y z) LOS Obliq_i... [truncated message content] |
From: <sta...@us...> - 2011-01-30 17:07:24
|
Revision: 42770 http://brlcad.svn.sourceforge.net/brlcad/?rev=42770&view=rev Author: starseeker Date: 2011-01-30 17:07:17 +0000 (Sun, 30 Jan 2011) Log Message: ----------- Move the template Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am Added Paths: ----------- brlcad/trunk/doc/docbook/system/mann/mged_cmd_template.xml Removed Paths: ------------- brlcad/trunk/doc/docbook/system/man1/mged_cmd_template.xml brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2011-01-30 17:05:28 UTC (rev 42769) +++ brlcad/trunk/doc/docbook/Makefile.am 2011-01-30 17:07:17 UTC (rev 42770) @@ -114,9 +114,8 @@ specifications/en/Makefile.am \ system/README \ system/man1/en/Makefile.am \ - system/man1/mged_cmd_template.xml \ + system/mann/mged_cmd_template.xml \ system/man3/en/Makefile.am \ - system/man3/mged_cmd_template.xml \ system/man5/en/Makefile.am \ system/mann/en/Makefile.am Deleted: brlcad/trunk/doc/docbook/system/man1/mged_cmd_template.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man1/mged_cmd_template.xml 2011-01-30 17:05:28 UTC (rev 42769) +++ brlcad/trunk/doc/docbook/system/man1/mged_cmd_template.xml 2011-01-30 17:07:17 UTC (rev 42770) @@ -1,82 +0,0 @@ -<!-- Converted by db4-upgrade version 1.0 --> - -<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id=""> - -<refmeta> - <refentrytitle/> - <manvolnum>1</manvolnum> - <refmiscinfo class="source">BRL-CAD</refmiscinfo> - <refmiscinfo class="manual">BRL-CAD User Commands</refmiscinfo> -</refmeta> - -<refnamediv xml:id="name"> - <refname/> - <refpurpose> - - </refpurpose> -</refnamediv> - -<!-- body begins here --> -<refsynopsisdiv xml:id="synopsis"> - <cmdsynopsis sepchar=" "> - <command/> - <arg choice="opt" rep="norepeat"/> - </cmdsynopsis> -</refsynopsisdiv> - -<refsection xml:id="description"><info><title>DESCRIPTION</title></info> - - <para> - - </para> -</refsection> - -<refsection xml:id="examples"><info><title>EXAMPLES</title></info> - - <para> - - </para> - <example><info><title/></info> - - <variablelist> - <varlistentry> - <term><prompt/> <userinput/></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt/> <userinput/></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - - <example><info><title/></info> - - <para> - <prompt/><userinput/> - </para> - <para> - - </para> - </example> - -</refsection> - -<info><corpauthor>BRL-CAD Team</corpauthor></info> - -<refsection xml:id="bug_reports"><info><title>BUG REPORTS</title></info> - - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> -</refsection> -</refentry> Deleted: brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml =================================================================== --- brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml 2011-01-30 17:05:28 UTC (rev 42769) +++ brlcad/trunk/doc/docbook/system/man3/mged_cmd_template.xml 2011-01-30 17:07:17 UTC (rev 42770) @@ -1,88 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "../../../resources/standard/dtd/docbookx.dtd"> - -<refentry id=''> - -<refmeta> - <refentrytitle></refentrytitle> - <manvolnum>3</manvolnum> - <refmiscinfo class='source'>BRL-CAD</refmiscinfo> - <refmiscinfo class='manual'>BRL-CAD Libraries</refmiscinfo> -</refmeta> - -<refnamediv id='name'> - <refname></refname> - <refpurpose> - - </refpurpose> -</refnamediv> - -<!-- body begins here --> -<refsynopsisdiv id='synopsis'> - <cmdsynopsis> - <command></command> - <arg></arg> - </cmdsynopsis> -</refsynopsisdiv> - -<refsect1 id='description'> - <title>DESCRIPTION</title> - <para> - - </para> -</refsect1> - -<refsect1 id='examples'> - <title>EXAMPLES</title> - <para> - - </para> - <example> - <title></title> - <variablelist> - <varlistentry> - <term><prompt></prompt> <userinput></userinput></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><prompt></prompt> <userinput></userinput></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - </variablelist> - </example> - - <example> - <title></title> - <para> - <prompt></prompt><userinput></userinput> - </para> - <para> - - </para> - </example> - -</refsect1> - -<refsect1 id='author'> - <title>AUTHOR</title> - <para>BRL-CAD TEAM</para> -</refsect1> - -<refsect1 id='bug_reports'> - <title>BUG REPORTS</title> - <para> - Reports of bugs or problems should be submitted via electronic - mail to <de...@br...>, or via the "cadbug.sh" script. - </para> -</refsect1> -</refentry> - Copied: brlcad/trunk/doc/docbook/system/mann/mged_cmd_template.xml (from rev 42769, brlcad/trunk/doc/docbook/system/man1/mged_cmd_template.xml) =================================================================== --- brlcad/trunk/doc/docbook/system/mann/mged_cmd_template.xml (rev 0) +++ brlcad/trunk/doc/docbook/system/mann/mged_cmd_template.xml 2011-01-30 17:07:17 UTC (rev 42770) @@ -0,0 +1,82 @@ +<!-- Converted by db4-upgrade version 1.0 --> + +<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id=""> + +<refmeta> + <refentrytitle/> + <manvolnum>1</manvolnum> + <refmiscinfo class="source">BRL-CAD</refmiscinfo> + <refmiscinfo class="manual">BRL-CAD User Commands</refmiscinfo> +</refmeta> + +<refnamediv xml:id="name"> + <refname/> + <refpurpose> + + </refpurpose> +</refnamediv> + +<!-- body begins here --> +<refsynopsisdiv xml:id="synopsis"> + <cmdsynopsis sepchar=" "> + <command/> + <arg choice="opt" rep="norepeat"/> + </cmdsynopsis> +</refsynopsisdiv> + +<refsection xml:id="description"><info><title>DESCRIPTION</title></info> + + <para> + + </para> +</refsection> + +<refsection xml:id="examples"><info><title>EXAMPLES</title></info> + + <para> + + </para> + <example><info><title/></info> + + <variablelist> + <varlistentry> + <term><prompt/> <userinput/></term> + <listitem> + <para> + + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><prompt/> <userinput/></term> + <listitem> + <para> + + </para> + </listitem> + </varlistentry> + </variablelist> + </example> + + <example><info><title/></info> + + <para> + <prompt/><userinput/> + </para> + <para> + + </para> + </example> + +</refsection> + +<info><corpauthor>BRL-CAD Team</corpauthor></info> + +<refsection xml:id="bug_reports"><info><title>BUG REPORTS</title></info> + + <para> + Reports of bugs or problems should be submitted via electronic + mail to <de...@br...>, or via the "cadbug.sh" script. + </para> +</refsection> +</refentry> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <tbr...@us...> - 2011-09-14 13:41:23
|
Revision: 46685 http://brlcad.svn.sourceforge.net/brlcad/?rev=46685&view=rev Author: tbrowder2 Date: 2011-09-14 13:41:12 +0000 (Wed, 14 Sep 2011) Log Message: ----------- new document added to tree Added Paths: ----------- brlcad/trunk/doc/docbook/presentations/ brlcad/trunk/doc/docbook/presentations/CMakeLists.txt brlcad/trunk/doc/docbook/presentations/README brlcad/trunk/doc/docbook/presentations/en/ brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt brlcad/trunk/doc/docbook/presentations/en/Makefile.am brlcad/trunk/doc/docbook/presentations/en/images/ brlcad/trunk/doc/docbook/presentations/en/images/copy-sph-part-left.png brlcad/trunk/doc/docbook/presentations/en/images/copy-sph-part-right.png brlcad/trunk/doc/docbook/presentations/en/images/mged-defaults.png brlcad/trunk/doc/docbook/presentations/en/images/special-character-interpretation.png brlcad/trunk/doc/docbook/presentations/en/images/tk-based-gui-for-mged.png brlcad/trunk/doc/docbook/presentations/en/intro-to-tcltk.xml Added: brlcad/trunk/doc/docbook/presentations/CMakeLists.txt =================================================================== --- brlcad/trunk/doc/docbook/presentations/CMakeLists.txt (rev 0) +++ brlcad/trunk/doc/docbook/presentations/CMakeLists.txt 2011-09-14 13:41:12 UTC (rev 46685) @@ -0,0 +1 @@ +ADD_SUBDIRECTORY(en) Property changes on: brlcad/trunk/doc/docbook/presentations/CMakeLists.txt ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/presentations/README =================================================================== --- brlcad/trunk/doc/docbook/presentations/README (rev 0) +++ brlcad/trunk/doc/docbook/presentations/README 2011-09-14 13:41:12 UTC (rev 46685) @@ -0,0 +1,2 @@ +The presentations sub-directory contains copies of briefings (slides +or slides converted to documents). Property changes on: brlcad/trunk/doc/docbook/presentations/README ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt =================================================================== --- brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt (rev 0) +++ brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt 2011-09-14 13:41:12 UTC (rev 46685) @@ -0,0 +1,18 @@ +SET(docbook_presentations_EN + intro-to-tcltk.xml +) + +SET(docbook_presentations_EN_IMAGES + copy-sph-part-left.png + copy-sph-part-right.png + mged-defaults.png + special-character-interpretation.png + tk-based-gui-for-mged.png +) + +DOCBOOK_TO_HTML(presentation docbook_presentations_EN html/presentations/en) +BRLCAD_ADDDATA(docbook_presentations_EN_IMAGES html/presentations/en/images) + +IF(BRLCAD_BUILD_EXTRADOCS_PDF) + DOCBOOK_TO_PDF(presentation docbook_presentations_EN pdf/presentations/en) +ENDIF(BRLCAD_BUILD_EXTRADOCS_PDF) Property changes on: brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/presentations/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/presentations/en/Makefile.am (rev 0) +++ brlcad/trunk/doc/docbook/presentations/en/Makefile.am 2011-09-14 13:41:12 UTC (rev 46685) @@ -0,0 +1,29 @@ +presentationsDOCBOOK_EN = \ + presentations/en/intro-to-tcltk.xml + +presentationsDOCBOOK_EN_IMAGES = \ + presentations/en/images/copy-sph-part-left.png \ + presentations/en/images/copy-sph-part-right.png \ + presentations/en/images/mged-defaults.png \ + presentations/en/images/special-character-interpretation.png \ + presentations/en/images/tk-based-gui-for-mged.png + +presentationsDOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/presentations/en +presentationsDOCBOOK_ENhtml_DATA = \ + $(BUILTPRESENTATIONS_ENHTML) + +BUILTPRESENTATIONS_ENHTML = \ + ${presentationsDOCBOOK_EN:xml=html} + +presentationsDOCBOOK_ENhtmlimagesdir = $(BRLCAD_DATA)/html/presentations/en/images +presentationsDOCBOOK_ENhtmlimages_DATA = \ + $(presentationsDOCBOOK_EN_IMAGES) + +if BUILD_PDF_DOCS + +BUILTPRESENTATIONS_ENPDF = ${presentationsDOCBOOK_EN:xml=pdf} + +endif + +presentationsDOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/presentations/en +presentationsDOCBOOK_ENpdf_DATA = $(BUILTPRESENTATIONS_ENPDF) Property changes on: brlcad/trunk/doc/docbook/presentations/en/Makefile.am ___________________________________________________________________ Added: svn:mime-type + text/plain Added: svn:keywords + Id Added: svn:eol-style + native Added: brlcad/trunk/doc/docbook/presentations/en/images/copy-sph-part-left.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/presentations/en/images/copy-sph-part-left.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/presentations/en/images/copy-sph-part-right.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/presentations/en/images/copy-sph-part-right.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/presentations/en/images/mged-defaults.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/presentations/en/images/mged-defaults.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/presentations/en/images/special-character-interpretation.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/presentations/en/images/special-character-interpretation.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/presentations/en/images/tk-based-gui-for-mged.png =================================================================== (Binary files differ) Property changes on: brlcad/trunk/doc/docbook/presentations/en/images/tk-based-gui-for-mged.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: brlcad/trunk/doc/docbook/presentations/en/intro-to-tcltk.xml =================================================================== --- brlcad/trunk/doc/docbook/presentations/en/intro-to-tcltk.xml (rev 0) +++ brlcad/trunk/doc/docbook/presentations/en/intro-to-tcltk.xml 2011-09-14 13:41:12 UTC (rev 46685) @@ -0,0 +1,1954 @@ +<article + xmlns="http://docbook.org/ns/docbook" + version="5.0" +> + +<!-- + + This is produced from the slides in 'tcltk.ppt' on the BRL-CAD site. + + There were 31 slides from which text and images have been extracted to make + DocBook source file. + +--> + + +<!-- slide 01 --> + + <info> + <title>Introduction to Tcl/Tk</title> + + <author> + <personname> + <firstname>TraNese</firstname> + <surname>Christy</surname> + </personname> + </author> + + <legalnotice> + <para>Approved for public release; distribution is unlimited.</para> + <para>Date approved: ????</para> + </legalnotice> + + </info> + +<!-- slide 02 --> + + <para>What is Tcl/Tk?</para> + + <itemizedlist> + + <listitem> + <para>Tool Command Language/ToolKit.</para> + </listitem> + + <listitem> + <para>Tcl is an embeddable and extensible interpreted language. </para> + </listitem> + + <listitem> + <para>Tk is a toolkit for building user interfaces.</para> + </listitem> + + <listitem> + <para>Combined, they provide a programming system for + development and use of GUI applications.</para> + </listitem> + + </itemizedlist> + +<!-- slide 03 --> + + <para>Benefits of Tcl/Tk</para> + + <itemizedlist> + + <listitem> + <para>Ease of providing applications with a powerful scripting language</para> + </listitem> + + <listitem> + <para>An excellent "glue language"</para> + </listitem> + + <listitem> + <para>User convenience</para> + </listitem> + + <listitem> + <para>Portability</para> + </listitem> + + </itemizedlist> + +<!-- slide 04 --> + + <para>Tcl/Tk-Based GUI for MGED</para> + + <!-- image4.png --> + <!-- tk-based-gui-for-mged.png --> + +<figure> +<title>Tcl/Tk-Based GUI for MGED</title> +<mediaobject> + <imageobject role='html'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/tk-based-gui-for-mged.png" + /><!-- was: width='100%' --> + </imageobject> + <imageobject role='fo'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/tk-based-gui-for-mged.png" + /> + </imageobject> + <textobject> + <phrase>a picture</phrase> + </textobject> +</mediaobject> +</figure> + + +<!-- slide 05 --> + + <para>Tcl Syntax</para> + + <itemizedlist> + + <listitem> + <para>A command is a list of words.</para> + </listitem> + + <listitem> + <para>First word on the command line is the command name, any additional words are arguments.</para> + </listitem> + + <listitem> + <para>command </para> + </listitem> + + <listitem> + <para>[</para> + </listitem> + + <listitem> + <para>arg1 ... argn</para> + </listitem> + + <listitem> + <para>]</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> puts "Hello World"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>Hello World</para> + </listitem> + + <listitem> + <para>Words can be grouped with double quotes (" ") or curly braces ({}).</para> + </listitem> + + <listitem> + <para>Commands are terminated with a newline or semicolon.</para> + </listitem> + + </itemizedlist> + +<!-- slide 06 --> + + <para>Variables</para> + + <itemizedlist> + + <listitem> + <para>Variable names are case-sensitive.</para> + </listitem> + + <listitem> + <para>Declarations are not necessary.</para> + </listitem> + + <listitem> + <para>set</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>varName</para> + </listitem> + + <listitem> + <para> [</para> + </listitem> + + <listitem> + <para>value</para> + </listitem> + + <listitem> + <para>]</para> + </listitem> + + <listitem> + <para>Assigns </para> + </listitem> + + <listitem> + <para>to the variable </para> + </listitem> + + <listitem> + <para>varName.</para> + </listitem> + + <listitem> + <para>mged> </para> + </listitem> + + <listitem> + <para>set day Friday</para> + </listitem> + + <listitem> + <para>Friday</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set day</para> + </listitem> + + <listitem> + <para>Friday</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set day 25</para> + </listitem> + + <listitem> + <para>25</para> + </listitem> + + </itemizedlist> + + +<!-- slide 07 --> + + <para>Lists</para> + + <itemizedlist> + + <listitem> + <para>An ordered set of strings</para> + </listitem> + + <listitem> + <para>Specified with curly braces</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set colors {red yellow green blue}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>red yellow green blue</para> + </listitem> + + <listitem> + <para>Sometimes created with "list" command</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set colors [list red yellow green blue]</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>Can extract elements from the list using the "lindex" command</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> lindex {red yellow green blue} 2</para> + </listitem> + + <listitem> + <para>blue</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + </itemizedlist> + + +<!-- slide 08 --> + + <para>Arrays</para> + + <itemizedlist> + + <listitem> + <para>Uses associative arrays</para> + </listitem> + + <listitem> + <para>Strings used to index the array elements</para> + </listitem> + + <listitem> + <para> set profit(January) 1500</para> + </listitem> + + <listitem> + <para>1500</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set profit(February) -200</para> + </listitem> + + <listitem> + <para>-200</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para>1500</para> + </listitem> + + </itemizedlist> + +<!-- slide 09 --> + + <para>Special Characters</para> + + <itemizedlist> + + <listitem> + <para>Dollar sign $</para> + </listitem> + + <listitem> + <para>Substitutes the value of the variable</para> + </listitem> + + <listitem> + <para>Square brackets [ ]</para> + </listitem> + + <listitem> + <para>Replaces contents with the result of evaluating the command</para> + </listitem> + + <listitem> + <para>Backslash \</para> + </listitem> + + <listitem> + <para>Allows special characters such as newlines, [, and $ to be inserted without being treated specially</para> + </listitem> + + <listitem> + <para>Double quotes " "</para> + </listitem> + + <listitem> + <para>Allows special characters to be processed normally</para> + </listitem> + + <listitem> + <para>Curly braces {}</para> + </listitem> + + <listitem> + <para>Disables special characters</para> + </listitem> + + <listitem> + <para>Parentheses ()</para> + </listitem> + + <listitem> + <para>Delimits key values in arrays</para> + </listitem> + + <listitem> + <para>Hashmark #</para> + </listitem> + + <listitem> + <para>At the beginning of a line, signifies a comment to follow</para> + </listitem> + + </itemizedlist> + + +<!-- slide 10 --> + + <para>Special Character Examples</para> + + <itemizedlist> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set name Elvis</para> + </listitem> + + <listitem> + <para>Elvis</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> puts "Hello name"</para> + </listitem> + + <listitem> + <para>Hello name</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> puts "Hello $name"</para> + </listitem> + + <listitem> + <para>Hello Elvis</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set len [string length $name]</para> + </listitem> + + <listitem> + <para>5</para> + </listitem> + + <listitem> + <para>string length $name returns 5</para> + </listitem> + + <listitem> + <para>len gets the value 5</para> + </listitem> + + </itemizedlist> + +<!-- slide 11 --> + + <para>Special Character Examples </para> + + <itemizedlist> + + <listitem> + <para>(cont'd)</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set price 1.41</para> + </listitem> + + <listitem> + <para>1.41</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> puts "Gasoline: \$ $price/gallon"</para> + </listitem> + + <listitem> + <para>Gasoline: $1.41/gallon</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> puts {Gasoline: \$ $price/gallon}</para> + </listitem> + + <listitem> + <para>Gasoline: \$ $price/gallon</para> + </listitem> + + <listitem> + <para>mged> </para> + </listitem> + + <listitem> + <para>set product 1; #This is a comment</para> + </listitem> + + <listitem> + <para>1</para> + </listitem> + + </itemizedlist> + +<!-- slide 12 --> + + <para>Special Character Conflicts</para> + + <itemizedlist> + + <listitem> + <para>MGED traditional "name globbing" characters conflict with Tcl/Tk usage:</para> + </listitem> + + <listitem> + <para>MGED follows Unix shell filename patterns.</para> + </listitem> + + <listitem> + <para>Tcl/Tk has different interpretation of * and [].</para> + </listitem> + + <listitem> + <para>Users can select which interpretation of special characters:</para> + </listitem> + + <listitem> + <para>.mgedrc: set MGED variable </para> + </listitem> + + <listitem> + <para>glob_compat_mode</para> + </listitem> + + <listitem> + <para>set glob_compat_mode 0 (for Tcl evaluation)</para> + </listitem> + + <listitem> + <para>set glob_compat_mode 1 (for object name matching)</para> + </listitem> + + <listitem> + <para>Menu: File->Preferences->Special Characters</para> + </listitem> + + </itemizedlist> + +<!-- slide 13 --> + + <para> </para> + + <itemizedlist> + + <listitem> + <para>Special Character Interpretation</para> + </listitem> + + </itemizedlist> + + <!-- image5.png --> + <!-- special-character-interpretation.png --> +<figure> +<title>Special Character Interpretation</title> +<mediaobject> + <imageobject role='html'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/special-character-interpretation.png" + /><!-- was: width='100%' --> + </imageobject> + <imageobject role='fo'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/special-character-interpretation.png" + /> + </imageobject> + <textobject> + <phrase>a picture</phrase> + </textobject> +</mediaobject> +</figure> + + +<!-- slide 14 --> + + <para>Expressions</para> + + <itemizedlist> + + <listitem> + <para>The</para> + </listitem> + + <listitem> + <para>command is used to evaluate math expressions.</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> expr 2 + 2</para> + </listitem> + + <listitem> + <para>4</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> expr (3 + 2) * 4</para> + </listitem> + + <listitem> + <para>20</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> in ball.s sph 0 0 0 [expr 3 + 4]</para> + </listitem> + + <listitem> + <para>A sphere is created with a vertex (0,0,0) and a radius of 7.</para> + </listitem> + + </itemizedlist> + +<!-- slide 15 --> + + <para>Control Flow</para> + + <itemizedlist> + + <listitem> + <para>if</para> + </listitem> + + <listitem> + <para> {</para> + </listitem> + + <listitem> + <para>test</para> + </listitem> + + <listitem> + <para>} {</para> + </listitem> + + <listitem> + <para>body1</para> + </listitem> + + <listitem> + <para>} [</para> + </listitem> + + <listitem> + <para>else </para> + </listitem> + + <listitem> + <para>{</para> + </listitem> + + <listitem> + <para>body2</para> + </listitem> + + <listitem> + <para>}]</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set temp 90</para> + </listitem> + + <listitem> + <para>90</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> if {$temp > 75} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>} else {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "It's moderate"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>It's hot</para> + </listitem> + + </itemizedlist> + + +<!-- slide 16 --> + + <para>Control Flow (cont'd) </para> + + <itemizedlist> + + <listitem> + <para>while </para> + </listitem> + + <listitem> + <para>{</para> + </listitem> + + <listitem> + <para>test</para> + </listitem> + + <listitem> + <para>} {</para> + </listitem> + + <listitem> + <para>body</para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> set time 3</para> + </listitem> + + <listitem> + <para>3</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> while {$time > 0} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "Time is $time"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set time [expr $time - 1]</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>Time is 3</para> + </listitem> + + <listitem> + <para>Time is 2</para> + </listitem> + + <listitem> + <para>Time is 1</para> + </listitem> + + </itemizedlist> + +<!-- slide 17 --> + + <para>Control Flow (cont'd)</para> + + <itemizedlist> + + <listitem> + <para>for </para> + </listitem> + + <listitem> + <para>{</para> + </listitem> + + <listitem> + <para>init</para> + </listitem> + + <listitem> + <para>} {</para> + </listitem> + + <listitem> + <para>test</para> + </listitem> + + <listitem> + <para>} {</para> + </listitem> + + <listitem> + <para>reinit</para> + </listitem> + + <listitem> + <para>} {</para> + </listitem> + + <listitem> + <para>body</para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para> for {set time 3} {$time > 0} {set time [expr $time - 1]} { </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "Time is $time"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>Time is 3</para> + </listitem> + + <listitem> + <para>Time is 2</para> + </listitem> + + <listitem> + <para>Time is 1</para> + </listitem> + + </itemizedlist> + +<!-- slide 18 --> + + <para>Control Flow (cont'd)</para> + + <itemizedlist> + + <listitem> + <para>foreach</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>varList list</para> + </listitem> + + <listitem> + <para> {</para> + </listitem> + + <listitem> + <para>body</para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> foreach fruit {apples pears peaches} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "I like $fruit"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>I like apples</para> + </listitem> + + <listitem> + <para>I like pears</para> + </listitem> + + <listitem> + <para>I like peaches</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> foreach {key val} {sky blue grass green snow white} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "The $key is $val"</para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>The sky is blue</para> + </listitem> + + <listitem> + <para>The grass is green</para> + </listitem> + + <listitem> + <para>The snow is white</para> + </listitem> + + </itemizedlist> + +<!-- slide 19 --> + + <para>MGED Commands</para> + + <itemizedlist> + + <listitem> + <para>get </para> + </listitem> + + <listitem> + <para>obj</para> + </listitem> + + <listitem> + <para> [</para> + </listitem> + + <listitem> + <para>attr</para> + </listitem> + + <listitem> + <para>]</para> + </listitem> + + <listitem> + <para>Returns a list of the object's attributes. If </para> + </listitem> + + <listitem> + <para>attr</para> + </listitem> + + <listitem> + <para> is specified, only the value for that attribute is returned.</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> get foo.r</para> + </listitem> + + <listitem> + <para>comb region yes id 200 los 100 GIFTmater 2 rgb {100 100 100} </para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> get foo.r rgb</para> + </listitem> + + <listitem> + <para>100 100 100</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> get foo.s</para> + </listitem> + + <listitem> + <para>ell V {0 0 0} A {4 0 0} B {0 4 0} C {0 0 4}</para> + </listitem> + + </itemizedlist> + +<!-- slide 20 --> + + <para>MGED Commands (cont'd)</para> + + <itemizedlist> + + <listitem> + <para>adjust </para> + </listitem> + + <listitem> + <para>obj attr value</para> + </listitem> + + <listitem> + <para> [</para> + </listitem> + + <listitem> + <para>attr value</para> + </listitem> + + <listitem> + <para>]</para> + </listitem> + + <listitem> + <para>Modifies the object's attribute(s) by adjusting the value of the attribute(s) to the new value(s).</para> + </listitem> + + <listitem> + <para>ls</para> + </listitem> + + <listitem> + <para> [</para> + </listitem> + + <listitem> + <para>-c -r -s</para> + </listitem> + + <listitem> + <para>]</para> + </listitem> + + <listitem> + <para>Without any options, lists every object in the database. </para> + </listitem> + + <listitem> + <para>With the </para> + </listitem> + + <listitem> + <para>c</para> + </listitem> + + <listitem> + <para> option, lists all nonhidden combinations; </para> + </listitem> + + <listitem> + <para>r</para> + </listitem> + + <listitem> + <para> option lists all nonhidden regions; and </para> + </listitem> + + <listitem> + <para>s</para> + </listitem> + + <listitem> + <para> option lists all nonhidden primitives.</para> + </listitem> + + </itemizedlist> + +<!-- slide 21 --> + + <para>MGED Examples</para> + + <itemizedlist> + + <listitem> + <para>Task: Change the color of all regions to blue.</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> foreach region [ls -r] {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>adjust $region rgb {0 0 255}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>Task: Print all regions with nonzero air codes.</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> foreach reg [ls -r] {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>if {[get $reg air] != 0} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "$reg"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + </itemizedlist> + +<!-- slide 22 --> + + <para>MGED Examples (cont'd)</para> + + <itemizedlist> + + <listitem> + <para>Task: Print all objects with the inherit flag set.</para> + </listitem> + + <listitem> + <para>mged> foreach obj [ls -c] {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>if {[get $obj inherit] == "yes"} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>puts "$obj"</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + </itemizedlist> + +<!-- slide 23 --> + + <para>Procedures</para> + + <itemizedlist> + + <listitem> + <para>proc</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>procName </para> + </listitem> + + <listitem> + <para>{</para> + </listitem> + + <listitem> + <para>args</para> + </listitem> + + <listitem> + <para>} {</para> + </listitem> + + <listitem> + <para>body</para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> proc add {x y} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set answer [expr $x + $y]</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>return $answer</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> add 123 456</para> + </listitem> + + <listitem> + <para>579</para> + </listitem> + + <listitem> + <para>Create new MGED commands</para> + </listitem> + + <listitem> + <para>Save in .mgedrc</para> + </listitem> + + </itemizedlist> + +<!-- slide 24 --> + + <para>Procedure Example</para> + + <itemizedlist> + + <listitem> + <para>Procedure that generates a PART that encompasses two specified SPHs</para> + </listitem> + + <listitem> + <para>proc sph-part {sph1 sph2 newname} {</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>foreach {vx1 vy1 vz1} [lindex [get $sph1 V] 0] {}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>foreach {vx2 vy2 vz2} [lindex [get $sph2 V] 0] {}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>foreach {ax1 ay1 az1} [lindex [get $sph1 A] 0] {}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>foreach {ax2 ay2 az2} [lindex [get $sph2 A] 0] {}</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set radius1 [expr sqrt($ax1*$ax1 + $ay1*$ay1 + $az1*$az1)]</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set radius2 [expr sqrt($ax2*$ax2 + $ay2*$ay2 + $az2*$az2)] </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set hx [expr $vx2-$vx1]</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set hy [expr $vy2-$vy1]</para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>set hz [expr $vz2-$vz1] </para> + </listitem> + + <listitem> + <para> </para> + </listitem> + + <listitem> + <para>in $newname part $vx1 $vy1 $vz1 $hx $hy $hz $radius1 $radius2</para> + </listitem> + + <listitem> + <para>}</para> + </listitem> + + </itemizedlist> + +<!-- slide 25 --> + + <para>Procedure Example (cont'd)</para> + + <itemizedlist> + + <listitem> + <para>mged></para> + </listitem> + + <listitem> + <para> sph-part s1.s s2.s part.s</para> + </listitem> + + </itemizedlist> + + <!-- image6.png --> + <!-- copy-sph-part-left.png --> +<figure> +<title>Procedure Example (1)</title> +<mediaobject> + <imageobject role='html'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/copy-sph-part-left.png" + /><!-- was: width='100%' --> + </imageobject> + <imageobject role='fo'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/copy-sph-part-left.png" + /> + </imageobject> + <textobject> + <phrase>a picture</phrase> + </textobject> +</mediaobject> +</figure> + + <!-- image7.png --> + <!-- copy-sph-part-right.png --> +<figure> +<title>Procedure Example (2)</title> +<mediaobject> + <imageobject role='html'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/copy-sph-part-right.png" + /><!-- was: width='100%' --> + </imageobject> + <imageobject role='fo'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/copy-sph-part-right.png" + /> + </imageobject> + <textobject> + <phrase>a picture</phrase> + </textobject> +</mediaobject> +</figure> + + +<!-- slide 26 --> + + <para>The "source" Command</para> + + <itemizedlist> + + <listitem> + <para>source <emphasis>fileName</emphasis></para> + </listitem> + + <listitem> + <para>Reads and executes the file as a Tcl script.</para> + </listitem> + + <listitem> + <para>Create the file with a text editor.</para> + </listitem> + + <listitem> + <para>Reload the file with "source" changes are made.</para> + </listitem> + + <listitem> + <para>The proc or the source command can be placed in .mgedrc.</para> + </listitem> + + </itemizedlist> + +<!-- slide 27 --> + + <para>MGED Defaults</para> + + <itemizedlist> + + <listitem> + <para>Create the default .mgedrc from inside MGED:</para> + </listitem> + + </itemizedlist> + + <!-- image8.png --> + <!-- mged-defaults.png --> +<figure> +<title>Mged Defaults</title> +<mediaobject> + <imageobject role='html'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/mged-defaults.png" + /><!-- was: width='100%' --> + </imageobject> + <imageobject role='fo'> + <imagedata + align='center' + width='5.5in' scalefit='1' + fileref="./images/mged-defaults.png" + /> + </imageobject> + <textobject> + <phrase>a picture</phrase> + </textobject> +</mediaobject> +</figure> + + +<!-- slide 28 --> + + <para>MGED Customization</para> + + <itemizedlist> + + <listitem> + <para>Placed in the file </para> + </listitem> + + <listitem> + <para>.mgedrc</para> + </listitem> + + <listitem> + <para>In local directory or home</para> + </listitem> + + <listitem> + <para>############### MGEDRC_HEADER ###############</para> + </listitem> + + <listitem> + <para># You can modify the values below. However, if you want</para> + </listitem> + + <listitem> + <para># to add new lines, add them above the MGEDRC_HEADER.</para> + </listitem> + + <listitem> + <para># Note - it's not a good idea to set the same variables</para> + </listitem> + + <listitem> + <para># above the MGEDRC_HEADER that are set below (i.e., the last</para> + </listitem> + + <listitem> + <para># value set wins).</para> + </listitem> + + <listitem> + <para>...</para> + </listitem> + + <listitem> + <para># Determines the maximum number of lines of</para> + </listitem> + + <listitem> + <para># output displayed in the command window</para> + </listitem> + + <listitem> + <para>set mged_default(max_text_lines) 1000</para> + </listitem> + + </itemizedlist> + +<!-- slide 29 --> + + <para>[incr Tcl/Tk]</para> + + <itemizedlist> + + <listitem> + <para>Object-oriented extension to Tcl.</para> + </listitem> + + <listitem> + <para>Provides support to build large programs. </para> + </listitem> + + <listitem> + <para>New applications in BRL-CAD are being written in [incr Tcl/Tk].</para> + </listitem> + + </itemizedlist> + +<!-- slide 30 --> + + <para>Useful References</para> + + <itemizedlist> + + <listitem> + <para>Raines, Paul. <emphasis>Tcl/Tk Pocket Reference</emphasis>. O'Reilly & Associates, Inc., Sebastopol, CA, 1998.</para> + </listitem> + + <listitem> + <para>Ousterhout, John K. <emphasis>Tcl and the Tk Toolkit</emphasis>. Addison-Wesley, Reading, MA, 1994.</para> + </listitem> + + <listitem> + <para>Welch, Brent B. <emphasis>Practical Programming in Tcl and Tk, Second Edition</emphasis>. Prentice Hall, Upper Saddle River, NJ, 1997. </para> + </listitem> + + </itemizedlist> + +</article> Property changes on: brlcad/trunk/doc/docbook/presentations/en/intro-to-tcltk.xml ___________________________________________________________________ Added: svn:eol + native Added: svn:mime-type + text/plain Added: svn:eol-style + native This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <tbr...@us...> - 2011-09-14 16:52:54
|
Revision: 46691 http://brlcad.svn.sourceforge.net/brlcad/?rev=46691&view=rev Author: tbrowder2 Date: 2011-09-14 16:52:48 +0000 (Wed, 14 Sep 2011) Log Message: ----------- renamed build variable to better track file tree name Modified Paths: -------------- brlcad/trunk/doc/docbook/Makefile.am brlcad/trunk/doc/docbook/system/man1/en/Makefile.am Modified: brlcad/trunk/doc/docbook/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/Makefile.am 2011-09-14 16:51:05 UTC (rev 46690) +++ brlcad/trunk/doc/docbook/Makefile.am 2011-09-14 16:52:48 UTC (rev 46691) @@ -53,14 +53,14 @@ $(BUILTLESSONS_ENPDF) \ $(BUILTLESSONS_ESHTML) \ $(BUILTLESSONS_ESPDF) \ + $(BUILTMAN1_ENHTML) \ + $(BUILTMAN1_ENPDF) \ $(BUILTMAN3_ENHTML) \ $(BUILTMAN3_ENPDF) \ $(BUILTMAN5_ENHTML) \ $(BUILTMAN5_ENPDF) \ $(BUILTMANN_ENHTML) \ $(BUILTMANN_ENPDF) \ - $(BUILTMAN_ENHTML) \ - $(BUILTMAN_ENPDF) \ $(BUILTPRESENTATIONS_ENHTML) \ $(BUILTPRESENTATIONS_ENPDF) \ $(BUILTSPECS_ENHTML) \ Modified: brlcad/trunk/doc/docbook/system/man1/en/Makefile.am =================================================================== --- brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2011-09-14 16:51:05 UTC (rev 46690) +++ brlcad/trunk/doc/docbook/system/man1/en/Makefile.am 2011-09-14 16:52:48 UTC (rev 46691) @@ -13,16 +13,16 @@ system/man1/en/tire.xml man1DOCBOOK_ENhtmldir = $(BRLCAD_DATA)/html/man1/en -man1DOCBOOK_ENhtml_DATA = $(BUILTMAN_ENHTML) +man1DOCBOOK_ENhtml_DATA = $(BUILTMAN1_ENHTML) -BUILTMAN_ENHTML = \ +BUILTMAN1_ENHTML = \ ${man1DOCBOOK_EN:xml=html} if BUILD_PDF_DOCS -BUILTMAN_ENPDF = ${man1DOCBOOK_EN:xml=pdf} +BUILTMAN1_ENPDF = ${man1DOCBOOK_EN:xml=pdf} endif man1DOCBOOK_ENpdfdir = $(BRLCAD_DATA)/pdf/man1/en -man1DOCBOOK_ENpdf_DATA = $(BUILTMAN_ENPDF) +man1DOCBOOK_ENpdf_DATA = $(BUILTMAN1_ENPDF) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <sta...@us...> - 2011-09-14 18:58:20
|
Revision: 46695 http://brlcad.svn.sourceforge.net/brlcad/?rev=46695&view=rev Author: starseeker Date: 2011-09-14 18:58:13 +0000 (Wed, 14 Sep 2011) Log Message: ----------- Fix up the presentations CMakeLists.txt logic Modified Paths: -------------- brlcad/trunk/doc/docbook/CMakeLists.txt brlcad/trunk/doc/docbook/presentations/CMakeLists.txt brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt Modified: brlcad/trunk/doc/docbook/CMakeLists.txt =================================================================== --- brlcad/trunk/doc/docbook/CMakeLists.txt 2011-09-14 18:52:15 UTC (rev 46694) +++ brlcad/trunk/doc/docbook/CMakeLists.txt 2011-09-14 18:58:13 UTC (rev 46695) @@ -70,6 +70,7 @@ ADD_SUBDIRECTORY(articles) ADD_SUBDIRECTORY(books) ADD_SUBDIRECTORY(lessons) +ADD_SUBDIRECTORY(presentations) ADD_SUBDIRECTORY(specifications) ADD_SUBDIRECTORY(system) Modified: brlcad/trunk/doc/docbook/presentations/CMakeLists.txt =================================================================== --- brlcad/trunk/doc/docbook/presentations/CMakeLists.txt 2011-09-14 18:52:15 UTC (rev 46694) +++ brlcad/trunk/doc/docbook/presentations/CMakeLists.txt 2011-09-14 18:58:13 UTC (rev 46695) @@ -1 +1,2 @@ ADD_SUBDIRECTORY(en) +CMAKEFILES(README) Modified: brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt =================================================================== --- brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt 2011-09-14 18:52:15 UTC (rev 46694) +++ brlcad/trunk/doc/docbook/presentations/en/CMakeLists.txt 2011-09-14 18:58:13 UTC (rev 46695) @@ -1,18 +1,19 @@ SET(docbook_presentations_EN intro-to-tcltk.xml -) + ) SET(docbook_presentations_EN_IMAGES - copy-sph-part-left.png - copy-sph-part-right.png - mged-defaults.png - special-character-interpretation.png - tk-based-gui-for-mged.png -) + images/copy-sph-part-left.png + images/copy-sph-part-right.png + images/mged-defaults.png + images/special-character-interpretation.png + images/tk-based-gui-for-mged.png + ) DOCBOOK_TO_HTML(presentation docbook_presentations_EN html/presentations/en) BRLCAD_ADDDATA(docbook_presentations_EN_IMAGES html/presentations/en/images) IF(BRLCAD_BUILD_EXTRADOCS_PDF) - DOCBOOK_TO_PDF(presentation docbook_presentations_EN pdf/presentations/en) + DOCBOOK_TO_PDF(presentation docbook_presentations_EN pdf/presentations/en) ENDIF(BRLCAD_BUILD_EXTRADOCS_PDF) +CMAKEFILES(Makefile.am) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |