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>
54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
---
|
|
title: "ksInsertRaster - Вставить растровый объект"
|
|
type: guide
|
|
api: [api7]
|
|
tags: [guide, api7, ksinsertraster]
|
|
sources:
|
|
- ksinsertraster.html
|
|
---
|
|
|
|
*API экспортных функций > Функции работы с графическим документом > Создание графических объектов > Графические примитивы *
|
|
|
|
|
|
## ksInsertRaster - Вставить растровый объект
|
|
|
|
Пример...
|
|
Аналог данной функции при использовании Automation - метод ksDocument2D::ksInsertRaster.
|
|
Синтаксис:
|
|
```
|
|
reference ksInsertRaster (RasterParam *par);
|
|
Входной параметр:
|
|
par - Структура параметров растрового объекта RasterParam.
|
|
Возвращаемое значение:
|
|
указатель на растровый объект - в случае удачного завершения,
|
|
0 - в случае неудачи.
|
|
Примечание.
|
|
При использовании Unicode следует использовать функцию ksInsertRasterW.
|
|
```
|
|
|
|
|
|
## ksInsertRaster - Пример использования
|
|
|
|
RasterParam par; // параметры растрового обекта
|
|
par.place.xBase = 100; // точка привязки
|
|
par.place.yBase = 100;
|
|
par.place.ang = -20; // угол наклона
|
|
par.place.scale = 0.5; // масштаб
|
|
::strcpy (par.fileName, "C:\\BROWNBEAR.jpg"); // имя файла растра
|
|
::ksInsertRaster (&par); // вставка растрового объекта
|
|
reference iter = ::CreateIterator (RASTER_OBJ, 0); // создать итератор по растровым объектам
|
|
if (iter) {
|
|
reference obj = ::MoveIterator (iter, 'F'); // смещаемся на первый объект
|
|
if (::ExistObj(obj)) { // если объект существует
|
|
Message("Меняем файл"); // сообщение
|
|
::GetObjParam(obj, &par, sizeof(RasterParam), ALLPARAM);
|
|
// считываем параметры объекта
|
|
::strcpy(par.fileName, "C:\\WHITEBEAR.jpg"); // имя нового файла растра
|
|
par.place.ang = 0; // угол наклона
|
|
par.place.scale = 0; // масштаб
|
|
::SetObjParam (obj, &par, sizeof(RasterParam), ALLPARAM);
|
|
// изменяем параметры объекта
|
|
}
|
|
::DeleteIterator (iter); // удаляем итератор
|
|
}
|