Create BRL-CAD-to-Blender tutorialBRL-CAD
Status: ClosedTime to complete: 72 hrs Mentors: SeanTags: blender, 3d, modeling, tutorial

Blender is a open source 3D content creation program.  While it's usually not at all well-suited for engineering, scientific, and other CAD purposes, it's a popular content editor that is really good at some forms of editing (surface editing in particular).

This task has you write a tutorial on how to model something in BRL-CAD, render the geometry, export it to a file, import that file into Blender, and render the imported geometry.  Make a region of two or more primitive objects for export -- a single primitive is insufficient.  Include lots of screenshots for every step along the way.

References:

  • http://brlcad.org/wiki/Documentation (particularly the MGED tutorial and quick start)

Tools:

  • blender
  • g-* (we have lots of exporters, use any that blender supports)
  • mged (display and edit geometry, run "tops" and "draw" commands)
  • within mged: rt -s1024 -A0.75 -c {set ambSamples=128} -c {set ambSlow=1}

Note that exporting geometry from our CSG format to a polygonal format can be VERY difficult.  It's a black art.  If you encounter an export failure/bomb/error, you'll need to edit the geometry you're attempting to export, try different tolerances, change your hierarchy, or try a different geometry exporter.

 

Uploaded Work
File name/URLFile sizeDate submitted
BRL-CAD to Blender.docx41.8 KBDecember 14 2012 21:07 UTC
BRL-CAD to Blender.docx223.8 KBDecember 15 2012 12:30 UTC
Comments
Johnon December 13 2012 19:31 UTCTask Claimed

I would like to work on this task.

Daniel Rossberg on December 13 2012 19:34 UTCTask Assigned

This task has been assigned to John. You have 72 hours to complete this task, good luck!

Johnon December 13 2012 19:49 UTCExample file

Daniel,


do you know any good .g files for me to work with it?

Daniel Rossberg on December 13 2012 19:58 UTCshare/db in your BRL-CAD installation

There should be some example databases.  Open them with mged (for example) and select one for your tutorial.

Johnon December 13 2012 20:57 UTCTwo questions

Daniel,


Where should I post my tutorial?


Do I realy need to actually model something on BRL-CAD? Can't I simply use an existing file?

Sean on December 13 2012 21:41 UTCtechnically three questions

You'll post your tutorial here for starters and once it's looking good, you can migrate it to our wiki.


You can use one of our example databases (there are dozens included in an install), but know that some of them will not export to Blender.  Look for the moss.g model, that should be a nice and simple one that you can demo.


 

Johnon December 14 2012 21:30 UTCReady for review

The work on this task is ready to be reviewed.

Johnon December 14 2012 21:39 UTCSorry for the lack of images

My computer is very very very very very very slow and taking images is taking me way to much time.

Sean on December 15 2012 06:46 UTCBut without the images, it's useless

The only problem is that without the images, the tutorial isn't useful.  The reader has no way of knowing whether what they've done is right or wrong.  It needs to show a picture of the model in MGED and a picture of the final resulting model in Blender.


As for the text, there are a few mistakes to correct:



  • Prerequisite can be listed as "BRL-CAD 7.20.0+"

  • What is an "existential" file?

  • click-n-drop should be drag-n-drop

  • Every .g file does NOT have an "all.g" object

  • You should tell them how to determine what objects there are:


    • run "tops" in mged


  • .sxf is wrong, should be .dxf

  • What does "arrange the lighting scheme and the materials again" mean?


And again, it needs at least two more images.  It needs an image of moss.g's all.g in mged (run "draw all.g" then "ae 35 25" then "zoom 1.5" then Tools-Raytrace control panel).  In needs a full-screen screenshot of what results immediately after importing the dxf.


 

Sean on December 15 2012 06:46 UTCTask Needs More Work

One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.

Johnon December 15 2012 12:30 UTCReady for review

The work on this task is ready to be reviewed.

Melange on December 16 2012 19:34 UTCNo more Work can be submitted

Melange has detected that the deadline has passed and no more work can be submitted. The submitted work should be reviewed.

Sean on December 17 2012 06:23 UTCTask Closed

Congratulations, this task has been completed successfully.

Sean on December 17 2012 06:27 UTCmuch better

Now that's MUCH better.  I even like how you extended the tutorial to talk about how to reparameterize the triangle mesh into a quad mesh once imported into Blender.


Note that the reason for the scaling size disparity is because the moss.g model is modeled in millimeters and Blender was apparently set to meters prior to import.  If set to mm, the scaling step shouldn't be necessary.  Unfortunately, the dxf file format doesn't encode units, so the user must either make sure export units match blender or import units match brl-cad.


Thanks again, nicely done!

Sean on January 14 2013 15:00 UTCthank you

As GCI comes to a close, we wanted to take the time to say THANK YOU for all your efforts.  This comment interface closes after GCI is over, so you're encouraged to join our mailing list where we'll be announcing contributions from GCI participants like yourelf over the upcoming months: 


https://lists.sourceforge.net/lists/listinfo/brlcad-news


If you've provided your full name, we'll be sure to credit you in our authorship documentation and you'll see your name in a future announcement.  If you contact us at devs@brlcad.org or via IRC, we'll even let you know when your work is integrated and follow up with updates.  You're welcome and encouraged to contact us any time, especially if you have a question about how to continue participating in Open Source after GCI is over, but even if just to keep in touch.  Note that ongoing participation in Open Source is one of the most impressive skills to have on your resumé.  Take care, be well, and thank you again!


As you did several "articles", each one of them is going to make a special appearance on our news list with your name on them.  Cheers!  :)