https://brlcad.org/w/api.php?action=feedcontributions&user=Vikram+Atreya&feedformat=atomBRL-CAD - User contributions [en]2024-03-29T14:18:35ZUser contributionsMediaWiki 1.32.2https://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12012User:Vikram Atreya/GSoC21/Project Report2021-08-23T11:12:47Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was <br><br />
1 obj_name == obj1_name was made <br><br />
2 obj_name == obj1_name was killed <br><br />
0 attr_obj == reverse all sub-actions within attr_obj which is an attribute object containing lot of sub-actions <be><br />
<br />
Every command can be broken down into a series of makes and kills and can be represented in the string. The way make is undone is by deleting the object with the name stored.For kill, a backup of it is hidden and stored with a suffix attached, when UNDO is called, the backup is renamed by removing the suffix and unhidden.<br />
<br />
Using the above mentioned technique undo was implemented for many commands, but not a complex commands don't have undo functionality yet. There are also a few TODO tasks before the PR is merged<br />
*Handle flags properly in the wrapper code<br />
*Enable the -n flag for UNDO<br />
*Randomize names of attribute objects that are created<br />
<br />
Overall my GSoC experience was very good from the start to the end. I ended up learning a lot of things from C functionality to how a developer works and the importance of consistency. I would like to thank Google, BRL-CAD, and my mentor Sean Morrison for the opportunity and constant support.<br />
<br />
Link to my PRs: <br><br />
[https://sourceforge.net/p/brlcad/patches/570/ Dummy UNDO command] <br><br />
[https://sourceforge.net/p/brlcad/patches/571/ UNDO for make, kill and simple commands] <br><br />
[https://sourceforge.net/p/brlcad/patches/572/ UNDO using action strings] <br><br />
<br />
- Vikram</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12011User:Vikram Atreya/GSoC21/Project Report2021-08-23T11:12:34Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was <br><br />
1 obj_name == obj1_name was made <br><br />
2 obj_name == obj1_name was killed <br><br />
0 attr_obj == reverse all sub-actions within attr_obj which is an attribute object containing lot of sub-actions <be><br />
<br />
Every command can be broken down into a series of makes and kills and can be represented in the string. The way make is undone is by deleting the object with the name stored.For kill, a backup of it is hidden and stored with a suffix attached, when UNDO is called, the backup is renamed by removing the suffix and unhidden.<br />
<br />
Using the above mentioned technique undo was implemented for many commands, but not a complex commands don't have undo functionality yet. There are also a few TODO tasks before the PR is merged<br />
*Handle flags properly in the wrapper code<br />
*Enable the -n flag for UNDO<br />
*Randomize names of attribute objects that are created<br />
<br />
Overall my GSoC experience was very good from the start to the end. I ended up learning a lot of things from C functionality to how a developer works and the importance of consistency. I would like to thank Google, BRL-CAD, and my mentor Sean Morrison for the opportunity and constant support.<br />
<br />
Link to my PRs:<br />
[https://sourceforge.net/p/brlcad/patches/570/ Dummy UNDO command] <br><br />
[https://sourceforge.net/p/brlcad/patches/571/ UNDO for make, kill and simple commands] <br><br />
[https://sourceforge.net/p/brlcad/patches/572/ UNDO using action strings] <br><br />
<br />
- Vikram</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12010User:Vikram Atreya/GSoC21/Project Report2021-08-23T11:12:18Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was <br><br />
1 obj_name == obj1_name was made <br><br />
2 obj_name == obj1_name was killed <br><br />
0 attr_obj == reverse all sub-actions within attr_obj which is an attribute object containing lot of sub-actions <be><br />
<br />
Every command can be broken down into a series of makes and kills and can be represented in the string. The way make is undone is by deleting the object with the name stored.For kill, a backup of it is hidden and stored with a suffix attached, when UNDO is called, the backup is renamed by removing the suffix and unhidden.<br />
<br />
Using the above mentioned technique undo was implemented for many commands, but not a complex commands don't have undo functionality yet. There are also a few TODO tasks before the PR is merged<br />
*Handle flags properly in the wrapper code<br />
*Enable the -n flag for UNDO<br />
*Randomize names of attribute objects that are created<br />
<br />
Overall my GSoC experience was very good from the start to the end. I ended up learning a lot of things from C functionality to how a developer works and the importance of consistency. I would like to thank Google, BRL-CAD, and my mentor Sean Morrison for the opportunity and constant support.<br />
<br />
Link to my PRs:<br />
[https://sourceforge.net/p/brlcad/patches/570/ Dummy UNDO command]<br />
[https://sourceforge.net/p/brlcad/patches/571/ UNDO for make, kill and simple commands]<br />
[https://sourceforge.net/p/brlcad/patches/572/ UNDO using action strings]<br />
<br />
- Vikram</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12009User:Vikram Atreya/GSoC21/Project Report2021-08-23T11:08:56Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was <br><br />
1 obj_name == obj1_name was made <br><br />
2 obj_name == obj1_name was killed <br><br />
0 attr_obj == reverse all sub-actions within attr_obj which is an attribute object containing lot of sub-actions <be><br />
<br />
Every command can be broken down into a series of makes and kills and can be represented in the string. The way make is undone is by deleting the object with the name stored.For kill, a backup of it is hidden and stored with a suffix attached, when UNDO is called, the backup is renamed by removing the suffix and unhidden.<br />
<br />
Using the above mentioned technique undo was implemented for many commands, but not a complex commands don't have undo functionality yet. There are also a few TODO tasks before the PR is merged<br />
*Handle flags properly in the wrapper code<br />
*Enable the -n flag for UNDO<br />
*Randomize names of attribute objects that are created<br />
<br />
Overall my GSoC experience was very good from the start to the end. I ended up learning a lot of things from C functionality to how a developer works and the importance of consistency. I would like to thank Google, BRL-CAD, and my mentor Sean Morrison for the opportunity and constant support.<br />
<br />
- Vikram</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12008User:Vikram Atreya/GSoC21/Project Report2021-08-23T11:00:59Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was <br><br />
1 obj_name == obj1_name was made <br><br />
2 obj_name == obj1_name was killed <br><br />
0 attr_obj == reverse all commands with attr_obj which is an attribute object containing lot of sub-actions <br><br />
<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12007User:Vikram Atreya/GSoC21/Project Report2021-08-23T11:00:17Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was<br />
1 obj_name == obj1_name was made<br />
2 obj_name == obj1_name was killed<br />
0 attr_obj == reverse all commands with attr_obj which is an attribute object containing lot of sub-actions<br />
<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12006User:Vikram Atreya/GSoC21/Project Report2021-08-23T10:59:47Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
'''<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
<br />
The notation used was<br />
1 obj_name == obj1_name was made<br />
2 obj_name == obj1_name was killed<br />
0 attr_obj == reverse all commands with attr_obj which is an attribute object containing lot of sub-actions<br />
<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12005User:Vikram Atreya/GSoC21/Project Report2021-08-23T10:59:24Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
'''<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. <br />
<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
The notation used was<br />
1 obj_name == obj1_name was made<br />
2 obj_name == obj1_name was killed<br />
0 attr_obj == reverse all commands with attr_obj which is an attribute object containing lot of sub-actions<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12004User:Vikram Atreya/GSoC21/Project Report2021-08-23T10:49:13Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. //<br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for the object being acted upon. //<br />
Since storing different information divided over many variables is unsuitable, a data structure was made to hold all the information. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. Every time a command is performed relevant information is concatenated to the action_string stored in _GLOBAL. For eg, make sph1.s sph would add "1 sph1.s". When undo is called the last action will be reversed and the last command info is popped from the string. For complex commands, we create a separate attribute object that might have multiple make or kill operations, which as a combination represents a complex command/action.<br />
The notation used was<br />
1 obj_name == obj1_name was made<br />
2 obj_name == obj1_name was killed<br />
0 attr_obj == reverse all commands with attr_obj which is an attribute object containing lot of sub-actions<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12003User:Vikram Atreya/GSoC21/Project Report2021-08-23T05:35:43Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|Proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point. After each step, we would need to store the last action and some details like which action and object. this information is stored as a string-value-pair in the _GLOBAL object. Initially, this data was stored in 2 separate variables one for the last action and one for object being acted upon.<br />
Since storing different information divided over many variables is not suitable, a data structure was made to hold all the information within it. This proved to be tough and making a linked list of these data structures wasn't easy. So a method was chosen to have all the information in 1 string and store that in _GLOBAL. <br />
To be contined...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12002User:Vikram Atreya/GSoC21/Project Report2021-08-23T04:41:22Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point.<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12001User:Vikram Atreya/GSoC21/Project Report2021-08-23T04:40:59Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point.<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=12000User:Vikram Atreya/GSoC21/Project Report2021-08-23T04:40:37Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|proposal]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point.<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=11999User:Vikram Atreya/GSoC21/Project Report2021-08-22T05:22:30Z<p>Vikram Atreya: </p>
<hr />
<div>= Project Report =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO<br />
<br />
The project started with deciding which kind of undo to be implemented. Various implementations were thought about including a complete re-run approach, partial checkpoint, full checkpoint, etc as discussed in detail in my [[https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|proposal]]. Using a version control system like libgit2 was also explored, but was found to be sub-optimal since it was occupying a lot of extra space and was also not very time efficient. <br />
It was decided that the undo would be implemented using a partial checkpoint-like approach, where a change in an object at any step would be the only thing stored at that step instead of storing a full checkpoint of the .g file at that point.<br />
To be continued...</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project_Report&diff=11998User:Vikram Atreya/GSoC21/Project Report2021-08-22T04:47:34Z<p>Vikram Atreya: created report page</p>
<hr />
<div>Project Report<br />
test</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Google_Summer_of_Code/2021&diff=11991Google Summer of Code/20212021-07-25T10:36:20Z<p>Vikram Atreya: </p>
<hr />
<div>= GSoC 2021 With BRL-CAD =<br />
<br />
'''BRL-CAD was accepted as an [https://summerofcode.withgoogle.com umbrella mentoring organization] for the Google Summer of Code!''' This year, we accepted 6 students to work on IfcOpenShell, BRL-CAD, FreeCAD, and OpenSCAD. <br />
<br />
<br />
= Accepted Projects =<br />
<br />
<!-- *** TO LIST A NEW PROJECT ***<br />
<br />
Copy this template and append your block at the end of this site.<br />
<br />
== Title Goes Here ==<br />
* Description: Awesome Sauce -- SHOULD BE JUST ONE SENTENCE... not an explanation<br />
* Org: BRL-CAD or LibreCAD or FreeCAD or OpenSCAD or Slic3r or IfcOpenShell or ...<br />
* Student: [[User:StudentName|Student Name]]<br />
* [[User:StudentName/GSoC20/Abstract| Abstract]]<br />
* [[User:StudentName/GSoC20/Project|Project Plan]]<br />
* [[User:StudentName/GSoC20/Log|Dev Log]]<br />
<br />
NOTE: do not link to the summerofcode.withgoogle.com site as the data is completely wiped annually...<br />
<br />
--><br />
<br />
== Implement UNDO and transactional changes ==<br />
* Description: This project implements intrinsic transactional undo support for BRL-CAD geometry. <br />
* Org: BRL-CAD<br />
* Student: [[User:Vikram_Atreya]|Vikram Atreyapurapu]<br />
* [[https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|Abstract]]<br />
* [[User:Vikram_Atreya/GSoC21/Project|Project Plan]]<br />
* [[User:Vikram_Atreya/GSoC21/Log|Dev Log]]<br />
<br />
== Add IDS validation with BCF output to IfcOpenShell ==<br />
* Description: This project adds Information Delivery Specifications (IDS) validation and file handling to IfcOpenShell. <br />
<!-- This looks like a good Abstract... --Sean.<br />
IDS (Information Delivery Specifications) in simple terms is a machine-readable standard for Building Information Modelling (BIM) requirements. Thanks to IDS, it is possible to automatically verify exchange requirements of BIM models delivered in IFC format. This project aims to implement IDS validation process to IfcOpenShell, create sample IDS files to test it against and allow the creation of validation reports in BIM Collaboration Format (BCF). Apart from that, a user-friendly web application will be developed to allow using IDS by non-coding users.--><br />
* Org: IfcOpenShell<br />
* Student: [[User:Artur|Artur Tomczak]]<br />
* [[User:Artur/GSoC21/Abstract|Abstract]]<br />
* [[User:Artur/GSoC21/Project|Project Plan]]<br />
* [[User:Artur/GSoC21/Log|Dev Log]]<br />
<br />
== Generator for offline documentation ==<br />
* Description: This project aims to provide a program to generate an offline version of the Manual, which can be run at the time of build.<br />
* Org: OpenSCAD<br />
* Student: [[User:ABSHK|Abhishek Rawat]]<br />
* [[User:ABSHK/GSoC21/Abstract| Abstract]]<br />
* [[User:ABSHK/GSoC21/Project|Project Plan]]<br />
* [[User:ABSHK/GSoC21/Log|Dev Log]]<br />
<br />
== Open Geometry Viewer(OGV) ==<br />
* Description: Online Geometry Viewer is an online web application, where users can upload, view, and share 3D CAD models. This project aims to add new features during GSoC 2021, and fix bugs and issues.<br />
* Org: BRL-CAD<br />
* Student: [[User:Theamanjs|Amanjot Singh]]<br />
* [[User:Theamanjs/GSoC21/Abstract| Abstract]]<br />
* [[User:Theamanjs/GSoC21/Project|Project Plan]]<br />
* [[User:Theamanjs/GSoC21/Log|Dev Log]]</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Google_Summer_of_Code/2021&diff=11990Google Summer of Code/20212021-07-25T10:35:10Z<p>Vikram Atreya: </p>
<hr />
<div>= GSoC 2021 With BRL-CAD =<br />
<br />
'''BRL-CAD was accepted as an [https://summerofcode.withgoogle.com umbrella mentoring organization] for the Google Summer of Code!''' This year, we accepted 6 students to work on IfcOpenShell, BRL-CAD, FreeCAD, and OpenSCAD. <br />
<br />
<br />
= Accepted Projects =<br />
<br />
<!-- *** TO LIST A NEW PROJECT ***<br />
<br />
Copy this template and append your block at the end of this site.<br />
<br />
== Title Goes Here ==<br />
* Description: Awesome Sauce -- SHOULD BE JUST ONE SENTENCE... not an explanation<br />
* Org: BRL-CAD or LibreCAD or FreeCAD or OpenSCAD or Slic3r or IfcOpenShell or ...<br />
* Student: [[User:StudentName|Student Name]]<br />
* [[User:StudentName/GSoC20/Abstract| Abstract]]<br />
* [[User:StudentName/GSoC20/Project|Project Plan]]<br />
* [[User:StudentName/GSoC20/Log|Dev Log]]<br />
<br />
NOTE: do not link to the summerofcode.withgoogle.com site as the data is completely wiped annually...<br />
<br />
--><br />
<br />
== Implement UNDO and transactional changes ==<br />
* Description: This project implements intrinsic transactional undo support for BRL-CAD geometry. <br />
* Org: BRL-CAD<br />
* Student: [[User:Vikram_Atreya]|Vikram Atreyapurapu]<br />
* [[https://docs.google.com/document/d/1cZLgqVvxOiy7PgkUzEzeyXXhmLx1sEgRB1xw3hDFUlA/edit?usp=sharing|Abstract]]<br />
* [[https://brlcad.org/wiki/User:Vikram_Atreya/GSoC21/Project|Project Plan]]<br />
* [[https://brlcad.org/wiki/User:Vikram_Atreya/GSoC21/Log|Dev Log]]<br />
<br />
== Add IDS validation with BCF output to IfcOpenShell ==<br />
* Description: This project adds Information Delivery Specifications (IDS) validation and file handling to IfcOpenShell. <br />
<!-- This looks like a good Abstract... --Sean.<br />
IDS (Information Delivery Specifications) in simple terms is a machine-readable standard for Building Information Modelling (BIM) requirements. Thanks to IDS, it is possible to automatically verify exchange requirements of BIM models delivered in IFC format. This project aims to implement IDS validation process to IfcOpenShell, create sample IDS files to test it against and allow the creation of validation reports in BIM Collaboration Format (BCF). Apart from that, a user-friendly web application will be developed to allow using IDS by non-coding users.--><br />
* Org: IfcOpenShell<br />
* Student: [[User:Artur|Artur Tomczak]]<br />
* [[User:Artur/GSoC21/Abstract|Abstract]]<br />
* [[User:Artur/GSoC21/Project|Project Plan]]<br />
* [[User:Artur/GSoC21/Log|Dev Log]]<br />
<br />
== Generator for offline documentation ==<br />
* Description: This project aims to provide a program to generate an offline version of the Manual, which can be run at the time of build.<br />
* Org: OpenSCAD<br />
* Student: [[User:ABSHK|Abhishek Rawat]]<br />
* [[User:ABSHK/GSoC21/Abstract| Abstract]]<br />
* [[User:ABSHK/GSoC21/Project|Project Plan]]<br />
* [[User:ABSHK/GSoC21/Log|Dev Log]]<br />
<br />
== Open Geometry Viewer(OGV) ==<br />
* Description: Online Geometry Viewer is an online web application, where users can upload, view, and share 3D CAD models. This project aims to add new features during GSoC 2021, and fix bugs and issues.<br />
* Org: BRL-CAD<br />
* Student: [[User:Theamanjs|Amanjot Singh]]<br />
* [[User:Theamanjs/GSoC21/Abstract| Abstract]]<br />
* [[User:Theamanjs/GSoC21/Project|Project Plan]]<br />
* [[User:Theamanjs/GSoC21/Log|Dev Log]]</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11954User:Vikram Atreya/GSoC21/Log2021-07-05T20:01:27Z<p>Vikram Atreya: Week 4 update</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here<br />
** Day 3-4<br />
*** Refined code of g cmd undo and updated PR<br />
*** Attempt at reefactoring code to libged/undo.cpp failed; Not right place to put the code<br />
*** Refactored make's undo code into mged/utility1.c and replaced code in make, in and g<br />
*** Solved major bug that made children objects disappear when any object was killed<br />
*** logic: renamed all leaves by adding sufffix, thereby poiting to imaginary objects and not hiding the references it had previously<br />
** Day 5-6<br />
*** Implemented undo for mv and mvall<br />
*** Also restructured code in undo.cpp to accommodate more cmds easily<br />
*** Made a spreadsheet with status of implementation for all commands<br />
<br />
* Week - 3<br />
** Day 1-2<br />
*** Solved a long pending bug<br />
** Day 3-4<br />
*** Took a break<br />
** Day 5-6<br />
*** Started work on storing objects as data in binary objects<br />
*** Understood code of mk_binunif, make and libged/bo.c<br />
<br />
* Week - 4<br />
** Day 1-2<br />
*** Done writing basic test to store and recover objects from a binary object<br />
*** Stored internal data in binary object, storing external data is better since it contains type information as well<br />
*** Switched code from storing internal to external of object<br />
** Day 3-4<br />
*** Ideated and tried different ways in which we could store the recovery data<br />
*** Wrote code implementing a new struct in ged/defines.h<br />
*** Mimicked history implementation for the struct<br />
** Day 5-6<br />
*** Implemented undo using the struct but realized it would not work<br />
*** Thought of using char** arrays to store the commands<br />
*** Have to discuss with mentor on a better approach</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11952User:Vikram Atreya/GSoC21/Log2021-06-30T19:40:50Z<p>Vikram Atreya: Week 4, day 1-2 update</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here<br />
** Day 3-4<br />
*** Refined code of g cmd undo and updated PR<br />
*** Attempt at reefactoring code to libged/undo.cpp failed; Not right place to put the code<br />
*** Refactored make's undo code into mged/utility1.c and replaced code in make, in and g<br />
*** Solved major bug that made children objects disappear when any object was killed<br />
*** logic: renamed all leaves by adding sufffix, thereby poiting to imaginary objects and not hiding the references it had previously<br />
** Day 5-6<br />
*** Implemented undo for mv and mvall<br />
*** Also restructured code in undo.cpp to accommodate more cmds easily<br />
*** Made a spreadsheet with status of implementation for all commands<br />
<br />
* Week - 3<br />
** Day 1-2<br />
*** Solved a long pending bug<br />
** Day 3-4<br />
*** Took a break<br />
** Day 5-6<br />
*** Started work on storing objects as data in binary objects<br />
*** Understood code of mk_binunif, make and libged/bo.c<br />
<br />
* Week - 4<br />
** Day 1-2<br />
*** Done writing basic test to store and recover objects from a binary object<br />
*** Stored internal data in binary object, storing external data is better since it contains type information as well<br />
*** Switched code from storing internal to external of object</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11949User:Vikram Atreya/GSoC21/Log2021-06-28T23:30:19Z<p>Vikram Atreya: Updated week 3 logs</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here<br />
** Day 3-4<br />
*** Refined code of g cmd undo and updated PR<br />
*** Attempt at reefactoring code to libged/undo.cpp failed; Not right place to put the code<br />
*** Refactored make's undo code into mged/utility1.c and replaced code in make, in and g<br />
*** Solved major bug that made children objects disappear when any object was killed<br />
*** logic: renamed all leaves by adding sufffix, thereby poiting to imaginary objects and not hiding the references it had previously<br />
** Day 5-6<br />
*** Implemented undo for mv and mvall<br />
*** Also restructured code in undo.cpp to accommodate more cmds easily<br />
*** Made a spreadsheet with status of implementation for all commands<br />
<br />
* Week - 3<br />
** Day 1-2<br />
*** Solved a long pending bug<br />
** Day 3-4<br />
*** Took a break<br />
** Day 5-6<br />
*** Started work on storing objects as data in binary objects<br />
*** Understood code of mk_binunif, make and libged/bo.c<br />
<br />
* Week - 4<br />
** Day 1-2<br />
Done writing basic test to store and recover objects from a binary object</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11940User:Vikram Atreya/GSoC21/Log2021-06-25T04:30:45Z<p>Vikram Atreya: /* Weekly update - Coding Period */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here<br />
** Day 3-4<br />
*** Refined code of g cmd undo and updated PR<br />
*** Attempt at reefactoring code to libged/undo.cpp failed; Not right place to put the code<br />
*** Refactored make's undo code into mged/utility1.c and replaced code in make, in and g<br />
*** Solved major bug that made children objects disappear when any object was killed<br />
*** logic: renamed all leaves by adding sufffix, thereby poiting to imaginary objects and not hiding the references it had previously<br />
** Day 5-6<br />
*** Implemented undo for mv and mvall<br />
*** Also restructured code in undo.cpp to accommodate more cmds easily<br />
*** Made a spreadsheet with status of implementation for all commands<br />
<br />
* Week - 3<br />
** Day 1-2<br />
*** Solved a long pending bug<br />
** Day 3-4<br />
*** Took a break</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11937User:Vikram Atreya/GSoC21/Log2021-06-21T19:41:04Z<p>Vikram Atreya: </p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here<br />
** Day 3-4<br />
*** Refined code of g cmd undo and updated PR<br />
*** Attempt at reefactoring code to libged/undo.cpp failed; Not right place to put the code<br />
*** Refactored make's undo code into mged/utility1.c and replaced code in make, in and g<br />
*** Solved major bug that made children objects disappear when any object was killed<br />
*** logic: renamed all leaves by adding sufffix, thereby poiting to imaginary objects and not hiding the references it had previously<br />
** Day 5-6<br />
*** Implemented undo for mv and mvall<br />
*** Also restructured code in undo.cpp to accommodate more cmds easily<br />
*** Made a spreadsheet with status of implementation for all commands<br />
<br />
* Week - 3<br />
** Day 1-2<br />
*** Solved a long pending bug</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Tutorial/Newbie&diff=11933Tutorial/Newbie2021-06-21T18:19:18Z<p>Vikram Atreya: /* Installing on Ubuntu/Debian */</p>
<hr />
<div>BRL-CAD for Newbies<br />
<br />
By: Cameron Wolfe, wiki-brlcad, and others<br />
<br />
BRL-CAD is a computer-aided design (CAD) software. It allows you to design houses if you are an architect, design robotics part, or just draw and model things you find in the world.<br />
<br />
<br />
<br />
=Installation=<br />
<br />
In order to take advantage of this tool, you need to download and install it on your computer.<br />
<br />
<br />
<br />
==Installing on Windows==<br />
<br />
[[File:BRL-CAD homepage.PNG|center|thumb|700px|1. Go to http://brlcad.org/]]<br />
[[File:Download.PNG|center|thumb|700px|2. Click Download]]<br />
[[File:DownloadPage.PNG|center|thumb|700px|3. You will find yourself on the download page.]]<br />
[[File:DownloadIt.PNG|center|thumb|700px|4. Click on your operating system to begin the download]]<br />
[[File:Install.PNG|center|thumb|700px|5. Install it]]<br />
<br />
<br />
Then what? It installed programs that don't run.<br />
They just say "The procedure entry point GetSystemTimePreciseAsFileTime could not be located in the dynamic link library KERNEL32.dll".<br />
<br />
==Installing on Ubuntu/Debian==<br />
<br />
Users of Ubuntu, Debian, and other similar packaging distributions of<br />
Linux will need to ensure that a few essentials are in place before<br />
you will be able to compile BRL-CAD.<br />
<br />
Before following the build instructions. You need:<br />
* <code>gcc (6+, e.g. 6.0.3)</code><br />
<br />
* <code>g++ (6+, e.g. 6.0.3)</code><br />
<br />
* <code>make (e.g. gnu make 3.8.0)</code><br />
<br />
* <code>cmake (3.0.2 or newer)</code><br />
<br />
All three of the above have implicit dependencies on other packages.<br />
* You will also want to make sure that you have the X11 development headers installed:<br />
:<code>apt-get install xserver-xorg-dev libx11-dev libxi-dev libxext-dev</code><br />
<br />
* Other development packages needed to build on Debian-based platforms:<br />
** For building the ''Tcl/Tk'' libraries: <code>libfontconfig-dev</code> <br /><br /><br />
** For ''OpenGL'': <code>libglu1-mesa-dev</code><br />
<br />
=Modeling=<br />
<br />
Now you can start modeling!<br />
<br />
First, you need to search for mged in your computer’s finder or on the start menu and open the program. Once you have opened up MGED you see that there is a terminal with a white background and a graphical window with a black background.<br />
<br />
[[File:Editor Windows.png|center|700px]]<br />
<br />
Once you see that you can almost begin to model, but first you need to create the file, or database that you are editing. In order to do that you need to go to the graphical layout then click File>New<br />
<br />
[[File:FileNew.PNG|center|thumb|700px]]<br />
<br />
and type in the file name and select the file that will be saved, then click save. After that, you will be prompted if you want to make the database, click yes and now you can start modeling! The first shape that I made was a sphere, but there are many other types of primitive shapes http://brlcad.org/gallery/diagrams/primitives. Type in the console (make sphere1 sph) and then if you look in the graphical window you will see a very crude sphere.<br />
<br />
[[File:Sphere.PNG|center|700px]]<br />
<br />
Then if you want to make a cube type in (make cube1 arb8) and you will have your very own cube.<br />
<br />
[[File:Cube.PNG|center|700px]]<br />
<br />
Then you can type in the names of other shapes and you will see that they make the object that you type in. After making part of your model, you decide that you don’t like the cube floating in space so you want to delete it. All you have to do is type in erase cube1 then it will erase itself from the graphical layout, but it is not completely gone, if you want it back all you have to do is type in draw cube1 and you will have your cube back.<br />
Only if you need the shape gone for good and will never use it again for any reason in that model, type in kill cube1 and it will be gone for good. After finishing, type in rt in the console, and you will see your model rendered and showing you how it would look with faces and lighting instead of a wireframe.<br />
<br />
[[File:RT.PNG|center|700px]]<br />
<br />
If you don’t know how to do a certain thing then just type in help.<br />
and all of the commands will be listed with a description of what they do and how you use them.<br />
<br />
[[File:TutHelp.PNG|center|700px]]<br />
<br />
Thank you for reading, and good modeling!<br />
<br />
<br />
<br />
=Where to go from here=<br />
<br />
brlcad-7.26.4/doc/docbook/README:<br />
"...<br />
This directory holds the DocBook (DB) documentation for BRL-CAD. Over<br />
time, this should become the repository for all tutorials, man pages,<br />
and other non-autogenerated, formatted documentation for BRL-CAD.<br />
...<br />
The current structure is as follows:<br />
articles/ ...<br />
books/ ...<br />
lessons/ ...<br />
resources/ ...<br />
system/ ...<br />
presentations/ ...<br />
..."<br />
<br />
Unfortunately, as for now, only [[Documentation|parts of this Documentation]] are available online and only in pdf.<br />
To acquire these documents you will most likely need to install BRL-CAD, and if you are lucky, they<br />
were installed as well during the installation. The location may vary from System to System.</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Tutorial/Newbie&diff=11932Tutorial/Newbie2021-06-21T18:10:29Z<p>Vikram Atreya: /* Installing on Ubuntu/Debian */</p>
<hr />
<div>BRL-CAD for Newbies<br />
<br />
By: Cameron Wolfe, wiki-brlcad, and others<br />
<br />
BRL-CAD is a computer-aided design (CAD) software. It allows you to design houses if you are an architect, design robotics part, or just draw and model things you find in the world.<br />
<br />
<br />
<br />
=Installation=<br />
<br />
In order to take advantage of this tool, you need to download and install it on your computer.<br />
<br />
<br />
<br />
==Installing on Windows==<br />
<br />
[[File:BRL-CAD homepage.PNG|center|thumb|700px|1. Go to http://brlcad.org/]]<br />
[[File:Download.PNG|center|thumb|700px|2. Click Download]]<br />
[[File:DownloadPage.PNG|center|thumb|700px|3. You will find yourself on the download page.]]<br />
[[File:DownloadIt.PNG|center|thumb|700px|4. Click on your operating system to begin the download]]<br />
[[File:Install.PNG|center|thumb|700px|5. Install it]]<br />
<br />
<br />
Then what? It installed programs that don't run.<br />
They just say "The procedure entry point GetSystemTimePreciseAsFileTime could not be located in the dynamic link library KERNEL32.dll".<br />
<br />
==Installing on Ubuntu/Debian==<br />
<br />
Users of Ubuntu, Debian, and other similar packaging distributions of<br />
Linux will need to ensure that a few essentials are in place before<br />
you will be able to compile BRL-CAD.<br />
<br />
Before following the build instructions. You need:<br />
* <code>gcc (6+, e.g. 6.0.3)</code><br />
<br />
* <code>g++ (6+, e.g. 6.0.3)</code><br />
<br />
* <code>make (e.g. gnu make 3.8.0)</code><br />
<br />
* <code>cmake (3.0.2 or newer)</code><br />
<br />
All three of the above have implicit dependencies on other packages.<br />
* You will also want to make sure that you have the X11 development headers installed:<br />
:<code>apt-get install xserver-xorg-dev libx11-dev libxi-dev libxext-dev</code><br />
<br />
* Other development packages needed to build on Debian-based platforms:<br />
** For building the ''Tcl/Tk'' libraries: <code>libfontconfig-dev</code><br />
** For ''OpenGL'': <code>libglu1-mesa-dev</code><br />
<br />
=Modeling=<br />
<br />
Now you can start modeling!<br />
<br />
First, you need to search for mged in your computer’s finder or on the start menu and open the program. Once you have opened up MGED you see that there is a terminal with a white background and a graphical window with a black background.<br />
<br />
[[File:Editor Windows.png|center|700px]]<br />
<br />
Once you see that you can almost begin to model, but first you need to create the file, or database that you are editing. In order to do that you need to go to the graphical layout then click File>New<br />
<br />
[[File:FileNew.PNG|center|thumb|700px]]<br />
<br />
and type in the file name and select the file that will be saved, then click save. After that, you will be prompted if you want to make the database, click yes and now you can start modeling! The first shape that I made was a sphere, but there are many other types of primitive shapes http://brlcad.org/gallery/diagrams/primitives. Type in the console (make sphere1 sph) and then if you look in the graphical window you will see a very crude sphere.<br />
<br />
[[File:Sphere.PNG|center|700px]]<br />
<br />
Then if you want to make a cube type in (make cube1 arb8) and you will have your very own cube.<br />
<br />
[[File:Cube.PNG|center|700px]]<br />
<br />
Then you can type in the names of other shapes and you will see that they make the object that you type in. After making part of your model, you decide that you don’t like the cube floating in space so you want to delete it. All you have to do is type in erase cube1 then it will erase itself from the graphical layout, but it is not completely gone, if you want it back all you have to do is type in draw cube1 and you will have your cube back.<br />
Only if you need the shape gone for good and will never use it again for any reason in that model, type in kill cube1 and it will be gone for good. After finishing, type in rt in the console, and you will see your model rendered and showing you how it would look with faces and lighting instead of a wireframe.<br />
<br />
[[File:RT.PNG|center|700px]]<br />
<br />
If you don’t know how to do a certain thing then just type in help.<br />
and all of the commands will be listed with a description of what they do and how you use them.<br />
<br />
[[File:TutHelp.PNG|center|700px]]<br />
<br />
Thank you for reading, and good modeling!<br />
<br />
<br />
<br />
=Where to go from here=<br />
<br />
brlcad-7.26.4/doc/docbook/README:<br />
"...<br />
This directory holds the DocBook (DB) documentation for BRL-CAD. Over<br />
time, this should become the repository for all tutorials, man pages,<br />
and other non-autogenerated, formatted documentation for BRL-CAD.<br />
...<br />
The current structure is as follows:<br />
articles/ ...<br />
books/ ...<br />
lessons/ ...<br />
resources/ ...<br />
system/ ...<br />
presentations/ ...<br />
..."<br />
<br />
Unfortunately, as for now, only [[Documentation|parts of this Documentation]] are available online and only in pdf.<br />
To acquire these documents you will most likely need to install BRL-CAD, and if you are lucky, they<br />
were installed as well during the installation. The location may vary from System to System.</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Tutorial/Newbie&diff=11931Tutorial/Newbie2021-06-21T18:09:34Z<p>Vikram Atreya: /* Installing on Ubuntu/Debian */</p>
<hr />
<div>BRL-CAD for Newbies<br />
<br />
By: Cameron Wolfe, wiki-brlcad, and others<br />
<br />
BRL-CAD is a computer-aided design (CAD) software. It allows you to design houses if you are an architect, design robotics part, or just draw and model things you find in the world.<br />
<br />
<br />
<br />
=Installation=<br />
<br />
In order to take advantage of this tool, you need to download and install it on your computer.<br />
<br />
<br />
<br />
==Installing on Windows==<br />
<br />
[[File:BRL-CAD homepage.PNG|center|thumb|700px|1. Go to http://brlcad.org/]]<br />
[[File:Download.PNG|center|thumb|700px|2. Click Download]]<br />
[[File:DownloadPage.PNG|center|thumb|700px|3. You will find yourself on the download page.]]<br />
[[File:DownloadIt.PNG|center|thumb|700px|4. Click on your operating system to begin the download]]<br />
[[File:Install.PNG|center|thumb|700px|5. Install it]]<br />
<br />
<br />
Then what? It installed programs that don't run.<br />
They just say "The procedure entry point GetSystemTimePreciseAsFileTime could not be located in the dynamic link library KERNEL32.dll".<br />
<br />
==Installing on Ubuntu/Debian==<br />
<br />
Users of Ubuntu, Debian, and other similar packaging distributions of<br />
Linux will need to ensure that a few essentials are in place before<br />
you will be able to compile BRL-CAD.<br />
<br />
Before following the build instructions. You need:<br />
* <code>gcc (6+, e.g. 6.0.3)</code><br />
<br />
* <code>g++ (6+, e.g. 6.0.3)</code><br />
<br />
* <code>make (e.g. gnu make 3.8.0)</code><br />
<br />
* <code>cmake (3.0.2 or newer)</code><br />
<br />
All three of the above have implicit dependencies on other packages.<br />
* You will also want to make sure that you have the X11 development headers installed:<br />
:<code>apt-get install xserver-xorg-dev libx11-dev libxi-dev libxext-dev</code><br />
<br />
* Other development packages needed to build on Debian-based platforms:<br />
** For building the ''Tcl/Tk'' libraries: <code>libfontconfig-dev</code><br />
<br />
* For ''OpenGL'': <code>libglu1-mesa-dev</code><br />
<br />
=Modeling=<br />
<br />
Now you can start modeling!<br />
<br />
First, you need to search for mged in your computer’s finder or on the start menu and open the program. Once you have opened up MGED you see that there is a terminal with a white background and a graphical window with a black background.<br />
<br />
[[File:Editor Windows.png|center|700px]]<br />
<br />
Once you see that you can almost begin to model, but first you need to create the file, or database that you are editing. In order to do that you need to go to the graphical layout then click File>New<br />
<br />
[[File:FileNew.PNG|center|thumb|700px]]<br />
<br />
and type in the file name and select the file that will be saved, then click save. After that, you will be prompted if you want to make the database, click yes and now you can start modeling! The first shape that I made was a sphere, but there are many other types of primitive shapes http://brlcad.org/gallery/diagrams/primitives. Type in the console (make sphere1 sph) and then if you look in the graphical window you will see a very crude sphere.<br />
<br />
[[File:Sphere.PNG|center|700px]]<br />
<br />
Then if you want to make a cube type in (make cube1 arb8) and you will have your very own cube.<br />
<br />
[[File:Cube.PNG|center|700px]]<br />
<br />
Then you can type in the names of other shapes and you will see that they make the object that you type in. After making part of your model, you decide that you don’t like the cube floating in space so you want to delete it. All you have to do is type in erase cube1 then it will erase itself from the graphical layout, but it is not completely gone, if you want it back all you have to do is type in draw cube1 and you will have your cube back.<br />
Only if you need the shape gone for good and will never use it again for any reason in that model, type in kill cube1 and it will be gone for good. After finishing, type in rt in the console, and you will see your model rendered and showing you how it would look with faces and lighting instead of a wireframe.<br />
<br />
[[File:RT.PNG|center|700px]]<br />
<br />
If you don’t know how to do a certain thing then just type in help.<br />
and all of the commands will be listed with a description of what they do and how you use them.<br />
<br />
[[File:TutHelp.PNG|center|700px]]<br />
<br />
Thank you for reading, and good modeling!<br />
<br />
<br />
<br />
=Where to go from here=<br />
<br />
brlcad-7.26.4/doc/docbook/README:<br />
"...<br />
This directory holds the DocBook (DB) documentation for BRL-CAD. Over<br />
time, this should become the repository for all tutorials, man pages,<br />
and other non-autogenerated, formatted documentation for BRL-CAD.<br />
...<br />
The current structure is as follows:<br />
articles/ ...<br />
books/ ...<br />
lessons/ ...<br />
resources/ ...<br />
system/ ...<br />
presentations/ ...<br />
..."<br />
<br />
Unfortunately, as for now, only [[Documentation|parts of this Documentation]] are available online and only in pdf.<br />
To acquire these documents you will most likely need to install BRL-CAD, and if you are lucky, they<br />
were installed as well during the installation. The location may vary from System to System.</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11924User:Vikram Atreya/GSoC21/Log2021-06-18T18:24:42Z<p>Vikram Atreya: Week 2- day 3&4 update</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here<br />
** Day 3-4<br />
*** Refined code of g cmd undo and updated PR<br />
*** Attempt at reefactoring code to libged/undo.cpp failed; Not right place to put the code<br />
*** Refactored make's undo code into mged/utility1.c and replaced code in make, in and g<br />
*** Solved major bug that made children objects disappear when any object was killed<br />
*** logic: renamed all leaves by adding sufffix, thereby poiting to imaginary objects and not hiding the references it had previously</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11922User:Vikram Atreya/GSoC21/Log2021-06-15T21:15:25Z<p>Vikram Atreya: Week 2- day 1&2 update</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall<br />
*** Did tutorials to understand how combinations and regions work<br />
*** Went in the wrong direction intially; Took a day to understand how combinations are stored <br />
* Week - 2<br />
** Day 1-2 <br />
*** Encountered many bugs while implementing undo for killall<br />
*** Ubuntu had some problems; mouse and keyboard stopped working and stopped work for sometime<br />
*** Tired refactoring code of backup storage for make; Chose to make a gmd_cmd for it but did not happen, also felt it was not the best option<br />
*** Succesfully implemented undo for kill by modifying code in libged/killrefs; Might have to write a new wrapper for this<br />
*** Created new wrapper for g (group) command and implemeted undo for it; Some refinement left here</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11915User:Vikram Atreya/GSoC21/Log2021-06-12T03:51:02Z<p>Vikram Atreya: Daily update for day5</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2 <br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo<br />
** Day 5-6<br />
*** Enabled undo for in command; Now working to enable undo for killall</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11908User:Vikram Atreya/GSoC21/Log2021-06-10T20:39:27Z<p>Vikram Atreya: /* Weekly update - Coding Period */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2<br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c<br />
*** Converted undo.c to undo.cpp so that code can be more functional<br />
** Day 3-4<br />
*** Had a discussion with my mentor how to proceed further on the undo<br />
*** Data accesible over all processes stored in _GLOBAL as name, value pairs<br />
*** Name of the last added object and last killed object stored in _GLOBAL<br />
*** Wrappers of make and kill modified to add the labels<br />
*** Introduced 3 variables in undo.cpp to keep track of latest_change and then take necessary action to undo</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11907User:Vikram Atreya/GSoC21/Log2021-06-08T21:27:51Z<p>Vikram Atreya: /* Weekly update - Coding Period */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2<br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function<br />
*** Finally found way to iterate over all objects from move_all.c</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11906User:Vikram Atreya/GSoC21/Log2021-06-08T21:19:29Z<p>Vikram Atreya: /* Weekly update - Coding Period */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2<br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects<br />
*** Stuck, trying to iterate over all objects in database but not finding the right function</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project&diff=11905User:Vikram Atreya/GSoC21/Project2021-06-08T17:40:54Z<p>Vikram Atreya: Updated design and implementation details</p>
<hr />
<div>=='''Implementing UNDO command'''==<br />
<br />
===Community Bonding===<br />
*Set up the blog and wiki<br />
*Decide on which approach to implement UNDO<br />
<br />
<br />
===Development Plan===<br />
*Week 1: Decide architecture and create the required files to have an undo cmd<br />
**Add files to libged, make changes in Cmake files and decide on space/location to store the temporary data being generated. Write documentation on how the undo command is going to be implemented and how it will work. <br />
*Week 2: Start implementing the UNDO logic<br />
**Check for different commands like kill, make and other basic commands for proper compatibility with the UNDO command. <br />
*Week 3: Continue the implementation<br />
**Start working and testing for complicated commands like dbconcat which deal with overwriting, creating new objects and deleting multiple objects. In the partial + events method this might take more time as splitting commands into events is a big task. <br />
*Week 4: Get a basic review and start testing<br />
**Take inputs from my mentor on current progress and how I could improve the code. Write tests for various cases and check robustness.<br />
*Week 5: Continue testing and optimizing code<br />
*Week 6: Work on further optimizations / Account for unforeseen delays<br />
**I will keep this week as a buffer.<br />
*Week 7: Optimizations to UNDO<br />
**Depending on the method chosen, work on improving the time/space complexity of the implementation.<br />
*Week 8: Document work and issues faced<br />
*Week 9: Prepare for final evaluations<br />
<br />
<br />
===Design ideas===<br />
* Facilitate 10-15 undos from the latest state<br />
* Initially no redo command and later states are deleted once undo is used<br />
* Works only on objects and not on other data stored<br />
* Plain undo with no flags does just 1 undo<br />
* ``` -n X``` flag does multiple undos, where X is no of undos to be done<br />
<br />
<br />
===Implementation ideas===<br />
* Full checkpoint is stored before 15 commands.<br />
* Form an array with values as names of all non-hidden objects, search for backups in hidden objects (backup should have a version just previous to the no of undos requested). After iterating through all backup objects if we do not find a backup, ,which should ideally be found in the full checkpoint even if it was not backed up later, we killthat object.<br />
* Undo can also be considered to be a normal command and full checpoint can be created before undoing, so that redo will be done with an undo.</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11904User:Vikram Atreya/GSoC21/Log2021-06-08T17:32:58Z<p>Vikram Atreya: </p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2<br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively<br />
*** Understood how hidden objects work, have to explore temporary file alternative to save backup objects</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11903User:Vikram Atreya/GSoC21/Log2021-06-08T17:26:16Z<p>Vikram Atreya: /* Weekly update - Coding Period */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Day 1-2<br />
*** Working version of undo command implemented in mged which prints name of database when command is given.<br />
*** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()<br />
*** Set flags -n and -h aimed to execute multiple undos and show usage respectively</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11901User:Vikram Atreya/GSoC21/Log2021-06-07T17:46:20Z<p>Vikram Atreya: /* Day 1 update */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** Working version of undo command implemented in mged which prints name of database when command is given.<br />
** Understood how commands use wrapper functions and function of cmd_ged_plain_wrapper()</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11900User:Vikram Atreya/GSoC21/Log2021-06-07T17:44:10Z<p>Vikram Atreya: /* Community Bonding Period */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
* Ideated various ways to implement undo and set constraints<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** .</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project&diff=11888User:Vikram Atreya/GSoC21/Project2021-05-21T06:38:59Z<p>Vikram Atreya: Updated project plan</p>
<hr />
<div>=='''Implementing UNDO command'''==<br />
<br />
===Community Bonding===<br />
*Set up the blog and wiki<br />
*Decide on which approach to implement UNDO<br />
<br />
===Development Plan===<br />
*Week 1: Decide architecture and create the required files to have an undo cmd<br />
**Add files to libged, make changes in Cmake files and decide on space/location to store the temporary data being generated. Write documentation on how the undo command is going to be implemented and how it will work. <br />
*Week 2: Start implementing the UNDO logic<br />
**Check for different commands like kill, make and other basic commands for proper compatibility with the UNDO command. <br />
*Week 3: Continue the implementation<br />
**Start working and testing for complicated commands like dbconcat which deal with overwriting, creating new objects and deleting multiple objects. In the partial + events method this might take more time as splitting commands into events is a big task. <br />
*Week 4: Get a basic review and start testing<br />
**Take inputs from my mentor on current progress and how I could improve the code. Write tests for various cases and check robustness.<br />
*Week 5: Continue testing and optimizing code<br />
*Week 6: Work on further optimizations / Account for unforeseen delays<br />
**I will keep this week as a buffer.<br />
*Week 7: Optimizations to UNDO<br />
**Depending on the method chosen, work on improving the time/space complexity of the implementation.<br />
*Week 8: Document work and issues faced<br />
*Week 9: Prepare for final evaluations</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11867User:Vikram Atreya/GSoC21/Log2021-05-19T16:44:38Z<p>Vikram Atreya: /* Dev logs */</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Forked github repo and compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** .</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Log&diff=11866User:Vikram Atreya/GSoC21/Log2021-05-19T16:43:51Z<p>Vikram Atreya: Created page with "= Development Logs = == Community Bonding Period == * Compiled working version of BRL-CAD * Made the pages for project plan and dev logs == Weekly update - Coding Period ==..."</p>
<hr />
<div>= Development Logs =<br />
<br />
== Community Bonding Period ==<br />
* Compiled working version of BRL-CAD <br />
* Made the pages for project plan and dev logs<br />
<br />
== Weekly update - Coding Period ==<br />
* Week - 1<br />
** .</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project&diff=11865User:Vikram Atreya/GSoC21/Project2021-05-19T16:40:06Z<p>Vikram Atreya: /* Community Bonding */</p>
<hr />
<div>=='''Implementing UNDO command'''==<br />
<br />
===Community Bonding===<br />
*Set up the blog and wiki<br />
*Decide on which approach to implement UNDO<br />
<br />
===Development Plan===</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project&diff=11864User:Vikram Atreya/GSoC21/Project2021-05-19T16:39:42Z<p>Vikram Atreya: /* Community Bonding */</p>
<hr />
<div>=='''Implementing UNDO command'''==<br />
<br />
===Community Bonding===<br />
Set up the blog and wiki<br />
Decide on which approach to implement UNDO<br />
<br />
===Development Plan===</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project&diff=11863User:Vikram Atreya/GSoC21/Project2021-05-19T16:19:54Z<p>Vikram Atreya: /* implementing UNDO command */</p>
<hr />
<div>=='''Implementing UNDO command'''==<br />
<br />
===Community Bonding===<br />
*Week 1 (17 May - 24 May): <br />
Setting up the blog and wiki <br />
<br />
===Development Plan===</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya/GSoC21/Project&diff=11862User:Vikram Atreya/GSoC21/Project2021-05-19T16:19:43Z<p>Vikram Atreya: Created page with "=='''implementing UNDO command'''== ===Community Bonding=== *Week 1 (17 May - 24 May): Setting up the blog and wiki ===Development Plan==="</p>
<hr />
<div>=='''implementing UNDO command'''==<br />
<br />
===Community Bonding===<br />
*Week 1 (17 May - 24 May): <br />
Setting up the blog and wiki <br />
<br />
===Development Plan===</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=User:Vikram_Atreya&diff=11861User:Vikram Atreya2021-05-18T20:44:42Z<p>Vikram Atreya: Created page with "= Personal Information = *'''Student Name:''' Vikram Atreyapurapu *'''GSoC Project:''' Implementing UNDO in libged *'''Timezone:''' UTC+05:30 *'''Zulip Nick:''' Vikram Atreya..."</p>
<hr />
<div>= Personal Information =<br />
*'''Student Name:''' Vikram Atreyapurapu<br />
*'''GSoC Project:''' Implementing UNDO in libged<br />
*'''Timezone:''' UTC+05:30<br />
*'''Zulip Nick:''' Vikram Atreya<br />
*'''Email:''' vikram.atreya@gmail.com</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Deuces&diff=11798Deuces2020-10-24T17:45:34Z<p>Vikram Atreya: Removed extra line</p>
<hr />
<div>This is a list of succinct tasks that are expected to take most people familiar with the prerequisites less than two hours to complete. It's a great starting point for anyone interested in contributing to BRL-CAD.<br />
<br />
The tasks are all roughly the same complexity with '''''no prior BRL-CAD experience expected'''''. A description is provided along with a list of references and files you'll probably need to edit. Can we make it any easier?<br />
<br />
= Getting Started =<br />
<br />
Contact us (via [[IRC]] or [[Mailing_Lists|brlcad-devel mailing list]]) if you have questions, comments, or ideas of your own you'd like to suggest.<br />
<br />
We've made an awesome virtual disk image that has everything you need preconfigured and ready to go:<br />
<br />
# [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/ Download our BRL-CAD Virtual Machine (VM) disk image.]<br />
# [https://www.virtualbox.org/wiki/Downloads Install VirtualBox.]<br />
# Import and start the VM, log in (the password is "Brlcad!" without the quotes).<br />
# Run "svn up brlcad-svn-trunk" and get started!<br />
<br />
=Pick a Task=<br />
<br />
We break down all tasks into one of five categories. Don't be worried if the tasks all sound confusing to you. Just pick one and start reading the references we've provided. Join IRC or our mailing list and ask questions.<br />
<br />
# Code (programming)<br />
# Documentation and Training (writing)<br />
# Outreach and Research (graphics)<br />
# Quality Assurance (testing)<br />
# User Interface (designing)<br />
<br />
__TOC__<br />
<br />
----<br />
<br />
== Code ==<br />
----<br />
''Tasks related to writing or refactoring code''<br />
<br />
See the When You're Done section above for details on submitting your changes.<br />
<br />
&nbsp;<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Close MGED when both windows are closed ===<br />
<br />
BRL-CAD has an interactive geometry editor called MGED. It's often the starting point for beginners and allows creation and manipulation of models using commands. When ''mged'' is run, it creates 2 windows: a text-console command window and an interactive graphics window. When the user closes one of those windows, there is a bug. Closing the graphics window closes the command window.<br />
<br />
This task involves fixing this behavior so that ONLY closing ''both'' windows terminates the process properly and that closing either window does not take the other along with it.<br />
<br />
Code:<br />
* src/mged/mged.c<br />
* src/tclscripts/mged/openw.tcl<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive centroid function ===<br />
<br />
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. 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.<br />
<br />
This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point). There are numerous examples in our code where we compute centroids for other primitives. The primitives that do not already have a centroid callback are itemized in following.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/Centroid<br />
* http://mathworld.wolfram.com/<br />
* include/raytrace.h: See ft_centroid callback defined in the rt_functab structure<br />
<br />
Code:<br />
* src/librt/primitives/table.c<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive curvature function ===<br />
<br />
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.<br />
<br />
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;<br />
* superell<br />
* cline<br />
* extrude<br />
* grip<br />
* metaball<br />
* hrt. <br />
There are numerous examples in our code where we compute the curvature for other primitives like the ellipsoid, sphere, elliptical parabola, etc.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/Curvature<br />
* http://en.wikipedia.org/wiki/Radius_of_curvature_(mathematics)<br />
* http://mathworld.wolfram.com/<br />
* 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).<br />
<br />
Code:<br />
* src/librt/primitives/table.c<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive UV-mapping callback ===<br />
<br />
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping. An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid. Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior.<br />
<br />
This task involves implementing a UV-mapping callback for any of the primitives that do not already have a functional UV-callback defined. Note that this is an advanced task that might take you more than a couple hours if you don't have solid coding skills, but it's ultimately just a few lines of code. See other primitives that already implement a UV-mapping callback for reference.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/UV_mapping<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c, read the rt_*_uv() function<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... UV-mapping for extruded sketches (EXTRUDE) ====<br />
<br />
Code:<br />
* src/librt/primitives/extrude/extrude.c<br />
* src/librt/primitives/table.c<br />
* include/rtgeom.h<br />
<br />
|}<br />
&nbsp;<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Implement a platform independent re-entrant sort function ===<br />
<br />
The classic C library qsort() does not support a context parameter. A work around is to store the context information in a static variable. However, this solution is not thread save and may result in unpredictable behavior.<br />
<br />
There are platform specific sort functions qsort_r() in incompatible versions for BSD and GNU and qsort_s() for MSVC. Your task is to implement a bu_sort() function for BRL-CAD which is platform independent.<br />
<br />
Code:<br />
* src/libbu/sort.c<br />
<br />
The new sort function could look like this:<br />
void bu_sort(genptr_t array, size_t nummemb, size_t sizememb, int (*compare)(const_genptr_t, const_genptr_t, genptr_t), genptr_t context);<br />
|}<br />
&nbsp;<br />
<br />
----<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Solve fonts related bug in new wiki theme ===<br />
<br />
BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme uses a font called 'open-sans' from google fonts directory. It's linked via CSS but it does not get loaded (we still see default serif all over the place). So your task will be to debug the CSS code and get Open Sans loaded. <br />
<br />
Links:<br />
*http://beta.brlcad.org/wiki/Main_Page<br />
<br />
&nbsp;<br />
<br />
----<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Better placement of icons in wiki theme ===<br />
<br />
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.<br />
<br />
Links:<br />
*http://beta.brlcad.org/wiki/Main_Page<br />
<br />
&nbsp;<br />
<br />
----<br />
|}<br />
<br />
== Documentation and Training ==<br />
----<br />
''Tasks related to creating/editing documents and helping others learn more about BRL-CAD''<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Add missing documentation (for any ONE command) ===<br />
<br />
BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented:<br />
<br />
a-d archer asc2g asc2pix bot-bldxf bottest brep_cube brep_simple brickwall btclsh burst bw-a bw-d bwish c-d chan_add clutter contours d-a damdf dauto dauto2 d-bw dconv ddisp d-f dfft d-i dmod double-asc dpeak dsel dsp_add dstat d-u dwin euclid_format euclid_unformat fbgammamod f-d fence fhor f-i g-adrt g-euclid1 g-jack globe g-off i-a i-d i-f ihist imod istat jack-g kurt lowp molecule nmgmodel nmg-sgp off-g pipe pipetest pix2g pix3filter pixcount pixelswap pixembed pixfields pixfieldsep pixflip-fb pixpaste pix-spm pix-yuv plstat pyramid rawbot remapid rlesortmap rletovcr room rtcell rtexample rtfrac rtrad rtsil rtsrv script-tab sketch solshoot sphflake spltest spm-fb ssampview syn tea tea_nmg testfree texturescale torii ttcp tube txyz-pl u-a u-bw u-d u-f umod ustat vcrtorle vegitation wall wdb_example xbmtorle xyz-pl yuv-pix<br />
<br />
This task involves writing basic documentation for '''JUST ONE''' of those commands in the Docbook XML format. The command documentation should provide a one-sentence description, a detailed paragraph description (200+ words), explanation of '''all''' available command-line options, and one or more examples on how to use the command. <br />
<br />
Code:<br />
* doc/docbook/system/man1/en/Makefile.am<br />
* doc/docbook/system/man1/en/*.xml<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write an article "BRL-CAD for dummies" ===<br />
<br />
Although BRL-CAD has extensive documentation, still it needs a short and simple document which is particularly built for dummies.<br />
<br />
This task involves writing a article named '''BRL-CAD for dummies'''. This article should start with the installation process, if there is any existing installation guide for dummies, provide a link to it. The main motive of this article to empower dummy to make his/her first model using BRL-CAD. One thing to be kept in mind while writing this article is that this article is mainly concentrated for dummies. So use simple language to an extent and if you need to mention some technical term, first explain that term.<br />
<br />
The output of this task can be a pdf, html, doc, odt or any other document file that contains this article. Go through the link provided. Use screenshots and images to make it look attractive so that the reader is not bored.<br />
<br />
Reference:<br />
* http://brlcad.org/wiki/Documentation<br />
<br />
|}<br />
<br />
&nbsp;<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Translate "Contributors Guide To BRL-CAD" To Any Language ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
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<br />
<br />
* Feature Overview<br />
* Working with our Code<br />
* What code to work on<br />
* How to contribute<br />
* .... (Just to name a few )<br />
<br />
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.<br />
<br />
Reference:<br />
* http://en.flossmanuals.net/_booki/contributors-guide-to-brl-cad/contributors-guide-to-brl-cad.pdf<br />
<br />
|}<br />
<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Write a "BRL-CAD Commands Quick Reference" document ===<br />
<br />
There is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands.<br />
<br />
This task involves writing a quick reference document similar to [http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf the MGED quick reference] but for BRL-CAD commands. The sheet should minimally include the following commands:<br />
<br />
mged, rt*, *-g, g-*, fb*, *fb, nirt, remrt, rtsrv, asc2g, g2asc, dbupgrade, pix*, *pix, *-*, brlman, benchmark<br />
<br />
References:<br />
* http://brlcad.org/wiki/Documentation<br />
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf<br />
* [http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png git example]<br />
* [http://www.stdout.org/~winston/latex/latexsheet-0.png latex example]<br />
* [http://img.docstoccdn.com/thumb/orig/524314.png another example]<br />
* [http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png drupal example]<br />
* [http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg php example]<br />
<br />
|}<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Doxygen cleanup ===<br />
<br />
BRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output.<br />
<br />
This task involves cleaning up the Doxygen comments in the library so that useful reports and API documentation automatically generated (correctly, completely, and cleanly). Verify/fix any Doxygen syntax. Verify/fix groups so that functions are organized neatly and all contained within a group. Provide patches that give clean (PDF) output from Doxygen.<br />
<br />
References:<br />
* http://www.jiggerjuice.net/software/doxygen.html<br />
* http://www.stack.nl/~dimitri/doxygen/starting.html<br />
* http://www.stack.nl/~dimitri/doxygen/<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBBU ====<br />
<br />
There are approximately 300 documented API function calls in LIBBU.<br />
<br />
Code:<br />
* include/bu.h<br />
* src/libbu<br />
* misc/Doxyfile<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBWDB ====<br />
<br />
There are approximately 100 documented API function calls in LIBWDB. <br />
<br />
Code:<br />
* include/wdb.h<br />
* include/raytrace.h<br />
* src/libwdb<br />
* misc/Doxyfile<br />
<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBRT ====<br />
<br />
There are approximately 1000 documented API function calls in LIBRT. <br />
<br />
Code:<br />
* include/raytrace.h<br />
* src/librt<br />
* src/librt/primitives<br />
* src/librt/comb<br />
* src/librt/binunif<br />
* misc/Doxyfile<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write up Wiki page tutorial on our Volumetric Primitive ===<br />
<br />
BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.<br />
<br />
This task involves writing up a page on the VOL primitive. Figure out how to use it (see the "in" command), create an example input data set, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:<br />
<br />
References:<br />
* http://brlcad.org/wiki/DSP<br />
* http://brlcad.org/wiki/Sketch<br />
* http://brlcad.org/wiki/EBM <-- particularly useful as the data is similar for VOL<br />
<br />
Show how to create a VOL with at least two layers/slices. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/VOL<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write a wiki tutorial on how to create a polygonal mesh (NMG) manually ===<br />
<br />
BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.<br />
<br />
This task involves writing up a page on the NMG polygonal mesh primitive. Figure out how to use it (not a simple task, will require some trial and error), create an example input, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:<br />
<br />
References:<br />
* http://brlcad.org/wiki/DSP<br />
* http://brlcad.org/wiki/EBM<br />
* http://brlcad.org/wiki/Sketch <-- particularly useful as neither NMG nor sketch are meant to be created manually<br />
<br />
Note the "facetize" command in mged will convert an existing object into NMG format. The get/put commands should help from there like the sketch tutorial.<br />
<br />
Show how to create an NMG cube or wedge or similar simple shape. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/NMG<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents) ===<br />
<br />
The majority of BRL-CAD's documentation is defined as DocBook files, from which other formats (HTML, PDF, man page, etc.) can be generated. PDF files present a particular challenge, and have some very specific requirements to achieve "good" formatting.<br />
<br />
BRL-CAD's DocBook files need to uniformly use a style of image inclusion that is aware of what "role" the image is supposed to serve. A "basic" image inclusion example looks like this:<br />
<br />
<mediaobject><br />
<imageobject><br />
<imagedata align="center" fileref="../../lessons/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<nowiki><caption></nowiki><br />
<para><br />
Caption goes here.<br />
</para><br />
</caption><br />
</mediaobject><br />
<br />
This task involves switching image inclusions that use the above style to something like the following:<br />
<br />
<mediaobject><br />
<imageobject role="html"><br />
<imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<imageobject role="fo"><br />
<imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<nowiki><caption></nowiki><br />
<para><br />
Caption goes here.<br />
</para><br />
</caption><br />
</mediaobject><br />
<br />
The "role" flag to imageobject provides the opportunity to specify different image formatting options when the output is HTML (role="html") or PDF (role="fo").<br />
<br />
The captions should be preserved as above on mediaobjects that have them, but mediaobjects without a caption should also be converted and there is no need to add a caption in such cases.<br />
<br />
Any patch that makes changes to the DocBook sources should result in a successful "make doc" build test. This won't generate PDF documents, but it will validate the XML files and produce HTML - remember that introducing breakage means the patch won't be accepted.<br />
<br />
Remember, the tasks are simply to do the above conversion for all images in the file or files, not to introduce PDF specific formatting. Formatting fixes will be needed, but they are very much "case by case" and will take both additional time and a working Apache FOP installation, as well as knowledge of how to enable PDF generation. If all image inclusions have been converted successfully and a student is interested in actually fixing the formatting, please discuss it with us on IRC or the mailing list.<br />
<br />
References:<br />
* doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml<br />
<br />
Code:<br />
* doc/docbook<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Make a step by step tutorial for creating BRL-CAD model ===<br />
<br />
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. <br />
<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Find 5 bugs in OGV ===<br />
<br />
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. <br />
<br />
Links:<br />
https://github.com/BRL-CAD/OGV-meteor/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Find 5 coding guidelines violations in OGV ===<br />
<br />
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. <br />
<br />
Links:<br />
https://github.com/BRL-CAD/OGV-meteor/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
----<br />
<br />
==Outreach and Research ==<br />
----<br />
''Tasks related to community management, outreach/marketing, studying problems, and recommending solutions''<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Profile NURBS prep performance ===<br />
<br />
BRL-CAD implements support for rendering of NURBS representation geometry. If you import a solid 3DM or STEP format model into BRL-CAD, it will import as BREP/NURBS geometry. Opening that geometry in BRL-CAD's MGED editor will tell you what objects are available and our 'rt' tool will raytrace it. When geometry is ray traced, it first goes through a "prep" phase and then it starts shooting rays. Our prep phase is entirely unoptimized so we'd like to know where all the time is presently being spent during prep..<br />
<br />
This task involves importing some NURBS geometry into BRL-CAD and ray tracing that geometry with a profiler watching our prep performance. Any profiler will do, including gprof, but a performance monitor like oprofile or the Mac "Instruments" application (or Shark) are preferred.<br />
<br />
Learning how to use a profiler is beyond the scope of this task, so it make take you considerably longer to provide us with useful information if you've never run a profiler before.<br />
<br />
To capture prep performance, you will need to import some fairly complex geometry. You should be able to search google with "filetype:3dm" or "filetype:step" or find something on grabcad.com to import<br />
<br />
Running "tops" within mged will tell you what geometry is available for rendering.<br />
<br />
Running "rt -o file.png -s32" on the system command line (not inside mged) should minimize the ray overhead or you can specifically isolate the prep phase we care about. Prep is the time between when rt is run where it opens a window until the first pixels are fired and pixels start filling in.<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Continue investigating GMP integration ===<br />
<br />
BRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this work on. This task is a continuation of a prior GCI task (read it in full!):<br />
<br />
http://www.google-melange.com/gci/task/view/google/gci2012/7946218<br />
<br />
This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic.<br />
<br />
Building on the previous GCI task work, take it to the next step. Try setting a vector to 1/3, 1/3, 1/3 and 0.1, 0.1, 0.1 and get proper values to print. Change the V3ARGS() macro if needed. If that all works, try to get bn_dist_pt3_pt3() to work. Report and discuss your progress.<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a T-Shirt for BRL-CAD ===<br />
<br />
This task involves designing a T-Shirt for BRL-CAD. Use your designing skills to design a T-Shirt for BRL-CAD. You can use the current BRL-CAD logo, or you may tweak it. Be creative while designing this T-Shirt. It would be good if the design has some special meaning.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a coffee mug for BRL-CAD ===<br />
<br />
This task involves designing a coffee mug for BRL-CAD. Make it look good, so that one can use it while working on BRL-CAD. Look over some great coffee mug designs before starting to work on this. It would be great if the design on coffee mug has some special meaning.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design BRL-CAD sticker ===<br />
<br />
This task involves designing a BRL-CAD sticker. The design should be simple and sleek. The concept of sticker should be clear and also it should be creatively presented. Get inspired from some sticker designs but choose your own imagination while designing the sticker. There is no bound for shape of sticker, it can be rectangular, circular or even irregular. The only thing that matters is that it should look good.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design BRL-CAD phone/tablet back cover ===<br />
<br />
This task involves designing a BRL-CAD phone/tablet cover. <br />
While submitting your design, provide the sample phone cover, tablet cover with the design and rendered png or jpg image of the sticker design. Try to have a special meaning of design, and the concept should be creatively illustrated.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a wallpaper set for BRL-CAD ===<br />
<br />
This task involves designing a set of wallpapers for BRL-CAD. The central idea of each wallpaper should represent any feature of BRL-CAD. Try to design a minimum of 5 wallpapers but if you have more than 5 designs than you are welcomed. <br />
<br />
Try to different resolutions of each wallpaper.<br />
<br />
Check the following wallpapers for inspiration.<br />
* http://www.smashingmagazine.com/tag/wallpapers/<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create Iron Man Arc Reactor Model in BRL-CAD ===<br />
<br />
This task involves creating Arc Reactor as seen in hollywood movie Iron-Man. You will have to create two versions of the Arc Reactor one glowing and another non glowing. <br />
<br />
Check this model for inspiration<br />
* http://grabcad.com/library/iron-man-arc-reactor-request<br />
<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Tweak BRL-CAD logo to wish New Year ===<br />
<br />
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.<br />
Make sure this tweak should be tweaked version of current logo and not entirely new logo.<br />
<br />
Tip: Search for some global events occurring in 2015 and design accordingly. Also keep the letters 2,0,1,5 in mind while designing. ;)<br />
<br />
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.<br />
<br />
Gallery of all google doodles<br />
* http://www.google.com/doodles<br />
<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Tweak BRL-CAD logo to wish Merry Christmas ===<br />
<br />
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.<br />
Make sure the output of this task should be tweaked version of current logo and not entirely new logo.<br />
<br />
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.<br />
<br />
Gallery of all google doodles<br />
* http://www.google.com/doodles<br />
<br />
<br />
|}<br />
<br />
----<br />
<br />
== Quality Assurance ==<br />
----<br />
''Tasks related to testing and ensuring code is of high quality''<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix single-precision floating point crash ===<br />
<br />
By default, all of BRL-CAD compiles using double-precision floating point arithmetic. We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point. This compilation mode was recently cleaned up and tested, but a bug was found. The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool.<br />
<br />
To compile in single precision, edit the include/bn.h header file and change the fastf_t typedef from double to float. To reproduce the bug, compile BRL-CAD and write this out to a text file named star.view:<br />
<br />
viewsize 2.500000000e+05;<br />
eye_pt 2.102677960e+05 8.455500000e+04 2.934714650e+04;<br />
viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00<br />
5.539599410e-01 4.823888300e-02 8.311441420e-01 0.000000000e+00<br />
4.896120540e-01 7.885590550e-01 -3.720948210e-01 0.000000000e+00<br />
0.000000000e+00 0.000000000e+00 0.000000000e+00 1.000000000e+00 ;<br />
start 0;<br />
end;<br />
<br />
Then run rt feeding it that view script as input. This is an example how to run within the gdb debugger:<br />
gdb path/to/bin/rt<br />
...<br />
(gdb) run -F/dev/X -M .cmake/share/db/star.g all < star.view<br />
<br />
At this point, rt should crash due to an infinite recursion. A backtrace in the debugger will show lots and lots of calls to rt_shootray() and light_hit().<br />
<br />
This task involves investigating and preventing the crash. Provide a patch that fixes the bug.<br />
<br />
References:<br />
* man gdb<br />
* brlman rt<br />
<br />
Code:<br />
* src/librt/shoot.c<br />
* src/liboptical/sh_light.c<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix closedb ===<br />
<br />
BRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file. While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications. However, at some point in the recent past, the ''closedb'' command was horked. It's undoubtedly something very simple but we haven't bothered to look due to other priorities. You can fix it. If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb:<br />
<br />
mged> opendb test.g y<br />
mged> make sph sph<br />
mged> l sph<br />
mged> closedb<br />
mged> make sph sph<br />
mged> opendb test.g<br />
mged> l sph<br />
mged> exit<br />
<br />
Provide a patch that fixes the bug or tell us which SVN revision introduced the bug. Make sure you can reproduce the bug before claiming this task, which presumes you know how to download/install BRL-CAD from a source distribution.<br />
<br />
Code:<br />
* src/mged/mged.c<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create a utility library (LIBBU) API unit test ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
References:<br />
* include/bu.h<br />
* src/libbu/*.c<br />
* src/libbu/tests/*.c<br />
<br />
Code:<br />
* src/libbu/tests/[TEST].c<br />
* src/libbu/tests/CMakeLists.txt<br />
<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit test for LIBBU bomb.c ====<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Create Numerics library (LIBBN) API unit tests ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
References:<br />
* include/bn.h<br />
* include/plot3.h<br />
* include/vmath.h<br />
* src/libbn/*.c<br />
* src/libbn/tests/*.c <-- check this directory for examples<br />
* src/libbu/tests/*.c <-- Note: Also check this too for more examples.<br />
<br />
Code:<br />
* src/libbn/tests/[TEST].c<br />
* src/libbn/tests/CMakeLists.txt<br />
<br />
<b> Note </b><br />
A valid task will constitute writing a basic test for each function in the following libbn/ files.<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN anim.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
*Useful resources<br />
->coming!<br />
<br />
==== ... unit tests for LIBBN axis.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN qmath.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
<br />
*Useful links and Resources<br />
-> Coming!<br />
<br />
==== ... unit tests for LIBBN rand.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN vector.c ====<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
*Useful links and resources<br />
-> To be added.<br />
<br />
=== Find, reliably reproduce, and report any bug in Archer ===<br />
<br />
Archer is our new modeling interface and a soon to merge with our long-standing MGED geometry editor. It undoubtedly has bugs. It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions. Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly. You will have to explore the tool with minimal documentation.<br />
<br />
This task involves filing a bug report with verifiable and reproducible steps that clearly demonstrate the bug. It can't be a bug already reported or otherwise documented nor can it be merely behavior you don't like.<br />
<br />
References:<br />
* archer<br />
* Introduction to MGED at http://brlcad.org/wiki/Documentation (many of the mged commands are available in some fashion within archer) <br />
* BUGS file in any source/binary distribution<br />
* http://sourceforge.net/tracker/?atid=640802&group_id=105292&func=browse<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Reproduce any 10 unconfirmed open bug reports ===<br />
<br />
BRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned. Read the comments and status to see if the bug has been confirmed/reproduced. <br />
<br />
This task involves going through those reports and REPRODUCE at least 10 of the ones that have not been confirmed. When you can reproduce the issue being reported, you'll comment on the thread to state as much and attach any data you used to reproduce the crash.<br />
<br />
References:<br />
* https://sourceforge.net/tracker/?limit=100&func=&group_id=105292&atid=640802&assignee=100&status=1&submit=Filter<br />
|}<br />
<br />
<br />
----<br />
<br />
== User Interface ==<br />
----<br />
''Tasks related to user experience research or user interface design and interaction''<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create an ISST screenshot or animation ===<br />
<br />
Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have.<br />
<br />
Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail.<br />
<br />
References:<br />
* http://brlcad.org/gallery/d/19-4/MGED.jpg<br />
* https://brlcad.org/tmp/archer.png<br />
* https://brlcad.org/gallery/index.php?/category/12<br />
* http://www.google-melange.com/gci/task/view/google/gci2012/8019211<br />
<br />
Note that we have several screenshot tasks. Note you may have to go through some or our basic MGED tutorials (see docs section on our website) just to be able to display geometry. Finally, give others a chance if you already completed one of the other screenshot tasks. ;)<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Categorize all of BRL-CAD's commands into a spreadsheet ===<br />
<br />
BRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more. There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together.<br />
<br />
This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command.<br />
<br />
References:<br />
* A spreadsheet template will be provided.<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a Cover Photo for Facebook page (and other social networks) ===<br />
<br />
BRL-CAD got it's logo changed, and it's website is undergoing a change. So this re-branding of BRL-CAD also requires a good, well designed and attractive cover photo for the BRL-CAD's Facebook page or other Social Media Appearances. It should feature a good tagline telling some killer feature of BRL-CAD, BRL-CAD's new logo and/or some illustration/image regarding the feature highlighted in tagline.<br />
<br />
It should be consistent with the color scheme of our new website design.<br />
<br />
New website design <br />
*http://cpp-tricks.com/brlcad/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Design a banner ad for BRL-CAD ===<br />
<br />
BRL-CAD is one of the oldest open source communities. This community has a good following, so we want to give a chance to everyone so that they can show their support to the community by adding a banner ad in their website. You have to create a banner ad that can be embedded in the website by copy pasting some simple lines of code (basically an iframe). <br />
<br />
Such a banner ad can also be used in various sections of our own website. <br />
<br />
The task requires you to create a CSS3 based animated horizontal and vertical banner add, highlighting some feature of BRL-CAD or making some call to action. This call to action can be joining mailing list, or signing up for community, or link to latest post etc. <br />
<br />
For Inspiration and tutorial refer<br />
*http://tympanus.net/Tutorials/AnimatedWebBanners/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Creating Motion Typography video for BRL-CAD ===<br />
<br />
BRL-CAD has a lot of great features that can be highlighted. A motion typography video highlighting these features would be a wonderful addition to the front page of website. <br />
<br />
This task requires you to create a motion typography video that will convince user to give BRL-CAD a try, it could be titled something like "x reasons to choose BRL-CAD" or anything similar (give your creative minds a flight). The video should not be more than 2 minutes. <br />
<br />
For inspiration about what a motion typography, see<br />
*http://vimeo.com/24715531<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create a screen-cast for BRL-CAD ===<br />
<br />
Getting started with BRL-CAD is sometimes not so smooth. A screen-cast giving a tour of BRL-CAD's GUI and the steps involved in creating the first model will make it easy for users to get started. <br />
<br />
For this task you need to install BRL-CAD on your computer. Create a very basic model in it and record your screen as you create the model. It should also give a tour of BRL-CAD's workspace. You can choose model of your choice. Keep something very basic and easy for the first time users. <br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Loading Google charts from API ===<br />
<br />
A basic wrapper of GCharts has been implemented a while ago : https://bitbucket.org/suryajith/benchmark/src/a27dd8c05d6819a527650e06a63076599d2e0d66/libs/charting.py?at=default With the google charts improving their API system which wasn't around then, see if the code could be optimized so to get the charts the optimal way.<br />
<br />
Reference: <br />
*https://developers.google.com/chart/interactive/docs/index<br />
<br />
<br />
|}<br />
<br />
=== Design a hall of fame for BRL-CAD developers ===<br />
<br />
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. <br />
<br />
Links: <br />
* http://cpp-tricks.com/brlcad/<br />
* http://underscores.me/<br />
<br />
<br />
|}<br />
----<br />
<br />
= When You're Done =<br />
----<br />
<br />
For non-code, just send us your file(s). For code changes, you will be expected to [[Patches|provide a patch file]]. Make sure you ''read'' your patch file before submitting it. Make sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:<br />
<br />
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit<br />
cd brlcad.edit<br />
# make changes<br />
svn diff > ~/my.patch<br />
# read ~/my.patch file with text editor<br />
cd ..<br />
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh<br />
cd brlcad.fresh<br />
patch -p0 < ~/my.patch<br />
# submit your patch file to our patches tracker<br />
&nbsp;</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Deuces&diff=11797Deuces2020-10-24T17:44:32Z<p>Vikram Atreya: Deleted Bounding box optimization task</p>
<hr />
<div>This is a list of succinct tasks that are expected to take most people familiar with the prerequisites less than two hours to complete. It's a great starting point for anyone interested in contributing to BRL-CAD.<br />
<br />
The tasks are all roughly the same complexity with '''''no prior BRL-CAD experience expected'''''. A description is provided along with a list of references and files you'll probably need to edit. Can we make it any easier?<br />
<br />
= Getting Started =<br />
<br />
Contact us (via [[IRC]] or [[Mailing_Lists|brlcad-devel mailing list]]) if you have questions, comments, or ideas of your own you'd like to suggest.<br />
<br />
We've made an awesome virtual disk image that has everything you need preconfigured and ready to go:<br />
<br />
# [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/ Download our BRL-CAD Virtual Machine (VM) disk image.]<br />
# [https://www.virtualbox.org/wiki/Downloads Install VirtualBox.]<br />
# Import and start the VM, log in (the password is "Brlcad!" without the quotes).<br />
# Run "svn up brlcad-svn-trunk" and get started!<br />
<br />
=Pick a Task=<br />
<br />
We break down all tasks into one of five categories. Don't be worried if the tasks all sound confusing to you. Just pick one and start reading the references we've provided. Join IRC or our mailing list and ask questions.<br />
<br />
# Code (programming)<br />
# Documentation and Training (writing)<br />
# Outreach and Research (graphics)<br />
# Quality Assurance (testing)<br />
# User Interface (designing)<br />
<br />
__TOC__<br />
<br />
----<br />
<br />
== Code ==<br />
----<br />
''Tasks related to writing or refactoring code''<br />
<br />
See the When You're Done section above for details on submitting your changes.<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Close MGED when both windows are closed ===<br />
<br />
BRL-CAD has an interactive geometry editor called MGED. It's often the starting point for beginners and allows creation and manipulation of models using commands. When ''mged'' is run, it creates 2 windows: a text-console command window and an interactive graphics window. When the user closes one of those windows, there is a bug. Closing the graphics window closes the command window.<br />
<br />
This task involves fixing this behavior so that ONLY closing ''both'' windows terminates the process properly and that closing either window does not take the other along with it.<br />
<br />
Code:<br />
* src/mged/mged.c<br />
* src/tclscripts/mged/openw.tcl<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive centroid function ===<br />
<br />
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. 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.<br />
<br />
This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point). There are numerous examples in our code where we compute centroids for other primitives. The primitives that do not already have a centroid callback are itemized in following.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/Centroid<br />
* http://mathworld.wolfram.com/<br />
* include/raytrace.h: See ft_centroid callback defined in the rt_functab structure<br />
<br />
Code:<br />
* src/librt/primitives/table.c<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive curvature function ===<br />
<br />
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.<br />
<br />
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;<br />
* superell<br />
* cline<br />
* extrude<br />
* grip<br />
* metaball<br />
* hrt. <br />
There are numerous examples in our code where we compute the curvature for other primitives like the ellipsoid, sphere, elliptical parabola, etc.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/Curvature<br />
* http://en.wikipedia.org/wiki/Radius_of_curvature_(mathematics)<br />
* http://mathworld.wolfram.com/<br />
* 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).<br />
<br />
Code:<br />
* src/librt/primitives/table.c<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive UV-mapping callback ===<br />
<br />
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping. An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid. Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior.<br />
<br />
This task involves implementing a UV-mapping callback for any of the primitives that do not already have a functional UV-callback defined. Note that this is an advanced task that might take you more than a couple hours if you don't have solid coding skills, but it's ultimately just a few lines of code. See other primitives that already implement a UV-mapping callback for reference.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/UV_mapping<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c, read the rt_*_uv() function<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... UV-mapping for extruded sketches (EXTRUDE) ====<br />
<br />
Code:<br />
* src/librt/primitives/extrude/extrude.c<br />
* src/librt/primitives/table.c<br />
* include/rtgeom.h<br />
<br />
|}<br />
&nbsp;<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Implement a platform independent re-entrant sort function ===<br />
<br />
The classic C library qsort() does not support a context parameter. A work around is to store the context information in a static variable. However, this solution is not thread save and may result in unpredictable behavior.<br />
<br />
There are platform specific sort functions qsort_r() in incompatible versions for BSD and GNU and qsort_s() for MSVC. Your task is to implement a bu_sort() function for BRL-CAD which is platform independent.<br />
<br />
Code:<br />
* src/libbu/sort.c<br />
<br />
The new sort function could look like this:<br />
void bu_sort(genptr_t array, size_t nummemb, size_t sizememb, int (*compare)(const_genptr_t, const_genptr_t, genptr_t), genptr_t context);<br />
|}<br />
&nbsp;<br />
<br />
----<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Solve fonts related bug in new wiki theme ===<br />
<br />
BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme uses a font called 'open-sans' from google fonts directory. It's linked via CSS but it does not get loaded (we still see default serif all over the place). So your task will be to debug the CSS code and get Open Sans loaded. <br />
<br />
Links:<br />
*http://beta.brlcad.org/wiki/Main_Page<br />
<br />
&nbsp;<br />
<br />
----<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Better placement of icons in wiki theme ===<br />
<br />
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.<br />
<br />
Links:<br />
*http://beta.brlcad.org/wiki/Main_Page<br />
<br />
&nbsp;<br />
<br />
----<br />
|}<br />
<br />
== Documentation and Training ==<br />
----<br />
''Tasks related to creating/editing documents and helping others learn more about BRL-CAD''<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Add missing documentation (for any ONE command) ===<br />
<br />
BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented:<br />
<br />
a-d archer asc2g asc2pix bot-bldxf bottest brep_cube brep_simple brickwall btclsh burst bw-a bw-d bwish c-d chan_add clutter contours d-a damdf dauto dauto2 d-bw dconv ddisp d-f dfft d-i dmod double-asc dpeak dsel dsp_add dstat d-u dwin euclid_format euclid_unformat fbgammamod f-d fence fhor f-i g-adrt g-euclid1 g-jack globe g-off i-a i-d i-f ihist imod istat jack-g kurt lowp molecule nmgmodel nmg-sgp off-g pipe pipetest pix2g pix3filter pixcount pixelswap pixembed pixfields pixfieldsep pixflip-fb pixpaste pix-spm pix-yuv plstat pyramid rawbot remapid rlesortmap rletovcr room rtcell rtexample rtfrac rtrad rtsil rtsrv script-tab sketch solshoot sphflake spltest spm-fb ssampview syn tea tea_nmg testfree texturescale torii ttcp tube txyz-pl u-a u-bw u-d u-f umod ustat vcrtorle vegitation wall wdb_example xbmtorle xyz-pl yuv-pix<br />
<br />
This task involves writing basic documentation for '''JUST ONE''' of those commands in the Docbook XML format. The command documentation should provide a one-sentence description, a detailed paragraph description (200+ words), explanation of '''all''' available command-line options, and one or more examples on how to use the command. <br />
<br />
Code:<br />
* doc/docbook/system/man1/en/Makefile.am<br />
* doc/docbook/system/man1/en/*.xml<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write an article "BRL-CAD for dummies" ===<br />
<br />
Although BRL-CAD has extensive documentation, still it needs a short and simple document which is particularly built for dummies.<br />
<br />
This task involves writing a article named '''BRL-CAD for dummies'''. This article should start with the installation process, if there is any existing installation guide for dummies, provide a link to it. The main motive of this article to empower dummy to make his/her first model using BRL-CAD. One thing to be kept in mind while writing this article is that this article is mainly concentrated for dummies. So use simple language to an extent and if you need to mention some technical term, first explain that term.<br />
<br />
The output of this task can be a pdf, html, doc, odt or any other document file that contains this article. Go through the link provided. Use screenshots and images to make it look attractive so that the reader is not bored.<br />
<br />
Reference:<br />
* http://brlcad.org/wiki/Documentation<br />
<br />
|}<br />
<br />
&nbsp;<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Translate "Contributors Guide To BRL-CAD" To Any Language ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
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<br />
<br />
* Feature Overview<br />
* Working with our Code<br />
* What code to work on<br />
* How to contribute<br />
* .... (Just to name a few )<br />
<br />
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.<br />
<br />
Reference:<br />
* http://en.flossmanuals.net/_booki/contributors-guide-to-brl-cad/contributors-guide-to-brl-cad.pdf<br />
<br />
|}<br />
<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Write a "BRL-CAD Commands Quick Reference" document ===<br />
<br />
There is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands.<br />
<br />
This task involves writing a quick reference document similar to [http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf the MGED quick reference] but for BRL-CAD commands. The sheet should minimally include the following commands:<br />
<br />
mged, rt*, *-g, g-*, fb*, *fb, nirt, remrt, rtsrv, asc2g, g2asc, dbupgrade, pix*, *pix, *-*, brlman, benchmark<br />
<br />
References:<br />
* http://brlcad.org/wiki/Documentation<br />
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf<br />
* [http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png git example]<br />
* [http://www.stdout.org/~winston/latex/latexsheet-0.png latex example]<br />
* [http://img.docstoccdn.com/thumb/orig/524314.png another example]<br />
* [http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png drupal example]<br />
* [http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg php example]<br />
<br />
|}<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Doxygen cleanup ===<br />
<br />
BRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output.<br />
<br />
This task involves cleaning up the Doxygen comments in the library so that useful reports and API documentation automatically generated (correctly, completely, and cleanly). Verify/fix any Doxygen syntax. Verify/fix groups so that functions are organized neatly and all contained within a group. Provide patches that give clean (PDF) output from Doxygen.<br />
<br />
References:<br />
* http://www.jiggerjuice.net/software/doxygen.html<br />
* http://www.stack.nl/~dimitri/doxygen/starting.html<br />
* http://www.stack.nl/~dimitri/doxygen/<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBBU ====<br />
<br />
There are approximately 300 documented API function calls in LIBBU.<br />
<br />
Code:<br />
* include/bu.h<br />
* src/libbu<br />
* misc/Doxyfile<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBWDB ====<br />
<br />
There are approximately 100 documented API function calls in LIBWDB. <br />
<br />
Code:<br />
* include/wdb.h<br />
* include/raytrace.h<br />
* src/libwdb<br />
* misc/Doxyfile<br />
<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBRT ====<br />
<br />
There are approximately 1000 documented API function calls in LIBRT. <br />
<br />
Code:<br />
* include/raytrace.h<br />
* src/librt<br />
* src/librt/primitives<br />
* src/librt/comb<br />
* src/librt/binunif<br />
* misc/Doxyfile<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write up Wiki page tutorial on our Volumetric Primitive ===<br />
<br />
BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.<br />
<br />
This task involves writing up a page on the VOL primitive. Figure out how to use it (see the "in" command), create an example input data set, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:<br />
<br />
References:<br />
* http://brlcad.org/wiki/DSP<br />
* http://brlcad.org/wiki/Sketch<br />
* http://brlcad.org/wiki/EBM <-- particularly useful as the data is similar for VOL<br />
<br />
Show how to create a VOL with at least two layers/slices. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/VOL<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write a wiki tutorial on how to create a polygonal mesh (NMG) manually ===<br />
<br />
BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.<br />
<br />
This task involves writing up a page on the NMG polygonal mesh primitive. Figure out how to use it (not a simple task, will require some trial and error), create an example input, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:<br />
<br />
References:<br />
* http://brlcad.org/wiki/DSP<br />
* http://brlcad.org/wiki/EBM<br />
* http://brlcad.org/wiki/Sketch <-- particularly useful as neither NMG nor sketch are meant to be created manually<br />
<br />
Note the "facetize" command in mged will convert an existing object into NMG format. The get/put commands should help from there like the sketch tutorial.<br />
<br />
Show how to create an NMG cube or wedge or similar simple shape. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/NMG<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents) ===<br />
<br />
The majority of BRL-CAD's documentation is defined as DocBook files, from which other formats (HTML, PDF, man page, etc.) can be generated. PDF files present a particular challenge, and have some very specific requirements to achieve "good" formatting.<br />
<br />
BRL-CAD's DocBook files need to uniformly use a style of image inclusion that is aware of what "role" the image is supposed to serve. A "basic" image inclusion example looks like this:<br />
<br />
<mediaobject><br />
<imageobject><br />
<imagedata align="center" fileref="../../lessons/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<nowiki><caption></nowiki><br />
<para><br />
Caption goes here.<br />
</para><br />
</caption><br />
</mediaobject><br />
<br />
This task involves switching image inclusions that use the above style to something like the following:<br />
<br />
<mediaobject><br />
<imageobject role="html"><br />
<imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<imageobject role="fo"><br />
<imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<nowiki><caption></nowiki><br />
<para><br />
Caption goes here.<br />
</para><br />
</caption><br />
</mediaobject><br />
<br />
The "role" flag to imageobject provides the opportunity to specify different image formatting options when the output is HTML (role="html") or PDF (role="fo").<br />
<br />
The captions should be preserved as above on mediaobjects that have them, but mediaobjects without a caption should also be converted and there is no need to add a caption in such cases.<br />
<br />
Any patch that makes changes to the DocBook sources should result in a successful "make doc" build test. This won't generate PDF documents, but it will validate the XML files and produce HTML - remember that introducing breakage means the patch won't be accepted.<br />
<br />
Remember, the tasks are simply to do the above conversion for all images in the file or files, not to introduce PDF specific formatting. Formatting fixes will be needed, but they are very much "case by case" and will take both additional time and a working Apache FOP installation, as well as knowledge of how to enable PDF generation. If all image inclusions have been converted successfully and a student is interested in actually fixing the formatting, please discuss it with us on IRC or the mailing list.<br />
<br />
References:<br />
* doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml<br />
<br />
Code:<br />
* doc/docbook<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Make a step by step tutorial for creating BRL-CAD model ===<br />
<br />
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. <br />
<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Find 5 bugs in OGV ===<br />
<br />
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. <br />
<br />
Links:<br />
https://github.com/BRL-CAD/OGV-meteor/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Find 5 coding guidelines violations in OGV ===<br />
<br />
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. <br />
<br />
Links:<br />
https://github.com/BRL-CAD/OGV-meteor/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
----<br />
<br />
==Outreach and Research ==<br />
----<br />
''Tasks related to community management, outreach/marketing, studying problems, and recommending solutions''<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Profile NURBS prep performance ===<br />
<br />
BRL-CAD implements support for rendering of NURBS representation geometry. If you import a solid 3DM or STEP format model into BRL-CAD, it will import as BREP/NURBS geometry. Opening that geometry in BRL-CAD's MGED editor will tell you what objects are available and our 'rt' tool will raytrace it. When geometry is ray traced, it first goes through a "prep" phase and then it starts shooting rays. Our prep phase is entirely unoptimized so we'd like to know where all the time is presently being spent during prep..<br />
<br />
This task involves importing some NURBS geometry into BRL-CAD and ray tracing that geometry with a profiler watching our prep performance. Any profiler will do, including gprof, but a performance monitor like oprofile or the Mac "Instruments" application (or Shark) are preferred.<br />
<br />
Learning how to use a profiler is beyond the scope of this task, so it make take you considerably longer to provide us with useful information if you've never run a profiler before.<br />
<br />
To capture prep performance, you will need to import some fairly complex geometry. You should be able to search google with "filetype:3dm" or "filetype:step" or find something on grabcad.com to import<br />
<br />
Running "tops" within mged will tell you what geometry is available for rendering.<br />
<br />
Running "rt -o file.png -s32" on the system command line (not inside mged) should minimize the ray overhead or you can specifically isolate the prep phase we care about. Prep is the time between when rt is run where it opens a window until the first pixels are fired and pixels start filling in.<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Continue investigating GMP integration ===<br />
<br />
BRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this work on. This task is a continuation of a prior GCI task (read it in full!):<br />
<br />
http://www.google-melange.com/gci/task/view/google/gci2012/7946218<br />
<br />
This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic.<br />
<br />
Building on the previous GCI task work, take it to the next step. Try setting a vector to 1/3, 1/3, 1/3 and 0.1, 0.1, 0.1 and get proper values to print. Change the V3ARGS() macro if needed. If that all works, try to get bn_dist_pt3_pt3() to work. Report and discuss your progress.<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a T-Shirt for BRL-CAD ===<br />
<br />
This task involves designing a T-Shirt for BRL-CAD. Use your designing skills to design a T-Shirt for BRL-CAD. You can use the current BRL-CAD logo, or you may tweak it. Be creative while designing this T-Shirt. It would be good if the design has some special meaning.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a coffee mug for BRL-CAD ===<br />
<br />
This task involves designing a coffee mug for BRL-CAD. Make it look good, so that one can use it while working on BRL-CAD. Look over some great coffee mug designs before starting to work on this. It would be great if the design on coffee mug has some special meaning.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design BRL-CAD sticker ===<br />
<br />
This task involves designing a BRL-CAD sticker. The design should be simple and sleek. The concept of sticker should be clear and also it should be creatively presented. Get inspired from some sticker designs but choose your own imagination while designing the sticker. There is no bound for shape of sticker, it can be rectangular, circular or even irregular. The only thing that matters is that it should look good.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design BRL-CAD phone/tablet back cover ===<br />
<br />
This task involves designing a BRL-CAD phone/tablet cover. <br />
While submitting your design, provide the sample phone cover, tablet cover with the design and rendered png or jpg image of the sticker design. Try to have a special meaning of design, and the concept should be creatively illustrated.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a wallpaper set for BRL-CAD ===<br />
<br />
This task involves designing a set of wallpapers for BRL-CAD. The central idea of each wallpaper should represent any feature of BRL-CAD. Try to design a minimum of 5 wallpapers but if you have more than 5 designs than you are welcomed. <br />
<br />
Try to different resolutions of each wallpaper.<br />
<br />
Check the following wallpapers for inspiration.<br />
* http://www.smashingmagazine.com/tag/wallpapers/<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create Iron Man Arc Reactor Model in BRL-CAD ===<br />
<br />
This task involves creating Arc Reactor as seen in hollywood movie Iron-Man. You will have to create two versions of the Arc Reactor one glowing and another non glowing. <br />
<br />
Check this model for inspiration<br />
* http://grabcad.com/library/iron-man-arc-reactor-request<br />
<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Tweak BRL-CAD logo to wish New Year ===<br />
<br />
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.<br />
Make sure this tweak should be tweaked version of current logo and not entirely new logo.<br />
<br />
Tip: Search for some global events occurring in 2015 and design accordingly. Also keep the letters 2,0,1,5 in mind while designing. ;)<br />
<br />
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.<br />
<br />
Gallery of all google doodles<br />
* http://www.google.com/doodles<br />
<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Tweak BRL-CAD logo to wish Merry Christmas ===<br />
<br />
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.<br />
Make sure the output of this task should be tweaked version of current logo and not entirely new logo.<br />
<br />
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.<br />
<br />
Gallery of all google doodles<br />
* http://www.google.com/doodles<br />
<br />
<br />
|}<br />
<br />
----<br />
<br />
== Quality Assurance ==<br />
----<br />
''Tasks related to testing and ensuring code is of high quality''<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix single-precision floating point crash ===<br />
<br />
By default, all of BRL-CAD compiles using double-precision floating point arithmetic. We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point. This compilation mode was recently cleaned up and tested, but a bug was found. The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool.<br />
<br />
To compile in single precision, edit the include/bn.h header file and change the fastf_t typedef from double to float. To reproduce the bug, compile BRL-CAD and write this out to a text file named star.view:<br />
<br />
viewsize 2.500000000e+05;<br />
eye_pt 2.102677960e+05 8.455500000e+04 2.934714650e+04;<br />
viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00<br />
5.539599410e-01 4.823888300e-02 8.311441420e-01 0.000000000e+00<br />
4.896120540e-01 7.885590550e-01 -3.720948210e-01 0.000000000e+00<br />
0.000000000e+00 0.000000000e+00 0.000000000e+00 1.000000000e+00 ;<br />
start 0;<br />
end;<br />
<br />
Then run rt feeding it that view script as input. This is an example how to run within the gdb debugger:<br />
gdb path/to/bin/rt<br />
...<br />
(gdb) run -F/dev/X -M .cmake/share/db/star.g all < star.view<br />
<br />
At this point, rt should crash due to an infinite recursion. A backtrace in the debugger will show lots and lots of calls to rt_shootray() and light_hit().<br />
<br />
This task involves investigating and preventing the crash. Provide a patch that fixes the bug.<br />
<br />
References:<br />
* man gdb<br />
* brlman rt<br />
<br />
Code:<br />
* src/librt/shoot.c<br />
* src/liboptical/sh_light.c<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix closedb ===<br />
<br />
BRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file. While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications. However, at some point in the recent past, the ''closedb'' command was horked. It's undoubtedly something very simple but we haven't bothered to look due to other priorities. You can fix it. If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb:<br />
<br />
mged> opendb test.g y<br />
mged> make sph sph<br />
mged> l sph<br />
mged> closedb<br />
mged> make sph sph<br />
mged> opendb test.g<br />
mged> l sph<br />
mged> exit<br />
<br />
Provide a patch that fixes the bug or tell us which SVN revision introduced the bug. Make sure you can reproduce the bug before claiming this task, which presumes you know how to download/install BRL-CAD from a source distribution.<br />
<br />
Code:<br />
* src/mged/mged.c<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create a utility library (LIBBU) API unit test ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
References:<br />
* include/bu.h<br />
* src/libbu/*.c<br />
* src/libbu/tests/*.c<br />
<br />
Code:<br />
* src/libbu/tests/[TEST].c<br />
* src/libbu/tests/CMakeLists.txt<br />
<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit test for LIBBU bomb.c ====<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Create Numerics library (LIBBN) API unit tests ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
References:<br />
* include/bn.h<br />
* include/plot3.h<br />
* include/vmath.h<br />
* src/libbn/*.c<br />
* src/libbn/tests/*.c <-- check this directory for examples<br />
* src/libbu/tests/*.c <-- Note: Also check this too for more examples.<br />
<br />
Code:<br />
* src/libbn/tests/[TEST].c<br />
* src/libbn/tests/CMakeLists.txt<br />
<br />
<b> Note </b><br />
A valid task will constitute writing a basic test for each function in the following libbn/ files.<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN anim.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
*Useful resources<br />
->coming!<br />
<br />
==== ... unit tests for LIBBN axis.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN qmath.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
<br />
*Useful links and Resources<br />
-> Coming!<br />
<br />
==== ... unit tests for LIBBN rand.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN vector.c ====<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
*Useful links and resources<br />
-> To be added.<br />
<br />
=== Find, reliably reproduce, and report any bug in Archer ===<br />
<br />
Archer is our new modeling interface and a soon to merge with our long-standing MGED geometry editor. It undoubtedly has bugs. It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions. Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly. You will have to explore the tool with minimal documentation.<br />
<br />
This task involves filing a bug report with verifiable and reproducible steps that clearly demonstrate the bug. It can't be a bug already reported or otherwise documented nor can it be merely behavior you don't like.<br />
<br />
References:<br />
* archer<br />
* Introduction to MGED at http://brlcad.org/wiki/Documentation (many of the mged commands are available in some fashion within archer) <br />
* BUGS file in any source/binary distribution<br />
* http://sourceforge.net/tracker/?atid=640802&group_id=105292&func=browse<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Reproduce any 10 unconfirmed open bug reports ===<br />
<br />
BRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned. Read the comments and status to see if the bug has been confirmed/reproduced. <br />
<br />
This task involves going through those reports and REPRODUCE at least 10 of the ones that have not been confirmed. When you can reproduce the issue being reported, you'll comment on the thread to state as much and attach any data you used to reproduce the crash.<br />
<br />
References:<br />
* https://sourceforge.net/tracker/?limit=100&func=&group_id=105292&atid=640802&assignee=100&status=1&submit=Filter<br />
|}<br />
<br />
<br />
----<br />
<br />
== User Interface ==<br />
----<br />
''Tasks related to user experience research or user interface design and interaction''<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create an ISST screenshot or animation ===<br />
<br />
Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have.<br />
<br />
Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail.<br />
<br />
References:<br />
* http://brlcad.org/gallery/d/19-4/MGED.jpg<br />
* https://brlcad.org/tmp/archer.png<br />
* https://brlcad.org/gallery/index.php?/category/12<br />
* http://www.google-melange.com/gci/task/view/google/gci2012/8019211<br />
<br />
Note that we have several screenshot tasks. Note you may have to go through some or our basic MGED tutorials (see docs section on our website) just to be able to display geometry. Finally, give others a chance if you already completed one of the other screenshot tasks. ;)<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Categorize all of BRL-CAD's commands into a spreadsheet ===<br />
<br />
BRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more. There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together.<br />
<br />
This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command.<br />
<br />
References:<br />
* A spreadsheet template will be provided.<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a Cover Photo for Facebook page (and other social networks) ===<br />
<br />
BRL-CAD got it's logo changed, and it's website is undergoing a change. So this re-branding of BRL-CAD also requires a good, well designed and attractive cover photo for the BRL-CAD's Facebook page or other Social Media Appearances. It should feature a good tagline telling some killer feature of BRL-CAD, BRL-CAD's new logo and/or some illustration/image regarding the feature highlighted in tagline.<br />
<br />
It should be consistent with the color scheme of our new website design.<br />
<br />
New website design <br />
*http://cpp-tricks.com/brlcad/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Design a banner ad for BRL-CAD ===<br />
<br />
BRL-CAD is one of the oldest open source communities. This community has a good following, so we want to give a chance to everyone so that they can show their support to the community by adding a banner ad in their website. You have to create a banner ad that can be embedded in the website by copy pasting some simple lines of code (basically an iframe). <br />
<br />
Such a banner ad can also be used in various sections of our own website. <br />
<br />
The task requires you to create a CSS3 based animated horizontal and vertical banner add, highlighting some feature of BRL-CAD or making some call to action. This call to action can be joining mailing list, or signing up for community, or link to latest post etc. <br />
<br />
For Inspiration and tutorial refer<br />
*http://tympanus.net/Tutorials/AnimatedWebBanners/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Creating Motion Typography video for BRL-CAD ===<br />
<br />
BRL-CAD has a lot of great features that can be highlighted. A motion typography video highlighting these features would be a wonderful addition to the front page of website. <br />
<br />
This task requires you to create a motion typography video that will convince user to give BRL-CAD a try, it could be titled something like "x reasons to choose BRL-CAD" or anything similar (give your creative minds a flight). The video should not be more than 2 minutes. <br />
<br />
For inspiration about what a motion typography, see<br />
*http://vimeo.com/24715531<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create a screen-cast for BRL-CAD ===<br />
<br />
Getting started with BRL-CAD is sometimes not so smooth. A screen-cast giving a tour of BRL-CAD's GUI and the steps involved in creating the first model will make it easy for users to get started. <br />
<br />
For this task you need to install BRL-CAD on your computer. Create a very basic model in it and record your screen as you create the model. It should also give a tour of BRL-CAD's workspace. You can choose model of your choice. Keep something very basic and easy for the first time users. <br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Loading Google charts from API ===<br />
<br />
A basic wrapper of GCharts has been implemented a while ago : https://bitbucket.org/suryajith/benchmark/src/a27dd8c05d6819a527650e06a63076599d2e0d66/libs/charting.py?at=default With the google charts improving their API system which wasn't around then, see if the code could be optimized so to get the charts the optimal way.<br />
<br />
Reference: <br />
*https://developers.google.com/chart/interactive/docs/index<br />
<br />
<br />
|}<br />
<br />
=== Design a hall of fame for BRL-CAD developers ===<br />
<br />
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. <br />
<br />
Links: <br />
* http://cpp-tricks.com/brlcad/<br />
* http://underscores.me/<br />
<br />
<br />
|}<br />
----<br />
<br />
= When You're Done =<br />
----<br />
<br />
For non-code, just send us your file(s). For code changes, you will be expected to [[Patches|provide a patch file]]. Make sure you ''read'' your patch file before submitting it. Make sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:<br />
<br />
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit<br />
cd brlcad.edit<br />
# make changes<br />
svn diff > ~/my.patch<br />
# read ~/my.patch file with text editor<br />
cd ..<br />
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh<br />
cd brlcad.fresh<br />
patch -p0 < ~/my.patch<br />
# submit your patch file to our patches tracker<br />
&nbsp;</div>Vikram Atreyahttps://brlcad.org/w/index.php?title=Deuces&diff=11796Deuces2020-10-22T10:59:39Z<p>Vikram Atreya: Corrected spelling mistakes</p>
<hr />
<div>This is a list of succinct tasks that are expected to take most people familiar with the prerequisites less than two hours to complete. It's a great starting point for anyone interested in contributing to BRL-CAD.<br />
<br />
The tasks are all roughly the same complexity with '''''no prior BRL-CAD experience expected'''''. A description is provided along with a list of references and files you'll probably need to edit. Can we make it any easier?<br />
<br />
= Getting Started =<br />
<br />
Contact us (via [[IRC]] or [[Mailing_Lists|brlcad-devel mailing list]]) if you have questions, comments, or ideas of your own you'd like to suggest.<br />
<br />
We've made an awesome virtual disk image that has everything you need preconfigured and ready to go:<br />
<br />
# [https://sourceforge.net/projects/brlcad/files/BRL-CAD%20for%20Virtual%20Machines/ Download our BRL-CAD Virtual Machine (VM) disk image.]<br />
# [https://www.virtualbox.org/wiki/Downloads Install VirtualBox.]<br />
# Import and start the VM, log in (the password is "Brlcad!" without the quotes).<br />
# Run "svn up brlcad-svn-trunk" and get started!<br />
<br />
=Pick a Task=<br />
<br />
We break down all tasks into one of five categories. Don't be worried if the tasks all sound confusing to you. Just pick one and start reading the references we've provided. Join IRC or our mailing list and ask questions.<br />
<br />
# Code (programming)<br />
# Documentation and Training (writing)<br />
# Outreach and Research (graphics)<br />
# Quality Assurance (testing)<br />
# User Interface (designing)<br />
<br />
__TOC__<br />
<br />
----<br />
<br />
== Code ==<br />
----<br />
''Tasks related to writing or refactoring code''<br />
<br />
See the When You're Done section above for details on submitting your changes.<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Verify/Improve bounding box function for our polygonal mesh (BoT) primitive ===<br />
<br />
BRL-CAD provides functions for its geometric primitives that define a bounding box - a box that completely encloses the volume described by the primitive. Ideally, these boxes are as small as possible while still enclosing the primitive. Currently the routine for BoTs is inefficient. It iterates over each vertex of all faces instead of simply iterating over all vertices.<br />
<br />
This task involves studying the current code for the function rt_bot_bbox() and the prior version (run "svn diff -c54560 src/librt/primitives/bot/bot.c" to see the previous version), and then figuring out how to make rt_bot_bbox() more efficient.<br />
<br />
Simply using vertices may result in inaccuracies (the mged 'bb' command is a good way to visualize primitive bounding boxes), so you will need to test with a variety of models and a variety of import methods (e.g., gcv, stl-g, obj-g).<br />
<br />
Reimplement it from scratch if you like. Use timers to determine whether you've actually made it faster.<br />
<br />
Code:<br />
* src/librt/primitives/bot/bot.c<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Close MGED when both windows are closed ===<br />
<br />
BRL-CAD has an interactive geometry editor called MGED. It's often the starting point for beginners and allows creation and manipulation of models using commands. When ''mged'' is run, it creates 2 windows: a text-console command window and an interactive graphics window. When the user closes one of those windows, there is a bug. Closing the graphics window closes the command window.<br />
<br />
This task involves fixing this behavior so that ONLY closing ''both'' windows terminates the process properly and that closing either window does not take the other along with it.<br />
<br />
Code:<br />
* src/mged/mged.c<br />
* src/tclscripts/mged/openw.tcl<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive centroid function ===<br />
<br />
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. 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.<br />
<br />
This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point). There are numerous examples in our code where we compute centroids for other primitives. The primitives that do not already have a centroid callback are itemized in following.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/Centroid<br />
* http://mathworld.wolfram.com/<br />
* include/raytrace.h: See ft_centroid callback defined in the rt_functab structure<br />
<br />
Code:<br />
* src/librt/primitives/table.c<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive curvature function ===<br />
<br />
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.<br />
<br />
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;<br />
* superell<br />
* cline<br />
* extrude<br />
* grip<br />
* metaball<br />
* hrt. <br />
There are numerous examples in our code where we compute the curvature for other primitives like the ellipsoid, sphere, elliptical parabola, etc.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/Curvature<br />
* http://en.wikipedia.org/wiki/Radius_of_curvature_(mathematics)<br />
* http://mathworld.wolfram.com/<br />
* 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).<br />
<br />
Code:<br />
* src/librt/primitives/table.c<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c<br />
<br />
|}<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Implement a primitive UV-mapping callback ===<br />
<br />
BRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping. An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid. Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior.<br />
<br />
This task involves implementing a UV-mapping callback for any of the primitives that do not already have a functional UV-callback defined. Note that this is an advanced task that might take you more than a couple hours if you don't have solid coding skills, but it's ultimately just a few lines of code. See other primitives that already implement a UV-mapping callback for reference.<br />
<br />
References:<br />
* http://en.wikipedia.org/wiki/UV_mapping<br />
* src/librt/primitives/[PRIMITIVE]/[PRIMITIVE].c, read the rt_*_uv() function<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... UV-mapping for extruded sketches (EXTRUDE) ====<br />
<br />
Code:<br />
* src/librt/primitives/extrude/extrude.c<br />
* src/librt/primitives/table.c<br />
* include/rtgeom.h<br />
<br />
|}<br />
&nbsp;<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Implement a platform independent re-entrant sort function ===<br />
<br />
The classic C library qsort() does not support a context parameter. A work around is to store the context information in a static variable. However, this solution is not thread save and may result in unpredictable behavior.<br />
<br />
There are platform specific sort functions qsort_r() in incompatible versions for BSD and GNU and qsort_s() for MSVC. Your task is to implement a bu_sort() function for BRL-CAD which is platform independent.<br />
<br />
Code:<br />
* src/libbu/sort.c<br />
<br />
The new sort function could look like this:<br />
void bu_sort(genptr_t array, size_t nummemb, size_t sizememb, int (*compare)(const_genptr_t, const_genptr_t, genptr_t), genptr_t context);<br />
|}<br />
&nbsp;<br />
<br />
----<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Solve fonts related bug in new wiki theme ===<br />
<br />
BRL-CAD has been working on a new incarnation of the website and has developed a new wiki theme and wordpress theme. Wiki theme uses a font called 'open-sans' from google fonts directory. It's linked via CSS but it does not get loaded (we still see default serif all over the place). So your task will be to debug the CSS code and get Open Sans loaded. <br />
<br />
Links:<br />
*http://beta.brlcad.org/wiki/Main_Page<br />
<br />
&nbsp;<br />
<br />
----<br />
<br />
|}<br />
&nbsp;<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Better placement of icons in wiki theme ===<br />
<br />
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.<br />
<br />
Links:<br />
*http://beta.brlcad.org/wiki/Main_Page<br />
<br />
&nbsp;<br />
<br />
----<br />
|}<br />
<br />
== Documentation and Training ==<br />
----<br />
''Tasks related to creating/editing documents and helping others learn more about BRL-CAD''<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Add missing documentation (for any ONE command) ===<br />
<br />
BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented:<br />
<br />
a-d archer asc2g asc2pix bot-bldxf bottest brep_cube brep_simple brickwall btclsh burst bw-a bw-d bwish c-d chan_add clutter contours d-a damdf dauto dauto2 d-bw dconv ddisp d-f dfft d-i dmod double-asc dpeak dsel dsp_add dstat d-u dwin euclid_format euclid_unformat fbgammamod f-d fence fhor f-i g-adrt g-euclid1 g-jack globe g-off i-a i-d i-f ihist imod istat jack-g kurt lowp molecule nmgmodel nmg-sgp off-g pipe pipetest pix2g pix3filter pixcount pixelswap pixembed pixfields pixfieldsep pixflip-fb pixpaste pix-spm pix-yuv plstat pyramid rawbot remapid rlesortmap rletovcr room rtcell rtexample rtfrac rtrad rtsil rtsrv script-tab sketch solshoot sphflake spltest spm-fb ssampview syn tea tea_nmg testfree texturescale torii ttcp tube txyz-pl u-a u-bw u-d u-f umod ustat vcrtorle vegitation wall wdb_example xbmtorle xyz-pl yuv-pix<br />
<br />
This task involves writing basic documentation for '''JUST ONE''' of those commands in the Docbook XML format. The command documentation should provide a one-sentence description, a detailed paragraph description (200+ words), explanation of '''all''' available command-line options, and one or more examples on how to use the command. <br />
<br />
Code:<br />
* doc/docbook/system/man1/en/Makefile.am<br />
* doc/docbook/system/man1/en/*.xml<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write an article "BRL-CAD for dummies" ===<br />
<br />
Although BRL-CAD has extensive documentation, still it needs a short and simple document which is particularly built for dummies.<br />
<br />
This task involves writing a article named '''BRL-CAD for dummies'''. This article should start with the installation process, if there is any existing installation guide for dummies, provide a link to it. The main motive of this article to empower dummy to make his/her first model using BRL-CAD. One thing to be kept in mind while writing this article is that this article is mainly concentrated for dummies. So use simple language to an extent and if you need to mention some technical term, first explain that term.<br />
<br />
The output of this task can be a pdf, html, doc, odt or any other document file that contains this article. Go through the link provided. Use screenshots and images to make it look attractive so that the reader is not bored.<br />
<br />
Reference:<br />
* http://brlcad.org/wiki/Documentation<br />
<br />
|}<br />
<br />
&nbsp;<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Translate "Contributors Guide To BRL-CAD" To Any Language ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
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<br />
<br />
* Feature Overview<br />
* Working with our Code<br />
* What code to work on<br />
* How to contribute<br />
* .... (Just to name a few )<br />
<br />
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.<br />
<br />
Reference:<br />
* http://en.flossmanuals.net/_booki/contributors-guide-to-brl-cad/contributors-guide-to-brl-cad.pdf<br />
<br />
|}<br />
<br />
&nbsp;<br />
<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Write a "BRL-CAD Commands Quick Reference" document ===<br />
<br />
There is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands.<br />
<br />
This task involves writing a quick reference document similar to [http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf the MGED quick reference] but for BRL-CAD commands. The sheet should minimally include the following commands:<br />
<br />
mged, rt*, *-g, g-*, fb*, *fb, nirt, remrt, rtsrv, asc2g, g2asc, dbupgrade, pix*, *pix, *-*, brlman, benchmark<br />
<br />
References:<br />
* http://brlcad.org/wiki/Documentation<br />
* http://brlcad.org/w/images/5/52/MGED_Quick_Reference_Card.pdf<br />
* [http://appletree.or.kr/quick_reference_cards/CVS-Subversion-Git/git-cheat-sheet-large.png git example]<br />
* [http://www.stdout.org/~winston/latex/latexsheet-0.png latex example]<br />
* [http://img.docstoccdn.com/thumb/orig/524314.png another example]<br />
* [http://www.inmensia.com/files/pictures/internal/CheatSheetDrupal4.7.png drupal example]<br />
* [http://www.phpmagicbook.com/wp-content/uploads/2010/06/php-reference-card.jpg php example]<br />
<br />
|}<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Doxygen cleanup ===<br />
<br />
BRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output.<br />
<br />
This task involves cleaning up the Doxygen comments in the library so that useful reports and API documentation automatically generated (correctly, completely, and cleanly). Verify/fix any Doxygen syntax. Verify/fix groups so that functions are organized neatly and all contained within a group. Provide patches that give clean (PDF) output from Doxygen.<br />
<br />
References:<br />
* http://www.jiggerjuice.net/software/doxygen.html<br />
* http://www.stack.nl/~dimitri/doxygen/starting.html<br />
* http://www.stack.nl/~dimitri/doxygen/<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBBU ====<br />
<br />
There are approximately 300 documented API function calls in LIBBU.<br />
<br />
Code:<br />
* include/bu.h<br />
* src/libbu<br />
* misc/Doxyfile<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBWDB ====<br />
<br />
There are approximately 100 documented API function calls in LIBWDB. <br />
<br />
Code:<br />
* include/wdb.h<br />
* include/raytrace.h<br />
* src/libwdb<br />
* misc/Doxyfile<br />
<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... doxygen cleanup for LIBRT ====<br />
<br />
There are approximately 1000 documented API function calls in LIBRT. <br />
<br />
Code:<br />
* include/raytrace.h<br />
* src/librt<br />
* src/librt/primitives<br />
* src/librt/comb<br />
* src/librt/binunif<br />
* misc/Doxyfile<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write up Wiki page tutorial on our Volumetric Primitive ===<br />
<br />
BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.<br />
<br />
This task involves writing up a page on the VOL primitive. Figure out how to use it (see the "in" command), create an example input data set, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:<br />
<br />
References:<br />
* http://brlcad.org/wiki/DSP<br />
* http://brlcad.org/wiki/Sketch<br />
* http://brlcad.org/wiki/EBM <-- particularly useful as the data is similar for VOL<br />
<br />
Show how to create a VOL with at least two layers/slices. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/VOL<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Write a wiki tutorial on how to create a polygonal mesh (NMG) manually ===<br />
<br />
BRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them.<br />
<br />
This task involves writing up a page on the NMG polygonal mesh primitive. Figure out how to use it (not a simple task, will require some trial and error), create an example input, and write up a wiki page on exactly what steps are needed similar to our other wiki pages:<br />
<br />
References:<br />
* http://brlcad.org/wiki/DSP<br />
* http://brlcad.org/wiki/EBM<br />
* http://brlcad.org/wiki/Sketch <-- particularly useful as neither NMG nor sketch are meant to be created manually<br />
<br />
Note the "facetize" command in mged will convert an existing object into NMG format. The get/put commands should help from there like the sketch tutorial.<br />
<br />
Show how to create an NMG cube or wedge or similar simple shape. Include images like the other examples. Put the write-up at http://brlcad.org/wiki/NMG<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents) ===<br />
<br />
The majority of BRL-CAD's documentation is defined as DocBook files, from which other formats (HTML, PDF, man page, etc.) can be generated. PDF files present a particular challenge, and have some very specific requirements to achieve "good" formatting.<br />
<br />
BRL-CAD's DocBook files need to uniformly use a style of image inclusion that is aware of what "role" the image is supposed to serve. A "basic" image inclusion example looks like this:<br />
<br />
<mediaobject><br />
<imageobject><br />
<imagedata align="center" fileref="../../lessons/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<nowiki><caption></nowiki><br />
<para><br />
Caption goes here.<br />
</para><br />
</caption><br />
</mediaobject><br />
<br />
This task involves switching image inclusions that use the above style to something like the following:<br />
<br />
<mediaobject><br />
<imageobject role="html"><br />
<imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<imageobject role="fo"><br />
<imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/><br />
</imageobject><br />
<nowiki><caption></nowiki><br />
<para><br />
Caption goes here.<br />
</para><br />
</caption><br />
</mediaobject><br />
<br />
The "role" flag to imageobject provides the opportunity to specify different image formatting options when the output is HTML (role="html") or PDF (role="fo").<br />
<br />
The captions should be preserved as above on mediaobjects that have them, but mediaobjects without a caption should also be converted and there is no need to add a caption in such cases.<br />
<br />
Any patch that makes changes to the DocBook sources should result in a successful "make doc" build test. This won't generate PDF documents, but it will validate the XML files and produce HTML - remember that introducing breakage means the patch won't be accepted.<br />
<br />
Remember, the tasks are simply to do the above conversion for all images in the file or files, not to introduce PDF specific formatting. Formatting fixes will be needed, but they are very much "case by case" and will take both additional time and a working Apache FOP installation, as well as knowledge of how to enable PDF generation. If all image inclusions have been converted successfully and a student is interested in actually fixing the formatting, please discuss it with us on IRC or the mailing list.<br />
<br />
References:<br />
* doc/docbook/books/en/BRL-CAD_Tutorial_Series-VolumeIII.xml<br />
<br />
Code:<br />
* doc/docbook<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Make a step by step tutorial for creating BRL-CAD model ===<br />
<br />
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. <br />
<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Find 5 bugs in OGV ===<br />
<br />
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. <br />
<br />
Links:<br />
https://github.com/BRL-CAD/OGV-meteor/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Find 5 coding guidelines violations in OGV ===<br />
<br />
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. <br />
<br />
Links:<br />
https://github.com/BRL-CAD/OGV-meteor/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
----<br />
<br />
==Outreach and Research ==<br />
----<br />
''Tasks related to community management, outreach/marketing, studying problems, and recommending solutions''<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Profile NURBS prep performance ===<br />
<br />
BRL-CAD implements support for rendering of NURBS representation geometry. If you import a solid 3DM or STEP format model into BRL-CAD, it will import as BREP/NURBS geometry. Opening that geometry in BRL-CAD's MGED editor will tell you what objects are available and our 'rt' tool will raytrace it. When geometry is ray traced, it first goes through a "prep" phase and then it starts shooting rays. Our prep phase is entirely unoptimized so we'd like to know where all the time is presently being spent during prep..<br />
<br />
This task involves importing some NURBS geometry into BRL-CAD and ray tracing that geometry with a profiler watching our prep performance. Any profiler will do, including gprof, but a performance monitor like oprofile or the Mac "Instruments" application (or Shark) are preferred.<br />
<br />
Learning how to use a profiler is beyond the scope of this task, so it make take you considerably longer to provide us with useful information if you've never run a profiler before.<br />
<br />
To capture prep performance, you will need to import some fairly complex geometry. You should be able to search google with "filetype:3dm" or "filetype:step" or find something on grabcad.com to import<br />
<br />
Running "tops" within mged will tell you what geometry is available for rendering.<br />
<br />
Running "rt -o file.png -s32" on the system command line (not inside mged) should minimize the ray overhead or you can specifically isolate the prep phase we care about. Prep is the time between when rt is run where it opens a window until the first pixels are fired and pixels start filling in.<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Continue investigating GMP integration ===<br />
<br />
BRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this work on. This task is a continuation of a prior GCI task (read it in full!):<br />
<br />
http://www.google-melange.com/gci/task/view/google/gci2012/7946218<br />
<br />
This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic.<br />
<br />
Building on the previous GCI task work, take it to the next step. Try setting a vector to 1/3, 1/3, 1/3 and 0.1, 0.1, 0.1 and get proper values to print. Change the V3ARGS() macro if needed. If that all works, try to get bn_dist_pt3_pt3() to work. Report and discuss your progress.<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a T-Shirt for BRL-CAD ===<br />
<br />
This task involves designing a T-Shirt for BRL-CAD. Use your designing skills to design a T-Shirt for BRL-CAD. You can use the current BRL-CAD logo, or you may tweak it. Be creative while designing this T-Shirt. It would be good if the design has some special meaning.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a coffee mug for BRL-CAD ===<br />
<br />
This task involves designing a coffee mug for BRL-CAD. Make it look good, so that one can use it while working on BRL-CAD. Look over some great coffee mug designs before starting to work on this. It would be great if the design on coffee mug has some special meaning.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design BRL-CAD sticker ===<br />
<br />
This task involves designing a BRL-CAD sticker. The design should be simple and sleek. The concept of sticker should be clear and also it should be creatively presented. Get inspired from some sticker designs but choose your own imagination while designing the sticker. There is no bound for shape of sticker, it can be rectangular, circular or even irregular. The only thing that matters is that it should look good.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design BRL-CAD phone/tablet back cover ===<br />
<br />
This task involves designing a BRL-CAD phone/tablet cover. <br />
While submitting your design, provide the sample phone cover, tablet cover with the design and rendered png or jpg image of the sticker design. Try to have a special meaning of design, and the concept should be creatively illustrated.<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a wallpaper set for BRL-CAD ===<br />
<br />
This task involves designing a set of wallpapers for BRL-CAD. The central idea of each wallpaper should represent any feature of BRL-CAD. Try to design a minimum of 5 wallpapers but if you have more than 5 designs than you are welcomed. <br />
<br />
Try to different resolutions of each wallpaper.<br />
<br />
Check the following wallpapers for inspiration.<br />
* http://www.smashingmagazine.com/tag/wallpapers/<br />
<br />
Logo References<br />
* http://brlcad.org/images/angelov_256.png<br />
* http://brlcad.org/d/node/92<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create Iron Man Arc Reactor Model in BRL-CAD ===<br />
<br />
This task involves creating Arc Reactor as seen in hollywood movie Iron-Man. You will have to create two versions of the Arc Reactor one glowing and another non glowing. <br />
<br />
Check this model for inspiration<br />
* http://grabcad.com/library/iron-man-arc-reactor-request<br />
<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Tweak BRL-CAD logo to wish New Year ===<br />
<br />
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.<br />
Make sure this tweak should be tweaked version of current logo and not entirely new logo.<br />
<br />
Tip: Search for some global events occurring in 2015 and design accordingly. Also keep the letters 2,0,1,5 in mind while designing. ;)<br />
<br />
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.<br />
<br />
Gallery of all google doodles<br />
* http://www.google.com/doodles<br />
<br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Tweak BRL-CAD logo to wish Merry Christmas ===<br />
<br />
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.<br />
Make sure the output of this task should be tweaked version of current logo and not entirely new logo.<br />
<br />
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.<br />
<br />
Gallery of all google doodles<br />
* http://www.google.com/doodles<br />
<br />
<br />
|}<br />
<br />
----<br />
<br />
== Quality Assurance ==<br />
----<br />
''Tasks related to testing and ensuring code is of high quality''<br />
<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix single-precision floating point crash ===<br />
<br />
By default, all of BRL-CAD compiles using double-precision floating point arithmetic. We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point. This compilation mode was recently cleaned up and tested, but a bug was found. The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool.<br />
<br />
To compile in single precision, edit the include/bn.h header file and change the fastf_t typedef from double to float. To reproduce the bug, compile BRL-CAD and write this out to a text file named star.view:<br />
<br />
viewsize 2.500000000e+05;<br />
eye_pt 2.102677960e+05 8.455500000e+04 2.934714650e+04;<br />
viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00<br />
5.539599410e-01 4.823888300e-02 8.311441420e-01 0.000000000e+00<br />
4.896120540e-01 7.885590550e-01 -3.720948210e-01 0.000000000e+00<br />
0.000000000e+00 0.000000000e+00 0.000000000e+00 1.000000000e+00 ;<br />
start 0;<br />
end;<br />
<br />
Then run rt feeding it that view script as input. This is an example how to run within the gdb debugger:<br />
gdb path/to/bin/rt<br />
...<br />
(gdb) run -F/dev/X -M .cmake/share/db/star.g all < star.view<br />
<br />
At this point, rt should crash due to an infinite recursion. A backtrace in the debugger will show lots and lots of calls to rt_shootray() and light_hit().<br />
<br />
This task involves investigating and preventing the crash. Provide a patch that fixes the bug.<br />
<br />
References:<br />
* man gdb<br />
* brlman rt<br />
<br />
Code:<br />
* src/librt/shoot.c<br />
* src/liboptical/sh_light.c<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Fix closedb ===<br />
<br />
BRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file. While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications. However, at some point in the recent past, the ''closedb'' command was horked. It's undoubtedly something very simple but we haven't bothered to look due to other priorities. You can fix it. If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb:<br />
<br />
mged> opendb test.g y<br />
mged> make sph sph<br />
mged> l sph<br />
mged> closedb<br />
mged> make sph sph<br />
mged> opendb test.g<br />
mged> l sph<br />
mged> exit<br />
<br />
Provide a patch that fixes the bug or tell us which SVN revision introduced the bug. Make sure you can reproduce the bug before claiming this task, which presumes you know how to download/install BRL-CAD from a source distribution.<br />
<br />
Code:<br />
* src/mged/mged.c<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create a utility library (LIBBU) API unit test ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
References:<br />
* include/bu.h<br />
* src/libbu/*.c<br />
* src/libbu/tests/*.c<br />
<br />
Code:<br />
* src/libbu/tests/[TEST].c<br />
* src/libbu/tests/CMakeLists.txt<br />
<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit test for LIBBU bomb.c ====<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Create Numerics library (LIBBN) API unit tests ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
References:<br />
* include/bn.h<br />
* include/plot3.h<br />
* include/vmath.h<br />
* src/libbn/*.c<br />
* src/libbn/tests/*.c <-- check this directory for examples<br />
* src/libbu/tests/*.c <-- Note: Also check this too for more examples.<br />
<br />
Code:<br />
* src/libbn/tests/[TEST].c<br />
* src/libbn/tests/CMakeLists.txt<br />
<br />
<b> Note </b><br />
A valid task will constitute writing a basic test for each function in the following libbn/ files.<br />
<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN anim.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
*Useful resources<br />
->coming!<br />
<br />
==== ... unit tests for LIBBN axis.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN qmath.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
<br />
*Useful links and Resources<br />
-> Coming!<br />
<br />
==== ... unit tests for LIBBN rand.c ====<br />
|}<br />
&nbsp;<br />
{| cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
==== ... unit tests for LIBBN vector.c ====<br />
|}<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
*Useful links and resources<br />
-> To be added.<br />
<br />
=== Find, reliably reproduce, and report any bug in Archer ===<br />
<br />
Archer is our new modeling interface and a soon to merge with our long-standing MGED geometry editor. It undoubtedly has bugs. It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions. Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly. You will have to explore the tool with minimal documentation.<br />
<br />
This task involves filing a bug report with verifiable and reproducible steps that clearly demonstrate the bug. It can't be a bug already reported or otherwise documented nor can it be merely behavior you don't like.<br />
<br />
References:<br />
* archer<br />
* Introduction to MGED at http://brlcad.org/wiki/Documentation (many of the mged commands are available in some fashion within archer) <br />
* BUGS file in any source/binary distribution<br />
* http://sourceforge.net/tracker/?atid=640802&group_id=105292&func=browse<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Reproduce any 10 unconfirmed open bug reports ===<br />
<br />
BRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned. Read the comments and status to see if the bug has been confirmed/reproduced. <br />
<br />
This task involves going through those reports and REPRODUCE at least 10 of the ones that have not been confirmed. When you can reproduce the issue being reported, you'll comment on the thread to state as much and attach any data you used to reproduce the crash.<br />
<br />
References:<br />
* https://sourceforge.net/tracker/?limit=100&func=&group_id=105292&atid=640802&assignee=100&status=1&submit=Filter<br />
|}<br />
<br />
<br />
----<br />
<br />
== User Interface ==<br />
----<br />
''Tasks related to user experience research or user interface design and interaction''<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create an ISST screenshot or animation ===<br />
<br />
Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have.<br />
<br />
Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail.<br />
<br />
References:<br />
* http://brlcad.org/gallery/d/19-4/MGED.jpg<br />
* https://brlcad.org/tmp/archer.png<br />
* https://brlcad.org/gallery/index.php?/category/12<br />
* http://www.google-melange.com/gci/task/view/google/gci2012/8019211<br />
<br />
Note that we have several screenshot tasks. Note you may have to go through some or our basic MGED tutorials (see docs section on our website) just to be able to display geometry. Finally, give others a chance if you already completed one of the other screenshot tasks. ;)<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Categorize all of BRL-CAD's commands into a spreadsheet ===<br />
<br />
BRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more. There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together.<br />
<br />
This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command.<br />
<br />
References:<br />
* A spreadsheet template will be provided.<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Design a Cover Photo for Facebook page (and other social networks) ===<br />
<br />
BRL-CAD got it's logo changed, and it's website is undergoing a change. So this re-branding of BRL-CAD also requires a good, well designed and attractive cover photo for the BRL-CAD's Facebook page or other Social Media Appearances. It should feature a good tagline telling some killer feature of BRL-CAD, BRL-CAD's new logo and/or some illustration/image regarding the feature highlighted in tagline.<br />
<br />
It should be consistent with the color scheme of our new website design.<br />
<br />
New website design <br />
*http://cpp-tricks.com/brlcad/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
<br />
=== Design a banner ad for BRL-CAD ===<br />
<br />
BRL-CAD is one of the oldest open source communities. This community has a good following, so we want to give a chance to everyone so that they can show their support to the community by adding a banner ad in their website. You have to create a banner ad that can be embedded in the website by copy pasting some simple lines of code (basically an iframe). <br />
<br />
Such a banner ad can also be used in various sections of our own website. <br />
<br />
The task requires you to create a CSS3 based animated horizontal and vertical banner add, highlighting some feature of BRL-CAD or making some call to action. This call to action can be joining mailing list, or signing up for community, or link to latest post etc. <br />
<br />
For Inspiration and tutorial refer<br />
*http://tympanus.net/Tutorials/AnimatedWebBanners/<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Creating Motion Typography video for BRL-CAD ===<br />
<br />
BRL-CAD has a lot of great features that can be highlighted. A motion typography video highlighting these features would be a wonderful addition to the front page of website. <br />
<br />
This task requires you to create a motion typography video that will convince user to give BRL-CAD a try, it could be titled something like "x reasons to choose BRL-CAD" or anything similar (give your creative minds a flight). The video should not be more than 2 minutes. <br />
<br />
For inspiration about what a motion typography, see<br />
*http://vimeo.com/24715531<br />
<br />
|}<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Create a screen-cast for BRL-CAD ===<br />
<br />
Getting started with BRL-CAD is sometimes not so smooth. A screen-cast giving a tour of BRL-CAD's GUI and the steps involved in creating the first model will make it easy for users to get started. <br />
<br />
For this task you need to install BRL-CAD on your computer. Create a very basic model in it and record your screen as you create the model. It should also give a tour of BRL-CAD's workspace. You can choose model of your choice. Keep something very basic and easy for the first time users. <br />
<br />
|}<br />
<br />
<br />
&nbsp;<br />
{| style="background-color:#ffffff;" cellpadding="20" cellspacing="0" border="2" width="100%"<br />
|<br />
=== Loading Google charts from API ===<br />
<br />
A basic wrapper of GCharts has been implemented a while ago : https://bitbucket.org/suryajith/benchmark/src/a27dd8c05d6819a527650e06a63076599d2e0d66/libs/charting.py?at=default With the google charts improving their API system which wasn't around then, see if the code could be optimized so to get the charts the optimal way.<br />
<br />
Reference: <br />
*https://developers.google.com/chart/interactive/docs/index<br />
<br />
<br />
|}<br />
<br />
=== Design a hall of fame for BRL-CAD developers ===<br />
<br />
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. <br />
<br />
Links: <br />
* http://cpp-tricks.com/brlcad/<br />
* http://underscores.me/<br />
<br />
<br />
|}<br />
----<br />
<br />
= When You're Done =<br />
----<br />
<br />
For non-code, just send us your file(s). For code changes, you will be expected to [[Patches|provide a patch file]]. Make sure you ''read'' your patch file before submitting it. Make sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:<br />
<br />
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit<br />
cd brlcad.edit<br />
# make changes<br />
svn diff > ~/my.patch<br />
# read ~/my.patch file with text editor<br />
cd ..<br />
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh<br />
cd brlcad.fresh<br />
patch -p0 < ~/my.patch<br />
# submit your patch file to our patches tracker<br />
&nbsp;</div>Vikram Atreya