Draft OrthoArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "L'outil {{Button|16px Draft Réseau orthogonal}} crée un Réseau orthogonal (3 axes) à partir d'un objet sélectionné.")
No edit summary
 
(214 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_Clone/fr|Cloner]]
|[[Draft_Draft2Sketch/fr|Draft vers esquisse]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_PolarArray/fr|Réseau polaire]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_Clone.svg
|IconR=Draft_PolarArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}
}}


Line 12: Line 13:
|Name=Draft OrthoArray
|Name=Draft OrthoArray
|Name/fr=Draft Réseau orthogonal
|Name/fr=Draft Réseau orthogonal
|MenuLocation=Modification → Array toolsArray
|MenuLocation=Modification → Outils pour les réseauxRéseau
|Workbenches=[[Draft_Module|Draft]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Version=0.19
|Version=0.19
|SeeAlso=[[Draft_PolarArray/fr|Draft Réseau polaire]], [[Draft_CircularArray/fr|Draft Réseau circulaire]], [[Draft_PathArray/fr|Draft Réseau selon une courbe]], [[Draft_PointArray/fr|Draft Réseau de points]], [[Draft_Clone/fr|Draft Clone]]
|SeeAlso=[[Draft_PolarArray/fr|Draft Réseau polaire]], [[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|[[Image:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray/fr |Draft Réseau orthogonal]]}} crée un Réseau orthogonal (3 axes) à partir d'un objet sélectionné.
La commande [[Image:Draft_OrthoArray.svg|24px]] '''Draft Réseau orthogonal''' crée un réseau orthogonal (3 axes) à partir d'un objet sélectionné. La commande peut éventuellement créer un réseau de liens [[App_Link/fr|Link]], plus efficace qu'un réseau normal.


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]]. It works on all objects that have a [[Part_TopoShape|Part TopoShape]]. It can also create [[App_Link|App Links]] instead of simple 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]].


[[File:Draft_Array_example.png|300px]]
To create polar and circular arrays directly, use the corresponding {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray|PolarArray]]}} and {{Button|[[File:Draft_CircularArray.svg|16px]] [[Draft_CircularArray|CircularArray]]}} tools; to position copies along a path use {{Button|[[File:Draft_PathArray.svg|16px]] [[Draft_PathArray|PathArray]]}}; to position copies at specified points use {{Button|[[File:Draft_PointArray.svg|16px]] [[Draft_PointArray|PointArray]]}}; to create copies or clones, and manually place them use {{Button|[[File:Draft_Move.svg|16px]] [[Draft_Move|Move]]}}, {{Button|[[File:Draft_Rotate.svg|16px]] [[Draft_Rotate|Rotate]]}}, and {{Button|[[File:Draft_Clone.svg|16px]] [[Draft_Clone|Clone]]}}.
{{Caption|Un Draft réseau orthogonal}}


<span id="Usage"></span>
This command deprecates the previously existing {{Button|[[File:Draft_Array.svg|16px]] [[Draft_Array|Array]]}}, as well as the short lived, {{Button|[[File:Draft_LinkArray.svg|16px]][[Draft_LinkArray|LinkArray]]}} tools.
==Utilisation==


# Sélectionner un objet au choix.
[[File:Draft_Array_example.png|x300px]]
# Il existe plusieurs façons de lancer la commande :
{{Caption|Orthogonal array from a solid object.}}
#* Appuyez sur le bouton {{Button|[[Image:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray/fr|Réseau]]}}.
#* Sélectionnez l'option {{MenuCommand|Modification → Outils pour les réseaux → [[Image:Draft_OrthoArray.svg|16px]] Réseau}} dans le menu.
# Le panneau de tâches {{MenuCommand|Réseau orthogonal}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Si vous n'avez pas encore sélectionné d'objet : sélectionnez un objet.
# Saisissez les paramètres requis dans le panneau des tâches.
# Pour terminer la commande, effectuez l'une des opérations suivantes :
#* Cliquez dans la [[3D_view/fr|Vue 3D]].
#* Appuyez sur {{KEY|Entrée}}.
#* Appuyez sur le bouton {{Button|OK}}.


==Usage==
== Options ==


