kompas-plugin/plugin/skills/kompas-3d/reference/drawing-playbook.md

Чертёж: оформить деталь по ГОСТ

Дополнение к SKILL.md — методика оформления 2D-чертежа. Чертёж строится не так, как деталь: авто-валидации здесь нет. Правило трёх проверок из SKILL.md §«Два правила прежде всего» в 2D не работает — операция не отчитывается «построилось верно», потому что верность тут не про геометрию, а про место на листе. Проверять приходится самому, и способ ровно один: посмотреть.

Порядок, который окупается:

1. Деталь строится в чертёжной ориентации. Набор видов задаётся ОТ модели: mainOrientation выбирает, какую ориентацию модели показывает главный вид, но саму ориентацию модели он не вращает. Если самая информативная проекция детали — не одна из шести стандартных, чертежа по ГОСТ не выйдет; планируешь чертёж — строй эскизы так, чтобы главный вид попадал на плоскость с наибольшей информацией.
2. drawing_set_sheet_format (формат до видов — иначе виды придётся двигать), при необходимости drawing_add_sheet для второго листа.
3. drawing_create_standard_views(views=[…], mainOrientation=…, hiddenLines=…) — бери ровно те проекции, которые нужны: лишний вид — лишнее место и лишний повод ошибиться видом. Главный вид входит в набор сам: перечисленные коды — это проекции ОТНОСИТЕЛЬНО него, поэтому views=["top"] даёт ДВА вида (главный и сверху). Ответ возвращает НОМЕРА видов, и дальше всё адресуется ими.
4. Координаты — замером, а не формулой. drawing_get_view_info(viewNumber) отдаёт паспорт вида одним вызовом: положение на листе, масштаб, габарит и — главное — локальную СК: куда попадает начало координат модели и куда смотрят её оси +X/+Y/+Z в координатах вида (нулевой орт = ось проекции, вдоль неё вид смотрит). Этого хватает, чтобы пересчитывать точки модели в вид арифметикой; отдельные точки переводит drawing_project_point(x, y, z, viewNumber). Выводить оси из головы не надо и вредно: у КОМПАС «спереди» показывает плоскость XY детали, а «сверху» — X и минус Z, и знаки инверсии зависят от mainOrientation — формула, выведенная на одном чертеже, на соседнем врёт.
5. Разрез — до размеров, а не после. Внутреннюю геометрию (зенковка, ступенчатое отверстие, паз, глубокая расточка, полость) показывай разрезом, а не невидимыми линиями: по штриховой линии нельзя ни поставить нормальный размер, ни разобрать форму. drawing_add_section_view — см. §«Разрез» ниже. Размеры внутренней геометрии ставятся УЖЕ НА РАЗРЕЗЕ, поэтому строить его надо раньше простановки, иначе размеры придётся переносить.
6. Размеры, drawing_add_axis (осевые и центровые), шероховатость, выноски, техтребования, штамп. Осевые сначала посмотри, потом добивай: ассоциативные виды приходят со СВОИМИ центровыми и осевыми, которые КОМПАС ставит сам, и drawing_add_axis вслепую даёт дубли поверх существующих. Сначала list_drawing_objects(kind="axis"|"centreMarker", viewNumber=…).
7. drawing_export_image — посмотреть глазами. Пока картинки не было, чертёж не сдан.

Разрез

drawing_add_section_view делает всё сразу: проводит линию разреза на базовом виде и строит по ней производный вид со штриховкой. Механика, ступенчатый разрез и встроенная проверка честности — help(topic="drawing-sections"); здесь только решения, которые принимаешь ты:

• Разрез или hiddenLines. Разрез — когда внутреннее нужно ИЗМЕРИТЬ или показать форму: зенковка и цековка, ступенчатое или резьбовое отверстие, паз, канавка, глубокая расточка, тонкая стенка полой детали. Невидимые линии — только намёк на то, что уже показано где-то ещё; размер к штриховой линии не привязывают.
• Веди линию с запасом за габарит (плита 60 мм → от −40 до +40): линия по самому краю режет не всю деталь. Координаты — в ЛСК БАЗОВОГО вида, её даёт drawing_get_view_info.
• Строй разрез, когда модель готова: после правки детали перестраивается только ПЕРВЫЙ разрез базового вида. Модель всё же изменилась — снеси разрезы и построй заново.
• Сам разрез дальше — обычный вид: размеры и обозначения ставятся на него по его номеру.

Промах простановки лечится, а не остаётся навсегда. Отката (undo) у чертежа нет, но list_drawing_objects показывает обозначения с индексами, drawing_delete_object убирает одно, а drawing_move_object его СДВИГАЕТ — слипшиеся тексты соседних размеров лечат именно сдвигом, а не заменой размера на выноску. Так же правится и компоновка: drawing_move_view переставляет вид со всеми обозначениями, drawing_add_view доносит недостающую проекцию, drawing_delete_view убирает лишнюю. Пересоздавать документ ради компоновки не нужно. Подробности адресации и порядок удаления — help(topic="drawing-fixing").

Три вещи, на которых чертёж молча выходит неверным — держи их в голове, детали в справочнике:

• viewNumber=0 — это НЕ главный вид, а координаты ЛИСТА; знак, поставленный «на главном виде» с нулём, уезжает за границы формата (help(topic="drawing-views"));
• ассоциативны только диаметральный и радиальный размеры; линейный и угловой меряют координаты, и «60» останется, когда деталь станет 70 — после правки модели перепроверяй их сам (help(topic="drawing-dimensions"));
• допуск, не легший в размер, виден только по пустому read-back в ответе — техтребования его не заменят (help(topic="drawing-dimension-text")).

Ещё две ловушки, о которых узнаёшь только столкнувшись: штамп частично ведёт МОДЕЛЬ, а не чертёж (help(topic="drawing-title-block")), и у цилиндрической грани нет «координат оси» — её восстанавливают и проверяют сходимостью площадей (help(topic="cylinder-axis")).

Чего нет. Выносного элемента (увеличенный фрагмент), МЕСТНОГО разреза внутри вида, местного вида и вида с разрывом. Ассоциативного ЛИНЕЙНОГО размера нет и не будет: в API у него нет привязки к геометрии ни под каким именем (проверено QI, поздним связыванием и размером с обрывом). Экспорта в PDF/DXF тоже нет — наружу уходит растр (drawing_export_image) и STEP.