Draft Point
Draft Point |
Menu location |
---|
Draft → Point |
Workbenches |
Draft, Arch |
Default shortcut |
P T |
Introduced in version |
- |
See also |
Draft Line, Draft Wire |
Description
The Point tool creates a simple point in the current work plane, handy to serve as reference for placing lines, wires, or other objects later. It uses the Draft Linestyle (only the color) set on the Draft Tray.
How to use
- Press the Draft Point button, or press P then T keys.
- Click a point on the 3D view, or type a coordinate and press the add point button.
Options
- To enter coordinates manually, simply enter the numbers, then press Enter between each X, Y and Z component.
- Press T or click the checkbox to toggle continue mode. If continue mode is on, the point tool will restart after you place a point, allowing you to place another one without pressing the tool button again.
- Press Esc or the Close button to abort the current command.
Properties
- DataX: The X coordinate of the point
- DataY: The Y coordinate of the point
- DataZ: The Z coordinate of the point
Scripting
See also: FreeCAD Scripting Basics, Draft API, and the autogenerated API documentation.
The Point tool can be used in macros and from the Python console by using the following function:
Point = makePoint(X=0, Y=0, Z=0, color=None, name="Point", point_size=5)
Point = makePoint(point, Y=0, Z=0, color=None, name="Point", point_size=5)
- Creates a
Point
object in the specifiedX
,Y
andZ
coordinates, with units in millimeters. If no coordinates are given the point is created at the origin (0,0,0).- If
X
is apoint
defined by aFreeCAD.Vector
, it is used.
- If
color
is a tuple(R, G, B)
that indicates the color of the point in the RGB scale; each value in the tuple should be in the range from0
to1
.name
is the name of the object.point_size
is the size of the object in pixels, if the graphical user interface is loaded.
Example:
import random, FreeCAD, Draft
Point1 = Draft.makePoint(1600, 1400, 0)
p2 = FreeCAD.Vector(-3200, 1800, 0)
Point2 = Draft.makePoint(p2, color=(0.5, 0.3, 0.6), point_size=10)
centered = FreeCAD.Placement(FreeCAD.Vector(-2000,-2000,0), FreeCAD.Rotation())
rect = Draft.makeRectangle(4000, 4000, placement=centered)
# Create ten points with random coordinates, color, and size, inside an area of 2 m x 2 m
for i in range(10):
x = 4000*random.random() - 2000
y = 4000*random.random() - 2000
z = 0
r = random.random()
g = random.random()
b = random.random()
size = 15*random.random() + 5
Draft.makePoint(x, y, z, color=(r, g, b), point_size=size)