Draft PointArray/fr: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Updating to match new version of source page)
 
(145 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_PathArray/fr|Série de copies Draft]]
|[[Draft_PathLinkArray/fr|Réseau lié selon une courbe]]
|[[Draft_PointLinkArray/fr|Réseau lié selon des points]]
|[[Draft_Clone/fr|Clone Draft]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_PathArray.svg
|IconL=Draft_PathLinkArray.svg
|IconR=Draft_PointLinkArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Clone.svg
}}
}}


{{GuiCommand/fr
{{GuiCommand/fr
|Name=Draft PointArray
|Name=Draft PointArray
|Name/fr=Matrice de points Draft
|Name/fr=Draft Réseau de points
|MenuLocation=Modification → Outils pour les réseaux → Réseau de points
|Icon=Draft_PointArray.svg
|Workbenches=[[Draft Module/fr|Atelier Draft]], [[Arch Module/fr|Atelier Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|MenuLocation=Draft → Matrice de points
|Version=0.18
|Version=0.18
|SeeAlso=[[Draft_OrthoArray/fr|Draft Réseau orthogonal]], [[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_PointLinkArray/fr|Draft Réseau lié selon des points]]
|SeeAlso=[[Draft Array/fr|Matrice Draft]], [[Draft PathArray/fr|Série de copies Draft]]
}}
}}


==Description==
==Description==


La commande [[Image:Draft_PointArray.svg|24px]] '''Draft Réseau de points''' crée un réseau régulier à partir d'un objet de base sélectionné en plaçant des copies aux points d'un objet ponctuel. Utilisez la commande [[Draft_PointLinkArray/fr|Draft Réseau lié selon une courbe]] pour créer un réseau lié [[App_Link/fr|Link]] plus efficace. À l'exception du type de réseau créé, réseau de liens ou réseau régulier, la commande [[Draft_PointLinkArray/fr|Draft Réseau lié selon une courbe]] est identique à cette commande.
L'outil PointArray place des copies d'une forme sélectionnée le long de divers points sélectionnés.


L'outil Matrice de points peut être utilisé sur des formes 2D créées avec [[Draft Workbench/fr|Atelier Draft]], mais également sur de nombreux types d'objets 3D, tels que ceux créés avec [[Part Workbench/fr|Atelier Part]], [[PartDesign Workbench/fr|Atelier PartDesign]] ou [[[Arch Workbench/fr|Atelier Arch]]].
L'objet de base peut être un objet 2D créé avec l'[[Draft_Workbench/fr|atelier Draft]] ou l'[[Sketcher_Workbench/fr|atelier Sketcher]], mais aussi un objet 3D tel que ceux créés avec l'[[Part_Workbench/fr|atelier Part]], l'[[PartDesign_Workbench/fr|atelier PartDesign]] ou l'[[Arch_Workbench/fr|atelier Arch]].


L'objet Point peut être n'importe quel objet ayant une forme et des sommets (y compris un [[Std_Part/fr|Std Part]] contenant un ou plusieurs de ces objets), ainsi qu'un [[Mesh_Workbench/fr|maillage]] et un [[Points_Workbench/fr|nuage de point]]. Les points en double dans l'objet point sont filtrés. {{Version/fr|0.21}}
Pour positionner les copies dans un tableau orthogonal, utilisez [[Draft Array/fr|Matrice Draft]]. Pour positionner les copies le long d’un chemin, utilisez [[Draft PathArray/fr|Série de copies Draft]]. Pour créer des copies ou des clones et les placer manuellement, utilisez [[Draft Move/fr|Déplacer Draft]], [[Draft Rotate/fr|Rotation Draft]] et [[Draft Clone/fr|Clone Draft]].

Dans {{VersionMinus/fr|0.20}}, seuls trois types d'objets Point sont pris en charge, voir [[#Objet_Point_version_0.20_et_inf.C3.A9rieure|Objet Point version 0.20 et inférieure]].


[[Image:Draft_PointArray_Example.png|400px]]
[[Image:Draft_PointArray_Example.png|400px]]
{{Caption|Objet disposé à des points spécifiques}}
{{Caption|Un Draft Réseau de points}}


<span id="Usage"></span>
==Utilisation==
==Utilisation==


# Sélectionnez un objet que vous souhaitez distribuer.
# Sélectionner l'objet que vous souhaitez mettre en réseau.
# Sélectionnez un point composé.
# Ajouter l'objet point à la sélection.
# Il existe plusieurs façons de lancer la commande :
# Appuyez sur le bouton {{Button|[[Image:Draft_PointArray.svg|16px]] [[Draft PointArray/fr|Matrice des points]]}}.
#* Appuyer sur le bouton {{Button|[[Image:Draft_PointArray.svg|16px]] [[Draft_PointArray/fr|Réseau de points]]}}.
#* Sélectionner l'option {{MenuCommand|Modification → Outils pour les réseaux → [[Image:Draft_PointArray.svg|16px]] Réseau de points}} du menu.
# Le réseau est créé.
# Vous pouvez modifier les [[#Propri.C3.A9t.C3.A9s|propriétés]] du réseau dans l'[[Property_editor/fr|éditeur de propriétés]].


<span id="Point_object_version_0.20_and_below"></span>
Pour créer un point composé, sélectionnez divers [[Draft Point/fr|Point Draft]] puis appuyez sur le bouton {{Button|[[Image:Draft Upgrade.svg|16px]] [[Draft Upgrade/fr|Mettre à niveau Draft]]}}.
== Objet Point version 0.20 et inférieure ==


Voici les objets Point pris en charge dans {{VersionMinus/fr|0.20}} et la manière dont ils peuvent être créés :
Chaque élément du tableau est un clone exact de l'objet d'origine mais l'ensemble du tableau est considéré comme une seule unité en termes de propriétés et d'apparence.
* [[Part_Compound/fr|Part Composé]] : crée un ou plusieurs [[Draft_Point/fr|Draft Points]] ou [[Part_Point/fr|Part Points]]. Sélectionnez-les et lancez la commande [[Part_Compound/fr|Part Composé]].
* Draft Bloc : crée un ou plusieurs [[Draft_Point/fr|Draft Points]] ou [[Part_Point/fr|Part Points]]. Sélectionnez-les et lancez la commande [[Draft_Upgrade/fr|Draft Agréger]].
* [[Sketcher_NewSketch/fr|Sketcher Esquisse]] : crée une [[Sketcher_NewSketch/fr|esquisse]] et ajoute un ou plusieurs [[Sketcher_CreatePoint/fr|Sketcher Points]] à l'esquisse.


<span id="Properties"></span>
==Options==
==Propriétés==


Voir aussi: [[Property_editor/fr|Éditeur de propriétés]]
Il n'y a pas d'options pour cet outil. Cela fonctionne avec les objets sélectionnés ou non.


Un objet Draft Réseau de points 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 Link). Les propriétés suivantes sont supplémentaires, sauf indication contraire :
==Propriétés==


<span id="Data"></span>
* {{PropertyData/fr|Base}}: spécifie l'objet à dupliquer.
===Données===
* {{PropertyData/fr|Count}}: (en lecture seule) spécifie le nombre de copies de l'objet de base. Ce nombre dépendra du nombre de [[Draft Point/fr|Point Draft]] dans le composé.
* {{PropertyData/fr|PointList}}: spécifie un objet composé avec des objets ponctuels indiquant l'emplacement des copies de l'objet {{PropertyData/fr|Base}}.
{{PropertyData/fr|Base}} objet qui apparaît.
L'objet composé doit avoir un attribut {{PropertyData/fr|Links}}, {{PropertyData/fr|Componets}}, ou {{PropertyData/fr|Geometry}}. Chacun des objets à l'intérieur du composé devrait être un [[Draft Point/fr|Draft Points]] qui a des attributs {{PropertyData/fr|X}}, {{PropertyData/fr|Y}}, et {{PropertyData/fr|Z}} .
Les composés pourraient être créés avec les attributs [[Part MakeCompound/fr|Part MakeCompound]] ({{PropertyData/fr|Links}}) ou avec les attributs [[Draft Upgrade/fr|Draft Upgrade]] ({{PropertyData/fr|Componets}}).


{{TitleProperty|Link}}
==Script==

{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD scripts de base]].
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.

