「MonoGame/クラスライブラリ/RenderTargetUsage列挙体」の版間の差分

← 古い編集新しい編集 →

ビジュアルウィキテキスト

@@ 30行目: / 30行目: @@
 === DiscardContentsの注意点 ===
-GraphicsDeviceが最初から持っているレンダリングターゲット（[[DirectX]]でいう[[プライマリサーフェイス]]）に相当するものはDiscardContentsに設定されている。
+DiscardContentsは「GraphicsDevice.SetRenderTargetするたびに破棄（初期化）される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。
-DiscardContentsの欠点はGraphicsDevice.SetRenderTargetするたびに破棄される点であり、レンダリング系APIの呼出順序を間違えると残念なことになる。
+<source lang="csharp">
+GraphicsDevice.SetRenderTarget(このRenderTargetは初期化される);
+</source>
-たとば以下のコードは正常に動作しない。
+ちなみにGraphicsDeviceが最初から持っているレンダリングターゲット（[[DirectX]]でいう[[プライマリサーフェイス]]、SetRenterTarget(null)）に相当するものはDiscardContentsに設定されている。
+このため、たとば以下のコードは正常に動作しない。
 <source lang="csharp">
-        protected override void Draw(GameTime gameTime)
+protected override void Draw(GameTime gameTime)
-        {
+{
-            // （１）プライマリサーフェイスを塗りつぶす
+    var gd = _graphics.GraphicsDevice;
-            _graphics.GraphicsDevice.Clear(Color.CornflowerBlue);
-            // （２）レンダリングターゲットを切り替える
+    // （１）プライマリサーフェイスを塗りつぶす
-            _graphics.GraphicsDevice.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));
+    gd.Clear(Color.CornflowerBlue);
-            // （３）レンダリングターゲットをプライマリサーフェイスに戻す
+    // （２）レンダリングターゲットを切り替える
-            // このときプライマリサーフェイスはDiscardContents設定なので内容がクリアされ（１）の塗りつぶしが無かったことにされる。
+    gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));
-            _graphics.GraphicsDevice.SetRenderTarget(null);
-            base.Draw(gameTime);
+    // （３）レンダリングターゲットをプライマリサーフェイスに戻す
-        }
+    // このときプライマリサーフェイスはDiscardContents設定なので内容がクリアされ（１）の塗りつぶしが無かったことにされる。
+    // （２）のレンダーターゲットは影響を受けない。
+    gd.SetRenderTarget(null);
+    base.Draw(gameTime);
+}
 </source>
 DiscardContentsの場合は以下のような呼出順序で書かなければならない。
 <source lang="csharp">
-        protected override void Draw(GameTime gameTime)
+protected override void Draw(GameTime gameTime)
-        {
+{
-            // （１）レンダリングターゲットを切り替える
+    var gd = _graphics.GraphicsDevice;
-            _graphics.GraphicsDevice.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));
+    // （１）レンダリングターゲットを切り替える
+    gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));
-            // （２）レンダリングターゲットをプライマリサーフェイスに戻す（と同時にまっさらになる）
+    // （２）レンダリングターゲットをプライマリサーフェイスに戻す（と同時にまっさらになる）
-            _graphics.GraphicsDevice.SetRenderTarget(null);
+    // （１）のレンダーターゲットは影響を受けない。
+    gd.SetRenderTarget(null);
-            // （３）プライマリサーフェイスを塗りつぶす
+    // （３）プライマリサーフェイスを塗りつぶす
-            _graphics.GraphicsDevice.Clear(Color.CornflowerBlue);
+    gd.Clear(Color.CornflowerBlue);
-            base.Draw(gameTime);
+    base.Draw(gameTime);
-        }
+}
 </source>