* Entrez le {{MenuCommand|Nombre d'éléments}} pour les directions X, Y et Z. Ce nombre doit être au moins {{Value|1}} pour chaque direction. Ce nombre doit être au moins {{Value|1}} pour chaque direction.
# Select an object with which you wish to make an array.
* Entrez dans le champ {{MenuCommand|Intervalles en X}} pour spécifier le déplacement des éléments dans la direction X. Pour un réseau rectangulaire, les intervalles Y et Z doivent être spécifiés. Pour un réseau rectangulaire, les valeurs Y et Z doivent être {{Value|0}}.
# Press the {{Button|[[File:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray|Draft OrthoArray]]}} button. If no object is selected, you will be invited to select one.
* Entrez dans le champ {{MenuCommand|Intervalles en Y}} pour spécifier le déplacement des éléments dans la direction Y. Pour un tableau rectangulaire, les valeurs X et Z doivent être {{Value|0}}. Pour un réseau rectangulaire, les valeurs X et Z doivent être {{Value|0}}.
# The [[task_panel|task panel]] is launched, where you can select the number of elements in each X, Y, Z direction; and the interval between each created element.
* Entrez dans le champ {{MenuCommand|Intervalles en Z}} pour spécifier le déplacement des éléments dans la direction Z. Pour un tableau rectangulaire, les valeurs X et Z doivent être {{Value|0}}. Pour un réseau rectangulaire, les valeurs X et Y doivent être {{Value|0}}.
# Press {{Button|OK}} to complete the operation.
* Appuyez sur le bouton {{MenuCommand|Réinitialiser X, Y ou Z}} pour réinitialiser le déplacement dans la direction donnée aux valeurs par défaut.
* 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|Lier un réseau}} est cochée, un réseau de liens est créé au lieu d'un réseau normal. Un réseau de liens est plus efficace car ses éléments sont des objets [[App_Link/fr|App Link]].
* Appuyez sur {{KEY|Echap}} ou sur le bouton {{Button|Annuler}} pour annuler la commande en cours.


<span id="Notes"></span>
Once the array in created, you can select it in the [[tree_view|tree view]], so you can change its properties in the [[property_editor|property editor]], including changing the number of the elements, or even changing its type to "polar" or "circular".
==Remarques==


* Un Draft Réseau orthogonal peut être transformé en un [[Draft_PolarArray/fr|Draft Réseau polaire]] ou un [[Draft_CircularArray/fr|Draft Réseau circulaire]] en modifiant sa propriété {{PropertyData|Array Type}}.
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.
* 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>
== Options ==
== Propriétés ==


Voir aussi : [[Property_editor/fr|Éditeur de propriétés]]
* Interval X: the values of displacement for the copies in the X direction. To create strictly rectangular arrays, the Y and Z values should be zero {{Value|(x, 0, 0)}}.
* Interval Y: the values of displacement for the copies in the Y direction. To create strictly rectangular arrays, the X and Z values should be zero {{Value|(0, y, 0)}}.
* Interval Z: the values of displacement for the copies in the Z direction. To create strictly rectangular arrays, the X and Y values should be zero {{Value|(0, 0, z)}}.
* Number of elements: the elements in the X, Y, and Z directions. A copy of the original object is produced, so this number must be at least {{Value|1}} in every direction.
* Fuse: if it is checked, the resulting objects in the array will fuse together if they touch each other. This only works if "Link array" is unchecked.
* Link array: if it is checked, the resulting array will be a "Link array". This array internally uses [[App_Link|App Link]] objects, so it is more efficient when handling many copies of complex shapes. However, in this case, the objects cannot be fused together.


