Draft Point/ru: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav
{{Docnav|[[Draft_BSpline|BSpline]]|[[Draft_ShapeString|ShapeString]]|[[Draft_Module|Draft]]|IconL=Draft_BSpline.svg |IconC=Workbench_Draft.svg|IconR=Draft_ShapeString.svg }}
|[[Draft_BSpline|BSpline]]
|[[Draft_ShapeString|ShapeString]]
|[[Draft_Module|Draft]]
|IconL=Draft_BSpline.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_ShapeString.svg
}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 14: Line 21:
==Description==
==Description==


The 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]] (only the color) set on the [[Draft Tray]].
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]].


[[Image:Draft_point_example.jpg|400px]]
[[Image:Draft_point_example.jpg|400px]]
{{Caption|A single point placed on the working plane}}
{{Caption|A single point placed on the working plane}}


==How to use==
==Usage==


# 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.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]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button.
# 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.


Line 37: Line 44:


==Scripting==
==Scripting==
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


The Point tool can be used in [[macros]] and from the [[Python]] console by using the following function:
The Point tool can be used in [[macros|macros]] and from the [[Python|]Python] console by using the following function:
{{Code|code=
{{Code|code=
Point = makePoint(X=0, Y=0, Z=0, color=None, name="Point", point_size=5)
Point = makePoint(X=0, Y=0, Z=0, color=None, name="Point", point_size=5)
Line 53: Line 60:
Example:
Example:
{{Code|code=
{{Code|code=
import random, FreeCAD, Draft
import FreeCAD
import Draft


Point1 = Draft.makePoint(1600, 1400, 0)
Point1 = Draft.makePoint(1600, 1400, 0)
Line 59: Line 67:
p2 = FreeCAD.Vector(-3200, 1800, 0)
p2 = FreeCAD.Vector(-3200, 1800, 0)
Point2 = Draft.makePoint(p2, color=(0.5, 0.3, 0.6), point_size=10)
Point2 = Draft.makePoint(p2, color=(0.5, 0.3, 0.6), point_size=10)
FreeCAD.ActiveDocument.recompute()
}}
Example:


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.
# Make a loop and create ten points with random coordinates that extend

# from -L to L on both X and Y. Also choose a random color and size.
{{Code|code=
import random
import FreeCAD
import Draft


# Change value to define the area covered by the points
L = 1000
L = 1000
centered = FreeCAD.Placement(FreeCAD.Vector(-L,-L,0), FreeCAD.Rotation())
centered = FreeCAD.Placement(FreeCAD.Vector(-L, -L, 0), FreeCAD.Rotation())
Rectangle = Draft.makeRectangle(2*L, 2*L, placement=centered)
Rectangle = Draft.makeRectangle(2*L, 2*L, placement=centered)
N = 10


for i in range(10):
for i in range(N):
x = 2*L*random.random() - L
x = 2*L*random.random() - L
y = 2*L*random.random() - L
y = 2*L*random.random() - L
Line 77: Line 92:
size = 15*random.random() + 5
size = 15*random.random() + 5
Draft.makePoint(x, y, z, color=(r, g, b), point_size=size)
Draft.makePoint(x, y, z, color=(r, g, b), point_size=size)

FreeCAD.ActiveDocument.recompute()
}}
}}


{{Docnav
{{Docnav|[[Draft_BSpline|BSpline]]|[[Draft_ShapeString|ShapeString]]|[[Draft_Module|Draft]]|IconL=Draft_BSpline.svg |IconC=Workbench_Draft.svg|IconR=Draft_ShapeString.svg }}
|[[Draft_BSpline|BSpline]]

|[[Draft_ShapeString|ShapeString]]
{{Draft Tools navi}}
|[[Draft_Module|Draft]]
|IconL=Draft_BSpline.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_ShapeString.svg
}}


{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 18:14, 22 February 2020

Draft Point

Системное название
Draft Point
Расположение в меню
Черчение -> Точка
Верстаки
Draft, Arch
Быстрые клавиши
P T
Представлено в версии
-
См. также
Нет

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

  1. Press the Draft Point button, or press P then T keys.
  2. 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

  • ДанныеX: the X coordinate of the point.
  • ДанныеY: the Y coordinate of the point.
  • ДанныеZ: 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 specified X, Y and Z coordinates, with units in millimeters. If no coordinates are given the point is created at the origin (0,0,0).
    • If X is a point defined by a FreeCAD.Vector, it is used.
  • 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 from 0 to 1.
  • 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()