Draft PolarArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "* Appuyez sur {{Button|Reset point}} pour définir le centre de rotation sur l'origine {{Value|(0, 0, 0)}}. * Si la case {{MenuCommand|Fuse}} est cochée, les objets résultan...")
No edit summary
(48 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav
{{Docnav/fr
|[[Draft_Draft2Sketch/fr|Draft vers Esquisse]]
|[[Draft_Draft2Sketch/fr|Draft vers esquisse]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_LinkArray/fr|Réseau lié]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Module/fr|Atelier Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_Draft2Sketch.svg
Line 9: Line 9:
}}
}}


{{GuiCommand/rf
{{GuiCommand/fr
|Name=Draft PolarArray
|Name=Draft PolarArray
|Name/fr=Draft Réseau polaire
|Name/fr=Draft Réseau polaire
|MenuLocation=Modify → Polar array
|MenuLocation=Modification → Array tools → Polar array
|Workbenches=[[Draft Module/fr|Draft]]
|Workbenches=[[Draft Module/fr|Draft]]
|Version=0.19
|Version=0.19
|SeeAlso=[[Draft_Array/fr|Draft Réseau]], [[Draft_CircularArray/fr|Draft Réseau circulaire]], [[Draft_PathArray/fr|Draft Chemin pour série de copies]], [[Draft_PointArray/fr|Draft Matrice de points]], [[Draft_Clone/fr|Draft Clone]]
|SeeAlso=[[Draft_OrthoArray|Draft Réseau orthogonal]], [[Draft_CircularArray/fr|Draft Réseau circulaire]], [[Draft_PathArray/fr|Draft Chemin pour série de copies]], [[Draft_PathLinkArray|Draft Réseau lié selon une courbe]], [[Draft_PointArray/fr|Draft Matrice de points]], [[Draft_Clone/fr|Draft Clone]]
}}
}}


Line 22: Line 22:
L'outil {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Draft PolarArray]]}} crée un réseau à partir d'un objet sélectionné en plaçant les copies le long d'une circonférence.
L'outil {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Draft PolarArray]]}} crée un réseau à partir d'un objet sélectionné en plaçant les copies le long d'une circonférence.


Cet outil peut être utilisé sur des formes 2D créées avec l'[[Draft_Workbench/fr|atelier Draft]] mais également sur de nombreux types d'objets 3D tels que ceux créés avec l'[[Part_Workbench/fr|atelier Part]] ou l'[[PartDesign_Workbench/fr|atelier PartDesign]].
Cet outil peut être utilisé sur n'importe quel objet possédant une [[Part_TopoShape/fr|Part TopoShape]], c'est-à-dire des formes 2D créées avec l'[[Draft_Workbench/fr|atelier Draft]] mais également des solides 3D créés avec d'autres ateliers, par exemple, [[Part_Workbench/fr|Part]], [[PartDesign_Workbench/fr|PartDesign]] ou [[Arch_Workbench/fr|Arch]]. Il peut également créer des [[App_Link/fr|App Links]] au lieu de simples copies.


* Pour créer des tableaux orthogonaux ou circulaires, utilisez les outils {{Button|[[File:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray/fr|Draft Réseau orthogonal]]}} and {{Button|[[File:Draft_CircularArray.svg|16px]] [[Draft_CircularArray/fr|Draft Réseau circulaire]]}}.
Pour positionner les copies sur une grille rectangulaire, utilisez [[Draft_Array/fr|Draft Réseau]]; pour vous positionner dans un motif circulaire, utilisez [[Draft_CircularArray/fr|Draft réseau Circulaire]]; pour positionner des copies le long d'un chemin, utilisez [[Draft_PathArray/fr|Draft réseau sur un chemin]]; pour positionner les copies aux points spécifiés, utilisez [[Draft_PointArray/fr|Draft Matrice de points]]; pour créer des copies ou des clones et les placer manuellement, utilisez [[Draft_Move/fr|Draft Déplacer]], [[Draft_Rotate/fr|Draft Rotation]] et [[Draft_Clone/fr|Draft Clone]].
* Pour positionner des copies le long d'un chemin, utilisez {{Button|[[File:Draft_PathArray.svg|16px]] [[Draft_PathArray/fr|Draft Réseau selon une courbe]]}} ou {{Button|[[File:Draft_PathLinkArray.svg|16px]] [[Draft_PathLinkArray/fr|Draft Réseau lié selon une courbe]]}}.
* Pour positionner les copies aux points spécifiés, utilisez {{Button|[[File:Draft_PointArray.svg|16px]] [[Draft_PointArray/fr|Draft Matrice de points]]}} ou {{Button|[[File:Draft_PathLinkArray.svg|16px]] [[Draft_PathLinkArray/fr|Draft Réseau lié selon des points]]}}.
* Pour créer des copies et les placer manuellement, utilisez {{Button|[[File:Draft_Move.svg|16px]] [[Draft_Move/fr|Draft Déplacer]]}} or {{Button|[[File:Draft_Rotate.svg|16px]] [[Draft_Rotate/fr|Draft Rotation]]}}.
* Pour créer des copies exactes et les placer ou les mettre à l'échelle manuellement, utilisez {{Button|[[File:Draft_Clone.svg|16px]] [[Draft_Clone/fr|Draft Clone]]}} or {{Button|[[File:Std_LinkMake.svg|16px]] [[Std_LinkMake/fr|Std LinkMake]]}}.


