Draft API/fr: Difference between revisions
(création et traduction de la page) |
(Updating to match new version of source page) |
||
(14 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
=Draft_API/fr= |
|||
{{VeryImportantMessage| |
{{VeryImportantMessage|(November 2018) Ces informations peuventt être incomplètes et obsolètes. Pour la dernière API, voir la page [https://www.freecadweb.org/api autogenerated API documentation].}} |
||
(Une fois la page traduite, vous pouvez supprimer le bandeau)<br><br>}} |
|||
Ces fonctions font partie |
Ces fonctions font partie de l'établi [[Draft Workbench/fr|Draft]], et, une fois que le module a été importé, elles peuvent être utilisées, dans les scripts, les [[macros/fr|macros]], ou dans l'interpréteur [[Python/fr|Python]]. |
||
Exemple: |
Exemple: |
||
{{Code|code= |
|||
import FreeCAD, Draft |
|||
from Draft import * |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
}} |
|||
{{APIFunction|cut|FreeCAD.Object, FreeCAD.Object|Renvoie un objet construit à partir de la différence de la coupe des 2 objets sélectionnés. Les objets originaux obtenu sont cachés.|Un nouvel objet est créé}} |
{{APIFunction|cut|FreeCAD.Object, FreeCAD.Object|Renvoie un objet construit, à partir de la différence de la coupe des 2 objets sélectionnés. Les objets originaux obtenu sont cachés.|Un nouvel objet est créé}} |
||
{{APIFunction|extrude|FreeCAD.Object, Vector|Extrude l'objet sélectionné dans la direction donnée par le vecteur. L'objet d'origine est caché.|Un nouvel objet est créé}} |
{{APIFunction|extrude|FreeCAD.Object, Vector|Extrude l'objet sélectionné dans la direction donnée par le vecteur. L'objet d'origine est caché.|Un nouvel objet est créé}} |
||
{{APIFunction|formatObject|FreeCAD.Object, [FreeCAD.Object]|Cette fonction s'applique à l'objet cible, compte tenu des propriétés actuelles fixées sur la barre d'outils Draft (couleur et largeur de la ligne), ou, le cas échéant copie les propriétés d'un deuxième objet. Il met également l'objet dans le groupe de construction si le bouton de construction est pressé.|Aucun}} |
{{APIFunction|formatObject|FreeCAD.Object, [FreeCAD.Object]|Cette fonction s'applique à l'objet cible, compte tenu des propriétés actuelles, fixées sur la barre d'outils Draft (couleur et largeur de la ligne), ou, le cas échéant copie les propriétés d'un deuxième objet. Il met également l'objet dans le groupe de construction si le bouton de construction est pressé.|Aucun}} |
||
{{APIFunction|fuse|FreeCAD.Object, FreeCAD.Object|Retourne un objet fabriqué à partir de la fusion des 2 objets sélectionnés. Si les objets sont coplanaires, un '''Draft Wire''' spécial est utilisé, sinon l'objet final est une fusion standard (standard Part fuse).|Un nouvel objet est créé}} |
{{APIFunction|fuse|FreeCAD.Object, FreeCAD.Object|Retourne un objet fabriqué à partir de la fusion des 2 objets sélectionnés. Si les objets sont coplanaires, un '''Draft Wire''' spécial est utilisé, sinon l'objet final est une fusion standard (standard Part fuse).|Un nouvel objet est créé}} |
||
{{APIFunction|getDraftPath|[string]|Retourne le chemin d'accès utilisateur ou système, à partir duquel, le Draft module est exécuté. Si un sous-dossier ou un nom de fichier est fourni, le chemin complet vers le sous-dossier de l'intérieur du Draft module est renvoyé.|Le chemin du fichier}} |
{{APIFunction|getDraftPath|[string]|Retourne le chemin d'accès utilisateur, ou système, à partir duquel, le Draft module est exécuté. Si un sous-dossier ou un nom de fichier est fourni, le chemin complet vers le sous-dossier de l'intérieur du Draft module est renvoyé.|Le chemin du fichier}} |
||
{{APIFunction|getGroupContents|list|Scanne récursivement la liste de données pour les groupes. Si les groupes sont trouvés, leur contenu est ajouté à la liste.|Une liste d'Objets FreeCAD}} |
{{APIFunction|getGroupContents|list|Scanne récursivement la liste de données pour les groupes. Si les groupes sont trouvés, leur contenu est ajouté à la liste.|Une liste d'Objets FreeCAD}} |
||
{{APIFunction|getRealName|string| |
{{APIFunction|getRealName|string|Sépare le numéro du nom de l'objet.|Le nom dépouillé de l'objet}} |
||
{{APIFunction|getSelection| |Retourne la sélection actuelle FreeCAD.|Retourne la sélection actuelle FreeCAD.}} |
{{APIFunction|getSelection| |Retourne la sélection actuelle FreeCAD.|Retourne la sélection actuelle FreeCAD.}} |
||
{{APIFunction|makeCircle|radius, [placement], [facemode], [startangle], [endangle]|Crée un objet cercle de rayon donné. Si une coordonnée est fournie, elle est utilisée. Si '''facemode est False''', le cercle est représenté comme un fil de fer, sinon comme une face. Si '''startAngle''' et '''endAngle''' (en degrés) sont donnés, ils sont utilisés et l'objet apparaîtra comme un arc.|Un nouvel objet est créé.}} |
{{APIFunction|makeCircle|radius, [placement], [facemode], [startangle], [endangle]|Crée un objet cercle de rayon donné. Si une coordonnée est fournie, elle est utilisée. Si '''facemode est False''', le cercle est représenté comme un fil de fer (filaire), sinon, comme une face. Si '''startAngle''' et '''endAngle''' (en degrés) sont donnés, ils sont utilisés et l'objet apparaîtra comme un arc.|Un nouvel objet est créé.}} |
||
{{APIFunction|makeDimension|Vector, Vector, [Vector] or FreeCAD.Object, int, int, [Vector]| |
{{APIFunction|makeDimension|Vector, Vector, [Vector] or FreeCAD.Object, int, int, [Vector]|Crée un objet '''Cotation''', mesure la distance entre le premier et le deuxième vecteur, avec la dimension de la ligne passant par le troisième vecteur, s'il est fourni. La largeur de ligne et la couleur affichée sur de la barre d'outils du projet seront utilisés. Au lieu de 2 vecteurs, vous pouvez également créer un objet FreeCAD de deux entiers (et éventuellement un vecteur) où la ligne de cotation doit passer. Dans ce cas, la dimension sera '''associée''' à l'objet, et la mesure des deux sommets, indiquée par les deux chiffres à l'indice donné.|Un nouvel objet est créé.}} |
||
{{APIFunction|makeLine|Vector, Vector|Crée une ligne entre les deux vecteurs |
{{APIFunction|makeLine|Vector, Vector|Crée une ligne entre les deux vecteurs donnés. La largeur de ligne, et, la couleur courante sélectionnés dans la barre d'outils Draft seront utilisés.|Un nouvel objet est créé.}} |
||
{{APIFunction|makeRectangle|length, width, [placement], [facemode]|Crée un objet Rectangle avec une longueur dans la direction X et la hauteur dans la direction Y. Si une position est donnée, elle est utilisée. Si '''facemode est False''', le rectangle est représenté comme un fil de fer, sinon comme une face. La largeur de ligne et la couleur courante sélectionnés dans la barre d'outils Draft seront utilisés.|Un nouvel objet est créé.}} |
{{APIFunction|makeRectangle|length, width, [placement], [facemode]|Crée un objet Rectangle avec une longueur dans la direction X et la hauteur dans la direction Y. Si une position est donnée, elle est utilisée. Si '''facemode est False''', le rectangle est représenté comme un fil de fer (filaire), sinon, comme une face. La largeur de ligne et la couleur courante sélectionnés dans la barre d'outils Draft seront utilisés.|Un nouvel objet est créé.}} |
||
{{APIFunction|makeText|string or list, [Vector], [screenmode] |
{{APIFunction|makeText|string or list, [Vector], [screenmode]|Crée un '''objet Texte''', au point donné, contenant la chaîne ou les chaînes figurant dans la liste, une chaîne par ligne. La couleur actuelle de la barre d'outils Projet la hauteur du texte et la police spécifiée dans les préférences sont utilisés. Si '''screenmode est sur True''', le texte fait toujours face à la direction de la vue, sinon il se trouve sur le plan '''X, Y'''.|Un nouvel objet est créé.}} |
||
{{APIFunction|makeWire|list or Part.Wire, [closed], [placement], [facemode]| |
{{APIFunction|makeWire|list or Part.Wire, [closed], [placement], [facemode]|Crée un objet (wire) dans la liste de données des vecteurs ou du fil donné. Si c'est un objet fermé (True), ou, si le premier et le dernier point sont identique, le fil est fermé. Si '''facemode est (True)''' (le fil est fermé), le fil, apparaîtra rempli. La largeur de ligne et la couleur courante sélectionnés dans la barre d'outils seront utilisés.|Un nouvel objet est créé.}} |
||
{{APIFunction|move|FreeCAD.Object or list, Vector, [copymode] |
{{APIFunction|move|FreeCAD.Object or list, Vector, [copymode]|Déplace l'objet ou les objets sélectionnés contenus dans la liste donnée ,dans la direction et la distance indiquée par le vecteur. Si '''CopyMode''' est sur True les objets réels ne sont pas déplacés, mais copiés à sa (leur) place.|L'objet ou les objets (ou leurs copies, si '''CopyMode''' était sur True).}} |
||
{{APIFunction|precision| |Retourne la valeur de précision définie dans les paramètres utilisateur.|Un integer.}} |
{{APIFunction|precision| |Retourne la valeur de précision définie dans les paramètres utilisateur.|Un integer.}} |
||
Line 47: | Line 47: | ||
{{APIFunction|rotate|FreeCAD.Object or list, angle, [center], [axis] ,[copymode]|Tourne l'objet donné ou les objets sélectionnés à l'angle donné et autour du centre donnée s'ils sont fourni, en utilisant l'axe comme un axe de rotation. Si l'axe est omis, la rotation se fera autour de l'axe vertical '''Z'''. Si '''CopyMode''' est sur True, les objets réels ne sont pas déplacés, mais les copies sont créées à leur place.|Les objets (ou leurs copies).}} |
{{APIFunction|rotate|FreeCAD.Object or list, angle, [center], [axis] ,[copymode]|Tourne l'objet donné ou les objets sélectionnés à l'angle donné et autour du centre donnée s'ils sont fourni, en utilisant l'axe comme un axe de rotation. Si l'axe est omis, la rotation se fera autour de l'axe vertical '''Z'''. Si '''CopyMode''' est sur True, les objets réels ne sont pas déplacés, mais les copies sont créées à leur place.|Les objets (ou leurs copies).}} |
||
{{APIFunction|scale|FreeCAD.Object or list, vector, [center], [copymode]|Redimensionne l'objet donné ou les objets sélectionnés au facteur d'échelle définis par le vecteur de donnés '''(X, Y et Z)''' autour du centre |
{{APIFunction|scale|FreeCAD.Object or list, vector, [center], [copymode]|Redimensionne l'objet donné ou les objets sélectionnés au facteur d'échelle définis par le vecteur de donnés '''(X, Y et Z)''' autour du centre donné s'il est fourni. Si '''CopyMode''' est sur True les objets réels ne sont pas déplacés, mais les copies sont créées à la place.|Les objets (ou leurs copies).}} |
||
{{APIFunction|select|FreeCAD.Object| |
{{APIFunction|select|FreeCAD.Object| Désélectionne tout, et, sélectionne uniquement l'objet survolé|Aucune.}} |
||
{{APIFunction|shapify|FreeCAD.Object|Transforme un objet de forme '''paramétrique''' en objet '''non-paramétrique'''.|Un nouvel objet est créé.}} |
{{APIFunction|shapify|FreeCAD.Object|Transforme un objet de forme '''paramétrique''' en objet '''non-paramétrique'''.|Un nouvel objet est créé.}} |
||
{{APIFunction|draftify|FreeCAD.Object or list|Met l'objet ou chaque objet sélectionné(s) en fils paramétriques Projet.| |
{{APIFunction|draftify|FreeCAD.Object or list|Met l'objet, ou, chaque objet sélectionné(s) en fils paramétriques Projet.|Aucune.}} |
||
{{APIFunction|getSVG|FreeCAD.Object, [linemodifier], [textmodifier], [(u,v)]|Crée une représentation SVG de l'objet donné. L'attribut '''linemodifier''' est le facteur d'échelle (en pourcent) pour la largeur de la ligne, et '''textmodifier''' pour la taille du texte. Vous pouvez également éventuellement fournir un tuple de vecteurs pour définir un plan de projection, sinon la forme géométrique sera projetée sur le plan '''X, Y'''.|Une chaîne contenant la représentation SVG de l'objet sélectionné.}} |
{{APIFunction|getSVG|FreeCAD.Object, [linemodifier], [textmodifier], [(u,v)]|Crée une représentation SVG de l'objet donné. L'attribut '''linemodifier''' est le facteur d'échelle (en pourcent) pour la largeur de la ligne, et '''textmodifier''' pour la taille du texte. Vous pouvez également éventuellement fournir un tuple de vecteurs pour définir un plan de projection, sinon la forme géométrique sera projetée sur le plan '''X, Y'''.|Une chaîne contenant la représentation SVG de l'objet sélectionné.}} |
||
{{Draft Tools navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
|||
⚫ | |||
⚫ | |||
{{clear}} |
|||
⚫ | |||
{{languages/fr | {{en|Draft API}} {{es|Draft API/es}} {{ru|Draft API/ru}} {{se|Draft API/se}} }} |
|||
⚫ |
Revision as of 22:25, 20 February 2020
Ces fonctions font partie de l'établi Draft, et, une fois que le module a été importé, elles peuvent être utilisées, dans les scripts, les macros, ou dans l'interpréteur Python.
Exemple:
import FreeCAD, Draft
myrect = Draft.makeRectangle(4, 3)
mydistance = FreeCAD.Vector(2, 2, 0)
Draft.move(myrect, mydistance)
Description: Renvoie un objet construit, à partir de la différence de la coupe des 2 objets sélectionnés. Les objets originaux obtenu sont cachés.
Returns: Un nouvel objet est créé
Description: Extrude l'objet sélectionné dans la direction donnée par le vecteur. L'objet d'origine est caché.
Returns: Un nouvel objet est créé
Description: Cette fonction s'applique à l'objet cible, compte tenu des propriétés actuelles, fixées sur la barre d'outils Draft (couleur et largeur de la ligne), ou, le cas échéant copie les propriétés d'un deuxième objet. Il met également l'objet dans le groupe de construction si le bouton de construction est pressé.
Returns: Aucun
Description: Retourne un objet fabriqué à partir de la fusion des 2 objets sélectionnés. Si les objets sont coplanaires, un Draft Wire spécial est utilisé, sinon l'objet final est une fusion standard (standard Part fuse).
Returns: Un nouvel objet est créé
Description: Retourne le chemin d'accès utilisateur, ou système, à partir duquel, le Draft module est exécuté. Si un sous-dossier ou un nom de fichier est fourni, le chemin complet vers le sous-dossier de l'intérieur du Draft module est renvoyé.
Returns: Le chemin du fichier
Description: Scanne récursivement la liste de données pour les groupes. Si les groupes sont trouvés, leur contenu est ajouté à la liste.
Returns: Une liste d'Objets FreeCAD
Description: Sépare le numéro du nom de l'objet.
Returns: Le nom dépouillé de l'objet
Description: Retourne la sélection actuelle FreeCAD.
Returns: Retourne la sélection actuelle FreeCAD.
Description: Crée un objet cercle de rayon donné. Si une coordonnée est fournie, elle est utilisée. Si facemode est False, le cercle est représenté comme un fil de fer (filaire), sinon, comme une face. Si startAngle et endAngle (en degrés) sont donnés, ils sont utilisés et l'objet apparaîtra comme un arc.
Returns: Un nouvel objet est créé.
Description: Crée un objet Cotation, mesure la distance entre le premier et le deuxième vecteur, avec la dimension de la ligne passant par le troisième vecteur, s'il est fourni. La largeur de ligne et la couleur affichée sur de la barre d'outils du projet seront utilisés. Au lieu de 2 vecteurs, vous pouvez également créer un objet FreeCAD de deux entiers (et éventuellement un vecteur) où la ligne de cotation doit passer. Dans ce cas, la dimension sera associée à l'objet, et la mesure des deux sommets, indiquée par les deux chiffres à l'indice donné.
Returns: Un nouvel objet est créé.
Description: Crée une ligne entre les deux vecteurs donnés. La largeur de ligne, et, la couleur courante sélectionnés dans la barre d'outils Draft seront utilisés.
Returns: Un nouvel objet est créé.
Description: Crée un objet Rectangle avec une longueur dans la direction X et la hauteur dans la direction Y. Si une position est donnée, elle est utilisée. Si facemode est False, le rectangle est représenté comme un fil de fer (filaire), sinon, comme une face. La largeur de ligne et la couleur courante sélectionnés dans la barre d'outils Draft seront utilisés.
Returns: Un nouvel objet est créé.
Description: Crée un objet Texte, au point donné, contenant la chaîne ou les chaînes figurant dans la liste, une chaîne par ligne. La couleur actuelle de la barre d'outils Projet la hauteur du texte et la police spécifiée dans les préférences sont utilisés. Si screenmode est sur True, le texte fait toujours face à la direction de la vue, sinon il se trouve sur le plan X, Y.
Returns: Un nouvel objet est créé.
Description: Crée un objet (wire) dans la liste de données des vecteurs ou du fil donné. Si c'est un objet fermé (True), ou, si le premier et le dernier point sont identique, le fil est fermé. Si facemode est (True) (le fil est fermé), le fil, apparaîtra rempli. La largeur de ligne et la couleur courante sélectionnés dans la barre d'outils seront utilisés.
Returns: Un nouvel objet est créé.
Description: Déplace l'objet ou les objets sélectionnés contenus dans la liste donnée ,dans la direction et la distance indiquée par le vecteur. Si CopyMode est sur True les objets réels ne sont pas déplacés, mais copiés à sa (leur) place.
Returns: L'objet ou les objets (ou leurs copies, si CopyMode était sur True).
Description: Retourne la valeur de précision définie dans les paramètres utilisateur.
Returns: Un integer.
Description: Tourne l'objet donné ou les objets sélectionnés à l'angle donné et autour du centre donnée s'ils sont fourni, en utilisant l'axe comme un axe de rotation. Si l'axe est omis, la rotation se fera autour de l'axe vertical Z. Si CopyMode est sur True, les objets réels ne sont pas déplacés, mais les copies sont créées à leur place.
Returns: Les objets (ou leurs copies).
Description: Redimensionne l'objet donné ou les objets sélectionnés au facteur d'échelle définis par le vecteur de donnés (X, Y et Z) autour du centre donné s'il est fourni. Si CopyMode est sur True les objets réels ne sont pas déplacés, mais les copies sont créées à la place.
Returns: Les objets (ou leurs copies).
Description: Désélectionne tout, et, sélectionne uniquement l'objet survolé
Returns: Aucune.
Description: Transforme un objet de forme paramétrique en objet non-paramétrique.
Returns: Un nouvel objet est créé.
Description: Met l'objet, ou, chaque objet sélectionné(s) en fils paramétriques Projet.
Returns: Aucune.
Description: Crée une représentation SVG de l'objet donné. L'attribut linemodifier est le facteur d'échelle (en pourcent) pour la largeur de la ligne, et textmodifier pour la taille du texte. Vous pouvez également éventuellement fournir un tuple de vecteurs pour définir un plan de projection, sinon la forme géométrique sera projetée sur le plan X, Y.
Returns: Une chaîne contenant la représentation SVG de l'objet sélectionné.
- Drafting : Ligne, Polyligne, Congé, Arc, Arc par 3 points, Cercle, Ellipse, Rectangle, Polygone, B-spline, Courbe de Bézier cubique, Courbe de Bézier, Point, Surfaces liées, Formes à partir de texte, Hachure
- Annotation : Texte, Dimension, Étiquette, Éditeur de styles d'annotations, Widget d'échelle d'annotation.
- Modification : Déplacer,Pivoter,Échelle,Miroir, Décalage, Ajuster ou prolonger, Étirer, Cloner, Réseau orthogonal, Réseau polaire, Réseau circulaire, Réseau selon une courbe, Réseau lié selon une courbe, Réseau de points, Réseau lié selon des points, Éditer, Surligner les sous éléments, Joindre, Scinder, Agréger, Désagréger, Polyligne vers B-spline, Draft vers esquisse, Pente, Inverser le texte de la dimension, Vue 2D d'une forme
- Barre Draft : Plan de travail, Définir le style, Basculer en mode construction, Groupement automatique
- Aimantation : Verrouillage de l'aimantation, Aimantation terminaison, Aimantation milieu, Aimantation centre, Aimantation angle, Aimantation intersection, Aimantation perpendiculaire, Aimantation extension, Aimantation parallèle, Aimantation spéciale, Aimantation au plus proche, Aimantation orthogonal, Aimantation grille, Aimantation plan de travail, Aimantation dimensions, Basculer la grille
- Utilitaires : Appliquer le style, Calque, Gestionnaire de calques, Nommer un groupe, Déplacer vers un groupe, Sélection groupée, Ajouter au groupe de construction, Mode d'affichage, Proxy de plan de travail, Réparer, Barre d'aimantation
- Additionnels : Contrainte, Motif, Préférences, Préférences d'Import Export, DXF/DWG, SVG, OCA, DAT
- Menu contextuel :
- Conteneur du calque : Fusionner les calques en double, Ajouter un nouveau calque
- Calque : Groupement automatique, Sélection groupée
- Texte : Ouvir les hyperliens
- Filaire : Aplatir
- Proxy de plan de travail : Enregistrer la position de la caméra, Enregistrer l'état des objets
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test, Web