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>
134 lines
4.9 KiB
Markdown
134 lines
4.9 KiB
Markdown
---
|
|
title: "Placement - Задать точку и угол"
|
|
type: guide
|
|
api: [api7]
|
|
tags: [guide, api7, placement]
|
|
sources:
|
|
- placement.html
|
|
---
|
|
|
|
*API экспортных функций > Функции работы с прикладной библиотекой > Функции ввода параметров *
|
|
|
|
|
|
## Placement - Задать точку и угол
|
|
|
|
Пример...
|
|
Аналог данной функции при использовании Automation - метод ksDocument2D::ksPlacement.
|
|
Синтаксис:
|
|
```
|
|
int Placement (RequestInfo *info, double *x, double *y, double *angle, void *phantom);
|
|
Входные параметры:
|
|
info - структуру параметров запроса к системе,
|
|
x,y - координаты введенной точки,
|
|
phantom - указатель на структуру управления фантомом, определяющую тип движения курсора,
|
|
angle - введенный угол.
|
|
Возвращаемое значение:
|
|
1 - в случае удачного завершения,
|
|
0 - в случае неудачи.
|
|
```
|
|
Примечание:
|
|
Возможные варианты (команды) задаются в строке commands структуры info и разделяются восклицательными знаками или пробелами. Если вместо строки в качестве параметра передать идентификатор меню из файла ресурсов, то соответствующее меню будет выдано в окне приглашений. Если в качестве адреса _callBack передается NULL, то действие функции прекращается после первого шага.
|
|
|
|
|
|
## Placement - Пример использования
|
|
|
|
#ifndef __MATH_H
|
|
#include <math.h>
|
|
#endif
|
|
#ifndef __LIBTOOL_H
|
|
#include <libtool.h>
|
|
#endif
|
|
int type, flag=0;
|
|
// Функция обратной связи, для выполнения цикла в Placement
|
|
int far __export pascal CallBackP (int com, double *x, double *y, double *angl,
|
|
RequestInfo *info, void *phantom, int /* dynamic*/) {
|
|
Phantom *valueub = (Phantom *)phantom;
|
|
switch (com) {
|
|
case 1:
|
|
case 2:
|
|
type = com;
|
|
break;
|
|
case -1: //поставить в модель
|
|
MoveObj(rub->type1.gr, *x, *y);
|
|
if(fabs(*angl) > 0.001)
|
|
RotateObj(rub->type1.gr, *x, *y, *angl);
|
|
StoryTmpGroup(rub->type1.gr); //поставить временную группу в вид
|
|
ClearGroup(rub->type1.gr);
|
|
break;
|
|
}
|
|
//группа для фантома должна быть временная и обновляться при изменении вида
|
|
// отрисовки
|
|
if (rub->type1.gr)
|
|
DeleteObj(rub->type1.gr);
|
|
rub->type1.gr = NewGroup(1); // временная группа
|
|
if((flag==1 && com==1)||(flag==2 && com==2))
|
|
type = 3;
|
|
//обновляется не только изображение но и меню для запроса
|
|
switch (type ) {
|
|
case 1:
|
|
Circle (0, 0, 20, 1);
|
|
info->commands = !Квадрат !Треугольник ;
|
|
flag = 1;
|
|
break;
|
|
case 2:
|
|
LineSeg(-10, 0, 10, 0, 1);
|
|
LineSeg(10, 0, 0, 20, 1);
|
|
LineSeg(0, 20, -10, 0, 1);
|
|
info->commands = !Окружность !Квадрат;
|
|
flag = 2;
|
|
break;
|
|
case 3:
|
|
LineSeg(-10, 0, 10, 0, 1);
|
|
LineSeg(10, 0, 10, 20, 1);
|
|
LineSeg(10, 20, -10, 20, 1);
|
|
LineSeg(-10, 20, -10, 0, 1);
|
|
info->commands = !Окружность !Треугольник;
|
|
flag = 0;
|
|
break;
|
|
}
|
|
EndGroup();
|
|
return 1;
|
|
}
|
|
void Placement_Example (void) {
|
|
type = 1;
|
|
int j = 1;
|
|
struct Phantom rub;
|
|
rub.type1.xBase = 0;
|
|
rub.type1.yBase = 0;
|
|
rub.type1.scale = 1;
|
|
rub.phType = 1;
|
|
rub.type1.ang = 0;
|
|
double x, y;
|
|
rub.type1.gr = NewGroup(1); // временная группа
|
|
Circle (0, 0, 20, 1);
|
|
EndGroup();
|
|
RequestInfo info;
|
|
memset(&info, 0, sizeof(info));
|
|
info.commands = "!Квадрат !Треугольник";
|
|
info.callBack = CallBackP;//указываем адрес функции обратной связи для Placement
|
|
Placement(&info, &x, &y, &rub.type1.ang, &rub);
|
|
}; /* Placement_Example*/
|
|
|
|
|
|
## Пример задания Placement детали
|
|
|
|
Последовательность установки направления осей задается абсолютными координатами направляющих векторов осей.
|
|
Для их задания нужно передавать сумму координат точки привязки и смещения.
|
|
// Получить указатель на интерфейс размещения детали
|
|
IPlacement *iPlacement = m_pPart->GetPlacement();
|
|
// Установить точку привязки:
|
|
iPlacement->SetOrigin(x, y, z);
|
|
// Установить направления осей:
|
|
iPlacement->SetAxis(
|
|
x 1,
|
|
y 0,
|
|
z 0,
|
|
0); // ось X
|
|
iPlacement->SetAxis(
|
|
x 0,
|
|
y 1,
|
|
z 0,
|
|
1); // ось Y
|
|
// Обновить Placement:
|
|
m_pPart->UpdatePlacement();
|