TextureLoader.FromFile-Methode (Device, String, Int32, Int32, Int32, Usage, Format, Pool, Filter, Filter, Int32)

Artikel
11/08/2009

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Erstellt eine Textur mit den angegebenen Eigenschaften aus einer Datei.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
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
'Usage
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

Parameter

device
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Device
Das Gerät die Textur zugeordnet.

srcFile
Typ: System.String
Der Name der Datei aus dem die Struktur erstellt.

width
Typ: System.Int32
Die Breite der Textur in Pixel.Wenn dieser Wert 0 (null) ist, werden die Abmessungen aus der Datei entnommen.

height
Typ: System.Int32
Die Höhe der Textur in Pixel.Wenn dieser Wert 0 (null) ist, werden die Abmessungen aus der Datei entnommen.

mipLevels
Typ: System.Int32
Die Anzahl der angeforderten mip-Ebenen.Wenn dieser Wert 0 (null) ist, wird eine vollständige Mipmap-Kette erstellt.

usage
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Usage
Geben Sie 0 (null) oder Usage Wert.Geben Sie RenderTarget, um anzugeben, dass die Oberfläche als ein Renderingziel verwendet werden.Die Ressource kann dann dem renderTarget -Parameter, der ein SetRenderTarget Device-Methode übergeben werden.Die Anwendung fest, ob das Gerät diese Operation unterstützt, mithilfe der CheckDeviceFormat -Methode von einer Manager.Geben Sie Dynamic an, dass die Oberfläche dynamisch behandelt werden soll.

format
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Das angeforderte Pixelformat für die Würfeltextur.

pool
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Pool
Die Speicher-Klasse in der die Würfeltextur platziert werden soll.

filter
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Filter
Eine oder mehrere Flags, die steuern, wie das Bild gefiltert wird.

mipFilter
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Filter
Eine oder mehrere Flags, die der Mipmaps gesteuert werden.

colorKey
Typ: System.Int32
Ein Wert, durch transparent Schwarz oder 0 (null) So deaktivieren Sie den Colorkey ersetzen. colorKey ist immer eine 32-Bit-ARGB-Farbe, die das Bildformat Datenquelle unabhängig ist.Alpha ist von Bedeutung, und in der Regel sollte festgelegt werden, FF für nicht transparente Farbe Schlüssel.Für nicht transparentes Schwarz ist der Wert gleich 0xFF000000.

Rückgabewert

Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Texture
Das Objekt erstellte Textur.

Hinweise

Diese Methode unterstützt die folgenden Dateiformate: .bmp, .DDS, .jpg, .PNG und GIF.

Um die bestmögliche Leistung mit dieser Methode abzurufen, Folgendes ein:

Bild skalieren und Format Konvertierung zur Ladezeit ausführen, kann langsam sein.Speichern Sie Bilder im Format und Auflösung in der Sie verwendet werden.Wenn die Zielhardware die Potenz von zwei Dimensionen erfordert, verwenden Sie Potenz von zwei Dimensionen, um erstellen und Speichern der Bilder.
Mipmap-Abbilderstellung zur Ladezeit Wenn Sie mithilfe des Box Filtertyps filtern.Ein Feld Filter ist wesentlich schneller als einige der anderen Filtertypen.
DirectDraw Oberfläche (DDS) Dateien in Erwägung.Da DDS-Dateien verwendet werden können, um alle Microsoft DirectX-Texturformat darzustellen, werden Sie von dieser Methode problemlos gelesen werden.Darüber hinaus können Sie Mipmaps, speichern, der bedeutet, dass alle Mipmap-Generation-Algorithmus verwendet werden kann, um die Bilder zu erstellen.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Plattformen

Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

Die .NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET framework.