Community Publication Portal

Welcome to the BRL-CAD community publication portal. This page is dedicated to the preparation and editing of community publications for BRL-CAD. Proposed and upcoming publications are listed with their individual editorial status. You are welcome and encouraged to help share news about recent events or current activities taking place within the BRL-CAD community by writing an article. Community editing is welcome.

Formatting & Editing Standards:

• Beginning quotations are italicized and placed between double quotes (wiki formatting requires 2 single quotes, space, double quote to achieve this)

• All acronyms need to be defined (Like This) upon first use; further use can use the acronym only

• Titles and Section Headings are bold (achieved by placing text between three single quotes); each should be Title Case (Meaning UpperCase the Major Words)

• Use the serial comma. One, two, and three; not one, two and three.

• Prefer first person for release notes, third person for everything else.

• Do not abbrev. words.

• Cite references and/or include hyperlinks.

• Keep it brief.

Distribution Channels:

For release publications, follow HACKING. For everything else, distribute to the following:

• brlcad-news@lists.sourceforge.net
• http://brlcad.org/d/node/add/story
• https://sourceforge.net/news/?group_id=105292
• (optional) https://brlcad.org/wiki/
• (optional) http://www.tenlinks.com/NEWS/tl_daily/submit_news.htm
• (optional) http://upfrontezine.com

---

Ready for Publication

These are articles ready for publication. Release notes should follow a release and get published within the first week of the month. Other publications should be scheduled one or two weeks later, ideally on the third week of the month.

Note: if you see a comment indicating that a section is FROZEN, any changes you make in that section may go unnoticed as the article is being prepared for distribution. If you find errors in a FROZEN article, go ahead and correct the article but contact Sean (brlcad on freenode IRC) who may be able to incorporate changes during final publication.

---

Final Editorial Review

These should be "complete" articles. The author is done with the content and all that remains is a review of structure, grammar, voice, punctuation, and spelling. Images may be added as well.

Release 7.20.2

This release marks the introduction of a new CMake build system for BRL-CAD. CMake is a cross-platform build system infrastructure capable of generating native build system logic for a wide variety of operating systems and compilation environments. Cliff Yapp has been diligently working on this adaptation for a number of months in order to simplify the task of maintaining BRL-CAD on multiple platforms.

Previously, there were two build sytems being maintained in BRL-CAD. One system was based on the GNU Autotools suite for Unix/Linux/BSD platforms (including Mac OSX); the other was Microsoft Visual Studio files for Windows. The new build system handles all supported platforms including Windows from the same build logic. This eliminates the need to manually update multiple build systems and improves BRL-CAD cross-platform maintainability.

