FitImageAndRelease

Обработка изображений, макет страницы, оптимизация

Описание

Вписывает указанное изображение в целевой прямоугольник, сохраняя пропорции, применяя заданные выравнивание и поворот, затем освобождает дескриптор изображения из кэша изображений документа

Используйте этот помощник, когда пакетный генератор добавляет много одноразовых изображений, которые не должны оставаться выделяемыми после размещения

Синтаксис

Delphi

Function TPDFlib.FitImageAndRelease(ImageID: Integer; Left, Top, Width, Height: Double; HAlign, VAlign, Rotate: Integer): Integer;

ActiveX

Function PDFlib::FitImageAndRelease(ImageID As Long, Left As Double, Top As Double, Width As Double, Height As Double, HAlign As Long, VAlign As Long, Rotate As Long) As Long

DLL

int DLFitImageAndRelease(int InstanceID, int ImageID, double Left, double Top, double Width, double Height, int HAlign, int VAlign, int Rotate);

Параметры

ImageID	Дескриптор изображения, возвращаемый функцией создания или импорта изображения
Left	Горизонтальная координата целевого прямоугольника
Top	Вертикальная координата целевого прямоугольника
Width	Ширина целевого прямоугольника
Height	Высота целевого прямоугольника
HAlign	Горизонтальное выравнивание внутри прямоугольника: 0 — влево, 1 — по центру, 2 — вправо
VAlign	Вертикальное выравнивание внутри прямоугольника: 0 — вверх, 1 — по центру, 2 — вниз
Rotate	Режим поворота, где 0 нормально, 1 — 90 градусов против часовой стрелки, 2 — 90 градусов по часовой стрелке, 3 — 180 градусов

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

0	Дескриптор изображения недопустим, опция размещения вне диапазона, изображение не нарисовалось либо дескриптор не освободился
1	Изображение вписано, дескриптор освобождён

Примечания

Сохранённый PDF сохраняет объект изображения, поскольку словарь ресурсов страницы уже ссылается на него до освобождения дескриптора кэша

После успешного вызова SelectImage(ImageID) возвращает 0 для этого освобожденного дескриптора