estructura D2D1_RENDER_TARGET_PROPERTIES (d2d1.h)
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.
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 |