Draft Point: Difference between revisions
(Marked this version for translation) |
m (png to svg) |
||
(37 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
⚫ | |||
<translate> |
<translate> |
||
⚫ | |||
{{Docnav |
|||
|[[Draft_BSpline|BSpline]] |
|||
|[[Draft_ShapeString|ShapeString]] |
|||
|[[Draft_Module|Draft]] |
|||
|IconL=Draft_BSpline.svg |
|||
|IconC=Workbench_Draft.svg |
|||
|IconR=Draft_ShapeString.svg |
|||
}} |
|||
<!--T:1--> |
<!--T:1--> |
||
{{GuiCommand |
|||
⚫ | |||
|Name=Draft Point |
|||
|MenuLocation=Draft → Point |
|||
⚫ | |||
|Shortcut={{KEY|P}} {{KEY|T}} |
|||
|SeeAlso=[[Draft AddPoint|Draft AddPoint]], [[Draft Line|Draft Line]], [[Draft Wire|Draft Wire]] |
|||
|Version=0.7 |
|||
}} |
|||
==Description== <!--T:2--> |
==Description== <!--T:2--> |
||
<!--T:3--> |
<!--T:3--> |
||
The Point tool creates a simple point in the current [[Draft |
The {{Button|[[Image:Draft_Point.svg|16px]] [[Draft Point|Draft Point]]}} tool creates a simple point in the current [[Draft SelectPlane|work plane]], handy to serve as reference for placing lines, wires, or other objects later. It uses the [[Draft Linestyle|Draft Linestyle]] (only the color) set on the [[Draft Tray|Draft Tray]]. |
||
</translate> |
|||
⚫ | |||
[[Image:Draft_point_example.jpg|400px]] |
[[Image:Draft_point_example.jpg|400px]] |
||
<translate> |
|||
<!--T:4--> |
|||
{{Caption|A single point placed on the working plane}} |
|||
== |
==Usage== <!--T:5--> |
||
<!--T:6--> |
<!--T:6--> |
||
# Press the {{KEY|[[Image: |
# Press the {{KEY|[[Image:Draft_Point.svg|16px]] [[Draft Point|Draft Point]]}} button, or press {{KEY|P}} then {{KEY|T}} keys. |
||
# Click a point on the 3D view, or type a [[Draft_Coordinates|coordinate]] |
# Click a point on the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button. |
||
==Options== <!--T:7--> |
==Options== <!--T:7--> |
||
<!--T:8--> |
<!--T:8--> |
||
* To enter coordinates manually, simply enter the numbers, then press {{KEY| |
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. You can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button when you have the desired values to insert the point. |
||
* Press {{KEY|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 {{KEY| |
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command. |
||
==Properties== <!--T:9--> |
==Properties== <!--T:9--> |
||
<!--T:10--> |
<!--T:10--> |
||
* {{PropertyData|X}}: |
* {{PropertyData|X}}: the X coordinate of the point. |
||
* {{PropertyData|Y}}: |
* {{PropertyData|Y}}: the Y coordinate of the point. |
||
* {{PropertyData|Z}}: |
* {{PropertyData|Z}}: the Z coordinate of the point. |
||
==Scripting== <!--T:11--> |
==Scripting== <!--T:11--> |
||
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]]. |
|||
<!--T:12--> |
<!--T:12--> |
||
The Point tool can |
The Point tool can be used in [[macros|macros]] and from the [[Python|]Python] console by using the following function: |
||
</translate> |
</translate> |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
Point = makePoint(X=0, Y=0, Z=0, color=None, name="Point", point_size=5) |
|||
makePoint([x],[y],[z]) |
|||
Point = makePoint(point, Y=0, Z=0, color=None, name="Point", point_size=5) |
|||
</syntaxhighlight> |
|||
}} |
|||
<translate> |
<translate> |
||
<!--T:13--> |
<!--T:13--> |
||
* |
* Creates a {{incode|Point}} object in the specified {{incode|X}}, {{incode|Y}} and {{incode|Z}} coordinates, with units in millimeters. If no coordinates are given the point is created at the origin (0,0,0). |
||
** If {{incode|X}} is a {{incode|point}} defined by a {{incode|FreeCAD.Vector}}, it is used. |
|||
* {{incode|color}} is a tuple {{incode|(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 {{incode|0}} to {{incode|1}}. |
|||
* {{incode|name}} is the name of the object. |
|||
* {{incode|point_size}} is the size of the object in pixels, if the graphical user interface is loaded. |
|||
<!--T:19--> |
|||
Example: |
|||
</translate> |
|||
{{Code|code= |
|||
import FreeCAD |
|||
import Draft |
|||
⚫ | |||
p2 = FreeCAD.Vector(-3200, 1800, 0) |
|||
Point2 = Draft.makePoint(p2, color=(0.5, 0.3, 0.6), point_size=10) |
|||
FreeCAD.ActiveDocument.recompute() |
|||
}} |
|||
<translate> |
|||
<!--T:14--> |
<!--T:14--> |
||
Example: |
Example: |
||
<!--T:20--> |
|||
This code creates {{incode|N}} random points within a square of side {{incode|2L}}. It makes a loop creating {{incode|N}} points, that may appear anywhere from {{incode|-L}} to {{incode|+L}} on both X and Y; it also chooses a random color and size for each point. Change {{incode|N}} to change the number of points, and change {{incode|L}} to change the area covered by the points. |
|||
</translate> |
</translate> |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
import random |
|||
import FreeCAD |
|||
⚫ | |||
import Draft |
|||
</syntaxhighlight> |
|||
L = 1000 |
|||
centered = FreeCAD.Placement(FreeCAD.Vector(-L, -L, 0), FreeCAD.Rotation()) |
|||
Rectangle = Draft.makeRectangle(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.makePoint(x, y, z, color=(r, g, b), point_size=size) |
|||
FreeCAD.ActiveDocument.recompute() |
|||
}} |
|||
<translate> |
|||
<!--T:15--> |
|||
{{Docnav |
|||
|[[Draft_BSpline|BSpline]] |
|||
|[[Draft_ShapeString|ShapeString]] |
|||
|[[Draft_Module|Draft]] |
|||
|IconL=Draft_BSpline.svg |
|||
|IconC=Workbench_Draft.svg |
|||
|IconR=Draft_ShapeString.svg |
|||
}} |
|||
</translate> |
|||
{{Draft Tools navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
|||
{{clear}} |
{{clear}} |
||
⚫ |
Revision as of 04:36, 22 February 2020
Draft Point |
Menu location |
---|
Draft → Point |
Workbenches |
Draft, Arch |
Default shortcut |
P T |
Introduced in version |
0.7 |
See also |
Draft AddPoint, Draft Line, Draft Wire |
Description
The Draft 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.
A single point placed on the working plane
Usage
- 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. You can press the add point button when you have the desired values to insert the point.
- 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: Draft API and FreeCAD Scripting Basics.
The Point tool can be used in macros and from the [[Python|]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 FreeCAD
import 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)
FreeCAD.ActiveDocument.recompute()
Example:
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
to +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
import Draft
L = 1000
centered = FreeCAD.Placement(FreeCAD.Vector(-L, -L, 0), FreeCAD.Rotation())
Rectangle = Draft.makeRectangle(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.makePoint(x, y, z, color=(r, g, b), point_size=size)
FreeCAD.ActiveDocument.recompute()
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub