Bibliothèques tierces

Other languages:

Vue d'ensemble

Ce sont des bibliothèques que FreeCAD utilise comme dépendances non modifiées, c'est-à-dire comme bibliothèques liées dynamiquement ; ce sont des fichiers avec une extension .so sous Linux/MacOS et une extension .dll sous Windows. Si une bibliothèque modifiée est nécessaire, ou si une classe wrapper est nécessaire, le code de la bibliothèque modifiée, ou du wrapper, doit faire partie du code source de FreeCAD et être compilé avec ce dernier.

The dependencies need to be installed in the system before proceeding with compilation; see compile on Unix, compile on Windows, and compile on Mac for more information.

Si vous utilisez Windows, pensez à utiliser le LibPack au lieu d'essayer d'installer une librairie individuelle.

Liens

Nom de la librairie	Version needed	Link to get it
Python	>= 2.5.x	http://www.python.org/
OpenCasCade	>= 5.2	http://www.opencascade.org
Qt	>= 4.1.x	https://www.qt.io/
Coin3D	>= 2.x	https://bitbucket.org/Coin3D/coin/wiki/Home
SoQt (deprecated)	>= 1.2	https://bitbucket.org/Coin3D/soqt/src/default/
Quarter	>= 1.0.0	https://bitbucket.org/Coin3D/quarter/src/default/
Xerces-C++	>= 2.7.x < 3.0	http://xml.apache.org/xerces-c/
Zlib	>= 1.x.x	http://www.zlib.net/
Boost	>= 1.33.x	http://www.boost.org/
Eigen3	>= 3.0.1	http://eigen.tuxfamily.org/index.php?title=Main_Page
Shiboken	>= 1.1.2	http://shiboken.readthedocs.org/en/latest/
libarea	N/A	https://github.com/danielfalck/libarea

Details

Python

Version : 3.3 ou plus

Licence : Python 3.3 licence

Python 2 est devenu obsolète en 2019. Le développement ultérieur de FreeCAD utilisera exclusivement Python 3 ; la compatibilité avec Python 2 ne sera pas explicitement ajoutée. Par conséquent, les anciens ateliers et les macros qui utilisent cette version devront être migrés ou risquent de ne plus fonctionner.

Python is a popular all-purpose scripting language that is widely used in Linux and open source software. In FreeCAD, Python is used during compilation and also at runtime in different ways. It is used

to write test scripts to test for different conditions, such as memory leaks, to ensure functionality of the software after changes, for post build checks, and test coverage tests,
to write macros and macro recording,
to implement application logic for standard packages,
to implement auxiliary tools such as the Addon Manager,
to implement entire workbenches like Draft and Arch,
to dynamically load packages,
to implement rules for design (knowledge engineering),
to do fancy Internet interactions like work groups and PDM

Sous Linux, Python est généralement déjà installé dans votre distribution. Pour Windows, vous pouvez utiliser le source ou le binaire de Python.org ou utiliser ActiveState Python bien qu’il soit un peu difficile d’obtenir les bibliothèques de débogage de ce dernier.

Python was chosen as the scripting language for FreeCAD for different reasons:

It is more object oriented than Perl and Tcl.
The code is more readable than Perl and Visual Basic.
It is easier to embed in another application, unlike, say, Java.

In summary, Python is well documented, and it's easy to embed and extend in a C++ application. It is also well tested and has strong support from the open source community. Read more about Python and browse the official documentation at Python.org.

Boost

Version: 1.33.x

License: Boost Software License - Version 1.0

Les bibliothèques Boost C++ sont une collection évaluées par des pairs, les bibliothèques, sont open source, et, étendent les fonctionnalités de C++. Les bibliothèques sont sous licence Boost Software License, Boost est conçu, pour être utilisé avec des projets open source et fermés. Beaucoup de programmeurs Boost sont sur le C++ standard committee, et plusieurs bibliothèques Boost ont été acceptées, pour leurs incorporations dans le Technical Report 1 of C++0x.

Due to their popularity and stability, many Boost libraries have been accepted for incorporation into the C++11 standard, and more are planned for inclusion in subsequent C++ standards.

Afin d'assurer l'efficacité et la flexibilité, Boost fait un usage intensif de modèles (templates). Boost a été une source de travail, et, de recherches approfondies dans la programmation générique, et, méta-données en C++.

OpenCasCade

Version: 5.2 ou plus

Licence: v6.7.0 et les versions ultérieures sont régies par la version 2.1 de la Licence publique générale GNU (LGPL) avec une exception supplémentaire. https://www.opencascade.com/content/licensing. Les versions antérieures utilisent une licence légèrement différente: https://www.opencascade.com/content/occt-public-license

OCC est un noyau complet CAD. A l'origine, il a été développé en France par Matra Datavision, pour la Strim (Styler) et Euclide applications quantiques, et, plus tard fait pour l'Open Source. C'est une bibliothèque vraiment énorme, et, faire en premier lieu une application de CAO libre est possible, en fournissant certains paquets, qui seraient difficiles, ou impossibles à mettre en œuvre dans un projet Open Source :