* {{PropertyData|Scale|Float}}
* {{PropertyData|Scale Vector|Vector|Hidden}}
* {{PropertyData|Scale List|VectorList}}
* {{PropertyData|Visibility List|BoolList|Hidden}}
* {{PropertyData|Placement List|PlacementList|Hidden}}
* {{PropertyData|Element List|LinkList|Hidden}}
* {{PropertyData|_ Link Touched|Bool|Hidden}}
* {{PropertyData|_ Child Cache|LinkList|Hidden}}
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}
* {{PropertyData|Link Transform|Bool}}

{{TitleProperty|Objects}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
* {{PropertyData|Base|Link}} : spécifie l'objet à dupliquer dans le réseau.
L'outil PointArray peut être utilisé à l'intérieur d'une [[macros/fr|macro]], et, à partir de la console [[Python/fr|Python]] , en utilisant la fonction suivante :
* {{PropertyData|Count|Integer}} : (en lecture seule) spécifie le nombre d'éléments dans le réseau. Ce nombre est déterminé par le nombre de points dans l'objet {{PropertyData|Point}}.
* {{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|Extra Placement|Placement}} : spécifie un [[Placement|placement]], une translation et une rotation supplémentaires pour chaque élément du réseau.
* {{PropertyData|Point Object|Link}} : spécifie l'objet composé dont les points sont utilisés pour positionner les éléments du réseau. L'objet doit avoir une propriété {{PropertyData|Links}}, {{PropertyData|Components}} ou {{PropertyData|Geometry}} et contenir au moins un élément avec les propriétés {{PropertyData|X}}, {{PropertyData|Y}}, et {{PropertyData|Z}}.
</div>
</div>

<span id="View"></span>
=== Vue ===

{{TitleProperty|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_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.

* {{PropertyView|Draw Style|Enumeration}}
* {{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|FreeCAD Débuter avec les scripts]].

Pour créer un réseau de points, utilisez la méthode {{incode|make_point_array}} ({{Version/fr|0.19}}) de l'atelier Draft. Cette méthode remplace la méthode dépréciée {{incode|makePointArray}}.

{{Code|code=
{{Code|code=
point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
PointArray = makePointArray(base, ptlst)
}}
}}


* Crée un objet {{incode|PointArray}} à partir de l'objet {{incode|base}} en plaçant les copies le long de {{incode|ptlst}}.
* {{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|ptlst}} est un objet avec les attributs {{incode|Geometry}}, {{incode|Links}} ou {{incode|Components}} qui définissent la position des copies.
* {{incode|point_object}} est l'objet contenant les points. Il peut également s'agir du {{incode|Label}} (chaîne de caractères) d'un objet du document courant. Il doit avoir une propriété {{incode|Geometry}}, {{incode|Links}}, ou {{incode|Components}} contenant des points.
* {{incode|extra}} est un {{incode|App.Placement}}, un {{incode|App.Vector}} ou un {{incode|App.Rotation}} qui déplace chaque élément.
* Si {{incode|use_link}} est {{incode|True}}, les éléments créés sont des [[App_Link/fr|App Links]] au lieu de copies ordinaires.

Exemple :


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


doc = App.newDocument()
Polygon = Draft.makePolygon(3, radius=500.0)


p1 = Draft.makePoint(FreeCAD.Vector(1500, 0, 0))
polygon = Draft.make_polygon(3, radius=500.0)
p2 = Draft.makePoint(FreeCAD.Vector(2500, 0, 0))
p3 = Draft.makePoint(FreeCAD.Vector(2000, 1000, 0))


p1 = Draft.make_point(App.Vector(1500, 0, 0))
# Create a compound of points
addList, deleteList = Draft.upgrade([p1, p2, p3])
p2 = Draft.make_point(App.Vector(2500, 0, 0))
p3 = Draft.make_point(App.Vector(2000, 1000, 0))


compound = doc.addObject("Part::Compound", "Compound")
# Extract the compound from the list
compound = addList[0]
compound.Links = [p1, p2, p3]


PointArray = Draft.makePointArray(Polygon, compound)
point_array = Draft.make_point_array(polygon, compound)
doc.recompute()
}}
}}