[[Image:Draft_PolarArray_example.png|400px]]
[[Image:Draft_PolarArray_example.png|400px]]
Line 32: Line 36:
== Utilisation ==
== Utilisation ==


# Sélectionnez un objet à partir duquel vous souhaitez créer le réseau polaire.
# Sélectionnez l'objet à partir duquel vous souhaitez créer un réseau.
# Appuyez sur le bouton {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Polar array]]}}. Si aucun objet n'est sélectionné, le [[task_panel | task panel]] s'ouvre mais vous devez toujours sélectionner un objet pour continuer.
# Appuyez sur le bouton {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray|Draft Polar array]]}}. Si aucun objet n'est sélectionné, vous serez invité à en sélectionner un avant de continuer.
# Le [[Task_Panel/fr|Panneau des tâches]] est lancé où vous pouvez sélectionner la distance radiale, la distance tangentielle, le nombre de couches circulaires, le paramètre de symétrie et le centre de l'axe de rotation.
# Choisissez l'angle polaire qui détermine où sera le dernier élément du réseau.
# Vous pouvez cliquer sur la [[3D_view/fr|vue 3D]] pour définir simultanément la position du centre de rotation et terminer la commande. Sinon, appuyez simplement sur {{KEY|Entrée}} ou sur le bouton {{Button|OK}} pour terminer l'opération.
# Choisissez le nombre d'éléments dans le tableau. Minimum de 2, maximum de 99.

# Choisissez le centre de l'axe de rotation. Vous pouvez cliquer sur la [[3D_view/fr|vue 3D]] pour définir simultanément la position du centre de rotation et terminer la commande.
=== Remarques ===
# Facultativement, vérifiez les options de fusible ou de lien.
# Appuyez sur {{Button|OK}} pour terminer la commande.


Remarques:
* Par défaut, l'axe de rotation est l'axe Z positif {{Value|(0, 0, 1)}}. Ceci peut être modifié dans l'[[property_editor/fr|Éditeur de propriétés]] après la création de l'objet.
* Par défaut, l'axe de rotation est l'axe Z positif {{Value|(0, 0, 1)}}. Ceci peut être modifié dans l'[[property_editor/fr|Éditeur de propriétés]] après la création de l'objet.
* Chaque élément du tableau est un clone exact de l'objet d'origine, mais l'ensemble du réseau est considéré comme une seule unité en termes de propriétés et d'apparence.
* L'angle polaire est positif dans le sens anti-horaire et négatif dans le sens horaire.
* Cette commande crée le même objet "réseau" paramétrique que celui créé avec le {{Button|[[File:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray|Draft Réseau orthogonal]]}} et {{Button|[[File:Draft_CircularArray.svg|16px]] [[Draft_CircularArray|Draft Réseau circulaire]]}}. Par conséquent, le tableau peut être converti en orthogonal, polaire ou circulaire en modifiant sa propriété {{PropertyData/fr|Array Type}}.
* Chaque élément du tableau est un clone exact de l'objet d'origine, mais l'ensemble du tableau est considéré comme une seule unité en termes de propriétés et d'apparence.
* Cette commande crée le même objet que celui créé avec les outils [[Draft_Array/fr|Draft Réseau]] et [[Draft_CircularArray/fr|Draft Réseau polaire]]. Par conséquent, le réseau peut être converti en orthogonal, polaire ou circulaire en changeant simplement ses propriétés.


== Options ==
== Options ==


