Files
kompas3d-mcp/docs/Kompas3D_SDK/guides/findobj.md
T
mikhail e1337e4016 feat(sdk-docs): MD-база знаний SDK — в репозиторий; генератор и зеркало убраны
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>
2026-05-26 20:00:05 +03:00

2.8 KiB

title, type, api, tags, sources
title type api tags sources
FindObj - Найти ближайший к заданной точке объект вида guide
api7
guide
api7
findobj
findobj.html

*API экспортных функций > Функции работы с графическим документом  > Навигация по графическому документу  > Функции навигации *

FindObj - Найти ближайший к заданной точке объект вида

Пример... Аналог данной функции при использовании Automation - метод ksDocument2D::ksFindObj. Синтаксис:

reference FindObj (double x,
double y,
double dist);
Входные параметры:
x, y    - координаты точки,
dist    - размер стороны квадрата-"ловушки" с центром в указанной точке.
Возвращаемое значение:
указатель на найденный объект вида    - в случае успешного завершения,
0    - в случае неудачи.

Примечание:

  1. Зона поиска - квадрат с указанной стороной и центром.
  2. Если значение dist равно MAXDOUBLE, выполняется поиск ближайшего к указанной точке объекта без ограничения зоны поиска.
  3. Функцию FindObj можно использовать для поиска объектов внутри макроэлемента. Для этого макроэлемент должен быть открыт на редактирование функцией ksOpenMacro. Пример:
ksOpenMacro(obj);
long obj_i=FindObj(x, y, AXIS_FIND_SENS);
if( ExistObj(obj_i) )
LightObj(obj_i, 1);
EndObj();
При этом, если для макроэлемента задана система координат (см. SetMacroPlacement), то координаты в FindObj должны передаваться в системе координат макроэлемента.
Пересчитать координаты в систему координат макроэлемента можно через функцию ksPointIntoMtr. Для этого нужно функцией ksMtr создать матрицу преобразования координат.

Пример:

ksMtr(xp, yp, ang, 1,1); // xp, yp, ang, scaleX, scaleY, - параметры Placement макроэлемента.
ksPointIntoMtr (x, y, &xn, &yn);
EndMtr();

FindObj - пример использования

{ reference pLine; LineSeg(0, 0, 50, 50, 1); LineSeg(50, 50, 70, 20, 1); pLine = FindObj(20, 20, 5); LightObj(pLine, 1); }