Draft PolarArray/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(86 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_Draft2Sketch/fr|Draft vers Esquisse]]
|[[Draft_OrthoArray/fr|Réseau orthogonal]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_CircularArray/fr|Réseau circulaire]]
|[[Draft_Module/fr|Atelier Draft]]
|[[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
}}
}}


Line 12: Line 13:
|Name=Draft PolarArray
|Name=Draft PolarArray
|Name/fr=Draft Réseau polaire
|Name/fr=Draft Réseau polaire
|MenuLocation=Modification → Array toolsPolar array
|MenuLocation=Modification → Outils pour les réseauxRéseau polaire
|Workbenches=[[Draft Module/fr|Draft]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Version=0.19
|Version=0.19
|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]]
|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 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.
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 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 des copies le long d'un chemin, utilisez {{Button|[[File:Draft_PathArray.svg|16px]] [[Draft_PathArray/fr|Draft Réseau selon une courbe]]}} or {{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]]}}.
* 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]]
{{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 l'objet à partir duquel vous souhaitez créer un réseau.
# 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.
# 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.


# Sélectionner un objet au choix.
=== Remarques ===
# Il existe plusieurs façons d'invoquer la commande :

#* Appuyer sur le bouton {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/fr|Réseau polaire]]}}.
* 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.
#* 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 réseau 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 "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}}.
# 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.
These are the options displayed in the [[task_panel|task panel]].
* 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.
* 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.
* Appuyer sur le bouton {{MenuCommand|Réinitialiser le point}} pour réinitialiser le {{MenuCommand|Centre de rotation}} à l'origine.
* 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>
<div class="mw-translate-fuzzy">
==Remarques==
* 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.
</div>


* 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}}.
{{Emphasis|Note:}} if a Link array is created, this object cannot be converted to a regular array. And similarly, a regular array cannot be converted to a Link array. Therefore, you must choose the type of array that you want at creation time.
* 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>
== Propriétés ==
== Propriétés ==


Voir [[Draft_OrthoArray/fr#Propri.C3.A9t.C3.A9s|Draft Réseau orthogonal]].
<div class="mw-translate-fuzzy">
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.
</div>

<div class="mw-translate-fuzzy">
Voir l'outil {{Button|[[Image:Draft_Array.svg|16px]] [[Draft_OrthoArray/fr|Draft Réseau orthogonal]]}} pour les informations complètes.
</div>


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


Older call:
{{Code|code=
{{Code|code=
array = makeArray(baseobject, center, totalangle, totalnum, use_link=False)
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 :
New call:

{{Code|code=
{{Code|code=
array = make_polar_array(base_object,
array = make_polar_array(base_object,
Line 90: Line 91:
}}
}}


* {{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.
<div class="mw-translate-fuzzy">
* {{incode|number}} est le nombre d'éléments dans le motif, y compris l'objet original.
* Crée un tableau à partir des objets contenus dans {{incode|obj}} qui peut être un seul objet ou une liste d'objets.
* La valeur de {{incode|center}} est un vecteur qui définit le centre du cercle du tableau; {{incode|angle}} est l'angle de l'arc en degrés et {{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 le vecteur qui définit le centre du motif.
* Si {{incode | use_link}} est {{TRUE}}, les copies créées seront [[App_Link/fr|App Links]] et non des copies régulières.
* {{incode|array_list}} est retourné avec les nouvelles copies.
* 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_list}} est soit un objet unique soit une liste d'objets selon l'entrée {{incode|obj}}.
* {{incode|array}} est restitué avec l'objet réseau créé.

</div>
Exemple :


Exemple:
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
Line 112: Line 113:
}}
}}


<span id="Non-parametric_array"></span>
== Scripting, non-parametric array ==
=== 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}}.
When using the {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray|PolarArray]]}} tool, a parametric {{incode|"Array"}} object is created. This can be scripted as described in the previous section.


However, to obtain standalone copies of the base object, the simple {{incode|Draft.array}} function can be used. This will create simple copies, not a new parametric object.

To create a polar array, use it like this:
{{Code|code=
{{Code|code=
array_list = array(objectslist, center, angle, number)
array(objectslist, center, angle, number)
}}
}}


Exemple :
* Creates an array from the objects contained in {{incode|objectslist}}, which can be a single object or a list of objects.
** In case of a polar array, {{incode|center}} defines the center of the array circle, {{incode|angle}} is the angle of the arc in degrees to cover with copies, and {{incode|number}} is the number of copies to arrange on the circular arc, not including the original object.
** {{incode|array_list}} is returned with the new copies. It is either a single object or a list of objects, depending on the input {{incode|objectslist}}.

This function internally uses {{incode|Draft.rotate()}} with <code>copy=True</code>.

Example:


{{Code|code=
{{Code|code=
Line 138: Line 131:


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


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



{{Docnav/fr
{{Docnav/fr
|[[Draft_Draft2Sketch/fr|Draft vers Esquisse]]
|[[Draft_OrthoArray/fr|Réseau orthogonal]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_CircularArray/fr|Réseau circulaire]]
|[[Draft_Module/fr|Atelier Draft]]
|[[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
}}
}}


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

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