|Draft → PointArray|
|Introduced in version|
|Draft Array, Draft PathArray|
Thetool places copies of a selected shape along various selected points.
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
- Select an object that you wish to distribute.
- Select a point compound.
- Press the button.
To create a point compound select various Draft Points and then press the 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.
There are no options for this tool. Either it works with the selected objects or not.
- DataBase: the object to duplicate.
- DataCount: (read-only) specifies the number of copies of the base object. This number will depend on the number of Draft Points in the compound.
- DataPointList: specifies a compound object with point objects that indicate where the copies of the DataBase object will appear.
The compound object needs to have a DataLinks, DataComponets, or DataGeometry attribute. Each of the objects inside the compound should be Draft Points that have DataX, DataY, and DataZ attributes. The compounds could be created with Part Compound (DataLinks attribute) or with Draft Upgrade (DataComponets attribute).
PointArray = makePointArray(base, ptlst)
- Creates a
PointArrayobject from the
baseobject, by placing the copies along
ptlstis an object with
Componentsattributes that define the position of the copies.
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 PointArray = Draft.makePointArray(Polygon, compound)