La commande Draft Réseau orthogonal, la commande [[Draft_PolarArray/fr|Draft Réseau polaire]] et la commande [[Draft_CircularArray/fr|Draft Réseau circulaire]] créent le même objet. Cet objet est dérivé d'un objet [[Part_Feature/fr|Part Feature]] et hérite de toutes ses propriétés (à l'exception de certaines propriétés Vue qui ne sont pas héritées par les réseaux liens Link). Les propriétés suivantes sont supplémentaires, sauf indication contraire :
{{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.


<span id="Data"></span>
== Properties ==
===Données===


{{TitleProperty|Link}}
* {{PropertyData|Base}}: specifies the object to duplicate in the array.
* {{PropertyData|Array Type|Enumeration}}: specifies the type of array to create, {{value|"ortho"}}, {{value|"polar"}}, or {{value|"circular"}}.
* {{PropertyData|Fuse}}: if it is {{TRUE}}, and the copies intersect with each other, they will be fused together into a single shape. This only works if the initial array was not a "Link array".


Les propriétés de ce groupe ne sont disponibles que pour les réseaux de liens. Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.
For orthogonal arrays:
* {{PropertyData|Interval X}}: specifies the interval between each copy on the X axis.
* {{PropertyData|Interval Y}}: specifies the interval between each copy on the Y axis.
* {{PropertyData|Interval Z}}: specifies the interval between each copy on the Z axis.
* {{PropertyData|Number X}}: specifies the number of copies on the X axis.
* {{PropertyData|Number Y}}: specifies the number of copies on the Y axis.
* {{PropertyData|Number Z}}: specifies the number of copies on the Z axis.


* {{PropertyData|Scale|Float}}
For polar arrays:
* {{PropertyData|Scale Vector|Vector|Hidden}}
* {{PropertyData|Axis}}: specifies the normal direction of the array circle.
* {{PropertyData|Center}}: specifies the center point of the array circle.
* {{PropertyData|Scale List|VectorList}}
* {{PropertyData|Visibility List|BoolList|Hidden}}
* {{PropertyData|Angle}}: specifies the aperture of the circular arc to cover with copies; use 360 to cover an entire circle.
* {{PropertyData|Placement List|PlacementList|Hidden}}
* {{PropertyData|Number Polar}}: specifies the number of copies to place in the circular arrangement.
* {{PropertyData|Element List|LinkList|Hidden}}
* {{PropertyData|Interval Axis}}: specifies the interval between each copy on the {{PropertyData|Axis}} direction.
* {{PropertyData|_ Link Touched|Bool|Hidden}}
* {{PropertyData|_ Child Cache|LinkList|Hidden}}
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}
* {{PropertyData|Link Transform|Bool}}


{{TitleProperty|Circular array}}
For circular arrays:
* {{PropertyData|Number Circles}}:
* {{PropertyData|Radial distance}}:
* {{PropertyData|Symmetry}}:
* {{PropertyData|Tangential Distance}}:


Les propriétés de ce groupe sont cachées pour les réseaux orthogonaux et les réseaux polaires.
The number property, either X, Y, Z, or Polar, also includes the original object, so this number will be at least one.


* {{PropertyData|Number Circles|Integer}} : spécifie le nombre de couches circulaires. Doit être au moins {{Value|2}}.
An interval is not a simple distance, but a vector {{Value|(x, y, z)}}. If more than one value is non-zero, the copy will be created in the main direction, but will also be displaced in the other non-zero directions.
* {{PropertyData|Radial Distance|Distance}} : spécifie la distance entre les couches circulaires.
* {{PropertyData|Symmetry|Integer}} : spécifie le nombre de lignes de symétrie. Ce nombre modifie la répartition des éléments dans le réseau.
* {{PropertyData|Tangential Distance|Distance}} : spécifie la distance entre les éléments d'une même couche circulaire. Elle doit être supérieure à zéro.


{{TitleProperty|Objects}}
For example, if {{PropertyData|Interval X}} is {{Value|(2 m, 1 m, 1 m)}}, and {{PropertyData|Number X}} is {{Value|3}}, it will create 3 copies in the X direction; the first copy will be at the original position, the second will be displaced 2 m on X, 1 m on Y, and 1 m on Z; the third copy will be displaced 4 m on X, 2 m on Y, and 2 m on Z. Each array element will be moved slightly to one side (Y direction) and up (Z direction) beside the main X direction.


* {{PropertyData|Array Type|Enumeration}} : spécifie le type de réseau, qui peut être {{value|ortho}}, {{value|polar}} ou {{value|circular}}.
The {{PropertyData|Interval Axis}} property works in the same way. If the original shape lies on the XY plane, creating a polar array with {{PropertyData|Interval Axis}} {{Value|(0, 0, z)}} allows you to make spiral arrangements.
* {{PropertyData|Axis Reference|LinkGlobal}} : spécifie l'objet et le bord à utiliser à la place des propriétés {{PropertyData|Axis}} et {{PropertyData|Center}}. Non utilisé pour les réseaux orthogonaux.
* {{PropertyData|Base|Link}} : spécifie l'objet à dupliquer dans le réseau.
* {{PropertyData|Count|Integer}} : (en lecture seule) spécifie le nombre total d'éléments dans le réseau. {{VersionMinus/fr|0.20}} : uniquement disponible pour les réseaux Link.
* {{PropertyData|Expand Array|Bool}} : spécifie s'il faut développer le réseau dans la [[Tree_view/fr|vue en arborescence]] pour permettre la sélection de ses éléments individuels. Disponible uniquement pour les réseaux de type Link.
* {{PropertyData|Fuse|Bool}} : spécifie si les éléments qui se chevauchent dans le réseau sont fusionnés ou non. Non utilisé pour les réseaux de type Link.


{{TitleProperty|Orthogonal array}}
==Scripting==


Les propriétés de ce groupe sont masquées pour les réseaux circulaires et les réseaux polaires.
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


* {{PropertyData|Interval X|VectorDistance}} : spécifie l'intervalle entre les éléments dans la direction X.
The Array tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using two different functions, depending on if you wish to obtain standalone copies of your base object, or a parametric array object that stays linked to the original object.
* {{PropertyData|Interval Y|VectorDistance}} : spécifie l'intervalle entre les éléments dans la direction Y.
* {{PropertyData|Interval Z|VectorDistance}} : spécifie l'intervalle entre les éléments dans la direction Z.
* {{PropertyData|Number X|Integer}} : spécifie le nombre d'éléments dans la direction X. Doit être au moins {{Value|1}}.
* {{PropertyData|Number Y|Integer}} : spécifie le nombre d'éléments dans la direction Y. Doit avoir au moins la valeur {{Value|1}}.
* {{PropertyData|Number Z|Integer}} : spécifie le nombre d'éléments dans la direction Z. Doit être au moins égal à {{Value|1}}.


{{TitleProperty|Polar array}}
=== Simple array ===


Les propriétés de ce groupe sont masquées pour les réseaux circulaires et les réseaux orthogonaux.
The basic signature is as follows:


* {{PropertyData|Angle|Angle}} : spécifie l'ouverture de l'arc de cercle. Utilisez {{value|360&#176;}} pour un cercle complet.
{{Code|code=
* {{PropertyData|Interval Axis|VectorDistance}} : spécifie l'intervalle entre les éléments dans la direction {{PropertyData|Axis}}.
array_list = array(objectslist, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None)
* {{PropertyData|Number Polar|Integer}} : spécifie le nombre d'éléments dans la direction polaire.
}}


{{TitleProperty|Polar/circular array}}
To create a rectangular array, use it like this:


Les propriétés de ce groupe sont cachées pour les réseaux orthogonaux.
{{Code|code=
array_list = array(objectslist, xvector, yvector, xnum, ynum)
array_list = array(objectslist, xvector, yvector, zvector, xnum, ynum, znum)
}}


* {{PropertyData|Axis|Vector}} : spécifie la direction de l'axe du réseau.
To create a polar array, use it like this:
* {{PropertyData|Center|VectorDistance}} : spécifie le point central du réseau. L'axe du réseau passe par ce point. Pour les réseaux circulaires, il s'agit d'un décalage par rapport à {{PropertyData|Placement}} de l'objet {{PropertyData|Base}}.


<span id="View"></span>
{{Code|code=
===Vue===
array_list = array(objectslist, center, totalangle, totalnum)
}}


{{TitleProperty|Link}}
* 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 rectangular array, {{incode|xvector}}, {{incode|yvector}}, and {{incode|zvector}} determine the distance between the base points of each copy, in the X, Y, and Z directions; and {{incode|xnum}}, {{incode|ynum}}, and {{incode|znum}} are the number of copies in the respective direction.
* In case of a polar array, {{incode|center}} defines the center of the array circle, {{incode|totalangle}} is the angle of the arc in degrees to cover with copies, and {{incode|totalnum}} is the number of copies to arrange around the circle, including the original object.
* {{incode|array_list}} is returned with the new copies.
** {{incode|array_list}} is either a single object or a list of objects, depending on the input {{incode|objectslist}}.


Les propriétés de ce groupe, à l'exception de la propriété héritée, ne sont disponibles que pour les réseaux liens (Link). Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.
This function internally uses {{incode|Draft.move()}} and {{incode|Draft.rotate()}} with <code>copy=True</code>.


* {{PropertyView|Draw Style|Enumeration}}
Example:
* {{PropertyView|Line Width|FloatConstraint}}
* {{PropertyView|Override Material|Bool}}
* {{PropertyView|Point Size|FloatConstraint}}
* {{PropertyView|Selectable|Bool}} : il s'agit d'une propriété héritée qui apparaît dans le groupe Sélection pour d'autres réseaux.
* {{PropertyView|Shape Material|Material}}

{{TitleProperty|Base}}

Les propriétés de ce groupe, à l'exception de la propriété héritée, ne sont disponibles que pour les réseaux liens (Link). Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.

* {{PropertyView|Child View Provider|PersistentObject|Hidden}}
* {{PropertyView|Material List|MaterialList|Hidden}}
* {{PropertyView|Override Color List|ColorList|Hidden}}
* {{PropertyView|Override Material List|BoolList|Hidden}}
* {{PropertyView|Proxy|PythonObject|Hidden}}: il s'agit d'une propriété héritée.

{{TitleProperty|Display Options}}

Les propriétés de ce groupe sont des propriétés héritées. Voir [[Part_Feature/fr#Propri.C3.A9t.C3.A9s|Part Feature]] pour plus d'informations.

* {{PropertyView|Bounding Box|Bool}} : cette propriété n'est pas héritée par les réseaux de liens (Link).
* {{PropertyView|Display Mode|Enumeration}}: pour les réseaux de liens, il peut s'agir de {{value|Link}} ou {{value|ChildView}}. Pour les autres réseaux, il peut s'agir de : {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} ou {{value|Points}}
* {{PropertyView|Show In Tree|Bool}}
* {{PropertyView|Visibility|Bool}}

{{TitleProperty|Draft}}

* {{PropertyView|Pattern|Enumeration}} : non utilisé.
* {{PropertyView|Pattern Size|Float}} : non utilisé.

{{TitleProperty|Object style}}

Les propriétés de ce groupe ne sont pas héritées par les réseaux de liens.

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

Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts FreeCAD]].

<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 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)
import FreeCAD, Draft
}}


