Draft Text/ru: Difference between revisions

From FreeCAD Documentation
(Created page with "=== Вид === * {{PropertyView|Режим отображения}}: если это «3D текст», текст будет выровнен по осям сцены, изн...")
(Updating to match new version of source page)
 
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
<div class="mw-translate-fuzzy">
|[[Draft_Rectangle|Rectangle]]
{{Docnav/ru
|[[Draft_Dimension|Dimension]]
|[[Draft_ShapeString/ru|Фигура из текста]]
|[[Draft_Module|Draft]]
|[[Draft_Dimension/ru|Размер]]
|IconL=Draft_Rectangle.svg
|[[Draft_Workbench/ru|Верстак "Draft"]]
|IconL=Draft_ShapeString.svg
|IconR=Draft_Dimension.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
</div>


{{GuiCommand/ru
{{GuiCommand/ru
|Name=Draft Text
|Name/ru=Текст
|Name/ru=Текст
|Name=Draft_Text
|MenuLocation=Черчение → Текст
|MenuLocation=Annotation → Текст
|Workbenches=[[Draft_Module/ru|Черчение]], [[Arch_Module/ru|Архитектура]]
|Workbenches=[[Draft_Workbench/ru|Draft]], [[Arch_Workbench/ru|Arch]]
|Shortcut={{KEY|T}} {{KEY|E}}
|Shortcut={{KEY|T}} {{KEY|E}}
|Version=0.7
|Version=0.7
|SeeAlso=[[Draft_Label/ru|Draft Label]], [[Draft_ShapeString/ru|Draft ShapeString]]
|SeeAlso=[[Draft_Label/ru|Метка]], [[Draft_ShapeString/ru|Фигура из текста]]
}}
}}


==Description==
<span id="Description"></span>
==Описание==


<div class="mw-translate-fuzzy">
Инструмент {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text|Текст]]}} позволяет добавить в документ многострочную текстовую область в указанную точку. Он использует предварительно выбранный [[Draft_Linestyle/ru|Draft Linestyle]], установленный в [[Draft_Tray/ru|Draft Tray]].
Инструмент {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text|Текст]]}} позволяет добавить в документ многострочную текстовую область в указанную точку. Он использует предварительно выбранный [[Draft_Linestyle/ru|Draft Linestyle]], установленный в [[Draft_Tray/ru|Draft Tray]].
</div>


'''Alternatively:''' To create a text label with a leader and an arrow use [[Draft Label|Draft Label]]. To create solid text or 3D letters use [[Draft ShapeString|Draft ShapeString]] with [[Part Extrude|Part Extrude]].
To create a text element with an arrow use the [[Draft_Label|Draft Label]] command instead.


<div class="mw-translate-fuzzy">
[[Image:Draft_Text_example.png|400px]]
[[Image:Draft_Text_example.png|400px]]
{{Caption|Для размещения текстового поля требуется одна точка}}
{{Caption|Для размещения текстового поля требуется одна точка}}
</div>


<span id="Usage"></span>
'''Warning:''' The texts created with [[Release notes 0.18 |version 0.18]] are not backward compatible, so backup your work if you try to open files created with 0.18 with older versions.
==Применение==


See also: [[Draft_Tray|Draft Tray]] and [[Draft_Snap|Draft Snap]].
==Usage==


<div class="mw-translate-fuzzy">
==Использование==
# Нажмите кнопку {{Button|[[Image:Draft_Text.svg|16px]] [[Draft Text/ru|Текст]]}}, или нажмите клавишу {{KEY|T}}, а затем{{KEY|E}}
# Нажмите кнопку {{Button|[[Image:Draft_Text.svg|16px]] [[Draft Text/ru|Текст]]}}, или нажмите клавишу {{KEY|T}}, а затем{{KEY|E}}
# Укажите точку на трёхмерном виде или задайте [[Draft_Coordinates/ru|координаты]] и нажмите кнопку {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/ru|add point]]}}.
# Укажите точку на трёхмерном виде или задайте координаты и нажмите кнопку {{Button|[[Image:Draft_AddPoint.svg|16px]] add point}}.
# Введите желаемый текст нажимая {{KEY|Enter}} между каждыми строками
# Введите желаемый текст нажимая {{KEY|Enter}} между каждыми строками
# Дважды нажмите {{KEY|Enter}} для завершения.
# Дважды нажмите {{KEY|Enter}} для завершения.
</div>


<span id="Options"></span>
==Опции==
==Опции==


The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts (for version 0.22).
* Для указания координат вручную, введите число и нажимайте {{KEY|ENTER}} для перехода между координатами X, Y и Z. Вы можете нажать кнопку {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/ru|добавить точку]]}}, когда у вас есть нужные значения для вставки точки.