<div class="mw-translate-fuzzy">
{{Docnav/fr
{{Docnav/fr
|[[Draft_PathArray/fr|Série de copies Draft]]
|[[Draft_PathLinkArray/fr|Réseau lié selon une courbe]]
|[[Draft_PointLinkArray/fr|Réseau lié selon des points]]
|[[Draft_Clone/fr|Clone Draft]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_PathArray.svg
|IconL=Draft_PathLinkArray.svg
|IconR=Draft_PointLinkArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Clone.svg
}}
}}
</div>

{{Draft Tools navi/fr}}


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

Latest revision as of 09:06, 28 March 2024

Draft Réseau de points

Emplacement du menu
Modification → Outils pour les réseaux → Réseau de points
Ateliers
Draft, Arch
Raccourci par défaut
Aucun
Introduit dans la version
0.18
Voir aussi
Draft Réseau orthogonal, Draft Réseau polaire, Draft Réseau circulaire, Draft Réseau selon une courbe, Draft Réseau lié selon une courbe, Draft Réseau lié selon des points

Description

La commande Draft Réseau de points crée un réseau régulier à partir d'un objet de base sélectionné en plaçant des copies aux points d'un objet ponctuel. Utilisez la commande Draft Réseau lié selon une courbe pour créer un réseau lié Link plus efficace. À l'exception du type de réseau créé, réseau de liens ou réseau régulier, la commande Draft Réseau lié selon une courbe est identique à cette commande.

L'objet de base peut être un objet 2D créé avec l'atelier Draft ou l'atelier Sketcher, mais aussi un objet 3D tel que ceux créés avec l'atelier Part, l'atelier PartDesign ou l'atelier Arch.

L'objet Point peut être n'importe quel objet ayant une forme et des sommets (y compris un Std Part contenant un ou plusieurs de ces objets), ainsi qu'un maillage et un nuage de point. Les points en double dans l'objet point sont filtrés. introduit dans la version 0.21

Dans version 0.20 et précédentes, seuls trois types d'objets Point sont pris en charge, voir Objet Point version 0.20 et inférieure.

Un Draft Réseau de points

Utilisation

  1. Sélectionner l'objet que vous souhaitez mettre en réseau.
  2. Ajouter l'objet point à la sélection.
  3. Il existe plusieurs façons de lancer la commande :
    • Appuyer sur le bouton Réseau de points.
    • Sélectionner l'option Modification → Outils pour les réseaux → Réseau de points du menu.
  4. Le réseau est créé.
  5. Vous pouvez modifier les propriétés du réseau dans l'éditeur de propriétés.

Objet Point version 0.20 et inférieure

Voici les objets Point pris en charge dans version 0.20 et précédentes et la manière dont ils peuvent être créés :

Propriétés

Voir aussi: Éditeur de propriétés

Un objet Draft Réseau de points 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 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)

