Gui Command/ru: Difference between revisions
No edit summary |
(Updating to match new version of source page) |
||
(31 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
⚫ | |||
{{TOCright}} |
|||
⚫ | |||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
GuiCommand. Некоторые из атрибутов GuiCommand: |
|||
⚫ | |||
⚫ | |||
⚫ | |||
* Задано имя |
* Задано имя |
||
* Содержит иконку |
* Содержит иконку |
||
Line 10: | Line 13: | ||
* Записывается в макрос |
* Записывается в макрос |
||
* и.т.д... |
* и.т.д... |
||
</div> |
|||
== Naming == |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Назначение имен === |
=== Назначение имен === |
||
GuiCommand именуются определенным образом: ''ИмяМодуля_ИмяКоманды'' |
GuiCommand именуются определенным образом: ''ИмяМодуля_ИмяКоманды'' |
||
т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base( |
т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base (базовой системе). |
||
GuiCommand |
GuiCommand в определенном модуле получает имя имя модуля впереди, например "Part_Cylinder". |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Если документ не закончен(в смысле wiki статья) используйте шаблон [[Template:UnfinishedDocu]] |
Если документ не закончен (в смысле wiki статья) используйте шаблон [[Template:UnfinishedDocu]] |
||
</div> |
|||
== Help page == |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Страница справки === |
=== Страница справки === |
||
Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. |
Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. Статья имеет то же имя, что и GuiCommand, например, [[Draft ShapeString]]. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Чтобы создать ваши собственные справочные страницы используйте шаблон: |
Чтобы создать ваши собственные справочные страницы используйте шаблон: |
||
[[GuiCommand model]] |
[[GuiCommand model]] |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Примеры: |
Примеры: |
||
* [[ |
* [[Draft ShapeString]] |
||
* [[ |
* [[Draft Line]] |
||
</div> |
|||
* [[Std_Open]] |
|||
<div class="mw-translate-fuzzy"> |
|||
=== Иконки === |
=== Иконки === |
||
[[Image:Tango-Palette.png|400px|right]] |
[[Image:Tango-Palette.png|400px|right]] |
||
</div> |
|||
[[Image:Tango-Palette.png|400px|right]] |
|||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Предпочтительней всех, иконки нарисованные в SVG , например с помощью [http://inkscape.org Inkscape]. |
Предпочтительней всех, иконки нарисованные в SVG , например с помощью [http://inkscape.org Inkscape]. |
||
Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения. |
Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения. |
||
</div> |
|||
===Диаграмма цветового кодирования иконок=== |
|||
[[Image:Colorchart.png|200px]] |
|||
=== Требования к качеству === |
|||
Существует множество GuiCommands (Особенностей/Фишек) в FreeCAD которые являются экспериментальными или используются недолгое время для реализации целей. Эти GuiCommands в основном помещаются в инструментарии, такие как Part, Mesh или Cam. |
|||
Для обеспечения хорошей работы пользователя, был создан''Полный(Complete)'' инструментарий. Это инструментарий, который запускается по умолчанию при старте FreeCAD и он включает в себя все GuiCommand-ы, отвечающие '''Требованиям к качеству''' ,описанным здесь: |
|||
Мы стараемся насколько возможно следовать этой диаграмме, так что цвета иконок имеют прямое значение. |
|||
* Команда/Функция должна быть '''законченой'''. Никаких незавершенных работ! |
|||
* Должен иметь '''справочную страницу''' как [[Std ViewScreenShot|эта]] |
|||
** Все поля [[Template:GuiCommand]] должны быть заполнены |
|||
** Картинки с изображением диологов команды и конечный вывод |
|||
** детальное описание команды и всех её параметров и настроек |
|||
** Описание связанных python интерфесов и классов с примерами кода |
|||
* Настройка надлежащей иконки и позиции в меню |
|||
Надеюсь, что так будет со всеми GuiCommands из [[List of Commands|Списка команд]]. |
|||
{{ |
{{Powerdocnavi{{#translation:}}}} |
Latest revision as of 09:06, 16 August 2022
GuiCommand - одна из наиболее важных функций FreeCAD при взаимодействии с пользователем. Каждый раз, когда пользователь выбирает опцию в меню или нажимает на кнопку панели инструментов, активируется GuiCommand. Некоторые из атрибутов GuiCommand:
- Задано имя
- Содержит иконку
- Определена возможности для отмены/повтора
- Есть страница справки
- Открывает и управляет диалогами
- Записывается в макрос
- и.т.д...
Naming
Назначение имен
GuiCommand именуются определенным образом: ИмяМодуля_ИмяКоманды т.е. "Base_Open" это команда Открыть(Open) графического интерфейса в Base (базовой системе). GuiCommand в определенном модуле получает имя имя модуля впереди, например "Part_Cylinder".
Если документ не закончен (в смысле wiki статья) используйте шаблон Template:UnfinishedDocu
Help page
Страница справки
Каждая GuiCommand должна обладать страницей справки. Страница справки должна располагаться в FreeCAD wiki. Статья имеет то же имя, что и GuiCommand, например, Draft ShapeString.
Чтобы создать ваши собственные справочные страницы используйте шаблон: GuiCommand model
Примеры:
Иконки
Каждая GuiCommand-а должна иметь иконку. Мы используем Tango набор иконок и его принципы. Справа вы можете видеть палитру цветов tango.
Предпочтительней всех, иконки нарисованные в SVG , например с помощью Inkscape. Это упрощает добавление изменений и получение дополнительных Иконок в том же пространстве приложения.
Диаграмма цветового кодирования иконок
Мы стараемся насколько возможно следовать этой диаграмме, так что цвета иконок имеют прямое значение.
- FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules: Builtin modules, Units, Quantity
- Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros: Macros, How to install macros
- Embedding: Embedding FreeCAD, Embedding FreeCADGui
- Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)
- Hubs: User hub, Power users hub, Developer hub