Метод Clone

Клонирует объект картинки.

Синтаксис: THIS.Clone(toGpImage)

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

Параметры: 

toGpImage, требуемый, клонируемый объект на основе gpImage.

Метод CreateFromFile

Создает объект картинки из файла.

Синтаксис: THIS.CreateFromFile(tcFileName [, tlUseEmbeddedColorMgmt])

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

Параметры: 

tcFileName, требуемый, файл картинки, из которого будет создан объект image.

tlUseEmbeddedColorMgmt, необязательный, будет ли использовано вложенная обработка цвета.

Свойство Flags

Указывает флаги атрибутов для этой картинки, как целое число, вычисляемое как комбинация значений битов, с помощью опеделенных констант GDIPLUS_ImageFlags_*.

По умолчанию: пустое.

Метод GetBounds

Получает окамляющий прямоугольник в указанных единицах.

Синтаксис: THIS.GetBounds(tnUnits)

Возвращаемые значения: объект типа gpRectangle, или .NULL. в случае ошибки.

Параметры: 

tnUnits, требуемый, определяется в соответствии с набором констант GDIPLUS_Unit_*.

Метод GetDecoderCLSID

Получает CLSID для Decoder для указанного формата картинки(например, "image/jpeg").

Синтаксис: qCLSID = THIS.GetDecoderCSLID(tvSearchValue)

Возвращаемые значения: Varbinary, CLSID Decoder'а. В случае ошибки возвращает .NULL. .

Параметры: 

tvSearchValue, требуемый. Строка, содержащая MIME тип картинки (например "image/jpeg"), или varbinary GUID формата картинки, как определено константами GDIPLUS_IMAGEFORMAT_*.

Примечания: если для уканного типа картинки не найден decoder, или если предоставленный в параметре tvSearchValue формат картинки MIME типа или GUID не являются допустимыми, тогда эта функция возвращает .NULL., а метод GetStatus() вернет 0 ("нет ошибок").

Метод GetEncoderCLSID

Получает CLSID для encoder для указанного формата картинки (например, "image/jpeg").

Синтаксис: qCLSID = THIS.GetEncoderCSLID(tvSearchValue)

Возвращаемые значения: Varbinary, CLSID  encoder'а пригодный для посылки методу SaveToFile(). В случае ошибки возвращает .NULL. .

Параметры: 

tvSearchValue, требуемый. Строка, содержащая MIME тип картинки (например "image/jpeg"), или varbinary GUID формата картинки, как определено константами GDIPLUS_IMAGEFORMAT_*.

Примечания: если для уканного типа картинки не найден encoder, или если предоставленный в параметре tvSearchValue формат картинки MIME типа или GUID не являются допустимыми, тогда эта функция возвращает .NULL., а метод GetStatus() вернет 0 ("нет ошибок").

Метод GetPropertyCount

Получает число свойств, хранимых в метаданных этого объекта Image.

Синтаксис: nCount = THIS.GetPropertyCount()

Возвращаемые значения: целочисленный, число свойств мета-данных (который может быть и нулем). В случае ошибки возвращает .NULL. .

Параметры: нет.

Метод GetPropertyIdList

Получает список свойств, хранимых в метаданных этого объекта Image, в виде массива Visual FoxPro.

Синтаксис: nCount = THIS.GetPropertyIdList(@raPropIDList)

Возвращаемые значения: целочисленный, число свойств мета-данных (который может быть и нулем). В случае ошибки возвращает .NULL. . Значения ID свойства возвращается в массиве параметров raPropIDList.

Параметры:

raPropIDList, требуемый, массив посылаемый по ссылке. При возврате этот массив оразмеривается в одномерный массив, а каждый элемент массива содержит  целочисленное значение ID свойства .

Метод GetPropertyItem

Возвращает указанное своймства из мета-данных картинки.

Синтаксис: vPropertyValue = THIS.GetPropertyItem(tnPropID)

Returns: Значение свойства или null (.NULL.), если свойство не было найдено или в случае, если произошла ошибка. Тип данных зависит от типа тэга свойства, как показано ниже:

Типы свойства, не показанные выше не поддерживаются.

Параметры:

tnPropID, требуемый, целочисленный, элемент ID свойства, возвращаемый в GetPropertyIDList.

Примечания: Если запрашиваемое свойство не определено, этот метод вернет null (.NULL.), а метод GetStatus() возвратит 19 (GDIPLUS_STATUS_PropertyNotFound).

