Функция DrawDibDraw (vfw.h)

Статья
08/27/2023

Функция DrawDibDraw рисует DIB на экране.

Синтаксис

BOOL VFWAPI DrawDibDraw(
  HDRAWDIB           hdd,
  HDC                hdc,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  UINT               wFlags
);

Параметры

hdd

Дескриптор для контроллера домена DrawDib.

hdc

Дескриптор контроллера домена.

xDst

Координата X в MM_TEXT координатах клиента в левом верхнем углу прямоугольника назначения.

yDst

Координата Y в MM_TEXT координатах клиента в левом верхнем углу прямоугольника назначения.

dxDst

Ширина целевого прямоугольника в MM_TEXT координатах клиента. Если значение dxDst равно −1, используется ширина растрового изображения.

dyDst

Высота в MM_TEXT клиентских координатах прямоугольника назначения. Если dyDst равно -1, используется высота растрового изображения.

lpbi

Указатель на структуру BITMAPINFOHEADER, содержащую формат изображения. Таблица цветов для DIB в BITMAPINFOHEADER соответствует формату, а член biHeight должен иметь положительное значение; DrawDibDraw не будет рисовать инвертированные DIB.

lpBits

Указатель на буфер, содержащий битовые биты.

xSrc

Координата X (в пикселях) левого верхнего угла исходного прямоугольника. Координаты (0,0) представляют левый верхний угол растрового изображения.

ySrc

Координата Y в пикселях верхнего левого угла исходного прямоугольника. Координаты (0,0) представляют левый верхний угол растрового изображения.

dxSrc

Ширина исходного прямоугольника (в пикселях).

dySrc

Высота исходного прямоугольника в пикселях.

wFlags

Применимые флаги для рисования. Определены следующие значения.

Значение	Значение
DDF_BACKGROUNDPAL	Реализует палитру, используемую для рисования в фоновом режиме, оставляя фактическую палитру, используемую для отображения, без изменений. Это значение допустимо, только если DDF_SAME_HDC не задано.
DDF_DONTDRAW	Текущее изображение распаковывается, но не рисуется. Этот флаг заменяет флаг DDF_PREROLL .
DDF_FULLSCREEN	Не поддерживается.
DDF_HALFTONE	Всегда падает dib в стандартную палитру независимо от палитры DIB. Если приложение использует функцию DrawDibBegin , задайте это значение в DrawDibBegin , а не в DrawDibDraw.
DDF_HURRYUP	Данные не обязательно должны быть отрисованы (то есть их можно удалить), и DDF_UPDATE не будут использоваться для отзыва этой информации. DrawDib проверяет это значение только в том случае, если оно требуется для построения следующего кадра; В противном случае значение игнорируется. Это значение обычно используется для синхронизации видео и звука. При синхронизации данных приложения должны отправлять изображение с этим значением на случай, если драйверу потребуется буферизировать кадр для распаковки последующих кадров.
DDF_NOTKEYFRAME	Данные DIB не являются ключевым кадром.
DDF_SAME_HDC	Используйте текущий дескриптор контроллера домена и палитру, связанную с контроллером домена.
DDF_SAME_DRAW	Используйте текущие параметры рисования для DrawDibDraw. Используйте это значение, только если lpbi, dxDst, dyDst, dxSrc и dySrc не изменились с момента использования DrawDibDraw или DrawDibBegin. DrawDibDraw обычно проверяет параметры, и если они изменились, DrawDibBegin подготавливает контроллер домена DrawDib к рисованию. Этот флаг заменяет флаги DDF_SAME_DIB и DDF_SAME_SIZE .
DDF_UPDATE	Последнее буферизованное растровое изображение необходимо перерисовывать. Если рисование завершается сбоем с этим значением, буферизованное изображение недоступно, и перед обновлением отображения необходимо указать новое изображение.

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

Возвращает значение TRUE в случае успешного выполнения или false в противном случае.

Если контроллер домена DrawDib не указан внеэкранный буфер, указание DDF_DONTDRAW приводит к немедленному выводу кадра на экран. Последующие вызовы DrawDibDraw , указывающие DDF_UPDATE завершаются ошибкой.

Хотя они задаются в разное время, DDF_UPDATE и DDF_DONTDRAW можно использовать вместе для создания составных изображений за кадром. Когда изображение за кадром завершится, его можно отобразить, вызвав DrawDibDraw.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	vfw.h
Библиотека	Vfw32.lib
DLL	Msvfw32.dll

См. также раздел

Функции DrawDib