Les wrappers pour les réseaux orthogonaux sont :
Rect = Draft.makeRectangle(1500, 500)


{{Code|code=
array_list = Draft.array(Rect, FreeCAD.Vector(1600, 0, 0), FreeCAD.Vector(0, 600, 0), 3, 4)
array = make_ortho_array(base_object,
v_x=App.Vector(10, 0, 0), v_y=App.Vector(0, 10, 0), v_z=App.Vector(0, 0, 10),
n_x=2, n_y=2, n_z=1,
use_link=True)
}}
}}


{{Code|code=
=== Parametric array ===
array = make_ortho_array2d(base_object,
v_x=App.Vector(10, 0, 0), v_y=App.Vector(0, 10, 0),
n_x=2, n_y=2,
use_link=True)
}}


Les wrappers pour les réseaux rectangulaires sont :
The basic signature is as follows:


{{Code|code=
{{Code|code=
array = make_rect_array(base_object,
Array = makeArray(baseobject, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, name="Array")
d_x=10, d_y=10, d_z=10,
n_x=2, n_y=2, n_z=1,
use_link=True)
}}
}}


{{Code|code=
To create a rectangular array, use it like this:
array = make_rect_array2d(base_object,
d_x=10, d_y=10,
n_x=2, n_y=2,
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. (chaîne de caractères) d'un objet dans le document actuel.
* {{incode|v_x}}, {{incode|v_y}}, et {{incode|v_z}} sont les vecteurs entre les points de base des éléments dans les directions respectives.
* {{incode|d_x}}, {{incode|d_y}}, et {{incode|d_z}} sont les distances entre les points de base des éléments dans les directions respectives.
* {{incode|n_x}}, {{incode|n_y}}, et {{incode|n_z}} sont les nombres d'éléments dans les directions respectives.
* 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 :


{{Code|code=
{{Code|code=
import FreeCAD as App
Array = makeArray(baseobject, xvector, yvector, xnum, ynum, name="Array")
import Draft
Array = makeArray(baseobject, xvector, yvector, zvector, xnum, ynum, znum, name="Array")

doc = App.newDocument()

rect = Draft.make_rectangle(1500, 500)
v_x = App.Vector(1600, 0, 0)
v_y = App.Vector(0, 600, 0)

array = Draft.make_ortho_array2d(rect, v_x, v_y, 3, 4)
doc.recompute()
}}
}}


<span id="Non-parametric_array"></span>
To create a polar array, use it like this:
=== Réseau non paramétrique ===

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


{{Code|code=
{{Code|code=
array(objectslist, xvector, yvector, xnum, ynum)
Array = makeArray(baseobject, center, totalangle, totalnum, name="Array")
array(objectslist, xvector, yvector, zvector, xnum, ynum, znum)
}}
}}


Exemple :
* Creates an {{incode|Array}} object from the given {{incode|baseobject}}.
* In case of a rectangular array, {{incode|xvector}}, {{incode|yvector}}, and {{incode|zvector}} determine the distance between the base points of each copy, in the X, Y, and Z directions; and {{incode|xnum}}, {{incode|ynum}}, and {{incode|znum}} are the number of copies in the respective direction.
* In case of a polar array, {{incode|center}} defines the center of the array circle, {{incode|totalangle}} is the angle of the arc in degrees to cover with copies, and {{incode|totalnum}} is the number of copies to arrange around the circle, including the original object.


Example:
{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft


doc = App.newDocument()
Rect = Draft.makeRectangle(1500, 500)
xvector = FreeCAD.Vector(1600, 0, 0)
yvector = FreeCAD.Vector(0, 600, 0)
Array = Draft.makeArray(Rect, xvector, yvector, 3, 4)


Tri = Draft.makePolygon(3, 600)
rect = Draft.make_rectangle(1500, 500)
center = FreeCAD.Vector(-1600, 0, 0)
v_x = App.Vector(1600, 0, 0)
Array2 = Draft.makeArray(Tri, center, 360, 6)
v_y = App.Vector(0, 600, 0)

Draft.array(rect, v_x, v_y, 3, 4)
doc.recompute()
}}
}}