Метод GetThumbnailImage

Получает миниатюру картинки из объекта Image, возвращемую как новый gpObject Image.

Синтаксис: oImage= THIS.GetThumbnailImage(tnWidth, tnHeight)

Возвращаемые значения: gpObject Image, содержащий миниатюру. В случае ошибки возвращает .NULL. .

Параметры:

tnWidth, целочисленный, требуемый, желаемая ширина миниатюры картинки в пикселях.

tnHeight, целочисленный, требуемый, желаемая высота миниатюры картинки в пикселях.

Примечания: Некоторые файлы картинок имеют вложенные в них миниатюры. А таких случаях, этот метод извлекает вложенную картинку миниатюры, а значения параметров tnWidth и tnHeight игнорирурются. Если не имеется вложенной миниатюры, это метод создает ее путем масштабирования основной картинки в размеры, определенные параметрами tnWidth и tnHeight. Если оба параметра установлены в 0, то будут применены размеры, определяемые системой.

Свойство HorizontalResolution

Численное, горизонтальное разрешение в пикселях-на-дюйм. Только для чтения.

По умолчанию: нет.

Свойство ImageHeight

Высота этого объекта Image. Только для чтения.

По умолчанию: нет.

Свойство ImageWidth

Ширина этого объекта Image.. Только для чтения.

По умолчанию: нет.

Метод Init

Создает объект Image во время инициализации, если были получены соответствующие параметры.

Синтаксис: CREATEOBJECT("gpImage" [,tnHandle|tcFileName[, tlParam]])

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

Параметры: 

tnHandle | tcFilename, требуемый, если было затребовано немедленное создание объекта, графический дескритор или имя файла, из которого будет создана картинка.

tlParam, необязательный, определяет - будет ли класс обладать своим собственным графическим дескритором (если первый параметр представляет собой tnHandle) или должно ли использoваться управление цветом (если первый параметр представляет собой tcFileName).

Свойство PhysicalDimension

Поставляет ширину и высоту этого объекта Image, представленные как объект типа gpSize. Только для чтения.

По умолчанию: нет.

Примечания: Если картинка представляет собой bitmap, ширина и высота возвращются в пикселях. Если картинка представляет собой метафайл (metafile), ширина и высота возвращются  в единицах 0.01 millimeter.

Свойство PixelFormat

Пиксельный формат, в соответствии со значениями, определенные в  константах GP_PIXELFORMAT_*. Только для чтения.

По умолчанию: нет.

Примечания: может не применяться к некоторым объектам Image,  таким как картинки векторного формата.

Свойство RawFormat

Получает формат этой картинки, как GUID типа varbinary. Только для чтения.

По умолчанию: нет.

Метод RotateFlip

Вращает и/или переворачивает (зеркально) объект Image..

Синтаксис: THIS.RotateFlip(tnRotateFlipType)

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

Параметры: 

tnRotateFlipType, требуемый, целочисленный. Указывает угол вращения и/или типа переворота, в соотстветствии со значениями констант GDIPLUS_ROTATEFLIPTYPE_*.

Метод SaveToFile

Сохраняет объект Image в дисковый файл, используется указанный encoder или формат картинки и необязательные параметры.

Синтаксис: THIS.SaveToFile(tcFilename, tvCLSIDEncoder[, rvEncoderParams])

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

Параметры: 

tcFilename, требуемый, строчный, имя файла, в который будет сохранена картинка.

tvCLSIDEncoder, требуемый, string или varbinary. CLSID используемого encoder'а  или MIME тип (например "image/jpeg"). Если MIME тип не указан, тогда метод динамически ищет CLSID соответствующий для Encoder.

rvEncoderParams, необязательный, параметры для encoder. Либо разделенная запятыми строка в форме "param1=value1,param2=value2", либо двумерный мвссив (посылаемый по ссылке) парметров и значений для encoder.

Примечания: Параметры encoder определяюься внутренне для глобального унифицированного ID (GUIDS). Эта функция понимает ограниченный набор параметров по имени:

Для посылки других параметров, используйте массив в форме rvEncoderParams с GUID параметров в первой колонке.

Приведенный ниже пример сохраняет картинку в файл JPEG, используя уровень качества в 80%.

	Скопировать код
lSuccess = oImage.SaveToFile( "example.jpg", ; "image/jpeg", "quality=80" )

Свойство VerticalResolution

Численное, вертикальное разрешение в пикселях-на-дюйм. Только для чтения.

По умолчанию: нет.