SaveImage

SaveImage()

Синтаксис

Result = SaveImage(#Image , Filename$ [, ImagePlugin [, Flags [, Depth]]])

Описание

Сохраняет указанное Изображение на диск (в виде файла изображения).

Параметры

#Image Номер, идентифицирующий Изображение, которое требуется сохранить на диск.

Filename$ Имя файла, используемое для сохранения Изображения. Если имя файла не содержит полный путь, он интерпретируется относительно текущего каталога.
ImagePlugin (дополн.)
Формат сохранения изображения. Этот параметр может быть одним из следующих значений:
  #PB_ImagePlugin_BMP      : сохранит в формат BMP (по умолчанию)
  #PB_ImagePlugin_JPEG     : сохранит в формат JPEG (требуется UseJPEGImageEncoder())
  #PB_ImagePlugin_JPEG2000 : сохранит в формат JPEG2000 (требуется UseJPEG2000ImageEncoder())
  #PB_ImagePlugin_PNG      : сохранит в формат PNG (требуется UsePNGImageEncoder()). Для сохранения
                 изображения с прозрачностью используйте этот формат.
Flags (дополн.)
Параметры для подключаемого плагина изображений. На данный момент поддерживается только настройка качества: число от 0 (минимальное качество) до 10 (максимальное качество). В настоящее время поддерживаются только плагины JPEG и JPEG 2000 (по умолчанию для качества установлено значение "7", если флаги не указаны).

Когда изображение кодируется с использованием глубины палитры (1, 4 или 8), для комбинации доступен следующий флаг:
  #PB_Image_FloydSteinberg: Применение сглаживание Флойда-Штайнберга. 
Depth (дополн.) Глубина цвета для сохранённого изображения. Допустимые значения: 1, 4, 8, 24 и 32. Значение по умолчанию - это исходная глубина цвета изображения. Пока только кодеры BMP и кодеры PNG поддерживают формат палитры (1, 4 или 8 бит).

Возвращаемое значение

Возвращает не нулевое значение, если операция сохранения файла прошла успешно. Если сохранить файл не удалось - будет возвращён ноль, например была предпринята попытка перезаписи файла имеющего атрибут "только для чтения", или не загружен кодер, требуемый для данного типа файла, и тд.

Пример (Фран)

LoadImage(0, #PB_Compiler_Home+"Examples\Sources\Data\GeeBee2.bmp") ; Загрузить изображение из файла
SaveImage(0, GetTemporaryDirectory() + "ok.bmp") ; Сохранение

См. также

ImageDepth(), библиотека ImagePlugin

Поддерживаемые OS

Все

<- ResizeImage() - Оглавление Image - SetImageFrame() ->

#Image	Номер, идентифицирующий Изображение, которое требуется сохранить на диск.
Filename$	Имя файла, используемое для сохранения Изображения. Если имя файла не содержит полный путь, он интерпретируется относительно текущего каталога.
ImagePlugin (дополн.)	Формат сохранения изображения. Этот параметр может быть одним из следующих значений: #PB_ImagePlugin_BMP : сохранит в формат BMP (по умолчанию) #PB_ImagePlugin_JPEG : сохранит в формат JPEG (требуется UseJPEGImageEncoder()) #PB_ImagePlugin_JPEG2000 : сохранит в формат JPEG2000 (требуется UseJPEG2000ImageEncoder()) #PB_ImagePlugin_PNG : сохранит в формат PNG (требуется UsePNGImageEncoder()). Для сохранения изображения с прозрачностью используйте этот формат.
Flags (дополн.)	Параметры для подключаемого плагина изображений. На данный момент поддерживается только настройка качества: число от 0 (минимальное качество) до 10 (максимальное качество). В настоящее время поддерживаются только плагины JPEG и JPEG 2000 (по умолчанию для качества установлено значение "7", если флаги не указаны). Когда изображение кодируется с использованием глубины палитры (1, 4 или 8), для комбинации доступен следующий флаг: #PB_Image_FloydSteinberg: Применение сглаживание Флойда-Штайнберга.
Depth (дополн.)	Глубина цвета для сохранённого изображения. Допустимые значения: 1, 4, 8, 24 и 32. Значение по умолчанию - это исходная глубина цвета изображения. Пока только кодеры BMP и кодеры PNG поддерживают формат палитры (1, 4 или 8 бит).