Draft PointArray/tr
Menü konumu |
---|
Draft → PointArray |
Tezgahlar |
Draft, Arch |
Varsayılan kısayol |
Hiçbiri |
Versiyonda tanıtıldı |
0.18 |
Ayrıca bkz |
Draft Array, Draft PathArray |
Tanım
The Draft PointArray tool places copies of a selected shape along various selected points.
The PointArray tool can be used on any object that has a Part TopoShape, meaning 2D shapes created with the Draft Workbench, but also 3D solids created with other workbenches, for example, Part, PartDesign, or Arch.
- To create orthogonal, polar or circular arrays, use the corresponding
OrthoArray,
PolarArray, or
CircularArray tools.
- To position App Link copies at specified points use
PointLinkArray.
- To position copies along a path use
PathArray or
PathLinkArray.
- To create copies and manually place them use
Move or
Rotate.
- To create exact copies and manually place or scale them, use
Clone or
Std LinkMake.
Object arranged at specific points
Usage
- Select the object that you wish to distribute.
- Select a point compound.
- Press the
PointArray 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.
Point compound
The point compound object can be created in different ways.
- Create various
Draft Points or
Part Points, and then press
Part Compound to create the compound.
- Repeat the previous method but instead of a compound use
Draft Upgrade to create a "Block".
- Create a
Sketch, and inside add various
Sketcher Points.
In essence, the object to be used as the compound must have one of three properties, DataComponents, DataLinks, or DataGeometry, and inside that compound, there must be at least one point with DataX, DataY, and DataZ properties.
Note: in the case of Draft Point and
Part Point the array will try to position the copies using the DataPlacement of the point. In the case of a
Sketcher Point, the position will be taken from its internal
X
, Y
, and Z
attributes.
Note 2: for Draft Point its DataPlacement always follows the values of DataX, DataY, DataZ, so modifying these values is enough to produce the desired displacement. However, for
Part Point, the net displacement is given by the sum of DataPlacement with the vector with components DataX, DataY, and DataZ.
Options
There are no options for this tool. Either it works with the selected objects or not.
Properties
A PointArray is derived from a Part Feature (Part::Feature
class), therefore it shares all the latter's properties. In addition to the properties described in Part Feature, the PointArray has the following properties in the property editor.
Objects
- DataBase (
Link
): the object to duplicate; it must have a Part TopoShape. - DataCount (
Integer
): (read-only) specifies the number of copies in the array. This property is read-only because the number of copies is determined by the number of points inside of DataPoint Object. - DataExtra Placement (
Placement
): specifies an additional placement, translation and rotation, that will be applied to each copy in the array. Each copy normally appears with the same rotation as the DataBase object; with this property it is possible to provide additional rotation, or counter the original rotation, and make small adjustments to the position of the copies. introduced in version 0.19 - DataPoint Object (
Link
): specifies a compound object with points that indicate where the copies of the DataBase object will appear. The compound object needs to have one of DataLinks, DataComponents, or DataGeometry properties, and contain at least one element with DataX, DataY, and DataZ attributes.
Scripting
See also: Draft API and FreeCAD Scripting Basics.
The PointArray tool can be used in macros and from the Python console by using the following function:
Older call
point_array = makePointArray(base_object, point_object)
New call
point_array = make_point_array(base_object, point_object, extra=None):
- Creates a
"PointArray"
object from thebase_object
, by placing the copies in the points contained withinpoint_object
.point_object
should have one ofGeometry
,Links
, orComponents
attributes containing points.- Instead of a reference to an object,
base_object
andpoint_object
can also beLabels
(strings) of objects existing in the current document. extra
can be a fullApp.Placement
, or just anApp.Vector
orApp.Rotation
.
Example:
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()
- Temeller: Koordinat, Kısıtlama, Yakalama (Yakın, Extension, Paralel, Izgara, Endpoint, Midpoint, Perpendicular, Angle, Center, Ortho, Intersection, Special, Dimensions, Working plane)
- Çizim: Çizgi, Tel, Çember, Yay, Elips, Çokgen, Dikdörtgen, Metin, Boyut, BSpline, Nokta, Şekil dizesi, Yüz kaplama, Bezier eğrisi, Etiket
- Değiştirme: Move, Rotate, Offset, Trimex, Upgrade, Downgrade, Scale, Edit, Wire to BSpline, Add point, Delete point, Shape 2D View, Draft to Sketch, Array, Path Array, Point Array, Clone, Drawing, Mirror, Stretch
- Araçlar: Set working plane, Finish line, Close line, Undo line, Toggle construction mode, Toggle continue mode, Apply style, Toggle display mode, Add to group, Select group contents, Toggle snap, Toggle grid, Show snap bar, Heal, Flip Dimension, VisGroup, Slope, AutoGroup, Set Working Plane Proxy, Add to Construction group
- Ek: Preferences, Import-Export Preferences (DXF/DWG, SVG, OCA, DAT); Draft API

- Kurulum: Windows, Linux, Mac; Başlamak
- Temeller: About FreeCAD, Workbenches, Preferences, Document structure, Interface Customization, Properties, Mouse Model; Tutorials
- Tezgahlar: Arch, Draft, FEM, Image, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Plot, Points, Raytracing, Reverse Engineering, Robot, Ship, Sketcher, Spreadsheet, Start, TechDraw, Surface workbench, Test Framework, Web
- Scripting: Introduction to Python, FreeCAD scripting tutorial, FreeCAD Scripting Basics, How to install macros, Gui Command, Units Modules: Builtin modules, Workbench creation, Installing more workbenches Meshes: Mesh Scripting, Mesh Module Parts: The Part Module, Topological data scripting, PythonOCC, Mesh to Part Coin scenegraph: The Coin/Inventor scenegraph, Pivy Qt interface: PySide, Using the FreeCAD GUI, Dialog creation Parametric objects: Scripted objects Other: Code snippets, Line drawing function, Embedding FreeCAD, FreeCAD vector math library, Power users hub, Python, Macros, FreeCAD Scripting Basics, Topological data scripting