ID2D1RenderTarget::Hapus metode

Menghapus area gambar ke warna yang ditentukan.

Daftar kelebihan beban

Metode	Deskripsi
Clear(D2D1_COLOR_F*)	Menghapus area gambar ke warna yang ditentukan.
Clear(D2D1_COLOR_F&)	Menghapus area gambar ke warna yang ditentukan.

Keterangan

Direct2D menginterpretasikan clearColor sebagai alfa lurus (tidak diisi sebelumnya). Jika mode alfa target render D2D1_ALPHA_MODE_IGNORE, saluran alfa clearColor diabaikan dan diganti dengan 1,0f (buram sepenuhnya).

Jika target render memiliki klip aktif (ditentukan oleh PushAxisAlignedClip), perintah hapus hanya diterapkan ke area dalam wilayah klip.

Contoh

Contoh berikut menggunakan metode Hapus untuk membuat latar belakang putih sebelum merender konten lain.

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

Persyaratan

Persyaratan	Value
Pustaka	D2d1.lib
DLL	D2d1.dll

Baca juga

ID2D1RenderTarget