Topological data scripting/fr

Introduction
Ici nous allons vous expliquer comment contrôler la boîte à outils (Part Module) ou de n'importe quel script externe, directement à partir de l'interpréteur Python inclus dans FreeCAD,.

Assurez-vous de parcourir l'article de familiarisation et scripts de base si vous avez besoin de plus amples renseignements sur la façon dont les scripts Python fonctionnent dans FreeCAD.

Here we will explain to you how to control the Part Module directly from the FreeCAD Python interpreter, or from any external script. The basics about Topological data scripting are described in Part Module Explaining the concepts. Be sure to browse the Scripting section and the FreeCAD_Scripting_Basics pages if you need more information about how Python scripting works in FreeCAD. If you are new to Python, it is a good idea to first read the Introduction to Python.

Class Diagram
Ceci est un Unified Modeling Language (UML) de la classe la plus importante de Part Module:

This is a Unified Modeling Language (UML) overview of the most important classes of the Part module:

top

Figures géométriques
Les objets géométriques sont la base de tous les objets topologiques :


 * Geom La classe de base des objets géométriques
 * Line Une ligne droite en 3D, défini par un point de départ et point d'arrivée
 * Circle Circle or circle segment défini par un point central, un point de départ et un point d'arrivée
 * ...... Et bien plus encore très rapidement

The geometric objects are the building blocks of all topological objects:
 * Geom Base class of the geometric objects.
 * Line A straight line in 3D, defined by starting point and end point.
 * Circle Circle or circle segment defined by a center point and start and end point.
 * ...... Etc.

top

Topology
Sont aussi disponibles des données de type topologique:


 * Compound Groupe de types différents d'objets topologiques.
 * Compsolid Un groupe de solides reliés par leurs faces. C'est un concept des notions de WIRE (filaire,bord..) et SHELL (coquille,enveloppe) des solides.
 * Solid Une portion de l'espace limité par son enveloppe. Il est en 3 dimensions.
 * Shell Un groupe de faces reliés par leurs bords.Un "SHELL" peut être ouvert ou fermé.
 * Face En 2D, c'est une surface plane; en 3D, c'est une seule face du volume. Sa géométrie est coupée par des contours. Il est en deux dimensions.
 * Wire Un ensemble relié par ses VERTEX (sommets). Il peut être de contour ouvert ou fermé suivant si les sommets sont reliés ou non.
 * Edge Elément topologique correspondant à une courbe retenue. Un "Edge" est généralement limité par des sommets. Il a une dimension.
 * Vertex Elément topologiques correspondant à un point. Il n'a pas de dimension.
 * Shape Est le terme générique pour traduire tout ce qui précède.

The following topological data types are available:
 * Compound A group of any type of topological objects.
 * Compsolid A composite solid is a set of solids connected by their faces. It expands the notions of WIRE and SHELL to solids.
 * Solid A part of space limited by shells. It is three dimensional.
 * Shell A set of faces connected by their edges. A shell can be open or closed.
 * Face In 2D it is part of a plane; in 3D it is part of a surface. Its geometry is constrained (trimmed) by contours. It is two dimensional.
 * Wire A set of edges connected by their vertices. It can be an open or closed contour depending on whether the edges are linked or not.
 * Edge A topological element corresponding to a restrained curve. An edge is generally limited by vertices. It has one dimension.
 * Vertex A topological element corresponding to a point. It has zero dimension.
 * Shape A generic term covering all of the above.

top

Exemple rapide : Création topologique simple


Nous allons créer une topologie avec une géométrie toute simple.

Nous devrons veiller à ce que les sommets des pièces géométriques soient à la même position, quatre sommets, deux cercles et deux lignes.

top

Création de la géométrie
Nous devons d'abord créer les parties distinctes géométriques en filaire.

Nous devons veiller à ce que tous les sommets des pièces géométriques qui vont êtres raccordées soient à la même position.

Sinon, plus tard nous pourrions ne pas être en mesure de relier les pièces géométriques en une topologie!

