チュートリアル : WPF での Direct3D9 コンテンツのホスト
更新 : 2010 年 8 月
このチュートリアルでは、Windows Presentation Foundation (WPF) アプリケーションで Direct3D9 コンテンツをホストする方法について説明します。
このチュートリアルでは次のタスクを行います。
Direct3D9 コンテンツをホストする WPF プロジェクトを作成する。
Direct3D9 コンテンツをインポートする。
D3DImage クラスを使用して Direct3D9 コンテンツを表示する。
このチュートリアルを終了すると、WPF アプリケーションで Direct3D9 コンテンツをホストする方法を理解できます。
必須コンポーネント
このチュートリアルを実行するには、次のコンポーネントが必要です。
Visual Studio 2010。
DirectX SDK 9 以降
WPF 互換形式の Direct3D9 コンテンツを含む DLL。 詳細については、「WPF と Direct3D9 の相互運用性」および「チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成」を参照してください。
WPF プロジェクトの作成
最初に WPF アプリケーションのプロジェクトを作成します。
WPF プロジェクトを作成するには
Visual C# で D3DHost という名前の新しい WPF アプリケーション プロジェクトを作成します。 詳細については、「方法 : 新しい WPF アプリケーション プロジェクトを作成する」を参照してください。
WPF デザイナーで MainWindow.xaml が開きます。
Direct3D9 コンテンツのインポート
DllImport 属性を使用して、Direct3D9 コンテンツをアンマネージ DLL からインポートします。
Direct3D9 コンテンツをインポートするには
コード エディターで MainWindow.xaml.cs を開きます。
自動的に生成されたコードを次のコードで置き換えます。
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Windows; using System.Windows.Controls; using System.Windows.Data; using System.Windows.Documents; using System.Windows.Input; using System.Windows.Interop; using System.Windows.Media; using System.Windows.Media.Imaging; using System.Windows.Navigation; using System.Windows.Shapes; using System.Windows.Threading; using System.Runtime.InteropServices; using System.Security.Permissions; namespace D3DHost { public partial class MainWindow : Window { public MainWindow() { InitializeComponent(); // Set up the initial state for the D3DImage. HRESULT.Check(SetSize(512, 512)); HRESULT.Check(SetAlpha(false)); HRESULT.Check(SetNumDesiredSamples(4)); // // Optional: Subscribing to the IsFrontBufferAvailableChanged event. // // If you don't render every frame (e.g. you only render in // reaction to a button click), you should subscribe to the // IsFrontBufferAvailableChanged event to be notified when rendered content // is no longer being displayed. This event also notifies you when // the D3DImage is capable of being displayed again. // For example, in the button click case, if you don't render again when // the IsFrontBufferAvailable property is set to true, your // D3DImage won't display anything until the next button click. // // Because this application renders every frame, there is no need to // handle the IsFrontBufferAvailableChanged event. // CompositionTarget.Rendering += new EventHandler(CompositionTarget_Rendering); // // Optional: Multi-adapter optimization // // The surface is created initially on a particular adapter. // If the WPF window is dragged to another adapter, WPF // ensures that the D3DImage still shows up on the new // adapter. // // This process is slow on Windows XP. // // Performance is better on Vista with a 9Ex device. It's only // slow when the D3DImage crosses a video-card boundary. // // To work around this issue, you can move your surface when // the D3DImage is displayed on another adapter. To // determine when that is the case, transform a point on the // D3DImage into screen space and find out which adapter // contains that screen space point. // // When your D3DImage straddles two adapters, nothing // can be done, because one will be updating slowly. // _adapterTimer = new DispatcherTimer(); _adapterTimer.Tick += new EventHandler(AdapterTimer_Tick); _adapterTimer.Interval = new TimeSpan(0, 0, 0, 0, 500); _adapterTimer.Start(); // // Optional: Surface resizing // // The D3DImage is scaled when WPF renders it at a size // different from the natural size of the surface. If the // D3DImage is scaled up significantly, image quality // degrades. // // To avoid this, you can either create a very large // texture initially, or you can create new surfaces as // the size changes. Below is a very simple example of // how to do the latter. // // By creating a timer at Render priority, you are guaranteed // that new surfaces are created while the element // is still being arranged. A 200 ms interval gives // a good balance between image quality and performance. // You must be careful not to create new surfaces too // frequently. Frequently allocating a new surface may // fragment or exhaust video memory. This issue is more // significant on XDDM than it is on WDDM, because WDDM // can page out video memory. // // Another approach is deriving from the Image class, // participating in layout by overriding the ArrangeOverride method, and // updating size in the overriden method. Performance will degrade // if you resize too frequently. // // Blurry D3DImages can still occur due to subpixel // alignments. // _sizeTimer = new DispatcherTimer(DispatcherPriority.Render); _sizeTimer.Tick += new EventHandler(SizeTimer_Tick); _sizeTimer.Interval = new TimeSpan(0, 0, 0, 0, 200); _sizeTimer.Start(); } ~MainWindow() { Destroy(); } void AdapterTimer_Tick(object sender, EventArgs e) { POINT p = new POINT(imgelt.PointToScreen(new Point(0, 0))); HRESULT.Check(SetAdapter(p)); } void SizeTimer_Tick(object sender, EventArgs e) { // The following code does not account for RenderTransforms. // To handle that case, you must transform up to the root and // check the size there. // Given that the D3DImage is at 96.0 DPI, its Width and Height // properties will always be integers. ActualWidth/Height // may not be integers, so they are cast to integers. uint actualWidth = (uint)imgelt.ActualWidth; uint actualHeight = (uint)imgelt.ActualHeight; if ((actualWidth > 0 && actualHeight > 0) && (actualWidth != (uint)d3dimg.Width || actualHeight != (uint)d3dimg.Height)) { HRESULT.Check(SetSize(actualWidth, actualHeight)); } } void CompositionTarget_Rendering(object sender, EventArgs e) { RenderingEventArgs args = (RenderingEventArgs)e; // It's possible for Rendering to call back twice in the same frame // so only render when we haven't already rendered in this frame. if (d3dimg.IsFrontBufferAvailable && _lastRender != args.RenderingTime) { IntPtr pSurface = IntPtr.Zero; HRESULT.Check(GetBackBufferNoRef(out pSurface)); if (pSurface != IntPtr.Zero) { d3dimg.Lock(); // Repeatedly calling SetBackBuffer with the same IntPtr is // a no-op. There is no performance penalty. d3dimg.SetBackBuffer(D3DResourceType.IDirect3DSurface9, pSurface); HRESULT.Check(Render()); d3dimg.AddDirtyRect(new Int32Rect(0, 0, d3dimg.PixelWidth, d3dimg.PixelHeight)); d3dimg.Unlock(); _lastRender = args.RenderingTime; } } } DispatcherTimer _sizeTimer; DispatcherTimer _adapterTimer; TimeSpan _lastRender; // Import the methods exported by the unmanaged Direct3D content. [DllImport("D3DCode.dll")] static extern int GetBackBufferNoRef(out IntPtr pSurface); [DllImport("D3DCode.dll")] static extern int SetSize(uint width, uint height); [DllImport("D3DCode.dll")] static extern int SetAlpha(bool useAlpha); [DllImport("D3DCode.dll")] static extern int SetNumDesiredSamples(uint numSamples); [StructLayout(LayoutKind.Sequential)] struct POINT { public POINT(Point p) { x = (int)p.X; y = (int)p.Y; } public int x; public int y; } [DllImport("D3DCode.dll")] static extern int SetAdapter(POINT screenSpacePoint); [DllImport("D3DCode.dll")] static extern int Render(); [DllImport("D3DCode.dll")] static extern void Destroy(); } public static class HRESULT { [SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)] public static void Check(int hr) { Marshal.ThrowExceptionForHR(hr); } } }
Direct3D9 コンテンツのホスト
最後に、D3DImage クラスを使用して Direct3D9 コンテンツをホストします。
Direct3D9 コンテンツをホストするには
MainWindow.xaml で、自動的に生成された XAML を次の XAML に置き換えます。
<Window x:Class="D3DHost.MainWindow" xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml" xmlns:i="clr-namespace:System.Windows.Interop;assembly=PresentationCore" Title="MainWindow" Height="300" Width="300" Background="PaleGoldenrod"> <Grid> <Image x:Name="imgelt"> <Image.Source> <i:D3DImage x:Name="d3dimg" /> </Image.Source> </Image> </Grid> </Window>
プロジェクトをビルドします。
Direct3D9 コンテンツを含む DLL を bin/Debug フォルダーにコピーします。
F5 キーを押してプロジェクトを実行します。
WPF アプリケーションの中に Direct3D9 コンテンツが表示されます。
参照
参照
概念
Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項
履歴の変更
日付 |
履歴 |
理由 |
---|---|---|
2010 年 8 月 |
Visual Studio 2010 用に更新。 |
カスタマー フィードバック |