Draft PointArray/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "==Notes d'utilisation== * {{emphasis|in progress}}")
(Updating to match new version of source page)
Line 12: Line 12:


L'outil PointArray place des copies d'une forme sélectionnée le long de divers points sélectionnés.
L'outil PointArray place des copies d'une forme sélectionnée le long de divers points sélectionnés.

The PointArray tool can be used on 2D shapes created with the [[Draft Workbench]], but can also be used on many types of 3D objects such as those created with the [[Part Workbench|Part]], [[PartDesign Workbench|PartDesign]], or [[Arch Workbench]]es.

To position copies in an orthogonal array use [[Draft Array]]; to position copies along a path use [[Draft PathArray]]; to create copies or clones, and manually place them use [[Draft Move]], [[Draft Rotate]], and [[Draft Clone]].


[[Image:Draft_PointArray_Example.png|400px]]
[[Image:Draft_PointArray_Example.png|400px]]
{{Caption|Object arranged at specific points}}


==Utilisation==
==Utilisation==


<div class="mw-translate-fuzzy">
# Créez un objet de forme que vous souhaitez distribuer. Vous obtiendrez les meilleurs résultats si votre objet est '''centré sur l'origine''', c'est-à-dire si sa {{PropertyData | position}} est [0, 0, 0].
# Créez un objet de forme que vous souhaitez distribuer. Vous obtiendrez les meilleurs résultats si votre objet est '''centré sur l'origine''', c'est-à-dire si sa {{PropertyData | position}} est [0, 0, 0].
# Placez les points en utilisant [[Draft Point]].
# Placez les points en utilisant [[Draft Point]].
# Sélectionnez les points et créez-en un composé à l'aide de [[Draft Upgrade]].
# Sélectionnez les points et créez-en un composé à l'aide de [[Draft Upgrade]].
# Sélectionnez d'abord votre forme, puis le nouveau point composé, puis appuyez sur le bouton {{KEY | [[Image: Draft_PointArray.svg | 16px]] [[Draft PointArray]]}}.
# Sélectionnez d'abord votre forme, puis le nouveau point composé, puis appuyez sur le bouton {{KEY | [[Image: Draft_PointArray.svg | 16px]] [[Draft PointArray]]}}.
</div>

To create a point compound select various [[Draft Point]]s and then press the {{Button|[[Image:Draft Upgrade.svg|16px]] [[Draft Upgrade]]}} button.

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.


==Options==
==Options==


<div class="mw-translate-fuzzy">
* Le tableau commence avec des copies de formes qui ne sont pas alignées sur le chemin, ni translatées vers un nouvel emplacement par défaut. Vous pouvez ensuite changer le nombre, l'alignement et/ou l'adaptation des vecteurs dans les propriétés.
* Le tableau commence avec des copies de formes qui ne sont pas alignées sur le chemin, ni translatées vers un nouvel emplacement par défaut. Vous pouvez ensuite changer le nombre, l'alignement et/ou l'adaptation des vecteurs dans les propriétés.
</div>


==Propriétés==
==Propriétés==


<div class="mw-translate-fuzzy">
* {{PropertyData | Base}}: l'objet de forme
* {{PropertyData | Base}}: l'objet de forme
* {{PropertyData | Count}}: nombre de fois que la forme a été copiée (lecture seule)
* {{PropertyData | Count}}: nombre de fois que la forme a été copiée (lecture seule)
* {{PropertyData | PointList}}: un composé de points
* {{PropertyData | PointList}}: un composé de points
</div>


<div class="mw-translate-fuzzy">
==Programmation==
==Programmation==
</div>


L'outil PointArray peut être utilisé à l'intérieur d'une [[macros/fr|macro]], et, à partir de la console [[Python]] , en utilisant la fonction suivante :
L'outil PointArray peut être utilisé à l'intérieur d'une [[macros/fr|macro]], et, à partir de la console [[Python]] , en utilisant la fonction suivante :

{{Code|code=
{{Code|code=
makePointArray(base, ptlst)
PointArray = makePointArray(base, ptlst)
}}
}}