<div class="mw-translate-fuzzy">
* Для указания координат вручную, введите число и нажимайте {{KEY|ENTER}} для перехода между координатами X, Y и Z. Вы можете нажать кнопку {{Button|[[Image:Draft_AddPoint.svg|16px]] добавить точку}}, когда у вас есть нужные значения для вставки точки.
* Удерживайте {{KEY|Ctrl}} при размещении текста, чтобы принудительно установить [[Draft_Snap/ru|привязку]] вашей точки в ближайшее место привязки, независимо от расстояния.
* Удерживайте {{KEY|Ctrl}} при размещении текста, чтобы принудительно установить [[Draft_Snap/ru|привязку]] вашей точки в ближайшее место привязки, независимо от расстояния.
* Нажмите {{KEY|Enter}} или {{KEY|↓ Стрелка вниз}}, чтобы ввести новую строку текста.
* Нажмите {{KEY|Enter}} или {{KEY|↓ Стрелка вниз}}, чтобы ввести новую строку текста.
Line 46: Line 60:
* Дважды нажмите {{KEY|Enter}} или {{KEY|↓ Стрелка вниз}}, чтобы завершить редактирование текста.
* Дважды нажмите {{KEY|Enter}} или {{KEY|↓ Стрелка вниз}}, чтобы завершить редактирование текста.
* Нажмите {{KEY|Esc}} или кнопку {{Button|Close}}, чтобы прервать выполнение текущей команды.
* Нажмите {{KEY|Esc}} или кнопку {{Button|Close}}, чтобы прервать выполнение текущей команды.
</div>


<span id="Notes"></span>
==Примечания==

* A Draft Text can be edited by double-clicking it in the [[Tree_view|Tree view]]. {{Version|0.20}}
* Draft Texts created or saved with [[Release_notes_0.21|FreeCAD version 0.21]] are not backward compatible.

<span id="Properties"></span>
==Свойства==
==Свойства==


See also: [[Property_editor|Property editor]].

A Draft Text object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. The following properties are additional unless otherwise stated.

<span id="Data"></span>
=== Данные ===
=== Данные ===

* {{PropertyData|Текст}}: указывает содержимое текстового блока как список строк, каждый элемент списка, разделённый запятыми, показывает новую строку
{{TitleProperty|Основные}}

<div class="mw-translate-fuzzy">
* {{PropertyData|Положение}}: указывает базовую точку первой линии текстового блока.
* {{PropertyData|Положение}}: указывает базовую точку первой линии текстового блока.
* {{PropertyData|Текст}}: указывает содержимое текстового блока как список строк, каждый элемент списка, разделённый запятыми, показывает новую строку
* {{PropertyView|Поворот}}: указывает поворот базовой линии первой строки текстового блока.
</div>
* {{PropertyView|Ось поворота}}: указывает ось, используемую для поворота.


<span id="View"></span>
=== Вид ===
=== Вид ===

{{TitleProperty|Annotation}}

* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the text. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]].
* {{PropertyView|Scale Multiplier|Float}}: specifies the general scaling factor applied to the text.

{{TitleProperty|Display Options}}

* {{PropertyView|Display Mode|Enumeration}}: specifies how the text is displayed. If it is {{value|World}} the text will be displayed on a plane defined by its {{PropertyData|Placement}}. If it is {{value|Screen}} the text will always face the screen. This is an inherited property. The mentioned options are the renamed options ({{Version|0.21}}).

{{TitleProperty|Graphics}}

* {{PropertyView|Line Color|Color}}: not used.
* {{PropertyView|Line Width|Float}}: not used.

{{TitleProperty|Text}}

<div class="mw-translate-fuzzy">
* {{PropertyView|Режим отображения}}: если это «3D текст», текст будет выровнен по осям сцены, изначально лежащим в плоскости XY; если это «2D-текст», текст всегда будет смотреть в камеру.
* {{PropertyView|Режим отображения}}: если это «3D текст», текст будет выровнен по осям сцены, изначально лежащим в плоскости XY; если это «2D-текст», текст всегда будет смотреть в камеру.
* {{PropertyView|Шрифт}}: указывает шрифт для отображения текста. Может быть название шрифта, например "Arial", название стиля, например, "sans", "serif" или "mono", название семейства, например, "Arial,Helvetica,sans", или название со стилем, например "Arial:Bold". Если указанный шрифт не найден в системе, то будет использован основной.
* {{PropertyView|Шрифт}}: указывает шрифт для отображения текста. Может быть название шрифта, например "Arial", название стиля, например, "sans", "serif" или "mono", название семейства, например, "Arial,Helvetica,sans", или название со стилем, например "Arial:Bold". Если указанный шрифт не найден в системе, то будет использован основной.
Line 61: Line 110:
* {{PropertyView|Выравнивание}}: указывает выравнивание текста налево, направо или по центру от базовой точки.
* {{PropertyView|Выравнивание}}: указывает выравнивание текста налево, направо или по центру от базовой точки.
* {{PropertyView|Межстрочное расстояние}}: указывает расстояние между строк текста.
* {{PropertyView|Межстрочное расстояние}}: указывает расстояние между строк текста.
</div>

