enumeração D2D1_BITMAP_OPTIONS (d2d1_1.h)

  • Artigo

Especifica como um bitmap pode ser usado.

Syntax

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
} ;

Constantes

 
D2D1_BITMAP_OPTIONS_NONE
Valor: 0x00000000
O bitmap é criado com propriedades padrão.
D2D1_BITMAP_OPTIONS_TARGET
Valor: 0x00000001
O bitmap pode ser usado como um destino de contexto de dispositivo.
D2D1_BITMAP_OPTIONS_CANNOT_DRAW
Valor: 0x00000002
O bitmap não pode ser usado como uma entrada.
D2D1_BITMAP_OPTIONS_CPU_READ
Valor: 0x00000004
O bitmap pode ser lido da CPU.
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE
Valor: 0x00000008
O bitmap funciona com ID2D1GdiInteropRenderTarget::GetDC.

Nota Esse sinalizador não está disponível em aplicativos da Windows Store.

 
D2D1_BITMAP_OPTIONS_FORCE_DWORD
Valor: 0xffffffff

Comentários

D2D1_BITMAP_OPTIONS_NONE implica que nenhum dos sinalizadores está definido. Isso significa que o bitmap pode ser usado para desenhar, não pode ser definido como um destino e não pode ser lido pela CPU.

D2D1_BITMAP_OPTIONS_TARGET significa que o bitmap pode ser especificado como um destino em ID2D1DeviceContext::SetTarget. Se você também especificar o sinalizador D2D1_BITMAP_OPTIONS_CANNOT_DRAW , o bitmap poderá ser usado como destino, mas ele não poderá ser extraído. Tentar desenhar com um bitmap que tenha os dois sinalizadores definidos resultará na colocação do contexto do dispositivo em um estado de erro com D2DERR_BITMAP_CANNOT_DRAW.

D2D1_BITMAP_OPTIONS_CPU_READ significa que o bitmap pode ser mapeado usando ID2D1Bitmap1::Map. Esse sinalizador requer D2D1_BITMAP_OPTIONS_CANNOT_DRAW e não pode ser combinado com nenhum outro sinalizador. O bitmap deve ser atualizado com os métodos CopyFromBitmap ou CopyFromRenderTarget .

Nota Você só deve usar D2D1_BITMAP_OPTIONS_CANNOT_DRAW é quando a finalidade do bitmap é ser apenas um destino ou quando o bitmap será mapeado.
 
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE significa que é possível obter um controlador de domínio associado a esse bitmap. Isso deve ser usado em conjunto com D2D1_BITMAP_OPTIONS_TARGET. O DXGI_FORMAT deve ser DXGI_FORMAT_B8G8R8A8_UNORM ou DXGI_FORMAT_B8G8R8A8_UNORM_SRGB.

Requisitos

   
Cliente mínimo com suporte Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho d2d1_1.h

Confira também

ID2D1DeviceContext::CreateBitmap