First we create the distinct geometric parts of this wire. Making sure that parts that have to be connected later share the same vertices.

Donc, nous créons d'abord les points:

top

Arc


Pour créer un arc de cercle, nous créons un point de repère puis nous créons l'arc de cercle passant par trois points:

top

Ligne


La ligne segment peut être créée très simplement en dehors des points :

top

Tout relier
La dernière étape consiste à relier les éléments géométriquement ensemble, et façonner une forme topologique:

The last step is to put the geometric base elements together and bake a topological shape:

top

Construire un prisme
Maintenant nous allons extruder notre forme filaire dans une direction, et créer une forme en 3 Dimensions:

Now extrude the wire in a direction and make an actual 3D shape:

top

Affichons le tout
top

Création de formes simples
Vous pouvez créer facilement des formes topologiques avec "make..." qui est une méthode du "Module Part":

You can easily create basic topological objects with the methods from the Part Module:

La combinaison de make... avec d'autres methodes sont disponibles:


 * makeBox(l,w,h): Construit un cube et pointe sur p dans la direction d et de dimensions (longueur,largeur,hauteur).
 * makeCircle(radius): Construit un cercle de rayon (r).
 * makeCone(radius1,radius2,height): Construit un cône de (rayon1,rayon2,hauteur).
 * makeCylinder(radius,height): Construit un cylindre de (rayon,hauteur).
 * makeLine((x1,y1,z1),(x2,y2,z2)): Construit une ligne aux coordonnées (x1,y1,z1),(x2,y2,z2) dans l'espace 3D.
 * makePlane(length,width): Construit un rectangle de (longueur,largeur).
 * makePolygon(list): Construit un polygone (liste de points).
 * makeSphere(radius): Construit une sphère de (rayon).
 * makeTorus(radius1,radius2): Construit un tore de (rayon1,rayon2).

La liste complète des API du module est sur la page Part API.

top

Importer les modules nécessaires
Nous avons d'abord besoin d'importer le module Part afin que nous puissions utiliser son contenu Python.

Nous allons également importer le module Base à l'intérieur du module de FreeCAD:

First we need to import the Part module so we can use its contents in Python. We'll also import the Base module from inside the FreeCAD module:

top

Création d'un Vecteur
Les Vecteurs sont l'une des informations les plus importantes lors de la construction des formes géométriques.

Ils contiennent habituellement 3 nombres (mais pas toujours) les coordonnées cartésiennes x, y et z.

Vous pouvez créez un vecteur comme ceci:

Vectors are one of the most important pieces of information when building shapes. They usually contain three numbers (but not necessarily always): the X, Y and Z cartesian coordinates. You create a vector like this:

Nous venons de créer un vecteur de coordonnées x = 3, y = 2, z = 0.

Dans le module Part, les vecteurs sont utilisés partout.

Le module Part utilise aussi une autre façon de représenter un point, appelé Vertex, qui est simplement un conteneur pour un vecteur.

Vous pouvez accéder aux vecteurs d'un sommet comme ceci:

top

Création d'une arête (edge)
Une arête (bord) n'est rien d'autre qu'une ligne avec deux Vertex (sommets):

An edge is nothing but a line with two vertices:

PS: Vous pouvez aussi créer un arête en donnant deux Vecteurs:

Vous pouvez trouver la longueur et le centre d'une arête comme ceci:

top

Mise en forme à l'écran
Jusqu'à présent, nous avons créé un objet a arêtes vives (bords), mais il n'est pas visible à l'écran.

C'est parce que nous n'avons manipulé que des objets en Python.

L'écran FreeCAD n'affiche uniquement que les vues 3D que vous lui demandez d'afficher.

Pour cela, nous utilisons une méthode simple:

So far we created an edge object, but it doesn't appear anywhere on the screen. This is because the FreeCAD 3D scene only displays what you tell it to display. To do that, we use this simple method:

La fonction show crée un objet dans notre document FreeCAD et assigne notre forme "edge" à cela.

Utilisez cette commande chaque fois que vous voudrez afficher votre forme géométrique à l'écran.

