mikhail
e1337e4016
docs/Kompas3D_SDK/ становится каноническим источником справки КОМПАС SDK и включается в репозиторий (2491 файл, ~14 МБ). HTML-зеркало docs/KOMPAS_SDK_ru-RU/ (~1.4 ГБ, © АСКОН) и генератор tools/build_kompas3d_sdk.py больше не нужны — регенерация не предполагается. - .gitignore: MD-база разблокирована; зеркало остаётся проигнорированным (safety-net на случай повторной локальной выгрузки). - CLAUDE.md / SKILL.md: убраны упоминания регенерации и зеркала. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
50 lines
2.8 KiB
Markdown
50 lines
2.8 KiB
Markdown
---
|
|
title: "ksClearRegion - Очистить указанную область"
|
|
type: guide
|
|
api: [api7]
|
|
domain: [drawing]
|
|
tags: [guide, api7, drawing, ksclearregion]
|
|
sources:
|
|
- ksclearregion.html
|
|
---
|
|
|
|
*API экспортных функций > Редактирование графических объектов > Функции редактирования объектов чертежа *
|
|
|
|
|
|
## ksClearRegion - Очистить указанную область
|
|
|
|
Пример...
|
|
Аналог данной функции при использовании Automation - метод ksDocument2D::ksClearRegion.
|
|
Синтаксис:
|
|
```
|
|
int ksClearRegion (reference grClear,
|
|
reference grRegion,
|
|
unsigned char inside);
|
|
Входные параметры:
|
|
grClear - группа обрабатываемых объектов (0 - просматривать все объекты текущего вида или выделенные, если они есть),
|
|
grRegion - группа объектов, задающая область очистки,
|
|
inside - место очистки: 0 - снаружи области, ограниченной grRegion, 1 - внутри области.
|
|
Возвращаемое значение:
|
|
1 - в случае удачного завершения,
|
|
0 - в случае неудачи.
|
|
```
|
|
Примечание:
|
|
При очистке объекты, которые пересекаются с границей области очистки, могут быть усечены или полностью удалены.
|
|
В зависимости от типа при усечении объекты изменяются (например, отрезок) или заменяются на новые объекты (например, окружность становится дугой).
|
|
Новые объекты, созданные в результате операции очистки, помещаются в группу обрабатываемых объектов.
|
|
Если группа временная, то для сохранения новых объектов в документе, для нее нужно выполнить функцию StoreTmpGroup.
|
|
|
|
|
|
## ksClearRegion - пример использования
|
|
|
|
reference gr = NewGroup(0); // группа геометрии, представляющая область очистки
|
|
::Circle(0, 0, 40, 1);
|
|
EndGroup();
|
|
reference gr1 = NewGroup(1); // группа геометрии, которую нужно очистить
|
|
::LineSeg(100, 100, -100, -100, 1);
|
|
::LineSeg(10, 10, -10, -10, 1);
|
|
EndGroup();
|
|
// очистка заданной области
|
|
::ksClearRegion(gr1/*группа которую надо очистить*/, gr/*область очистки*/, 1);
|
|
::StoreTmpGroup(gr1); // записываем результат в документ
|