Описание
Класс TBitmap инкапсулирует битовую матрицу Windows, включая палитру. Обеспечивает быстрое и простое для пользователя выполнение операций создания, копирования, преобразования и сохранения битовой матрицы.
Иерархия
TObject - TPersistent - TGraphic
Модуль
graphics.h
Свойства
Свойство | Тип | Описание |
Canvas | TCanvas | Определяет пространство (холст) для изображения битовой матрицы. Свойство только для чтения. |
Empty | bool | Указывает, содержит ли объект битовую матрицу. Свойство только для чтения. |
Handle | HBITMAP | Обеспечивает доступ к обработке битовых матриц в GDI Windows. Используется при вызовах функций API Windows. |
HandleType | enum TBitmapHandleType {bmDIB, bmDDB} | Указывает, является ли битовая матрица DDB (Device Dependent Bitmap - аппаратно зависимой), или DIB (Device Independent Bitmap - аппаратно независимой). Может изменяться пользователем. |
Height | int | Указывает высоту изображения в пикселах. Может изменяться пользователем, что вызывает создание копии матрицы с указанным размером. |
IgnorePalette | bool | Определяет, использует ли матрица палитру. При установке в true ухудшается качество, но ускоряется рисование. |
Modified | bool | Определяет, было ли модифицировано изображение после его загрузки. |
MaskHandle | HBITMAP | Обеспечивает доступ к обработке битовых матриц в GDI Windows. Используется при вызовах функций API Windows. Свойство только для чтения. |
Monochrome | bool | Определяет, является ли битовая матрица монохромной (значение true). |
Palette | HPALETTE | Управляет цветами битовой матрицы с 256 цветами. Если изображение не нуждается в палитре или не имеет палитры, то Palette - 0. |
PixelFormat | enum TPixelFormat {pfDevice, pflbit, pf4bit, pf8bit, pflSbit, pfl6bit, pf246it, pf32bit, pfCustom} | Определяет битовый формат отображения изображения. Используется для задания формата видеодрайверам, не способным прочитать собственный формат битовой матрицы. |
ScanLine | void * | Обеспечивает доступ к отдельным строкам пикселов для их низкоуровневой обработки для матриц DIBs (Device Independent Bitmap - аппаратно независимых). Свойство только для чтения. |
Transparent | bool | Определяет, должно ли изображение быть «прозрачным». |
TransparentColor | TColor | Определяет, какой из цветов будет прозрачным при рисовании битовой матрицы. Читаемое значение зависит от значения TransparentMode. |
TransparentMode | enum TTransparentMode {tmAuto, tmFixed} | Определяет, будет ли свойство TransparentColor сохраняться вместе с битовой матрицей. |
Width | int | Указывает ширину изображения в пикселах. Может изменяться пользователем, что вызывает создание копии матрицы с указанным размером. |
Методы
Значение | Описание |
Assign | Копирует изображение из другого графического объекта, в частности, из буфера обмена Clipboard. |
Dormant | Создает изображение битовой матрицы в памяти, чтобы освободить дескриптор матрицы и сэкономить ресурсы. |
Freelmage | Освобождаем память, занятую кэшированием изображения, экономит ресурсы, но может вести к потере глубины цвета. |
LoadFromClipboardFormat | Читает изображение из буфера обмена Clipboard в заданном формате. |
LoadFromFile | Читает изображение из файла. |
LoadFromResourcelD | Загружает битовую карту из ресурса по указанному идентификатору. |
LoadFromResourceName | Загружает битовую карту из ресурса по указанному имени. |
LoadFromStream | Читает графическое изображение из указанного потока. |
Mask | Преобразует изображение в монохромную маску. |
ReleaseHandle | Возвращает дескриптор типа HBitmap и очищает объект TBitmap от этого дескриптора. |
ReleaseMaskHandle | Возвращает дескриптор маски типа HBitmap и очищает объект TBitmapот этого дескриптора. |
ReleasePalette | Возвращает дескриптор палитры типа HPalette и разрывает связь палитры с объектом TBitmap. |
SaveToClipboardFormat | Сохраняет изображение в буфере обмена Clipboard в заданном формате. |
SaveToFile | Сохраняет изображение в файле. |
SaveToStream | Записывает изображение в поток. |
События
Значение | Описание |
OnChantfe | Событие при изменении графического объекта. |
OnProgress | События происходят при медленных процессах изменения графического изображения и позволяют построить индикатор хода процесса. |