Draft Point: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
Line 1: Line 1:
<translate>
<translate>
<!--T:1-->
{{GuiCommand|Name=Draft Point|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Point|Shortcut=P T}}
{{GuiCommand|Name=Draft Point|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Point|Shortcut=P T}}


==Description==
==Description== <!--T:2-->


<!--T:3-->
The Point tool creates a simple point in the current [[Draft Workingplane|work plane]], handy to serve as reference for placing other objects later. It takes the [[Draft Linestyle|color]] previously set on the Tasks tab.
The Point tool creates a simple point in the current [[Draft Workingplane|work plane]], handy to serve as reference for placing other objects later. It takes the [[Draft Linestyle|color]] previously set on the Tasks tab.


<!--T:4-->
[[Image:Draft_point_example.jpg|400px]]
[[Image:Draft_point_example.jpg|400px]]


==How to use==
==How to use== <!--T:5-->


<!--T:6-->
# Press the {{KEY|[[Image:Draft Point.png|16px]] [[Draft Point]]}} button, or press {{KEY|P}} then {{KEY|T}} keys
# Press the {{KEY|[[Image:Draft Point.png|16px]] [[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]]


==Options==
==Options== <!--T:7-->


<!--T:8-->
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button to abort the current Line command.
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button to abort the current Line command.


==Properties==
==Properties== <!--T:9-->


<!--T:10-->
* {{PropertyData|X}}: The X coordinate of the point
* {{PropertyData|X}}: The X coordinate of the point
* {{PropertyData|Y}}: The Y coordinate of the point
* {{PropertyData|Y}}: The Y coordinate of the point
* {{PropertyData|Z}}: The Z coordinate of the point
* {{PropertyData|Z}}: The Z coordinate of the point


==Scripting==
==Scripting== <!--T:11-->


<!--T:12-->
The Point tool can by used in [[macros]] and from the python console by using the following function:
The Point tool can by used in [[macros]] and from the python console by using the following function:
</translate>
</translate>
Line 32: Line 39:
</syntaxhighlight>
</syntaxhighlight>
<translate>
<translate>
<!--T:13-->
* makes a point at the given coordinates. If no X, Y and Z coordinates are given, the point is created at (0,0,0). Returns the newly created object.
* makes a point at the given coordinates. If no X, Y and Z coordinates are given, the point is created at (0,0,0). Returns the newly created object.


<!--T:14-->
Example:
Example:
</translate>
</translate>

Revision as of 13:51, 13 February 2014

Draft Point

Menu location
Draft -> Point
Workbenches
Draft, Arch
Default shortcut
P T
Introduced in version
-
See also
None

Description

The Point tool creates a simple point in the current work plane, handy to serve as reference for placing other objects later. It takes the color previously set on the Tasks tab.

How to use

  1. Press the Draft Point button, or press P then T keys
  2. Click a point on the 3D view, or type a coordinate

Options

  • To enter coordinates manually, simply enter the numbers, then press ENTER between each X, Y and Z component.
  • Press ESC or the Cancel button to abort the current Line command.

Properties

  • DataX: The X coordinate of the point
  • DataY: The Y coordinate of the point
  • DataZ: The Z coordinate of the point

Scripting

The Point tool can by used in macros and from the python console by using the following function:

 makePoint([x],[y],[z])
  • makes a point at the given coordinates. If no X, Y and Z coordinates are given, the point is created at (0,0,0). Returns the newly created object.

Example:

 import Draft
 Draft.makePoint(6,4,2)