Editing Deuces

From BRL-CAD

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 59: Line 59:
 
Code:
 
Code:
 
* src/mged/mged.c
 
* src/mged/mged.c
* src/tclscripts/mged/openw.tcl
+
* src/tclscripts/mged/openw.c
  
 
|}
 
|}
Line 65: Line 65:
  
  
 +
|}
 +
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
Line 82: Line 84:
 
* src/librt/primitives/table.c
 
* src/librt/primitives/table.c
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c
 
|}
 
 
 
  
  
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
+
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 
+
==== ... centroid function for extruded sketches (EXTRUDE) ====
=== Implement a primitive curvature function ===
 
 
 
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones each described by a collection of callback functions, for example rt_sph_bbox() returns the bounding box dimensions for a sphere. Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.
 
 
 
This task involves writing the callback function rt_xxx_curve() that computes the curvature at a given point on the surface of a primitive such as;
 
* superell
 
* cline
 
* extrude
 
* grip
 
* metaball
 
* hrt. 
 
There are numerous examples in our code where we compute the curvature for other primtives like the ellipsoid, sphere, elliptical parabola, etc.
 
 
 
References:
 
* http://en.wikipedia.org/wiki/Curvature
 
* http://en.wikipedia.org/wiki/Radius_of_curvature_(mathematics)
 
* http://mathworld.wolfram.com/
 
* include/raytrace.h: See the data structure that holds the curvature of a surface at a point (from Line 296) as well as the prototype for ft_curve() callback function defined in the rt_functab structure ( Line 2078).
 
 
 
Code:
 
* src/librt/primitives/table.c
 
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c
 
 
 
 
|}
 
|}
 
 
 
 
 
  
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
Line 178: Line 153:
  
 
----
 
----
 
|}
 
 
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== Better placement of icons in wiki theme ===
 
 
BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme is responsive but has a small styling problem. On smaller screens icons near the search bar gets misplaced and unaligned. Your task would be to fix that. Task would include diving into sass file that corresponds to styling of this part of theme (given below) and adjusting spacing between icons to keep them aligned even at smaller screens.
 
 
Links:
 
*http://beta.brlcad.org/wiki/Main_Page
 
 
 
 
 
----
 
|}
 
  
 
== Documentation and Training ==
 
== Documentation and Training ==
Line 233: Line 191:
  
 
 
 
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== Translate "Contributors Guide To BRL-CAD" To Any Language ===
 
 
People interested in improving BRL-CAD sometimes find themselves lost in a sea of information. In all, BRL-CAD has more than a million words of documentation across hundreds of manual pages, dozens of tutorials and examples, hundreds of wiki pages, dozens of technical papers, and other resources. There are literally thousands of features and this can sometimes pose problems.
 
 
In 2013, a team of contributors got to California and worked on an entire book titled "Contributors Guide To BRL-CAD" in just a few days. This great resource needs to be translated to other languages to attract developers from other lingual backgrounds (who don't read English ) to contribute to BRL-CAD.
 
 
This task involves translating the chapters/sections of the "Contributors Guide To BRL-CAD" into a language of your choice such as Mandarin, French, Chinese, Spanish, German, Hindi, Arabic, Russian, etc. Chapters/Sections include
 
 
* Feature Overview
 
* Working with our Code
 
* What code to work on
 
* How to contribute
 
* .... (Just to name a few )
 
 
The output of this task can be a pdf, html, doc, odt or any other document file that contains the translated article.Images in the original document (see link in Reference below) should not be changed ! only text should be.
 
 
Reference:
 
* http://en.flossmanuals.net/_booki/contributors-guide-to-brl-cad/contributors-guide-to-brl-cad.pdf
 
 
|}
 
 
 
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
 
=== Write a "BRL-CAD Commands Quick Reference" document ===
 
=== Write a "BRL-CAD Commands Quick Reference" document ===
  
Line 274: Line 204:
 
* http://brlcad.org/wiki/Documentation
 
* http://brlcad.org/wiki/Documentation
 
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf
 
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf
* [http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png git example]
+
* http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png
* [http://www.stdout.org/~winston/latex/latexsheet-0.png latex example]
+
* http://www.stdout.org/~winston/latex/latexsheet-0.png
* [http://img.docstoccdn.com/thumb/orig/524314.png another example]
+
* http://img.docstoccdn.com/thumb/orig/524314.png
* [http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png drupal example]
+
* http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png
* [http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg php example]
+
* http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg
  
 
|}
 
|}
Line 284: Line 214:
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 
 
=== Doxygen cleanup ===
 
=== Doxygen cleanup ===
  
Line 430: Line 359:
 
|}
 
|}
  
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== Make a step by step tutorial for creating BRL-CAD model ===
 
 
BRL-CAD is said to have an expert friendly User Interface so new users mostly have a tough time getting around it's UI and making models. So anything link Django poll app tutorial https://docs.djangoproject.com/en/dev/intro/tutorial01/ would be very helpful.
 
 
 
|}
 
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== Find 5 bugs in OGV ===
 
 
Online Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally and find 5 bugs or errors in it.
 
 
Links:
 
https://github.com/BRL-CAD/OGV-meteor/
 
 
|}
 
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
=== Find 5 coding guidelines violations in OGV ===
 
 
Online Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally, look into code and see if any coding guidelines are violated.
 
 
Links:
 