top

Création d'un contour (Wire)
Un contour est une ligne multi-arêtes, et peut être créé dans une liste d'arêtes ou même une liste de lignes (fils):

A wire is a multi-edge line and can be created from a list of edges or even a list of wires:

Part.show (wire3) permet d'afficher les 4 bords qui composent notre contour filaire.

D'autres informations utiles, peuvent être facilement récupérées:

top

Création d'une face
Seul les faces à contour fermés seront valides.

Dans cet exemple, wire3 est un contour fermé, et Wire2 est un contour ouvert (voir ci-dessus)

Only faces created from closed wires will be valid. In this example, wire3 is a closed wire but wire2 is not (see above)

Seul les faces auront une superficie, mais les lignes et les bords (arêtes) n'en possède pas.

top

Création d'un cercle
Un cercle est créé simplement comme ceci:

A circle can be created like this:

Si vous voulez le créer à une certaine position et avec une certaine direction:

ccircle sera créé à une distance de 10 de l’origine x et sera face à l'extérieur le long de l'axe des x. Remarque: makeCircle accepte uniquement Base.Vector pour la position et les paramètres normaux, pas les tuples. Vous pouvez également créer une partie du cercle en donnant un angle de début et de fin:

Si nous joignions les deux arcs arc1 et arc2 nous obtiendrons un cercle.

L'angle fourni doit être exprimé en degrés, s'il sont en radians, vous devez les convertir en degrès avec la formule: degrés = radians * 180/PI ou en utilisant le module mathématiques Python (après avoir fait import math, bien sûr):

top

Création d'un arc sur des points (repères)
Malheureusement, il n'existe pas de fonction makeArc mais nous avons la fonction Part.Arc pour créer un arc sur trois points de référence.

Fondamentalement, nous pouvons supposer un arc attaché sur un point de départ, passant sur un point central et se termine sur un point final en.

Part.Arc crée un objet arc pour lequel .ToShape doit être appelée pour obtenir un objet ligne (edge), de cette manière nous utiliserons Part.LineSegment au lieu de Part.makeLine.

Unfortunately there is no function, but we have the  function to create an arc through three points. It creates an arc object joining the start point to the end point through the middle point. The arc object's function must be called to get an edge object, the same as when using instead of.

Arc travaille uniquement avec Base.Vector pour les points mais pas pour les tuples.

arc_edge est ce qui sera affiché à l'aide Part.show (arc_edge).

Vous pouvez également obtenir un arc de cercle en utilisant une partie de cercle:

Les arcs Arc sont des lignes (edges). Ils peuvent donc être utilisés aussi comme contour en filaire.

top

Création de polygones
Un polygone est tout simplement une ligne (wire) avec de multiples lignes droites.

La fonction makePolygon crée une liste de points et crée une ligne de points en points:

A polygon is simply a wire with multiple straight edges. The function takes a list of points and creates a wire through those points:

top

