---
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();
