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

ナビゲーションに移動 検索に移動

警告: ログインしていません。編集を行うと、あなたの IP アドレスが公開されます。ログインまたはアカウントを作成すれば、あなたの編集はその利用者名とともに表示されるほか、その他の利点もあります。

この編集を取り消せます。 下記の差分を確認して、本当に取り消していいか検証してください。よろしければ変更を保存して取り消しを完了してください。

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

MonoBookへの投稿はすべて、他の投稿者によって編集、変更、除去される場合があります。 自分が書いたものが他の人に容赦なく編集されるのを望まない場合は、ここに投稿しないでください。
また、投稿するのは、自分で書いたものか、パブリック ドメインまたはそれに類するフリーな資料からの複製であることを約束してください（詳細はMonoBook:著作権を参照）。 著作権保護されている作品は、許諾なしに投稿しないでください！

このページを編集するには、下記の確認用の質問に回答してください (詳細):

取り消し 編集の仕方 (新しいウィンドウで開きます)
「https://monobook.org/wiki/MonoGame/クラスライブラリ/RenderTargetUsage列挙体」から取得