Rysunek Roboczy: Szyk z punktów
Draft PointArray |
Menu location |
---|
Modification → Array tools → Point array |
Workbenches |
Draft, Arch |
Default shortcut |
None |
Introduced in version |
0.18 |
See also |
Draft OrthoArray, Draft PolarArray, Draft CircularArray, Draft PathArray, Draft PathLinkArray, Draft PointLinkArray, Draft Clone |
Description
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, DANEComponents, DANELinks, or DANEGeometry, and inside that compound, there must be at least one point with DANEX, DANEY, and DANEZ properties.
Note: in the case of Draft Point and Part Point the array will try to position the copies using the DANEPlacement 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 DANEPlacement always follows the values of DANEX, DANEY, DANEZ, so modifying these values is enough to produce the desired displacement. However, for Part Point, the net displacement is given by the sum of DANEPlacement with the vector with components DANEX, DANEY, and DANEZ.
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
- DANEBase (
Link
): the object to duplicate; it must have a Part TopoShape. - DANECount (
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 DANEPoint Object. - DANEExtra 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 DANEBase 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 - DANEPoint Object (
Link
): specifies a compound object with points that indicate where the copies of the DANEBase object will appear. The compound object needs to have one of DANELinks, DANEComponents, or DANEGeometry properties, and contain at least one element with DANEX, DANEY, and DANEZ attributes.
Scripting
See also: Autogenerated API documentation 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()
- Kreślenie: Linia, Polilinia, Zaokrąglenie, Łuk, Łuk przez 3 punkty, Okrąg, Elipsa, Wielokąt foremny, Krzywa złożona, Krzywa Bezier'a, Punkt, Łącznik ścian, Kształt z tekstu, Kreskowanie, Prostokąt
- Adnotacje: Adnotacja wieloliniowa, Wymiarowanie, Etykieta, Edytor stylów adnotacji, Widżet skali anotacji
- Modyfikacja: Przesuń, Obróć, Skala, Odbicie lustrzane, Odsunięcie, Przytnij, Rozciągnij, Klonuj, Szyk, Szyk biegunowy, Szyk kołowy, Szyk po ścieżce, Szyk powiązań po ścieżce, Szyk z punktów, Szyk powiązań w punktach, Edycja, Podświetl element podrzędny, Połącz, Rozdziel, Ulepsz kształt, Rozbij obiekt na elementy, Polilinia na krzywą złożoną, Rysunek Roboczy do szkicu, Nachylenie, Obróć wymiar, Widok 2D kształtu
- Tacka narzędziowa: Wybór płaszczyzny, Ustaw styl, Przełącz tryb konstrukcyjny, Grupowanie automatyczne
- Przyciąganie: Przełącz przyciąganie, Przyciągnij do punktu końcowego, Przyciągnij do punktu środkowego, Przyciągnij do środka, Przyciągnij do kąta, Przyciąganie do punktu przecięcia, Przyciągnij prostopadle, Rozszerz, Przyciągnij równolegle, Przyciągnij specjalnie, Przyciąganie do najbliższego, Przyciągnij ortogonalnie, Przyciągnij do siatki, Przyciągnij do płaszczyzny roboczej, Przyciągnij do wymiaru, Pokaż / ukryj siatkę
- Różności: Zastosuj bieżący styl, Warstwa, Zarządzaj warstwami, Dodaj grupę o nazwie, Dodaj do grupy, Wybierz grupę, Dodaj do grupy konstrukcyjnej, Przełącz tryb wyświetlania, Pośrednia płaszczyzna robocza, Ulecz, Przełącz tryb kontynuacji, Pokaż przybornik przyciągania
- Dodatkowe:: Wiązania, Wypełnienie wzorem, Preferencje, Ustawienia Importu i Eksportu, DXF/DWG, SVG, OCA, DAT
- Menu podręczne:
- Kontener warstwy: Połącz duplikaty warstw, Dodaj warstwę
- Warstwa: Aktywuj warstwę, Zaznacz zawartość warstwy
- Pośrednia płaszczyzna robocza: Zapisz ujęcie widoku, Zapisz stan obiektów
- Jak zacząć
- Instalacja: Pobieranie programu, Windows, Linux, Mac, Dodatkowych komponentów, Docker, AppImage, Ubuntu Snap
- Podstawy: Informacje na temat FreeCAD, Interfejs użytkownika, Profil nawigacji myszką, Metody wyboru, Nazwa obiektu, Edytor ustawień, Środowiska pracy, Struktura dokumentu, Właściwości, Pomóż w rozwoju FreeCAD, Dotacje
- Pomoc: Poradniki, Wideo poradniki
- Środowiska pracy: Strona Startowa, Architektura, Assembly, CAM, Rysunek Roboczy, MES, Inspekcja, Siatka, OpenSCAD, Część, Projekt Części, Punkty, Inżynieria Wsteczna, Robot, Szkicownik, Arkusz Kalkulacyjny, Powierzchnia 3D, Rysunek Techniczny, Test Framework