ID2D1Factory インターフェイス (d2d1.h)

[アーティクル]
08/22/2023

Direct2D リソースを作成します。

継承

ID2D1Factory インターフェイスは、IUnknown インターフェイスから継承されます。 ID2D1Factory には、次の種類のメンバーもあります。

メソッド

メソッド

ID2D1Factory インターフェイスには、これらのメソッドがあります。


ID2D1Factory::CreateDCRenderTarget Windows グラフィックスデバイスインターフェイス (GDI) デバイスコンテキストに描画するレンダーターゲットを作成します。
ID2D1Factory::CreateDrawingStateBlock レンダーターゲットの SaveDrawingState メソッドおよび RestoreDrawingState メソッドで使用できる ID2D1DrawingStateBlock を作成します。 (オーバーロード 1/3)
ID2D1Factory::CreateDrawingStateBlock レンダーターゲットの SaveDrawingState メソッドおよび RestoreDrawingState メソッドで使用できる ID2D1DrawingStateBlock を作成します。 (オーバーロード 2/3)
ID2D1Factory::CreateDrawingStateBlock レンダーターゲットの SaveDrawingState メソッドおよび RestoreDrawingState メソッドで使用できる ID2D1DrawingStateBlock を作成します。 (オーバーロード 3/3)
ID2D1Factory::CreateDxgiSurfaceRenderTarget DirectX グラフィックスインフラストラクチャ (DXGI) サーフェスに描画するレンダーターゲットを作成します。 (オーバーロード 1/2)
ID2D1Factory::CreateDxgiSurfaceRenderTarget DirectX グラフィックスインフラストラクチャ (DXGI) サーフェスに描画するレンダーターゲットを作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateEllipseGeometry ID2D1EllipseGeometry を作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateEllipseGeometry ID2D1EllipseGeometry を作成します。 (オーバーロード 1/2)
ID2D1Factory::CreateGeometryGroup 他のジオメトリを保持するオブジェクトである ID2D1GeometryGroup を作成します。
ID2D1Factory::CreateHwndRenderTarget ウィンドウにレンダリングするレンダーターゲットである ID2D1HwndRenderTarget を作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateHwndRenderTarget ウィンドウにレンダリングするレンダーターゲットである ID2D1HwndRenderTarget を作成します。 (オーバーロード 1/2)
ID2D1Factory::CreatePathGeometry 空の ID2D1PathGeometry を作成します。
ID2D1Factory::CreateRectangleGeometry ID2D1RectangleGeometry を作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateRectangleGeometry ID2D1RectangleGeometry を作成します。 (オーバーロード 1/2)
ID2D1Factory::CreateRoundedRectangleGeometry ID2D1RoundedRectangleGeometry を作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateRoundedRectangleGeometry ID2D1RoundedRectangleGeometry を作成します。 (オーバーロード 1/2)
ID2D1Factory::CreateStrokeStyle ストロークの開始キャップ、ダッシュパターン、およびその他の特徴を記述する ID2D1StrokeStyle を作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateStrokeStyle ストロークの開始キャップ、ダッシュパターン、およびその他の特徴を記述する ID2D1StrokeStyle を作成します。 (オーバーロード 1/2)
ID2D1Factory::CreateTransformedGeometry 指定したジオメトリを変換し、結果を ID2D1TransformedGeometry オブジェクトとして格納します。 (オーバーロード 2/2)
ID2D1Factory::CreateTransformedGeometry 指定したジオメトリを変換し、結果を ID2D1TransformedGeometry オブジェクトとして格納します。 (オーバーロード 1/2)
ID2D1Factory::CreateWicBitmapRenderTarget Microsoft Windows Imaging Component (WIC) ビットマップにレンダリングするレンダーターゲットを作成します。 (オーバーロード 2/2)
ID2D1Factory::CreateWicBitmapRenderTarget Microsoft Windows Imaging Component (WIC) ビットマップにレンダリングするレンダーターゲットを作成します。 (オーバーロード 1/2)
ID2D1Factory::GetDesktopDpi 現在のデスクトップドット/インチ (DPI) を取得します。この値を更新するには、ReloadSystemMetrics を呼び出します。
ID2D1Factory::ReloadSystemMetrics ファクトリの作成後に変更された可能性のあるシステムの既定値を強制的に更新します。

注釈

ID2D1Factory インターフェイスは、Direct2D を使用するための開始点です。図形の描画や記述に使用できる他の Direct2D リソースを作成するために使用します。

ファクトリは、次の描画リソースを生成できる一連の CreateResource メソッドを定義します。

レンダーターゲット: 描画コマンドをレンダリングするオブジェクト。
描画状態ブロック: 現在の変換やアンチエイリアシングモードなどの描画状態情報を格納するオブジェクト。
ジオメトリ: 単純で複雑な可能性のある図形を表すオブジェクト。

ID2D1Factory を作成するには、CreateFactory メソッドのいずれかを使用します。 Direct2D リソースを使用する限り、 ID2D1Factory インスタンスを保持する必要があります。一般に、アプリケーションの実行時に再作成する必要はありません。 Direct2D リソースの詳細については、「リソースの概要」を参照してください。

シングルスレッドファクトリとマルチスレッドファクトリ

ファクトリを作成するときに、マルチスレッドかシングルスレッドかを指定できます。シングルスレッドファクトリでは、Direct2D 内の他のシングルスレッドインスタンスに対するシリアル化は提供されないため、このメカニズムでは CPU のスケーリングが非常に大きくなります。

マルチスレッドファクトリインスタンスを作成することもできます。この場合、ファクトリとすべての派生オブジェクトは任意のスレッドから使用でき、各レンダーターゲットは個別ににレンダリングできます。 Direct2D は、これらのオブジェクトへの呼び出しをシリアル化するため、単一のマルチスレッド Direct2D インスタンスは、単一スレッドインスタンスの数ほど CPU 上でスケーリングされません。ただし、リソースはマルチスレッドインスタンス内で共有できます。

修飾子 "ON the CPU": GPU は通常、CPU よりもきめ細かい並列処理を利用します。たとえば、CPU からのマルチスレッド呼び出しは GPU に送信されるときにシリアル化される可能性がありますが、ピクセルシェーダーと頂点シェーダーのバンク全体が並列で実行され、レンダリングが実行されます。

詳細については、「マルチスレッド Direct2D アプリ」を参照してください。

例

次のコードフラグメントは、ファクトリポインターを宣言し、シングルスレッドファクトリインスタンスを作成し、ファクトリを使用してレンダーターゲットを作成します。

ID2D1Factory* m_pDirect2dFactory;

    // Create a Direct2D factory.
    hr = D2D1CreateFactory(D2D1_FACTORY_TYPE_SINGLE_THREADED, &m_pDirect2dFactory);

        // Create a Direct2D render target.
        hr = m_pDirect2dFactory->CreateHwndRenderTarget(
            D2D1::RenderTargetProperties(),
            D2D1::HwndRenderTargetProperties(m_hwnd, size),
            &m_pRenderTarget
            );

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	d2d1.h