Création de courbes de Bézier
Les courbes de Bézier sont utilisées pour modéliser des courbes lisses à l'aide d'une série de repères (points de contrôle) avec un nombre de repères représentants la précision (fluidité de la courbe) optionnel. La fonction ci-dessous fait un Part.BezierCurve avec une série de points FreeCAD.Vector. (Note : l'indice du premier repère et du nombre commencent à 1, et pas à 0.)

Bézier curves are used to model smooth curves using a series of poles (points) and optional weights. The function below makes a from a series of  points. Note: when "getting" and "setting" a single pole or weight, indices start at 1, not 0.

top

Création d'une forme plane
Une forme plane, est tout simplement une surface plane rectangulaire.

La méthode utilisée pour créer une forme plane est la suivante: makePlane(longueur, largeur, [point de départ, direction]).

Par défaut point de départ = Vecteur(0,0,0) et direction = Vecteur(0,0,1).

L'utilisation point de départ = Vecteur(0,0,1) va créer la forme sur l' axe z positif, tandis que direction = Vecteur(1,0,0) va créer la forme sur l'axe x positif:

(Pour s'y retrouver un peu sur les axes, Vecteur ( 0, 0 , 1 ) est égal à Vecteur ( X=0 , Y=0 , Z=1 ) l'ordre des axes sera toujours ( x , y , z ))

A Plane is a flat rectangular surface. The method used to create one is. By default start_pnt = Vector(0, 0, 0) and dir_normal = Vector(0, 0, 1). Using dir_normal = Vector(0, 0, 1) will create the plane facing in the positive Z axis direction, while dir_normal = Vector(1, 0, 0) will create the plane facing in the positive X axis direction:

BoundBox est un rectangle qui possède une diagonale commençant sur le plan (3,0,0) et se terminant à (5,0,2).

L'épaisseur de la boîte (Box) dans l'axe y est égal à zéro, car notre forme est totalement plane.

PS: makePlane accepte uniquement Base.Vector pour start_pnt et dir_normal mais pas les tuples.

top

Création d'une ellipse
Pour créer une ellipse, il existe plusieurs façons:

There are several ways to create an ellipse:

Créez une ellipse avec un grand rayon = 2 et un petit rayon = 1 et un centre = (0,0,0).

Créez une copie des données de l'ellipse

Crée une ellipse positionnée au point "Center", le plan de l'ellipse est défini par Center, S1 et S2,

le grand axe est définit par Center et S1,

son grand rayon est la distance entre Center et S1,

son petit rayon est la distance entre S2 et le grand axe.

Crée une ellipse avec un grand rayon MajorRadius et un petit rayon MinorRadius et situé dans le plan défini par (0,0,1)

Dans le code ci-dessus, nous avons passé S1 (Grand rayon), S2 (Petit rayon) et le centre (les coordonnées centrales).

De même que l'Arc, l'Ellipse crée également un objet Ellipse mais pas d'arête (bords), nous avons donc besoin de le convertir en arête à l'aide toShape pour l'afficher.

PS: Arc accepte uniquement Base.Vector pour les points mais pas les tuples.

pour construire l'Ellipse ci-dessus, nous avons entré les coordonnées centrales, le Grand rayon et le Petit rayon.

top

Création d'un Tore
Nous créons un Tore en utilisant la méthode makeTorus( rayon1, rayon2 , [ pnt , dir , angle1 , angle2 , angle ] ).

Par défaut,

Rayon1 = est le rayon du grande cercle

Rayon2 = est le rayon du petit cercle,

pnt = Vecteur(0,0,0),pnt est le centre de tore

dir = Vecteur(0,0,1), dir est la direction normale

angle1 = 0, est l'angle de début pour le petit cercle exprimé en radians

angle2 = 360 est l'angle de fin pour le petit cercle exprimé en radians

angle = 360 le dernier paramètre est la section du tore

Using. By default pnt = Vector(0, 0, 0), dir = Vector(0, 0, 1), angle1 = 0, angle2 = 360 and angle = 360. Consider a torus as small circle sweeping along a big circle. Radius1 is the radius of the big circle, radius2 is the radius of the small circle, pnt is the center of the torus and dir is the normal direction. angle1 and angle2 are angles in degrees for the small circle; the last angle parameter is to make a section of the torus:

Le code ci-dessus créera un tore avec un diamètre de 20 (rayon de 10) et une épaisseur de 4 (rayon du petite cercle 2)

Le code ci-dessus créera une portion du tore.

Le code ci-dessus créera un demi tore; seul le dernier paramètre change à savoir l'angle et les angles restants sont prédéfinis.

En donnant un angle de 180 degrés, créez un tore de 0 à 180 degrés, c'est à dire un demi tore.

top

Création d'un cube ou d'un parallélépipède
Utilisez makeBox(length,width,height,[pnt,dir]).

Par défaut pnt=Vector(0,0,0) and dir=Vector(0,0,1).

Using. By default pnt = Vector(0, 0, 0) and dir = Vector(0, 0, 1).

top

Création d'une Sphère
Nous utiliserons makeSphere ( rayon, [ pnt , dir , angle1 , angle2 , angle3 ] ).

rayon = rayon de la sphère par défaut,

pnt = Vecteur (0,0,0),

dir = Vecteur (0,0,1),

angle1 = -90, verticale minimale de la sphère

angle2 = 90, verticale maximale de la sphère

angle3 = 360, le diamètre de la sphère.

Using. By default pnt = Vector(0, 0, 0), dir = Vector(0, 0, 1), angle1 = -90, angle2 = 90 and angle3 = 360. angle1 and angle2 are the vertical minimum and maximum of the sphere, angle3 is the sphere diameter.

top

Création d'un Cylindre
Nous utiliserons makeCylinder(radius,height,[pnt,dir,angle]).

Par défaut,

pnt=Vector(0,0,0), dir=Vector(0,0,1) et angle=360.

Using. By default pnt = Vector(0, 0, 0), dir = Vector(0, 0, 1) and angle = 360.

top

Création d'un Cône
Nous utiliserons makeCone(radius1,radius2,height,[pnt,dir,angle]).

Par défaut,

pnt=Vector(0,0,0), dir=Vector(0,0,1) et angle=360.

Using. By default pnt = Vector(0, 0, 0), dir = Vector(0, 0, 1) and angle = 360.

top

Modification d'une forme
Il y a plusieurs manières de modifier des formes. Certaines sont de simples opérations de transformation telles que le déplacement ou la rotation de formes, d'autres sont plus complexes telles que fusion et soustraction d'une forme à une autre.

There are several ways to modify shapes. Some are simple transformation operations such as moving or rotating shapes, others are more complex, such as unioning and subtracting one shape from another.

top

Transformer une forme
La transformation est l'action de déplacer une forme d'un endroit à un autre.

Toute forme (arête, face, cube, etc ..) peut être transformé de la même manière:

Translating is the act of moving a shape from one place to another. Any shape (edge, face, cube, etc...) can be translated the same way:

Cette commande va déplacer notre forme "myShape" de 2 unités dans la direction x.

top

Rotation d'une forme
Pour faire pivoter une forme, vous devez spécifier le centre de rotation, l'axe, et l'angle de rotation:

To rotate a shape, you need to specify the rotation center, the axis, and the rotation angle:

Cette opération va faire pivoter notre forme de 180 degrés sur l'axe z.

top

Transformations génériques avec matrices
Une matrice est un moyen très simple de mémoriser les transformations dans le mode 3D. Dans une seule matrice, vous pouvez définir les valeurs de transformation, rotation et mise à l'échelle à appliquer à un objet.

Par exemple:

A matrix is a very convenient way to store transformations in the 3D world. In a single matrix, you can set translation, rotation and scaling values to be applied to an object. For example:

PS: les matrices de FreeCAD travaillent en radians. En outre presque toutes les opérations matricielles qui travaillent avec un vecteur peut aussi avoir 3 nombres de sorte que ces 2 lignes effectuent le même travail:

Lorsque notre matrice est paramétrée, nous pouvons l'appliquer à notre forme. FreeCAD fournit nous fournit 2 méthodes: transformShape et transformGeometry().

La différence est que, avec la première, vous ne verez pas de différence (voir "mise à l'échelle d'une forme" ci-dessous).

Donc, nous pouvons opérer notre transformation comme ceci:

ou

top

Echelle du dessin (forme)
Changer l'échelle d'une forme est une opération plus dangereuse, car, contrairement à la translation ou à la rotation, le changement d'échelle non uniforme (avec des valeurs différentes pour x, y et z) peut modifier la structure de la forme!

Par exemple, le redimensionnement d'un cercle avec une valeur plus élevée horizontalement que verticalement le transformera en une ellipse, qui mathématiquement très différent.

Pour modifier l'échelle, nous ne pouvons pas utiliser le transformShape, nous devons utiliser transformGeometry:

Scaling a shape is a more dangerous operation because, unlike translation or rotation, scaling non-uniformly (with different values for X, Y and Z) can modify the structure of the shape. For example, scaling a circle with a higher value horizontally than vertically will transform it into an ellipse, which behaves mathematically very differently. For scaling, we cannot use the, we must use :

top

Soustraction
Soustraire une forme d'une autre est appelé, dans le jargon OCC/FreeCAD "cut" (coupe) et,

se fait de cette manière:

Subtracting a shape from another one is called "cut" in FreeCAD and is done like this:

top

Intersection
De la même manière, l'intersection entre 2 formes est appelé "common" et se fait de cette manière:

The same way, the intersection between two shapes is called "common" and is done this way:

top

Fusion
La fusion "fuse", fonctionne de la même manière:

Union is called "fuse" and works the same way:

top

Section
Une section, est l'intersection entre une forme solide et une forme plane.

Elle retournera une courbe d'intersection et sera composée de bords (edges, arêtes).

A "section" is the intersection between a solid shape and a plane shape. It will return an intersection curve, a compound curve composed of edges.

top

Extrusion
L'extrusion est une action de "pousser" une forme plane dans une certaine direction et résultant en un corps solide.

Par exemple, pousser sur un cercle pour le transformer en tube:

Extrusion is the act of "pushing" a flat shape in a certain direction, resulting in a solid body. Think of a circle becoming a tube by "pushing it out":

Si votre cercle est vide, vous obtiendrez un tube vide.

Mais si votre cercle est un disque avec une face pleine, vous obtiendrez un cylindre solide:

top

Exploration de la forme (shape)
Vous pouvez facilement explorer la structure de ses données topologique:

You can easily explore the topological data structure:

En tapant ce code dans l'interpréteur Python, vous aurez une bonne compréhension de la structure de Part objets.

Ici, notre commande makebox créé une forme solide. Ce solide, comme tous les solides Part, contiennent des faces. Une face est constituée de lignes, qui sont un ensemble de bords, arêtes qui délimitent la face. Chaque face a au moins un contour fermé (il peut en avoir plus si la face comporte un ou plusieurs trou). Dans une ligne, nous pouvons voir chaque côté séparément, et nous pouvons voir les sommets (Vertex) de chaque bord ou arête. Lignes et arêtes n'ont que deux sommets, évidemment.

top

Analyse des arêtes (Edge)
Dans le cas d'un bord (ou arête), qui est une courbe arbitraire, il est fort probable que vous voulez faire une discrétisation. Dans FreeCAD, les bords sont paramétrés par leurs longueurs.

Cela signifie, que vous pouvez suivre une arête/courbe par sa longueur:

In case of an edge, which is an arbitrary curve, it's most likely you want to do a discretization. In FreeCAD the edges are parametrized by their lengths. That means you can walk an edge/curve by its length:

Maintenant, vous pouvez accéder à un grand nombre de propriétés de l'arête en utilisant sa longueur comme une position.

C'est à dire que, si l'arête(ou bord) a une longueur de 100 mm la position de départ est 0 et sa position extrème est 100.

top

Utilisation de la sélection
Ici, nous allons voir comment nous pouvons utiliser la fonction de sélection, quand l'utilisateur a fait une sélection dans la visionneuse.

Tout d'abord, nous créons une boîte (box) et nous l'affichons dans la fen^etre de vue.

Here we see now how we can use a selection the user did in the viewer. First of all we create a box and show it in the viewer.

Sélectionnez maintenant des faces ou arêtes.

Avec ce script, vous pouvez parcourir tous les objets sélectionnés et visionner leurs sous-éléments:

Sélectionnez quelques bords et ce script va calculer la longueur:

top

Exemple Complet: "The OCC bottle"
L'exemple OpenCasCade Technology Tutorial vous montre comment faire une bouteille.

C’est un bon exercice pour FreeCAD. Si vous suivez notre exemple ci-dessous et la page OCC simultanément, vous verre comment les structures OCC sont implémentées dans FreeCAD. Le script complet ci-dessous est également inclus dans l’installation de FreeCAD (dans le dossier Mod / Part) et peut être appelé à partir de l'interpréteur Python en tapant:

A typical example found on the OpenCasCade Technology website is how to build a bottle. This is a good exercise for FreeCAD too. In fact, if you follow our example below and the OCC page simultaneously, you will see how well OCC structures are implemented in FreeCAD. The script is included in the FreeCAD installation (inside the folder) and can be called from the Python interpreter by typing:

top

Le script complet
Ici, le script complet de MakeBottle.py (extension .py):

For the purpose of this tutorial we will consider a reduced version of the script. In this version the bottle will not be hollowed out, and the neck of the bottle will not be threaded.

top

Détail et déroulement MakeBottle.py
Nous aurons bien sûr besoin du module Part, mais aussi du module FreeCAD.Base, qui contient des structures FreeCAD de base comme des vecteurs et des matrices.

Ici, nous définissons notre fonction MakeBottle.

Cette fonction peut être appelée sans argument, comme nous l'avons fait ci-dessus, les valeurs par défaut, de largeur, hauteur et épaisseur seront utilisés.

Ensuite, nous définissons une paire de points qui seront utilisés pour la construction de notre profil de base.

C'est ici que nous définissons les formes géométriques: un arc composé de 3 points et deux segments de ligne de 2 points chacun.

Vous vous souvenez de la différence entre la géométrie et les formes? Nous allons construire les formes de notre forme géométrique. Trois bords (bords ou arêtes peuvent être des segments de droites ou des courbes) puis nous raccordons tous les sommets.

Jusqu'à présent, nous n'avons construit qu'un demi profil. Au lieu de construire le profil entier de la même manière, nous pouvons simplement reproduire ce que nous avons fait et coller les deux moitiés ensemble. Nous créons d'abord une matrice. Une matrice est un moyen très courant d'appliquer des transformations à des objets du monde 3D car elle peut contenir dans une structure toutes les transformations de base que peuvent subir les objets 3D (déplacement, rotation et mise à l'échelle). Après avoir créé la matrice, nous en faisons une symétrie puis nous créons une copie de notre fil avec cette matrice de transformation qui lui est appliquée. Nous avons maintenant deux fils et nous pouvons en faire un troisième, les fils étant en réalité des listes de bords.

