The FreeCAD source code/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Le [https://github.com/FreeCAD/FreeCAD FreeCAD source code] est géré avec git et est public, ouvert et disponible sous la [https://en.wikipedia.org/wiki/GNU_Lesser_General_P...")
No edit summary
 
(12 intermediate revisions by 2 users not shown)
Line 2: Line 2:
Le [https://github.com/FreeCAD/FreeCAD FreeCAD source code] est géré avec git et est public, ouvert et disponible sous la [https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License 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 [http://forum.freecadweb.org forum], pour éviter le risque de voir vos modifications rejetées pour une raison que vous n'aviez pas prévue.
Le [https://github.com/FreeCAD/FreeCAD FreeCAD source code] est géré avec git et est public, ouvert et disponible sous la [https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License 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 [http://forum.freecadweb.org 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.
Below are some clues and useful information to get you on tracks if you are interested in exploring the FreeCAD code.


* The FreeCAD code is programmed mainly in '''C++''', but relies heavily on '''Python'''. A very large part of its functionality provides associated Python bindings, and it is part of the core philosophy of the FreeCAD development to always offer python access to any new feature implemented in C++. To obtain this, CPython (the C interfacing tools provided by Python itself) and specially [http://cxx.sourceforge.net/ PyCXX] are heavily used throughout FreeCAD. Many templates and custom tools are also provided in the FreeCAD code itself to turn the building of associated python bindings very easy. Some more high-level parts of the FreeCAD code are coded fully in Python.
* 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 [http://cxx.sourceforge.net/ 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.


* The FreeCAD source code is fully '''multi-platform''', and great care is taken to allow to use the application on a biggest possible number of platforms and configurations, and not put existing users in difficult situations. Therefore, as much as possible, new versions of needed components are avoided while they are not widely and easily available on all platforms, and backwards compatibility (the ability to open a file produced with an old version of FreeCAD on a newer version) is an important priority.
* 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.


* Almost all the functionality of FreeCAD is separated in two different parts, named '''App''' and '''Gui'''. This separation is reflected everywhere in the files structure of the source code. App contains all the functionality that needs to run in pure console mode (no GUI). As FreeCAD can be compiled and run without its Graphical User Interface, the code in App is independent of any GUI-related library. Gui contains all the code needed to run in GUI mode, and is built around the App functionality.
* 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.


* Most of FreeCAD's functionality is implemented in '''Modules'''. FreeCAD without its module is a simple container window that can just open and save a file. All the geometry tools and workbenches are implemented in Modules. Modules can be written in C++, in Python, or combining the best of the two worlds. They can be hybrid C++/Python modules, where solid core functionality is programmed in C++ and end-user tools are written in Python making them easier to extend and adapt by FreeCAD users. Each module usually defines and creates a '''Workbench''' in the FreeCAD interface, when used in GUI mode, usually with the same name, but it is not mandatory for modules to contain a workbench.
* 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.
* Les modules FreeCAD '''dépendent souvent d'autres modules'''. La plupart des modules qui utilisent la géométrie solide dépendent du module '''Part''', qui est le module le plus fondamental de FreeCAD, et implémente la plupart de l'interfaçage avec OpenCascade. Bien que d'autres modules puissent utiliser directement la fonctionnalité OpenCascade, ils s'appuient souvent sur des fonctions de niveau supérieur fournies par Part.


* Modules are always '''initialized''' from Python. Even if they are written fully in C++, they always contain a minimal Python/CPython structure.
* Les modules sont toujours '''initialisés''' depuis Python. Même s'ils sont entièrement écrits en C++, ils contiennent toujours une structure Python/CPython minimale.


* 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 [https://en.wikipedia.org/wiki/Open_Cascade_Technology OpenCascade Technology] (OCCT) and [http://www.coin3d.org/ 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 est un utilisateur avide d''''autres bibliothèques open-source'''. Outre Python et Qt, utilisés par le noyau et presque tous les modules, les deux bibliothèques lourdes utilisées dans la plupart des modules sont [https://fr.wikipedia.org/wiki/Open_CASCADE_Technology Open CASCADE Technology] (OCCT) et [http://www.coin3d.org/ Coin3D] Open Cascade est utilisé pour créer et gérer toute la géométrie solide de FreeCAD, tandis que coin3D est utilisé pour gérer la vue 3D. OpenCascade est principalement utilisé dans le monde des applications et coin3D exclusivement dans le monde de l'interface graphique. Une compréhension de base d'Open Cascade est fondamentale pour effectuer tout travail lié à la géométrie avec FreeCAD. Des modules plus spécifiques utilisent des bibliothèques plus spécifiques, et comme il n'y a généralement aucune restriction sur ce point en dehors de ces bibliothèques pour être facilement disponibles sur toutes les plates-formes, la liste des dépendances d'une installation complète de FreeCAD avec tous ses modules peut être assez longue.


* 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.
* Les '''objets de document''' de FreeCAD, qui sont tous les objets contenus dans un document FreeCAD, sont ce qui apparaît dans l'arborescence de l'interface graphique et dans FreeCAD.ActiveDocument.Objects() en Python. Ils peuvent ou non avoir des données géométriques, et peuvent ou non afficher quoi que ce soit dans la vue 3D. Ils sont toujours séparés dans les parties App et Gui. La partie Gui n'est pas chargée lors de l'exécution en mode console. Les objets géométriques standard, tels que ceux trouvés dans Part ou PartDesign, ont leur géométrie basée sur OpenCascade définie dans leur homologue App, tandis que l'homologue Gui (également généralement appelé "View Provider") est responsable de la création d'une représentation coin3D de cette géométrie, qui sera inséré dans le graphique principal de la scène coin3D de la vue 3D.


* La structure de répertoire de base du code source est organisée comme ceci:
* 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.
** '''App''': contient l'application en mode console FreeCAD, définit les structures de base et les classes de base pour les objets de document, qui sont utilisées par les modules pour créer leurs propres
** '''Base''': contains core functionality commonly used everywhere in FreeCAD: 3D vectors, units, matrices, placements, etc.
** '''Base''': contient les fonctionnalités de base couramment utilisées partout dans FreeCAD: vecteurs 3D, unités, 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.
** '''Gui''': contient l'application en mode GUI de FreeCAD, définit la vue 3D, contient de nombreux outils et fonctions à utiliser par les établis pour interagir avec l'interface et avec la vue 3D, définit les classes de base pour les fournisseurs de vues .
** '''Doc''': contains mainly an all-in-one Qt help file generated from this wiki.
** '''Doc''': contient principalement un fichier d'aide Qt tout-en-un généré à partir de ce 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).
** '''Mod''': contient tous les modules, eux-mêmes séparés en App et Gui (à l'exception des modules python, qui ne suivent pas toujours cette règle aussi clairement).


=== Related ===
=== En relation ===
* [[Source_code_management|Source Code Management]]
* [[Source_code_management/fr|Gestion du code source]]
* 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.
* La [[Power_users_hub/fr|Documentation pour utilisateurs expérimentés]] contient beaucoup de documentation sur les modules, OpenCascade et Coin3D, principalement pour le programmeur Python. Cependant, comme la fonctionnalité est similaire, ces pages intéresseront également le programmeur C++.
* [[File_Format_FCStd/fr|FCStd]] - le format de fichier FreeCAD


[[Category:Developer Documentation{{#translation:}}]]
[[Category:Developer Documentation{{#translation:}}]]
{{clear}}

Latest revision as of 16:35, 20 March 2021

Other languages:

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.
  • Les modules FreeCAD dépendent souvent d'autres modules. La plupart des modules qui utilisent la géométrie solide dépendent du module Part, qui est le module le plus fondamental de FreeCAD, et implémente la plupart de l'interfaçage avec OpenCascade. Bien que d'autres modules puissent utiliser directement la fonctionnalité OpenCascade, ils s'appuient souvent sur des fonctions de niveau supérieur fournies par Part.
  • Les modules sont toujours initialisés depuis Python. Même s'ils sont entièrement écrits en C++, ils contiennent toujours une structure Python/CPython minimale.
  • FreeCAD est un utilisateur avide d'autres bibliothèques open-source. Outre Python et Qt, utilisés par le noyau et presque tous les modules, les deux bibliothèques lourdes utilisées dans la plupart des modules sont Open CASCADE Technology (OCCT) et Coin3D Open Cascade est utilisé pour créer et gérer toute la géométrie solide de FreeCAD, tandis que coin3D est utilisé pour gérer la vue 3D. OpenCascade est principalement utilisé dans le monde des applications et coin3D exclusivement dans le monde de l'interface graphique. Une compréhension de base d'Open Cascade est fondamentale pour effectuer tout travail lié à la géométrie avec FreeCAD. Des modules plus spécifiques utilisent des bibliothèques plus spécifiques, et comme il n'y a généralement aucune restriction sur ce point en dehors de ces bibliothèques pour être facilement disponibles sur toutes les plates-formes, la liste des dépendances d'une installation complète de FreeCAD avec tous ses modules peut être assez longue.
  • Les objets de document de FreeCAD, qui sont tous les objets contenus dans un document FreeCAD, sont ce qui apparaît dans l'arborescence de l'interface graphique et dans FreeCAD.ActiveDocument.Objects() en Python. Ils peuvent ou non avoir des données géométriques, et peuvent ou non afficher quoi que ce soit dans la vue 3D. Ils sont toujours séparés dans les parties App et Gui. La partie Gui n'est pas chargée lors de l'exécution en mode console. Les objets géométriques standard, tels que ceux trouvés dans Part ou PartDesign, ont leur géométrie basée sur OpenCascade définie dans leur homologue App, tandis que l'homologue Gui (également généralement appelé "View Provider") est responsable de la création d'une représentation coin3D de cette géométrie, qui sera inséré dans le graphique principal de la scène coin3D de la vue 3D.
  • La structure de répertoire de base du code source est organisée comme ceci:
    • App: contient l'application en mode console FreeCAD, définit les structures de base et les classes de base pour les objets de document, qui sont utilisées par les modules pour créer leurs propres
    • Base: contient les fonctionnalités de base couramment utilisées partout dans FreeCAD: vecteurs 3D, unités, matrices, placements, etc.
    • Gui: contient l'application en mode GUI de FreeCAD, définit la vue 3D, contient de nombreux outils et fonctions à utiliser par les établis pour interagir avec l'interface et avec la vue 3D, définit les classes de base pour les fournisseurs de vues .
    • Doc: contient principalement un fichier d'aide Qt tout-en-un généré à partir de ce wiki.
    • Mod: contient tous les modules, eux-mêmes séparés en App et Gui (à l'exception des modules python, qui ne suivent pas toujours cette règle aussi clairement).

En relation

Retrieved from "http://wiki.freecad.org/index.php?title=The_FreeCAD_source_code/fr&oldid=867945"