Device.UpdateTexture メソッド

.NET Framework クラス ライブラリ リファレンス

Device.UpdateTexture メソッド

テクスチャのダーティ部分を更新します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)
構文

Visual Basic (宣言)

Public Sub UpdateTexture ( _
    sourceTexture As BaseTexture, _
    destinationTexture As BaseTexture _
)

Visual Basic (使用法)

Dim instance As Device
Dim sourceTexture As BaseTexture
Dim destinationTexture As BaseTexture

instance.UpdateTexture(sourceTexture, destinationTexture)

C#

public void UpdateTexture (
    BaseTexture sourceTexture,
    BaseTexture destinationTexture
)

C++

public:
void UpdateTexture (
    BaseTexture^ sourceTexture, 
    BaseTexture^ destinationTexture
)

J#

public void UpdateTexture (
    BaseTexture sourceTexture, 
    BaseTexture destinationTexture
)

JScript

public function UpdateTexture (
    sourceTexture : BaseTexture, 
    destinationTexture : BaseTexture
)

パラメータ

sourceTexture

転送元テクスチャを表す BaseTexture オブジェクト。これは、SystemMemory で指定されているシステム メモリ内にある必要があります。

destinationTexture

転送元テクスチャを表す BaseTexture オブジェクト。

例外

例外の種類	条件
InvalidCallException	メソッドの呼び出しが無効です。たとえば、パラメータに無効な値が含まれている場合などです。

解説

テクスチャの一部分をダーティにするには、その部分をロックするか、または AddDirtyRectangle を呼び出します。

UpdateTexture は、最後の更新処理後に蓄積された処理を計算することにより、テクスチャのダーティ部分を取得します。

パフォーマンス上の理由により、ダーティ領域はレベル 0 のテクスチャに対してのみ記録されます。サブレベルについては、対応する (スケーリングされた) 四角形またはボックスもダーティであると見なされます。ダーティ領域は、NoDirtyUpdate または ReadOnly を指定せずに LockRectangle を呼び出した場合に自動的に記録されます。また、UpdateTexture の転送先サーフェイスは、ダーティとしてマークされます。

転送元と転送先のテクスチャの種類が異なる場合、最下位バッファのサイズが異なる場合、または一致レベルが一致しない場合、このメソッドは失敗します。たとえば、次のような大きさの 6 つの レベルの転送元テクスチャがあるとします。

32x16, 16x8, 8x4, 4x2, 2x1, 1x1

この 6 つのレベルの転送元テクスチャは、次の 1 つのレベルの転送先の転送元になる場合があります。

1x1

次の 2 つのレベルの転送先になる場合もあります。

2x1, 1x1

または、次の 3 つのレベルの転送先になる場合もあります。

4x2, 2x1, 1x1

また、テクスチャの形式が異なる場合、このメソッドは失敗します。転送先テクスチャのレベル数が転送元より少ない場合は、一致するレベルだけがコピーされます。転送元テクスチャのレベル数が転送先より少ない場合は、メソッドは失敗します。

転送元テクスチャにダーティ領域がある場合は、コピーをその領域だけに限定することにより、コピー処理を最適化できます。ダーティとしてマークされているバイトだけがコピーされるという保証はありません。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Device クラス
Device メンバ
Microsoft.WindowsMobile.DirectX.Direct3D 名前空間