QtでDirect3Dを使用する

かつて、Direct3DをQtと組み合わせて使用​​する必要がありました。 インターネットを数日間検索した後、ほんの少しの情報しか見つけませんでした。 どこでもDirect3Dを使用するメカニズムの完全な説明はありませんでした。 その結果、多くの研究を重ねた後、私は望んでいたことを達成しました:)

猫の下には、Direct3DとQtの「rapprochement」命令、およびそのまま使用できるウィジェットコードがあります。



この記事を書くとき、次のツールが使用されました。

1. Qt 4.5.0
2. VS2008 SP1
3. DirectX SDK 2008年8月

別のものを使用している場合。 IDEの場合、ビルド時間はわずかに異なります。 VS2008のみのアセンブリ例を示します。 ビルドがdirect3dエンジンをサポートしていることが確実な場合は、Qtの構成とビルドのステップをスキップしてください。

Qtの構成と構築

• 最初の手順は、DirectXの環境変数を構成することです。そのためには、コンソールで次のコマンドを実行します。
  
  > "％DXSDK_DIR％\ Utilities \ Bin \ dx_setenv.cmd"
• 
  
  Qtディレクトリに移動して構成します。 私の場合、このように見えました> configure -direct3d -platform win32-msvc2008
  
  -direct3dは省略できます。このパラメーターはコンフィギュレーターが計算する必要があります。
  
  すべてがうまくいった場合、コンフィギュレーターの出力では次のようになります： Direct3Dサポート...はい
  
  
  
  
• nmakeを作成し、問題がなければ、アセンブリが終了するまで待機します。 問題が発生しました。アセンブリ中にDirect3Dに関連する未解決の外部エラーがありました。 修正するには、 ％QTDIR％\ src \ gui \に移動し、両方のMakefile（リリースおよびデバッグ）でdxguid.libを「％DXSDK_DIR％\ Lib \ x86 \ dxguid.lib」に変更します （またはx64どのプラットフォーム用に構築するのか。）その後、問題は解消されるはずなので、構築が完了するまで待ちます。

ウィジェットコード

Direct3DWidget.h

1. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
2. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
4. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
5. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
6. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
8. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
9. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
   
   
   
   
10. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
12. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
13. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
14. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
15. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
16. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
17. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
18. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
19. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
20. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
21. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
22. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    
24. #ifndef DIRECT3DWIDGET_H #define DIRECT3DWIDGET_H #include <QtGui/QWidget> #include <d3d9.h> #include <atlbase.h> class Direct3DWidget : public QWidget { Q_OBJECT CComPtr < IDirect3D9 > m_pD3D ; CComPtr < IDirect3DDevice9 > m_pd3dDevice ; public : Direct3DWidget ( QWidget * parent = 0 ) ; ~Direct3DWidget ( ) ; bool InitDirect3D ( ) ; public slots : bool Rendering ( ) ; private : void paintEvent ( QPaintEvent * pEvent ) ; } ; #endif
    
    
    
    

Direct3DWidget.cpp

1. #include "Direct3DWidget.h"
3. Direct3DWidget :: Direct3DWidget （ QWidget * parent / * = 0 * / ） ： QWidget （ parent ）
4. {
5. setAttribute （ Qt :: WA_PaintOnScreen ） ;
6. }
7. Direct3DWidget :: 〜Direct3DWidget （ ）
8. {
9. }
10. bool Direct3DWidget :: InitDirect3D （ ）
11. {
12. m_pD3D = Direct3DCreate9 （ D3D_SDK_VERSION ） ;
13. if （ ！ m_pD3D ）
14. falseを返します。
15. D3DPRESENT_PARAMETERS d3dpp = { 0 } ;
16. d3dpp。 ウィンドウ化 = TRUE ;
17. d3dpp。 SwapEffect = D3DSWAPEFFECT_DISCARD ;
18. d3dpp。 BackBufferFormat = D3DFMT_UNKNOWN ;
19. d3dpp。 FullScreen_RefreshRateInHz = D3DPRESENT_RATE_DEFAULT ;
20. d3dpp。 PresentationInterval = D3DPRESENT_INTERVAL_IMMEDIATE ;
21. d3dpp。 SwapEffect = D3DSWAPEFFECT_DISCARD ;
22. d3dpp。 EnableAutoDepthStencil = TRUE ;
23. d3dpp。 AutoDepthStencilFormat = D3DFMT_D16 ;
24. HRESULT hrResult = m_pD3D- > CreateDevice （ D3DADAPTER_DEFAULT 、 D3DDEVTYPE_HAL 、 winId （ ） 、
25. D3DCREATE_HARDWARE_VERTEXPROCESSING 、
26. ＆ d3dpp 、 ＆ m_pd3dDevice ） ;
27. if （失敗（ hrResult ） ）
28. falseを返します。
29. trueを返します。
30. }
31. bool Direct3DWidget :: レンダリング （ ）
32. {
33. if （ m_pd3dDevice == 0 ）
34. falseを返します。
35. m_pd3dDevice- > Clear （ 0、0 、 D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER 、 D3DCOLOR_XRGB （ 255、255、0 ） 、 1.0f 、 0 ） ;
36. if （ SUCCEEDED （ m_pd3dDevice- > BeginScene （ ） ） ））
37. {
38. m_pd3dDevice- > EndScene （ ） ;
39. }
40. m_pd3dDevice- > Present （ 0、0、0、0 ） ;
41. trueを返します。
42. }
44. void Direct3DWidget :: paintEvent （ QPaintEvent * pEvent ）
45. {
46. Q_UNUSED （ pEvent ） ;
47. レンダリング（ ） ;
48. }

