Draft PolarArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Remarques: * Par défaut, l'axe de rotation est l'axe Z positif {{Value|(0, 0, 1)}}. Ceci peut être modifié dans l'Éditeur de propriétés après la...")
No edit summary
 
(113 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
{{Docnav/fr
|[[Draft_Draft2Sketch/fr|Draft vers Esquisse]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_OrthoArray/fr|Réseau orthogonal]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_CircularArray/fr|Réseau circulaire]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_OrthoArray.svg
|IconR=Draft_CircularArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}
}}


{{GuiCommand/rf
{{GuiCommand/fr
|Name=Draft PolarArray
|Name=Draft PolarArray
|Name/fr=Draft Réseau polaire
|Name/fr=Draft Réseau polaire
|MenuLocation=ModifyPolar array
|MenuLocation=ModificationOutils pour les réseaux → Réseau polaire
|Workbenches=[[Draft Module/fr|Draft]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|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/fr|Draft Réseau orthogonal]], [[Draft_CircularArray/fr|Draft Réseau circulaire]], [[Draft_PathArray/fr|Draft Réseau selon une courbe]], [[Draft_PathLinkArray/fr|Draft Réseau lié selon une courbe]], [[Draft_PointArray/fr|Draft Réseau de points]], [[Draft_PointLinkArray/fr|Draft Réseau lié selon des points]]
}}
}}


==Description==
==Description==


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.
La commande [[Image:Draft_PolarArray.svg|24px]] '''Draft Réseau polaire''' crée un réseau à partir d'un objet sélectionné en plaçant des copies le long d'une circonférence. La commande peut éventuellement créer un réseau lié [[App_Link/fr|Link]], qui est plus efficace qu'un réseau régulier.


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]].
Cette commande peut être utilisée sur des objets 2D créés avec l'[[Draft_Workbench/fr|atelier Draft]] ou l'[[Sketcher_Workbench/fr|atelier Sketcher]], mais aussi sur de nombreux objets 3D tels que ceux créés avec l'[[Part_Workbench/fr|atelier Part]], l'[[PartDesign_Workbench/fr|atelier PartDesign]] ou l'[[Arch_Workbench/fr|atelier Arch]].

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]].


[[Image:Draft_PolarArray_example.png|400px]]
[[Image:Draft_PolarArray_example.png|400px]]
{{Caption|Un Draft réseau polaire}}