Objects

  • DonnéesBase (Link) : spécifie l'objet à dupliquer dans le réseau.
  • DonnéesCount (Integer) : (en lecture seule) spécifie le nombre d'éléments dans le réseau. Ce nombre est déterminé par le nombre de points dans l'objet DonnéesPoint.
  • 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éesExtra Placement (Placement) : spécifie un placement, une translation et une rotation supplémentaires pour chaque élément du réseau.
  • DonnéesPoint Object (Link) : spécifie l'objet composé dont les points sont utilisés pour positionner les éléments du réseau. L'objet doit avoir une propriété DonnéesLinks, DonnéesComponents ou DonnéesGeometry et contenir au moins un élément avec les propriétés DonnéesX, DonnéesY, et DonnéesZ.

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 FreeCAD Débuter avec les scripts.

Pour créer un réseau de points, utilisez la méthode make_point_array (introduit dans la version 0.19) de l'atelier Draft. Cette méthode remplace la méthode dépréciée makePointArray.

point_array = make_point_array(base_object, point_object, extra=None, 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.
  • point_object est l'objet contenant les points. Il peut également s'agir du Label (chaîne de caractères) d'un objet du document courant. Il doit avoir une propriété Geometry, Links, ou Components contenant des points.
  • extra est un App.Placement, un App.Vector ou un App.Rotation qui déplace chaque élément.
  • Si use_link est True, les éléments créés sont des App Links au lieu de copies ordinaires.

Exemple :

import FreeCAD as App
import Draft

doc = App.newDocument()

polygon = Draft.make_polygon(3, radius=500.0)

p1 = Draft.make_point(App.Vector(1500, 0, 0))
p2 = Draft.make_point(App.Vector(2500, 0, 0))
p3 = Draft.make_point(App.Vector(2000, 1000, 0))

compound = doc.addObject("Part::Compound", "Compound")
compound.Links = [p1, p2, p3]

point_array = Draft.make_point_array(polygon, compound)
doc.recompute()