---
title: "ksSaveAsToRasterFormat - Сохранить документ в растровом формате"
type: guide
api: [api7]
tags: [guide, api7, kssaveastorasterformat]
sources:
  - kssaveastorasterformat.html
---

*API экспортных функций > Функции экспорта документов *

Аналог данной функции при использовании Automation - метод ksDocument2D::SaveAsToRasterFormat.
Синтаксис:
```
int ksSaveAsToRasterFormat (reference sheet,
char * fileName,
RasterFormatParam * par);
Входные параметры:
sheet    - указатель на документ,
fileName    - полное имя файла документа,
par    - структура параметров записи в растровый формат.
Возвращаемое значение:
1    - в случае удачного завершения,
0    - в случае неудачи.
```
Примечания:
1. Метод позволяет сохранить присланный документ в растровом формате (BMP, GIF, JPG, PNG, TIF, TGA, PCX, EMF и WMF) с заданными свойствами.
Cохранение в WMF формат не поддерживается. При сохранении в WMF формате файл записывается в формате EMF.
2. Метод используется для чертежей, фрагментов, спецификаций, деталей и сборок.
3. Для трехмерной модели предварительно нужно получить reference, используя функцию ksGetReferenceFrom3dDocument для COM или свойство ksDocument3D::reference для Automation.
4. Если параметр sheet=0, сохраняется текущий документ.
5. При использовании Unicode следует использовать функцию ksSaveAsToRasterFormatW.