Draft PolarArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "L'outil {{Button|16px Draft PolarArray}} crée un réseau à partir d'un objet sélectionné en plaçant les copies le lo...")
No edit summary
 
(119 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.


This tool can be used on 2D shapes created with the [[Draft_Workbench|Draft Workbench]] but can also be used on many types of 3D objects such as those created with the [[Part_Workbench|Part Workbench]] or [[PartDesign_Workbench|PartDesign Workbench]].
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]].

To position copies in a rectangular grid use [[Draft_Array|Array]]; to position in a circular pattern use [[Draft_CircularArray|CircularArray]]; to position copies along a path use [[Draft_PathArray|PathArray]]; to position copies at specified points use [[Draft_PointArray|PointArray]]; to create copies or clones, and manually place them use [[Draft_Move|Move]], [[Draft_Rotate|Rotate]], and [[Draft_Clone|Clone]].


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


<span id="Usage"></span>
{{Caption|A polar array of an object.}}
== Utilisation ==


Voir aussi : [[Draft_Snap/fr|Draft Aimantation]].
== Usage ==


# Sélectionner un objet au choix.
# Select an object from which you wish to make the polar array.
# Il existe plusieurs façons d'invoquer la commande :
# Press the {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray|Polar array]]}} button. If no object is selected, the [[task_panel|task panel]] will open, but you still need to select an object to proceed.
#* Appuyer sur le bouton {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Réseau polaire]]}}.
# Choose the polar angle, which determines where the last element of the array will be.
#* Sélectionner l'option {{MenuCommand|Modification → Outils pour les réseaux → [[Image:Draft_PolarArray.svg|16px]] Réseau polaire}} du menu.
# Choose the number of elements in the array. Minimum of 2, maximum of 99.
# Le panneau de tâches {{MenuCommand|Réseau polaire}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Choose the center of the axis of rotation. You can click on the [[3D_view|3D view]], to simultaneously set the position of the center of rotation, and complete the command.
# Si vous n'avez pas encore sélectionné d'objet : sélectionner un objet.
# Optionally, check the fuse or link options.
# Saisir les paramètres requis dans le panneau des tâches.
# Press {{Button|OK}} to complete the command.
# 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}}.
Notes:
#* Appuyer sur {{KEY|Entrée}}.
* By default, the axis of rotation is the positive Z axis {{Value|(0, 0, 1)}}. This can be changed in the [[property_editor|property editor]] after the object is created.
#* Appuyer sur le bouton {{Button|OK}}.
* The polar angle is positive in the counter-clockwise direction, and negative in the clockwise direction.
* Each element in the array is an exact clone of the original object, but the entire array is considered a single unit in terms of properties and appearance.
* This command creates the same object as the one created with the [[Draft_Array|Array]] and [[Draft_CircularArray|CircularArray]] tools. Therefore, the array can be converted to orthogonal, polar, or circular just by changing its properties.


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