Qinventor/docs/workflows.md

# Рабочие процессы QInventor

## Общая таблица параметров

Кнопка **3D-модель → Параметры** открывает параметры всего активного документа;
предварительно выделять деталь не нужно. Завершите редактирование эскиза или
панели операции перед применением таблицы.

Таблица показывает объект, имя параметра, единицы, формулу/значение,
вычисленный результат и комментарий. Она включает размеры эскизов, свойства
операций и нативные наборы переменных. Справочные и недоступные в текущем
режиме свойства доступны для чтения. Имена модельных свойств сохраняются для
стабильности выражений; пользовательские параметры можно переименовать.

1. Нажмите **Добавить параметр**, задайте имя, тип и значение. Поддерживаются
   длина, угол и безразмерное число; например `Width = 40 mm` и `Depth = 20 mm`.
2. В строке нужного размера введите выражение, например
   `QIUserParameters.Width / 2` для радиуса и `QIUserParameters.Depth` для
   длины выдавливания. Ссылку выбранной строки можно скопировать снизу окна.
   Параметры одного набора могут ссылаться друг на друга: `Width / 2`.
3. Нажмите **Применить**. Новые переменные и связи можно задать одним
   применением; модель перестраивается, изменения образуют один шаг отмены.
4. Исправьте поле в том же окне, если получена ошибка единиц, циклической
   зависимости, решателя или геометрии. Отклонённый набор сохраняет модель
   и историю Undo/Redo. Закрытие окна отбрасывает неприменённые правки.

Переименование пользовательской переменной обновляет её штатные зависимости.
Удаление используемого параметра отклоняется, пока его потребители не удалены
или не перевязаны в том же наборе изменений. Комментарии сохраняются в FCStd
и участвуют в отмене. Для связей между документами предварительно сохраните
оба проекта; внешние потребители пересчитываются вместе с источником.

Чертёж и его спецификация могут существовать до изменения параметров детали.
Обычные таблицы, управляющие геометрией, сохраняют свои связи; выходной лист
спецификации нельзя использовать как вход модели. Если изменение меняет тип
вычисленной ячейки таблицы, например с целого на дробное число, оно отклоняется
до применения: штатная отмена FreeCAD не восстанавливает такую ячейку корректно.
Формулы пользователя при этом сохраняются.

После изменения модели вне таблицы нажмите **Обновить**. Эта кнопка загружает
актуальные значения и сбрасывает неприменённые правки окна. Если в таблице
остались правки, применение устаревших строк блокируется с пояснением;
так старый индекс ограничения не изменит другой размер после правки эскиза.
Поиск скрывает строки, а удаление действует только на выбранную видимую строку.

## Размеры и эскизы

Создание эскиза — явная операция с выбором плоскости или плоской грани.
Редактор содержит геометрию и список ограничений; зелёная геометрия указывает
на полностью определённый эскиз. Не фиксируйте всю геометрию вместо размеров,
если модель должна оставаться параметрической.

В рабочем месте QInventor дерево закреплено слева, размеры и задачи — справа.
Панели не перекрывают полотно. Кнопки **Завершить эскиз** и **Отменить эскиз**
находятся в нижней строке ленты и доступны независимо от прокрутки инструментов.
Завершение и отмена возвращают штатную камеру без повторного автоматического
вписывания; команды вида остаются на вкладке **Вид**.

Универсальный размер D выбирает длину, расстояние, угол или диаметр по
выбранной геометрии. Расположение курсора определяет горизонтальный,
вертикальный или наклонный размер; M переключает допустимые варианты.
Стрелка рядом с **Размер D** открывает явный выбор: горизонтальный,
вертикальный, длина, радиус, диаметр или угол. Справа в **Размеры эскиза**
показаны только размеры активного эскиза, их значения, формулы и тип связи.
Щелчок по строке подсвечивает размер; двойной щелчок или **Изменить размер**
открывает исходный редактор значения FreeCAD. Флажок **Скрытые** добавляет
скрытые размеры в список.
Управляющее ограничение изменяет эскиз; справочное только измеряет. В выражениях
доступна штатная система FreeCAD. Полностью определённые примеры имеют именованные
размеры «Длина», «Ширина», «Радиус» и связанные свойства заготовки. Имена свойств
`QILength` / `QIWidth` / `QIRadius` остаются стабильными для выражений.

Закончите текущий инструмент Esc, затем нажмите **Завершить эскиз**. Эта
кнопка сохраняет построение и выбирает профиль для следующей операции.
**Отменить эскиз** восстанавливает геометрию и зависимости существующего
эскиза до начала редактирования; при отмене нового эскиза удаляется только
новое построение. Имена ограничений отображаются по-русски. Внутренние
идентификаторы параметров остаются стабильными для выражений.
При редактировании существующего эскиза последующие операции пересчитываются.
Для пустого или незамкнутого профиля выдавливание сообщает причину ошибки.

