---
title: "ksTrimCurve - Усечь кривую, оставив часть между указанными точками"
type: guide
api: [api7]
domain: [drawing]
tags: [guide, api7, drawing, kstrimcurve]
sources:
  - kstrimcurve.html
---

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


## ksTrimCurve - Усечь кривую, оставив часть между указанными точками

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksTrimmCurve.
Синтаксис:
```
reference ksTrimCurve (reference curve,
double x1, double y1,
double x2, double y2,
double x3, double y3,
unsigned char deleteOldCurve);
Входные параметры:
curve    - указатель на усекаемую кривую,
x1, y1    - координаты начала оставляемого участка,
x2, y2    - координаты конца оставляемого участка,
x3, y3    - координаты точки, определяющей направление усечения для замкнутых кривых (эта точка принадлежит оставляемому участку),
deleteOldCurve    - признак удаления усекаемой кривой: 1 - кривая будет удалена после усечения, 0 - кривая не будет удалена после усечения.
Возвращаемое значение:
указатель на усеченную кривую    - в случае успеха,
0    - в случае неудачи.
```
Примечание:
Если указанные точки не лежат на кривой, то усечение производится по их проекциям на кривую.


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

reference iter = ::CreateIterator(ALL_OBJ, 0); // итератор по всем объектам
if (iter) {
reference obj = ::MoveIterator(iter, 'F'); // первый объект
// если объект геометрический - усечем его
if (::IsGeomObject(obj)) {
reference newCurve = ::ksTrimCurve(obj, 0, 20, 0, -20, 1, false);
if (newCurve) {
::LightObj(newCurve, 1); // подсветим объект
::Message ("Усекли кривую"); // выдадим сообщение
::LightObj(newCurve, 0); // погасим подсветку объекта
}
}
::DeleteIterator(iter); // удалить итератор
}
