kompas 0.4.0 (из f1ecc6ff5a923d524a7aa8dc7b97c538d9cf1bb3)

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

@@ -13,12 +13,12 @@
    ГОСТ не выйдет; планируешь чертёж — строй эскизы так, чтобы главный вид попадал на плоскость
    с наибольшей информацией.
 2. **`drawing_set_sheet_format`** (формат до видов — иначе виды придётся двигать), при
-   необходимости `drawing_add_sheet` для второго листа.
+   необходимости `drawing_set_sheet_format(add=true)` для второго листа.
 3. **`drawing_create_standard_views(views=[…], mainOrientation=…, hiddenLines=…)`** — бери ровно те
    проекции, которые нужны: лишний вид — лишнее место и лишний повод ошибиться видом. **Главный вид
    входит в набор сам**: перечисленные коды — это проекции ОТНОСИТЕЛЬНО него, поэтому `views=["top"]`
    даёт ДВА вида (главный и сверху). Ответ возвращает НОМЕРА видов, и дальше всё адресуется ими.
-4. **Координаты — замером, а не формулой.** `drawing_get_view_info(viewNumber)` отдаёт паспорт вида
+4. **Координаты — замером, а не формулой.** `describe_drawing(sections=view, viewNumber)` отдаёт паспорт вида
    одним вызовом: положение на листе, масштаб, габарит и — главное — локальную СК: куда попадает
    начало координат модели и куда смотрят её оси +X/+Y/+Z в координатах вида (нулевой орт = ось
    проекции, вдоль неё вид смотрит). Этого хватает, чтобы пересчитывать точки модели в вид
@@ -34,7 +34,7 @@
 6. **Размеры**, `drawing_add_axis` (осевые и центровые), шероховатость, выноски, техтребования,
    штамп. **Осевые сначала посмотри, потом добивай**: ассоциативные виды приходят со СВОИМИ
    центровыми и осевыми, которые КОМПАС ставит сам, и `drawing_add_axis` вслепую даёт дубли поверх
-   существующих. Сначала `list_drawing_objects(kind="axis"|"centreMarker", viewNumber=…)`.
+   существующих. Сначала `describe_drawing(kind="axis"|"centreMarker", viewNumber=…)`.
 7. **`drawing_export_image`** — посмотреть глазами. Пока картинки не было, чертёж не сдан.
 
 ## Разрез
@@ -48,16 +48,16 @@
   стенка полой детали. Невидимые линии — только намёк на то, что уже показано где-то ещё; размер к
   штриховой линии не привязывают.
 - **Веди линию с запасом за габарит** (плита 60 мм → от −40 до +40): линия по самому краю режет не
-  всю деталь. Координаты — в ЛСК БАЗОВОГО вида, её даёт `drawing_get_view_info`.
+  всю деталь. Координаты — в ЛСК БАЗОВОГО вида, её даёт `describe_drawing(sections=view)`.
 - **Строй разрез, когда модель готова**: после правки детали перестраивается только ПЕРВЫЙ разрез
   базового вида. Модель всё же изменилась — снеси разрезы и построй заново.
 - Сам разрез дальше — обычный вид: размеры и обозначения ставятся на него по его номеру.
 
 **Промах простановки лечится, а не остаётся навсегда.** Отката (undo) у чертежа нет, но
-`list_drawing_objects` показывает обозначения с индексами, `drawing_delete_object` убирает одно, а
+`describe_drawing` показывает обозначения с индексами, `drawing_delete(target=object)` убирает одно, а
 `drawing_move_object` его СДВИГАЕТ — слипшиеся тексты соседних размеров лечат именно сдвигом, а не
 заменой размера на выноску. Так же правится и компоновка: `drawing_move_view` переставляет вид со
-всеми обозначениями, `drawing_add_view` доносит недостающую проекцию, `drawing_delete_view` убирает
+всеми обозначениями, `drawing_create_standard_views(views=[])` доносит недостающую проекцию, `drawing_delete(target=view)` убирает
 лишнюю. Пересоздавать документ ради компоновки не нужно. Подробности адресации и порядок удаления —
 `help(topic="drawing-fixing")`.