MonoGame/クラスライブラリ/RenderTargetUsage列挙体 - 版の履歴

Administrator: /* DiscardContentsの注意点 */

2020-09-15T02:45:37Z

DiscardContentsの注意点

← 古い版		2020年9月15日 (火) 02:45時点における版
52行目:		52行目:
	// プライマリサーフェイスは問答無用でDiscardContents設定なので		// プライマリサーフェイスは問答無用でDiscardContents設定なので
	// 内容はクリアされ（１）の塗りつぶしは無かったことにされる。		// 内容はクリアされ（１）の塗りつぶしは無かったことにされる。
	// ~~（２）のレンダーターゲットは影響を受けない。~~		// なお、（２）のレンダーターゲットは影響を受けない。
	gd.SetRenderTarget(null);		gd.SetRenderTarget(null);

Administrator: /* DiscardContentsの注意点 */

2020-09-15T02:45:10Z

DiscardContentsの注意点

← 古い版		2020年9月15日 (火) 02:45時点における版
35行目:		35行目:
	</source>		</source>

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

	このため、たとば以下のコードは正常に動作しない。		このため、たとば以下のコードは正常に動作しない。

Administrator: /* DiscardContentsの注意点 */

2020-09-15T02:44:44Z

DiscardContentsの注意点

← 古い版		2020年9月15日 (火) 02:44時点における版
30行目:		30行目:

	=== DiscardContentsの注意点 ===		=== DiscardContentsの注意点 ===
	~~DiscardContentsは「GraphicsDevice~~.SetRenderTargetするたびに破棄（初期化）される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。		DiscardContents設定になっていると「GraphicsDevice.SetRenderTargetするたびに破棄（初期化）される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。
	<source lang="csharp">		<source lang="csharp">
	GraphicsDevice.SetRenderTarget(このRenderTargetは初期化される);		GraphicsDevice.SetRenderTarget(このRenderTargetは初期化される);

2020年9月15日 (火) 02:42にAdministratorによる

2020-09-15T02:42:57Z

← 古い版		2020年9月15日 (火) 02:42時点における版
50行目:		50行目:

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

2020年9月15日 (火) 02:41にAdministratorによる

2020-09-15T02:41:44Z

← 古い版		2020年9月15日 (火) 02:41時点における版
30行目:		30行目:

	=== DiscardContentsの注意点 ===		=== DiscardContentsの注意点 ===
	GraphicsDeviceが最初から持っているレンダリングターゲット（[[DirectX]]でいう[[プライマリサーフェイス]]）に相当するものはDiscardContentsに設定されている。		DiscardContentsは「GraphicsDevice.SetRenderTargetするたびに破棄（初期化）される」という特徴がある。この特性があるためレンダリング系APIの呼出順序を間違えると残念なことになる。
	~~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)		protected override void Draw(GameTime gameTime)
	{		{
	~~// （１）プライマリサーフェイスを塗りつぶす~~		var gd = _graphics.GraphicsDevice;
	_graphics.GraphicsDevice~~.Clear(Color.CornflowerBlue)~~;

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

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

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

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

imported>Administrator: /* 名前空間 */

2017-11-09T01:04:06Z

名前空間

← 古い版		2017年11月9日 (木) 01:04時点における版
2行目:		2行目:

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

	== 構文 ==		== 構文 ==

2017年11月8日 (水) 14:03に162.158.255.54による

2017-11-08T14:03:46Z

← 古い版		2017年11月8日 (水) 14:03時点における版
77行目:		77行目:
	* [[MonoGame/クラスライブラリ/CubeMapFace列挙体\|CubeMapFace列挙体]]		* [[MonoGame/クラスライブラリ/CubeMapFace列挙体\|CubeMapFace列挙体]]
	* [[MonoGame/クラスライブラリ/RenderTargetBinding構造体\|RenderTargetBinding構造体]]		* [[MonoGame/クラスライブラリ/RenderTargetBinding構造体\|RenderTargetBinding構造体]]
			* [[MonoGame/クラスライブラリ/RenderTargetUsage列挙体\|RenderTargetUsage列挙体]]

	[[category: MonoGame]]		[[category: MonoGame]]

imported>Administrator: /* DiscardContentsの注意点 */

2017-11-08T08:59:19Z

DiscardContentsの注意点

← 古い版		2017年11月8日 (水) 08:59時点における版
30行目:		30行目:

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

2017年11月8日 (水) 08:58にimported>Administratorによる

2017-11-08T08:58:56Z

← 古い版		2017年11月8日 (水) 08:58時点における版
1行目:		1行目:
	RenderTargetUsage列挙体は、グラフィックデバイス（[[MonoGame/クラスライブラリ/GraphicsDeviceクラス\|GraphicsDeviceクラス]]）に新たなレンダリングターゲット（[[MonoGame/クラスライブラリ/RenderTarget2Dクラス\|RenderTarget2Dクラス]]）を設定したとき、そのレンダリングターゲットの[[データ]]~~をどのように処理するかを指定するのに使用する列挙体である。~~		RenderTargetUsage列挙体は、グラフィックデバイス（[[MonoGame/クラスライブラリ/GraphicsDeviceクラス\|GraphicsDeviceクラス]]）に新たなレンダリングターゲット（[[MonoGame/クラスライブラリ/RenderTarget2Dクラス\|RenderTarget2Dクラス]]）を設定したとき、そのレンダリングターゲットの[[データ]]をどのように処理するかを指定するのに使用する[[列挙体]]である。

	== 名前空間 ==		== 名前空間 ==

imported>Administrator: /* PreserveContentsは遅い */

2017-11-08T08:57:12Z

PreserveContentsは遅い

← 古い版		2017年11月8日 (水) 08:57時点における版
25行目:		25行目:
	== 備考 ==		== 備考 ==
	=== PreserveContentsは遅い ===		=== PreserveContentsは遅い ===
	~~PreserveContentsはVRAM容量が少ない環境ではメインメモリへの保存と復元が発生するため絶望的なほど遅くなる。~~		PreserveContentsは[[VRAM]]容量が少ない環境では[[メインメモリ]]への保存と復元が発生するため絶望的なほど遅くなる。
	[[PC]]~~ではまず問題になることはないようだだが、一部の~~[[スマホ]]では絶望的な速度になるようだ。		[[PC]]ではまず問題になることはないようだが、一部の[[スマホ]]では絶望的な速度になるようだ。
	なるべくDiscardContentsを使ったほうが良さそうだ。		なるべくDiscardContentsを使ったほうが良さそうだ。