Un noyau géométrique complet conforme à STEP.
Un modèle topologique de données et toutes les fonctions nécessaires pour travailler sur les (coupes, fusion, extrusion, etc ...)
Import-standard/exportation des processeurs comme STEP, IGES, VRML.
Visionneuse 2D et 3D avec le soutien de la sélection.
Une structure de document, et, données de projet, avec le soutien de, sauvegarde et restauration, de liaison externe des documents, de recalcul de l'historique du dessin (modélisation paramétrique) et d'un centre de chargement de nouveaux types de données, comme un module d'extension dynamique.

OCCT is a big and complex set of C++ libraries that provide functionality required by a CAD application:

A complete STEP compliant geometry kernel.
A topological data model and needed functions to work with shapes (cut, fuse, extrude, and many others).
Standard import and export processors for files like STEP, IGES, VRML.
A 2D and 3D viewer with selection support.
A document and project data structure with support for save and restore, external linking of documents, recalculation of design history (parametric modeling) and a facility to load new data types as an extension package dynamically.

There are two main versions of OpenCASCADE in existence in different Linux distributions. One is distributed by the original developers; it is known as OCCT, and is packaged under the names occ or occt. The other version is the "community edition", abbreviated OCE, and is normally found with the oce name. FreeCAD can compile against either version, however, since 2016 FreeCAD recommends compiling against the official OCCT libraries rather than the OCE ones. The reason is that the community edition lacks important bug fixes and functions that make using FreeCAD better.

Pour en savoir plus sur OpenCascade jeter un coup oeil à la page OpenCascade ou sur OpenCascade.

Qt

Version: 4.1.x or higher

Licence : GPL v2.0/v3.0 ou commerciale (à partir de la version 4.5 aussi sur v2.1 LPGL)

Je ne pense pas que j'ai besoin de dire beaucoup de choses sur Qt. C'est un des outils les plus souvent utilisés, dans l'interface graphique des projets Open Source. Pour moi, le point le plus important d'utiliser Qt est le Qt Designer et la possibilité de charger les boîtes de dialogue entières comme, une ressource (XML), et, d'intégrer des widgets spécialisés.

Dans une application CAX, l'interaction avec l'utilisateur, et, les boîtes de dialogue, sont de loin la plus grande partie du code, et, un bon concepteur de boîtes de dialogues, est très important pour ajouter facilement de nouvelles fonctionnalités à FreeCAD.

Vous trouverez de plus amples informations, et une très bonne documentation en ligne sur Qt

Further information about Qt libraries and their programming documentation are available at Qt Documentation.

Shiboken et Pyside

Shiboken (Shi bō ken, 死某剣) est le générateur de liaisons Python utilisé par Qt pour Python pour créer le module PySide. En d'autres termes, c'est le système que nous utilisons pour exposer Qt C ++. API à Python.

Les noms Shiboken2 et PySide2 font référence à la compatibilité avec Qt 5 puisque les versions précédentes (sans le 2 ) font référence à Qt 4. Pour en savoir plus sur Shiboken et Pyside voir Qt pour la page wiki de Python

Read more about Shiboken and Pyside on Qt for Python.

Coin3D

Version: 2.0 ou plus

License: GPL v2.0 ou Commercial

Coin est une bibliothèque graphique 3D de haut niveau, avec une interface de programmation C++. Coin utilise une structure de données scenegraph, pour rendre des graphiques en temps réel, il est adapté à toutes sortes d'applications de visualisation scientifique, et, d'ingénierie.

Coin est construit sur le standard industriel OpenGL avec les bibliothèques de rendu immédiat, et, ajoute les abstractions de primitives de haut niveau, fournit une interactivité 3D, augmente la commodité et la productivité du programmeur, contient de nombreuses fonctions d'optimisations complexes, pour obtenir un rendu rapide, et, de plus est transparent pour le programmeur d'applications.

Coin est basé sur l'API Open Inventor de SGI. Open Inventor est devenu l'interface graphique standard de facto pour les logiciels de visualisation 3D et de simulation visuelle dans la communauté scientifique et technique. Il a fait ses preuves depuis 20 ans en tant que pierre angulaire de plusieurs milliers d'applications d'ingénierie à grande échelle dans le monde.

OpenInventor est utilisé comme visualiseur 3D dans FreeCAD car le visualiseur OpenCASCADE (AIS et Graphics3D) présente des limitations et des goulots d'étranglement en termes de performances, notamment avec le rendu technique à grande échelle. D'autres éléments tels que les textures ou le rendu volumétrique ne sont pas vraiment pris en charge.

Coin est portable sur un large éventail de plates-formes : UNIX / Linux / BSD, Mac OS X, et tous les systèmes d'exploitation Microsoft Windows.

SoQt (déprécié)