使用例：

1. #include <QtGui / QWidget>
2. #include <QtGui / QApplication>
3. #include <QtGui / QHBoxLayout>
4. #include "Direct3DWidget.h"
6. int main （ int argc 、 char * argv [ ] ）
7. {
8. // ------------------------------初期化を開始
9. //追加のパラメータ、カンマで区切られたパラメータを追加するだけ
10. std :: string aAdditionalParameters [ ] = { "-direct3d" } ;
11. int iRealArgumentAmount = argc + sizeof （ aAdditionalParameters ） / sizeof （ std :: string ） ;
12. //このダブルポインターには、argvからのパラメーターが含まれます。
13. //このアプリケーションに必要な静的パラメータ
14. char ** pArguments = new char * [ iRealArgumentAmount ] ;
15. //すべてのソース（コマンドラインから）パラメーターをコピーします
16. for （ int i = 0 ; i < argc ; ++ i ）
17. {
18. * （ pArguments + i ） = new char [ strlen （ argv [ i ] ） + 1 ] ;
19. strcpy （ * （ pArguments + i ） 、 argv [ i ] ） ;
20. }
21. //追加するパラメーターを追加します
22. for （ int i = argc 、 j = 0 ; i < iRealArgumentAmount ; ++ i 、 ++ j ）
23. {
24. * （ pArguments + i ） = new char [ aAdditionalParameters [ j ] 。 サイズ （ ） + 1 ] ;
25. strcpy （ * （ pArguments + i ） 、 aAdditionalParameters [ j ] .c_str （ ） ） ;
26. }
27. QApplication xApplication （ iRealArgumentAmount 、 pArguments ） ;
28. for （ int i = 0 ; i < iRealArgumentAmount ; ++ i ）
29. delete [ ] * （ pArguments + i ） ;
30. delete [ ] pArguments ;
31. // --------------------------------初期化完了
32. QWidget xMainWindow ;
33. Direct3DWidget * xScene = 新しい Direct3DWidget （ ＆ xMainWindow ） ;
34. QHBoxLayout * xMainLayout = new QHBoxLayout ;
35. xMainLayout- > addWidget （ xScene ） ;
36. xMainWindow。 setLayout （ xMainLayout ） ;
37. //ウィジェットがウィンドウに埋め込まれた後にDirect3dを初期化することが重要です
38. xScene- > InitDirect3D （ ） ;
39. xMainWindow。 show （ ） ;
41. xApplicationを返します。 exec （ ） ;
42. }

このコードの実行結果は、そのようなウィンドウになります（ストレッチした場合）。





優れたQtフレームワークでdirect3dを静かに使用するためのすべてがあるように思えますが、残念ながら、いくつかの落とし穴を発見しました。

一部のコンピューターでは、Direct3dで描画した画像の代わりにDirect3dを使用し始めた後、背景色でペイントされた画面がありました。 属性のすべての組み合わせを試しましたが、この欠陥を取り除くことができませんでした。 一部のマシンでは、direct3dエンジンの誤動作の原因を特定することもできませんでした。 Qtのドキュメントには「 この機能は実験的なものです。 "、問題はdirect3dサポートの素朴さであると仮定できます。



しかし、この欠点がDirect3Dを使用しない理由にはなりません:)。 trolltechがdirect3dを安定状態に完了する間、次の回避策を使用できます。

paintEventのRendering（）の呼び出しをコメントアウトします。

1. void Direct3DWidget :: paintEvent （ QPaintEvent * pEvent ）
2. {
3. Q_UNUSED （ pEvent ） ;
4. //レンダリング（）;
5. }

使用場所に次のコードを追加します。

1. ...
2. //ウィジェットがウィンドウに埋め込まれた後にDirect3dを初期化することが重要です
3. xScene- > InitDirect3D （ ） ;
4. xMainWindow。 show （ ） ;
6. QTimer xTimer ;
7. QWidget :: connect （ ＆ xTimer 、 SIGNAL （ timeout （ ） ）） 、 xScene 、 SLOT （ Rendering （ ） ） ）） ;
8. xTimer。 開始 （ 100 ） ;
10. xApplicationを返します。 exec （ ） ;
11. ...

このコードを上記の例のコードに追加しました。

また、 QTimerヘッダーを含めることを忘れないでください



QtでDirect3d APIの使用をお楽しみください。 -direct3dオプションを使用してアプリケーションを起動することを忘れないでください。このオプションを使用例のコードに含めました。