Release notes 0.19/it: Difference between revisions

From FreeCAD Documentation
(Created page with "== App::Link e assemblaggio ==")
(Updating to match new version of source page)
(26 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{VeryImportantMessage|This page tracks new features as they are added to the development version of FreeCAD, which is currently 0.19. When the 0.19 feature freeze happens, delete these messages, and don't add more features to this page. FreeCAD 0.19 is expected to be released in 2020.}}
{{VeryImportantMessage|This page tracks new features as they are added to the development version of FreeCAD, which is currently 0.19. When the 0.19 feature freeze happens, delete these messages, and don't add more features to this page. FreeCAD 0.19 is expected to be released in 2020.}}

<div style="text-align:center; background:#e0e0ee; margin:1em 7em; padding:0.5em 2em; border:2px solid #bb7736;">
<div style="text-align:center; background:#e0e0ee; margin:1em 7em; padding:0.5em 2em; border:2px solid #bb7736;">
Are features missing? Mention them in the [https://forum.freecadweb.org/viewtopic.php?f=10&t=34586 Release notes for v0.19] forum thread.
Are features missing? Mention them in the [https://forum.freecadweb.org/viewtopic.php?f=10&t=34586 Release notes for v0.19] forum thread.


See [[Help FreeCAD]] for ways to contribute to FreeCAD.</div>
See [[Help FreeCAD]] for ways to contribute to FreeCAD.</div>
{{TOCright}}

'''FreeCAD 0.19''' was released on '''DD Month 2020''', get it from the [[Download|Download]] page. This is a summary of the most interesting changes. The complete list of changes can be found in the [https://www.freecadweb.org/tracker/changelog_page.php?version_id=78 MantisBT bugtracker FC 0.19 changelog].
'''FreeCAD 0.19''' was released on '''DD Month 2020''', get it from the [[Download|Download]] page. This is a summary of the most interesting changes. The complete list of changes can be found in the [https://www.freecadweb.org/tracker/changelog_page.php?version_id=78 MantisBT bugtracker FC 0.19 changelog].


Line 16: Line 17:
== Punti salienti ==
== Punti salienti ==


<!-- These are highlight images therefore they must appear big, and not the same size as the other images. -->
[[File:FreeCAD_highlight_1_0.19.jpg|384px]]
<!-- Extra spacing is added between the images-->
{| cellpadding=5
| [[File:FreeCAD_highlight_1_0.19.jpg|512px]]
| Horizontal 4 cylinder rotary valve steam engine, by "un1corn", [https://forum.freecadweb.org/viewtopic.php?f=24&t=38602 Users Showcase].
|}


''Horizontal 4 cylinder rotary valve steam engine, by "un1corn", [https://forum.freecadweb.org/viewtopic.php?f=24&t=38602 Users Showcase].''


<div class="mw-translate-fuzzy">
[[File:FreeCAD_highlight_2_0.19.png|384px]]
[[File:FreeCAD_highlight_2_0.19.png|384px]]
</div>


This assembly was made by "Zolko", author of the new [[Assembly4_Workbench|Assembly4 Workbench]], which uses the new powerful [[App_Link|App Link]] object to import thousands of different parts and subassemblies, arranging them in specified positions by means of mathematical expressions. See [https://forum.freecadweb.org/viewtopic.php?f=24&t=42624 Users Showcase].
''Add a high quality image here that highlights a development in FreeCAD 0.19, with its author, and link to the image's origin.''


For this model, the parts were not designed in FreeCAD, they were just imported in STEP format, and subsequently arranged with Assembly4.
[[File:FreeCAD_highlight_3_0.19.png|384px]]
|}


''Add a high quality image here that highlights a development in FreeCAD 0.19, with its author, and link to the image's origin.''


{| cellpadding=5
[[File:FreeCAD_highlight_4_0.19.png|384px]]
| [[File:FreeCAD_highlight_3_0.19.jpg|512px]]
| Constant velocity joint M. GECIK, by user "ppemawm", see [https://forum.freecadweb.org/viewtopic.php?f=20&p=379220#p377075 Users Showcase]. The model is reversed engineered from the individual STL files from Thingiverse by the original author, [https://www.thingiverse.com/thing:4191753 NOP21]. Please notice the license of the original files.


The STL files were downloaded, saved, and imported into FreeCAD, and they were manually assembled using the [[Std_Transform|Std Transform]] tool; this [[mesh|mesh]] [[assembly|assembly]] was used as reference to create solid [[Body|bodies]] with [[PartDesign_Workbench|PartDesign]] and subsequently assemble them using the new [[Assembly4_Workbench|Assembly4 Workbench]].
''Add a high quality image here that highlights a development in FreeCAD 0.19, with its author, and link to the image's origin.''

The model was started with Assembly4, and each part was created in-context referencing the STL model for [[sketch|sketch]] dimensions; sketches were created 1:1 scale with the STL model in the background.
|}

{| cellpadding=5
| [[File:FreeCAD_highlight_4_0.19.png|512px]]
| The [[File:Workbench_TechDraw.svg|24px]] [[TechDraw_Workbench|TechDraw Workbench]], which replaced the [[File:Workbench_Drawing.svg|24px]] [[Drawing_Workbench|Drawing Workbench]] in [[Release_notes_0.17|v0.17]], has been upgraded in an important way. It has many new features with respect to [[Release_notes_0.18|v0.18]], which make it much more useful to produce technical illustrations of 3D solids.

Among many small improvments, new features include: dimensions are now compliant with one of ISO 129-1 or ASME Y14.5M standards; new [[TechDraw_Balloon|balloon annotations]] to include text inside a circle or polygon shape; new [[TechDraw_RichTextAnnotation|rich text annotations]] to include big paragraphs formatted as bold or italic; [[TechDraw_CosmeticVertex|cosmetic vertices]] and [[TechDraw_FaceCenterLine|cosmetic edges]] that are not part of the original model but which can be used to create custom dimensions; basic support for [[TechDraw_WeldSymbol|welding symbols]]; new [[TechDraw_ActiveView|active view]] mode to take a "snapshot" of the [[3D_view|3D view]]; new basic templates for ISO sizes (A0 to A4), as well as Russian and Chinese language templates; new horizontal and vertical dimensions that measure the [[TechDraw_Dimension_Horizontal_Extent|full extent of the projections]]; SVG face hatches are now available when the page is exported to SVG; the new [[App_Link|App Link]] object is now also supported as a source for creating views, which is useful when working with [[assembly|assemblies]].
|}


== Aspetti generali ==
== Aspetti generali ==
Line 53: Line 72:
=== Sviluppo ===
=== Sviluppo ===


* New Libpack for Windows with Qt 5.12, OCC 7.3, and Python 3.6; [https://forum.freecadweb.org/viewtopic.php?f=4&t=35789 forum discussion].
* Merged QtWebEngine support; [https://github.com/FreeCAD/FreeCAD/pull/1937 pull request #1937].
* New Libpack for Windows with Qt 5.12, OCC 7.3 and Python 3.6; [https://forum.freecadweb.org/viewtopic.php?f=4&t=35789 forum discussion].
* New Libpack for Windows with Qt 5.12.6, OCC 7.4; [https://forum.freecadweb.org/viewtopic.php?f=4&t=42945 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2944 pull request #2944].
* There is a new Docker container to build FreeCAD, see [[Compile_on_Docker|Compile on Docker]]; [https://forum.freecadweb.org/viewtopic.php?f=4&t=42954 forum discussion].
* Added support for existing Python virtual environments; [https://github.com/FreeCAD/FreeCAD/pull/2021 pull request #2021].
* Fixed broken support for "INCH" units when exporting to STEP/IGES formats; [https://forum.freecadweb.org/viewtopic.php?f=22&t=36808&p=314172#p314172 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/1b2617358 commit 1b26173580].
* The infrastructure of the bug tracker as well as wiki was moved to a dedicated server, so that it is easier to manage by the project administrators; [https://forum.freecadweb.org/viewtopic.php?f=8&t=42795 forum discussion].
* Improved import/export compatibility with proprietary CAD systems, when using compressed STEP, or STPZ; [https://forum.freecadweb.org/viewtopic.php?f=3&t=37469 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2323 pull request #2323], [https://github.com/FreeCAD/FreeCAD/commit/7de89cf62e0411dcd commit 7de89cf62e].
* Pre-select name filter in the import/export dialog; [https://forum.freecadweb.org/viewtopic.php?f=3&t=8093 forum discussion], [http://github.com/FreeCAD/FreeCAD/commit/e239994 commit e239994],
* Fixed missing application ID and icon on GNOME/Wayland; [https://github.com/FreeCAD/FreeCAD/pull/2466 pull request #2466].


=== Documentazione ===
=== Documentazione ===


<div class="mw-translate-fuzzy">
* La pagina [[CompileOnUnix/it|Compilare su Unix]] è stata rivista per spiegare meglio i requisiti per compilare su diverse distribuzioni Linux. Poiché molti sviluppatori utilizzano sistemi basati su Debian, questa sezione ha ricevuto la massima attenzione. Gli utenti di altre distribuzioni Linux sono incoraggiati a mantenere la documentazione per la loro particolare distribuzione. Anche [[CompileOnWindows/it|Compilare su Windows]] è stato riscritto per spiegare come usare il LibPack per la compilazione.
* La pagina [[Compile_on_Linux/Unix/it|Compilare su Linux/Unix]] è stata rivista per spiegare meglio i requisiti per compilare su diverse distribuzioni Linux. Poiché molti sviluppatori utilizzano sistemi basati su Debian, questa sezione ha ricevuto la massima attenzione. Gli utenti di altre distribuzioni Linux sono incoraggiati a mantenere la documentazione per la loro particolare distribuzione. Anche [[CompileOnWindows/it|Compilare su Windows]] è stato riscritto per spiegare come usare il LibPack per la compilazione.
* La pagina [[Source code management/it|Documentazione del codice sorgente]] è stata ripulita per spiegare meglio come produrre la documentazione di programmazione (API) partendo da C++ e Python.
* La pagina [[Source code management/it|Documentazione del codice sorgente]] è stata ripulita per spiegare meglio come produrre la documentazione di programmazione (API) partendo da C++ e Python.
* La pagina [[Doxygen/it|Doxygen]] è stata rivista ed estesa per fornire maggiori dettagli sulla sintassi utilizzata nei file C++ per produrre la documentazione di programmazione.
* La pagina [[Doxygen/it|Doxygen]] è stata rivista ed estesa per fornire maggiori dettagli sulla sintassi utilizzata nei file C++ per produrre la documentazione di programmazione.
* Anche la pagina [[Source code management/it|Gestione del codice sorgente]] è stata rielaborata con descrizioni ed esempi migliori sull'uso di {{incode|git}} per gestire i rami e contribuire al codice.
* Anche la pagina [[Source code management/it|Gestione del codice sorgente]] è stata rielaborata con descrizioni ed esempi migliori sull'uso di {{incode|git}} per gestire i rami e contribuire al codice.
* La pagina [[External workbenches/it|Ambienti di lavoro esterni]] è stata riorganizzata, in modo da elencare tutti gli ambienti ricchi di funzionalità e disponibili al pubblico. Se si desideri aggiungere un workbench a questa pagina, comunicarlo nel forum e fornire le informazioni di supporto come il manuale dell'utente, le pagine wiki e un link al suo repository. Quindi spingere per includerlo in [[Addon Manager/it|Addon Manager]].
* La pagina [[External workbenches/it|Ambienti di lavoro esterni]] è stata riorganizzata, in modo da elencare tutti gli ambienti ricchi di funzionalità e disponibili al pubblico. Se si desideri aggiungere un workbench a questa pagina, comunicarlo nel forum e fornire le informazioni di supporto come il manuale dell'utente, le pagine wiki e un link al suo repository. Quindi spingere per includerlo in [[Addon Manager/it|Addon Manager]].
</div>


=== Limitazioni note ===
=== Limitazioni note ===
Line 81: Line 99:
| The navigation cube got a few retouches; now it uses transparency to be easier on the eyes, and the arrows are bigger to improve clicking on them.
| The navigation cube got a few retouches; now it uses transparency to be easier on the eyes, and the arrows are bigger to improve clicking on them.
[https://forum.freecadweb.org/viewtopic.php?f=34&t=35523 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2076 pull request #2076].
[https://forum.freecadweb.org/viewtopic.php?f=34&t=35523 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2076 pull request #2076].

|-
| [[File:FreeCAD_CubeMenu.png|384px]]
| The navigation cube can be augmented by the CubeMenu addon, which allows configuring the menu that pops up, as well as the size of the cube itself. This is helpful particularly for very high resolution screens, in which the default size is too small. This is an external tool that can be installed from the [[Std_AddonMgr|Addon Manager]].
[https://forum.freecadweb.org/viewtopic.php?f=34&t=43338 Forum discussion]; [https://github.com/triplus/CubeMenu CubeMenu] repository (LGPL 2.1).

|-
|-
| [[File:COIL_Icons.png|384px]]
| [[File:COIL_Icons.png|384px]]
Line 92: Line 116:
| [[File:Dark_theme1.PNG|384px]]
| [[File:Dark_theme1.PNG|384px]]
| New dark stylesheet developed by user {{emphasis|userzmp2000}}.
| New dark stylesheet developed by user {{emphasis|userzmp2000}}.
[https://forum.freecadweb.org/viewtopic.php?f=9&t=11419&start=120#p305844 Forum dscussion], [https://github.com/zmp2000/FreeCAD/blob/master/src/Gui/Stylesheets/BlenderLike-dark.qss BlenderLike-dark.qss].
[https://forum.freecadweb.org/viewtopic.php?f=9&t=11419&start=120#p305844 Forum discussion], [https://github.com/zmp2000/FreeCAD/blob/master/src/Gui/Stylesheets/BlenderLike-dark.qss BlenderLike-dark.qss].
|-
|-
| [[File:Darker.png|384px]]
| [[File:Darker.png|384px]]
| Dark themes by user {{emphasis|pablogil}}. Blue, green, and orange variations, which are darker than previous templates.
| Dark themes by user {{emphasis|pablogil}}. Blue, green, and orange variations, which are darker than previous templates.
[https://forum.freecadweb.org/viewtopic.php?f=9&t=38851 Forum discussion].
[https://forum.freecadweb.org/viewtopic.php?f=9&t=38851 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2433 pull request #2433], [https://github.com/FreeCAD/FreeCAD/pull/2920 #2920], [https://github.com/FreeCAD/FreeCAD/pull/2933 #2933].
|-
| [[File:View_ScreenCapture.png|384px]]
| The [[Std_ViewScreenShot|Std ViewScreenShot]] tool now supports transparency. Options are available by clicking the {{Button|Extended}} button and changing the {{MenuCommand|Image Properties}} section.

[https://wiki.freecadweb.org/Std_ViewScreenShot#Creation_method Wiki], [https://forum.freecadweb.org/viewtopic.php?f=8&t=41950&start=10 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/8e5151002 commit 8e5151002].
|}
|}


== App::Link e assemblaggio ==
== App::Link e assemblaggio ==


<!-- This is not a typo, the "x" indicates the height of the image, like WxH. In this case the width is omitted so only the height is set.
This doesn't need to have the same size as the other images because it's not going to be aligned inside a table.
Moreover, the text is perfectly readable at natural size. -->
[[File:Link.svg|64px]] [[File:AppLink.png|500px]]
<div class="mw-translate-fuzzy">
[[File:AppLink.png|600px]]
[[File:AppLink.png|600px]]
{{Caption|The "App::Link" object allows lightweight linking of objects in a document and from external documents.}}
{{Caption|L'oggetto "App::Link" consente il collegamento leggero di oggetti in un documento e da documenti esterni.}}
</div>


<div class="mw-translate-fuzzy">
After 2.5 years in development, the "[[Std_LinkMake|Link]]" object, or more formally {{incode|App::Link}}, was introduced in FreeCAD. This is a special type of {{incode|App::DocumentObject}} with certain properties that will hopefully allow for doing assemblies easier.
Dopo 2,5 anni di sviluppo, l'oggetto "[[Std_LinkMake/it|Link]]", o più formalmente {{incode|App::Link}}, è stato introdotto in FreeCAD. Questo è un tipo speciale di {{incode|App::DocumentObject}} con alcune proprietà che, si spera, consentiranno di semplificare gli assemblaggi.
</div>


<div class="mw-translate-fuzzy">
A "Link" allows objects to use another object's data, such as geometry or even their 3D visual representation, in the same or different files. It can be thought of as a thin, absolute clone, or as the same object living into two different "instances". Some functionality offered by a "Link" is already present in some workbenches like [[Arch Workbench|Arch]] and [[BIM Workbench|BIM]] ([[Draft Clone|clones]], [[Arch_Reference|external references]]), but the "Link" implementation is at the core level, and thus can be used by all workbenches in different ways.
Un "Link" consente agli oggetti di utilizzare i dati di un altro oggetto, come la geometria o anche la loro rappresentazione visiva 3D, negli stessi file o in file diversi. Può essere pensato come un leggero clone assoluto o come lo stesso oggetto che vive in due "istanze" diverse. Alcune funzionalità offerte da un "Link" sono già presenti in alcuni ambienti come [[Arch Workbench/it|Arch]] e [[BIM Workbench/it|BIM]] ([[Draft Clone/it|cloni]], [[Arch_Reference/it|riferimenti esterni]] ), ma l'implementazione di "Link" è al livello principale e può quindi essere utilizzato da tutti gli ambienti in diversi modi.
</div>


<div class="mw-translate-fuzzy">
The "Link" component was thought and developed almost single-handedly by user {{emphasis|realthunder}}. The motivations and design implementations behind this project are described in his GitHub page, [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link Link]. In order to accomplish this feature, several core changes to FreeCAD were made; these are also extensively documented in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes].
Il componente "Link" è stato pensato e sviluppato quasi interamente dall'utente {{emphasis|realthunder}}. Le motivazioni e le implementazioni progettuali alla base di questo progetto sono descritte nella sua pagina GitHub, [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link Link]. Per realizzare questa funzione, sono state apportate diverse modifiche fondamentali a FreeCAD; queste modifiche sono ampiamente documentate in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes].
</div>


<div class="mw-translate-fuzzy">
The history of "Link" can be traced to some essential forum threads:
La storia di "Link" può essere rintracciata tramite alcune discussioni essenziali del forum:
*[https://forum.freecadweb.org/viewtopic.php?f=19&t=21505 Why an object can only be inside one App::Part?] (March 2017)
*[https://forum.freecadweb.org/viewtopic.php?f=19&t=21505 Why an object can only be inside one App::Part?] (March 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=21586 Introducing App::Link/XLink] (March 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=21586 Introducing App::Link/XLink] (March 2017)
Line 119: Line 161:
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Assembly3 preview] (December 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Assembly3 preview] (December 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=29542 Merging of my Link branch] (June 2018)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=29542 Merging of my Link branch] (June 2018)
</div>


Finally, the pull request and merge happened:
Finally, the pull request and merge happened:
Line 126: Line 169:
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=39672 PR#2559: expose link and navigation actions], an introduction to the Link feature in 0.19 (September 2019).
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=39672 PR#2559: expose link and navigation actions], an introduction to the Link feature in 0.19 (September 2019).


The "Link" object prepares FreeCAD for the phase that was scheduled to happen after the redesign of [[Release_notes_0.17|PartDesign in FreeCAD 0.17]], which is working with assemblies.
The "App Link" object prepares FreeCAD for the phase that was scheduled to happen after the redesign of [[Release_notes_0.17|PartDesign in FreeCAD 0.17]], which is working with assemblies.


"Assembly3" is an assembly workbench written in Python by realthunder, that makes use of the "Link" functionality. The workbench served as a testbed for the "Link" component during its development. While Assembly3 is still not officially part of FreeCAD, with the inclusion of "Link", it is a matter of time for Assembly3 to be provided as an installable add-on, just like [[A2plus Workbench]] is provided currently.
[[Assembly3_Workbench|Assembly3]] is an assembly workbench written in Python by realthunder, that makes use of the "App Link" functionality. The workbench served as a testbed for this component during its development. While Assembly3 is still not officially part of FreeCAD, with the inclusion of "App Link" in the master branch, it is a matter of time for Assembly3 to be provided as an installable add-on, just like [[A2plus Workbench|A2plus]] and [[Assembly4_Workbench|Assembly4]] are provided currently.


== Core system, App, Base, and Gui namespaces ==
=== Other additions in the App::Link merge ===


Beside the introduction of "App::Link", the "LinkMerge" branch also introduced some changes visible to the user with regards to object properties, [[Expressions|expressions]], visual selection, and the tree view. These are described in the [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes] page.
Beside the introduction of [[App_Link|App Link]], the "LinkMerge" branch also introduced some changes visible to the user with regards to object properties, [[Expressions|expressions]], [[Selection_methods|visual selection]], and the [[tree_view|tree view]]. These are described in the [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes] page.


{|cellpadding=5
{|cellpadding=5
| [[File:Custom-property.gif|384px]]
| [[File:Custom_property_0.19.png|384px]]
| Dynamic properties can be added to any C++ or Python object. This can make macros such as [[Macro_PropertyMemo|Macro PropertyMemo]] obsolete.
| Dynamic properties can be added to any C++ or Python object. This can make macros such as [[Macro_PropertyMemo|Macro PropertyMemo]] obsolete.
[https://forum.freecadweb.org/viewtopic.php?p=328913#p328913 Forum discussion] | [http://www.freecadweb.org/wiki/images/3/3d/Custom-property.gif Animated gif]
[https://forum.freecadweb.org/viewtopic.php?p=328913#p328913 Forum discussion], [http://www.freecadweb.org/wiki/images/3/3d/Custom-property.gif animated GIF] example.

|-
| [[File:Custom_property_0.19_property_editor.png|384px]]
| These dynamic properties were added in the [[App_Link|App Link]] merge; [https://github.com/FreeCAD/FreeCAD/pull/2350 pull request #2350].

|-
|-
| [[File:selection.png|384px]]
| [[File:selection.png|384px]]
| Selected elements hidden by other elements are highlighted to indicate their position within the model.
| Selected elements hidden by other elements are highlighted to indicate their position within the model.
These selection enhancement were also introduced in the [[App_Link|App Link]] merge; [https://github.com/FreeCAD/FreeCAD/pull/2350 pull request #2350].

|-
| [[File:FreeCAD_backup_timestamp.png.png|384px]]
| After two years being stalled, there have been improvements in the way the program handles backup files. Now they can include a timestamp in the format {{incode|%Y%m%d-%H%M%S}}, instead of a simple number. This can be set in the [[Preferences_Editor|preferences editor]].

[https://forum.freecadweb.org/viewtopic.php?f=27&t=26965&start=20#p217186 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/1148 pull request #1148].

|-
| [[File:FreeCAD_Parameter_editor_quick_search.png|384px]]
| New input field to quickly search for parameters in the [[Parameter_Editor|parameter editor]].
[https://forum.freecadweb.org/viewtopic.php?f=27&t=44169 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3173 pull request #3173].

|-
| [[File:Macro_recently_used.png|384px]]
| The [[Std_Macro_Menu|Macro menu]] now shows a shortcut to recently used [[macros|macros]], which can be called with a key combination, for example, {{KEY|Ctrl}}+{{KEY|Shift}}+{{KEY|1}}. This can be configured in the [[Preferences_Editor|Macro preferences]].
[https://forum.freecadweb.org/viewtopic.php?f=8&t=48342 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3616 pull request #3616].
|}
|}

* Added support for existing Python virtual environments; [https://github.com/FreeCAD/FreeCAD/pull/2021 pull request #2021].
* Pre-select name filter in the import/export dialog; [https://forum.freecadweb.org/viewtopic.php?f=3&t=8093 forum discussion], [http://github.com/FreeCAD/FreeCAD/commit/e239994 commit e239994],
* Fixed missing application ID and icon on GNOME/Wayland; [https://github.com/FreeCAD/FreeCAD/pull/2466 pull request #2466].
* Added support for Hertz as a physical unit, and added the Frequency [[property|property]]; [https://forum.freecadweb.org/viewtopic.php?f=10&t=39485 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/3500451a0 commit 3500451a0], [https://github.com/FreeCAD/FreeCAD/commit/d7ca604c9 commit d7ca604c9].
* Added [[Std_TextDocument|Std TextDocument]] tool to insert an object to store arbitrary text in the document; [http://github.com/FreeCAD/FreeCAD/commit/13db5b0560 commit 13db5b0560], [http://github.com/FreeCAD/FreeCAD/commit/53b01f08f9 commit 53b01f08f9].
* Added support for further units, Gauss, Weber, Oersted; [https://forum.freecadweb.org/viewtopic.php?p=358223 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2863 pull request #2863].
* New commands to get information on the graphical commands, and the shortcuts; {{incode|Gui.getCommandInfo(...)}}, {{incode|Gui.getCommandShortcut(...)}}, {{incode|Gui.setCommandShortcut(...)}}; [https://forum.freecadweb.org/viewtopic.php?t=44973&start=30#p417043 forum thread], [https://github.com/FreeCAD/FreeCAD/pull/3710 pull request #3710].


== Addon Manager ==
== Addon Manager ==
Line 148: Line 221:
| [[File:Addon_Manager_update_0.19.png|384px]]
| [[File:Addon_Manager_update_0.19.png|384px]]
| The [[Addon Manager|Addon Manager]] was upgraded; it is now able to display more complete information on all [[external workbenches|external workbenches]] and [[macros recipes|macros]], and show an icon for each of them. It also allows checking for updates on start, and using custom repositories.
| The [[Addon Manager|Addon Manager]] was upgraded; it is now able to display more complete information on all [[external workbenches|external workbenches]] and [[macros recipes|macros]], and show an icon for each of them. It also allows checking for updates on start, and using custom repositories.

[https://forum.freecadweb.org/viewtopic.php?f=10&t=37394 Forum discussion].
[https://forum.freecadweb.org/viewtopic.php?f=10&t=37394 Forum discussion].
|-
| [[File:addon_manager_ui_tweak.png|384px]]
| It will also show information on whether the addon is obsolete, already installed, or available for update.
[https://forum.freecadweb.org/viewtopic.php?f=10&t=37394&p=340109#p340109 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2605 pull request #2605].
|}
|}


==Ambiente Arch==
==Ambiente Arch==

Keep with the latest developments to the [[Arch_Workbench|Arch Workbench]], and the [[BIM_Workbench|BIM Workbench]] that depends on it, by following the main author of this workbench, at
[https://yorik.uncreated.net/blog/freecad Uncreated]. The updates are also posted to the forum, [https://forum.freecadweb.org/viewtopic.php?f=23&t=17498 BIM/Arch development news articles from Yorik's blog].

The developers of [[Draft_Module|Draft]], [[Arch_Module|Arch]], and [[BIM_Workbench|BIM Workbenches]] also collaborate with the greater [https://osarch.org OSArch community], with the ultimate goal of improving building design by using entirely free software.


{|cellpadding=5
{|cellpadding=5
Line 174: Line 255:
|-
|-
| [[File:BeamReinforcementDialog_Stirrups.png|384px]]
| [[File:BeamReinforcementDialog_Stirrups.png|384px]]
| Improvements in the [[Reinforcement Addon]], which extends the [[Arch Rebar|Arch Rebar]] tool.
| Improvements in the [[Reinforcement Addon|Reinforcement Addon]], which extends the [[Arch Rebar|Arch Rebar]] tool.


Automated reinforcement graphical user interface: the intention is to facilitate the automatic creation of simple and complex rebars. This development was carried out as a [[Google Summer of Code 2019]] project: [[User:Suraj_Dadral/gsoc_proposal|Suraj_Dadral/gsoc_proposal]].
Automated reinforcement graphical user interface: the intention is to facilitate the automatic creation of simple and complex rebars. This development was carried out as a [[Google Summer of Code 2019]] project: [[User:Suraj_Dadral/gsoc_proposal|Suraj_Dadral/gsoc_proposal]].


[https://forum.freecadweb.org/viewtopic.php?f=8&t=35077 Forum discussion], [https://github.com/amrit3701/FreeCAD-Reinforcement FreeCAD-Reinforcement] (master code), [https://github.com/SurajDadral/FreeCAD-Reinforcement SurajDadral/FreeCAD-Reinforcement] (development fork).
[https://forum.freecadweb.org/viewtopic.php?f=8&t=35077 Forum discussion], [https://github.com/amrit3701/FreeCAD-Reinforcement FreeCAD-Reinforcement] (master code), [https://github.com/SurajDadral/FreeCAD-Reinforcement SurajDadral/FreeCAD-Reinforcement] (development fork).

|-
| [[File:FreeCAD_Arch_Coin_rendering.png|384px]]
| New rendering modes for [[Arch_SectionPlane|Arch SectionPlane]] that can be selected when using [[TechDraw_ArchView|TechDraw ArchView]], {{PropertyData|Render Mode}}, {{Value|Coin}} and {{Value|Coin mono}}. The section plane generates an SVG that is simply displayed in a TechDraw page; with these new modes, the SVG generation is performed by Coin, so it is faster than using {{Value|Wireframe}} and {{Value|Solid}}, which use the internal OCCT kernel to calculate the SVG projection. The tradeoff is between speed and precision; the Coin modes are faster but less precise, while the original modes are more precise but relatively slow.

[https://forum.freecadweb.org/viewtopic.php?f=3&t=38526&start=30#p328350 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/f93a986b5a commits f93a986b5a], [https://github.com/FreeCAD/FreeCAD/commit/ed0eff0248 ed0eff0248].

|-
| [[File:Arch_CutLine_example_1.png|384px]]
| New [[Arch_CutLine|Arch CutLine]] tool to cut solid objects, like [[Arch_Wall|Arch Walls]] and [[Arch_Structure|Arch Structure]], using an edge, like a [[Draft_Line|Draft Line]]. This works similar to the existing [[Arch_CutPlane|Arch CutPlane]].

[https://forum.freecadweb.org/viewtopic.php?f=23&t=40600 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2701 pull request #2701], [https://github.com/FreeCAD/FreeCAD/pull/2870 #2870].

|-
| [[File:Arch_Shapefile_importer_example.jpg|384px]]
| Arch now includes a Shapefile importer, which is commonly used in GIS applications. The importer uses the {{incode|shapefile.py}} library from the [https://github.com/GeospatialPython/pyshp pyshp] project; this library should be downloaded on first run.

[https://www.forum.freecadweb.org/viewtopic.php?f=9&p=396940#p396536 Forum thread], [https://github.com/FreeCAD/FreeCAD/commit/916a42397c commit 916a42397c]. Image of a site shared by @HnsaCAD for @gemeentearnhem.

|-
| [[File:Arch_Truss_example.png|384px]]
| New [[Arch_Truss|Arch Truss]] tool to create a variety of trusses. Like [[Arch_Wall|Arch Walls]] they are constructed from a baseline, and different properties define the shape of the truss, its height, and the intermediate elements.

It also supports [[Arch_MultiMaterial|Arch MultiMaterial]] to assign different materials to the bottom, top, and intermediate elements.

[https://github.com/FreeCAD/FreeCAD/commit/0c96f77184 Commit 0c96f77184].

|-
| [[File:Arch_CurtainWall_example.png|384px]]
| New [[Arch_CurtainWall|Arch CurtainWall]] tool to create various types of walls. This tool needs a base surface to work on. If none is selected, you can simply draw a line between two points, like the standard [[Arch_Wall|Arch Wall]]. The surface is then subdivided into rows and columns, and four points extracted from the surface subdivisions, forming quadrangular facets.

[https://github.com/FreeCAD/FreeCAD/commit/e42a26fba1 Commit e42a26fba1], [https://github.com/FreeCAD/FreeCAD/commit/7c12c8688c commit 7c12c8688c].
|}
|}


Line 186: Line 299:
| [[File:V0ODfsN9nY.gif|384px]]
| [[File:V0ODfsN9nY.gif|384px]]
| The [[Draft Edit|Draft Edit]] tool was upgraded to allow editing many Draft objects at the same time, and also display better trackers.
| The [[Draft Edit|Draft Edit]] tool was upgraded to allow editing many Draft objects at the same time, and also display better trackers.
[https://forum.freecadweb.org/viewtopic.php?f=23&t=33941&start=50#p290648 Forum discussion] | [https://www.freecadweb.org/wiki/images/f/f7/V0ODfsN9nY.gif Animated gif] |
[https://forum.freecadweb.org/viewtopic.php?f=23&t=33941&start=50#p290648 Forum discussion],
[https://github.com/FreeCAD/FreeCAD/pull/1968 Pull request #1968], [https://github.com/FreeCAD/FreeCAD/commit/272a8dfcc9f91097f6abcd228a3cc18fbecc37db commit 272a8dfcc9], [https://github.com/FreeCAD/FreeCAD/commit/7de2248bb commit 7de2248bb], [https://github.com/FreeCAD/FreeCAD/pull/2108 pull request #2108], [https://github.com/FreeCAD/FreeCAD/pull/2430 pull request #2430].
[https://github.com/FreeCAD/FreeCAD/pull/1968 pull request #1968], [https://github.com/FreeCAD/FreeCAD/commit/272a8dfcc9f91097f6abcd228a3cc18fbecc37db commit 272a8dfcc9], [https://github.com/FreeCAD/FreeCAD/commit/7de2248bb commit 7de2248bb], [https://github.com/FreeCAD/FreeCAD/pull/2108 pull request #2108], [https://github.com/FreeCAD/FreeCAD/pull/2430 pull request #2430]; [https://www.freecadweb.org/wiki/images/f/f7/V0ODfsN9nY.gif animated GIF] example.


The tool was also moved into its own module: [https://github.com/FreeCAD/FreeCAD/commit/a4e2df115d744a305f6c77a0468ea026b0f231c1 commit a4e2df115d], [https://github.com/FreeCAD/FreeCAD/commit/c351b9094a112218f9787c2d4c61edeb82c419f0 commit c351b9094].
The tool was also moved into its own module: [https://github.com/FreeCAD/FreeCAD/commit/a4e2df115d commit a4e2df115d], [https://github.com/FreeCAD/FreeCAD/commit/c351b9094 commit c351b9094].
|-
|-
| [[File:Draft_SubelementHighlight_example.png|384px]]
| [[File:Draft_SubelementHighlight_example.png|384px]]
| New [[Draft Edit Improved|Draft SubelementHighlight]] tool to highlight the nodes and edges of certain objects, like [[Draft Wire|Draft Wires]], in order to update them using modifiers like [[Draft Move|Draft Move]], [[Draft Rotate|Draft Rotate]], and [[Draft Scale|Draft Scale]]. It allows you to select multiple objects to edit instead of just one, and modify only the selected the sub-elements of those objects (vertices or edges).
| New [[Draft SubelementHighlight|Draft SubelementHighlight]] tool to highlight the nodes and edges of certain objects, like [[Draft Wire|Draft Wires]], in order to edit them using modifiers like [[Draft Move|Draft Move]], [[Draft Rotate|Draft Rotate]], and [[Draft Scale|Draft Scale]]. It allows you to select multiple objects to edit instead of just one. Once the objects are highlighted, you can select specific sub-elements, vertices and edges, and transform (move, rotate, scale) only these.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=34114 Forum discussion] | [https://peertube.social/videos/watch/d39d4f3c-b3c8-4a18-b8c4-6719d0f70f48 Video demonstration 1], [https://peertube.social/videos/watch/861af3cb-b053-415c-ba31-fae332e916f4 2] |
This tool was particularly developed to help edit the shape of [[Arch_Wall|Arch Walls]] that are based on [[Draft Wire|Draft Wires]]. When various walls are selected, and the tool is used, the base wires automatically become visible, and display their nodes prominently.
[https://github.com/FreeCAD/FreeCAD/pull/1975 Pull request #1975].

[https://forum.freecadweb.org/viewtopic.php?f=23&t=34114 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/1975 pull request #1975]; [https://peertube.social/videos/watch/d39d4f3c-b3c8-4a18-b8c4-6719d0f70f48 video demonstration 1], [https://peertube.social/videos/watch/861af3cb-b053-415c-ba31-fae332e916f4 2].

|-
|-
| [[File:Draft_CubicBezCurve_example.png|384px]]
| [[File:Draft_CubicBezCurve_example.png|384px]]
| New [[Draft CubicBezCurve|Draft CubicBezCurve]] tool, to create 3rd degree Bezier curves in a way similar to Inkscape.
| New [[Draft CubicBezCurve|Draft CubicBezCurve]] tool, to create 3rd degree Bezier curves in a way similar to Inkscape.
[https://forum.freecadweb.org/viewtopic.php?f=23&t=35397 Forum discussion] | [https://www.freecadweb.org/wiki/images/9/97/Draft_3rd_degree_bezier.gif Animated gif] |
[https://forum.freecadweb.org/viewtopic.php?f=23&t=35397 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2072 pull request #2072]; [https://www.freecadweb.org/wiki/images/9/97/Draft_3rd_degree_bezier.gif animated GIF] example.

[https://github.com/FreeCAD/FreeCAD/pull/2072 Pull request #2072].
|-
|-
| [[File:Draft_Arc_3Points_example.png|384px]]
| [[File:Draft_Arc_3Points_example.png|384px]]
| New [[Draft Arc 3Points|Draft Arc 3Points]] tool, to create circular arcs by specifying three points through which the arc passes. Originally developed in the [[BIM Workbench]] and then migrated to Draft.
| New [[Draft Arc 3Points|Draft Arc 3Points]] tool, to create circular arcs by specifying three points through which the arc passes. Originally developed in the [[BIM Workbench]] and then migrated to Draft.
[https://forum.freecadweb.org/viewtopic.php?f=23&t=36332 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/4f19a65559486f9bf6d462a9f8608d3883d71106 commit 4f19a65559], [https://github.com/FreeCAD/FreeCAD/commit/0b905fade00d5e96de70418d08459ec15369dd61 commit 0b905fade0], [https://github.com/FreeCAD/FreeCAD/pull/2286 pull request #2286].
[https://forum.freecadweb.org/viewtopic.php?f=23&t=36332 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/4f19a65559 commit 4f19a65559], [https://github.com/FreeCAD/FreeCAD/commit/0b905fade0 commit 0b905fade0], [https://github.com/FreeCAD/FreeCAD/pull/2286 pull request #2286].

A proper command line interface as well as unit test are also provided.

[https://github.com/FreeCAD/FreeCAD/pull/3004 Pull request #3004], [https://github.com/FreeCAD/FreeCAD/pull/3005 #3005].
|-
|-
| [[File:Draft_layers.png|384px]]
| [[File:Draft_layers.png|384px]]
| New [[Draft Layer|Draft Layer]] tool that replaces the seldom used [[Draft VisGroup|Draft VisGroup]], providing a true layer system as it exists in other CAD systems. Draft Layer supports adding objects by drag-and-drop, controls object visibility and, optionally, object color.
| New [[Draft_Layer|Draft Layer]] tool that replaces the seldom used [[Draft_VisGroup|Draft VisGroup]], providing a true layer system as it exists in other CAD systems. Draft Layer supports adding objects by drag-and-drop, controls object visibility and, optionally, object color.
[https://forum.freecadweb.org/viewtopic.php?f=39&t=36669 Forum discussion] (development), [https://forum.freecadweb.org/viewtopic.php?f=9&t=36852 forum discussion] (announcement), [https://github.com/FreeCAD/FreeCAD/commit/5ee99ca4ee6b62e40d67e32b4a87a8af4be73e01 commit 5ee99ca4ee], [https://github.com/FreeCAD/FreeCAD/commit/36bc48c9bf240606870044e76cd3a62fe3317795 commit 36bc48c9bf].
[https://forum.freecadweb.org/viewtopic.php?f=39&t=36669 Forum discussion] (development), [https://forum.freecadweb.org/viewtopic.php?f=9&t=36852 forum discussion] (announcement), [https://github.com/FreeCAD/FreeCAD/commit/5ee99ca4ee commit 5ee99ca4ee], [https://github.com/FreeCAD/FreeCAD/commit/36bc48c9bf commit 36bc48c9bf].

|-
|-
| [[File:Draft-TechDraw_integration.png|384px]]
| [[File:Draft-TechDraw_integration.png|384px]]
| Substantial reworking of Draft SVG routines to improve inclusion of 2D projections in [[TechDraw Workbench|TechDraw]] pages. This benefits tools like [[Draft Shape2DView|Draft Shape2DView]] and [[Arch SectionPlane|Arch SectionPlane]], when used with [[TechDraw NewDraft|TechDraw NewDraft]] and [[TechDraw NewArch|TechDraw NewArch]].
| Improvements in the Draft SVG routines to improve inclusion of 2D projections in [[TechDraw_Workbench|TechDraw]] pages. This benefits tools like [[Draft_Shape2DView|Draft Shape2DView]] and [[Arch_SectionPlane|Arch SectionPlane]], when used with [[TechDraw_DraftView|TechDraw DraftView]] and [[TechDraw_ArchView|TechDraw ArchView]].

[https://forum.freecadweb.org/viewtopic.php?f=35&t=38940 Forum discussion].
A new {{PropertyData|Override Style}} property is added to [[TechDraw_DraftView|TechDraw DraftView]], in order to choose whether the appearance of Draft objects is kept (new) or is overridden by the TechDraw page (old behavior).

[https://forum.freecadweb.org/viewtopic.php?f=35&t=38940 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/3e323fee14 commit 3e323fee14].

|-
|-
| [[File:Draft_Fillet_example.png|384px]]
| [[File:Draft_Fillet_example.png|384px]]
| New [[Draft Fillet|Draft Fillet]] tool that creates a fillet (rounded corner) or a chamfer (straight line) between two simple [[Draft Line|Draft Lines]].
| New [[Draft_Fillet|Draft Fillet]] tool that creates a fillet (rounded corner) or a chamfer (straight line) between two simple [[Draft Line|Draft Lines]].
[https://forum.freecadweb.org/viewtopic.php?f=23&t=38715 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2441 pull request #2441], [https://github.com/FreeCAD/FreeCAD/pull/2492 #2492].

|-
| [[File:Draft_LinkArray_example.png|384px]]
| The introduction of the [[App_Link|App Link]] object made it possible to create arrays which have many exact references to an existing object instead of shape duplicates (simple copies). This results in more memory efficient arrays. This is possible with the new [[Draft_LinkArray|Draft LinkArray]] and [[Draft_PathLinkArray|Draft PathLinkArray]] tools. [[Draft_LinkArray|Draft LinkArray]] works in three modes, "ortho", "polar", and the new "circular" mode, which was introduced in a separate commit.

[https://github.com/FreeCAD/FreeCAD/pull/2350 Pull request #2350].

After the creation of the Link arrays, a new command called [[Draft_OrthoArray|Draft OrthoArray]] now replaces both [[Draft_Array|Draft Array]] and [[Draft_LinkArray|Draft LinkArray]]. This [[Draft_OrthoArray|Draft OrthoArray]] is used to create exclusively orthogonal arrays. It shows a task panel similar to [[Draft_PolarArray|Draft PolarArray]] and [[Draft_CircularArray|Draft CircularArray]]. Therefore, from the toolbar it is now possible to create "orthogonal", "polar" and "circular" arrays from separate buttons. Moreover, the array buttons are collected in a group so that they are organized.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=41816&p=365888#p365878 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2988 pull request #2988], [https://github.com/FreeCAD/FreeCAD/pull/2972 #2972].

|-
| [[File:Draft_PolarArray_example.png|384px]]
| New [[Draft_PolarArray|Draft PolarArray]] tool to create polar arrays directly. Previously, the same could be done by using the old [[Draft_Array|Draft Array]] command, and then modifying the properties of the created object.
This [[Draft_PolarArray|Draft PolarArray]] tool can create the new [[App_Link|App Link]] objects or the traditional copies.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=41816 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2824 pull request #2824].
|-
| [[File:Draft_CircularArray_example.png|384px]]
| The Array object has a new "circular" mode. This is controlled by new properties: {{PropertyData|RadialDistance}}, {{PropertyData|TangentialDistance}}, {{PropertyData|NumberCircles}}, and {{PropertyData|Symmetry}}.
[https://forum.freecadweb.org/viewtopic.php?f=13&t=39726 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2585 pull request #2585].

Moreover, a new [[Draft_CircularArray|Draft CircularArray]] tool was developed to create these circular arrays directly. This tool can create the new [[App_Link|App Link]] objects or the traditional copies.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=41816 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2824 pull request #2824].

|-
| [[File:Draft_test_objects.png|384px]]
| The unit tests of the workbench were rewritten and expanded, so that now it is easier to test for errors and regressions when new code is merged.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=40405 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2668 pull request #2668], [https://github.com/FreeCAD/FreeCAD/pull/2727 #2727], [https://github.com/FreeCAD/FreeCAD/pull/2881 #2881], [https://github.com/FreeCAD/FreeCAD/pull/3005 #3005].

Also, a script is provided in {{incode|Mod/Draft/drafttests/draft_test_objects.py}}, that produces a test file with most objects of the workbench. This file is useful to learn scripting in Draft, and can also be used to test regressions in the underlying code of the objects.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=40405&p=368819#p368819 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3012 pull request #3012].

|-
| [[File:Draft_tree_icons.png]]
| New icons were provided for the Draft objects in the [[tree_view|tree view]]. The objective is to more quickly distinguish the objects at a glance, particularly if the default label is changed. This makes it easier to recognize objects which are lines, curves, geometrical elements, linear, radial, or angular dimensions, or other objects.

In addition, all icons were converted to the new standard pixel resolution of 96 dpi, and were saved as Plain SVG, so that we don't introduce non-standard SVG tags.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=43439 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3051 pull request #3051], [https://github.com/FreeCAD/FreeCAD/pull/3058 #3058], [https://github.com/FreeCAD/FreeCAD/pull/3060 #3060], [https://github.com/FreeCAD/FreeCAD/pull/3070 #3070], [https://github.com/FreeCAD/FreeCAD/pull/3170 #3170], [https://github.com/FreeCAD/FreeCAD/pull/3402 #3402].

|-
| [[File:Draft_architecture.svg|384px]]
| Undergoing efforts to split tools into their own module files to ease maintenance of the codebase for the future, and facilitate the addition of new tools.

[https://forum.freecadweb.org/viewtopic.php?f=23&t=38593 Forum discussion], [https://forum.freecadweb.org/viewtopic.php?f=23&t=38593&start=120#p428304 overall structure].

Some of the functions and classes that have already been moved: [https://github.com/FreeCAD/FreeCAD/commit/5ee99ca4ee commit 5ee99ca4ee] ([[Draft_Layer|Draft Layer]]), [https://github.com/FreeCAD/FreeCAD/commit/16c26cb3b1 commit 16c26cb3b1] ([[Draft_Edit|Draft Edit]]), [https://github.com/FreeCAD/FreeCAD/commit/9fb6aec313 commit 9fb6aec313] ([[Draft_SelectPlane|Draft SelectPlane]]), [https://github.com/FreeCAD/FreeCAD/pull/2823 pull requests #2823] (GuiCommandBase), [https://github.com/FreeCAD/FreeCAD/pull/2829 #2829] (utilities), [https://github.com/FreeCAD/FreeCAD/pull/2830 #2830] (GUI utilities), [https://github.com/FreeCAD/FreeCAD/pull/2831 #2831] (ToDo class), [https://github.com/FreeCAD/FreeCAD/pull/2832 #2832] (translate function), [https://github.com/FreeCAD/FreeCAD/pull/3091 #3091] ([[Draft_Snap|Draft Snap]]), [https://github.com/FreeCAD/FreeCAD/pull/3092 #3092] (Draft Trackers), [https://github.com/FreeCAD/FreeCAD/pull/3094 #3094] ([[Draft_SelectPlane|Draft SelectPlane]]), [https://github.com/FreeCAD/FreeCAD/pull/3095 #3095] ([[Draft_ShapeString|Draft ShapeString]] task panel), [https://github.com/FreeCAD/FreeCAD/pull/3096 #3096] ([[Draft_Scale|Draft Scale]] task panel), [https://github.com/FreeCAD/FreeCAD/pull/3097 #3097] ([[Draft_Edit|Draft Edit]]), [https://github.com/FreeCAD/FreeCAD/pull/3157 #3157] ([[Draft_SetWorkingPlaneProxy|Draft WorkingPlaneProxy]]), [https://github.com/FreeCAD/FreeCAD/pull/3182 #3182] (various Gui Commands), [https://github.com/FreeCAD/FreeCAD/pull/3291 #3291] (base classes {{incode|DraftTool}}, {{incode|Creator}}, {{incode|Modifier}}), [https://github.com/FreeCAD/FreeCAD/pull/3299 #3299], ({{incode|Creator}} tools), [https://github.com/FreeCAD/FreeCAD/pull/3308 #3308] ({{incode|Modifier}} tools).

For an overall view of the pull requests, see [https://github.com/FreeCAD/FreeCAD/pull/2429 #2429].

This is a work in progress that requires advancing carefully as we aim to maintain compatibility with previous versions of Draft. Most refactoring is complete, but there is still room for improving many aspects of the workbench. We invite enthusiastic developers to join the effort.

|-
| [[File:Draft_AnnotationStyleEditor_example.png|384px]]
| New [[Draft_AnnotationStyleEditor|Annotation style editor]] tool to create styles for annotations. These styles can define things like text font, size, color, and arrows, which can be applied to any of your texts, dimensions or labels. We started by implementing an editor and a system to store the styles in the document. Next steps will be adapting the different annotation objects to support the styles.


[https://forum.freecadweb.org/viewtopic.php?f=23&t=38715 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2441 pull request #2441], [https://github.com/FreeCAD/FreeCAD/pull/2492 pull request #2492].
[https://forum.freecadweb.org/viewtopic.php?f=23&t=44051 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/1b887fa0f5 commit 1b887fa0f5], [https://github.com/FreeCAD/FreeCAD/commit/4555a77663 commit 4555a77663], [https://github.com/FreeCAD/FreeCAD/commit/5b3fea59e0 commit 5b3fea59e0].
|}
|}


Line 222: Line 407:


* The [[Draft Wire|Draft Wire]] tool now is called "Polyline" in the menu, instead of "DWire"; all options and functionality remain the same, so this doesn't break compatibility; [https://github.com/FreeCAD/FreeCAD/commit/39e748229e67fa93e924e355c0ce0897c870d756 commit 39e748229e].
* The [[Draft Wire|Draft Wire]] tool now is called "Polyline" in the menu, instead of "DWire"; all options and functionality remain the same, so this doesn't break compatibility; [https://github.com/FreeCAD/FreeCAD/commit/39e748229e67fa93e924e355c0ce0897c870d756 commit 39e748229e].
* Undergoing efforts to split tools into their own module files to ease maintenance of the codebase for the future; [https://forum.freecadweb.org/viewtopic.php?f=23&t=38593 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/16c26cb3b1cd7209ea8efc8cb30b3b18fd80cf95 commit 16c26cb3b1].
* A "DraftEditPickRadius" preference was added to control the area of influence of the pointer when picking vertices in edit mode [[Draft_Edit|Draft Edit]]; [https://forum.freecadweb.org/viewtopic.php?f=23&t=40060 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2642 pull request #2642], [https://freecadweb.org/tracker/view.php?id=4162 issue #4162].
* Undergoing efforts to document the Python source code (adding complete docstrings), in order to produce better programming documentation that can be used by both users and developers. See [[Source documentation|Source documentation]] for instructions on generating the documentation with [[Doxygen|Doxygen]].
* Undergoing efforts to document the Python source code (adding complete docstrings), in order to produce better programming documentation that can be used by both users and developers. See [[Source documentation|Source documentation]] for instructions on generating the documentation with [[Doxygen|Doxygen]].
* The "Toolbar mode" when launching the Draft tools has been removed. This was an interface that was used in the past but became obsolete as the [[task_panel|task panel]] became the predominant interface; [https://forum.freecadweb.org/viewtopic.php?f=34&t=42782 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2973 pull request #2973].
* {{incode|Draft.copy}} now works with any document object, thanks to the new {{incode|Document.copyObject()}} method introduced with the LinkMerge; pull request [https://github.com/FreeCAD/FreeCAD/pull/3658 #3658].


==Ambiente FEM==
==Ambiente FEM==
Line 230: Line 417:
| [[File:Femconcrete_Wall_3D_rx_PSS.png|384px]]
| [[File:Femconcrete_Wall_3D_rx_PSS.png|384px]]
| After half a year in development and testing the "femconcrete" branch was added to the FEM Workbench. This provides tools to estimate the level of reinforcement required in a concrete structure to prevent brittle failure under tension or shear. In essence, it is a post processing routine for the CalculiX solver, which calculates the principal tensile stresses in the concrete from an elastic analysis and uses those to determine the minimum reinforcement in the three coordinate directions required to prevent failure.
| After half a year in development and testing the "femconcrete" branch was added to the FEM Workbench. This provides tools to estimate the level of reinforcement required in a concrete structure to prevent brittle failure under tension or shear. In essence, it is a post processing routine for the CalculiX solver, which calculates the principal tensile stresses in the concrete from an elastic analysis and uses those to determine the minimum reinforcement in the three coordinate directions required to prevent failure.
[https://forum.freecadweb.org/viewtopic.php?f=18&t=33106 Forum discussion], [[Analysis_of_reinforced_concrete_with_FEM|Analysis of reinforced concrete with FEM]] (tutorial) | [https://github.com/FreeCAD/FreeCAD/pull/2267 Pull request #2267].
[https://forum.freecadweb.org/viewtopic.php?f=18&t=33106 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2267 pull request #2267]; [[Analysis_of_reinforced_concrete_with_FEM|Analysis of reinforced concrete with FEM]] (tutorial).

|-
|-
| [[File:fcFEM_Plate_with_Hole_2.png|384px]]
| [[File:fcFEM_Plate_with_Hole_2.png|384px]]
Line 237: Line 425:
In due time this solver could be distributed together with the FEM Workbench, meaning that the FreeCAD project would have its own finite element solver for doing mechanical and structural analyses.
In due time this solver could be distributed together with the FEM Workbench, meaning that the FreeCAD project would have its own finite element solver for doing mechanical and structural analyses.


[https://forum.freecadweb.org/viewtopic.php?f=18&t=33974 Forum discussion] | [https://github.com/HarryvL/fcFEM fcFEM] repository (LGPL 2).
[https://forum.freecadweb.org/viewtopic.php?f=18&t=33974 Forum discussion]; [https://github.com/HarryvL/fcFEM fcFEM] repository (LGPL 2).

|-
|-
| [[File:FEM_Beso_topology_optimization.png|384px]]
| [[File:FEM_Beso_topology_optimization.png|384px]]
| Topology optimization has long been a feature desired for those working with FEM. In 2016 the BESO (Bi-directional Evolutionary Structural Optimization) project was started, implementing an iterative method with the CalculiX solver that removes ineffective elements from a mesh in order to optimize the mass of the design. In the 0.19 development cycle, a simple graphical interface has been developed to facilitate generating the beso configuration files.
| Topology optimization has long been a feature desired for those working with FEM. In 2016 the BESO (Bi-directional Evolutionary Structural Optimization) project was started, implementing an iterative method with the CalculiX solver that removes ineffective elements from a mesh in order to optimize the mass of the design. In the 0.19 development cycle, a simple graphical interface has been developed to facilitate generating the beso configuration files.


[https://forum.freecadweb.org/viewtopic.php?f=18&t=15460 Forum discussion] | [https://github.com/fandaL/beso beso] repository (LGPL 3).
[https://forum.freecadweb.org/viewtopic.php?f=18&t=15460 Forum discussion]; [https://github.com/fandaL/beso beso] repository (LGPL 3).
|-
|-
| [[File:FEM_ToOptix_topology_optimization.png|384px]]
| [[File:FEM_ToOptix_topology_optimization.png|384px]]
| Similar to beso, the ToOptix project also provides a macro to perform topology optimization; it currently only works in structural and heat transfer studies.
| Similar to beso, the ToOptix project also provides a macro to perform topology optimization; it currently only works in structural and heat transfer studies.


[https://forum.freecadweb.org/viewtopic.php?p=273794#p273794 Forum discussion] (just a mention) | [https://github.com/DMST1990/ToOptixFreeCADAddon ToOptixFreeCADAddon] repository (GPL 2).
[https://forum.freecadweb.org/viewtopic.php?p=273794#p273794 Forum discussion] (just a mention); [https://github.com/DMST1990/ToOptixFreeCADAddon ToOptixFreeCADAddon] repository (GPL 2).
|}
|}


Line 255: Line 444:
* The Elmer project has developed a library for handling batch type pre-processing for the ElmerSolver, using the FEM Workbench. This includes creating mesh objects for FreeCAD, manipulating the mesh sizes of solids, creating finite element meshes using Gmsh, running ElmerGrid and exporting the mesh for ElmerSolver, and selecting and naming bodies and boundaries for ElmerSolver; [https://forum.freecadweb.org/viewtopic.php?f=18&t=38950 forum discussion], [https://github.com/ElmerCSC/elmerfem elmerfem] repository (Elmer main repository), [https://github.com/ElmerCSC/elmerfem/tree/devel/ElmerWorkflows/FreeCADBatchFEMTools FreeCADBatchFEMTools] repository (library to interact with FEM Workbench, LGPL 2.1).
* The Elmer project has developed a library for handling batch type pre-processing for the ElmerSolver, using the FEM Workbench. This includes creating mesh objects for FreeCAD, manipulating the mesh sizes of solids, creating finite element meshes using Gmsh, running ElmerGrid and exporting the mesh for ElmerSolver, and selecting and naming bodies and boundaries for ElmerSolver; [https://forum.freecadweb.org/viewtopic.php?f=18&t=38950 forum discussion], [https://github.com/ElmerCSC/elmerfem elmerfem] repository (Elmer main repository), [https://github.com/ElmerCSC/elmerfem/tree/devel/ElmerWorkflows/FreeCADBatchFEMTools FreeCADBatchFEMTools] repository (library to interact with FEM Workbench, LGPL 2.1).
* The integration of the OOFem solver, which started in 2018, is progressing, so it is now another option that can be used for structural analysis in FreeCAD. This solver is interesting in that it has interface elements, as well as arc-length control, in addition to many non-linear material models. The integration of OOFEM into FEM has been carried in various commits that together serve as documentation on how to integrate similar solvers; [https://forum.freecadweb.org/viewtopic.php?f=18&t=31288 forum discussion], [https://github.com/berndhahnebach/FreeCAD_bhb/tree/femoofem femoofem] branch, [http://www.oofem.org/ OOFEM] main website, [https://github.com/oofem/oofem oofem] repository (LGPL 2.1).
* The integration of the OOFem solver, which started in 2018, is progressing, so it is now another option that can be used for structural analysis in FreeCAD. This solver is interesting in that it has interface elements, as well as arc-length control, in addition to many non-linear material models. The integration of OOFEM into FEM has been carried in various commits that together serve as documentation on how to integrate similar solvers; [https://forum.freecadweb.org/viewtopic.php?f=18&t=31288 forum discussion], [https://github.com/berndhahnebach/FreeCAD_bhb/tree/femoofem femoofem] branch, [http://www.oofem.org/ OOFEM] main website, [https://github.com/oofem/oofem oofem] repository (LGPL 2.1).

== Import ==

* Improved import/export compatibility with proprietary CAD systems, when using compressed STEP, or STPZ; [https://forum.freecadweb.org/viewtopic.php?f=3&t=37469 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2323 pull request #2323], [https://github.com/FreeCAD/FreeCAD/commit/7de89cf62e0411dcd commit 7de89cf62e].

== Material handling ==

{{Emphasis|None}}

== Mesh ==

{|cellpadding=5
| [[File:Mesh_FromPartShape_Gmsh.png|384px]]
| [[Mesh_FromPartShape|Mesh FromPartShape]] is now able to create [[mesh|meshes]] using [https://en.wikipedia.org/wiki/Gmsh Gmsh]. This mesher is an external program that must be installed in the system before it can be used. Gmsh was already one of the options to create [[FEM_Mesh|finite element meshes]] with the [[FEM_Workbench|FEM Workbench]].

Moreover, now the [[Mesh_FromPartShape|Mesh FromPartShape]] dialog will remember the settings that you used the last time.

[https://github.com/FreeCAD/FreeCAD/commit/1cb4625bf Commit 1cb4625bf].
|}

=== Further improvements ===

* It is now possible to take an OpenInventor mesh file ({{FileName|.iv}}), and export it to STL; [https://forum.freecadweb.org/viewtopic.php?f=3&t=43926#p378032 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/601ac707b2 commit 601ac707b2].
* It is now possible to export a [[Mesh|Mesh]] to [[Asymptote|Asymptote format]] ({{FileName|.asy}} ); [https://forum.freecadweb.org/viewtopic.php?f=8&t=48915 forum thread], [https://github.com/FreeCAD/FreeCAD/commit/4badaba5 commits 4badaba5], [https://github.com/FreeCAD/FreeCAD/commit/50bbd522 50bbd522], [https://github.com/FreeCAD/FreeCAD/commit/58a92681 58a92681], [https://github.com/FreeCAD/FreeCAD/commit/dd7afa72 dd7afa72], [https://github.com/FreeCAD/FreeCAD/commit/b0f78f5a b0f78f5a].
* Most tools of the [[Mesh_Workbench|Mesh Workbench]] now have a proper icon so it is easier to recognize the function in the menu and toolbars; [https://forum.freecadweb.org/viewtopic.php?f=34&t=47494 forum thread], pull request [https://github.com/FreeCAD/FreeCAD/pull/3816 #3816], [https://github.com/FreeCAD/FreeCAD/pull/3864 #3864].


==Ambiente Part==
==Ambiente Part==
Line 262: Line 476:
| New command [[Part_PointsFromMesh|Part PointsFromMesh]] to create an object made of points from an imported mesh. Then the points can be used as reference objects to do further operations, such as define a plane, and draw a sketch. This can be used to reverse engineer or remodel meshes by creating solid objects.
| New command [[Part_PointsFromMesh|Part PointsFromMesh]] to create an object made of points from an imported mesh. Then the points can be used as reference objects to do further operations, such as define a plane, and draw a sketch. This can be used to reverse engineer or remodel meshes by creating solid objects.
[https://forum.freecadweb.org/viewtopic.php?f=9&t=38670&p=328959#p328959 Forum discussion] (and video), [https://github.com/FreeCAD/FreeCAD/pull/2450 pull request #2450].
[https://forum.freecadweb.org/viewtopic.php?f=9&t=38670&p=328959#p328959 Forum discussion] (and video), [https://github.com/FreeCAD/FreeCAD/pull/2450 pull request #2450].

|-
| [[File:Part_Primitives_example.png|384px]]
| A script is provided in {{incode|Mod/Part/parttests/part_test_objects.py}}, that produces a test file with the [[Part_Primitives|Part Primitives]]. This file is useful to learn scripting in Part, and can also be used to test regressions in the underlying code of the objects.

[https://github.com/FreeCAD/FreeCAD/pull/3078 Pull request #3078].

|-
| [[File:Part_CheckGeometry_advanced.png|384px]]
| The {{Button|[[File:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Part CheckGeometry]]}} tool has been expanded to include more information about the [[Part_TopoShape|Part TopoShape]] that is contained in all solid objects of the program, not including [[Mesh|Mesh]]-type objects.

[https://forum.freecadweb.org/viewtopic.php?f=22&t=48792 Forum discusion], [https://forum.freecadweb.org/viewtopic.php?f=8&t=48994 2], [https://forum.freecadweb.org/viewtopic.php?f=9&t=50153 announcement]; [https://github.com/FreeCAD/FreeCAD/pull/3747 pull request #3747].
|}
|}


=== Further improvements ===

* Fixed broken support for "INCH" units when exporting to STEP/IGES formats; [https://forum.freecadweb.org/viewtopic.php?f=22&t=36808&p=314172#p314172 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/1b2617358 commit 1b26173580].
* New Face method: {{incode|Part.Face.cutHoles(list_of_wires)}} to cut holes into a face. The face usually needs to be validated after operation.
* New Face method: {{incode|Part.Face.cutHoles(list_of_wires)}} to cut holes into a face. The face usually needs to be validated after operation.
* The "App::Link" merge introduced two new commands, [[Part_TransformedCopy|Part TransformedCopy]] and [[Part_ElementCopy|Part ElementCopy]]. These commands create non-parametric copies of a body with a transformed placement, and of an element (vertex, edge, or face); [https://github.com/FreeCAD/FreeCAD/commit/6da72b9859f6d21119831d44a8d132c8e2dfb544 commit 6da72b9859]. These operations essentially make the [[Macro_Repro_Wire|Macro Repro Wire]] obsolete.
* The [[App_Link|App Link]] merge introduced two new commands, [[Part_TransformedCopy|Part TransformedCopy]] and [[Part_ElementCopy|Part ElementCopy]]. These commands create non-parametric copies of a body with a transformed placement, and of an element (vertex, edge, or face); [https://github.com/FreeCAD/FreeCAD/commit/6da72b9859f6d21119831d44a8d132c8e2dfb544 commit 6da72b9859]. These operations essentially make the [[Macro_Repro_Wire|Macro Repro Wire]] obsolete.


== Ambiente PartDesign ==
== Ambiente PartDesign ==
Line 271: Line 500:
{|cellpadding=5
{|cellpadding=5
| [[File:PartDesign_Feature_not_attached.png]]
| [[File:PartDesign_Feature_not_attached.png]]
| Features that have an "Attachment" property now show when the attachment mode is "deactivated" by displaying a small overlay to the left of the icon in the tree view. Features that are attached to a plane or other reference don't display this overlay.
| [[PartDesign_Feature|Features]] that have an [[Part_Attachment|"Attachment"]] property now show when the attachment mode is "deactivated" by displaying a small overlay to the left of the icon in the [[tree_view|tree view]]. Features that are attached to a plane or other reference don't display this overlay.
[https://forum.freecadweb.org/viewtopic.php?f=8&t=37074&p=315344#p315344 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2272 pull request #2272].
[https://forum.freecadweb.org/viewtopic.php?f=8&t=37074&p=315344#p315344 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2272 pull request #2272].
|-
| [[File:PartDesign_Chamfer-angle.png|384px]]
| The dialog to edit [[PartDesign_Chamfer|chamfers]] allows now to define chamfers also either
* using 2 values
* a value and an angle
These 2 parameters can also be flipped using the dialog.
[https://forum.freecadweb.org/viewtopic.php?f=17&t=46205 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3456 pull request #3456]
|-
| [[File:PartDesign_Pad_direction.png|384px]]
| The dialog to edit [[PartDesign_Pad|pads]] allows now to specify a direction in which the sketch is padded.
[https://forum.freecadweb.org/viewtopic.php?f=27&t=49343 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3794 pull request #3794]
|-
| [[File:PartDesign_Dressup_pattern.png|384px]]
| [[PartDesign_LinearPattern|PartDesign LinearPattern]] and [[PartDesign_PolarPattern|PolarPattern]] now can be used with dress-up features ([[PartDesign_Fillet|fillets]], [[PartDesign_Chamfer|chamfers]], [[PartDesign_Thickness|thickness]] and [[PartDesign_Draft|draft]]) and with primitives ([[PartDesign_CompPrimitiveAdditive|Additives]] and [[PartDesign_CompPrimitiveSubtractive|Subtractives]]). A new property {{PropertyData|Support Transform}} in these [[PartDesign_Feature|features]], controls whether the feature supports the pattern or not.
[https://forum.freecadweb.org/viewtopic.php?f=8&t=43312 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3045 pull request #3045], [https://github.com/FreeCAD/FreeCAD/pull/3155 #3155], [https://github.com/FreeCAD/FreeCAD/pull/3226 #3226].
|-
| [[File:PartDesign_Prism_direction.png|384px]]
| The dialog to edit [[PartDesign_AdditivePrism|Prisms]] (additive and subtractive) allows now to specify an angle in respect to the normal of the chosen attachment plane. This way one can create skew prisms.
[https://forum.freecadweb.org/viewtopic.php?f=27&t=49343#p422857 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3793 pull request #3793]
|-
| [[File:PartDesign_Multiple-pattern-features.png|384px]]
| It is now possible to select several features in the document tree before executing a [[PartDesign_Workbench#Transformation_tools|transformation]]. This way several features can easily be transformed at once. The order of the features in the transformation dialog can be changed by dragging a feature to the desired position.
[https://forum.freecadweb.org/viewtopic.php?f=27&t=48998 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3748 pull request #3748], [https://github.com/FreeCAD/FreeCAD/pull/3760 #3760].
|-
| [[File:PartDesign_Multiple_selection.png|384px]]
| The dialogs to edit [[PartDesign_Fillet|fillets]], [[PartDesign_Chamfer|chamfers]], [[PartDesign_Thickness|thickness]], and [[PartDesign_Draft|draft]] features were improved to allow selecting several sub-elements (edges and faces) at once.
[https://forum.freecadweb.org/viewtopic.php?f=19&t=43383 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3050 pull request #3050], [https://www.freecadweb.org/wiki/images/b/b8/FC019-PD-Multiple-Selection.gif animated GIF] example.
|-
| [[File:PartDesign_Primitive_parameters_expressions.png|384px]]
| It is now possible to set [[Expressions|expressions]] for all parameters of [[PartDesign_CompPrimitiveAdditive|additive]] and [[PartDesign_CompPrimitiveSubtractive|subtractive primitives]].
[https://forum.freecadweb.org/viewtopic.php?f=3&t=36458 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3225 pull request #3225].
|-
| [[File:PartDesign_Attachment_angles_expressions.png|384px]]
| It is now possible to set [[Expressions|expressions]] for the attachment angles of additive and subtractive primitives. Formerly, expressions were only available for the direction offsets.
[https://forum.freecadweb.org/viewtopic.php?f=10&t=44346 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/1cfe6d2cc7 commit 1cfe6d2cc7].
|-
|
| It is now possible to change the list items in the different dialogs. For example [https://forum.freecadweb.org/viewtopic.php?f=27&t=48998#p420352 in this forum post] there is a god example why the item list matters for transformations. [https://forum.freecadweb.org/viewtopic.php?f=19&t=50222#p430499 Here] is another example for the sketch order for lofts.
[https://forum.freecadweb.org/viewtopic.php?f=27&t=48998 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3760 pull request #3760], [https://github.com/FreeCAD/FreeCAD/commit/94ca4388e commit 94ca4388e].
|}
|}


Line 280: Line 548:
| [[File:CoolantModes.png|384px]]
| [[File:CoolantModes.png|384px]]
| Added coolant modes for coolant management.
| Added coolant modes for coolant management.
[https://forum.freecadweb.org/viewtopic.php?f=15&t=38852&start=10#p329868 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2463 pull request #2463].
[https://forum.freecadweb.org/viewtopic.php?f=15&t=38852&start=10#p329868 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2463 pull request #2463].
|}
|}


* Tool manager support for multiple tool tables
=== Altro ===

* Added [[Path DressupBoundary]] for excluding parts of a path
<!-- [https://forum.freecadweb.org/viewtopic.php?f=15&t=41564&p=352927#p352927 forum discussion] -->

* PathPocket: Extensions (For milling open pockets).
* New unified Profile operation: The pre-existing Contour, Profile Faces, and Profile Edges of version 0.18.x are now combined into a single Profile operation. The new Profile operation maintains features and capabilities of the three individual source operations. [https://forum.freecadweb.org/viewtopic.php?style=1&f=15&t=39915 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3443 pull request #3443].
* Profile Edges: Open Edges support added. '''Note:''' ''The Profile Edges operation is now merged into the Profile operation.'' [https://forum.freecadweb.org/viewtopic.php?style=3&f=15&t=43434 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3068 pull request #3068].
* First attempt of 4th-axis support: Profile (limited to full contour and profiling of faces), PathPocket, and Drilling


* Fixed issue [https://freecadweb.org/tracker/view.php?id=0003993 #3993], Python 3 memory leak; [https://forum.freecadweb.org/viewtopic.php?f=10&t=36703 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/3c205946e commit 3c205946e].
* Fixed issue [https://freecadweb.org/tracker/view.php?id=0003993 #3993], Python 3 memory leak; [https://forum.freecadweb.org/viewtopic.php?f=10&t=36703 forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/3c205946e commit 3c205946e].
* Ability to use an arbitrary number of an object as the base model for a Path.Job, each one being positionable individually; [https://github.com/FreeCAD/FreeCAD/pull/2056 pull request #2056].
* Ability to use an arbitrary number of an object as the base model for a Path.Job, each one being positionable individually; [https://github.com/FreeCAD/FreeCAD/pull/2056 pull request #2056].
* PathDeburr: Added direction selection. Fixed DressupLeadInOut problem.
* MillFace
** Clear edges feature added.
** Exclude raised areas feature added; [https://forum.freecadweb.org/viewtopic.php?f=15&t=37873 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2367 pull request #2367].
** Added `Face Region` option to boundary options. This allows the cutter to access areas smaller than cutter diameter, but physically accessible within the part geometry. [https://forum.freecadweb.org/viewtopic.php?style=3&f=15&t=46881 forum mention], [https://github.com/FreeCAD/FreeCAD/pull/3534 pull request #3534].
* Adaptive Clearing improvements.
* 3D Pocket: Reduction of air-milling above inclined pockets; [https://forum.freecadweb.org/viewtopic.php?f=15&t=37869 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2366 pull request #2366].
* 3D Surface
** Improvements to general surfacing algorithm.
** Initial 4th-axis support; [https://forum.freecadweb.org/viewtopic.php?f=15&t=36018 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2114 pull request #2114].
** Selection of individual faces; [https://forum.freecadweb.org/viewtopic.php?style=3&f=15&t=41997 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2849 pull request #2849].
** Fixes to and addition of various cut patterns: Line, Circular, CircularZigZag, Offset, Spiral, ZigZag. [https://github.com/FreeCAD/FreeCAD/pull/3327 pull request #3327] and other pull requests.
* New operation: '''Waterline'''.
** The independent operation was split from 3D Surface; [https://forum.freecadweb.org/viewtopic.php?style=3&f=15&t=44473 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3268 pull request #3268].
** Experimental algorithm added using a combination of Path.Area() offsets of model cross-sections.
* Post Processing
** Update of some Post Processors (Mainly GRBL and LinuxCNC).
** Mach3/Mach4 Post Processor; [https://github.com/FreeCAD/FreeCAD/pull/3195 pull request #3195].
** Support tool height offset in the LinuxCNC Post Processor; [https://github.com/FreeCAD/FreeCAD/pull/2479 pull request #2479].

* New operation: '''Slot'''. Allows for creation of a horizontal slotting operation based on two custom points; the selection of one or more faces or edges; or the selection of two vertices. [https://forum.freecadweb.org/viewtopic.php?style=3&f=15&t=47693 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3624 initial pull request #3624].

* General:
** Added cycle time calculations to operations and total cycle time to the job; [https://forum.freecadweb.org/viewtopic.php?f=15&t=26864 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3378 pull request #3378].
** Added ability to import Base Geometry from existing operations within the same Job; [https://forum.freecadweb.org/viewtopic.php?style=3&f=15&t=46922 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3537 pull request #3537].
** Added icons to section headings in the Tasks Editor window for Base Geometry, Depths, Heights, and Operation; [https://github.com/FreeCAD/FreeCAD/pull/3631 pull request #3631].


== Ambiente Render ==
== Ambiente Render ==
Line 298: Line 600:
{|cellpadding=5
{|cellpadding=5
| [[File:Sketcher_Elements_mode_filter.png|384px]]
| [[File:Sketcher_Elements_mode_filter.png|384px]]
| In the Sketcher "Elements" panel there is now a "Mode" filter to select "normal", "construction", "external", or "all" geometry. This is useful to perform an action with only one type of geometry. For example, one use case is selecting only the "construction" edges, and deleting them after being used.
| In the Sketcher's [[task_panel|task panel]], in the "Elements" section there is now a "Mode" filter to select "normal", "construction", "external", or "all" geometry. This is useful to perform an action with only one type of geometry. For example, one use case is selecting only the "construction" edges, and deleting them after being used.

|-
| [[File:Sketcher_ToggleActiveConstraint_example_disabled_2.png|384px]]
| New [[Sketcher_ToggleActiveConstraint|Sketcher ToggleActiveConstraint]] tool to temporarily deactivate a constraint without removing it entirely. This is helpful to test the movement of the sketch before fully constraining it.
[https://github.com/FreeCAD/FreeCAD/pull/2283 Pull request #2283], [https://github.com/FreeCAD/FreeCAD/commit/159b8e7bdf commit 159b8e7bdf].

|-
| [[File:Sketcher_Constraint_reference_dialog.png]]
| It is now possible to make a dimension constraint a [[Sketcher_ToggleDrivingConstraint|reference constraint]] directly in the dialog.
[https://forum.freecadweb.org/viewtopic.php?f=3&t=33705 Forum discussion], [https://forum.freecadweb.org/viewtopic.php?f=3&t=36433 2]; [https://github.com/FreeCAD/FreeCAD/pull/3201 pull request #3201], [https://github.com/FreeCAD/FreeCAD/commit/06f479622c commit 06f479622c].
|}
|}

* New method to get the geometrical index of a [[Sketcher_SketchObject|sketch]], {{incode|SketchObject.getGeoVertexIndex(index)}}; [https://forum.freecadweb.org/viewtopic.php?f=8&t=48707 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3713 pull request #3713].


== Ambiente Spreadsheet ==
== Ambiente Spreadsheet ==


The introduction of "App::Link" also brought some improvements to the [[Expressions|Expressions]] capabilities of FreeCAD, which are visible in the [[Property editor|Property editor]], and the [[Spreadsheet Workbench|Spreadsheet Workbench]]. These are described in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes].
The introduction of [[App_Link|App Link]] also brought some improvements to the [[expressions|expressions]] capabilities of FreeCAD, which are visible in the [[property_editor|property editor]], and the [[Spreadsheet_Workbench|Spreadsheet Workbench]]. These are described in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes] and this [https://forum.freecadweb.org/viewtopic.php?f=27&t=38974 forum thread].
* A new expression syntax is introduced to unambiguously reference a property of the owner object, by omitting the object reference and starting with a leading dot ({{incode|.}}), similar to Python relative import syntax. So instead of {{incode|Cylinder.Height}}, now you can use {{incode|.Height}}.
* A new expression syntax is introduced to unambiguously reference a property of the owner object, by omitting the object reference and starting with a leading dot ({{incode|.}}), similar to Python relative import syntax. So instead of {{incode|Cylinder.Height}}, now you can use {{incode|.Height}}.
* You can refer to an object by its {{incode|Name}} or by its {{incode|Label}}. In the case of a {{incode|Label}}, it must be enclosed in {{incode|<<}} and {{incode|>>}} symbols, such as {{incode|<<Label>>}}. For example, {{incode|<<Metal_cylinder>>.Height}}.
* You can refer to an object by its {{incode|Name}} or by its {{incode|Label}}. In the case of a {{incode|Label}}, it must be enclosed in {{incode|<<}} and {{incode|>>}} symbols, such as {{incode|<<Label>>}}. For example, {{incode|<<Metal_cylinder>>.Height}}.
* Improved spreadsheet recomputation logic, and cell copy and paste functions.
* Improved spreadsheet recomputation logic, and cell copy and paste functions. [https://github.com/FreeCAD/FreeCAD/pull/2350 Pull request #2350], [https://github.com/FreeCAD/FreeCAD/pull/2475 #2475].

The previous commits changed the way the autocompletion works with [[expressions|expressions]], particularly when used with [[Sketcher_Workbench|Sketcher]] constraints, which was seen as a regression for many use cases. A new set of commits were proposed to restore this functionality; [https://forum.freecadweb.org/viewtopic.php?f=17&t=43412 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3062 pull request #3062].

{|cellpadding=5
| [[File:Spreadsheet_Alias_field.png|384px]]
| Aliases for table cells can now be set easier with a new input field at the upper right of the spreadsheet.
[https://forum.freecadweb.org/viewtopic.php?f=8&t=43957 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/3154 pull request #3154], [https://github.com/FreeCAD/FreeCAD/pull/3162 #3162], [https://github.com/FreeCAD/FreeCAD/pull/3233 #3233].
|}


==Ambiente Start==
==Ambiente Start==
Line 318: Line 640:
==Ambiente Surface==
==Ambiente Surface==


{|cellpadding=5
{{Emphasis|None}}
| [[File:Surface_Sections_example.png|384px]]
| The [[Surface_Sections|Surface Sections]] object has been added to create surfaces from edges that represent transversal sections.

[https://forum.freecadweb.org/viewtopic.php?f=8&t=46895 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/3a8a6aae1b commit 3a8a6aae1b].

|-
| [[File:Surface_ExtendFace_example.png|384px]]
| The [[Surface_Module|Surface Workbench documentation]] has been rewritten, and expanded with more images and scripting examples, in order to showcase better the tools of the workbench. All commands are now available from the toolbar: [[Surface_Filling|Surface Filling]], [[Surface_GeomFillSurface|Surface GeomFillSurface]], [[Surface_Sections|Surface Sections]], [[Surface_ExtendFace|Surface ExtendFace]], and [[Surface_CurveOnMesh|Surface CurveOnMesh]].

Likewise, the icons have been updated to be more visually attractive.
|}


== Ambiente TechDraw ==
== Ambiente TechDraw ==
Line 326: Line 659:
| Improved placing and scaling of a 3D viewport screenshot in a TechDraw page.
| Improved placing and scaling of a 3D viewport screenshot in a TechDraw page.
[https://forum.freecadweb.org/viewtopic.php?f=10&t=34539#p290451 Forum discussion].
[https://forum.freecadweb.org/viewtopic.php?f=10&t=34539#p290451 Forum discussion].

|-
|-
| [[File:Techdraw_balloon.png|384px]]
| [[File:Techdraw_balloon.png|384px]]
| New [[TechDraw Balloon|TechDraw Balloon]] tool to add balloon decorators to create notes with numbers, letters, and text.
| New [[TechDraw_Balloon|TechDraw Balloon]] tool to add balloon decorators to create notes with numbers, letters, and text.
[https://forum.freecadweb.org/viewtopic.php?f=35&t=34484 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2013 pull request #2013].
[https://forum.freecadweb.org/viewtopic.php?f=35&t=34484 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2013 pull request #2013].

|-
|-
| [[File:Techdraw_leaderline.png|384px]]
| [[File:Techdraw_leaderline.png|384px]]
| New [[TechDraw LeaderLine|TechDraw LeaderLine]] and [[TechDraw RichTextBlock|TechDraw RichTextBlock]] tools to create better annotations in the drawing page.
| New [[TechDraw_LeaderLine|TechDraw LeaderLine]] and [[TechDraw_RichTextAnnotation|TechDraw RichTextAnnotation]] tools to create better annotations in the drawing page.
[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=36169 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/7f07195f938eb76294c1de72339da5ff50093e8f commit 7f07195f93], [https://github.com/FreeCAD/FreeCAD/commit/6c699887c02268c697a580aceaf0687d4dc53df0 commit 6c699887c0]; testing and bug fixing [https://github.com/FreeCAD/FreeCAD/commit/ab986d9a00 commit ab986d9a00], [https://github.com/FreeCAD/FreeCAD/commit/15f440525e commit 15f440525e], [https://github.com/FreeCAD/FreeCAD/commit/8ef3f13fbb commit 8ef3f13fbb], [https://github.com/FreeCAD/FreeCAD/commit/bf38ae958f commit bf38ae958f], [https://github.com/FreeCAD/FreeCAD/commit/74737f71fd commit 74737f71fd], [https://github.com/FreeCAD/FreeCAD/commit/be257182ba commit be257182ba], [https://github.com/FreeCAD/FreeCAD/commit/de3715908e commit de3715908e], [https://github.com/FreeCAD/FreeCAD/commit/916fe7ced3 commit 916fe7ced3].
[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=36169 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/7f07195f938eb76294c1de72339da5ff50093e8f commit 7f07195f93], [https://github.com/FreeCAD/FreeCAD/commit/6c699887c02268c697a580aceaf0687d4dc53df0 commit 6c699887c0]; testing and bug fixing [https://github.com/FreeCAD/FreeCAD/commit/ab986d9a00 commit ab986d9a00], [https://github.com/FreeCAD/FreeCAD/commit/15f440525e commit 15f440525e], [https://github.com/FreeCAD/FreeCAD/commit/8ef3f13fbb commit 8ef3f13fbb], [https://github.com/FreeCAD/FreeCAD/commit/bf38ae958f commit bf38ae958f], [https://github.com/FreeCAD/FreeCAD/commit/74737f71fd commit 74737f71fd], [https://github.com/FreeCAD/FreeCAD/commit/be257182ba commit be257182ba], [https://github.com/FreeCAD/FreeCAD/commit/de3715908e commit de3715908e], [https://github.com/FreeCAD/FreeCAD/commit/916fe7ced3 commit 916fe7ced3].

|-
|-
| [[File:Cosmetic_dimension.png|384px]]
| [[File:Cosmetic_dimension.png|384px]]
| New [[TechDraw CosmeticVertex|TechDraw CosmeticVertex]], [[TechDraw_Midpoints|TechDraw Midpoints]], and [[TechDraw_Quadrant|TechDraw Quadrant]] tools, which allow the user to place fake or "cosmetic" vertices that can be used to create dimensions. The midpoint and quadrant vertices can be used to add more points to straight and curved edges (circular arcs), respectively; the "CosmeticVertex" tool can add a point anywhere on the drawing view without requiring being based on existing geometry.
| New [[TechDraw CosmeticVertex|TechDraw CosmeticVertex]], [[TechDraw_Midpoints|TechDraw Midpoints]], and [[TechDraw_Quadrants|TechDraw Quadrant]] tools, which allow the user to place fake or "cosmetic" vertices that can be used to create dimensions. The midpoint and quadrant vertices can be used to add more points to straight and curved edges (circular arcs), respectively; the "CosmeticVertex" tool can add a point anywhere on the drawing view without requiring being based on existing geometry.
[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=36614 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/59e47de5064e3112e65c51a0d32b1ad4584b6a80 commit 59e47de506], [https://github.com/FreeCAD/FreeCAD/commit/94b167f3a200f0a84365dccafcfeb3542f7a6795 commit 94b167f3a2].
[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=36614 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/59e47de5064e3112e65c51a0d32b1ad4584b6a80 commit 59e47de506], [https://github.com/FreeCAD/FreeCAD/commit/94b167f3a200f0a84365dccafcfeb3542f7a6795 commit 94b167f3a2].

|-
|-
| [[File:Cosmetic_eraser.png|384px]]
| [[File:Cosmetic_eraser.png]]
| New [[TechDraw_FaceCenterLine|TechDraw FaceCenterLine]], [[TechDraw 2LineCenterLine|TechDraw 2LineCenterLine]], and [[TechDraw 2PointCenterLine|TechDraw 2PointCenterLine]] tools, to add a line in the center of a face, or between two existing edges, or between two existing points, respectively.
| New [[TechDraw_FaceCenterLine|TechDraw FaceCenterLine]], [[TechDraw 2LineCenterLine|TechDraw 2LineCenterLine]], and [[TechDraw 2PointCenterLine|TechDraw 2PointCenterLine]] tools, to add a line in the center of a face, or between two existing edges, or between two existing points, respectively.


Line 345: Line 682:


[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=36875 Forum discussion] (v1, alpha), [https://forum.freecadweb.org/viewtopic.php?f=35&t=37749 forum discussion] (v2), [https://github.com/FreeCAD/FreeCAD/commit/656e1654ff0825173a7d03f9b1b9ca8866d59adb commit 656e1654ff], [https://github.com/FreeCAD/FreeCAD/commit/93431edfba377c58dc1e49d68c39574057111523 commit 93431edfba], [https://github.com/FreeCAD/FreeCAD/commit/f25826bba3124f46e267d9a4cf078dda7e6c031d commit f25826bba3], [https://github.com/FreeCAD/FreeCAD/commit/11d8aaed616b81eda8658f2d63bd97db5b4a87c7 commit 11d8aaed61], [https://github.com/FreeCAD/FreeCAD/commit/941968b37cd45505a5668a1df17ba9b8d6f9a66b commit 941968b37c].
[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=36875 Forum discussion] (v1, alpha), [https://forum.freecadweb.org/viewtopic.php?f=35&t=37749 forum discussion] (v2), [https://github.com/FreeCAD/FreeCAD/commit/656e1654ff0825173a7d03f9b1b9ca8866d59adb commit 656e1654ff], [https://github.com/FreeCAD/FreeCAD/commit/93431edfba377c58dc1e49d68c39574057111523 commit 93431edfba], [https://github.com/FreeCAD/FreeCAD/commit/f25826bba3124f46e267d9a4cf078dda7e6c031d commit f25826bba3], [https://github.com/FreeCAD/FreeCAD/commit/11d8aaed616b81eda8658f2d63bd97db5b4a87c7 commit 11d8aaed61], [https://github.com/FreeCAD/FreeCAD/commit/941968b37cd45505a5668a1df17ba9b8d6f9a66b commit 941968b37c].

|-
|-
| [[File:TechDraw_WeldingSymbol_example.png|384px]]
| [[File:TechDraw_WeldingSymbol_example.png|384px]]
| New [[TechDraw_WeldingSymbol|TechDraw WeldingSymbol]] tool to provide welding symbols. One of the most requested features from the older Drawing Workbench is finally in TechDraw.
| New [[TechDraw_WeldSymbol|TechDraw WeldSymbol]] tool to provide welding symbols. One of the most requested features from the older Drawing Workbench is finally in TechDraw. Russian standard (GOST) symbols are also added.

[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=38560 Forum discussion] (testing), [https://forum.freecadweb.org/viewtopic.php?f=35&t=38762 forum discussion] (main thread); [https://github.com/FreeCAD/FreeCAD/pull/2446 pull request #2446].
[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=38560 Forum discussion] (testing), [https://forum.freecadweb.org/viewtopic.php?f=35&t=38762 forum discussion] (main thread); [https://github.com/FreeCAD/FreeCAD/pull/2446 pull request #2446], [https://github.com/FreeCAD/FreeCAD/pull/3110 #3110].


[https://github.com/hamish2014/FreeCAD_drawing_dimensioning/tree/master/Gui/Resources/icons Old welding symbols] from Drawing Workbench.
[https://github.com/hamish2014/FreeCAD_drawing_dimensioning/tree/master/Gui/Resources/icons Old welding symbols] from Drawing Workbench.
|-
|-
| [[File:TechDraw_ActiveView_example.png|384px]]
| [[File:TechDraw_ActiveView_example.png|384px]]
| New [[TechDraw ActiveView|TechDraw ActiveView]] tool. It produces a static image from the active 3D view, and puts it in a new TechDraw view. The result is a snapshot that doesn't update with changes to the model, and which is very fast to produce because it doesn't perform hidden line removal calculations. It is intended for rapid visualization of models, or to display flat projections of models without needing to add dimensions, a workflow that may be interesting for architectural visualization. Together with [[Arch SectionPlane|Arch SectionPlane]] and [[TechDraw NewArch|TechDraw NewArch]], [[TechDraw ActiveView|TechDraw ActiveView]] hopes to improve the interaction between [[Arch Workbench|Arch]] and [[TechDraw Workbench|TechDraw]] to document building models.
| New [[TechDraw_ActiveView|TechDraw ActiveView]] tool. It produces a static image from the active 3D view, and puts it in a new TechDraw view. The result is a snapshot that doesn't update with changes to the model, and which is very fast to produce because it doesn't perform hidden line removal calculations. It is intended for rapid visualization of models, or to display flat projections of models without needing to add dimensions, a workflow that may be interesting for architectural visualization. Together with [[Arch_SectionPlane|Arch SectionPlane]] and [[TechDraw_ArchView|TechDraw ArchView]], [[TechDraw_ActiveView|TechDraw ActiveView]] hopes to improve the interaction between [[Arch_Workbench|Arch]] and [[TechDraw_Workbench|TechDraw]] to document building models.


[https://forum.freecadweb.org/viewtopic.php?f=35&t=38957 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/13676bfe57 commit 13676bfe57].
[https://forum.freecadweb.org/viewtopic.php?f=35&t=38957 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/13676bfe57 commit 13676bfe57].
Line 363: Line 702:
| [[File:TechDraw_A4_Landscape_CN.svg|384px]]
| [[File:TechDraw_A4_Landscape_CN.svg|384px]]
| New page templates, the People's Republic of China Templates A series; please use with font family "HYSWLongFangSong".
| New page templates, the People's Republic of China Templates A series; please use with font family "HYSWLongFangSong".
[https://forum.freecadweb.org/viewtopic.php?f=27&t=37459 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2322 pull request #2322].
[https://forum.freecadweb.org/viewtopic.php?f=27&t=37459 Forum discussion], [https://forum.freecadweb.org/viewtopic.php?f=17&t=48854 2], [https://github.com/FreeCAD/FreeCAD/pull/2322 pull request #2322].
|-
|-
| [[File:A3 (L) -- freesans (italic) -- vpetje (da) -- logotip (ne) -- sestavna risba (5).svg|384px]]
| [[File:A3 (L) -- freesans (italic) -- vpetje (da) -- logotip (ne) -- sestavna risba (5).svg|384px]]
Line 375: Line 714:


[https://forum.freecadweb.org/viewtopic.php?f=35&t=39571 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2552 pull request #2552].
[https://forum.freecadweb.org/viewtopic.php?f=35&t=39571 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2552 pull request #2552].

|-
| [[File:TechDraw_Dimension_Horizontal_Extent_example.png|384px]]
| New [[TechDraw_Dimension_Horizontal_Extent|TechDraw Dimension Horizontal Extent]] and [[TechDraw_Dimension_Vertical_Extent|TechDraw Dimension Vertical Extent]], to obtain the maximum dimensions in a view.
[https://forum.freecadweb.org/viewtopic.php?f=35&t=40037 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2680 pull request 2680], [http://github.com/FreeCAD/FreeCAD/commit/a7d9661b1d5c5795 commit a7d9661b1d].

|-
| [[File:TechDraw_DetailView_Task_Dialog.png]]
| New task dialog to set up [[TechDraw_DetailView|Detail Views]].
[https://forum.freecadweb.org/viewtopic.php?f=35&t=45236 Forum discussion].

|-
| [[File:TechDraw_pyramid_arrow_style.png|300px]]
| New pyramid arrow style for dimensions and balloon annotations.
[https://www.forum.freecadweb.org/viewtopic.php?p=356630 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2853 pull request #2853].

|-
| [[File:TechDraw_ExportedHatch_example.png|300px]]
| SVG face hatches are now available when the page is exported to SVG. The SVG hatches are converted to bitmaps and clipped to fit the face before export. The example image shows the exported SVG page when it is opened in Inkscape.

[https://www.forum.freecadweb.org/viewtopic.php?f=35&t=47013 Forum discussion], [https://github.com/FreeCAD/FreeCAD/commit/a9b718d1e0 commit a9b718d1e0].
|}
|}


=== Altro ===
=== Altro ===


* There has been discussions about changing the standard behavior of TechDraw. Instead of keeping the drawing pages updated automatically, they would be updated only on demand; this would mitigate the effects of TechDraw slowing down the rest of FreeCAD when modelling. Moreover, now that "App::Link" is included in FreeCAD, TechDraw pages may be stored in a separate file, and loaded on demand; [https://forum.freecadweb.org/viewtopic.php?f=35&t=35086 forum discussion] (main discussion), [https://forum.freecadweb.org/viewtopic.php?f=35&t=38822 forum discussion] (alternatives).
* There has been discussions about changing the standard behavior of TechDraw. Instead of keeping the drawing pages updated automatically, they would be updated only on demand; this would mitigate the effects of TechDraw slowing down the rest of FreeCAD when modelling. Moreover, now that [[App_Link|App Link]] is included in FreeCAD, TechDraw pages may be stored in a separate file, and loaded on demand; [https://forum.freecadweb.org/viewtopic.php?f=35&t=35086 forum discussion] (main discussion), [https://forum.freecadweb.org/viewtopic.php?f=35&t=38822 forum discussion] (alternatives).
* Improvements on the handling of sectional views with [[TechDraw SectionView]]; [https://forum.freecadweb.org/viewtopic.php?f=35&t=40639 Forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2737 pull request #2737].
* Fixed font size issues when exporting to SVG; [https://forum.freecadweb.org/viewtopic.php?f=35&t=27108 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2219 pull request #2219].
* Fixed font size issues when exporting to SVG; [https://forum.freecadweb.org/viewtopic.php?f=35&t=27108 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2219 pull request #2219].
* Fixed regression in caption handling and hide caption property where not applicable; [https://github.com/FreeCAD/FreeCAD/pull/2228 pull request #2228].
* Fixed regression in caption handling and hide caption property where not applicable; [https://github.com/FreeCAD/FreeCAD/pull/2228 pull request #2228].
Line 386: Line 747:
* Finer control of drawing updates; [https://forum.freecadweb.org/viewtopic.php?f=35&t=38956 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2468 pull request #2468], [https://github.com/FreeCAD/FreeCAD/commit/5bed53f858 commit 5bed53f858], [https://github.com/FreeCAD/FreeCAD/commit/b2d8eeeb65 commit b2d8eeeb65].
* Finer control of drawing updates; [https://forum.freecadweb.org/viewtopic.php?f=35&t=38956 forum discussion], [https://github.com/FreeCAD/FreeCAD/pull/2468 pull request #2468], [https://github.com/FreeCAD/FreeCAD/commit/5bed53f858 commit 5bed53f858], [https://github.com/FreeCAD/FreeCAD/commit/b2d8eeeb65 commit b2d8eeeb65].
* Also new [[TechDraw_Redraw|TechDraw Redraw]] tool to force a drawing page update while ignoring the state of the options "Update with 3d", "Allow page override", or "KeepUpdated". This tool disappeared in 0.18, but was re-implemented for 0.19; [https://forum.freecadweb.org/viewtopic.php?f=35&t=38956 forum discussion].
* Also new [[TechDraw_Redraw|TechDraw Redraw]] tool to force a drawing page update while ignoring the state of the options "Update with 3d", "Allow page override", or "KeepUpdated". This tool disappeared in 0.18, but was re-implemented for 0.19; [https://forum.freecadweb.org/viewtopic.php?f=35&t=38956 forum discussion].
* The new [[App_Link|App Link]] object is now supported as a source for creating views; [https://forum.freecadweb.org/viewtopic.php?f=35&t=41973 forum discussion], [http://github.com/FreeCAD/FreeCAD/commit/37b578bf49 commit 37b578bf49].
* The center marks created from circular edges, can now be printed; [https://github.com/FreeCAD/FreeCAD/pull/2335 pull request #2335], [https://github.com/FreeCAD/FreeCAD/pull/2962 #2962].


== Material Handling ==
== Web ==


* QtWebEngine support for Qt 5.7 and above, and fallback to QWebkit for Qt 5.6 and below; [https://github.com/FreeCAD/FreeCAD/pull/1937 pull request #1937].
{{Emphasis|None}}


== Macro ==
== Macro ==
Line 398: Line 761:
| [[File:Structural_frame.png|384px]]
| [[File:Structural_frame.png|384px]]
| Automatic light-gauge steel frame creator and panelizer.
| Automatic light-gauge steel frame creator and panelizer.
[https://forum.freecadweb.org/viewtopic.php?f=23&t=26092 Forum discussion] | [https://peertube.social/videos/watch/cbd2efd0-f763-41ac-9e38-2e0034c56703 Screencast] | [https://gitlab.com/Oriond/FreeCAD-Steel_Frame FreeCAD-Steel_Frame] repository (GPL 3).
[https://forum.freecadweb.org/viewtopic.php?f=23&t=26092 Forum discussion]; [https://gitlab.com/Oriond/FreeCAD-Steel_Frame FreeCAD-Steel_Frame] repository (GPL 3), [https://peertube.social/videos/watch/cbd2efd0-f763-41ac-9e38-2e0034c56703 video] example.
|}
|}


== Moduli aggiuntivi ==
== Moduli aggiuntivi ==


See [[External workbenches|external workbenches]] for the full list of additional workbenches that can be installed in FreeCAD. If you want to see your workbench added, join the forum and present your code.
{{Emphasis|Note:}} these are the new workbenches created in this development cycle, or older workbenches that received updates. See [[External workbenches|external workbenches]] for more workbenches that can be installed, and which cover a wide variety of topics. If you want to see your workbench added, join the [https://forum.freecadweb.org/index.php forum] and present your code.


=== 3D Printing Tools ===
=== 3D Printing Tools ===
Line 411: Line 774:
| Previously it was called "MeshTools". It has utilities for working with imported STL meshes which could be used for 3D printing, like scaling the mesh up and down, scale it to fit a 3D printer, make objects transparent, hide and show objects, change colors and line widths of groups of objects, and others.
| Previously it was called "MeshTools". It has utilities for working with imported STL meshes which could be used for 3D printing, like scaling the mesh up and down, scale it to fit a 3D printer, make objects transparent, hide and show objects, change colors and line widths of groups of objects, and others.


[https://forum.freecadweb.org/viewtopic.php?f=9&t=36564 Forum discussion] | [https://github.com/mark1791/3D_Printing_Tools 3D Printing Tools] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?f=9&t=36564 Forum discussion]; [https://github.com/mark1791/3D_Printing_Tools 3D Printing Tools] repository (LGPL 2.1).
|}
|}


Line 419: Line 782:
| [[File:A2plus.jpg|384px]]
| [[File:A2plus.jpg|384px]]
| The successor to the Assembly2 workbench, [[A2plus_Workbench|A2plus]] is the most mature assembly workbench, and has received important updates in this development cycle, like an improved point on plane constraint, and point on line constraint, using the center of a sphere as the point; this improves the constraining of spheres.
| The successor to the Assembly2 workbench, [[A2plus_Workbench|A2plus]] is the most mature assembly workbench, and has received important updates in this development cycle, like an improved point on plane constraint, and point on line constraint, using the center of a sphere as the point; this improves the constraining of spheres.
[https://forum.freecadweb.org/viewtopic.php?f=20&t=29207 Forum discussion] | [https://github.com/kbwbe/A2plus A2plus] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?f=20&t=29207 Forum discussion]; [https://github.com/kbwbe/A2plus A2plus] repository (LGPL 2.1).


Please note: A2plus is not compatible with Assembly2 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in A2plus.
Please note: A2plus is not compatible with Assembly2 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in A2plus.
Line 428: Line 791:
{|cellpadding=5
{|cellpadding=5
| [[File:Assembly3_0.19.png|384px]]
| [[File:Assembly3_0.19.png|384px]]
| Assembly3 is an assembly workbench created by developer {{Emphasis|realthunder}}, that is inspired by Assembly2, but is not compatible with it. Assembly3 makes use of realthunder's "App::Link" object and various significant changes to the internal code of FreeCAD. Because of this reason, Assembly3 cannot be installed simply from the Addon Manager. Instead, realthunder provides a pre-compiled version of FreeCAD that includes Assembly3. This workbench serves as a testing environment for the "App::Link" object, and other changes that realthunder plans to submit to the main FreeCAD source code.
| [[Assembly3_Workbench|Assembly3]] is an assembly workbench created by developer {{Emphasis|realthunder}}, that is inspired by [[Assembly2_Workbench|Assembly2]], but is not compatible with it. Assembly3 makes use of realthunder's [[App_Link|App Link]] object and various significant changes to the internal code of FreeCAD. Because of this reason, Assembly3 cannot be installed simply from the Addon Manager. Instead, realthunder provides a pre-compiled version of FreeCAD that includes Assembly3. This workbench serves as a testing environment for the [[App_Link|App Link]] object, and other changes that realthunder plans to submit to the main FreeCAD source code.


The Assembly3 workbench can also be tested in the development [[AppImage|AppImage]].
[https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Forum discussion] (massive thread) | [https://github.com/realthunder/FreeCAD_assembly3 FreeCAD_assembly3] repository (GPL 3).

[https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Forum discussion] (massive thread); [https://github.com/realthunder/FreeCAD_assembly3 FreeCAD_assembly3] repository (GPL 3).


Please note: Assembly3 is not compatible with Assembly2 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in Assembly3.
Please note: Assembly3 is not compatible with Assembly2 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in Assembly3.
Line 439: Line 804:
{|cellpadding=5
{|cellpadding=5
| [[File:Assembly4_0.19.png|384px]]
| [[File:Assembly4_0.19.png|384px]]
| Assembly4 is an assembly workbench created by developer {{Emphasis|Zolko}}, that uses realthunder's "App::Link" object and many other changes to the base FreeCAD system. Because of this, Assembly4 cannot be installed simply from the Addon Manager. Instead, first the pre-compiled FreeCAD from realthunder needs to be installed, and then Assembly4 can be installed.
| [[Assembly4_Workbench|Assembly4]] is an assembly workbench created by developer {{Emphasis|Zolko}}, that uses realthunder's [[App_Link|App Link]] object and many other changes to the base FreeCAD system, particularly the new [[expressions|expression engine]]. Because of this, Assembly4 doesn't work with versions below 0.19. Assembly4 can be installed from the [[Std_AddonMgr|Addon Manager]].


Assembly4 is an experimental workbench that tries to perform assembly without using a constraint solver, but rather with the concept of arranging local coordinate systems.
Unlike [[A2plus_Workbench|A2plus]] and [[Assembly3_Workbench|Assembly3]], Assembly4 tries to perform assembly without using a constraint solver, but rather with the concept of arranging local coordinate systems (LCS) and setting relationships through [[expressions|mathematical expressions]].


[https://forum.freecadweb.org/viewtopic.php?f=20&t=32843 Forum discussion] (original idea), [https://forum.freecadweb.org/viewtopic.php?f=20&t=34806 forum discussion] (main thread) | [https://github.com/Zolko-123/FreeCAD_Assembly4 FreeCAD_Assembly4] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?f=20&t=32843 Forum discussion] (original idea), [https://forum.freecadweb.org/viewtopic.php?f=20&t=34806 forum discussion] (main thread); [https://github.com/Zolko-123/FreeCAD_Assembly4 FreeCAD_Assembly4] repository (LGPL 2.1).


Please note: Assembly4 is not compatible with Assembly3 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in Assembly4.
Please note: Assembly4 is not compatible with Assembly3 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in Assembly4.
Line 453: Line 818:
| [[File:ArchTextures_0.19.png|384px]]
| [[File:ArchTextures_0.19.png|384px]]
| The ArchTextures Workbench was developed to provide basic texture support to [[Arch Workbench|Arch Workbench]] elements like walls and roofs, in order to quickly visualize a building. It is not intended to produce photo-realistic renderings, just simple texturing of materials like wood, brick, and concrete. It also provides lights (directional, point, and spot), which makes it more feature complete to set up a scene.
| The ArchTextures Workbench was developed to provide basic texture support to [[Arch Workbench|Arch Workbench]] elements like walls and roofs, in order to quickly visualize a building. It is not intended to produce photo-realistic renderings, just simple texturing of materials like wood, brick, and concrete. It also provides lights (directional, point, and spot), which makes it more feature complete to set up a scene.
[https://forum.freecadweb.org/viewtopic.php?f=3&t=38222 Forum discussion] (help requests), [https://forum.freecadweb.org/viewtopic.php?f=10&t=38223 forum discussion] (development), [https://forum.freecadweb.org/viewtopic.php?f=9&t=31598 forum discussion] (only announcements), [https://forum.freecadweb.org/viewtopic.php?f=9&t=39031 forum discussion] (announcement of lights) | [https://github.com/furti/FreeCAD-ArchTextures FreeCAD-ArchTextures] repository (MIT).
[https://forum.freecadweb.org/viewtopic.php?f=3&t=38222 Forum discussion] (help requests), [https://forum.freecadweb.org/viewtopic.php?f=10&t=38223 forum discussion] (development), [https://forum.freecadweb.org/viewtopic.php?f=9&t=31598 forum discussion] (only announcements), [https://forum.freecadweb.org/viewtopic.php?f=9&t=39031 forum discussion] (announcement of lights); [https://github.com/furti/FreeCAD-ArchTextures FreeCAD-ArchTextures] repository (MIT).
|}
|}


Line 461: Line 826:
| [[File:BOLTSFC_0.19.png|384px]]
| [[File:BOLTSFC_0.19.png|384px]]
| BOLTS is an "open library of technical specifications"; it is meant to provide free, standardized parts defined parametrically that can be used in different CAD systems like OpenSCAD and FreeCAD. The BOLTS library was launched in 2013 but received little maintenance since 2016. Now, with a new maintainer and repository, the project has revived with the BOLTSFC workbench that provides an interface to insert the different parametric objects.
| BOLTS is an "open library of technical specifications"; it is meant to provide free, standardized parts defined parametrically that can be used in different CAD systems like OpenSCAD and FreeCAD. The BOLTS library was launched in 2013 but received little maintenance since 2016. Now, with a new maintainer and repository, the project has revived with the BOLTSFC workbench that provides an interface to insert the different parametric objects.
[https://forum.freecadweb.org/viewtopic.php?f=8&t=4549 Forum discussion] | [https://www.bolts-library.org/en/index.html Homepage] | [https://github.com/boltsparts/BOLTSFC BOLTSFC] repository, [https://github.com/boltsparts/BOLTS BOLTS] main repository (GPL 3).
[https://forum.freecadweb.org/viewtopic.php?f=8&t=4549 Forum discussion]; [https://www.bolts-library.org/en/index.html Homepage], [https://github.com/boltsparts/BOLTSFC BOLTSFC] repository, [https://github.com/boltsparts/BOLTS BOLTS] main repository (GPL 3).
|}
|}


Line 469: Line 834:
| [[File:Curved_shapes_wb.png|384px]]
| [[File:Curved_shapes_wb.png|384px]]
| The CurvedShapes workbench has tools for designing 3D surfaces starting from a skeleton of multiple curves in the XY, XZ, or YZ planes. It was created particularly to simplify the modelling of the wings of aircrafts.
| The CurvedShapes workbench has tools for designing 3D surfaces starting from a skeleton of multiple curves in the XY, XZ, or YZ planes. It was created particularly to simplify the modelling of the wings of aircrafts.
[https://forum.freecadweb.org/viewtopic.php?f=8&t=36989 Forum discussion] | [https://github.com/chbergmann/CurvedShapesWorkbench CurvedShapesWorkbench] repository (LGPL 3).
[https://forum.freecadweb.org/viewtopic.php?f=8&t=36989 Forum discussion]; [https://github.com/chbergmann/CurvedShapesWorkbench CurvedShapesWorkbench] repository (LGPL 3).
|}
|}


Line 478: Line 843:
| Dodo is the successor to the [[Flamingo Workbench|Flamingo Workbench]], a workbench specialized in creating piping and frames. While Flamingo was developed for Python 2 and Qt4, Dodo is meant to work with Python 3 and Qt5. It provides the same features as Flamingo, but has improved tools and interfaces.
| Dodo is the successor to the [[Flamingo Workbench|Flamingo Workbench]], a workbench specialized in creating piping and frames. While Flamingo was developed for Python 2 and Qt4, Dodo is meant to work with Python 3 and Qt5. It provides the same features as Flamingo, but has improved tools and interfaces.


[https://forum.freecadweb.org/viewtopic.php?f=8&t=22711 Forum discussion] (main thread), [https://forum.freecadweb.org/viewtopic.php?p=304165#p304165 forum discussion] (Dodo announcement), [https://forum.freecadweb.org/viewtopic.php?f=36&t=38464 tutorial] | [https://github.com/oddtopus/flamingo flamingo] repository (LGPL 3), [https://github.com/oddtopus/dodo/ dodo] repository (LGPL 3).
[https://forum.freecadweb.org/viewtopic.php?f=8&t=22711 Forum discussion] (main thread), [https://forum.freecadweb.org/viewtopic.php?p=304165#p304165 forum discussion] (Dodo announcement), [https://forum.freecadweb.org/viewtopic.php?f=36&t=38464 tutorial]; [https://github.com/oddtopus/dodo/ dodo] repository (LGPL 3), [https://github.com/oddtopus/flamingo flamingo] repository (LGPL 3).
|}
|}


Line 486: Line 851:
| [[File:Fastener_workbench.png|384px]]
| [[File:Fastener_workbench.png|384px]]
| The [[Fasteners Workbench|Fasteners Workbench]] to generate standard ISO screws, bolts, washers, and other fasteners, was updated to work with Python 3 and Qt5.
| The [[Fasteners Workbench|Fasteners Workbench]] to generate standard ISO screws, bolts, washers, and other fasteners, was updated to work with Python 3 and Qt5.
[https://forum.freecadweb.org/viewtopic.php?t=11429 Forum discussion], [https://github.com/shaise/FreeCAD_FastenersWB FreeCAD_FasternersWB] repository (GPL 2), [http://theseger.com/projects/2015/07/generating-holes-for-countersunk-screws-in-freecad/ additional details].
[https://forum.freecadweb.org/viewtopic.php?t=11429 Forum discussion]; [https://github.com/shaise/FreeCAD_FastenersWB FreeCAD_FasternersWB] repository (GPL 2), [http://theseger.com/projects/2015/07/generating-holes-for-countersunk-screws-in-freecad/ additional details].
|}

=== Geomatics Workbench ===

{|cellpadding=5
| [[File:Geomatics_Workbench_0.19.png|384px]]
| A workbench that provides functionality specific to Geomatics and Survey engineering, such as importing geodata information, and creating surfaces from clouds of points. There are some issues with rendering objects that use large coordinates (kilometers) and importing large DXF files. If you want to help solving these issues, please contact the developers.
[https://forum.freecadweb.org/viewtopic.php?f=8&t=34371 Forum discussion] | [https://github.com/HakanSeven12/FreeCAD-Geomatics-Workbench FreeCAD-Geomatics-Workbench] repository (LGPL 2.1).
|}
|}


Line 501: Line 858:
{|cellpadding=5
{|cellpadding=5
| [[File:MeshRemodel_Workbench_0.19.png|384px]]
| [[File:MeshRemodel_Workbench_0.19.png|384px]]
| This workbench helps convert a mesh, for example, an imported STL file, into a native FreeCAD object. It will not do the conversion automatically, but it will help re-build, or re-model, the imported mesh. The general workflow is to select the mesh object, then create a "points" object from it; then these points can be used as references for creating FreeCAD objects such as lines, polygons, circles, arcs, and BSplines. These wires can then be turned into a [[Sketcher Workbench|Sketch]] object, which can be padded to create a 3D solid with the [[PartDesign Workbench|PartDesign Workbench]].
| This workbench helps convert a mesh, for example, an imported STL file, into a native FreeCAD object. It will not do the conversion automatically, but it will help re-build, or re-model, the imported mesh. The general workflow is to select the mesh object, then create a "points" object from it; then these points can be used as references for creating FreeCAD objects such as lines, polygons, circles, arcs, and BSplines. These wires can then be turned into a [[Sketcher_Workbench|Sketch]] object, which can be padded to create a 3D solid with the [[PartDesign Workbench|PartDesign Workbench]].


[https://forum.freecadweb.org/viewtopic.php?f=9&t=38670 Forum discussion] (only announcement) | [https://github.com/mwganson/MeshRemodel MeshRemodel] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?f=9&t=38670 Forum discussion] (only announcement); [https://github.com/mwganson/MeshRemodel MeshRemodel] repository (LGPL 2.1).
|}
|}


Line 514: Line 871:
At this moment, the workbench is only offered in the French language.
At this moment, the workbench is only offered in the French language.


[https://forum.freecadweb.org/viewtopic.php?f=9&t=37584 Forum discussion] | [https://framagit.org/freecad-france/mooc-workbench mooc-workbench] repository (GPL 2).
[https://forum.freecadweb.org/viewtopic.php?f=9&t=37584 Forum discussion]; [https://framagit.org/freecad-france/mooc-workbench mooc-workbench] repository (GPL 2).
|}
|}


Line 523: Line 880:
| The NodeEditor workbench implements a system of nodes that can be used to dynamically control the properties of objects, similar to Blender's node system to edit materials. The NodeEditor is based on a slightly modified version of the PyFlow framework, which is under active development.
| The NodeEditor workbench implements a system of nodes that can be used to dynamically control the properties of objects, similar to Blender's node system to edit materials. The NodeEditor is based on a slightly modified version of the PyFlow framework, which is under active development.


A node editor has been a requested feature for a very long time, at least since 2014 (see [https://forum.freecadweb.org/viewtopic.php?f=8&t=7442 this thread]). A fully working node editor has the potential of simplifying the drawing of complex shapes using generative algorithms that produce a shape based on the values of its inputs. This could be used to create various types of meshes and surfaces with applications in architecture and mechanical design.
A node editor has been a requested feature for a very long time, at least since 2014 (see [https://forum.freecadweb.org/viewtopic.php?f=8&t=7442 this thread]). A fully working node editor has the potential of simplifying the drawing of complex shapes using generative algorithms that produce a shape based on the values of its inputs. This could be used to create various types of meshes and surfaces with many applications in architecture and mechanical design.


[https://forum.freecadweb.org/viewtopic.php?f=8&t=36299 Forum discussion] | [https://github.com/microelly2/NodeEditor NodeEditor] repository (MIT License), [https://github.com/microelly2/PyFlow PyFlow] customized fork (Apache 2.0 license), [https://github.com/wonderworks-software/PyFlow PyFlow] original project (Apache 2.0 license).
[https://forum.freecadweb.org/viewtopic.php?f=8&t=36299 Forum discussion]; [https://github.com/microelly2/NodeEditor NodeEditor] repository (MIT License), [https://github.com/microelly2/PyFlow PyFlow] customized fork (Apache 2.0 license), [https://github.com/wonderworks-software/PyFlow PyFlow] original project (Apache 2.0 license).
|}
|}


=== Trails (and PyTrails and Turns) ===
=== Trails, PyTrails, Turns, pivy_trackers, and Geomatics ===


{|cellpadding=5
{|cellpadding=5
| [[File:Trails_Workbench_0.19.png|384px]]
| [[File:Trails_Workbench_0.19.png|384px]]
| The Trails workbench was formerly known as the "Transportation Engineering" workbench. It consists of a toolset for developing highway and railway designs, including horizontal alignments, vertical profiles, and 3D models. Read more in the wiki page [[Civil_Engineering_Workbench|Civil Engineering/Transportation Workbench]].
| The '''Trails''' workbench was formerly known as the "Transportation Engineering" workbench. It consists of a toolset for developing highway and railway designs, including horizontal alignments, vertical profiles, and 3D models.


[https://forum.freecadweb.org/viewtopic.php?f=8&t=6973 Forum discussion] (original thread that started the project), [https://forum.freecadweb.org/viewtopic.php?f=8&t=22277 forum discussion] (main thread, very long), [https://www.youtube.com/watch?v=QRTd7056yy8&feature=youtu.be video example] | [https://github.com/joelgraff/freecad.trails freecad.trails] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?f=8&t=6973 Forum discussion] (original thread that started the project), [https://forum.freecadweb.org/viewtopic.php?f=8&t=22277 forum discussion] (main thread, very long); [https://github.com/joelgraff/freecad.trails freecad.trails] repository (LGPL 2.1), [https://www.youtube.com/watch?v=QRTd7056yy8&feature=youtu.be video example].


Most of the functions used in the Trails workbench have been placed in a new Python library called PyTrails. The expectation is that Trails serves as a FreeCAD based graphical interface for PyTrails, while PyTrails remains a general purpose library that can be used outside FreeCAD in other projects.
Most of the functions used in the Trails workbench have been placed in a new Python library called '''PyTrails'''. The expectation is that Trails serves as a FreeCAD based graphical interface for PyTrails, while PyTrails remains a general purpose library that can be used outside FreeCAD in other projects.


[https://forum.freecadweb.org/viewtopic.php?p=334760#p334760 Forum discussion] (PyTrails announcement) | [https://github.com/joelgraff/PyTrails PyTrails] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?p=334760#p334760 Forum discussion] (PyTrails announcement); [https://github.com/joelgraff/PyTrails PyTrails] repository (LGPL 2.1).


|-
The Turns workbench is a small component that was created during development of the Trails workbench. It performs vehicle swept-path analysis (turning analysis) for highway intersections and other entrances.
| [[File:pivy_trackers_turns.png|384px]]
| The '''Turns''' workbench is a small component that was created during development of the Trails workbench. It performs vehicle swept-path analysis (turning analysis) for highway intersections and other entrances.


[https://forum.freecadweb.org/viewtopic.php?p=333290#p333290 Forum discussion] (main thread) | [https://github.com/joelgraff/freecad.turns freecad.turns] repository (LGPL 2.1).
[https://forum.freecadweb.org/viewtopic.php?p=333290#p333290 Forum discussion] (main thread); [https://github.com/joelgraff/freecad.turns freecad.turns] repository (LGPL 2.1), [https://wiki.freecadweb.org/images/8/86/Turns_vehicle.gif animated GIF] example.
|}


|-
=== Altro ===
| [[File:Pivy_trackers_example.png|384px]]
| After working with Trails and Turns, the author decided to split the tracker code into a separate library called '''pivy_trackers'''. This is a general library that could be included in other workbenches to generate tracker objects and perform actions in the scene, like dragging lines, dragging points, and changing certain geometrical elements on the fly.

[https://forum.freecadweb.org/viewtopic.php?f=9&t=39939 Forum discussion], ([https://forum.freecadweb.org/viewtopic.php?t=43831 2], [https://forum.freecadweb.org/viewtopic.php?f=8&t=22277&start=890#p373426 3]); [https://github.com/joelgraff/pivy_trackers pivy_trackers] repository (LGPL 2.1), [https://github.com/joelgraff/pivy_trackers/wiki/Examples examples], [https://wiki.freecadweb.org/images/b/bd/Pivy_trackers_example.gif animated GIF] example.


{| class='wikitable' cellpadding=5
!colspan='2' | CadQuery <br> [https://github.com/jmwright/cadquery-freecad-module/wiki github]
|-
|-
| [[File:Geomatics_Workbench_0.19.png|384px]]
|Scripting based on the CadQuery CAD scripting API. A new code editor is available and script variables can be edited dynamically through a parameter dialog. The workbench also supports normal file operations for CadQuery scripts (open, new, close, etc), and example scripts to help users learn new concepts. || [[File:Cadquery_workbench.png | 384px]]
| The '''Geomatics''' workbench provides functionality specific to survey engineering, such as importing geodata information, and creating surfaces from clouds of points. There are some issues with rendering objects that use large coordinates (kilometers) and importing large DXF files. If you want to help solving these issues, please contact the developers.
|-

!colspan='2' | Curves<br>[https://github.com/tomate44/CurvesWB github] [https://forum.freecadweb.org/viewtopic.php?f=8&t=22675 discussion]
This workbench started as a fork of the older [https://github.com/microelly2/geodata Geodata] workbench by microelly2. Eventually it became a separate project by HakanSeven12. Now its code has been merged into the '''Trails''' workbench as it provides complementary functions to it. Therefore, in the future, please use Trails instead of the older Geomatics repository.
|-

|A collection of tools to create and edit NURBS curves and surfaces. || [[File:Sw2r-3.jpg | 384px]]
[https://forum.freecadweb.org/viewtopic.php?f=8&t=34371 Forum discussion]; [https://github.com/HakanSeven12/FreeCAD-Geomatics-Workbench FreeCAD-Geomatics-Workbench] repository (LGPL 2.1).
|-
!colspan='2' | [[Defeaturing Workbench|Defeaturing Workbench]] <br> [https://forum.freecadweb.org/viewtopic.php?f=9&t=29506 discussion] [https://github.com/easyw/Defeaturing_WB github]
|-
|Edit imported STEP models and remove selected features from the model. || [[File:defeaturing_workbench.png | 384px]]
|-
!colspan='2' | Electromagnetic (EM) <br> [https://forum.freecadweb.org/viewtopic.php?f=9&t=33372 discussion]
|-
|Electromagnetic || [[File:Screenshot_EM_window.png | 384px]]
|-
!colspan='2' | InventorLoader <br> [https://forum.freecadweb.org/viewtopic.php?f=22&t=20575&start=70 discussion] [https://github.com/jmplonka/InventorLoader github]
|-
|Import Autodesk Inventor files (in progress). || [[File:InventorLoader.png | 384px]]
|-
!colspan='2' | [[KicadStepUp Workbench|KicadStepUp Workbench]] <br> [https://forum.freecadweb.org/viewtopic.php?t=14276 discussion] [https://sourceforge.net/projects/kicadstepup/ sourceforge]
|-
| Provide support for KiCad and FreeCAD users in ECAD and MCAD collaboration. || [[File:Kicad stepup.PNG | 384px]]
|-
!colspan='2' | Lithophane Workbench <br> [https://github.com/furti/FreeCAD-Lithophane github] [https://forum.freecadweb.org/viewtopic.php?f=9&t=30496 discussion]
|-
|Create Lithophanes by projecting images onto solid surfaces || [[File:Lithophane_Windmill.png | 384px]]
|-
!colspan='2' | Manipulator Workbench <br> [https://forum.freecadweb.org/viewtopic.php?f=9&t=24742 discussion]
|-
|Tools to aid in part manipulation || [[File:Manipulator_workbench.png | 384px]]
|-
!colspan='2' | Nurbs <br> [https://forum.freecadweb.org/viewtopic.php?f=3&t=16473 discussion] [https://github.com/microelly2/freecad-nurbs github] [http://freecadbuch.de/doku.php?id=nurbs Microelly's "FreeCAD Buch"]
|-
|A collection of scripts for managing freeform surfaces and curves. || [[File:Nurbs_workbench.png | 384px]]
|-
!colspan='2' | [[SheetMetal Workbench|SheetMetal Workbench]] <br> Discussion ([https://forum.freecadweb.org/viewtopic.php?f=22&t=25281&start=170 thread 1] | [https://forum.freecadweb.org/viewtopic.php?t=34593 thread 2] | [https://forum.freecadweb.org/viewtopic.php?f=10&t=11303 thread 3]) [https://github.com/shaise/FreeCAD_SheetMetal github]
|-
|Tools for designing and bending objects made from sheet metal || [[File:Basebend-unfold.jpg | 384px]]
|-
!colspan='2' | Silk <br> [https://forum.freecadweb.org/viewtopic.php?f=22&t=23243 discussion][https://github.com/edwardvmills/Silk github]
|-
|A collection of NURBS surface modeling tools focused on low degree and seam continuity. || [[File:Silk_Workbench.png | 384px]]
|-
!colspan='2' | SQL Workbench <br> [https://forum.freecadweb.org/viewtopic.php?f=9&t=33403 discussion] [https://github.com/furti/FreeCAD-Reporting github]
|-
|Perform Structured Query Language (SQL) queries on FreeCAD document files to retrieve and report model data. || [[File:SQL_Workbench.png | 384px]]
|}
|}


[[Category:News{{#translation:}}]]

[[Category:News/it]]
[[Category:Documentation{{#translation:}}]]
[[Category:Documentation/it]]
[[Category:Releases{{#translation:}}]]

Revision as of 10:31, 6 October 2020

This page tracks new features as they are added to the development version of FreeCAD, which is currently 0.19. When the 0.19 feature freeze happens, delete these messages, and don't add more features to this page. FreeCAD 0.19 is expected to be released in 2020.

Are features missing? Mention them in the Release notes for v0.19 forum thread.

See Help FreeCAD for ways to contribute to FreeCAD.

FreeCAD 0.19 was released on DD Month 2020, get it from the Download page. This is a summary of the most interesting changes. The complete list of changes can be found in the MantisBT bugtracker FC 0.19 changelog.

Le note di rilascio delle versioni precedenti di FreeCAD sono disponibili in Funzioni di FreeCAD.

Simpson and Shipton short stroke steam engine circa 1845, using horizontal rotating piston, by "un1corn", Users Showcase.

Punti salienti

Horizontal 4 cylinder rotary valve steam engine, by "un1corn", Users Showcase.


This assembly was made by "Zolko", author of the new Assembly4 Workbench, which uses the new powerful App Link object to import thousands of different parts and subassemblies, arranging them in specified positions by means of mathematical expressions. See Users Showcase.

For this model, the parts were not designed in FreeCAD, they were just imported in STEP format, and subsequently arranged with Assembly4. |}


Constant velocity joint M. GECIK, by user "ppemawm", see Users Showcase. The model is reversed engineered from the individual STL files from Thingiverse by the original author, NOP21. Please notice the license of the original files.

The STL files were downloaded, saved, and imported into FreeCAD, and they were manually assembled using the Std Transform tool; this mesh assembly was used as reference to create solid bodies with PartDesign and subsequently assemble them using the new Assembly4 Workbench.

The model was started with Assembly4, and each part was created in-context referencing the STL model for sketch dimensions; sketches were created 1:1 scale with the STL model in the background.

The TechDraw Workbench, which replaced the Drawing Workbench in v0.17, has been upgraded in an important way. It has many new features with respect to v0.18, which make it much more useful to produce technical illustrations of 3D solids.

Among many small improvments, new features include: dimensions are now compliant with one of ISO 129-1 or ASME Y14.5M standards; new balloon annotations to include text inside a circle or polygon shape; new rich text annotations to include big paragraphs formatted as bold or italic; cosmetic vertices and cosmetic edges that are not part of the original model but which can be used to create custom dimensions; basic support for welding symbols; new active view mode to take a "snapshot" of the 3D view; new basic templates for ISO sizes (A0 to A4), as well as Russian and Chinese language templates; new horizontal and vertical dimensions that measure the full extent of the projections; SVG face hatches are now available when the page is exported to SVG; the new App Link object is now also supported as a source for creating views, which is useful when working with assemblies.

Aspetti generali

Con oltre 2000 commit nel ramo master dalla versione 0.18, questa è una delle versioni più estese di sempre, con diversi nuovi componenti come il nuovo oggetto "App::Link", oltre a molti nuovi strumenti nell'ambiente TechDraw che rendono FreeCAD ancora più potente per la modellazione e l'assemblaggio di solidi 3D. Inoltre, l'ecosistema di FreeCAD ha continuato a crescere con ulteriori ambienti di lavoro esterni specializzati.

Python 3 e Qt5

Lo sforzo di migrare da Python 2 e Qt4 a Python 3 e Qt5 è sostanzialmente completo e la maggior parte degli sviluppatori è passata agli strumenti di Python3 e Qt5.

Indubbiamente ci sono bug imprevisti; questi saranno affrontati man mano che vengono segnalati. Qualsiasi dipendenza esistente da Python 2 o Qt4 non sarà supportata oltre il 1 ° gennaio 2020, data in cui Python 2 diventerà ufficialmente non più supportato dalla Python Foundation. Notare che alcuni componenti aggiuntivi non sono stati ancora portati su Python3 e Qt5. Ciò può essere dovuto a diversi motivi tra cui la mancanza di tempo da parte dei loro sviluppatori o dipendenze interrotte che potrebbero non essere facilmente risolvibili o semplicemente perché l'addon è considerato obsoleto. Le persone interessate alla migrazione di un particolare ambiente di lavoro o strumento sono incoraggiate a partecipare al forum di FreeCAD; vedere anche Python3 and Qt5 Compatible Addon Workbenches (in preparazione per 0.18).

Alcuni problemi

Fixed issue with Std Part containers visibility when the viewport is displayed in full screen in Qt5:

Sviluppo

Documentazione

  • La pagina Compilare su Linux/Unix è stata rivista per spiegare meglio i requisiti per compilare su diverse distribuzioni Linux. Poiché molti sviluppatori utilizzano sistemi basati su Debian, questa sezione ha ricevuto la massima attenzione. Gli utenti di altre distribuzioni Linux sono incoraggiati a mantenere la documentazione per la loro particolare distribuzione. Anche Compilare su Windows è stato riscritto per spiegare come usare il LibPack per la compilazione.
  • La pagina Documentazione del codice sorgente è stata ripulita per spiegare meglio come produrre la documentazione di programmazione (API) partendo da C++ e Python.
  • La pagina Doxygen è stata rivista ed estesa per fornire maggiori dettagli sulla sintassi utilizzata nei file C++ per produrre la documentazione di programmazione.
  • Anche la pagina Gestione del codice sorgente è stata rielaborata con descrizioni ed esempi migliori sull'uso di git per gestire i rami e contribuire al codice.
  • La pagina Ambienti di lavoro esterni è stata riorganizzata, in modo da elencare tutti gli ambienti ricchi di funzionalità e disponibili al pubblico. Se si desideri aggiungere un workbench a questa pagina, comunicarlo nel forum e fornire le informazioni di supporto come il manuale dell'utente, le pagine wiki e un link al suo repository. Quindi spingere per includerlo in Addon Manager.

Limitazioni note

  • Black screen due to video card drivers, while running FreeCAD inside a virtual machine; issue #3939.
  • Logitech Wingman USB joystick can cause erratic behavior when spinning and zooming in the view; forum discussion.
  • Gesture navigation is fully supported for Windows but yet to be maintained in Linux and MacOS. Problem: the developer, DeepSOIC, doesn't have a MacOS machine with its special trackpad, and hasn't tested it on Linux either; forum discussion.

Interfaccia utente

The navigation cube got a few retouches; now it uses transparency to be easier on the eyes, and the arrows are bigger to improve clicking on them.

Forum discussion, pull request #2076.

The navigation cube can be augmented by the CubeMenu addon, which allows configuring the menu that pops up, as well as the size of the cube itself. This is helpful particularly for very high resolution screens, in which the default size is too small. This is an external tool that can be installed from the Addon Manager.

Forum discussion; CubeMenu repository (LGPL 2.1).

New COIL icon theme developed by user 1D_Inc. This is a minimalistic icon set inspired on Blender's 2.8 outline-style icons (a coil of threads or strands alludes to the appearance of the icons). The intention is to have professional-looking icons that can be used with different color themes, including light, dark, and monochrome.

Forum discussion 1 (old thread), discussion 2 (main thread), 1D_SVG_Tools repository.

New icon theme management developed by user triplus.

Forum discussion.

New dark stylesheet developed by user userzmp2000.

Forum discussion, BlenderLike-dark.qss.

Dark themes by user pablogil. Blue, green, and orange variations, which are darker than previous templates.

Forum discussion, pull request #2433, #2920, #2933.

The Std ViewScreenShot tool now supports transparency. Options are available by clicking the Extended button and changing the Image Properties section.

Wiki, forum discussion, commit 8e5151002.

App::Link e assemblaggio

L'oggetto "App::Link" consente il collegamento leggero di oggetti in un documento e da documenti esterni.

Dopo 2,5 anni di sviluppo, l'oggetto "Link", o più formalmente App::Link, è stato introdotto in FreeCAD. Questo è un tipo speciale di App::DocumentObject con alcune proprietà che, si spera, consentiranno di semplificare gli assemblaggi.

Un "Link" consente agli oggetti di utilizzare i dati di un altro oggetto, come la geometria o anche la loro rappresentazione visiva 3D, negli stessi file o in file diversi. Può essere pensato come un leggero clone assoluto o come lo stesso oggetto che vive in due "istanze" diverse. Alcune funzionalità offerte da un "Link" sono già presenti in alcuni ambienti come Arch e BIM (cloni, riferimenti esterni ), ma l'implementazione di "Link" è al livello principale e può quindi essere utilizzato da tutti gli ambienti in diversi modi.

Il componente "Link" è stato pensato e sviluppato quasi interamente dall'utente realthunder. Le motivazioni e le implementazioni progettuali alla base di questo progetto sono descritte nella sua pagina GitHub, Link. Per realizzare questa funzione, sono state apportate diverse modifiche fondamentali a FreeCAD; queste modifiche sono ampiamente documentate in Core-Changes.

La storia di "Link" può essere rintracciata tramite alcune discussioni essenziali del forum:

Finally, the pull request and merge happened:

The "App Link" object prepares FreeCAD for the phase that was scheduled to happen after the redesign of PartDesign in FreeCAD 0.17, which is working with assemblies.

Assembly3 is an assembly workbench written in Python by realthunder, that makes use of the "App Link" functionality. The workbench served as a testbed for this component during its development. While Assembly3 is still not officially part of FreeCAD, with the inclusion of "App Link" in the master branch, it is a matter of time for Assembly3 to be provided as an installable add-on, just like A2plus and Assembly4 are provided currently.

Core system, App, Base, and Gui namespaces

Beside the introduction of App Link, the "LinkMerge" branch also introduced some changes visible to the user with regards to object properties, expressions, visual selection, and the tree view. These are described in the Core-Changes page.

Dynamic properties can be added to any C++ or Python object. This can make macros such as Macro PropertyMemo obsolete.

Forum discussion, animated GIF example.

These dynamic properties were added in the App Link merge; pull request #2350.
Selected elements hidden by other elements are highlighted to indicate their position within the model.

These selection enhancement were also introduced in the App Link merge; pull request #2350.

After two years being stalled, there have been improvements in the way the program handles backup files. Now they can include a timestamp in the format %Y%m%d-%H%M%S, instead of a simple number. This can be set in the preferences editor.

Forum discussion, pull request #1148.

New input field to quickly search for parameters in the parameter editor.

Forum discussion, pull request #3173.

The Macro menu now shows a shortcut to recently used macros, which can be called with a key combination, for example, Ctrl+Shift+1. This can be configured in the Macro preferences.

Forum discussion, pull request #3616.

Addon Manager

The Addon Manager was upgraded; it is now able to display more complete information on all external workbenches and macros, and show an icon for each of them. It also allows checking for updates on start, and using custom repositories.

Forum discussion.

It will also show information on whether the addon is obsolete, already installed, or available for update.

Forum discussion, pull request #2605.

Ambiente Arch

Keep with the latest developments to the Arch Workbench, and the BIM Workbench that depends on it, by following the main author of this workbench, at Uncreated. The updates are also posted to the forum, BIM/Arch development news articles from Yorik's blog.

The developers of Draft, Arch, and BIM Workbenches also collaborate with the greater OSArch community, with the ultimate goal of improving building design by using entirely free software.

The Arch Site tool once more is able to produce sun path diagrams if the given latitude, longitude, and declination are provided. This requires Pysolar 0.7 or above, and only works with Python 3.

Forum discussion, commit 2177f4437, commit c05bc0990.

The Arch Site tool now can display a compass to show the direction of the "true North" (declination) in the model. By the default, North is aligned to the Y axis. This is useful when working in real world coordinates.

Forum discussion, pull request #2111, commit ff1fb11af, pull request #2360.

The Arch SectionPlane tool now has the ability of clipping the view, to act as a camera.

Forum discussion, commit 9a64f3fad9.

The Arch Fence tool was added to produce fence objects starting from a post and a path.

Forum discussion, pull request #2151, pull request #2173, pull request #2263, pull request #2270.

Arch Fence in action.

Improvements in the Reinforcement Addon, which extends the Arch Rebar tool.

Automated reinforcement graphical user interface: the intention is to facilitate the automatic creation of simple and complex rebars. This development was carried out as a Google Summer of Code 2019 project: Suraj_Dadral/gsoc_proposal.

Forum discussion, FreeCAD-Reinforcement (master code), SurajDadral/FreeCAD-Reinforcement (development fork).

New rendering modes for Arch SectionPlane that can be selected when using TechDraw ArchView, DatiRender Mode, Coin and Coin mono. The section plane generates an SVG that is simply displayed in a TechDraw page; with these new modes, the SVG generation is performed by Coin, so it is faster than using Wireframe and Solid, which use the internal OCCT kernel to calculate the SVG projection. The tradeoff is between speed and precision; the Coin modes are faster but less precise, while the original modes are more precise but relatively slow.

Forum discussion, commits f93a986b5a, ed0eff0248.

New Arch CutLine tool to cut solid objects, like Arch Walls and Arch Structure, using an edge, like a Draft Line. This works similar to the existing Arch CutPlane.

Forum discussion, pull request #2701, #2870.

Arch now includes a Shapefile importer, which is commonly used in GIS applications. The importer uses the shapefile.py library from the pyshp project; this library should be downloaded on first run.

Forum thread, commit 916a42397c. Image of a site shared by @HnsaCAD for @gemeentearnhem.

New Arch Truss tool to create a variety of trusses. Like Arch Walls they are constructed from a baseline, and different properties define the shape of the truss, its height, and the intermediate elements.

It also supports Arch MultiMaterial to assign different materials to the bottom, top, and intermediate elements.

Commit 0c96f77184.

New Arch CurtainWall tool to create various types of walls. This tool needs a base surface to work on. If none is selected, you can simply draw a line between two points, like the standard Arch Wall. The surface is then subdivided into rows and columns, and four points extracted from the surface subdivisions, forming quadrangular facets.

Commit e42a26fba1, commit 7c12c8688c.

Ambiente Draft

The Draft Edit tool was upgraded to allow editing many Draft objects at the same time, and also display better trackers.

Forum discussion, pull request #1968, commit 272a8dfcc9, commit 7de2248bb, pull request #2108, pull request #2430; animated GIF example.

The tool was also moved into its own module: commit a4e2df115d, commit c351b9094.

New Draft SubelementHighlight tool to highlight the nodes and edges of certain objects, like Draft Wires, in order to edit them using modifiers like Draft Move, Draft Rotate, and Draft Scale. It allows you to select multiple objects to edit instead of just one. Once the objects are highlighted, you can select specific sub-elements, vertices and edges, and transform (move, rotate, scale) only these.

This tool was particularly developed to help edit the shape of Arch Walls that are based on Draft Wires. When various walls are selected, and the tool is used, the base wires automatically become visible, and display their nodes prominently.

Forum discussion, pull request #1975; video demonstration 1, 2.

New Draft CubicBezCurve tool, to create 3rd degree Bezier curves in a way similar to Inkscape.

Forum discussion, pull request #2072; animated GIF example.

New Draft Arc 3Points tool, to create circular arcs by specifying three points through which the arc passes. Originally developed in the BIM Workbench and then migrated to Draft.

Forum discussion, commit 4f19a65559, commit 0b905fade0, pull request #2286.

A proper command line interface as well as unit test are also provided.

Pull request #3004, #3005.

New Draft Layer tool that replaces the seldom used Draft VisGroup, providing a true layer system as it exists in other CAD systems. Draft Layer supports adding objects by drag-and-drop, controls object visibility and, optionally, object color.

Forum discussion (development), forum discussion (announcement), commit 5ee99ca4ee, commit 36bc48c9bf.

Improvements in the Draft SVG routines to improve inclusion of 2D projections in TechDraw pages. This benefits tools like Draft Shape2DView and Arch SectionPlane, when used with TechDraw DraftView and TechDraw ArchView.

A new DatiOverride Style property is added to TechDraw DraftView, in order to choose whether the appearance of Draft objects is kept (new) or is overridden by the TechDraw page (old behavior).

Forum discussion, commit 3e323fee14.

New Draft Fillet tool that creates a fillet (rounded corner) or a chamfer (straight line) between two simple Draft Lines.

Forum discussion, pull request #2441, #2492.

The introduction of the App Link object made it possible to create arrays which have many exact references to an existing object instead of shape duplicates (simple copies). This results in more memory efficient arrays. This is possible with the new Draft LinkArray and Draft PathLinkArray tools. Draft LinkArray works in three modes, "ortho", "polar", and the new "circular" mode, which was introduced in a separate commit.

Pull request #2350.

After the creation of the Link arrays, a new command called Draft OrthoArray now replaces both Draft Array and Draft LinkArray. This Draft OrthoArray is used to create exclusively orthogonal arrays. It shows a task panel similar to Draft PolarArray and Draft CircularArray. Therefore, from the toolbar it is now possible to create "orthogonal", "polar" and "circular" arrays from separate buttons. Moreover, the array buttons are collected in a group so that they are organized.

Forum discussion, pull request #2988, #2972.

New Draft PolarArray tool to create polar arrays directly. Previously, the same could be done by using the old Draft Array command, and then modifying the properties of the created object.

This Draft PolarArray tool can create the new App Link objects or the traditional copies.

Forum discussion, pull request #2824.

The Array object has a new "circular" mode. This is controlled by new properties: DatiRadialDistance, DatiTangentialDistance, DatiNumberCircles, and DatiSymmetry.

Forum discussion, pull request #2585.

Moreover, a new Draft CircularArray tool was developed to create these circular arrays directly. This tool can create the new App Link objects or the traditional copies.

Forum discussion, pull request #2824.

The unit tests of the workbench were rewritten and expanded, so that now it is easier to test for errors and regressions when new code is merged.

Forum discussion, pull request #2668, #2727, #2881, #3005.

Also, a script is provided in Mod/Draft/drafttests/draft_test_objects.py, that produces a test file with most objects of the workbench. This file is useful to learn scripting in Draft, and can also be used to test regressions in the underlying code of the objects.

Forum discussion, pull request #3012.

New icons were provided for the Draft objects in the tree view. The objective is to more quickly distinguish the objects at a glance, particularly if the default label is changed. This makes it easier to recognize objects which are lines, curves, geometrical elements, linear, radial, or angular dimensions, or other objects.

In addition, all icons were converted to the new standard pixel resolution of 96 dpi, and were saved as Plain SVG, so that we don't introduce non-standard SVG tags.

Forum discussion, pull request #3051, #3058, #3060, #3070, #3170, #3402.

Undergoing efforts to split tools into their own module files to ease maintenance of the codebase for the future, and facilitate the addition of new tools.

Forum discussion, overall structure.

Some of the functions and classes that have already been moved: commit 5ee99ca4ee (Draft Layer), commit 16c26cb3b1 (Draft Edit), commit 9fb6aec313 (Draft SelectPlane), pull requests #2823 (GuiCommandBase), #2829 (utilities), #2830 (GUI utilities), #2831 (ToDo class), #2832 (translate function), #3091 (Draft Snap), #3092 (Draft Trackers), #3094 (Draft SelectPlane), #3095 (Draft ShapeString task panel), #3096 (Draft Scale task panel), #3097 (Draft Edit), #3157 (Draft WorkingPlaneProxy), #3182 (various Gui Commands), #3291 (base classes DraftTool, Creator, Modifier), #3299, (Creator tools), #3308 (Modifier tools).

For an overall view of the pull requests, see #2429.

This is a work in progress that requires advancing carefully as we aim to maintain compatibility with previous versions of Draft. Most refactoring is complete, but there is still room for improving many aspects of the workbench. We invite enthusiastic developers to join the effort.

File:Draft AnnotationStyleEditor example.png New Annotation style editor tool to create styles for annotations. These styles can define things like text font, size, color, and arrows, which can be applied to any of your texts, dimensions or labels. We started by implementing an editor and a system to store the styles in the document. Next steps will be adapting the different annotation objects to support the styles.

Forum discussion, commit 1b887fa0f5, commit 4555a77663, commit 5b3fea59e0.

Altro

  • The Draft Wire tool now is called "Polyline" in the menu, instead of "DWire"; all options and functionality remain the same, so this doesn't break compatibility; commit 39e748229e.
  • A "DraftEditPickRadius" preference was added to control the area of influence of the pointer when picking vertices in edit mode Draft Edit; forum discussion, pull request #2642, issue #4162.
  • Undergoing efforts to document the Python source code (adding complete docstrings), in order to produce better programming documentation that can be used by both users and developers. See Source documentation for instructions on generating the documentation with Doxygen.
  • The "Toolbar mode" when launching the Draft tools has been removed. This was an interface that was used in the past but became obsolete as the task panel became the predominant interface; forum discussion, pull request #2973.
  • Draft.copy now works with any document object, thanks to the new Document.copyObject() method introduced with the LinkMerge; pull request #3658.

Ambiente FEM

After half a year in development and testing the "femconcrete" branch was added to the FEM Workbench. This provides tools to estimate the level of reinforcement required in a concrete structure to prevent brittle failure under tension or shear. In essence, it is a post processing routine for the CalculiX solver, which calculates the principal tensile stresses in the concrete from an elastic analysis and uses those to determine the minimum reinforcement in the three coordinate directions required to prevent failure.

Forum discussion, pull request #2267; Analysis of reinforced concrete with FEM (tutorial).

After a few months in development the "fcFEM" macro was published. It implements a finite element solver entirely in Python. Its author designed it to overcome the limitations of other external solvers, like CalculiX and z88. Some of the intended improvements include creating mixed mesh analyses, improved beam and shell elements, arc-length control for overcoming limit points in elastic-plastic analyses, implementation of zero-thickness interface elements for different applications, and others.

In due time this solver could be distributed together with the FEM Workbench, meaning that the FreeCAD project would have its own finite element solver for doing mechanical and structural analyses.

Forum discussion; fcFEM repository (LGPL 2).

Topology optimization has long been a feature desired for those working with FEM. In 2016 the BESO (Bi-directional Evolutionary Structural Optimization) project was started, implementing an iterative method with the CalculiX solver that removes ineffective elements from a mesh in order to optimize the mass of the design. In the 0.19 development cycle, a simple graphical interface has been developed to facilitate generating the beso configuration files.

Forum discussion; beso repository (LGPL 3).

Similar to beso, the ToOptix project also provides a macro to perform topology optimization; it currently only works in structural and heat transfer studies.

Forum discussion (just a mention); ToOptixFreeCADAddon repository (GPL 2).

Altro

  • Updated coding standards that strive for PEP8 compliance with Python; forum discussion, commit ad03ee9bdf, commit 27cb54009b.
  • The Elmer project has developed a library for handling batch type pre-processing for the ElmerSolver, using the FEM Workbench. This includes creating mesh objects for FreeCAD, manipulating the mesh sizes of solids, creating finite element meshes using Gmsh, running ElmerGrid and exporting the mesh for ElmerSolver, and selecting and naming bodies and boundaries for ElmerSolver; forum discussion, elmerfem repository (Elmer main repository), FreeCADBatchFEMTools repository (library to interact with FEM Workbench, LGPL 2.1).
  • The integration of the OOFem solver, which started in 2018, is progressing, so it is now another option that can be used for structural analysis in FreeCAD. This solver is interesting in that it has interface elements, as well as arc-length control, in addition to many non-linear material models. The integration of OOFEM into FEM has been carried in various commits that together serve as documentation on how to integrate similar solvers; forum discussion, femoofem branch, OOFEM main website, oofem repository (LGPL 2.1).

Import

Material handling

None

Mesh

Mesh FromPartShape is now able to create meshes using Gmsh. This mesher is an external program that must be installed in the system before it can be used. Gmsh was already one of the options to create finite element meshes with the FEM Workbench.

Moreover, now the Mesh FromPartShape dialog will remember the settings that you used the last time.

Commit 1cb4625bf.

Further improvements

Ambiente Part

New command Part PointsFromMesh to create an object made of points from an imported mesh. Then the points can be used as reference objects to do further operations, such as define a plane, and draw a sketch. This can be used to reverse engineer or remodel meshes by creating solid objects.

Forum discussion (and video), pull request #2450.

A script is provided in Mod/Part/parttests/part_test_objects.py, that produces a test file with the Part Primitives. This file is useful to learn scripting in Part, and can also be used to test regressions in the underlying code of the objects.

Pull request #3078.

The Part CheckGeometry tool has been expanded to include more information about the Part TopoShape that is contained in all solid objects of the program, not including Mesh-type objects.

Forum discusion, 2, announcement; pull request #3747.

Further improvements

Ambiente PartDesign

Features that have an "Attachment" property now show when the attachment mode is "deactivated" by displaying a small overlay to the left of the icon in the tree view. Features that are attached to a plane or other reference don't display this overlay.

Forum discussion, pull request #2272.

The dialog to edit chamfers allows now to define chamfers also either
  • using 2 values
  • a value and an angle

These 2 parameters can also be flipped using the dialog. Forum discussion, pull request #3456

The dialog to edit pads allows now to specify a direction in which the sketch is padded.

Forum discussion, pull request #3794

PartDesign LinearPattern and PolarPattern now can be used with dress-up features (fillets, chamfers, thickness and draft) and with primitives (Additives and Subtractives). A new property DatiSupport Transform in these features, controls whether the feature supports the pattern or not.

Forum discussion, pull request #3045, #3155, #3226.

The dialog to edit Prisms (additive and subtractive) allows now to specify an angle in respect to the normal of the chosen attachment plane. This way one can create skew prisms.

Forum discussion, pull request #3793

It is now possible to select several features in the document tree before executing a transformation. This way several features can easily be transformed at once. The order of the features in the transformation dialog can be changed by dragging a feature to the desired position.

Forum discussion, pull request #3748, #3760.

The dialogs to edit fillets, chamfers, thickness, and draft features were improved to allow selecting several sub-elements (edges and faces) at once.

Forum discussion, pull request #3050, animated GIF example.

File:PartDesign Primitive parameters expressions.png It is now possible to set expressions for all parameters of additive and subtractive primitives.

Forum discussion, pull request #3225.

File:PartDesign Attachment angles expressions.png It is now possible to set expressions for the attachment angles of additive and subtractive primitives. Formerly, expressions were only available for the direction offsets.

Forum discussion, commit 1cfe6d2cc7.

It is now possible to change the list items in the different dialogs. For example in this forum post there is a god example why the item list matters for transformations. Here is another example for the sketch order for lofts.

Forum discussion, pull request #3760, commit 94ca4388e.

Ambiente Path

Added coolant modes for coolant management.

Forum discussion, pull request #2463.

  • Tool manager support for multiple tool tables
  • PathPocket: Extensions (For milling open pockets).
  • New unified Profile operation: The pre-existing Contour, Profile Faces, and Profile Edges of version 0.18.x are now combined into a single Profile operation. The new Profile operation maintains features and capabilities of the three individual source operations. forum discussion, pull request #3443.
  • Profile Edges: Open Edges support added. Note: The Profile Edges operation is now merged into the Profile operation. forum discussion, pull request #3068.
  • First attempt of 4th-axis support: Profile (limited to full contour and profiling of faces), PathPocket, and Drilling
  • New operation: Slot. Allows for creation of a horizontal slotting operation based on two custom points; the selection of one or more faces or edges; or the selection of two vertices. forum discussion, initial pull request #3624.

Ambiente Render

Added support for Blender's standalone "Cycles" renderer; commit 759067912f; FreeCAD-render repository. The Cycles standalone renderer usually needs to be compiled from source, as the binary is normally not provided by itself in a complete Blender distribution.

Besides this, the Render Workbench already has support for Pov-Ray, Luxrender and Appleseed.

Ambiente Sketcher

In the Sketcher's task panel, in the "Elements" section there is now a "Mode" filter to select "normal", "construction", "external", or "all" geometry. This is useful to perform an action with only one type of geometry. For example, one use case is selecting only the "construction" edges, and deleting them after being used.
New Sketcher ToggleActiveConstraint tool to temporarily deactivate a constraint without removing it entirely. This is helpful to test the movement of the sketch before fully constraining it.

Pull request #2283, commit 159b8e7bdf.

It is now possible to make a dimension constraint a reference constraint directly in the dialog.

Forum discussion, 2; pull request #3201, commit 06f479622c.

Ambiente Spreadsheet

The introduction of App Link also brought some improvements to the expressions capabilities of FreeCAD, which are visible in the property editor, and the Spreadsheet Workbench. These are described in Core-Changes and this forum thread.

  • A new expression syntax is introduced to unambiguously reference a property of the owner object, by omitting the object reference and starting with a leading dot (.), similar to Python relative import syntax. So instead of Cylinder.Height, now you can use .Height.
  • You can refer to an object by its Name or by its Label. In the case of a Label, it must be enclosed in << and >> symbols, such as <<Label>>. For example, <<Metal_cylinder>>.Height.
  • Improved spreadsheet recomputation logic, and cell copy and paste functions. Pull request #2350, #2475.

The previous commits changed the way the autocompletion works with expressions, particularly when used with Sketcher constraints, which was seen as a regression for many use cases. A new set of commits were proposed to restore this functionality; forum discussion, pull request #3062.

Aliases for table cells can now be set easier with a new input field at the upper right of the spreadsheet.

Forum discussion, pull request #3154, #3162, #3233.

Ambiente Start

Re-added example files to the Start page with saved thumbnails in their icons.

Forum discussion, pull request #2316.

Ambiente Surface

The Surface Sections object has been added to create surfaces from edges that represent transversal sections.

Forum discussion, commit 3a8a6aae1b.

The Surface Workbench documentation has been rewritten, and expanded with more images and scripting examples, in order to showcase better the tools of the workbench. All commands are now available from the toolbar: Surface Filling, Surface GeomFillSurface, Surface Sections, Surface ExtendFace, and Surface CurveOnMesh.

Likewise, the icons have been updated to be more visually attractive.

Ambiente TechDraw

Improved placing and scaling of a 3D viewport screenshot in a TechDraw page.

Forum discussion.

New TechDraw Balloon tool to add balloon decorators to create notes with numbers, letters, and text.

Forum discussion, pull request #2013.

New TechDraw LeaderLine and TechDraw RichTextAnnotation tools to create better annotations in the drawing page.

Forum discussion, commit 7f07195f93, commit 6c699887c0; testing and bug fixing commit ab986d9a00, commit 15f440525e, commit 8ef3f13fbb, commit bf38ae958f, commit 74737f71fd, commit be257182ba, commit de3715908e, commit 916fe7ced3.

New TechDraw CosmeticVertex, TechDraw Midpoints, and TechDraw Quadrant tools, which allow the user to place fake or "cosmetic" vertices that can be used to create dimensions. The midpoint and quadrant vertices can be used to add more points to straight and curved edges (circular arcs), respectively; the "CosmeticVertex" tool can add a point anywhere on the drawing view without requiring being based on existing geometry.

Forum discussion, commit 59e47de506, commit 94b167f3a2.

New TechDraw FaceCenterLine, TechDraw 2LineCenterLine, and TechDraw 2PointCenterLine tools, to add a line in the center of a face, or between two existing edges, or between two existing points, respectively.

Also, TechDraw DecorateLine to change the appearance of single edges, and TechDraw CosmeticEraser to remove any of the cosmetic features from the view.

Forum discussion (v1, alpha), forum discussion (v2), commit 656e1654ff, commit 93431edfba, commit f25826bba3, commit 11d8aaed61, commit 941968b37c.

New TechDraw WeldSymbol tool to provide welding symbols. One of the most requested features from the older Drawing Workbench is finally in TechDraw. Russian standard (GOST) symbols are also added.

Forum discussion (testing), forum discussion (main thread); pull request #2446, #3110.

Old welding symbols from Drawing Workbench.

New TechDraw ActiveView tool. It produces a static image from the active 3D view, and puts it in a new TechDraw view. The result is a snapshot that doesn't update with changes to the model, and which is very fast to produce because it doesn't perform hidden line removal calculations. It is intended for rapid visualization of models, or to display flat projections of models without needing to add dimensions, a workflow that may be interesting for architectural visualization. Together with Arch SectionPlane and TechDraw ArchView, TechDraw ActiveView hopes to improve the interaction between Arch and TechDraw to document building models.

Forum discussion, commit 13676bfe57.

New page templates, Russian State Standard of Technical Documentation (Unified system for design documentation), GOST 2.104-2006, GOST Р 21.1101-2013.

Forum discussion, pull request #2249.

New page templates, the People's Republic of China Templates A series; please use with font family "HYSWLongFangSong".

Forum discussion, 2, pull request #2322.

New page templates, A-size, Slovenian (GPL 2).

Forum discussion, FreeCADTemplates repository.

Only LGPL2 compatible code can be provided directly with TechDraw; code contributed under GPL2 or GPL3 needs to be stored in a separate repository.

The drawing of dimensions was completely rewritten. Now any drawn dimension is fully compliant with one of ISO 129-1 or ASME Y14.5M standards. There are four styles to choose from: ISO oriented (rotated value), ISO Referencing (horizontal value), ASME Inlined (horizontal value), ASME Referencing (value connected by a reference line).

Forum discussion, pull request #2552.

New TechDraw Dimension Horizontal Extent and TechDraw Dimension Vertical Extent, to obtain the maximum dimensions in a view.

Forum discussion, pull request 2680, commit a7d9661b1d.

New task dialog to set up Detail Views.

Forum discussion.

New pyramid arrow style for dimensions and balloon annotations.

Forum discussion, pull request #2853.

SVG face hatches are now available when the page is exported to SVG. The SVG hatches are converted to bitmaps and clipped to fit the face before export. The example image shows the exported SVG page when it is opened in Inkscape.

Forum discussion, commit a9b718d1e0.

Altro

Web

  • QtWebEngine support for Qt 5.7 and above, and fallback to QWebkit for Qt 5.6 and below; pull request #1937.

Macro

See Macros recipes for many more macros.

Automatic light-gauge steel frame creator and panelizer.

Forum discussion; FreeCAD-Steel_Frame repository (GPL 3), video example.

Moduli aggiuntivi

Note: these are the new workbenches created in this development cycle, or older workbenches that received updates. See external workbenches for more workbenches that can be installed, and which cover a wide variety of topics. If you want to see your workbench added, join the forum and present your code.

3D Printing Tools

Previously it was called "MeshTools". It has utilities for working with imported STL meshes which could be used for 3D printing, like scaling the mesh up and down, scale it to fit a 3D printer, make objects transparent, hide and show objects, change colors and line widths of groups of objects, and others.

Forum discussion; 3D Printing Tools repository (LGPL 2.1).

A2plus

The successor to the Assembly2 workbench, A2plus is the most mature assembly workbench, and has received important updates in this development cycle, like an improved point on plane constraint, and point on line constraint, using the center of a sphere as the point; this improves the constraining of spheres.

Forum discussion; A2plus repository (LGPL 2.1).

Please note: A2plus is not compatible with Assembly2 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in A2plus.

Assembly3

Assembly3 is an assembly workbench created by developer realthunder, that is inspired by Assembly2, but is not compatible with it. Assembly3 makes use of realthunder's App Link object and various significant changes to the internal code of FreeCAD. Because of this reason, Assembly3 cannot be installed simply from the Addon Manager. Instead, realthunder provides a pre-compiled version of FreeCAD that includes Assembly3. This workbench serves as a testing environment for the App Link object, and other changes that realthunder plans to submit to the main FreeCAD source code.

The Assembly3 workbench can also be tested in the development AppImage.

Forum discussion (massive thread); FreeCAD_assembly3 repository (GPL 3).

Please note: Assembly3 is not compatible with Assembly2 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in Assembly3.

Assembly4

Assembly4 is an assembly workbench created by developer Zolko, that uses realthunder's App Link object and many other changes to the base FreeCAD system, particularly the new expression engine. Because of this, Assembly4 doesn't work with versions below 0.19. Assembly4 can be installed from the Addon Manager.

Unlike A2plus and Assembly3, Assembly4 tries to perform assembly without using a constraint solver, but rather with the concept of arranging local coordinate systems (LCS) and setting relationships through mathematical expressions.

Forum discussion (original idea), forum discussion (main thread); FreeCAD_Assembly4 repository (LGPL 2.1).

Please note: Assembly4 is not compatible with Assembly3 or other assembly workbenches. If you have previous assemblies, they will need to be re-created entirely in Assembly4.

ArchTextures

The ArchTextures Workbench was developed to provide basic texture support to Arch Workbench elements like walls and roofs, in order to quickly visualize a building. It is not intended to produce photo-realistic renderings, just simple texturing of materials like wood, brick, and concrete. It also provides lights (directional, point, and spot), which makes it more feature complete to set up a scene.

Forum discussion (help requests), forum discussion (development), forum discussion (only announcements), forum discussion (announcement of lights); FreeCAD-ArchTextures repository (MIT).

BOLTSFC

BOLTS is an "open library of technical specifications"; it is meant to provide free, standardized parts defined parametrically that can be used in different CAD systems like OpenSCAD and FreeCAD. The BOLTS library was launched in 2013 but received little maintenance since 2016. Now, with a new maintainer and repository, the project has revived with the BOLTSFC workbench that provides an interface to insert the different parametric objects.

Forum discussion; Homepage, BOLTSFC repository, BOLTS main repository (GPL 3).

CurvedShapes Workbench

The CurvedShapes workbench has tools for designing 3D surfaces starting from a skeleton of multiple curves in the XY, XZ, or YZ planes. It was created particularly to simplify the modelling of the wings of aircrafts.

Forum discussion; CurvedShapesWorkbench repository (LGPL 3).

Dodo (formerly Flamingo)

Dodo is the successor to the Flamingo Workbench, a workbench specialized in creating piping and frames. While Flamingo was developed for Python 2 and Qt4, Dodo is meant to work with Python 3 and Qt5. It provides the same features as Flamingo, but has improved tools and interfaces.

Forum discussion (main thread), forum discussion (Dodo announcement), tutorial; dodo repository (LGPL 3), flamingo repository (LGPL 3).

Fasteners

The Fasteners Workbench to generate standard ISO screws, bolts, washers, and other fasteners, was updated to work with Python 3 and Qt5.

Forum discussion; FreeCAD_FasternersWB repository (GPL 2), additional details.

MeshRemodel Workbench

This workbench helps convert a mesh, for example, an imported STL file, into a native FreeCAD object. It will not do the conversion automatically, but it will help re-build, or re-model, the imported mesh. The general workflow is to select the mesh object, then create a "points" object from it; then these points can be used as references for creating FreeCAD objects such as lines, polygons, circles, arcs, and BSplines. These wires can then be turned into a Sketch object, which can be padded to create a 3D solid with the PartDesign Workbench.

Forum discussion (only announcement); MeshRemodel repository (LGPL 2.1).

MOOC Workbench

The MOOC workbench is an educational tool that offers interactive tutorials and exercise evaluations to learn to use FreeCAD. It was developed as part of a series of courses on Digital Manufacturing.

At this moment, the workbench is only offered in the French language.

Forum discussion; mooc-workbench repository (GPL 2).

NodeEditor (PyFlow)

The NodeEditor workbench implements a system of nodes that can be used to dynamically control the properties of objects, similar to Blender's node system to edit materials. The NodeEditor is based on a slightly modified version of the PyFlow framework, which is under active development.

A node editor has been a requested feature for a very long time, at least since 2014 (see this thread). A fully working node editor has the potential of simplifying the drawing of complex shapes using generative algorithms that produce a shape based on the values of its inputs. This could be used to create various types of meshes and surfaces with many applications in architecture and mechanical design.

Forum discussion; NodeEditor repository (MIT License), PyFlow customized fork (Apache 2.0 license), PyFlow original project (Apache 2.0 license).

Trails, PyTrails, Turns, pivy_trackers, and Geomatics

The Trails workbench was formerly known as the "Transportation Engineering" workbench. It consists of a toolset for developing highway and railway designs, including horizontal alignments, vertical profiles, and 3D models.

Forum discussion (original thread that started the project), forum discussion (main thread, very long); freecad.trails repository (LGPL 2.1), video example.

Most of the functions used in the Trails workbench have been placed in a new Python library called PyTrails. The expectation is that Trails serves as a FreeCAD based graphical interface for PyTrails, while PyTrails remains a general purpose library that can be used outside FreeCAD in other projects.

Forum discussion (PyTrails announcement); PyTrails repository (LGPL 2.1).

The Turns workbench is a small component that was created during development of the Trails workbench. It performs vehicle swept-path analysis (turning analysis) for highway intersections and other entrances.

Forum discussion (main thread); freecad.turns repository (LGPL 2.1), animated GIF example.

After working with Trails and Turns, the author decided to split the tracker code into a separate library called pivy_trackers. This is a general library that could be included in other workbenches to generate tracker objects and perform actions in the scene, like dragging lines, dragging points, and changing certain geometrical elements on the fly.

Forum discussion, (2, 3); pivy_trackers repository (LGPL 2.1), examples, animated GIF example.

The Geomatics workbench provides functionality specific to survey engineering, such as importing geodata information, and creating surfaces from clouds of points. There are some issues with rendering objects that use large coordinates (kilometers) and importing large DXF files. If you want to help solving these issues, please contact the developers.

This workbench started as a fork of the older Geodata workbench by microelly2. Eventually it became a separate project by HakanSeven12. Now its code has been merged into the Trails workbench as it provides complementary functions to it. Therefore, in the future, please use Trails instead of the older Geomatics repository.

Forum discussion; FreeCAD-Geomatics-Workbench repository (LGPL 2.1).