Version: 1.2.0 ou plus

License: GPL v2.0 ou commercial

SoQt est l'inventeur de la liaison avec la boîte à outils Qt Gui. Malheureusement, il n'est plus LGPL, et, nous devons donc le supprimer du code de FreeCAD, et le lier comme une bibliothèque. Il a le même type de licence que Coin. Et vous devez le compiler avec votre version de Qt.

SoQt n'est plus utilisé dans FreeCAD, il a été remplacé par Quarter qui est une connexion plus récente.

Quarter

Version : 1.0 ou suivantes

License: BSD 3-clause license

Quarter est une nouvelle connexion Coin3d à la boîte à outils Qt. Une version de celui-ci est incluse dans le code source de FreeCAD.

Xerces-C++

Version: 2.7.0 ou plus

License: Apache Software License Version 2.0

Xerces-C++ est un analyseur de validation XML, écrit dans un sous-ensemble portable de C++. Avec Xerces-C++, il est facile de donner à votre application la capacité de lire et écrire des données au format XML. Une bibliothèque partagée est prévue pour l'analyse, la génération, la manipulation et la validation des documents XML.

L'analyseur est utilisé, pour sauvegarder, et, restaurer les paramètres dans FreeCAD.

Eigen3

Version: 3.0 or higher

License: Starting from the 3.1.1 version, it is licensed under the Mozilla Public License 2.0. Earlier versions were licensed under the GNU Lesser General Public License 3.

Eigen is a C++ template library for linear algebra: matrices, vectors, numerical solvers, and related algorithms.

If you just want to use Eigen, you can use the header files right away. There is no binary library to link to, and no configured header file. Eigen is a pure template library defined in the headers.

Eigen is used in FreeCAD for many vector operations in 3D space. To learn more, visit Eigen homepage.

Zipios++

Version: 0.1.5 or higher

License: GNU Lesser General Public License 2.1

Zipios++ is a C++ library for reading and writing .zip files. Access to individual entries is provided through standard C++ iostreams. A simple read-only virtual file system that mounts regular directories and .zip files is also provided. The structure and public interface of Zipios++ are loosely based on the java.util.zip package of Java.

FreeCAD's native file format .FCstd is in reality a .zip file that stores and compresses other types of data within it, such as BREP and XML files. Therefore, Zipios++ is used to save and open compressed archives, including FreeCAD files.

A copy of Zipios++ is included in the source code of FreeCAD so it is compiled together with it. If you want to use an external Zipios++ library, provided by your operating system, you may set -DFREECAD_USE_EXTERNAL_ZIPIOS=ON with cmake.

Zipios++ uses the Zlib library to perform the actual decompression of files.

Zlib

Version: 1.x.x

License: zlib Licence

zlib est conçu pour comprimer des données de toute sorte, il est libre, et légalement utilisé, il n'est pas couvert par des brevets, il compresse sans perte de données, et pour une utilisation sur pratiquement n'importe quel matériel informatique et système d'exploitation. Le format des données zlib est lui-même portable sur toutes les plateformes. Contrairement à la méthode de compression LZW utilisée sous Unix compress(1) et dans le format d'image GIF, la méthode de compression utilisée actuellement dans zlib, ne "gonfle" jamais les données. (LZW peut doubler ou dans les cas extrêmes, tripler la taille du fichier). L'empreinte mémoire de la librairie zlib, est également indépendante des données entrées et peut être, si nécessaire, réduite à un certain taux de compression.

A copy of this library is included in the source code of FreeCAD so it is compiled together with it.

libarea

Version: non applicable

License: nouvelle BSD (BSD 3-Clause)

Area est un logiciel créé par Dan Heeks pour HeeksCNC. Il sert de bibliothèque pour la génération d'opérations liées au CAM dans Path Workbench.

A copy of the library is included with the source code of the Path Workbench, so it is compiled together with it.

LibPack

LibPack est un paquet pratique qui regroupe toutes les bibliothèques ci-dessus. Cela n'est nécessaire que si vous utilisez une plate-forme Windows. Vous pouvez le trouver à l'adresse https://github.com/FreeCAD/FreeCAD-ports-cache/releases. Si vous travaillez sous Linux, vous devez utiliser les référentiels de paquets de votre distribution Linux. LibPack n’est nécessaire dans Linux et fourni par Linux.

If you're working under Linux, you don't need the LibPack, as you can get the dependencies from your distribution's repositories as mentioned in the compile on Unix page.

FreeCAD 12.1.2

See the announcement in the forum: New libpacks for Windows with Qt5.12, OCC7.3 and Python 3.6 by apeltauer

It includes among other things: Boost 1.67, Coin3D 4.0.0a, Eigen3, Open CASCADE Technology 7.3.0, Python 3.6.8, PySide2, Qt 5.12.1, Salome SMESH, Shiboken2, vtk7, Xerces-C, Zipios++, zlib 1.2.11

Compilation

Outils tiers

Index