{{Docnav/fr
{{Docnav/fr
|[[Draft_Clone/fr|Cloner]]
|[[Draft_Draft2Sketch/fr|Draft vers esquisse]]
|[[Draft_LinkArray/fr|Link Array]]
|[[Draft_PolarArray/fr|Réseau polaire]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_Clone.svg
|IconR=Draft_PolarArray.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 21:02, 7 December 2023

Draft Réseau orthogonal

Emplacement du menu
Modification → Outils pour les réseaux → Réseau
Ateliers
Draft, Arch
Raccourci par défaut
Aucun
Introduit dans la version
0.19
Voir aussi
Draft Réseau polaire, 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 orthogonal crée un réseau orthogonal (3 axes) à partir d'un objet sélectionné. La commande peut éventuellement créer un réseau de liens 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 orthogonal

Utilisation

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

Options

  • Entrez le Nombre d'éléments pour les directions X, Y et Z. Ce nombre doit être au moins 1 pour chaque direction. Ce nombre doit être au moins 1 pour chaque direction.
  • Entrez dans le champ Intervalles en X pour spécifier le déplacement des éléments dans la direction X. Pour un réseau rectangulaire, les intervalles Y et Z doivent être spécifiés. Pour un réseau rectangulaire, les valeurs Y et Z doivent être 0.
  • Entrez dans le champ Intervalles en Y pour spécifier le déplacement des éléments dans la direction Y. Pour un tableau rectangulaire, les valeurs X et Z doivent être 0. Pour un réseau rectangulaire, les valeurs X et Z doivent être 0.
  • Entrez dans le champ Intervalles en Z pour spécifier le déplacement des éléments dans la direction Z. Pour un tableau rectangulaire, les valeurs X et Z doivent être 0. Pour un réseau rectangulaire, les valeurs X et Y doivent être 0.
  • Appuyez sur le bouton Réinitialiser X, Y ou Z pour réinitialiser le déplacement dans la direction donnée aux valeurs par défaut.
  • 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 Lier un réseau est cochée, un réseau de liens est créé au lieu d'un réseau normal. Un réseau de liens est plus efficace car ses éléments sont des objets App Link.
  • Appuyez sur Echap ou sur le bouton Annuler pour annuler la commande en cours.

Remarques

  • Un Draft Réseau orthogonal peut être transformé en un Draft Réseau polaire 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 normal ou vice versa. Le type de réseau doit être décidé au moment de la création.

Propriétés

Voir aussi : Éditeur de propriétés

La commande Draft Réseau orthogonal, la commande Draft Réseau polaire et la commande Draft Réseau circulaire créent le même objet. Cet objet est dérivé d'un objet Part Feature et hérite de toutes ses propriétés (à l'exception de certaines propriétés Vue qui ne sont pas héritées par les réseaux liens Link). Les propriétés suivantes sont supplémentaires, sauf indication contraire :

Données

Link

Les propriétés de ce groupe ne sont disponibles que pour les réseaux de liens. Voir Std Créer un lien pour plus d'informations.

  • DonnéesScale (Float)
  • Données (Hidden)Scale Vector (Vector)
  • DonnéesScale List (VectorList)
  • Données (Hidden)Visibility List (BoolList)
  • Données (Hidden)Placement List (PlacementList)
  • Données (Hidden)Element List (LinkList)
  • Données (Hidden)_ Link Touched (Bool)
  • Données (Hidden)_ Child Cache (LinkList)
  • Données (Hidden)Colored Elements (LinkSubHidden)
  • DonnéesLink Transform (Bool)

Circular array

Les propriétés de ce groupe sont cachées pour les réseaux orthogonaux et les réseaux polaires.

  • DonnéesNumber Circles (Integer) : spécifie le nombre de couches circulaires. Doit être au moins 2.
  • DonnéesRadial Distance (Distance) : spécifie la distance entre les couches circulaires.
  • DonnéesSymmetry (Integer) : spécifie le nombre de lignes de symétrie. Ce nombre modifie la répartition des éléments dans le réseau.
  • DonnéesTangential Distance (Distance) : spécifie la distance entre les éléments d'une même couche circulaire. Elle doit être supérieure à zéro.

Objects

  • DonnéesArray Type (Enumeration) : spécifie le type de réseau, qui peut être ortho, polar ou circular.
  • DonnéesAxis Reference (LinkGlobal) : spécifie l'objet et le bord à utiliser à la place des propriétés DonnéesAxis et DonnéesCenter. Non utilisé pour les réseaux orthogonaux.
  • DonnéesBase (Link) : spécifie l'objet à dupliquer dans le réseau.
  • DonnéesCount (Integer) : (en lecture seule) spécifie le nombre total d'éléments dans le réseau. version 0.20 et précédentes : uniquement disponible pour les réseaux Link.
  • DonnéesExpand Array (Bool) : spécifie s'il faut développer le réseau dans la vue en arborescence pour permettre la sélection de ses éléments individuels. Disponible uniquement pour les réseaux de type Link.
  • DonnéesFuse (Bool) : spécifie si les éléments qui se chevauchent dans le réseau sont fusionnés ou non. Non utilisé pour les réseaux de type Link.

Orthogonal array

Les propriétés de ce groupe sont masquées pour les réseaux circulaires et les réseaux polaires.

  • DonnéesInterval X (VectorDistance) : spécifie l'intervalle entre les éléments dans la direction X.
  • DonnéesInterval Y (VectorDistance) : spécifie l'intervalle entre les éléments dans la direction Y.
  • DonnéesInterval Z (VectorDistance) : spécifie l'intervalle entre les éléments dans la direction Z.
  • DonnéesNumber X (Integer) : spécifie le nombre d'éléments dans la direction X. Doit être au moins 1.
  • DonnéesNumber Y (Integer) : spécifie le nombre d'éléments dans la direction Y. Doit avoir au moins la valeur 1.
  • DonnéesNumber Z (Integer) : spécifie le nombre d'éléments dans la direction Z. Doit être au moins égal à 1.

Polar array

Les propriétés de ce groupe sont masquées pour les réseaux circulaires et les réseaux orthogonaux.

  • DonnéesAngle (Angle) : spécifie l'ouverture de l'arc de cercle. Utilisez 360° pour un cercle complet.
  • DonnéesInterval Axis (VectorDistance) : spécifie l'intervalle entre les éléments dans la direction DonnéesAxis.
  • DonnéesNumber Polar (Integer) : spécifie le nombre d'éléments dans la direction polaire.

Polar/circular array

Les propriétés de ce groupe sont cachées pour les réseaux orthogonaux.

  • DonnéesAxis (Vector) : spécifie la direction de l'axe du réseau.
  • DonnéesCenter (VectorDistance) : spécifie le point central du réseau. L'axe du réseau passe par ce point. Pour les réseaux circulaires, il s'agit d'un décalage par rapport à DonnéesPlacement de l'objet DonnéesBase.

Vue

Link

Les propriétés de ce groupe, à l'exception de la propriété héritée, ne sont disponibles que pour les réseaux liens (Link). Voir Std Créer un lien pour plus d'informations.

  • VueDraw Style (Enumeration)
  • VueLine Width (FloatConstraint)
  • VueOverride Material (Bool)
  • VuePoint Size (FloatConstraint)
  • VueSelectable (Bool) : il s'agit d'une propriété héritée qui apparaît dans le groupe Sélection pour d'autres réseaux.
  • VueShape Material (Material)

Base

Les propriétés de ce groupe, à l'exception de la propriété héritée, ne sont disponibles que pour les réseaux liens (Link). Voir Std Créer un lien pour plus d'informations.

  • Vue (Hidden)Child View Provider (PersistentObject)
  • Vue (Hidden)Material List (MaterialList)
  • Vue (Hidden)Override Color List (ColorList)
  • Vue (Hidden)Override Material List (BoolList)
  • Vue (Hidden)Proxy (PythonObject): il s'agit d'une propriété héritée.

Display Options

Les propriétés de ce groupe sont des propriétés héritées. Voir Part Feature pour plus d'informations.

  • VueBounding Box (Bool) : cette propriété n'est pas héritée par les réseaux de liens (Link).
  • VueDisplay Mode (Enumeration): pour les réseaux de liens, il peut s'agir de Link ou ChildView. Pour les autres réseaux, il peut s'agir de : Flat Lines, Shaded, Wireframe ou Points
  • VueShow In Tree (Bool)
  • VueVisibility (Bool)

Draft

  • VuePattern (Enumeration) : non utilisé.
  • VuePattern Size (Float) : non utilisé.

Object style

Les propriétés de ce groupe ne sont pas héritées par les réseaux de liens.

Script

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

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)

Les wrappers pour les réseaux orthogonaux sont :

array = make_ortho_array(base_object,
                         v_x=App.Vector(10, 0, 0), v_y=App.Vector(0, 10, 0), v_z=App.Vector(0, 0, 10),
                         n_x=2, n_y=2, n_z=1,
                         use_link=True)
array = make_ortho_array2d(base_object,
                           v_x=App.Vector(10, 0, 0), v_y=App.Vector(0, 10, 0),
                           n_x=2, n_y=2,
                           use_link=True)

Les wrappers pour les réseaux rectangulaires sont :

array = make_rect_array(base_object,
                        d_x=10, d_y=10, d_z=10,
                        n_x=2, n_y=2, n_z=1,
                        use_link=True)
array = make_rect_array2d(base_object,
                          d_x=10, d_y=10,
                          n_x=2, n_y=2,
                          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. (chaîne de caractères) d'un objet dans le document actuel.
  • v_x, v_y, et v_z sont les vecteurs entre les points de base des éléments dans les directions respectives.
  • d_x, d_y, et d_z sont les distances entre les points de base des éléments dans les directions respectives.
  • n_x, n_y, et n_z sont les nombres d'éléments dans les directions respectives.
  • 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()

rect = Draft.make_rectangle(1500, 500)
v_x = App.Vector(1600, 0, 0)
v_y = App.Vector(0, 600, 0)

array = Draft.make_ortho_array2d(rect, v_x, v_y, 3, 4)
doc.recompute()

Réseau non paramétrique

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

array(objectslist, xvector, yvector, xnum, ynum)
array(objectslist, xvector, yvector, zvector, xnum, ynum, znum)

Exemple :

import FreeCAD as App
import Draft

doc = App.newDocument()

rect = Draft.make_rectangle(1500, 500)
v_x = App.Vector(1600, 0, 0)
v_y = App.Vector(0, 600, 0)

Draft.array(rect, v_x, v_y, 3, 4)
doc.recompute()