ID2D1RenderTarget::P ushLayer(constD2D1_LAYER_PARAMETERS&,ID2D1Layer*) メソッド (d2d1.h)

指定したレイヤーをレンダー ターゲットに追加し、 PopLayer が呼び出されるまで後続のすべての描画操作を受け取るようにします。

構文

void PushLayer(
  [ref] const D2D1_LAYER_PARAMETERS & layerParameters,
  [in]  ID2D1Layer                    *layer
);

パラメーター

[ref] layerParameters

型: const D2D1_LAYER_PARAMETERS

レイヤーのコンテンツ境界、ジオメトリック マスク、不透明度、不透明度マスク、アンチエイリアシング オプション。

[in] layer

種類: ID2D1Layer*

後続の描画操作を受け取るレイヤー。

戻り値

なし

解説

PushLayer メソッドを使用すると、呼び出し元はレイヤーへのレンダリングのリダイレクトを開始できます。 すべてのレンダリング操作はレイヤーで有効です。 レイヤーの位置は、レンダー ターゲットに設定されたワールド変換の影響を受けます。

各 PushLayer には、一致する PopLayer 呼び出しが必要です。 PushLayer 呼び出しよりも多くの PopLayer 呼び出しがある場合、レンダー ターゲットはエラー状態になります。 すべての未処理のレイヤーがポップされる前に Flush が呼び出された場合、レンダー ターゲットはエラー状態になり、エラーが返されます。 エラーの状態は、 EndDraw の呼び出しによってクリアできます。

特定の ID2D1Layer リソースは、一度にのみアクティブにすることができます。 つまり、 PushLayer メソッドを呼び出して、同じレイヤー リソースを持つ別の PushLayer メソッドをすぐに実行することはできません。 代わりに、異なるレイヤー リソースで 2 番目の PushLayer メソッドを呼び出す必要があります。

失敗した場合、このメソッドはエラー コードを返しません。 描画操作 (PushLayer など) が失敗したかどうかを判断するには、ID2D1RenderTarget::EndDraw メソッドまたは ID2D1RenderTarget::Flush メソッドによって返される結果をチェックします。

例

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

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

要件

こちらもご覧ください

ID2D1RenderTarget

レイヤーの概要

PopLayer