---
title: "ksMtr - Создать матрицу преобразования координат"
type: guide
api: [api7]
tags: [guide, api7, ksmtr]
sources:
  - ksmtr.html
---

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


## ksMtr - Создать матрицу преобразования координат

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksMtr.
Синтаксис:
```
int ksMtr (double x, double y,
double angle,
double scaleX,
double scaleY);
Входные параметры:
x, y    - координаты начала локальной системы координат,
angle    - угол наклона системы координат в градусах,
scaleX    - масштаб локальной системы координат по оси Х,
scaleY    - масштаб локальной системы координат по оси Y.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
1. Допускается вложение матриц трансформации. В результате вложения действует суммарная матрица, полученная произведением накопленных матриц.
2. Объекты вида, вводимые между операторами ksMtr и DeleteMtr, подвергаются преобразованию по суммарной матрице.


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

reference gr = NewGroup (0);
LineSeg (50, 50, 100, 100, 1);
LineSeg (100, 100, 150, 50, 1);
Circle (50, 50, 10, 1);
Circle (150, 50, 10, 1);
EndGroup ();
//масштаб по оси Х - 2 и по оси Y - 1
ksMtr (0, 0, 0, 2, 1);
TransformObj (gr);
DeleteMtr();
