estructura D2D1_RENDER_TARGET_PROPERTIES (d2d1.h)

  • Artículo

Contiene opciones de representación (hardware o software), formato de píxeles, información de PPP, opciones de comunicación remota y requisitos de compatibilidad de Direct3D para un destino de representación.

Sintaxis

typedef struct D2D1_RENDER_TARGET_PROPERTIES {
  D2D1_RENDER_TARGET_TYPE  type;
  D2D1_PIXEL_FORMAT        pixelFormat;
  FLOAT                    dpiX;
  FLOAT                    dpiY;
  D2D1_RENDER_TARGET_USAGE usage;
  D2D1_FEATURE_LEVEL       minLevel;
} D2D1_RENDER_TARGET_PROPERTIES;

Miembros

type

Tipo: D2D1_RENDER_TARGET_TYPE

Valor que especifica si el destino de representación debe forzar la representación de hardware o software. Un valor de D2D1_RENDER_TARGET_TYPE_DEFAULT especifica que el destino de representación debe usar la representación de hardware si está disponible; de lo contrario, usa la representación de software. Tenga en cuenta que los destinos de representación del mapa de bits WIC no admiten la representación de hardware.

pixelFormat

Tipo: D2D1_PIXEL_FORMAT

Formato de píxel y modo alfa del destino de representación. Puede usar la función D2D1::P ixelFormat para crear un formato de píxel que especifique que Direct2D debe seleccionar el formato de píxel y el modo alfa automáticamente. Para obtener una lista de formatos de píxeles y modos alfa admitidos por cada destino de representación, consulte Formatos de píxeles admitidos y Modos alfa.

dpiX

Tipo: FLOAT

PPP horizontal del destino de representación. Para usar el valor de PPP predeterminado, establezca pppX y pppY en 0. Para obtener más información, vea la sección Comentarios.

dpiY

Tipo: FLOAT

PPP vertical del destino de representación. Para usar el valor de PPP predeterminado, establezca pppX y pppY en 0. Para obtener más información, vea la sección Comentarios.

usage

Tipo: D2D1_RENDER_TARGET_USAGE

Valor que especifica cómo se remoto el destino de representación y si debe ser compatible con GDI. Establézcalo en D2D1_RENDER_TARGET_USAGE_NONE para crear un destino de representación que no sea compatible con GDI y use la comunicación remota de secuencia de comandos de Direct3D si está disponible.

minLevel

Tipo: D2D1_FEATURE_LEVEL

Valor que especifica el nivel de característica de Direct3D mínimo necesario para la representación de hardware. Si el nivel mínimo especificado no está disponible, el destino de representación usa la representación de software si el miembro de tipo está establecido en D2D1_RENDER_TARGET_TYPE_DEFAULT; si el tipo se establece en D2D1_RENDER_TARGET_TYPE_HARDWARE, se produce un error en la creación del destino de representación. Un valor de D2D1_FEATURE_LEVEL_DEFAULT indica que Direct2D debe determinar si el nivel de característica de Direct3D del dispositivo es adecuado. Este campo solo se usa al crear objetos ID2D1HwndRenderTarget e ID2D1DCRenderTarget .

Comentarios

Use esta estructura al crear un destino de representación o úselo con el método ID2D1RenderTarget::IsSupported para comprobar las propiedades admitidas por un destino de representación existente.

Como comodidad, Direct2D proporciona la función auxiliar D2D1::RenderTargetProperties para crear estructuras de D2D1_RENDER_TARGET_PROPERTIES . Una manera sencilla de crear una estructura de D2D1_RENDER_TARGET_PROPERTIES que funcione para la mayoría de los destinos de representación es llamar a la función sin especificar ningún parámetro. Al hacerlo, se crea una estructura de D2D1_RENDER_TARGET_PROPERTIES que tiene sus campos establecidos en valores predeterminados. Para obtener más información, vea D2D1::RenderTargetProperties.

No todos los destinos de representación admiten la representación de hardware. Para obtener una lista, consulte Introducción a los destinos de representación.

Usar la configuración de PPP predeterminada

Para usar el valor de PPP predeterminado, establezca pppX y pppY en 0. El valor de PPP predeterminado varía en función del destino de representación:
  • En el caso de un destino de representación compatible, el valor de PPP predeterminado es el PPP del destino de representación primario.
  • Para un ID2D1HwndRenderTarget, el valor de PPP predeterminado es el PPP del sistema obtenido del id2D1Factory del destino de representación.
  • Para otros destinos de representación, el valor predeterminado de PPP es 96.
Para usar la configuración de PPP predeterminada, pppX y pppY deben establecerse en 0. Al establecer solo un valor en 0, se produce un error de E_INVALIDARG al intentar crear un destino de representación.

Ejemplos

En el ejemplo siguiente se usa la función D2D1::RenderTargetProperties para crear una estructura de D2D1_RENDER_TARGET_PROPERTIES adecuada para la mayoría de los destinos de representación.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado d2d1.h

Consulte también

ID2D1RenderTarget::IsSupported

Introducción a los destinos de representación