Draft PolarArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "L'outil Réseau (Array) peut être utilisé dans une macro et dans la console Python avec la commande:")
No edit summary
 
(106 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.
* Appuyez sur {{Button|Reset point}} pour définir le centre de rotation sur l'origine {{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.
* 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.
* 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.
* 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.
* Appuyer sur le bouton {{MenuCommand|Réinitialiser le point}} pour réinitialiser le {{MenuCommand|Centre de rotation}} à l'origine.
* Appuyez sur {{KEY|Esc}} ou sur le bouton {{Button|Cancel}} pour abandonner la commande en cours.
* 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>
== Propriétés ==
==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}}.
Un objet [[Draft_PolarArray/fr|Draft Réseau]] est basé sur[[Part_Feature/fr|Part Feature]] (classe {{incode|Part::Feature}}) et partage ainsi toutes les propriétés de ce dernier. Outre les propriétés répertoriées dans [[Part_Feature/fr|Part Feature]], l'objet Array possède des propriétés supplémentaires.
* 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>
Voir l'outil [[Draft_Array/fr|Draft Réseau]] pour les informations complètes.
== Propriétés ==


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

<span id="Scripting"></span>
== Script ==
== Script ==


{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD Scripts de Base]].
Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].

<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 :
L'outil Réseau (Array) peut être utilisé dans une [[macros/fr|macro]] et dans la console [[Python/fr|Python]] avec la commande:


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