Draft CircularArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Docnav/fr |Draft vers Esquisse |Link Array |Atelier Draft |IconL=Draft_Draft2Sketch.svg |IconC=Workbench_Dr...")
No edit summary
 
(108 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_Draft2Sketch/fr|Draft vers Esquisse]]
|[[Draft_PolarArray/fr|Réseau polaire]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_PathArray/fr|Réseau selon une courbe]]
|[[Draft_Module|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_PolarArray.svg
|IconR=Draft_PathArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}
}}


{{GuiCommand
{{GuiCommand/fr
|Name=Draft CircularArray
|Name=Draft PolarArray
|MenuLocation=Draft Circular array
|Name/fr=Draft Réseau circulaire
|MenuLocation=Modification → Outils pour les réseaux → Réseau circulaire
|Workbenches=[[Draft Module|Draft]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Version=0.19
|Version=0.19
|SeeAlso=[[Draft_Array|Array]], [[Draft_PolarArray|PolarArray]], [[Draft_PathArray|PathArray]], [[Draft_PointArray|PointArray]], [[Draft_Clone|Clone]]
|SeeAlso=[[Draft_OrthoArray/fr|Draft Réseau orthogonal]], [[Draft_PolarArray/fr|Draft Réseau polaire]], [[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==


La commande [[Image:Draft_CircularArray.svg|24px]] '''Draft Réseau circulaire''' crée un réseau à partir d'un objet sélectionné en plaçant des copies le long de circonférences concentriques. La commande peut éventuellement créer un réseau [[App_Link/fr|Link]], plus efficace qu'un réseau normal.
The {{Button|[[File:Draft_CircularArray.svg|16px]] [[Draft_CircularArray|Draft CircularArray]]}} tool creates an array from a selected object placing the copies along concentric circumferences. This is like using [[Draft_PolarArray|PolarArray]] with a polar angle of 360 degrees, and creating several such concentric arrays.


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 polar pattern use [[Draft_PolarArray|PolarArray]]; 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_CircularArray_example.png|400px]]
[[Image:Draft_CircularArray_example.png|400px]]
{{Caption|Un Draft réseau circulaire}}


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


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


# Sélectionner un objet.
# Select an object from which you wish to make the circular array.
# Il existe plusieurs façons de lancer la commande :
# Press the {{Button|[[File:Draft_CircularArray.svg|16px]] [[Draft_CircularArray|Circular 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_CircularArray.svg|16px]] [[Draft_CircularArray/fr|Réseau circulaire]]}}.
# Choose the radial distance, which determines the distance from the center of the array to the next circular layer, and between subsequent circular layers.
#* Sélectionner l'option {{MenuCommand|Modification → Outils pour les réseaux → [[Image:Draft_CircularArray.svg|16px]] Réseau circulaire}} du menu.
# Choose the tangential distance, which determines the distance from one element in the array to the next element in the same circular layer. This distance determines how many elements will be in the array; if the number is small, there will be many tightly packed copies; if the number is large, there will only be a few copies. This distance cannot be zero.
# Le panneau de tâches {{MenuCommand|Réseau circulaire}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Choose the number of circular layers. The original object is considered one layer by itself. Minimum of 2, maximum of 99.
# Si vous n'avez pas encore sélectionné d'objet : en sélectionner un.
# Choose the symmetry number, which determines how the objects will be distributed in the array. Choose a number between 1 and 10.
# Saisir les paramètres requis dans le panneau des tâches.
# 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.
# Pour terminer la commande, effectuer l'une des opérations suivantes :
# Optionally, check the fuse or link options.
#* Choisir un point dans la [[3D_view/fr|vue 3D]] pour le {{MenuCommand|Centre de rotation}}.
# Press {{Button|OK}} to complete the command.
#* Appuyer sur {{KEY|Entrée}}.

#* Appuyer sur le bouton {{Button|OK}}.
Notes:
* 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.
* 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_PolarArray|PolarArray]] tools. Therefore, the array can be converted to orthogonal, polar, or circular just by changing its properties.


== Options ==
== Options ==


* Entrez la {{MenuCommand|Distance radiale}} pour spécifier la distance entre les couches circulaires et entre le centre et la première couche circulaire.
* Press {{Button|Reset point}} to set the center of the circular patterns to the origin {{Value|(0, 0, 0)}}.
* Entrez la {{MenuCommand|Distance tangentielle}} pour spécifier la distance entre les éléments d'une même couche circulaire. Elle doit être supérieure à zéro.
* 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.
* Entrez le {{MenuCommand|Nombre de couches circulaires}}. L'élément au centre compte pour une couche. Doit être au moins {{Value|2}}. Le maximum pouvant ê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 Circles}} du réseau.
* 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.
* Saisissez la valeur {{MenuCommand|Symétrie}}. Ce nombre détermine la façon dont les éléments sont répartis. Une valeur de {{Value|3}}, par exemple, donne un motif comportant trois secteurs égaux de 120°. Des valeurs plus élevées pour la {{MenuCommand|Symétrie}} et la {{MenuCommand|Distance tangentielle}} permettent d'obtenir moins d'éléments, voire aucun, sur les couches internes.
* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the current command.
* Choisissez 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.
* Appuyez 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 seront 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 normal. Un réseau de liens est plus performant car ses éléments sont des objets [[App_Link/fr|App Link]].
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Annuler}} pour abandonner la commande.


<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 circulaire peut être transformé en un [[Draft_OrthoArray/fr|Draft Réseau orthogonal]] ou un [[Draft_PolarArray/fr|Draft Réseau polaire]] en modifiant sa propriété {{PropertyData|Array Type}}.
* Un réseau de liens ne peut pas être transformé en un réseau normal 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.

Pour créer un réseau circulaire, 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 Réseaux circulaires. Pour chaque type de réseau, une ou plusieurs enveloppes 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_circular_array(obj, r_distance, tan_distance,
axis, center, number, symmetry,
use_link)
}}
}}


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

