Power users hub/ru

---

Это место, куда можно прийти, если вы опытный пользователь и хотите узнать больше о настройке и расширении FreeCAD.

FreeCAD расширяем с помощью кода Python, который запускается непосредственно в консоли Python или загружается из модулей при запуске. Это означает, что вы можете модифицировать FreeCAD без необходимости перекомпиляции программы. Например, вы можете:

• Создавать и изменять геометрию: вы можете создать новый вид объекта, либо с нуля, либо адаптировав существующий тип.
• Создавать собственные инструменты и команды: создать ваши собственные наборы инструментов, запускающих Ваш код .
• Изменять интерфейс: создать панель инструментов и пометить туда ваши инструменты, создавать специальные окна, панели или интерфейсы для взаимодействия с вашими инструментами.
• Изменять представление в графе сцены: В FreeCAD есть разделение процессов построения и вычисления геометрии и отрисовки этой геометрии на вашем экране. У Вас есть полный доступ к способу отображения содержимого на экране, поэтому вы можете изменить представление, взаимодействовать с ним, или добавить к ним пользовательское поведение.

Вы можете так же добавить пользовательские экранные виджеты, как например информационные, перетаскиватели (draggers), якоря (привязки) или временные объекты (для быстрого предпросмотра операции).

Если Вы хотите добавить содержимое на эти страницы, запросите аккаунт на wiki с правом редактирования на форуме, и читайте WikiPages насчёт общих рекомендаций, которым Вы должны следовать. Относительно прочих путей внести вклад в проект смотрите страницу Помочь FreeCAD.

Настройка FreeCAD

• Настройка Интерфейса: Начиная с начала: Панели инструментов и ярлыки
• Работа с макросами: Легкая запись часто повторяющихся задач или python кода
• Рецепты макросов
• Кастомизация панелей инструментов
• Установка дополнительных верстаков

Написание сценариев FreeCAD

Основы

• Введение в python - См. также другие учебники Python в нижней части этой страницы
• Учебник скриптов FreeCAD - Общий взгляд на написание скриптов на python в FreeCAD
• Основы написания сценариев для FreeCAD: Что сказать, основы ...
• Команды графического интерфейса : Добавление пользовательских команд в графический интерфейс
• Использование смешанных Единиц измерения в FreeCAD
• Профилирование кода Python

Модули

Функциональность FreeCAD разделена между модулями, работающими со своими типами данных и приложениями. У FreeCADа есть встроенные модули и модули расширения (plug-ins). Когда модули расширений установлены, они становятся доступны вам как встроенные модули. Описываемые ниже модули модули по умолчанию, включённые в любую установку FreeCAD.

• Встроенные модули это принципиальные модули FreeCAD. Они содержат инструменты для манипулирования общими конфигурациями FreeCAD, документами и их содержимым.
• Создание верстаков покажет Вам как создать собственных верстак.

Работа с полигиональными сетками

• Написание сценариев для Mesh: Как взаимодействовать с модулем Mesh

Работа с Parts

• Модуль Деталей: Как инструменты и структуры OpenCasCade используются в FreeCAD
• Сценарии для обработки топологических данных: Как взаимодействовать с модулем Part
• PythonOCC: Как раскрыть всю мощь OpenCasCade
• Mesh to Part: Преобразование между типами объектов

Получение доступа к отрисовщику сцен - Coin

• The Coin/Inventor scenegraph: Как работает представление сцен в FreeCAD
• Pivy: Как получить доступ и изменить графическое представление сцены

Управление Qt интерфейсом

• PySide: Как получить доступ к интерфейсу и изменить его содержание
• Использование FreeCAD GUI в различных Qt приложениях с помощью PyQt

Работа с параметрическими объектами

• Сценарные объекты: Как создать на 100% управляемые сценариями на python объекты в FreeCAD
  • Scripted objects with attachment:Как сделать скриптовые объекты присоединяемыми к другим объектам в FreeCAD
  • Scripted objects saving attributes: как сохранить и восстановить атрибуты промежуточного класса с __getstate__ и __setstate__.
  • Scripted objects migration: как мигрировать старые скриптовые объекты на новые классы.