• improved fusing of coplanar faces (tessellation) - Richard Weiss
• fixed rtwizard issues with unknown units and freezing - Bob Parker
• fixed problem with mater command setting color - Cliff Yapp
• fixed crash rendering scenes with all invalid lights - Sean Morrison
• improved reliability of ARS tessellation/conversion - Richard Weiss
• improved tessellation performance and reliability - Richard Weiss
• replaced 'erase_all' command with 'erase -r' - Brandon Hinesley
• improved 'ls' command error reporting in archer - Brandon Hinesley
• fixed related object highlighting in archer's tree view - Cliff Yapp
• added closedb command to archer - Brandon Hinesley
• improved behavior of opendb command in archer - Brandon Hinesley
• improved archer/mged manual page browser behavior - Brandon Hinesley
• added man documentation command to archer - Brandon Hinesley
• improved File->New dialog in mged - Brandon Hinesley
• all cmake files now included in dist - Erik Greenwald, Sean Morrison
• cross-platform 64-bit ISST (cmake-only) - Cliff Yapp, Erik Greenwald
• fixed mged zoom out mouse binding on Linux/*BSD - Cliff Yapp
• improved multiple path handling for search command - Cliff Yapp
• fixed segment splitting tessellation conversion bug - Richard Weiss
• fixed crash during facetization of large models - Richard Weiss
• fixed asc2g bug importing color and other attributes - Bob Parker
• added -q "quiet lookup" option to the 'ls' command - Cliff Yapp
• fixed numerous 'red' command text edit bugs and robustness issues
  • Cliff Yapp, Sean Morrison
• modification of LIBRT spatial partition traversal ordering
  • Sean Morrison, Keith Bowman
• new LIBRT_BOT_MINTIE environment variable override - Erik Greenwald
• changed search output order to shallow followed by deep - Cliff Yapp
• added search support for '.' object list search results - Cliff Yapp
• red -f flag to force overwriting pre-existing combs - Sean Morrison

---

Kyle Bodt: Ronja

http://brlcad.org/wiki/Ronja

Ronja (Reasonable Optical Near Joint Access) is an innovative piece of equipment that utilizes reliable optical data links to create a current communication range of 1.4 km and a speed of 10Mbps full duplex that can be used as a general purpose wireless link for virtually any networking project. This is a very important project for Twibright Labs, a small group of computer science graduate students operating out of Charles University in Prague in the Czech Republic. The group specializes in the usage of Free Software and User Controlled Technology Development.

The primary output for the Ronja project is a design. The lab does not intend to manufacture and sell the hardware that is being designed but wants to engage in open source development of the technology. The philosophy surrounding User Controlled Technology is the ideal that the end-user is provided with unrestricted access to the intellectual property surrounding the technology, including the tools that are being used to create it. One tool playing an integral part in the development of the Ronja designs is BRL-CAD. All of the models that Twibright labs use to display the different variants of their Ronja concept were created with the help of BRL-CAD. BRL-CAD has allowed the members of Twibright labs to create instructional diagrams so that the users and builders of their open source technology will be able to have the latest information with regard to the proper construction of a Ronja unit. The interactive geometry editor and ray-tracers in BRL-CAD are an integral part in the communication of design plans for Twibright labs and enables them to connect with the users, who are the driving force behind the User Controlled Technology ideal.

---

Initial Drafts

These are incomplete articles being worked on. Most articles should be between 250 and 500 words (not counting tables, labels, and diagrams) before they have enough content to be considered complete.

Cliff Yapp: NURBS Ray Tracing in BRL-CAD

Over the past year, an intense development effort by BRL-CAD's development team has successfully implemented raytracing of Non-Uniform Rational BSpline (NURBS) geometry within the BRL-CAD Computer-Aided Design (CAD) package. NURBS surfaces are very general, very complex mathematical shapes used by virtually all modern commercial CAD software packages. Because BRL-CAD did not originally support this type of geometry, commercial models could only be imported into BRL-CAD after a labor-intensive and difficult conversion process from NURBS form to triangle-base geometry (referred to in BRL-CAD as Bags-of-Triangles or BoTs). The new NURBS raytracing capability builds on work by many developers over a period of years, who in turn built on the open source library OpenNURBS. Support for this primitive type means BRL-CAD can now store and raytrace data from commercial models without requiring preliminary conversion to another type of geometry.

The last major feature needed to make import of commercial models in BRL-CAD straightforward is conversion support for ISO’s "Standard for the Exchange of Product model data" or STEP file format. STEP uses NURBS geometry in its definition, making support for NURBS geometry a necessary prelude to support for STEP import. Most commercial CAD modelers support this file format as an output option, hence STEP support in BRL-CAD would allow a direct path for moving geometric descriptions from a variety of commercial modelers to BRL-CAD. Considerable progress has already been made on STEP import support, but more work is need to bring the code and feature set to "production quality". If anyone would like to join the BRL-CAD open source development effort and has a little familiarity with C++, the step-g converter and its supporting libraries have some simple-yet-useful tasks that would be an excellent and very useful way to explore the project - join BRL-CAD's IRC channel or development email list if you are interested!

Erik Greenwald: Bolting ADRT's libtie under the hood

BoT vs Tie pixdiff

Initial progress on the integration of ADRT's libtie "triangle intersection engine" with LIBRT.

---

Idea Hopper

These are ideas for interesting or useful publications. We need someone to at least write a draft.

BRL-CAD's Evolutionary API

Talk about BRL-CAD deprecation process.

Introduction to new .deb and .rpm builds

Brief article overviewing the efforts by jordisayol for Debian, Ubuntu, Fedora, and openSUSE. Included are new icons, menu items, mime type associations, and more.

2010 End Of Year Review

Article giving an overview of the past year's highlight developments with hints at what 2011 may bring. Alternatively, may be the annual statistics review if we switch from fiscal to calendar year reporting.

Erik Greenwald: ADRT/ISST Visualization

Article introducing ADRT/ISST core capability.

Bob Parker: Alpha Archer: Working Towards Next Generation MGED

Article introducing Archer's core new features that will be "coming" to MGED. Undo, interactive editing, tree view, and info panels come to mind.

Finding the Hot Spots

Article on the rt lighting model Stephen Kennedy developed that visualizes the time spent per-pixel.

Point Clouds

Article introducing the new point cloud primitive.

bn_mat_inv: singular matrix

Article on the v4 format and binary compatibility.

Model Showcase: Goliath

Article talking about the making of the Goliath model.

Model Showcase: Chumaciera

Article on Pedro Baptista's bearing model.

Model Showcase: Proyecto Catapulta

Article on a model developed by André Santos, António Almeida, and Pedro Ferreira.

Model Showcase: Union Coupling Tool

Article on a model developed by Inês de Matos under teacher Luís Ferreira. The project focuses on a tool, union coupling, based on the book, http://purl.pt/14352 , page 122 of the original book and page 128 of the file, figures 108 and 109.

Geometry Service FAQ

FAQ summarization of the GS as it pertains to the wider open source community.

BRL-CAD's 3rd Generation Build System

Article on the new CMake build system.

BRL-CAD's Open Source Vision

Article introducing the Project Priorities diagram and overall project vision.

BRL-CAD Primitives Showcase

Article summarizing all of BRL-CAD's primitives and their current status.

BRL-CAD Geometry Converter Showcase

Article summarizing all of BRL-CAD's geometry converters.

Release Schedule

Explain our release schedule and versioning system.

RTGL

Article on Nick's point-based visualization mode.

BRL-CAD Quick Reference Card

Article on a BRL-CAD QRC similar to the existing MGED QRC.

BRL-CAD Bibliography

After the .bib gets published to the website, an article announcing it and soliciting additions.

Revolve Primitive

Article on Timothy Van Ruitenbeek's work implementing 'revolve'.

Parametrics and Constraints

Article on Dawn Thomas' work to integrate parametric equation and constraint evaluation support.

Converting Implicit to Explicit: CSG to BREP NURBS

Article on the work by Cliff Yapp, Joe Doliner, and Ben Poole converting primitives with an implicit representation into an explicit NURBS representation.

Online Model Repository

Article on Elena Băutu's work developing the model repository website.

Project Statistics for 2010

Article on our current stats similar to previous years.

Next Generation BRL-CAD

Article on our super secret awesome new GUI.