Compartir a través de


Métodos ID2D1RenderTarget::Clear

Borra el área de dibujo con el color especificado.

Lista de sobrecarga

Método Descripción
Clear(D2D1_COLOR_F*) Borra el área de dibujo con el color especificado.
Clear(D2D1_COLOR_F&) Borra el área de dibujo con el color especificado.

Observaciones

Direct2D interpreta clearColor como alfa recto (no premultiplicado). Si el modo alfa del destino de representación es D2D1_ALPHA_MODE_IGNORE, el canal alfa de clearColor se omite y se reemplaza por 1,0f (totalmente opaco).

Si el destino de representación tiene un clip activo (especificado por PushAxisAlignedClip), el comando clear solo se aplica al área dentro de la región del clip.

Ejemplos

En el ejemplo siguiente se usa el método Clear para crear un fondo blanco antes de representar otro contenido.

//  Called whenever the application needs to display the client
//  window. This method writes "Hello, World"
//
//  Note that this function will automatically discard device-specific
//  resources if the Direct3D device disappears during function
//  invocation, and will recreate the resources the next time it's
//  invoked.
//
HRESULT DemoApp::OnRender()
{
    HRESULT hr;

    hr = CreateDeviceResources();

    if (SUCCEEDED(hr))
    {
        static const WCHAR sc_helloWorld[] = L"Hello, World!";

        // Retrieve the size of the render target.
        D2D1_SIZE_F renderTargetSize = m_pRenderTarget->GetSize();

        m_pRenderTarget->BeginDraw();

        m_pRenderTarget->SetTransform(D2D1::Matrix3x2F::Identity());

        m_pRenderTarget->Clear(D2D1::ColorF(D2D1::ColorF::White));

        m_pRenderTarget->DrawText(
            sc_helloWorld,
            ARRAYSIZE(sc_helloWorld) - 1,
            m_pTextFormat,
            D2D1::RectF(0, 0, renderTargetSize.width, renderTargetSize.height),
            m_pBlackBrush
            );

        hr = m_pRenderTarget->EndDraw();

        if (hr == D2DERR_RECREATE_TARGET)
        {
            hr = S_OK;
            DiscardDeviceResources();
        }
    }

    return hr;
}

Requisitos

Requisito Value
Biblioteca
D2d1.lib
Archivo DLL
D2d1.dll

Consulte también

ID2D1RenderTarget