「MonoGame/クラスライブラリ/RenderTargetUsage列挙体」を編集中

RenderTargetUsage列挙体は、グラフィックデバイス（[[MonoGame/クラスライブラリ/GraphicsDeviceクラス|GraphicsDeviceクラス]]）に新たなレンダリングターゲット（[[MonoGame/クラスライブラリ/RenderTarget2Dクラス|RenderTarget2Dクラス]]）を設定したとき、そのレンダリングターゲットの[[データ]]をどのように処理するかを指定するのに使用する[[列挙体]]である。

== 名前空間 ==
 [[MonoGame/クラスライブラリ/Microsoft.Xna.Framework.Graphics名前空間|Microsoft.Xna.Framework.Graphics名前空間]]

== 構文 ==
 public enum RenderTargetUsage

== フィールド ==
{| class="wikitable"
|+
! 値
! 概要
|-
| DiscardContents
| 常にレンダリングターゲットのデータを削除する。
|-
| PlatformContents
| プラットフォームに応じて扱いを変える。使うな危険。
|-
| PreserveContents
| 常にレンダリングターゲットのデータを保持する。
|}

== 備考 ==
=== PreserveContentsは遅い ===
PreserveContentsは[[VRAM]]容量が少ない環境では[[メインメモリ]]への保存と復元が発生するため絶望的なほど遅くなる。
[[PC]]ではまず問題になることはないようだが、一部の[[スマホ]]では絶望的な速度になるようだ。
なるべくDiscardContentsを使ったほうが良さそうだ。

=== DiscardContentsの注意点 ===
GraphicsDeviceが最初から持っているレンダリングターゲット（[[DirectX]]でいう[[プライマリサーフェイス]]）に相当するものはDiscardContentsに設定されている。
DiscardContentsの欠点はGraphicsDevice.SetRenderTargetするたびに破棄される点であり、レンダリング系APIの呼出順序を間違えると残念なことになる。

たとば以下のコードは正常に動作しない。
<source lang="csharp">
        protected override void Draw(GameTime gameTime)
        {
            // （１）プライマリサーフェイスを塗りつぶす
            _graphics.GraphicsDevice.Clear(Color.CornflowerBlue);

            // （２）レンダリングターゲットを切り替える
            _graphics.GraphicsDevice.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));

            // （３）レンダリングターゲットをプライマリサーフェイスに戻す
            // このときプライマリサーフェイスはDiscardContents設定なので内容がクリアされ（１）の塗りつぶしが無かったことにされる。
            _graphics.GraphicsDevice.SetRenderTarget(null);

            base.Draw(gameTime);
        }
</source>

DiscardContentsの場合は以下のような呼出順序で書かなければならない。
<source lang="csharp">
        protected override void Draw(GameTime gameTime)
        {
            // （１）レンダリングターゲットを切り替える
            _graphics.GraphicsDevice.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));

            // （２）レンダリングターゲットをプライマリサーフェイスに戻す（と同時にまっさらになる）
            _graphics.GraphicsDevice.SetRenderTarget(null);

            // （３）プライマリサーフェイスを塗りつぶす
            _graphics.GraphicsDevice.Clear(Color.CornflowerBlue);

            base.Draw(gameTime);
        }
</source>

== 関連項目 ==
* [[MonoGame/クラスライブラリ/GraphicsDeviceクラス|GraphicsDeviceクラス]]
** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/SetRenderTargetメソッド|SetRenderTargetメソッド]]
** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/SetRenderTargetsメソッド|SetRenderTargetsメソッド]]
** [[MonoGame/クラスライブラリ/GraphicsDeviceクラス/GetRenderTargetsメソッド|GetRenderTargetsメソッド]]
* [[MonoGame/クラスライブラリ/RenderTarget2Dクラス|RenderTarget2Dクラス]]
* [[MonoGame/クラスライブラリ/RenderTargetCubeクラス|RenderTargetCubeクラス]]
* [[MonoGame/クラスライブラリ/CubeMapFace列挙体|CubeMapFace列挙体]]
* [[MonoGame/クラスライブラリ/RenderTargetBinding構造体|RenderTargetBinding構造体]]
* [[MonoGame/クラスライブラリ/RenderTargetUsage列挙体|RenderTargetUsage列挙体]]

[[category: MonoGame]]