ID2D1RenderTarget::Clear-Methoden

Artikel
06/13/2023

Löscht den Zeichnungsbereich auf die angegebene Farbe.

Überladeliste

Methode	BESCHREIBUNG
*Clear(D2D1_COLOR_F)**	Löscht den Zeichnungsbereich auf die angegebene Farbe.
Clear(D2D1_COLOR_F&)	Löscht den Zeichnungsbereich auf die angegebene Farbe.

Bemerkungen

Direct2D interpretiert clearColor als gerades Alpha (nicht vormultipliziert). Wenn der Alphamodus des Renderziels D2D1_ALPHA_MODE_IGNORE ist, wird der Alphakanal von clearColor ignoriert und durch 1.0f (vollständig undurchsichtig) ersetzt.

Wenn das Renderziel über einen aktiven Clip verfügt (angegeben durch PushAxisAlignedClip), wird der Clear-Befehl nur auf den Bereich innerhalb des Clipbereichs angewendet.

Beispiele

Im folgenden Beispiel wird die Clear-Methode verwendet, um einen weißen Hintergrund zu erstellen, bevor andere Inhalte gerendert werden.

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

Anforderungen

Anforderung	Wert
Bibliothek	D2d1.lib
DLL	D2d1.dll

Weitere Informationen

ID2D1RenderTarget

Freigeben über