方法 : スプライトを使用します。
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
図面のイメージと画面にテキスト スプライトを使えます。 この例では描画とレンダリングを示します。
このコード例フォームが、次のオブジェクト。
このコード例は、スプライトを作成するファイルからテクスチャをロードします。 デバイスまたはエミュレーターに配置するプロジェクトに、小さいビットマップを追加する必要があります。
フォームのコンストラクターでは、デバイスの PresentationParameters プロパティの設定を指定 Device オブジェクトを作成し、デバイスの Reset メソッドを呼び出します。 Font オブジェクトを構築してもします。
次の表は、スプライトをレンダリングするサンプル メソッドです。
注意
マネージの Direct3D モバイル アプリケーションが、Pocket PC やスマートフォン Windows Mobile 5. 0 ソフトウェアを必要です。.NET の外部のリソース フレームワークを最適化します。 Windows Mobile ソフトウェアおよび SDK についてを参照してください。
メソッド |
アクション |
|---|---|
OnDeviceReset |
|
OnPaint |
|
使用例
完全な形を次のコード例に示します。 指定されたビットマップを使用して、スプライトを描画します。
Class Sprites
Inherits Form
' The objects that will be used to show ' the uses of the Sprite classPrivate device As Device
Private d3dFont As Microsoft.WindowsMobile.DirectX.Direct3D.Font
Private sprite As Sprite
Private texture As Texture
PublicSubNew()
Dim present As PresentParameters
Dim gdiFont As System.Drawing.Font
Me.Text = "Using Sprites"
' Give the application a way to be closed. ' This must be done before the device is created ' as it will cause the hwnd of the Form to change.Me.MinimizeBox = False
present = New PresentParameters()
present.Windowed = True
present.SwapEffect = SwapEffect.Discard
device = New Device(0, DeviceType.Default, Me, CreateFlags.None, present)
AddHandler device.DeviceReset, AddressOf OnDeviceReset
' Construct a new Sprite. ' Sprites do not need to be recreated ' when a device is reset.
sprite = New Sprite(device)
gdiFont = New System.Drawing.Font(FontFamily.GenericSansSerif, 10F, FontStyle.Regular)
' Construct a new font. Fonts do not need ' to be recreated when a device is reset.
d3dFont = New Microsoft.WindowsMobile.DirectX.Direct3D.Font(device, gdiFont)
OnDeviceReset(Nothing, EventArgs.Empty)
EndSubPrivateSub OnDeviceReset(ByVal sender AsObject, ByVal e As EventArgs)
' Textures must be recreated whenever a device is reset ' no matter what pool they are created in.
texture = TextureLoader.FromFile(device, "image.bmp")
EndSubProtectedOverridesSub OnPaintBackground(ByVal e As PaintEventArgs)
' Do nothing.EndSubProtectedOverridesSub OnPaint(ByVal e As PaintEventArgs)
' Begin the scene and clear the back buffer to black
device.BeginScene()
device.Clear(ClearFlags.Target, Color.Black, 1.0F, 0)
' When using sprites it is important to ' specify sprite flags passed to Sprite.Begin
sprite.Begin(SpriteFlags.SortTexture Or SpriteFlags.AlphaBlend)
' Draw an image to the screen using Sprite.DrawDim spriteY AsInteger = 5
sprite.Draw(texture, Vector3.Empty, New Vector3(0, spriteY, 0), Color.White.ToArgb())
spriteY += texture.GetLevelDescription(0).Height + 5
' Draw a portion of an image to the screen ' using Sprite.Draw. This shall be drawn such ' that the image is modulated with the color green.
sprite.Draw(texture, New Rectangle(4, 4, 24, 24), Vector3.Empty, New Vector3(0, spriteY, 0), Color.Green)
spriteY += 30
' Draw text to the screen. Using a sprite to draw text ' to the screen is essential for good performance. ' Otherwise the font object will perform a ' Sprite.Begin/Sprite.End internally for ' each call to Font.DrawText. This can cause severe ' performance problems.
spriteY = 150
d3dFont.DrawText(sprite, "This is text.", 5, spriteY, Color.Red)
spriteY += d3dFont.Description.Height + 5
d3dFont.DrawText(sprite, "This is another line of text.", 5, spriteY, Color.Green)
spriteY += d3dFont.Description.Height + 5
d3dFont.DrawText(sprite, "Only one call to Sprite.Begin.", 5, spriteY, Color.Blue)
' End drawing using this sprite. This will cause the ' sprites to be flushed to the graphics driver and will ' reset the transformation matrices, textures states, ' and renderstates if the SpriteFlags specified in Begin ' call for that to happen.
sprite.End()
' Finish the scene and present it on the screen.
device.EndScene()
device.Present()
EndSubSharedSub Main()
Application.Run(New Sprites())
EndSubEndClass
class Sprites : Form
{
// The objects that will be used to show// the uses of the Sprite classprivate Device device;
private Microsoft.WindowsMobile.DirectX.Direct3D.Font d3dFont;
private Sprite sprite;
private Texture texture;
public Sprites()
{
PresentParameters present;
System.Drawing.Font gdiFont;
this.Text = "Using Sprites";
// Give the application a way to be closed.// This must be done before the device is created// as it will cause the hwnd of the Form to change.this.MinimizeBox = false;
present = new PresentParameters();
present.Windowed = true;
present.SwapEffect = SwapEffect.Discard;
device = new Device(0, DeviceType.Default, this,
CreateFlags.None, present);
device.DeviceReset += new EventHandler(OnDeviceReset);
// Construct a new Sprite.// Sprites do not need to be recreated// when a device is reset.
sprite = new Sprite(device);
gdiFont = new System.Drawing.Font
(FontFamily.GenericSansSerif,
10.0f, FontStyle.Regular);
// Construct a new font. Fonts do not need// to be recreated when a device is reset.
d3dFont= new Microsoft.WindowsMobile.DirectX.Direct3D.Font
(device, gdiFont);
OnDeviceReset(null, EventArgs.Empty);
}
privatevoid OnDeviceReset(object sender, EventArgs e)
{
// Textures must be recreated whenever a device is reset// no matter what pool they are created in.
texture = TextureLoader.FromFile(device, "image.bmp");
}
protectedoverridevoid OnPaintBackground(PaintEventArgs e)
{
// Do nothing.
}
protectedoverridevoid OnPaint(PaintEventArgs e)
{
// Begin the scene and clear the back buffer to black
device.BeginScene();
device.Clear(ClearFlags.Target, Color.Black, 1.0f, 0);
// When using sprites it is important to// specify sprite flags passed to Sprite.Begin
sprite.Begin(SpriteFlags.SortTexture | SpriteFlags.AlphaBlend);
// Draw an image to the screen using Sprite.Drawint spriteY = 5;
sprite.Draw(texture, Vector3.Empty, new Vector3(0,
spriteY, 0),
Color.White.ToArgb());
spriteY += texture.GetLevelDescription(0).Height + 5;
// Draw a portion of an image to the screen// using Sprite.Draw. This shall be drawn such// that the image is modulated with the color green.
sprite.Draw(texture, new Rectangle(4, 4, 24, 24),
Vector3.Empty,
new Vector3(0, spriteY, 0), Color.Green);
spriteY+= 30;
// Draw text to the screen. Using a sprite to draw text// to the screen is essential for good performance.// Otherwise the font object will perform a// Sprite.Begin/Sprite.End internally for// each call to Font.DrawText. This can cause severe// performance problems.
spriteY = 150;
d3dFont.DrawText(sprite, "This is text.",
5, spriteY, Color.Red);
spriteY += d3dFont.Description.Height + 5;
d3dFont.DrawText(sprite, "This is another line of text.",
5, spriteY, Color.Green);
spriteY += d3dFont.Description.Height + 5;
d3dFont.DrawText(sprite, "Only one call to Sprite.Begin.",
5, spriteY, Color.Blue);
// End drawing using this sprite. This will cause the// sprites to be flushed to the graphics driver and will// reset the transformation matrices, textures states,// and renderstates if the SpriteFlags specified in Begin// call for that to happen.
sprite.End();
// Finish the scene and present it on the screen.
device.EndScene();
device.Present();
}
staticvoid Main()
{
Application.Run(new Sprites());
}
}
コードのコンパイル方法
この例では、次の名前空間への参照が必要です。
N:Microsoft.WindowsMobile.DirectX
N:Microsoft.WindowsMobile.DirectX.Direct3D
N:System.Drawing
堅牢性の高いプログラム
デバイスがリセットされる再作成する必要はありませんようににフォームのコンストラクターでスプライトとフォントを作成します。
優れたパフォーマンスには、スプライトを使用してテキストの描画します。 それ以外の場合は、フォント オブジェクト内部スプライト Begin と End メソッドに対して実行 DrawText を呼び出すたびします。
可能であれば、フレームごとに 1 つのスプライトを使用する場合は、スプライト Begin とするスプライトの End メソッドに 1 回の呼び出し内の入れ子にします。
レンダリングを最適化してパフォーマンスを向上する、次の SpriteFlags 値を指定します。
SortTexture は高速化できるテクスチャを切り替えるように画面に描画する前にイメージを並べ替えます。
AlphaBlend を透明または半透明の領域を持つスプライトの特にフォントを正しくレンダリングします。
SortDepthBackToFront はスプライトは互いの上に描画されるいくつかの半透明、または透明のスプライトをした場合に便利です - ライトバック前面に順序で並べ替えます。
DoNotSaveState は指定されたレンダリング ステートを使用できないアプリケーションのパフォーマンスが向上します。
DoNotModifyRenderState 現在のレンダリング ステートを使用してパフォーマンスを最適化され、特殊効果で使用されることができます。
ObjectSpace および Billboard はさまざまな特殊効果と描画 (イメージを使用します。
参照
概念
.NET コンパクトなフレームワーク方法を説明したトピックの検索