Примеры

• Фрагменты кода: Коллекция фрагментов FreeCAD python кода, в качестве ингредиентов ваших сценариев...
• Функция отрисовки линии: Как собрать простой инструмент для отрисовки линий
• Создание диалога: Как сконструировать диалог в Qt designer, и использовать его в FreeCAD
• Встраивание FreeCAD: Как импортировать FreeCAD в виде python модуля в другие приложения
• Модуль черчениядобавляет основные функции 2d рисования в freecad. Он полностью написан на python, так что может быть хорошим примером если вы хотите писать ваши собственные модули.
• Векторная библиотека FreeCAD: Пара полезных функций для работы с векторами в FreeCAD. Эта библиотека также включена в Чертежный Модуль.

Функции API

Полное описание API можно найти в http://www.freecadweb.org/api/ . Он содержит программный интерфейс как на C++, так и на Python, и пока не совсем хорошо форматирован, что может мешать при просмотре кода Python. Более простая для просмотра версия доступна здесь. Заметим что он может быть неполным, так как обновляется вручную. Для получения более точной информации, просматривайте модули напрямую из консоли Python FreeCADа.

Связанное: Представление C++ в Python

Продвинутые модификации

• Запуск и настройка: Запуск и параметры командной строки
• Установка в Windows: Использование установщика windows
• Компиляция FreeCAD в Windows и компиляция FreeCAD в Linux
• Маркирование: Простые изменения, которые вы можете сделать с исходными кодами для изменения некоторых аспектов FreeCAD
• Дополнительные модули Python : Расширение интерпретатора python в FreeCAD этими мощными модулями!

Учебники по Python

Здесь представлены хорошие общие учебники, без специфики FreeCAD, они могут вас заинтересовать, если для вас python, это что-то свовершенно новое.

Python

• Официальный учебник python - весьма полный учебник для знакомства с Python
• Учебник по python для не программистов - отличная wikiкнига
• Python для новичков - один большой учебник, полностью охватывающий основы

PyQt - Как создавать и управлять FreeCADовским Qt UI интерфейсом с помощью python

• PySide tutorial : Платформонезависимый учебник, показывающий использование PySide с примерами
• PySide/PyQt tutorial : Легкий в чтении учебник по PySide и PyQt, с примерами
• Документация PySide : от проекта Qt (от тех, кто его написал)
• Использование QtCreator в PySide : так же от проекта Qt
• Справка по PySide : бесконечные детали о minutiae PySide и Qt, надежный источник для справки
• Примеры кода PySide : база данных кода PySide с возможностью поиска

Дальнейшие два ссылаются на специффичные для PyQt (не PySide), но могут предложить некоторую полезную информацию:

• Basic PyQt tutorial : Простое и короткое, ориентированное на linux руководство, объясняющее работу с PyQt и Qt Designer
• Programming Qt applications in python : Более глубокое руководство, описывающее все процессы работы с qt и python.

Pivy - Как взаимодействовать с в 3D сценой FreeCADа

• Pivy - Embedding a Dynamic Scripting Language into a Scene Graph Library : Тезис, подробно объясняющий Pivy
• High Level 3D Graphics Programming in Python : Примеры Pivy из Pycon 2004
• Introducing Pivy into studierstube (Mirror) : Документ, который на самом деле не учебник, но прекрасно иллюстрирует как работает Pivy (требует академический аккаунт)

Проекты сообщества

На портале Сообщества, вы можете найти другие основанные на FreeCAD проекты запущенные сообществом пользователей FreeCAD. Если вы начинаете новый проект FreeCAD, убедитесь что его нет в списке! У нас также есть страница, с описанием вещей, которые вы могли бы сделать, если хотите Помочь FreeCAD.

• Научная литература: статьи, которые по-разному ссылаются на систему FreeCAD или используют ее.

Power user documentation

• 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