ID2D1TransformGraph

変換ノードのグラフを表します。

このインターフェイスを使用すると、変換ノードのグラフを指定できます。このインターフェイスは ID2D1EffectImpl::Initialize に渡され、エフェクトの実装が変換のグラフまたは単一の変換を指定できるようにします。

Examples

この例では、ID2D1TransformGraph の多くのメソッドをどのように使用できるかを示します。

class CMyEffect : public ID2D1EffectImpl
{
public:

    IFACEMETHODIMP SetGraph(
       __in ID2D1TransformGraph *pGraph
       )
    {
        HRESULT hr = S_OK;

        hr = pGraph->Clear();

        if (SUCEEDED(hr))
        {
            hr = pGraph->AddNode(_pTransform1);
        }
   
        if (SUCCEEDED(hr))
        {
            hr = pGraph->AddNode(_pTransform2);
        }
 
        if (SUCCEEDED(hr))
        {
            hr = pGraph->SetOutputNode(_pTransform2);
        }

        if (SUCCEEDED(hr))
        {
            hr = pGraph->ConnectNode(_pTransform1, _pTransform2, 0);
        }

        if (SUCCEEDED(hr))
        {
            hr = pGraph->ConnectToEffectInput(0, _pTransform1, 0);
        }

        return hr;
    }

private:

    class CMyTransform1 : public ID2D1DrawTransform
    {
        // <Snip> The transform implementation, one node input</Snip>
    };

    class CMyTransform2 : public ID2D1DrawTransform
    {
        // <Snip> A second transform implementation one node input</Snip>
    };

    CMyTransform1 *_pTransform1;
    CMyTransform2 *_pTransform2;
};

変換グラフへの入力の数を返します。

型: UINT32

この変換グラフへの入力の数。

単一の変換ノードをグラフ全体と等価なものとして設定します。

型: HRESULT

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。

これは、ID2D1TransformGraph::Clear を呼び出し、単一のノードを追加し、そのノードのすべての入力をエフェクトの入力に順番に接続し、その変換ノードをグラフの出力として設定するのと同等です。

Examples

class CMySimpleEffect : public ID2D1EffectImpl
{
public:

    IFACEMETHODIMP SetGraph(
        __in ID2D1TransformGraph   *pGraph
        )
    {
        HRESULT hr = S_OK;

        CMyTransform *pTransform = new CMyTransform();
  
        hr = pTransform ? S_OK : E_OUTOFMEMORY;

        if (SUCCEEDED(hr))
        {
            hr = graph->SetSingleTransformNode(pTransform);

            pTransform->Release();
        }

        return hr;
    }

private:

    class CMyTransform : public ID2D1DrawTransform
    {
        // <Snip> Implementation of transform </Snip> 
    };

    
};

指定されたノードを変換グラフに追加します。

型: HRESULT

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。

これは変換ノードを変換グラフに追加します。ノードを何らかの方法で相互接続する前に、そのノードを変換グラフに追加しておく必要があります。

変換グラフを別の変換グラフに直接追加することはできません。 ID2D1TransformNode から派生したインターフェイスのみを変換グラフに追加できます。

指定されたノードを変換グラフから削除します。

型: HRESULT

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。

ノードはグラフ内に既に存在している必要があります。そうでない場合、呼び出しは D2DERR_NOT_FOUND で失敗します。

ノードが削除されると、そのノードへのすべての接続も削除されます。

ノードが削除された後は、AddNode によってグラフに追加されるまで、そのノードをインターフェイスで使用することはできません。

変換グラフの出力ノードを設定します。

型: HRESULT

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。

ノードはグラフ内に既に存在している必要があります。そうでない場合、呼び出しは D2DERR_NOT_FOUND で失敗します。

変換グラフ内の 2 つのノードを接続します。

型: HRESULT

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。

両方のノードがグラフ内に既に存在している必要があります。そうでない場合、呼び出しは D2DERR_NOT_FOUND で失敗します。

グラフ内の変換ノードを、それを内包するエフェクトの対応するエフェクト入力に接続します。

型: HRESULT

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。

変換グラフから変換ノードとすべての接続をクリアします。

変換に対する変更が多く、変換グラフの編集が非効率になる場合に使用します。

指定された入力をエフェクトの出力として使用します。

このメソッドは HRESULT を返します。とりうる値には、次の表に示すものが含まれますが、これらに限定されません。