* The values of {{incode|r_distance}} and {{incode|tan_distance}} correspond to the radial and tangential distances of the elements in the array.
{{Code|code=
* The values of {{incode|axis}} and {{incode|center}} are vectors that describe the direction of the axis of rotation, and a point through which that axis goes.
array = make_circular_array(base_object,
* The value of {{incode|number}} is the number of circular layers in the circular pattern; the original object counts as the first layer.
r_distance=100, tan_distance=50,
* The value of {{incode|symmetry}} is an integer that participates in some calculations that affect the way the copies are distributed around the circumferences. Try different values, from 1 to 10, to get different placements of the copies.
number=3, symmetry=1,
* If {{incode|use_link}} is {{TRUE}} the created copies will be [[App_Link|App Links]] and not regular copies.
axis=App.Vector(0, 0, 1), 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}}.
}}

* {{incode|base_object}} est l'objet à mettre en réseau. Il peut également s'agir d'un {{incode|Label}} (chaîne de caractères) d'un objet du document en cours.
* {{incode|r_distance}} et {{incode|tan_distance}} sont les distances radiale et tangentielle entre les éléments.
* {{incode|number}} est le nombre de couches circulaires dans le motif, l'objet original comptant comme la première couche.
* {{incode|symmetry}} est un nombre entier utilisé dans certains calculs qui affectent la façon dont les éléments sont répartis sur les circonférences. Les valeurs habituelles vont de 1 à 6. Les valeurs plus élevées ne sont pas recommandées et font disparaître les éléments des couches intérieures.
* {{incode|axis}} et {{incode|center}} sont des vecteurs qui décrivent la direction de l'axe de rotation et un point par lequel cet axe passe.
* 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 retourné 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.circulararray as ca


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


tri = Draft.makePolygon(3, 600)
tri = Draft.make_polygon(3, 600)

axis = App.Vector(0, 0, 1)
array = Draft.make_circular_array(tri, 1800, 1200, 4, 1)
center = App.Vector(0, 0, 0)
doc.recompute()
arr = ca.make_circular_array(tri, 1800, 1200, axis, center, 4, 1)
}}
App.ActiveDocument.recompute()