Ce sont les options affichées dans [[Task_Panel/fr|Panneau des tâches]]
* Appuyez sur {{Button|Reset point}} pour définir le centre de rotation sur l'origine {{Value|(0, 0, 0)}}.
* Si la case {{MenuCommand|Fuse}} est cochée, les objets résultants dans le tableau seront fusionnés en une seule forme, s'ils se touchent ou se croisent.
* Si la case {{MenuCommand|Use Links}} est cochée, les objets résultants dans le tableau seront référencées entre eux [[App_Link/fr|App Links]] au lieu de simples copies. Cela améliore l'utilisation de la mémoire du tableau, car le lien d'application réutilise la forme [[Shape/fr|shape]] de l'objet d'origine et ne crée pas de nouvelles formes. Si cette option est utilisée, la case à cocher {{MenuCommand|Fuse}} n'a aucun effet.
* Appuyez sur {{KEY|Esc}} ou sur le bouton {{Button|Cancel}} pour abandonner la commande en cours.


* {{MenuCommand|Polar angle}}: l'angle qui détermine où le dernier élément du réseau sera placé dans l'arrangement polaire. L'angle est positif dans le sens anti-horaire et négatif dans le sens horaire.
== Properties ==
* {{MenuCommand|Number of elements}}: le nombre d'éléments dans le tableau. Minimum de 2, maximum de 99.
* {{MenuCommand|Center of rotation}}: les coordonnées par lesquelles passe l'axe de rotation.
* {{MenuCommand|Reset point}}: il réinitialise le centre de rotation à l'origine {{Value|(0, 0, 0)}}.
* {{MenuCommand|Fuse}}: si elle est cochée, les objets résultants dans le tableau fusionneront s'ils se touchent. Cela ne fonctionne que si {{MenuCommand|Link array}} n'est pas coché.
* {{MenuCommand|Link array}}: s'il est coché, le tableau résultant sera un "Link array". Ce tableau utilise en interne des objets [[App_Link/fr|App Link]], il est donc plus efficace lors du traitement de nombreuses copies de formes complexes. Cependant, dans ce cas, les objets ne peuvent pas être fusionnés ensemble.
* Appuyez sur {{KEY|Echap}} ou sur le bouton {{Button|Annuler}} pour annuler la commande en cours.


{{Emphasis|Remarque:}} si un Link array est créé, cet objet ne peut pas être converti en réseau standard. De même, un réseau standard ne peut pas être converti en Link array. Par conséquent, vous devez choisir le type de réseau que vous souhaitez au moment de la création.
An [[Draft_PolarArray|Array]] object is based on [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class), and thus shares all properties of the latter. In addition to the properties listed in [[Part_Feature|Part Feature]], the Array object has additional properties.


== Propriétés ==
See the [[Draft_Array|Array]] tool for the complete information.


Un objet [[Draft_PolarArray/fr|Draft Réseau polaire]] en interne est le même objet produit avec l'outil {{Button|[[Image:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray/fr|Draft Réseau orthogonal]]}}. Il est basé sur [[Part_Feature/fr|Part Feature]] (classe {{incode|Part::Feature}}) et partage ainsi toutes les propriétés de ce dernier.
== Scripting ==


Voir l'outil {{Button|[[Image:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray/fr|Draft Réseau orthogonal]]}} pour la description complète des propriétés. Toutes les propriétés s'appliquent, à l'exception de celles des groupes {{TitleProperty|Orthogonal array}} et {{TitleProperty|Polar array}}.
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


== Script ==
The Array tool can be used in [[macros|macros]] and from the [[Python_console|Python console]] by using the following function.


{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD Scripts de Base]].

L'outil Réseau polaire peut être utilisé dans une [[macros/fr|macro]] et dans la [[Python_console/fr|console Python]] avec la fonction suivante:

Appel plus ancien:
{{Code|code=
{{Code|code=
array_list = make_polar_array(obj, center, angle, number, use_link)
array = makeArray(baseobject, center, totalangle, totalnum, use_link=False)
}}
}}


Nouvel appel:
* Creates an array from the objects contained in {{incode|obj}}, which can be a single object or a list of objects.
{{Code|code=
* The value of {{incode|center}} is a vector that defines the center of the array circle; {{incode|angle}} is the angle of the arc in degrees, and {{incode|number}} is the number of copies in the polar pattern, including the original object.
array = make_polar_array(base_object,
* If {{incode|use_link}} is {{TRUE}} the created copies will be [[App_Link|App Links]] and not regular copies.
number=5, angle=360, center=App.Vector(0, 0, 0),
* {{incode|array_list}} is returned with the new copies.
use_link=True)
** {{incode|array_list}} is either a single object or a list of objects, depending on the input {{incode|obj}}.
}}

