|Drafting → Point|
|Introduced in version|
- There are several ways to invoke the command:
- The Point task panel opens. See Options for more information.
- Pick a point in the 3D view, or type coordinates and press the button.
The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.
- To manually enter coordinates enter the X, Y and Z component, and press 3D view before entering coordinates. after each. Or you can press the button when you have the desired values. It is advisable to move the pointer out of the
- Press working plane coordinate system. introduced in version 0.20 or click the Global checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the
- Press or click the Continue checkbox to toggle continue mode. If continue mode is on, the command will restart after finishing, allowing you to continue creating points.
- Press Draft snapping on or off. to switch
- Press or the button to abort the command.
- Use Draft Snap Near (version 0.20 and below) or Draft Snap Endpoint (version 1.0 and above) to snap to Draft points.
- To change the number of decimals used for the input of coordinates: Edit → Preferences... → General → Units → Units settings → Number of decimals.
See also: Property editor.
A Draft Point object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:
- DataX (
Distance): specifies the X coordinate of the point.
- DataY (
Distance): specifies the Y coordinate of the point.
- DataZ (
Distance): specifies the Z coordinate of the point.
- ViewPattern (
Enumeration): not used.
- ViewPattern Size (
Float): not used.
To create a Draft Point use the
make_point method (introduced in version 0.19) of the Draft module. This method replaces the deprecated
point = make_point(X=0, Y=0, Z=0, color=None, name="Point", point_size=5) point = make_point(point, Y=0, Z=0, color=None, name="Point", point_size=5)
- Creates a
pointobject in the specified
Zcoordinates, with units in millimeters. If no coordinates are given the point is created at the origin (0,0,0).
pointdefined by a
FreeCAD.Vector, it is used.
coloris 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 from
nameis the name of the object.
point_sizeis the size of the object in pixels, if the graphical user interface is loaded.
import FreeCAD as App import Draft doc = App.newDocument() point1 = Draft.make_point(1600, 1400, 0) p2 = App.Vector(-3200, 1800, 0) point2 = Draft.make_point(p2, color=(0.5, 0.3, 0.6), point_size=10) doc.recompute()
This code creates
N random points within a square of side
2L. It makes a loop creating
N points, that may appear anywhere from
+L on both X and Y. It also chooses a random color and size for each point. Change
N to change the number of points, and change
L to change the area covered by the points.
import random import FreeCAD as App import Draft doc = App.newDocument() L = 1000 centered = App.Placement(App.Vector(-L, -L, 0), App.Rotation()) rectangle = Draft.make_rectangle(2*L, 2*L, placement=centered) N = 10 for i in range(N): x = 2*L*random.random() - L y = 2*L*random.random() - L z = 0 r = random.random() g = random.random() b = random.random() size = 15*random.random() + 5 Draft.make_point(x, y, z, color=(r, g, b), point_size=size) doc.recompute()