imported>Administrator |
Administrator (トーク | 投稿記録) |
||
(3人の利用者による、間の9版が非表示) | |||
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名前空間]] | |
== 構文 == | == 構文 == | ||
25行目: | 25行目: | ||
== 備考 == | == 備考 == | ||
=== PreserveContentsは遅い === | === PreserveContentsは遅い === | ||
− | + | PreserveContentsは[[VRAM]]容量が少ない環境では[[メインメモリ]]への保存と復元が発生するため絶望的なほど遅くなる。 | |
− | [[PC]] | + | [[PC]]ではまず問題になることはないようだが、一部の[[スマホ]]では絶望的な速度になるようだ。 |
なるべくDiscardContentsを使ったほうが良さそうだ。 | なるべくDiscardContentsを使ったほうが良さそうだ。 | ||
=== DiscardContentsの注意点 === | === DiscardContentsの注意点 === | ||
− | + | DiscardContents設定になっていると「GraphicsDevice.SetRenderTargetするたびに破棄(初期化)される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。 | |
− | + | <source lang="csharp"> | |
+ | GraphicsDevice.SetRenderTarget(このRenderTargetは初期化される); | ||
+ | </source> | ||
− | + | ちなみにGraphicsDeviceが最初から持っているレンダリングターゲット([[DirectX]]でいう[[プライマリサーフェイス]]、SetRenterTarget(null))に相当するものは問答無用でDiscardContentsに設定されている。 | |
+ | |||
+ | このため、たとば以下のコードは正常に動作しない。 | ||
<source lang="csharp"> | <source lang="csharp"> | ||
− | + | protected override void Draw(GameTime gameTime) | |
− | + | { | |
− | + | var gd = _graphics.GraphicsDevice; | |
− | |||
− | + | // (1)プライマリサーフェイスを塗りつぶす | |
− | + | gd.Clear(Color.CornflowerBlue); | |
− | + | // (2)レンダリングターゲットを切り替える | |
− | + | gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128)); | |
− | |||
− | + | // (3)レンダリングターゲットをプライマリサーフェイスに戻す | |
− | + | // プライマリサーフェイスは問答無用でDiscardContents設定なので | |
+ | // 内容はクリアされ(1)の塗りつぶしは無かったことにされる。 | ||
+ | // なお、(2)のレンダーターゲットは影響を受けない。 | ||
+ | gd.SetRenderTarget(null); | ||
+ | |||
+ | base.Draw(gameTime); | ||
+ | } | ||
</source> | </source> | ||
DiscardContentsの場合は以下のような呼出順序で書かなければならない。 | DiscardContentsの場合は以下のような呼出順序で書かなければならない。 | ||
<source lang="csharp"> | <source lang="csharp"> | ||
− | + | protected override void Draw(GameTime gameTime) | |
− | + | { | |
− | + | var gd = _graphics.GraphicsDevice; | |
− | + | ||
+ | // (1)レンダリングターゲットを切り替える | ||
+ | gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128)); | ||
− | + | // (2)レンダリングターゲットをプライマリサーフェイスに戻す(と同時にまっさらになる) | |
− | + | // (1)のレンダーターゲットは影響を受けない。 | |
+ | gd.SetRenderTarget(null); | ||
− | + | // (3)プライマリサーフェイスを塗りつぶす | |
− | + | gd.Clear(Color.CornflowerBlue); | |
− | + | base.Draw(gameTime); | |
− | + | } | |
</source> | </source> | ||
77行目: | 88行目: | ||
* [[MonoGame/クラスライブラリ/CubeMapFace列挙体|CubeMapFace列挙体]] | * [[MonoGame/クラスライブラリ/CubeMapFace列挙体|CubeMapFace列挙体]] | ||
* [[MonoGame/クラスライブラリ/RenderTargetBinding構造体|RenderTargetBinding構造体]] | * [[MonoGame/クラスライブラリ/RenderTargetBinding構造体|RenderTargetBinding構造体]] | ||
+ | * [[MonoGame/クラスライブラリ/RenderTargetUsage列挙体|RenderTargetUsage列挙体]] | ||
[[category: MonoGame]] | [[category: MonoGame]] |
2020年9月15日 (火) 02:45時点における最新版
RenderTargetUsage列挙体は、グラフィックデバイス(GraphicsDeviceクラス)に新たなレンダリングターゲット(RenderTarget2Dクラス)を設定したとき、そのレンダリングターゲットのデータをどのように処理するかを指定するのに使用する列挙体である。
目次
名前空間編集
構文編集
public enum RenderTargetUsage
フィールド編集
値 | 概要 |
---|---|
DiscardContents | 常にレンダリングターゲットのデータを削除する。 |
PlatformContents | プラットフォームに応じて扱いを変える。使うな危険。 |
PreserveContents | 常にレンダリングターゲットのデータを保持する。 |
備考編集
PreserveContentsは遅い編集
PreserveContentsはVRAM容量が少ない環境ではメインメモリへの保存と復元が発生するため絶望的なほど遅くなる。 PCではまず問題になることはないようだが、一部のスマホでは絶望的な速度になるようだ。 なるべくDiscardContentsを使ったほうが良さそうだ。
DiscardContentsの注意点編集
DiscardContents設定になっていると「GraphicsDevice.SetRenderTargetするたびに破棄(初期化)される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。
GraphicsDevice.SetRenderTarget(このRenderTargetは初期化される);
ちなみにGraphicsDeviceが最初から持っているレンダリングターゲット(DirectXでいうプライマリサーフェイス、SetRenterTarget(null))に相当するものは問答無用でDiscardContentsに設定されている。
このため、たとば以下のコードは正常に動作しない。
protected override void Draw(GameTime gameTime)
{
var gd = _graphics.GraphicsDevice;
// (1)プライマリサーフェイスを塗りつぶす
gd.Clear(Color.CornflowerBlue);
// (2)レンダリングターゲットを切り替える
gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));
// (3)レンダリングターゲットをプライマリサーフェイスに戻す
// プライマリサーフェイスは問答無用でDiscardContents設定なので
// 内容はクリアされ(1)の塗りつぶしは無かったことにされる。
// なお、(2)のレンダーターゲットは影響を受けない。
gd.SetRenderTarget(null);
base.Draw(gameTime);
}
DiscardContentsの場合は以下のような呼出順序で書かなければならない。
protected override void Draw(GameTime gameTime)
{
var gd = _graphics.GraphicsDevice;
// (1)レンダリングターゲットを切り替える
gd.SetRenderTarget(new RenderTarget2D(GraphicsDevice, 128, 128));
// (2)レンダリングターゲットをプライマリサーフェイスに戻す(と同時にまっさらになる)
// (1)のレンダーターゲットは影響を受けない。
gd.SetRenderTarget(null);
// (3)プライマリサーフェイスを塗りつぶす
gd.Clear(Color.CornflowerBlue);
base.Draw(gameTime);
}