* Crée un objet {{incode|"Array"}} à partir de {{incode|base_object}}.
** {{incode|number}} est le nombre de copies dans le motif polaire, y compris l'objet d'origine.
** {{incode|angle}} est l'angle de l'arc polaire en degrés.
** {{incode|center}} est un vecteur qui définit le centre du modèle de réseau.
** Si {{incode|use_link}} est {{TRUE}}, les copies créées seront [[App_Link/fr|App Links]] et non des copies régulières.


Exemple:
Example:
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
import Draft
import Draft
import draftobjects.polararray as pa


doc = App.newDocument()
doc = App.newDocument()


tri = Draft.makePolygon(3, 600)
tri = Draft.make_polygon(3, 600)
center = App.Vector(-1600, 0, 0)
center = App.Vector(-1600, 0, 0)

arr = pa.make_polar_array(tri, center, 270, 8)
array = Draft.make_polar_array(tri, 8, 270, center)
App.ActiveDocument.recompute()
doc.recompute()
}}

==Script, réseau non paramétrique==

Lorsque vous utilisez l'outil {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Draft PolarArray]]}}, un objet paramétrique {{incode|"Array"}} est créé. Cela peut être scripté comme décrit dans la section précédente.

Cependant, pour obtenir des copies autonomes de l'objet de base, la simple fonction {{incode|Draft.array}} peut être utilisée. Cela créera des copies simples, pas un nouvel objet paramétrique.

Pour créer un réseau polaire, utilisez-le comme ceci :
{{Code|code=
array_list = array(objectslist, center, angle, number)
}}

* Crée un réseau à partir des objets contenus dans {{incode|objectslist}} qui peut être un seul objet ou une liste d'objets.
** Dans le cas d'un réseau polaire, {{incode|center}} définit le centre du cercle du réseau, {{incode|angle}} est l'angle de l'arc en degrés à recouvrir de copies et {{incode|number }} est le nombre de copies à disposer sur l'arc de cercle, sans compter l'objet d'origine.
** {{incode|array_list}} est retourné avec les nouvelles copies. Il s'agit soit d'un objet unique, soit d'une liste d'objets, selon l'entrée {{incode|liste d'objets}}.

Cette fonction utilise en interne {{incode|Draft.move()}} avec <code>copy=True</code>.

Exemple:

{{Code|code=
import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)
center = App.Vector(-3200, 0, 0)

array_list = Draft.array(tri, center, 180, 5)
doc.recompute()
}}

