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

← 古い編集

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

@@ 1行目: / 1行目: @@
-RenderTargetUsage列挙体は、グラフィックデバイス（[[MonoGame/クラスライブラリ/GraphicsDeviceクラス|GraphicsDeviceクラス]]）に新たなレンダリングターゲット（[[MonoGame/クラスライブラリ/RenderTarget2Dクラス|RenderTarget2Dクラス]]）を設定したとき、そのレンダリングターゲットの[[データ]]をどのように処理するかを指定するのに使用する列挙体である。
+RenderTargetUsage列挙体は、グラフィックデバイス（[[MonoGame/クラスライブラリ/GraphicsDeviceクラス|GraphicsDeviceクラス]]）に新たなレンダリングターゲット（[[MonoGame/クラスライブラリ/RenderTarget2Dクラス|RenderTarget2Dクラス]]）を設定したとき、そのレンダリングターゲットの[[データ]]をどのように処理するかを指定するのに使用する[[列挙体]]である。
 == 名前空間 ==
-* [[MonoGame/クラスライブラリ/Microsoft.Xna.Framework.Graphics名前空間|Microsoft.Xna.Framework.Graphics名前空間]]
+ [[MonoGame/クラスライブラリ/Microsoft.Xna.Framework.Graphics名前空間|Microsoft.Xna.Framework.Graphics名前空間]]
 == 構文 ==
@@ 25行目: / 25行目: @@
 == 備考 ==
 === PreserveContentsは遅い ===
-PreserveContentsはVRAM容量が少ない環境ではメインメモリへの保存と復元が発生するため絶望的なほど遅くなる。
+PreserveContentsは[[VRAM]]容量が少ない環境では[[メインメモリ]]への保存と復元が発生するため絶望的なほど遅くなる。
-とくにスマホでは絶望的なようなので、なるべくDiscardContentsを使ったほうが良さそうだ。
+[[PC]]ではまず問題になることはないようだが、一部の[[スマホ]]では絶望的な速度になるようだ。
+なるべくDiscardContentsを使ったほうが良さそうだ。
 === 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>
 == 関連項目 ==
 * [[MonoGame/クラスライブラリ/GraphicsDeviceクラス|GraphicsDeviceクラス]]
-** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/SetRenderTargetメソッド|GraphicsDeviceクラス/SetRenderTargetメソッド]]
+** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/SetRenderTargetメソッド|SetRenderTargetメソッド]]
-** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/SetRenderTargetsメソッド|GraphicsDeviceクラス/SetRenderTargetsメソッド]]
+** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/SetRenderTargetsメソッド|SetRenderTargetsメソッド]]
-** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/GetRenderTargetsメソッド|GraphicsDeviceクラス/GetRenderTargetsメソッド]]
+** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/GetRenderTargetsメソッド|GetRenderTargetsメソッド]]
 * [[MonoGame/クラスライブラリ/RenderTarget2Dクラス|RenderTarget2Dクラス]]
 * [[MonoGame/クラスライブラリ/RenderTargetCubeクラス|RenderTargetCubeクラス]]
 * [[MonoGame/クラスライブラリ/CubeMapFace列挙体|CubeMapFace列挙体]]
 * [[MonoGame/クラスライブラリ/RenderTargetBinding構造体|RenderTargetBinding構造体]]
+* [[MonoGame/クラスライブラリ/RenderTargetUsage列挙体|RenderTargetUsage列挙体]]
 [[category: MonoGame]]