ID2D1Layer

レイヤーをレンダリングするために必要なバッキングストアを表します。

レイヤーを作成するには、そのレイヤーを使用するレンダーターゲットの CreateLayer メソッドを呼び出します。レイヤーに描画するには、PushLayer メソッドを呼び出して、レイヤーをレンダーターゲットのスタックにプッシュします。レイヤーへの描画が完了したら、PopLayer メソッドを呼び出します。

PushLayer と PopLayer の呼び出しの間、レイヤーは使用中の状態となり、他のレンダーターゲットで使用することはできません。

レイヤーのサイズが指定されていない場合、対応する PushLayer の呼び出しが、レイヤーのコンテンツ境界とジオメトリックマスクに基づいて最小のレイヤーサイズを決定します。レイヤーリソースは、レンダリングアーティファクトを生じさせることなく、PushLayer が要求するサイズより大きくすることができます。

レイヤーのサイズが指定されている場合、またはレイヤーがすでに使用されていて、PushLayer の実行中に計算された必要なバッキングストアのサイズがレイヤーより大きい場合は、レイヤーリソースが十分な大きさになるように各軸方向へ単調に拡張されます。レイヤーリソースのサイズが縮小することはありません。

ID2D1Layer オブジェクトの作成

レイヤーはデバイス依存のリソースです。アプリケーションは、レイヤーを使用するレンダーターゲットを初期化した後にレイヤーを作成し、レンダーターゲットの再作成が必要になるたびにレイヤーを再作成する必要があります。(リソースの詳細については、リソースの概要 を参照してください。)

例

次の例では、レイヤーを使用して描画をジオメトリックマスクにクリップします。完全な例については、ジオメトリックマスクへのクリップ方法 を参照してください。

HRESULT DemoApp::RenderWithLayer(ID2D1RenderTarget *pRT)
{
    HRESULT hr = S_OK;

    // Create a layer.
    ID2D1Layer *pLayer = NULL;
    hr = pRT->CreateLayer(NULL, &pLayer);

    if (SUCCEEDED(hr))
    {
        pRT->SetTransform(D2D1::Matrix3x2F::Translation(350, 50));

        // Push the layer with the geometric mask.
        pRT->PushLayer(
            D2D1::LayerParameters(D2D1::InfiniteRect(), m_pPathGeometry),
            pLayer
            );
            
  
        pRT->DrawBitmap(m_pOrigBitmap, D2D1::RectF(0, 0, 200, 133));
        pRT->FillRectangle(D2D1::RectF(0.f, 0.f, 25.f, 25.f), m_pSolidColorBrush);  
        pRT->FillRectangle(D2D1::RectF(25.f, 25.f, 50.f, 50.f), m_pSolidColorBrush);
        pRT->FillRectangle(D2D1::RectF(50.f, 50.f, 75.f, 75.f), m_pSolidColorBrush); 
        pRT->FillRectangle(D2D1::RectF(75.f, 75.f, 100.f, 100.f), m_pSolidColorBrush);    
        pRT->FillRectangle(D2D1::RectF(100.f, 100.f, 125.f, 125.f), m_pSolidColorBrush); 
        pRT->FillRectangle(D2D1::RectF(125.f, 125.f, 150.f, 150.f), m_pSolidColorBrush);    
        

        pRT->PopLayer();
    }

    SafeRelease(&pLayer);

    return hr;
}

レイヤーのサイズをデバイス非依存ピクセル単位で取得します。

Type: D2D1_SIZE_F

レイヤーのサイズ(デバイス非依存ピクセル単位)。