{{Docnav/fr
|[[Draft_Draft2Sketch/fr|Draft vers esquisse]]
|[[Draft_LinkArray/fr|Réseau lié]]
|[[Draft_Module/fr|Atelier Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}
}}


{{Draft Tools navi}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 21:24, 24 August 2020

Draft Réseau polaire

Emplacement du menu
Modification → Array tools → Polar array
Ateliers
Draft
Raccourci par défaut
Aucun
Introduit dans la version
0.19
Voir aussi
Draft Réseau orthogonal, Draft Réseau circulaire, Draft Chemin pour série de copies, Draft Réseau lié selon une courbe, Draft Matrice de points, Draft Clone

Description

L'outil Draft PolarArray crée un réseau à partir d'un objet sélectionné en plaçant les copies le long d'une circonférence.

Cet outil peut être utilisé sur n'importe quel objet possédant une Part TopoShape, c'est-à-dire des formes 2D créées avec l'atelier Draft mais également des solides 3D créés avec d'autres ateliers, par exemple, Part, PartDesign ou Arch. Il peut également créer des App Links au lieu de simples copies.

Un réseau polaire d'un objet.

Utilisation

  1. Sélectionnez l'objet à partir duquel vous souhaitez créer un réseau.
  2. Appuyez sur le bouton Draft Polar array. Si aucun objet n'est sélectionné, vous serez invité à en sélectionner un avant de continuer.
  3. Le Panneau des tâches est lancé où vous pouvez sélectionner la distance radiale, la distance tangentielle, le nombre de couches circulaires, le paramètre de symétrie et le centre de l'axe de rotation.
  4. Vous pouvez cliquer sur la vue 3D pour définir simultanément la position du centre de rotation et terminer la commande. Sinon, appuyez simplement sur Entrée ou sur le bouton OK pour terminer l'opération.

Remarques

  • Par défaut, l'axe de rotation est l'axe Z positif (0, 0, 1). Ceci peut être modifié dans l'Éditeur de propriétés après la création de l'objet.
  • Chaque élément du tableau est un clone exact de l'objet d'origine, mais l'ensemble du réseau est considéré comme une seule unité en termes de propriétés et d'apparence.
  • Cette commande crée le même objet "réseau" paramétrique que celui créé avec le Draft Réseau orthogonal et Draft Réseau circulaire. Par conséquent, le tableau peut être converti en orthogonal, polaire ou circulaire en modifiant sa propriété DonnéesArray Type.

Options

Ce sont les options affichées dans Panneau des tâches

  • Polar angle: l'angle qui détermine où le dernier élément du réseau sera placé dans l'arrangement polaire. L'angle est positif dans le sens anti-horaire et négatif dans le sens horaire.
  • Number of elements: le nombre d'éléments dans le tableau. Minimum de 2, maximum de 99.
  • Center of rotation: les coordonnées par lesquelles passe l'axe de rotation.
  • Reset point: il réinitialise le centre de rotation à l'origine (0, 0, 0).
  • Fuse: si elle est cochée, les objets résultants dans le tableau fusionneront s'ils se touchent. Cela ne fonctionne que si Link array n'est pas coché.
  • Link array: s'il est coché, le tableau résultant sera un "Link array". Ce tableau utilise en interne des objets App Link, il est donc plus efficace lors du traitement de nombreuses copies de formes complexes. Cependant, dans ce cas, les objets ne peuvent pas être fusionnés ensemble.
  • Appuyez sur Echap ou sur le bouton Annuler pour annuler la commande en cours.

Remarque: si un Link array est créé, cet objet ne peut pas être converti en réseau standard. De même, un réseau standard ne peut pas être converti en Link array. Par conséquent, vous devez choisir le type de réseau que vous souhaitez au moment de la création.

Propriétés

Un objet Draft Réseau polaire en interne est le même objet produit avec l'outil Draft Réseau orthogonal. Il est basé sur Part Feature (classe Part::Feature) et partage ainsi toutes les propriétés de ce dernier.

Voir l'outil Draft Réseau orthogonal pour la description complète des propriétés. Toutes les propriétés s'appliquent, à l'exception de celles des groupes Orthogonal array et Polar array.

Script

Voir aussi: Draft API et FreeCAD Scripts de Base.

L'outil Réseau polaire peut être utilisé dans une macro et dans la console Python avec la fonction suivante:

Appel plus ancien:

array = makeArray(baseobject, center, totalangle, totalnum, use_link=False)

Nouvel appel:

array = make_polar_array(base_object,
                         number=5, angle=360, center=App.Vector(0, 0, 0),
                         use_link=True)
  • Crée un objet "Array" à partir de base_object.
    • number est le nombre de copies dans le motif polaire, y compris l'objet d'origine.
    • angle est l'angle de l'arc polaire en degrés.
    • center est un vecteur qui définit le centre du modèle de réseau.
    • Si use_link est true, les copies créées seront App Links et non des copies régulières.

Exemple:

import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)
center = App.Vector(-1600, 0, 0)

array = Draft.make_polar_array(tri, 8, 270, center)
doc.recompute()

Script, réseau non paramétrique

Lorsque vous utilisez l'outil Draft PolarArray, un objet paramétrique "Array" est créé. Cela peut être scripté comme décrit dans la section précédente.

Cependant, pour obtenir des copies autonomes de l'objet de base, la simple fonction Draft.array peut être utilisée. Cela créera des copies simples, pas un nouvel objet paramétrique.

Pour créer un réseau polaire, utilisez-le comme ceci :

array_list = array(objectslist, center, angle, number)
  • Crée un réseau à partir des objets contenus dans objectslist qui peut être un seul objet ou une liste d'objets.
    • Dans le cas d'un réseau polaire, center définit le centre du cercle du réseau, angle est l'angle de l'arc en degrés à recouvrir de copies et number est le nombre de copies à disposer sur l'arc de cercle, sans compter l'objet d'origine.
    • array_list est retourné avec les nouvelles copies. Il s'agit soit d'un objet unique, soit d'une liste d'objets, selon l'entrée liste d'objets.

Cette fonction utilise en interne Draft.move() avec copy=True.

Exemple:

import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)
center = App.Vector(-3200, 0, 0)

array_list = Draft.array(tri, center, 180, 5)
doc.recompute()