Condividi tramite


Metodi ID2D1RenderTarget::Clear

Cancella l'area di disegno sul colore specificato.

Elenco di overload

metodo Descrizione
Clear(D2D1_COLOR_F*) Cancella l'area di disegno sul colore specificato.
Clear(D2D1_COLOR_F&) Cancella l'area di disegno sul colore specificato.

Osservazioni:

Direct2D interpreta clearColor come alfa dritto (non premoltiplicato). Se la modalità alfa della destinazione di rendering è D2D1_ALPHA_MODE_IGNORE, il canale alfa di clearColor viene ignorato e sostituito con 1,0f (completamente opaco).

Se la destinazione di rendering ha una clip attiva (specificata da PushAxisAlignedClip), il comando clear viene applicato solo all'area all'interno dell'area di ritaglio.

Esempi

Nell'esempio seguente viene utilizzato il metodo Clear per creare uno sfondo bianco prima di eseguire il rendering di altri contenuti.

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

Requisiti

Requisito Valore
Libreria
D2d1.lib
DLL
D2d1.dll

Vedi anche

ID2D1RenderTarget