The FreeCAD source code/fr: Difference between revisions
(Created page with "* Presque toutes les fonctionnalités de FreeCAD sont séparées en deux parties différentes, nommées '''App''' et '''Gui'''. Cette séparation se reflète partout dans la s...") |
(Created page with "* La plupart des fonctionnalités de FreeCAD sont implémentées dans '''Modules'''. FreeCAD sans son module est une simple fenêtre de conteneur qui peut simplement ouvrir et...") |
||
| Line 10: | Line 10: | ||
* Presque toutes les fonctionnalités de FreeCAD sont séparées en deux parties différentes, nommées '''App''' et '''Gui'''. Cette séparation se reflète partout dans la structure des fichiers du code source. L'application contient toutes les fonctionnalités nécessaires pour fonctionner en mode console pure (pas d'interface graphique). Comme FreeCAD peut être compilé et exécuté sans son interface utilisateur graphique, le code de l'application est indépendant de toute bibliothèque liée à l'interface graphique. L'interface graphique contient tout le code nécessaire pour s'exécuter en mode GUI et est construite autour de la fonctionnalité de l'application. |
* Presque toutes les fonctionnalités de FreeCAD sont séparées en deux parties différentes, nommées '''App''' et '''Gui'''. Cette séparation se reflète partout dans la structure des fichiers du code source. L'application contient toutes les fonctionnalités nécessaires pour fonctionner en mode console pure (pas d'interface graphique). Comme FreeCAD peut être compilé et exécuté sans son interface utilisateur graphique, le code de l'application est indépendant de toute bibliothèque liée à l'interface graphique. L'interface graphique contient tout le code nécessaire pour s'exécuter en mode GUI et est construite autour de la fonctionnalité de l'application. |
||
* |
* La plupart des fonctionnalités de FreeCAD sont implémentées dans '''Modules'''. FreeCAD sans son module est une simple fenêtre de conteneur qui peut simplement ouvrir et enregistrer un fichier. Tous les outils de géométrie et les ateliers sont implémentés dans des modules. Les modules peuvent être écrits en C++, en Python ou en combinant le meilleur des deux mondes. Il peut s'agir de modules hybrides C++/Python, où les fonctionnalités de base solides sont programmées en C++ et les outils de l'utilisateur final sont écrits en Python, ce qui les rend plus faciles à étendre et à adapter par les utilisateurs de FreeCAD. Chaque module définit et crée généralement un '''Atelier ''' dans l'interface FreeCAD, lorsqu'il est utilisé en mode GUI, généralement avec le même nom, mais il n'est pas obligatoire pour les modules de contenir un workbench. |
||
* FreeCAD modules often '''depend on other modules'''. Most modules that use solid geometry depend on the '''Part''' module, which is the most fundamental module of FreeCAD, and implements most of the interfacing with OpenCascade. Although other module can use OpenCascade functionality directly, they often rely on higher-level functions provided by Part. |
* FreeCAD modules often '''depend on other modules'''. Most modules that use solid geometry depend on the '''Part''' module, which is the most fundamental module of FreeCAD, and implements most of the interfacing with OpenCascade. Although other module can use OpenCascade functionality directly, they often rely on higher-level functions provided by Part. |
||
Revision as of 14:03, 17 January 2021
Le FreeCAD source code est géré avec git et est public, ouvert et disponible sous la licence LGPL. Il peut être copié, téléchargé, lu, analysé, redistribué et modifié par n'importe qui. Si vous prévoyez d'apporter des modifications que vous souhaitez voir incluses dans le code officiel lui-même, n'oubliez pas que vos modifications devront être approuvées par les développeurs de FreeCAD, il est donc sage de discuter d'abord de vos intentions et de vos idées sur le forum, pour éviter le risque de voir vos modifications rejetées pour une raison que vous n'aviez pas prévue.
Vous trouverez ci-dessous quelques indices et informations utiles pour vous mettre sur les rails si vous souhaitez explorer le code FreeCAD.
- Le code FreeCAD est principalement programmé en C++ mais repose fortement sur Python. Une très grande partie de ses fonctionnalités fournit des liaisons Python associées, et cela fait partie de la philosophie de base du développement FreeCAD de toujours offrir un accès python à toute nouvelle fonctionnalité implémentée en C++. Pour obtenir cela, CPython (les outils d'interfaçage C fournis par Python lui-même) et spécialement PyCXX sont largement utilisés dans FreeCAD. De nombreux modèles et outils personnalisés sont également fournis dans le code FreeCAD lui-même pour faciliter la création de liaisons python associées. Certaines parties de plus haut niveau du code FreeCAD sont entièrement codées en Python.
- Le code source de FreeCAD est entièrement multi-plateforme et un grand soin est pris pour permettre d'utiliser l'application sur un plus grand nombre possible de plates-formes et de configurations, et de ne pas mettre les utilisateurs existants dans des situations difficiles. Par conséquent, autant que possible, les nouvelles versions des composants nécessaires sont évitées alors qu'elles ne sont pas largement et facilement disponibles sur toutes les plates-formes, et la rétrocompatibilité (la possibilité d'ouvrir un fichier produit avec une ancienne version de FreeCAD sur une version plus récente) est un priorité importante.
- Presque toutes les fonctionnalités de FreeCAD sont séparées en deux parties différentes, nommées App et Gui. Cette séparation se reflète partout dans la structure des fichiers du code source. L'application contient toutes les fonctionnalités nécessaires pour fonctionner en mode console pure (pas d'interface graphique). Comme FreeCAD peut être compilé et exécuté sans son interface utilisateur graphique, le code de l'application est indépendant de toute bibliothèque liée à l'interface graphique. L'interface graphique contient tout le code nécessaire pour s'exécuter en mode GUI et est construite autour de la fonctionnalité de l'application.
- La plupart des fonctionnalités de FreeCAD sont implémentées dans Modules. FreeCAD sans son module est une simple fenêtre de conteneur qui peut simplement ouvrir et enregistrer un fichier. Tous les outils de géométrie et les ateliers sont implémentés dans des modules. Les modules peuvent être écrits en C++, en Python ou en combinant le meilleur des deux mondes. Il peut s'agir de modules hybrides C++/Python, où les fonctionnalités de base solides sont programmées en C++ et les outils de l'utilisateur final sont écrits en Python, ce qui les rend plus faciles à étendre et à adapter par les utilisateurs de FreeCAD. Chaque module définit et crée généralement un Atelier dans l'interface FreeCAD, lorsqu'il est utilisé en mode GUI, généralement avec le même nom, mais il n'est pas obligatoire pour les modules de contenir un workbench.
- FreeCAD modules often depend on other modules. Most modules that use solid geometry depend on the Part module, which is the most fundamental module of FreeCAD, and implements most of the interfacing with OpenCascade. Although other module can use OpenCascade functionality directly, they often rely on higher-level functions provided by Part.
- Modules are always initialized from Python. Even if they are written fully in C++, they always contain a minimal Python/CPython structure.
- FreeCAD is an avid user of other open-source libraries. Besides Python and Qt, used by the core and almost all of the modules, the two heavyweight libraries used throughout most modules are OpenCascade Technology (OCCT) and Coin3D. OpenCascade is used to create and manage all the solid geometry of FreeCAD, while coin3D is used to manage the 3D view. OpenCascade is used mainly in the App world, and coin3D exclusively in the Gui world. A basic understanding of OpenCascade is fundamental to do any geometry-related work with FreeCAD. More specific modules make use of more specific libraries, and since there are usually no restrictions on that point apart from these libraries to be easily available on all platforms, the list of dependencies of a full FreeCAD installation with all its modules can be quite large.
- FreeCAD's document objects, which are all the objects contained in a FreeCAD document, are what appear in the Tree View in the GUI and in FreeCAD.ActiveDocument.Objects() in Python. They may or may not have any geometrical data, and may or may not show anything in the 3D view. They are always separated in App and Gui parts. The Gui part is not loaded when running in console mode. Standard geometrical objects, such as those found in Part or PartDesign, have their OpenCascade-based geometry defined in their App counterpart, while the Gui counterpart (also usually called "View Provider") is responsible for creating a coin3D representation of that geometry, which will be inserted into the main coin3D scene graph of the 3D view.
- The basic directory structure of the source code is organized like this:
- App: contains the FreeCAD console-mode application, defines basic structures and base classes for document objects, that are used by modules to build their own.
- Base: contains core functionality commonly used everywhere in FreeCAD: 3D vectors, units, matrices, placements, etc.
- Gui: contains the FreeCAD GUI-mode application, defines the 3D view, contains many tools and functions to be used by workbenches to interact with the interface and with the 3D view, defines base classes for view providers.
- Doc: contains mainly an all-in-one Qt help file generated from this wiki.
- Mod: contains all the modules, themselves further separated into App and Gui (except for python modules, which don't always follow that rule so clearly).
Related
- Source Code Management
- The Power users hub contains a lot of documentation about modules, OpenCascade and Coin3D, mainly for the Python programmer. However, as the functionality is similar, these pages will be of interest to the C++ programmer as well.