Document structure/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "{{docnav/fr|Naviguer dans l'espace 3D|Réglage des préférences}}")
(34 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
{{docnav/fr|[[Mouse Model/fr|Naviguer dans l'espace 3D]]|[[Preferences Editor/fr|Réglage des préférences]]}}

[[Image:Screenshot treeview.jpg|left]]
[[Image:Screenshot treeview.jpg|left]]
A FreeCAD document contains all the objects of your scene. It can contain groups, and objects made with any workbench. You can therefore switch between workbenches, and still work on the same document. The document is what gets saved to disk when you save your work. You can also open several documents at the same time in FreeCAD, and open several views of the same document.
Un document FreeCAD contient tous les objets compris dans votre scène. Il peut contenir des groupes ainsi que des objets créés avec n'importe quel atelier. Vous pouvez donc basculer entre les ateliers et toujours travailler sur le même document. Ce document est ce qui est enregistré sur le disque quand vous sauvegardez votre travail. Vous pouvez aussi ouvrir plusieurs documents à la fois dans FreeCAD, et ouvrir plusieurs vues du même document.


À l'intérieur du document, les objets peuvent être regroupés, et avoir un nom unique. La gestion des groupes, objets et noms d'objets se fait à partir de la vue arborescente. Elle peut bien évidemment se faire aussi, comme tout dans FreeCAD, depuis l'interpréteur [[Python/fr|Python]]. Dans la vue arborescente, avec un clic droit de la souris dans la vue arborescente ou sur un objet, vous pouvez créer des groupes, déplacer des objets dans des groupes, supprimer des objets ou des groupes ; renommer des objets avec un double-clic sur leur nom ; ou possiblement d'autres opération, selon l'établi actif.
Inside the document, the objects can be moved into groups, and have a unique name. Managing groups, objects and object names is done mainly from the Tree view. It can also be done, of course, like everything in FreeCAD, from the python interpreter. In the Tree view, you can create groups, move objects to groups, delete objects or groups, by right-clicking in the tree view or on an object, rename objects by double-clicking on their names, or possibly other operations, depending on the current workbench.


The objects inside a FreeCAD document can be of different types. Each workbench can create its own types of objects, for example the [[Mesh Workbench]] creates mesh objects, the [[Part Workbench]] create Part objects, the [[Draft Workbench]] also creates Part objects, etc.
Les objets dans un document FreeCAD peuvent être de différents types. Chaque atelier peut créer ses propres types d'objets ; par exemple, l'[[Mesh Module/fr|Atelier Maillages]] créé des maillages, l'[[Part Module/fr|Atelier Pièce]] créé des objets pièces, la [[Draft Module/fr|Planche à dessin]] créé aussi des objets pièces, etc.


If there is at least one document open in FreeCAD, there is always one and only one active document. That's the document that appears in the current 3D view, the document you are currently working on.
S'il y a au moins un document ouvert dans FreeCAD, il ne peut y avoir qu'un seul document actif. Il s'agit du document qui est affiché dans la vue 3D courante, le document sur lequel vous travaillez.


==Interface utilisateur et application==
==Application and User Interface==


Like almost everything else in FreeCAD, the user interface part (Gui) is separated from the base application part (App). This is also valid for documents. The documents are also made of two parts: the Application document, which contains our objects, and the View document, which contains the representation on screen of our objects.
Puisque l'architecture de FreeCAD est totalement modulaire, l'interface graphique ou environnement graphique est séparée de la partie application. Ceci est aussi valide pour les documents. Les documents sont aussi séparés en deux parties : le document Application, qui contient les objets, et le document Affichage, qui contient la représentation à l'écran des objets.


Voyez cela comme deux espaces dans lesquels les objets sont définis. Leurs paramètres de construction (est-ce un cube ? un cône ? quelle taille ?) sont enregistrés dans le document Application, alors que leur représentation graphique (l'objet est-il dessiné avec des lignes noires ? avec des faces de couleur bleue ?) est enregistrée dans le document Affichage. Pourquoi cela ? Parce que FreeCAD peut aussi être utilisé {{emphasis|sans}} l'interface graphique, par exemple à l'intérieur d'autres programmes, et nous devons pouvoir manipuler les objets, même si rien n'est affiché à l'écran.
Think of it as two spaces, where the objects are defined. Their constructive parameters (is it a cube? a cone? which size?) are stored in the Application document, while their graphical representation (is it drawn with black lines? with blue faces?) are stored in the View document. Why is that? Because FreeCAD can also be used WITHOUT graphical interface, for example inside other programs, and we must still be able to manipulate our objects, even if nothing is drawn on the screen.


Le document Affichage contient aussi les vues 3D. Un document peut avoir plusieurs vues ouvertes, ce qui vous permet de l'inspecter depuis plusieurs points de vue en même temps. Vous pourriez vouloir afficher à la fois une vue de dessus et une vue de face de votre projet. Deux vues du même document seront alors enregistrées dans le document Affichage. La création de nouvelles vues, ou la fermeture des vues peut être faite depuis le menu Vue, ou par un clic droit de la souris sur l'onglet d'une vue.
Another thing that is contained inside the View document are 3D views. One document can have several views opened, so you can inspect your document from several points of view at the same time. Maybe you would want to see a top view and a front view of your work at the same time? Then, you will have two views of the same document, both stored in the View document. Creating new views or closing views can be done from the View menu or by right-clicking on a view tab.


==Scripting==
==Script==


Les documents peuvent être créés, accédés et modifiés facilement depuis l'interpréteur [[Python/fr|Python]]. Par exemple :
Documents can be easily created, accessed and modified from the python interpreter. For example:
{{Code|code=
FreeCAD.ActiveDocument
FreeCAD.ActiveDocument
Will return the current (active) document
}}
FreeCAD.ActiveDocument.Blob
Retournera le document courant (actif)
Would access an object called "Blob" inside your document
{{Code|code=
FreeCADGui.ActiveDocument
FreeCAD.ActiveDocument.Blob
Will return the view document associated to the current document
}}
FreeCADGui.ActiveDocument.Blob
Accède à un objet nommé « Blob » à l'intérieur de votre document
Would access the graphical representation (view) part of our Blob object
{{Code|code=
FreeCADGui.ActiveDocument.ActiveView
FreeCADGui.ActiveDocument
Will return the current view
}}
Retournera la vue document associée au document courant
{{Code|code=
FreeCADGui.ActiveDocument.Blob
}}
Accède à la représentation graphique (vue) de l'objet « Blob »
{{Code|code=
FreeCADGui.ActiveDocument.ActiveView
}}
Retourne à la vue courante


{{docnav|Mouse Model|Preferences Editor}}
{{docnav/fr|[[Mouse Model/fr|Naviguer dans l'espace 3D]]|[[Preferences Editor/fr|Réglage des préférences]]}}


[[Category:User Documentation]]
[[Category:User Documentation/fr]]
<languages/>

Revision as of 07:04, 5 April 2019

Un document FreeCAD contient tous les objets compris dans votre scène. Il peut contenir des groupes ainsi que des objets créés avec n'importe quel atelier. Vous pouvez donc basculer entre les ateliers et toujours travailler sur le même document. Ce document est ce qui est enregistré sur le disque quand vous sauvegardez votre travail. Vous pouvez aussi ouvrir plusieurs documents à la fois dans FreeCAD, et ouvrir plusieurs vues du même document.

À l'intérieur du document, les objets peuvent être regroupés, et avoir un nom unique. La gestion des groupes, objets et noms d'objets se fait à partir de la vue arborescente. Elle peut bien évidemment se faire aussi, comme tout dans FreeCAD, depuis l'interpréteur Python. Dans la vue arborescente, avec un clic droit de la souris dans la vue arborescente ou sur un objet, vous pouvez créer des groupes, déplacer des objets dans des groupes, supprimer des objets ou des groupes ; renommer des objets avec un double-clic sur leur nom ; ou possiblement d'autres opération, selon l'établi actif.

Les objets dans un document FreeCAD peuvent être de différents types. Chaque atelier peut créer ses propres types d'objets ; par exemple, l'Atelier Maillages créé des maillages, l'Atelier Pièce créé des objets pièces, la Planche à dessin créé aussi des objets pièces, etc.

S'il y a au moins un document ouvert dans FreeCAD, il ne peut y avoir qu'un seul document actif. Il s'agit du document qui est affiché dans la vue 3D courante, le document sur lequel vous travaillez.

Interface utilisateur et application

Puisque l'architecture de FreeCAD est totalement modulaire, l'interface graphique ou environnement graphique est séparée de la partie application. Ceci est aussi valide pour les documents. Les documents sont aussi séparés en deux parties : le document Application, qui contient les objets, et le document Affichage, qui contient la représentation à l'écran des objets.

Voyez cela comme deux espaces dans lesquels les objets sont définis. Leurs paramètres de construction (est-ce un cube ? un cône ? quelle taille ?) sont enregistrés dans le document Application, alors que leur représentation graphique (l'objet est-il dessiné avec des lignes noires ? avec des faces de couleur bleue ?) est enregistrée dans le document Affichage. Pourquoi cela ? Parce que FreeCAD peut aussi être utilisé sans l'interface graphique, par exemple à l'intérieur d'autres programmes, et nous devons pouvoir manipuler les objets, même si rien n'est affiché à l'écran.

Le document Affichage contient aussi les vues 3D. Un document peut avoir plusieurs vues ouvertes, ce qui vous permet de l'inspecter depuis plusieurs points de vue en même temps. Vous pourriez vouloir afficher à la fois une vue de dessus et une vue de face de votre projet. Deux vues du même document seront alors enregistrées dans le document Affichage. La création de nouvelles vues, ou la fermeture des vues peut être faite depuis le menu Vue, ou par un clic droit de la souris sur l'onglet d'une vue.

Script

Les documents peuvent être créés, accédés et modifiés facilement depuis l'interpréteur Python. Par exemple :

FreeCAD.ActiveDocument

Retournera le document courant (actif)

FreeCAD.ActiveDocument.Blob

Accède à un objet nommé « Blob » à l'intérieur de votre document

FreeCADGui.ActiveDocument

Retournera la vue document associée au document courant

FreeCADGui.ActiveDocument.Blob

Accède à la représentation graphique (vue) de l'objet « Blob »

FreeCADGui.ActiveDocument.ActiveView

Retourne à la vue courante