<span id="Scripting"></span>
==Программирование==

{{Emphasis|См. так же:}} [[Draft API/ru|Draft API]] и [[FreeCAD Scripting Basics|Основы составления скриптов FreeCAD]].


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Инструмент Текст может быть использован в [[macros/ru|макросах]] и из консоли [[Python/ru|Python]] следующими функциями:
==Сценарии==
Инструмент Текст может быть использован в [[macros/ru|макросах]] и из консоли Python следующими функциями:
</div>
</div>


The Text tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
{{Code|code=
{{Code|code=
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
text = make_text(string, placement=None, screen=False)
}}
}}

<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
* Создать объект {{incode|Text}} в {{incode|point}}, определённой как {{incode|FreeCAD.Vector}}.
* Создать текстовый объект в указанной точке, если задан вектор, содержащий строку или строки заданные в виде списка.
* {{incode|stringlist}} это строка, или список строк, если это список, каждый элемент показывается в отдельной строке.
* Используется текущий цвет, высота и шрифт текста из настроек.
* Если значение screenmode True, текст всегда ориентируется в направлении вида, иначе в плоскости XY.
* Если {{incode|screen}} равен {{incode|True}}, текст всегда ориентируется в направлении просмотра камеры, иначе выравнивается по осям сцены и лежит в плоскости XY.
* Возвращает новый созданный объект.
</div>
</div>


The placement of the {{incode|Text}} can be changed by overwriting its {{incode|Placement}} attribute, or by individually overwriting its {{incode|Placement.Base}} and {{incode|Placement.Rotation}} attributes.
The view properties of {{incode|text}} can be changed by overwriting its attributes; for example, overwrite {{incode|ViewObject.FontSize}} with the new size in millimeters.

The view properties of {{incode|Text}} can be changed by overwriting its attributes; for example, overwrite {{incode|ViewObject.FontSize}} with the new size in millimeters.


Пример:
Пример:

{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft

doc = App.newDocument()


p1 = FreeCAD.Vector(0, 0, 0)
t1 = "This is a sample text"
t1 = "This is a sample text"
p1 = App.Vector(0, 0, 0)


p2 = FreeCAD.Vector(1000, 1000, 0)
t2 = ["First line", "second line"]
t2 = ["First line", "second line"]
p2 = App.Vector(1000, 1000, 0)

text1 = Draft.make_text(t1, p1)
text2 = Draft.make_text(t2, p2)
text1.ViewObject.FontSize = 200
text2.ViewObject.FontSize = 200


Text1 = Draft.makeText(t1, point=p1)
zaxis = App.Vector(0, 0, 1)
Text2 = Draft.makeText(t2, point=p2)
Text1.ViewObject.FontSize = 200
Text2.ViewObject.FontSize = 200


p3 = FreeCAD.Vector(-1000, -500, 0)
t3 = ["Upside", "down"]
t3 = ["Upside", "down"]
p3 = App.Vector(-1000, -500, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 180))
text3 = Draft.make_text(t3, place3)
text3.ViewObject.FontSize = 200


doc.recompute()
Text3 = Draft.makeText(t3, point=p3)
Text3.ViewObject.FontSize = 200

ZAxis = FreeCAD.Vector(0, 0, 1)
place3 = FreeCAD.Placement(p3, FreeCAD.Rotation(ZAxis, 175))
Text3.Placement = place3

Text4 = Draft.makeText(t3, point=p3)
Text4.ViewObject.FontSize = 200
Text4.Placement.Rotation = FreeCAD.Rotation(ZAxis, -30)
}}
}}



