Интерфейс ID2D1BitmapRenderTarget (d2d1.h)

Статья
02/26/2024

Выполняет отрисовку в промежуточной текстуре, созданной методом CreateCompatibleRenderTarget .

Наследование

Интерфейс ID2D1BitmapRenderTarget наследуется от ID2D1RenderTarget. ID2D1BitmapRenderTarget также имеет следующие типы элементов:

Методы

Методы

Интерфейс ID2D1BitmapRenderTarget содержит следующие методы.


ID2D1BitmapRenderTarget::GetBitmap Извлекает растровое изображение для этого целевого объекта отрисовки. Возвращаемое растровое изображение можно использовать для операций рисования.

ID2D1BitmapRenderTarget записывает в промежуточную текстуру. Это полезно для создания шаблонов для использования с ID2D1BitmapBrush или кэширования данных рисования, которые будут использоваться повторно.

Для записи непосредственно в точечный рисунок WIC используйте метод ID2D1Factory::CreateWicBitmapRenderTarget . Этот метод возвращает id2D1RenderTarget , который записывает данные в указанное растровое изображение WIC.

Создание объектов ID2D1BitmapRenderTarget

Чтобы создать целевой объект отрисовки растрового изображения, вызовите метод ID2D1RenderTarget::CreateCompatibleRenderTarget .

Как и другие целевые объекты отрисовки, ID2D1BitmapRenderTarget является ресурсом, зависящим от устройства, и его необходимо повторно создать, когда связанное устройство становится недоступным. Дополнительные сведения см. в разделе Общие сведения о ресурсах.

Примеры

В следующем примере метод CreateCompatibleRenderTarget используется для создания ID2D1BitmapRenderTarget и используется для рисования шаблона сетки. Шаблон сетки используется в качестве источника ID2D1BitmapBrush.

HRESULT DemoApp::CreateGridPatternBrush(
    ID2D1RenderTarget *pRenderTarget,
    ID2D1BitmapBrush **ppBitmapBrush
    )
{
    // Create a compatible render target.
    ID2D1BitmapRenderTarget *pCompatibleRenderTarget = NULL;
    HRESULT hr = pRenderTarget->CreateCompatibleRenderTarget(
        D2D1::SizeF(10.0f, 10.0f),
        &pCompatibleRenderTarget
        );
    if (SUCCEEDED(hr))
    {
        // Draw a pattern.
        ID2D1SolidColorBrush *pGridBrush = NULL;
        hr = pCompatibleRenderTarget->CreateSolidColorBrush(
            D2D1::ColorF(D2D1::ColorF(0.93f, 0.94f, 0.96f, 1.0f)),
            &pGridBrush
            );
        if (SUCCEEDED(hr))
        {
            pCompatibleRenderTarget->BeginDraw();
            pCompatibleRenderTarget->FillRectangle(D2D1::RectF(0.0f, 0.0f, 10.0f, 1.0f), pGridBrush);
            pCompatibleRenderTarget->FillRectangle(D2D1::RectF(0.0f, 0.1f, 1.0f, 10.0f), pGridBrush);
            pCompatibleRenderTarget->EndDraw();

            // Retrieve the bitmap from the render target.
            ID2D1Bitmap *pGridBitmap = NULL;
            hr = pCompatibleRenderTarget->GetBitmap(&pGridBitmap);
            if (SUCCEEDED(hr))
            {
                // Choose the tiling mode for the bitmap brush.
                D2D1_BITMAP_BRUSH_PROPERTIES brushProperties =
                    D2D1::BitmapBrushProperties(D2D1_EXTEND_MODE_WRAP, D2D1_EXTEND_MODE_WRAP);

                // Create the bitmap brush.
                hr = m_pRenderTarget->CreateBitmapBrush(pGridBitmap, brushProperties, ppBitmapBrush);

                pGridBitmap->Release();
            }

            pGridBrush->Release();
        }

        pCompatibleRenderTarget->Release();
    }

    return hr;
}

В следующем примере кода используется кисть для рисования шаблона.

// Paint a grid background.
m_pRenderTarget->FillRectangle(
    D2D1::RectF(0.0f, 0.0f, renderTargetSize.width, renderTargetSize.height),
    m_pGridPatternBitmapBrush
    );

Код в этом примере опущен.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1.h

См. также раздел

CreateCompatibleRenderTarget

ID2D1Factory::CreateWicBitmapRenderTarget

ID2D1RenderTarget

Поделиться через