{{Docnav/fr
|[[Draft_PolarArray/fr|Réseau polaire]]
|[[Draft_PathArray/fr|Réseau selon une courbe]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_PolarArray.svg
|IconR=Draft_PathArray.svg
|IconC=Workbench_Draft.svg
}}
}}


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

Latest revision as of 12:29, 8 December 2023

Draft Réseau circulaire

Emplacement du menu
Modification → Outils pour les réseaux → Réseau circulaire
Ateliers
Draft, Arch
Raccourci par défaut
Aucun
Introduit dans la version
0.19
Voir aussi
Draft Réseau orthogonal, Draft Réseau polaire, 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 circulaire crée un réseau à partir d'un objet sélectionné en plaçant des copies le long de circonférences concentriques. La commande peut éventuellement créer un réseau Link, plus efficace qu'un réseau normal.

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 circulaire

Utilisation

Voir aussi : Draft Aimantation.

  1. Sélectionner un objet.
  2. Il existe plusieurs façons de lancer la commande :
    • Appuyer sur le bouton Réseau circulaire.
    • Sélectionner l'option Modification → Outils pour les réseaux → Réseau circulaire du menu.
  3. Le panneau de tâches Réseau circulaire s'ouvre. Voir Options pour plus d'informations.
  4. Si vous n'avez pas encore sélectionné d'objet : en sélectionner un.
  5. Saisir les paramètres requis dans le panneau des tâches.
  6. Pour terminer la commande, effectuer 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

  • Entrez la Distance radiale pour spécifier la distance entre les couches circulaires et entre le centre et la première couche circulaire.
  • Entrez la Distance tangentielle pour spécifier la distance entre les éléments d'une même couche circulaire. Elle doit être supérieure à zéro.
  • Entrez le Nombre de couches circulaires. L'élément au centre compte pour une couche. Doit être au moins 2. Le maximum pouvant ê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 Circles du réseau.
  • Saisissez la valeur Symétrie. Ce nombre détermine la façon dont les éléments sont répartis. Une valeur de 3, par exemple, donne un motif comportant trois secteurs égaux de 120°. Des valeurs plus élevées pour la Symétrie et la Distance tangentielle permettent d'obtenir moins d'éléments, voire aucun, sur les couches internes.
  • Choisissez 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.
  • Appuyez 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 seront 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 normal. Un réseau de liens est plus performant car ses éléments sont des objets App Link.
  • Appuyez sur Échap ou sur le bouton Annuler pour abandonner la commande.

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 circulaire peut être transformé en un Draft Réseau orthogonal ou un Draft Réseau polaire en modifiant sa propriété DonnéesArray Type.
  • Un réseau de liens ne peut pas être transformé en un réseau normal 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.

Pour créer un réseau circulaire, 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, une ou plusieurs enveloppes 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 circulaires est :

array = make_circular_array(base_object,
                            r_distance=100, tan_distance=50,
                            number=3, symmetry=1,
                            axis=App.Vector(0, 0, 1), center=App.Vector(0, 0, 0),
                            use_link=True)
  • base_object est l'objet à mettre en réseau. Il peut également s'agir d'un Label (chaîne de caractères) d'un objet du document en cours.
  • r_distance et tan_distance sont les distances radiale et tangentielle entre les éléments.
  • number est le nombre de couches circulaires dans le motif, l'objet original comptant comme la première couche.
  • symmetry est un nombre entier utilisé dans certains calculs qui affectent la façon dont les éléments sont répartis sur les circonférences. Les valeurs habituelles vont de 1 à 6. Les valeurs plus élevées ne sont pas recommandées et font disparaître les éléments des couches intérieures.
  • axis et center sont des vecteurs qui décrivent la direction de l'axe de rotation et un point par lequel cet axe passe.
  • Si use_link est True, les éléments créés sont des App Links au lieu de copies ordinaires.
  • array est retourné avec l'objet réseau créé.

Exemple :

import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)

array = Draft.make_circular_array(tri, 1800, 1200, 4, 1)
doc.recompute()