перечисление D2D1_BITMAP_OPTIONS (d2d1_1.h)

  • Статья

Указывает способ использования растрового изображения.

Синтаксис

typedef enum D2D1_BITMAP_OPTIONS {
  D2D1_BITMAP_OPTIONS_NONE = 0x00000000,
  D2D1_BITMAP_OPTIONS_TARGET = 0x00000001,
  D2D1_BITMAP_OPTIONS_CANNOT_DRAW = 0x00000002,
  D2D1_BITMAP_OPTIONS_CPU_READ = 0x00000004,
  D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE = 0x00000008,
  D2D1_BITMAP_OPTIONS_FORCE_DWORD = 0xffffffff
} ;

Константы

 
D2D1_BITMAP_OPTIONS_NONE
Значение: 0x00000000
Растровое изображение создается со свойствами по умолчанию.
D2D1_BITMAP_OPTIONS_TARGET
Значение: 0x00000001
Растровое изображение можно использовать в качестве целевого объекта контекста устройства.
D2D1_BITMAP_OPTIONS_CANNOT_DRAW
Значение: 0x00000002
Растровое изображение нельзя использовать в качестве входных данных.
D2D1_BITMAP_OPTIONS_CPU_READ
Значение: 0x00000004
Растровое изображение можно считать из ЦП.
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE
Значение: 0x00000008
Растровое изображение работает с ID2D1GdiInteropRenderTarget::GetDC.

Примечание Этот флаг недоступен в приложениях Магазина Windows.

 
D2D1_BITMAP_OPTIONS_FORCE_DWORD
Значение: 0xffffffff

Комментарии

D2D1_BITMAP_OPTIONS_NONE подразумевает, что ни один из флагов не задан. Это означает, что растровый рисунок может использоваться для рисования из, не может быть задан в качестве целевого объекта и не может быть прочитан ЦП.

D2D1_BITMAP_OPTIONS_TARGET означает, что растровое изображение можно указать в качестве целевого объекта в ID2D1DeviceContext::SetTarget. Если также указать флаг D2D1_BITMAP_OPTIONS_CANNOT_DRAW точечного рисунка можно использовать в качестве целевого объекта, но его нельзя нарисовать из. Попытка рисовать с помощью растрового рисунка, для которого установлены оба флага, приведет к тому, что контекст устройства будет переведен в состояние ошибки с D2DERR_BITMAP_CANNOT_DRAW.

D2D1_BITMAP_OPTIONS_CPU_READ означает, что растровое изображение можно сопоставить с помощью ID2D1Bitmap1::Map. Этот флаг требует D2D1_BITMAP_OPTIONS_CANNOT_DRAW и не может сочетаться с другими флагами. Растровое изображение должно быть обновлено с помощью методов CopyFromBitmap или CopyFromRenderTarget .

Примечание Следует использовать D2D1_BITMAP_OPTIONS_CANNOT_DRAW используется только в том случае, если растровое изображение предназначено только для целевого объекта или если растровое изображение будет сопоставлено .
 
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE означает, что можно получить контроллер домена, связанный с этим растровым изображением. Его необходимо использовать в сочетании с D2D1_BITMAP_OPTIONS_TARGET. DXGI_FORMAT должна быть DXGI_FORMAT_B8G8R8A8_UNORM или DXGI_FORMAT_B8G8R8A8_UNORM_SRGB.

Требования

   
Минимальная версия клиента Windows 8 и Обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть d2d1_1.h

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

ID2D1DeviceContext::CreateBitmap