Developer hub/sv: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
(9 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{TOCright}} |
|||
[[Image:Crystal_Clear_app_tutorials.png| |
[[Image:Crystal_Clear_app_tutorials.png|64px]] |
||
---- |
|||
This is the place to come if you want to contribute to the development of the FreeCAD software. |
This is the place to come if you want to contribute to the development of the FreeCAD software. |
||
Line 18: | Line 19: | ||
* [[Compile_on_Linux|Compiling on Linux]] |
* [[Compile_on_Linux|Compiling on Linux]] |
||
* [[Compile_on_MacOS|Compiling on MacOS]] |
* [[Compile_on_MacOS|Compiling on MacOS]] |
||
* [[ |
* [[License|License details]] about the FreeCAD licences |
||
* [[Third Party Libraries|Third Party Libraries]] |
* [[Third Party Libraries|Third Party Libraries]] |
||
* [[Third Party Tools|Third Party Tools]] |
* [[Third Party Tools|Third Party Tools]] |
||
Line 39: | Line 40: | ||
* The [[FreeCAD Build Tool|FreeCAD Build Tool]] |
* The [[FreeCAD Build Tool|FreeCAD Build Tool]] |
||
** [[ |
** [[Workbench_creation|Adding an application module]] to FreeCAD |
||
* [[Debugging|Debugging]] FreeCAD |
* [[Debugging|Debugging]] FreeCAD |
||
* [[Testing|Testing]] FreeCAD |
* [[Testing|Testing]] FreeCAD |
||
Line 57: | Line 58: | ||
* [[Google Summer of Code|Google Summer of Code]] get involved via Google's student support program |
* [[Google Summer of Code|Google Summer of Code]] get involved via Google's student support program |
||
* [[Fine-tuning|Fine-tuning]] shows different options and parameter switches that can overcome problems |
* [[Fine-tuning|Fine-tuning]] shows different options and parameter switches that can overcome problems |
||
* [[Wrapping_a_Cplusplus_class_in_Python|Wrapping a C++ class in Python]] shows how to create the Python wrapper for a C++ class |
|||
* [[NewFeatureCheckList_C++|Checklist for adding a Feature to a C++ workbench]] provides an aid for contributors. |
|||
* [[Translating an external workbench|Translating an external workbench]] |
* [[Translating an external workbench|Translating an external workbench]] |
||
Line 91: | Line 94: | ||
==== File format ==== |
==== File format ==== |
||
[[File_Format_FCStd|File Format FCStd]]. The files created with FreeCAD are {{incode|.zip}} files that include the BREP geometry, as well as XML data that describes the document. |
[[File_Format_FCStd|File Format FCStd]]. The files created with FreeCAD are {{incode|.zip}} files that include the [https://en.wikipedia.org/wiki/Boundary_representation BREP] geometry, as well as XML data that describes the document. |
||
==== Sketcher solver ==== |
==== Sketcher solver ==== |
||
Line 108: | Line 111: | ||
to reach a state where we can compete with commercial software. |
to reach a state where we can compete with commercial software. |
||
[[ |
[[FreeCAD_1.0_Development_Cycle|FreeCAD 1.0 Development Cycle]] |
||
== Community == |
== Community == |
||
* [ |
* [ircs://irc.libera.chat:6697/freecad IRC channel] ,synchronized with [https://gitter.im/FreeCAD/FreeCAD gitter channel] |
||
* [https://forum. |
* [https://forum.freecad.org/viewforum.php?f=6 Development forum] |
||
* [[Development roadmap|Development roadmap]] |
* [[Development roadmap|Development roadmap]] |
Latest revision as of 16:24, 4 April 2024
This is the place to come if you want to contribute to the development of the FreeCAD software.
These pages are in the early stage of development. If you can't find the information you are looking for, or have found useful information somewhere we have not linked to, then please leave a comment on the forum and someone will look into it (or, if you are feeling bold, why not edit this page directly!).
Developer Documentation
The developer documentation comprises the following sections:
Compiling FreeCAD
- Github repo. If you are new to git, read Source code management
- Compile with Docker
- Compiling on Windows
- Compiling on Linux
- Compiling on MacOS
- License details about the FreeCAD licences
- Third Party Libraries
- Third Party Tools
- Start up and Configuration
- Source documentation
- Use the bug tracker when you have a problem or think you may have found a bug
Packaging
Packaging consists in taking the compiled binaries and Python source files of FreeCAD, and distributing them for use in a particular system.
Build Support Tools
- The FreeCAD Build Tool
- Adding an application module to FreeCAD
- Debugging FreeCAD
- Testing FreeCAD
- Compiling (Speeding up) FreeCAD
- Continuous Integration
Modifying FreeCAD
- Understanding The FreeCAD source code
- Submitting patches
- Add Features to FreeCAD or a Workbench
- Branding or how to give FreeCAD a unique look
- Artwork we made for FreeCAD, that you can freely reuse
- Artwork guidelines standards for icons
- Translating FreeCAD
- Extra python modules, or how to extend python functionality within FreeCAD
- Google Summer of Code get involved via Google's student support program
- Fine-tuning shows different options and parameter switches that can overcome problems
- Wrapping a C++ class in Python shows how to create the Python wrapper for a C++ class
- Checklist for adding a Feature to a C++ workbench provides an aid for contributors.
Module developer's guide
FreeCAD Mod Dev Guide: This is an ebook under writing on github, please fork and send pull request to contribute.
Chapters:
- Overview and Software Architecture
- Source code structure
- Base and App module
- Gui module
- Python wrapping
- Modular design
- Fem module source analysis (mixed C++ and Python)
- Development of CFD Module (pure Python)
- Module testing and debugging
- Contribute code with git
Latest pdf preview can be downoaded from pdf folder of this git repo
Internals
OpenCascade Documentation
OpenCascade is a software development platform for 3D surface and solid modeling, CAD data exchange, and visualization, mostly in the form of C++ libraries.
- Roman Lygin's tutorials
- Full Online Documentation
- Reference Manual
- The openCascade wiki (currently containing ?? Chinese spam)
File format
File Format FCStd. The files created with FreeCAD are .zip
files that include the BREP geometry, as well as XML data that describes the document.
Sketcher solver
- Sketcher Solver Architecture Booklet (forum thread), source in GitHub.
- PlaneGCS solver in the FreeCAD source code; important files are GCS.cpp and SubSystem.cpp.
- Recent Several Sketcher improvements.
The sketcher solver isn't perfect, as there are some issues with numerical precision when using large values, see Adventure of fixing sketcher solver for large sketches.
The development of a new solver architecture could improve the way the solver is used both in the Sketcher Workbench, and for assembly of 3D bodies. See Reimplementing constraint solver.
Roadmap
FreeCAD, though usable in certain areas, is at the beginning of a long way into the CAD mainstream. There is still a lot to do to reach a state where we can compete with commercial software.
Community
- IRC channel ,synchronized with gitter channel
- Development forum
Credits
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub