差分

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); }