{{Docnav
<div class="mw-translate-fuzzy">
|[[Draft_Rectangle|Rectangle]]
{{Docnav/ru
|[[Draft_Dimension|Dimension]]
|[[Draft_ShapeString/ru|Фигура из текста]]
|[[Draft_Module|Draft]]
|[[Draft_Dimension/ru|Размер]]
|IconL=Draft_Rectangle.svg
|[[Draft_Workbench/ru|Верстак "Draft"]]
|IconL=Draft_ShapeString.svg
|IconR=Draft_Dimension.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
</div>


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

Latest revision as of 05:03, 9 January 2024

Текст

Системное название
Draft_Text
Расположение в меню
Annotation → Текст
Верстаки
Draft, Arch
Быстрые клавиши
T E
Представлено в версии
0.7
См. также
Метка, Фигура из текста

Описание

Инструмент Текст позволяет добавить в документ многострочную текстовую область в указанную точку. Он использует предварительно выбранный Draft Linestyle, установленный в Draft Tray.

To create a text element with an arrow use the Draft Label command instead.

Для размещения текстового поля требуется одна точка

Применение

See also: Draft Tray and Draft Snap.

  1. Нажмите кнопку Текст, или нажмите клавишу T, а затемE
  2. Укажите точку на трёхмерном виде или задайте координаты и нажмите кнопку add point.
  3. Введите желаемый текст нажимая Enter между каждыми строками
  4. Дважды нажмите Enter для завершения.

Опции

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts (for version 0.22).

  • Для указания координат вручную, введите число и нажимайте ENTER для перехода между координатами X, Y и Z. Вы можете нажать кнопку добавить точку, когда у вас есть нужные значения для вставки точки.
  • Удерживайте Ctrl при размещении текста, чтобы принудительно установить привязку вашей точки в ближайшее место привязки, независимо от расстояния.
  • Нажмите Enter или ↓ Стрелка вниз, чтобы ввести новую строку текста.
  • Нажмите ↑ Стрелка вверх, чтобы отредактировать предыдущую строку текста.
  • Дважды нажмите Enter или ↓ Стрелка вниз, чтобы завершить редактирование текста.
  • Нажмите Esc или кнопку Close, чтобы прервать выполнение текущей команды.

Примечания

Свойства

See also: Property editor.

A Draft Text object is derived from an App FeaturePython object and inherits all its properties. The following properties are additional unless otherwise stated.

Данные

Основные

  • ДанныеПоложение: указывает базовую точку первой линии текстового блока.
  • ДанныеТекст: указывает содержимое текстового блока как список строк, каждый элемент списка, разделённый запятыми, показывает новую строку

Вид

Annotation

  • ВидAnnotation Style (Enumeration): specifies the annotation style applied to the text. See Draft AnnotationStyleEditor.
  • ВидScale Multiplier (Float): specifies the general scaling factor applied to the text.

Display Options

  • ВидDisplay Mode (Enumeration): specifies how the text is displayed. If it is World the text will be displayed on a plane defined by its ДанныеPlacement. If it is Screen the text will always face the screen. This is an inherited property. The mentioned options are the renamed options (introduced in version 0.21).

Graphics

  • ВидLine Color (Color): not used.
  • ВидLine Width (Float): not used.

Text

  • ВидРежим отображения: если это «3D текст», текст будет выровнен по осям сцены, изначально лежащим в плоскости XY; если это «2D-текст», текст всегда будет смотреть в камеру.
  • ВидШрифт: указывает шрифт для отображения текста. Может быть название шрифта, например "Arial", название стиля, например, "sans", "serif" или "mono", название семейства, например, "Arial,Helvetica,sans", или название со стилем, например "Arial:Bold". Если указанный шрифт не найден в системе, то будет использован основной.
  • ВидРазмер шрифта: указывает размер символов текста. Если текстовый объект создается в древе проекта, но текст не отображается, увеличивайте размер текста, пока он не станет видим.
  • ВидВыравнивание: указывает выравнивание текста налево, направо или по центру от базовой точки.
  • ВидМежстрочное расстояние: указывает расстояние между строк текста.

Программирование

См. так же: Draft API и Основы составления скриптов FreeCAD.

Инструмент Текст может быть использован в макросах и из консоли Python следующими функциями:

text = make_text(string, placement=None, screen=False)
  • Создать объект Text в point, определённой как FreeCAD.Vector.
  • stringlist это строка, или список строк, если это список, каждый элемент показывается в отдельной строке.
  • Если screen равен True, текст всегда ориентируется в направлении просмотра камеры, иначе выравнивается по осям сцены и лежит в плоскости XY.

The view properties of text can be changed by overwriting its attributes; for example, overwrite ViewObject.FontSize with the new size in millimeters.

Пример:

import FreeCAD as App
import Draft

doc = App.newDocument()

t1 = "This is a sample text"
p1 = App.Vector(0, 0, 0)

t2 = ["First line", "second line"]
p2 = App.Vector(1000, 1000, 0)

text1 = Draft.make_text(t1, p1)
text2 = Draft.make_text(t2, p2)
text1.ViewObject.FontSize = 200
text2.ViewObject.FontSize = 200

zaxis = App.Vector(0, 0, 1)

t3 = ["Upside", "down"]
p3 = App.Vector(-1000, -500, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 180))
text3 = Draft.make_text(t3, place3)
text3.ViewObject.FontSize = 200

doc.recompute()