Maintenant, nous avons un contour fermé, il peut être transformé en une face. Une fois que nous avons une face, nous pouvons l'extruder.

Une fois fait, nous avons un solide. Puis, nous appliquons un filet à notre objet car nous voulons lui donner un aspect "design", n'est-ce pas?

À ce stade, le corps de notre bouteille est fabriqué mais nous devons encore créer un goulot. On fait un nouveau solide avec un cylindre.

L'opération de fusion, qui dans d'autres applications est parfois appelé union, est très puissante.

Cette opération prendra soin de coller ce qui doit être collé et enlever ce qui doit être enlevé.

Puis, nous revenons à notre bouteille (Part solid), qui est le résultat de notre fonction.

Enfin, nous appelons la fonction pour créer la pièce puis la rendons visible.

top

Cube percé
Ici un exemple complet de construction d'un cube percé.

Here is a complete example of building a pierced box.

La construction se fait face par face et quand le cube est terminé, il est évidé d'un cylindre traversant.

top

Chargement et sauvegarde
Il ya plusieurs façons de sauver votre travail dans le Part Module. Vous pouvez bien sûr sauvegarder votre document au format FreeCAD, mais vous pouvez également enregistrer les objets directement dans un format courant de CAO, tels que BREP, IGS, STEP et STL.

There are several ways to save your work. You can of course save your FreeCAD document, but you can also save Part objects directly to common CAD formats, such as BREP, IGS, STEP and STL.

L'enregistrement d'une forme (un projet) dans un fichier est facile, il y a les fonctions exportBrep, exportIges, exportStl et exportStep qui sont des méthodes disponibles pour toutes les formes d'objets.

Donc, en faisant:

Ceci sauve votre box (cube) dans le format .STP. Pour charger un fichier BREP, IGES ou STEP:

Pour convertir un fichier .stp en .igs:

top