https://github.com/BRL-CAD/OGV-meteor/
 
 
|}
 
  
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
----
 
----
  
Line 592: Line 484:
 
|}
 
|}
  
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== Tweak BRL-CAD logo to wish New Year ===
 
 
You might have heard and praised those google doodles we occasionally see on google.com on special days. This task is all about tweaking BRL-CAD logo to wish New Year. You may have a look at google doodles but don't entirely copy their style. I am sure your creative mind will get something much better.
 
Make sure this tweak should be tweaked version of current logo and not entirely new logo.
 
 
Tip: Search for some global events occurring in 2015 and design accordingly. Also keep the letters 2,0,1,5 in mind while designing. ;)
 
 
Also output of this task shall be the png file of your work and the raw file but don't upload the raw file(.psd, .xcf or some other) for review of this task. We will ask for it later, when the design is finalized.
 
 
Gallery of all google doodles
 
* http://www.google.com/doodles
 
 
 
|}
 
 
 
 
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
=== Tweak BRL-CAD logo to wish Merry Christmas ===
 
 
You might have heard and praised those google doodles we occasionally see on google.com on special days. This task is all about tweaking BRL-CAD logo to wish Christmas. You may have a look at google doodles but don't entirely copy their style. I am sure your creative mind will get something much better.
 
Make sure the output of this task should be tweaked version of current logo and not entirely new logo.
 
 
Also output of this task shall be the png file of your work and the raw file but don't upload the raw file(.psd, .xcf or some other) for review of this task. We will ask for it later, when the design is finalized.
 
 
Gallery of all google doodles
 
* http://www.google.com/doodles
 
 
 
|}
 
  
 
----
 
----
Line 696: Line 553:
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
=== Create a utility library (LIBBU) API unit test ===
+
=== Create an utility library (LIBBU) API unit test ===
  
 
There are more than 300 library functions in our core LIBBU library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
 
There are more than 300 library functions in our core LIBBU library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
  
This task involves implementing new unit tests for any of LIBBU's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as examples.
+
This task involves implementing a new unit test for any of LIBBU's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as an example.
  
 
References:
 
References:
Line 721: Line 578:
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 
+
=== Create numerics library (LIBBN) API unit test ===
=== Create Numerics library (LIBBN) API unit tests ===
 
  
 
There are more than 300 library functions in our core LIBBN library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
 
There are more than 300 library functions in our core LIBBN library.  As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important.
  
This task involves implementing new unit tests for any of LIBBN's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as examples.
+
This task involves implementing a new unit test for any of LIBBN's source files that do not already have a unit test defined.  The test should run all of the public functions and be hooked into our build system.  We have lots of existing unit tests to follow as an example.
  
 
References:
 
References:
Line 733: Line 589:
 
* include/vmath.h
 
* include/vmath.h
 
* src/libbn/*.c
 
* src/libbn/*.c
* src/libbn/tests/*.c <-- check this directory for examples
+
* src/libbu/tests/*.c <-- note libbu, not libbn for examples
* src/libbu/tests/*.c <-- Note: Also check this too for more examples.
 
  
 
Code:
 
Code:
 
* src/libbn/tests/[TEST].c
 
* src/libbn/tests/[TEST].c
 
* src/libbn/tests/CMakeLists.txt
 
* src/libbn/tests/CMakeLists.txt
 
<b> Note </b>
 
A valid task will constitute writing a basic test for each function in the following libbn/ files.
 
  
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
==== ... unit tests for LIBBN anim.c ====
+
==== ... unit test for LIBBN axis.c ====
 
|}
 
|}
 
&nbsp;
 
&nbsp;
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 
+
==== ... unit test for LIBBN qmath.c ====
*Useful resources
 
  ->coming!
 
 
 
==== ... unit tests for LIBBN axis.c ====
 
 
|}
 
|}
 
&nbsp;
 
&nbsp;
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
==== ... unit tests for LIBBN qmath.c ====
+
==== ... unit test for LIBBN rand.c ====
|}
 
&nbsp;
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
 
 
 
 
*Useful links and Resources
 
-> Coming!
 
 
 
==== ... unit tests for LIBBN rand.c ====
 
|}
 
&nbsp;
 
{| cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
==== ... unit tests for LIBBN vector.c ====
 
 
|}
 
|}
 
|}
 
|}
Line 781: Line 614:
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"
 
|
 
|
 
*Useful links and resources
 
-> To be added.
 
 
 
=== Find, reliably reproduce, and report any bug in Archer ===
 
=== Find, reliably reproduce, and report any bug in Archer ===
  
Line 918: Line 747:
 
Reference:  
 
Reference:  
 
*https://developers.google.com/chart/interactive/docs/index
 
*https://developers.google.com/chart/interactive/docs/index
 
 
|}
 
 
=== Design a hall of fame for BRL-CAD developers ===
 
 
We love our developers and want to have a special place in it's website to thank and motivate hard working folks behind BRL-CAD. Your task would be to use an image manipulation software such as GIMP or Photoshop and design a hall of fame page for developers. It should have avatars and names of all the developers. For inspiration you can take a look at http://underscores.me/. You are free to experiment and design anyway you want, just make sure that the color scheme and font-scheme is consistent with the new BRL-CAD web design.
 
 
Links:
 
* http://cpp-tricks.com/brlcad/
 
* http://underscores.me/
 
  
  

Please note that all contributions to BRL-CAD may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BRL-CAD:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)