差分

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

GraphicsDeviceが最初から持っているレンダリングターゲット（[[DirectX]]でいう[[プライマリサーフェイス]]）に相当するものはDiscardContentsに設定されている。DiscardContents設定になっていると「GraphicsDevice.SetRenderTargetするたびに破棄（初期化）される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。DiscardContentsの欠点はGraphicsDevice<source lang="csharp">GraphicsDevice.SetRenderTargetするたびに破棄される点であり、レンダリング系APIの呼出順序を間違えると残念なことになる。SetRenderTarget(このRenderTargetは初期化される);</source>

たとば以下のコードは正常に動作しない。ちなみにGraphicsDeviceが最初から持っているレンダリングターゲット（[[DirectX]]でいう[[プライマリサーフェイス]]、SetRenterTarget(null)）に相当するものは問答無用でDiscardContentsに設定されている。 このため、たとば以下のコードは正常に動作しない。

protected override void Draw(GameTime gameTime) { // （１）プライマリサーフェイスを塗りつぶす var gd = _graphics.GraphicsDevice.Clear(Color.CornflowerBlue);

// （２）レンダリングターゲットを切り替える（１）プライマリサーフェイスを塗りつぶす _graphics gd.GraphicsDeviceClear(Color.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128)CornflowerBlue);

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

// （３）レンダリングターゲットをプライマリサーフェイスに戻す // プライマリサーフェイスは問答無用でDiscardContents設定なので // 内容はクリアされ（１）の塗りつぶしは無かったことにされる。 // なお、（２）のレンダーターゲットは影響を受けない。 gd.SetRenderTarget(null);  base.Draw(gameTime); }

protected override void Draw(GameTime gameTime) { var gd = _graphics.GraphicsDevice;  // （１）レンダリングターゲットを切り替える _graphics.GraphicsDevice gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));

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

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

base.Draw(gameTime); }