<span id="Usage"></span>
{{Caption|Un réseau polaire d'un objet.}}

== Utilisation ==
== Utilisation ==


Voir aussi : [[Draft_Snap/fr|Draft Aimantation]].
# Sélectionnez un objet à partir duquel vous souhaitez créer le réseau polaire.
# 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.
# Choisissez l'angle polaire qui détermine où sera le dernier élément du réseau.
# 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.
# Facultativement, vérifiez les options de fusible ou de lien.
# Appuyez sur {{Button|OK}} pour terminer la commande.


# Sélectionner un objet au choix.
Remarques:
# Il existe plusieurs façons d'invoquer la commande :
* 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.
#* Appuyer sur le bouton {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Réseau polaire]]}}.
* L'angle polaire est positif dans le sens anti-horaire et négatif dans le sens horaire.
#* Sélectionner l'option {{MenuCommand|Modification → Outils pour les réseaux → [[Image:Draft_PolarArray.svg|16px]] Réseau polaire}} du menu.
* 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.
# Le panneau de tâches {{MenuCommand|Réseau polaire}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
* 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.
# Si vous n'avez pas encore sélectionné d'objet : sélectionner un objet.
# Saisir les paramètres requis dans le panneau des tâches.
# Pour terminer la commande, effectuez l'une des opérations suivantes :
#* Choisir un point dans la [[3D_view/fr|vue 3D]] pour le {{MenuCommand|Centre de rotation}}.
#* Appuyer sur {{KEY|Entrée}}.
#* Appuyer sur le bouton {{Button|OK}}.


== Options ==
== Options ==


* Entrer l'{{MenuCommand|Angle polaire}} pour spécifier l'angle total du réseau. L'angle est positif dans le sens inverse des aiguilles d'une montre.
* Press {{Button|Reset point}} to set the center of rotation to the origin {{Value|(0, 0, 0)}}.
* Entrer le {{MenuCommand|Nombre d'éléments}}. Doit être au moins {{Value|2}}. Le maximum qui peut être saisi dans le panneau de tâches est {{Value|99}}, mais des valeurs plus élevées sont possibles en modifiant la propriété {{PropertyData|Number Polar}} du réseau.
* If the {{MenuCommand|Fuse}} checkbox is ticked, the resulting objects in the array will be fused into a single shape, if they touch or intersect each other.
* Choisir un point dans la [[3D_view/fr|vue 3D]], notez que cela terminera également la commande ou rentrez des coordonnées pour le {{MenuCommand|Centre de rotation}}. L'axe de rotation du réseau passera par ce point. Il est conseillé de déplacer le pointeur hors de la [[3D_view/fr|vue 3D]] avant de saisir les coordonnées.
* If the {{MenuCommand|Use Links}} checkbox is ticked, the resulting objects in the array will be [[App_Link|App Links]] instead of simple copies. This improves the memory usage of the array, as the App Link re-uses the [[Shape|shape]] of the original object, and does not create new shapes. If this option is used, the {{MenuCommand|Fuse}} checkbox has no effect.
* Appuyer sur le bouton {{MenuCommand|Réinitialiser le point}} pour réinitialiser le {{MenuCommand|Centre de rotation}} à l'origine.
* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the current command.
* Si la case {{MenuCommand|Union}} est cochée, les éléments qui se chevauchent dans le réseau sont fusionnés. Cela ne fonctionne pas pour les réseaux de liens.
* Si la case {{MenuCommand|Réseau de liens}} est cochée, un réseau de liens est créé au lieu d'un réseau régulier. Un réseau de liens est plus efficace car ses éléments sont des objets [[App_Link/fr|App Link]].
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Annuler}} pour annuler la commande en cours.


<span id="Notes"></span>
== Properties ==
==Remarques==


* L'axe de rotation par défaut du réseau est l'axe Z positif. Il peut être modifié en éditant sa propriété {{PropertyData|Axis}}.
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.
* Un Draft Réseau polaire peut être transformé en un [[Draft_OrthoArray/fr|Draft Réseau orthogonal]] ou un [[Draft_CircularArray/fr|Draft Réseau circulaire]] en modifiant sa propriété {{PropertyData|Array Type}}.
* Un réseau de liens ne peut pas être transformé en un réseau régulier ou vice versa. Le type de réseau doit être décidé au moment de la création.


<span id="Properties"></span>
See the [[Draft_Array|Array]] tool for the complete information.
== Propriétés ==


Voir [[Draft_OrthoArray/fr#Propri.C3.A9t.C3.A9s|Draft Réseau orthogonal]].
== Scripting ==


<span id="Scripting"></span>
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
== Script ==


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
The Array tool can be used in [[macros|macros]] and from the [[Python_console|Python console]] by using the following function.

<span id="Parametric_array"></span>
=== Réseau paramétrique ===

Pour créer un réseau orthogonal paramétrique, utilisez la méthode {{incode|make_array}} ({{Version/fr|0.19}}) de l'atelier Draft. Cette méthode remplace la méthode dépréciée {{incode|makeArray}}. La méthode {{incode|make_array}} peut créer des [[Draft_OrthoArray/fr|Draft Réseaux orthogonaux]], [[Draft_PolarArray/fr|Draft Réseaux polaires]] et [[Draft_CircularArray/fr|Draft Réseaux circulaires]]. Pour chaque type de réseau, un ou plusieurs wrappers sont disponibles.

La méthode principale :


{{Code|code=
{{Code|code=
array = make_array(base_object, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, use_link=True)
array_list = make_polar_array(obj, center, angle, number, use_link)
}}
}}


L'enveloppe pour les réseaux polaires est :
* Creates an array from the objects contained in {{incode|obj}}, which can be a single object or a list of objects.

* 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.
{{Code|code=
* If {{incode|use_link}} is {{TRUE}} the created copies will be [[App_Link|App Links]] and not regular copies.
array = make_polar_array(base_object,
* {{incode|array_list}} is returned with the new copies.
number=5, angle=360, center=App.Vector(0, 0, 0),
** {{incode|array_list}} is either a single object or a list of objects, depending on the input {{incode|obj}}.
use_link=True)
}}

* {{incode|base_object}} est l'objet à mettre en réseau. Il peut également s'agir du {{incode|Label}} (chaîne de caractères) d'un objet du document courant.
* {{incode|number}} est le nombre d'éléments dans le motif, y compris l'objet original.
* {{incode|angle}} est l'angle de l'arc polaire en degrés.
* {{incode|center}} est le vecteur qui définit le centre du motif.
* Si {{incode|use_link}} est {{incode|True}}, les éléments créés sont des [[App_Link/fr|App Links]] au lieu de copies ordinaires.
* {{incode|array}} est restitué avec l'objet réseau créé.

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()
}}

<span id="Non-parametric_array"></span>
=== Réseau non paramétrique ===

Pour créer un réseau polaire non-paramétrique, utilisez la méthode {{incode|array}} de l'atelier Draft. Cette méthode renvoie {{incode|None}}.

{{Code|code=
array(objectslist, center, angle, number)
}}

Exemple :

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

doc = App.newDocument()

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

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


{{Docnav/fr
|[[Draft_OrthoArray/fr|Réseau orthogonal]]
|[[Draft_CircularArray/fr|Réseau circulaire]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_OrthoArray.svg
|IconR=Draft_CircularArray.svg
|IconC=Workbench_Draft.svg
}}
}}


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

Latest revision as of 11:56, 9 December 2023

Draft Réseau polaire

Emplacement du menu
Modification → Outils pour les réseaux → Réseau polaire
Ateliers
Draft, Arch
Raccourci par défaut
Aucun
Introduit dans la version
0.19
Voir aussi
Draft Réseau orthogonal, Draft Réseau circulaire, Draft Réseau selon une courbe, Draft Réseau lié selon une courbe, Draft Réseau de points, Draft Réseau lié selon des points

Description

La commande Draft Réseau polaire crée un réseau à partir d'un objet sélectionné en plaçant des copies le long d'une circonférence. La commande peut éventuellement créer un réseau lié Link, qui est plus efficace qu'un réseau régulier.

Cette commande peut être utilisée sur des objets 2D créés avec l'atelier Draft ou l'atelier Sketcher, mais aussi sur de nombreux objets 3D tels que ceux créés avec l'atelier Part, l'atelier PartDesign ou l'atelier Arch.

Un Draft réseau polaire

Utilisation

Voir aussi : Draft Aimantation.

  1. Sélectionner un objet au choix.
  2. Il existe plusieurs façons d'invoquer la commande :
    • Appuyer sur le bouton Réseau polaire.
    • Sélectionner l'option Modification → Outils pour les réseaux → Réseau polaire du menu.
  3. Le panneau de tâches Réseau polaire s'ouvre. Voir Options pour plus d'informations.
  4. Si vous n'avez pas encore sélectionné d'objet : sélectionner un objet.
  5. Saisir les paramètres requis dans le panneau des tâches.
  6. Pour terminer la commande, effectuez l'une des opérations suivantes :
    • Choisir un point dans la vue 3D pour le Centre de rotation.
    • Appuyer sur Entrée.
    • Appuyer sur le bouton OK.

Options

  • Entrer l'Angle polaire pour spécifier l'angle total du réseau. L'angle est positif dans le sens inverse des aiguilles d'une montre.
  • Entrer le Nombre d'éléments. Doit être au moins 2. Le maximum qui peut être saisi dans le panneau de tâches est 99, mais des valeurs plus élevées sont possibles en modifiant la propriété DonnéesNumber Polar du réseau.
  • Choisir un point dans la vue 3D, notez que cela terminera également la commande ou rentrez des coordonnées pour le Centre de rotation. L'axe de rotation du réseau passera par ce point. Il est conseillé de déplacer le pointeur hors de la vue 3D avant de saisir les coordonnées.
  • Appuyer sur le bouton Réinitialiser le point pour réinitialiser le Centre de rotation à l'origine.
  • Si la case Union est cochée, les éléments qui se chevauchent dans le réseau sont fusionnés. Cela ne fonctionne pas pour les réseaux de liens.
  • Si la case Réseau de liens est cochée, un réseau de liens est créé au lieu d'un réseau régulier. Un réseau de liens est plus efficace car ses éléments sont des objets App Link.
  • Appuyez sur Échap ou sur le bouton Annuler pour annuler la commande en cours.

Remarques

  • L'axe de rotation par défaut du réseau est l'axe Z positif. Il peut être modifié en éditant sa propriété DonnéesAxis.
  • Un Draft Réseau polaire peut être transformé en un Draft Réseau orthogonal ou un Draft Réseau circulaire en modifiant sa propriété DonnéesArray Type.
  • Un réseau de liens ne peut pas être transformé en un réseau régulier ou vice versa. Le type de réseau doit être décidé au moment de la création.

Propriétés

Voir Draft Réseau orthogonal.

Script

Voir aussi : Autogenerated API documentation et FreeCAD Débuter avec les scripts.

Réseau paramétrique

Pour créer un réseau orthogonal paramétrique, utilisez la méthode make_array (introduit dans la version 0.19) de l'atelier Draft. Cette méthode remplace la méthode dépréciée makeArray. La méthode make_array peut créer des Draft Réseaux orthogonaux, Draft Réseaux polaires et Draft Réseaux circulaires. Pour chaque type de réseau, un ou plusieurs wrappers sont disponibles.

La méthode principale :

array = make_array(base_object, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, use_link=True)

L'enveloppe pour les réseaux polaires est :

array = make_polar_array(base_object,
                         number=5, angle=360, center=App.Vector(0, 0, 0),
                         use_link=True)
  • base_object est l'objet à mettre en réseau. Il peut également s'agir du Label (chaîne de caractères) d'un objet du document courant.
  • number est le nombre d'éléments dans le motif, y compris l'objet original.
  • angle est l'angle de l'arc polaire en degrés.
  • center est le vecteur qui définit le centre du motif.
  • Si use_link est True, les éléments créés sont des App Links au lieu de copies ordinaires.
  • array est restitué avec l'objet réseau créé.

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()

Réseau non paramétrique

Pour créer un réseau polaire non-paramétrique, utilisez la méthode array de l'atelier Draft. Cette méthode renvoie None.

array(objectslist, center, angle, number)

Exemple :

import FreeCAD as App
import Draft

doc = App.newDocument()

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

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