**Проецировать геометрию** переносит выбранное ребро или все контуры грани
в открытый эскиз с сохранением связи с исходной деталью. Изменение исходной
геометрии обновляет проекцию. В обычном режиме замкнутый контур участвует
в профиле; режим **Вспомогательная** оставляет его для привязок и размеров.
**Разорвать связь** превращает выбранную проекцию в независимую геометрию,
сохраняя её текущую форму и связанные ограничения. Для проекции целой грани
связь разрывается сразу для всех её контуров. Действие поддерживает отмену.

В блоке **Изменить** находятся **Смещение геометрии**, **Зеркальное отражение**,
**Прямоугольный массив**, **Круговой массив** и **Параметры повторений**.
Сначала выберите геометрию открытого эскиза; Ctrl добавляет элементы к выбору.
Диалог содержит русские поля, **Предпросмотр**, **Создать** и **Отмена**.
Повторный предпросмотр заменяет предыдущий вариант. Отмена возвращает
геометрию, зависимости, историю отмены и исходный признак сохранения.
Подтверждение создаёт один шаг отмены.

Смещение поддерживает окружность, отдельный отрезок и выпуклый замкнутый
контур из отрезков. **Выбирать связанный замкнутый контур** расширяет выбор
по совпадающим концам линий; для отдельного отрезка отключите этот флажок.
Положительное расстояние расширяет окружность и контур, отрицательное
уменьшает. Для отдельного отрезка положительное расстояние означает левую
сторону в направлении от начала к концу. **Сохранить равное расстояние**
связывает результат с исходной геометрией; без флажка получается независимая
копия. Размер смещения остаётся настоящим управляющим ограничением эскиза.
Дуги, сплайны, вогнутые и открытые многосегментные цепочки пока не поддерживаются.

Связанные зеркала и массивы поддерживают отрезки и окружности. Ось зеркала —
горизонтальная/вертикальная ось эскиза или его отрезок, в том числе
вспомогательный. Если линия зеркала была включена в выбор, она служит осью
и не копируется. Количество массива включает исходную геометрию.
Прямоугольный массив задаётся количеством и шагом в двух перпендикулярных
направлениях; угол поворачивает первое направление. Круговой массив задаётся
центром, количеством и общим углом. При 360° экземпляры равномерно распределены
по окружности без повторения исходника; при меньшем угле они включают оба
конца сектора. Отрицательные шаг или угол меняют сторону повторения.
Изменение размеров исходной геометрии обновляет копии, в том числе после
сохранения и повторного открытия FCStd.

**Параметры повторений** позволяет изменить уже созданную операцию.
Шаг, угол и центр остаются редактируемыми через её управляющие размеры.
Изменение количества или оси зеркала требует перестроения: оно разрешено,
пока после операции не добавлена другая геометрия и её экземпляры не используются
сторонними зависимостями. При нарушении этих условий приложение сообщает
причину и сохраняет модель. Режим общей длины массива, подавление отдельных
экземпляров и неортогональные направления пока не реализованы.
Если управляющий размер связан формулой, числовой диалог не заменяет эту
формулу и не перестраивает количество с потерей связи. Изменяйте выражение
в редакторе ограничений эскиза; несвязанные поля операции остаются доступными.

## Деталь

Операции применяются к активному телу детали (Body). Для выреза профиль должен пересекать
тело. Объединение должно давать одно связное твёрдое тело; для независимой
геометрии выбирайте **Новое тело**. Вращение, отверстия, скругления и фаски
открывают собственные панели параметров CAD-движка. Свойства операции и её
профиль доступны в дереве модели. Сохранение в FCStd сохраняет историю.

В **Выдавить** можно задать прямое, обратное, симметричное или двустороннее
направление. В двустороннем режиме длины независимы. Режимы завершения:
**По длине**, **Сквозь всё**, **До грани**, **До следующей**. Для **До грани**
выберите плоскую конечную грань; наклонная грань обрезает объём по своей
плоскости. **Продолжить грань** разрешает выход профиля за её края. Без этого
флажка вся геометрия должна укладываться в выбранную грань, включая отверстия.
**До следующей** ищет ближайшую плоскую грань, полностью перекрывающую профиль;
криволинейные и неоднозначные опоры вызывают понятную ошибку. Изменение опоры
перестраивает операцию. Двойной щелчок по выдавливанию открывает его параметры.

## Сборка