<div class="mw-translate-fuzzy">
* {{incode | base}} est la forme à copier et {{incode | ptlst}} est un objet avec une géométrie, des liens ou des composants qui définissent la position des copies.
* {{incode | base}} est la forme à copier et {{incode | ptlst}} est un objet avec une géométrie, des liens ou des composants qui définissent la position des copies.
</div>


Exemple:
Exemple:
Line 45: Line 64:
import FreeCAD, Draft
import FreeCAD, Draft


poly = Draft.makePolygon(3, radius=500.0)
Polygon = Draft.makePolygon(3, radius=500.0)

p1 = Draft.makePoint(FreeCAD.Vector(1500, 0, 0))
p1 = Draft.makePoint(FreeCAD.Vector(1500, 0, 0))
p2 = Draft.makePoint(FreeCAD.Vector(2500, 0, 0))
p2 = Draft.makePoint(FreeCAD.Vector(2500, 0, 0))
p3 = Draft.makePoint(FreeCAD.Vector(2000, 1000, 0))
p3 = Draft.makePoint(FreeCAD.Vector(2000, 1000, 0))


# Create a compound of points
upg = Draft.upgrade([p1, p2, p3], delete=True)
addList, deleteList = Draft.upgrade([p1, p2, p3])
compound = upg[0][0] # Extract the compound from the list

# Extract the compound from the list
compound = addList[0]


array = Draft.makePointArray(poly, compound)
PointArray = Draft.makePointArray(Polygon, compound)
}}
}}


{{Draft Tools navi}}
==Notes d'utilisation==
{{Userdocnavi}}
* {{emphasis|in progress}}
{{clear}}

Revision as of 13:13, 8 January 2019

Draft PointArray

Menu location
Draft → PointArray
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
0.18
See also
Draft Array, Draft PathArray

Description

L'outil PointArray place des copies d'une forme sélectionnée le long de divers points sélectionnés.

The PointArray tool can be used on 2D shapes created with the Draft Workbench, but can also be used on many types of 3D objects such as those created with the Part, PartDesign, or Arch Workbenches.

To position copies in an orthogonal array use Draft Array; to position copies along a path use Draft PathArray; to create copies or clones, and manually place them use Draft Move, Draft Rotate, and Draft Clone.

Object arranged at specific points

Utilisation

  1. Créez un objet de forme que vous souhaitez distribuer. Vous obtiendrez les meilleurs résultats si votre objet est centré sur l'origine, c'est-à-dire si sa Données position est [0, 0, 0].
  2. Placez les points en utilisant Draft Point.
  3. Sélectionnez les points et créez-en un composé à l'aide de Draft Upgrade.
  4. Sélectionnez d'abord votre forme, puis le nouveau point composé, puis appuyez sur le bouton Draft PointArray.

To create a point compound select various Draft Points and then press the Draft Upgrade button.

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.

Options

  • Le tableau commence avec des copies de formes qui ne sont pas alignées sur le chemin, ni translatées vers un nouvel emplacement par défaut. Vous pouvez ensuite changer le nombre, l'alignement et/ou l'adaptation des vecteurs dans les propriétés.

Propriétés

  • Données Base: l'objet de forme
  • Données Count: nombre de fois que la forme a été copiée (lecture seule)
  • Données PointList: un composé de points

Programmation

L'outil PointArray peut être utilisé à l'intérieur d'une macro, et, à partir de la console Python , en utilisant la fonction suivante :

PointArray = makePointArray(base, ptlst)
  • base est la forme à copier et ptlst est un objet avec une géométrie, des liens ou des composants qui définissent la position des copies.

Exemple:

import FreeCAD, Draft

Polygon = Draft.makePolygon(3, radius=500.0)

p1 = Draft.makePoint(FreeCAD.Vector(1500, 0, 0))
p2 = Draft.makePoint(FreeCAD.Vector(2500, 0, 0))
p3 = Draft.makePoint(FreeCAD.Vector(2000, 1000, 0))

# Create a compound of points
addList, deleteList = Draft.upgrade([p1, p2, p3])

# Extract the compound from the list
compound = addList[0]

PointArray = Draft.makePointArray(Polygon, compound)