TextureLoader.FromFile メソッド (Device, String, Int32, Int32, Int32, Usage, Format, Pool, Filter, Filter, Int32)

[アーティクル]
11/03/2009

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。空白のトピックは、プレースホルダーとして挿入されています。]

指定したプロパティを持つテクスチャをファイルから作成します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)

構文

'宣言
Public Shared Function FromFile ( _
    device As Device, _
    srcFile As String, _
    width As Integer, _
    height As Integer, _
    mipLevels As Integer, _
    usage As Usage, _
    format As Format, _
    pool As Pool, _
    filter As Filter, _
    mipFilter As Filter, _
    colorKey As Integer _
) As Texture
'使用
Dim device As Device
Dim srcFile As String
Dim width As Integer
Dim height As Integer
Dim mipLevels As Integer
Dim usage As Usage
Dim format As Format
Dim pool As Pool
Dim filter As Filter
Dim mipFilter As Filter
Dim colorKey As Integer
Dim returnValue As Texture

returnValue = TextureLoader.FromFile(device, _
    srcFile, width, height, mipLevels, _
    usage, format, pool, filter, mipFilter, _
    colorKey)

public static Texture FromFile(
    Device device,
    string srcFile,
    int width,
    int height,
    int mipLevels,
    Usage usage,
    Format format,
    Pool pool,
    Filter filter,
    Filter mipFilter,
    int colorKey
)

public:
static Texture^ FromFile(
    Device^ device, 
    String^ srcFile, 
    int width, 
    int height, 
    int mipLevels, 
    Usage usage, 
    Format format, 
    Pool pool, 
    Filter filter, 
    Filter mipFilter, 
    int colorKey
)

static member FromFile : 
        device:Device * 
        srcFile:string * 
        width:int * 
        height:int * 
        mipLevels:int * 
        usage:Usage * 
        format:Format * 
        pool:Pool * 
        filter:Filter * 
        mipFilter:Filter * 
        colorKey:int -> Texture

パラメーター

device
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Device
テクスチャに関連付けるデバイス。

srcFile
型 : System.String
テクスチャの作成元のファイルの名前。

width
型 : System.Int32
テクスチャの幅 (ピクセル単位)。この値が 0 (ゼロ) の場合、寸法はファイルから取得されます。

height
型 : System.Int32
テクスチャの高さ (ピクセル単位)。この値が 0 (ゼロ) の場合、寸法はファイルから取得されます。

mipLevels
型 : System.Int32
要求される MIP レベルの数。この値が 0 (ゼロ) の場合、完全な MIPMAP チェーンが作成されます。

usage
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Usage
0 (ゼロ) または Usage 値を指定します。サーフェイスをレンダリング先として使用することを示す場合は、RenderTarget を指定します。その後、リソースを SetRenderTarget の Device メソッドの renderTarget パラメーターに渡すことができます。アプリケーションは、CheckDeviceFormat の Manager メソッドを使用して、デバイスがこの操作をサポートしているかどうかを確認する必要があります。サーフェイスを動的に処理する必要があることを示すには、Dynamic を指定します。

format
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Format
キューブテクスチャに必要なピクセル形式。

pool
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Pool
キューブテクスチャを格納するメモリクラス。

filter
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Filter
イメージをフィルター処理する方法を制御する 1 つ以上のフラグ。

mipFilter
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Filter
MIPMAP をフィルター処理する方法を制御する 1 つ以上のフラグ。

colorKey
型 : System.Int32
透明な黒またはカラーキーを無効に 0 (ゼロ) に置き換える値。 colorKey は常に、ソースイメージの形式とは無関係である 32 ビット ARGB カラー、です。アルファは有意であり、通常、カラーキーを不透明にする場合は FF に設定する必要があります。たとえば、不透明な黒の場合、値は 0xFF000000 となります。

戻り値

型 : Microsoft.WindowsMobile.DirectX.Direct3D.Texture
作成されたテクスチャオブジェクト。

解説

このメソッドは、次のファイル形式をサポートします。.bmp、.dds、.jpg、.png、および.gif です。

このメソッドで最高のパフォーマンスを得るには、次の点を考慮してください。

読み込み時にイメージのスケーリングや形式変換を実行すると、処理に時間がかかることがあります。イメージは、使用するときの形式と解像度で保存してください。対象のハードウェアで 2 の累乗の寸法が要求される場合は、2 の累乗の寸法を使用してイメージを作成および保存してください。
読み込み時に MIPMAP イメージを作成する場合は、Box フィルターを使用してフィルター処理を行ってください。ボックスフィルターは、他の種類のフィルターよりも処理が高速です。
DirectDraw Surface (DDS) ファイルを使用することを検討してください。DDS ファイルは、すべての Microsoft DirectX テクスチャ形式を表すことができるため、このメソッドで簡単に読み取ることができます。また、MIPMAP も保存できるので、任意の MIPMAP 生成アルゴリズムを使用してイメージを作成できます。

.NET Framework セキュリティ

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

プラットフォーム

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

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。

バージョン情報

.NET Compact Framework

サポート対象 : 3.5、2.0

参照

TextureLoader クラス

TextureLoader メンバー

FromFile オーバーロード

Microsoft.WindowsMobile.DirectX.Direct3D 名前空間

次の方法で共有