Новая сборка создаёт объект встроенной среды сборок (Assembly) и группу соединений.
Добавьте компоненты из открытых документов, закрепите базовый компонент,
затем выберите компоненты/элементы соединения и нужный тип связи.
**Решить** пересчитывает сборку. Дополнительные типы соединений и симуляция
доступны в штатной среде сборок (Assembly). Пример сборки содержит закреплённую плиту,
неподвижный и вращающийся штифты, связанные экземпляры деталей и спецификацию.

### Спецификация и физические свойства

**Сборка → Спецификация** открывает состав документа без предварительного
выделения. Выберите весь документ или нужную сборку. **Сводная** показывает
конечные детали и их общее количество; **Структурная** сохраняет уровни
подсборок. Количество внутри родителя и количество во всей выбранной области
отображаются отдельно. Итоговая масса не складывает повторно массу родителя
и его дочерних строк.

Повторные экземпляры учитываются по реальным связям CAD. Одинаковые подписи
или обозначения разных исходников не объединяют их в одну деталь. Материал
и плотность берутся у конечных деталей; сборка из нескольких материалов
показывает суммарную массу и среднюю плотность. Скрытие компонента само по
себе не убирает его из состава.
Материал назначается конечной детали или её экземпляру. Для изменения
материалов сборки выбирайте входящие в неё детали.

После изменения геометрии или материалов нажмите **Обновить**. **Экспорт CSV**
пересчитывает выбранную область и сохраняет текущее представление. Ошибка
источника отклоняет экспорт до замены прежнего файла. **Масса и объём** доступна
для выбранной детали или сборки; для единственной сборки выделение не нужно.
При создании чертежа сборки из разных материалов поле материала основной
надписи указывает **См. спецификацию**.

## Чертёж

Создайте чертёж из существующей детали или сборки. QInventor добавляет
ассоциативные виды спереди, сверху и в изометрии на собственный русский A4.
Изменение модели обновляет проекции. Откройте страницу двойным щелчком,
выберите нужные рёбра вида и инструмент **Размер**. Полная среда чертежей (TechDraw)
содержит разрезы, выносные виды, аннотации и оформление. PDF/SVG/DXF сохраняют
лист; исходный проект FCStd сохраняет редактируемую страницу.

### Спецификация на листе

Откройте **Чертёж → Оформление → Спецификация на листе**. Если листов несколько,
выберите один в дереве; для единственного листа выделение не требуется.
Если листа ещё нет, сначала создайте чертёж. Завершите активное редактирование
детали или сборки перед работой с таблицей.

В окне показаны фактические источники проекций выбранного листа. Все проекции
должны показывать одну область состава. Спецификация относится к этой области;
посторонние детали документа в неё не добавляются. **Сводная — только детали**
показывает общее количество конечных деталей. **Структурная — состав сборок**
сохраняет позиции подсборок, количество внутри родителя и общее количество.
Итоговая масса учитывает конечные экземпляры один раз.

Проверьте строки и нажмите **Разместить на листе**. Для существующей таблицы
кнопка называется **Обновить на листе**. **Обновить предпросмотр** перечитывает
источники и строки перед применением. **Закрыть** или Esc отменяют неприменённые
изменения; уже применённое изменение можно отменить Ctrl+Z и повторить Ctrl+Y.

После перестроения модели таблица на листе пересчитывает состав и массу.
Для просмотра актуальных строк в открытом окне нажмите **Обновить предпросмотр**.
Если источники проекций изменены, проверьте новый состав и явно обновите таблицу.
Проект FCStd сохраняет таблицу и её связи. **Экспорт чертежа** сохраняет весь лист
в PDF/SVG; DXF содержит проекции, сетку таблицы и редактируемые текстовые строки.
Ошибка модели или таблицы отклоняет экспорт и сохраняет прежний файл.

На штатном A4 помещаются до **4 строк состава в сводном** или **5 в структурном**
режиме. Заголовок и строка «Итого» в это число не входят. Длинный текст также
должен помещаться в столбцах, а проекции не должны перекрывать таблицу.
При переполнении сократите область состава или
текст исходных обозначений/наименований; приложение сохраняет прежнюю таблицу.

## Обмен и восстановление

STEP / IGES передают точную геометрию, но не историю эскизов другого CAD.
STL — треугольная сетка. Пользовательские настройки отдельны от установленных
на компьютере сред FreeCAD. Резервные FCStd1/FCBak управляются CAD-движком.
Экспорт учитывает мировое размещение выбранной детали или сборки, включая
преобразования родительских контейнеров. STEP сохраняет физические элементы
массива; BREP, IGES и STL учитывают его маску элементов. Явно выбранный скрытый
элемент экспортируется отдельно. Если маска не оставляет геометрии, экспорт
геометрического формата отклоняется. Ошибка записи сохраняет прежний файл.
Если приложение не запускается, сохраните `logs/launcher.log` и `logs/cad.log`.