Freigeben über

TextureLoader.FromFile-Methode (Device, String, Int32, Int32, Int32, Usage, Format, Pool, Filter, Filter, Int32, array<PaletteEntry[]%)

  • Artikel

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 einschließlich der Farbpalette 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, _
    <OutAttribute> ByRef palette As PaletteEntry() _
) 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 palette As PaletteEntry()
Dim returnValue As Texture

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

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,
    out PaletteEntry[] palette
)

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, 
    [OutAttribute] array<PaletteEntry>^% palette
)

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 * 
        palette:PaletteEntry[] byref -> Texture

Parameter

  • 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
    Anzahl der angeforderten mip-Ebenen.Wenn dieser Wert 0 (null) ist, wird eine vollständige Mipmap-Kette erstellt.
  • 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.

Ausnahmen

Ausnahme Bedingung
InvalidCallException

Der Methodenaufruf ist ungültig.Beispielsweise kann eine Methode Parameter einen ungültigen Wert enthalten.
OutOfMemoryException

Direct3D konnte nicht genügend Speicher um den Aufruf vollständig auszuführen.

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

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.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 3.5, 2.0

Siehe auch

Referenz

TextureLoader Klasse

Member TextureLoader

FromFile-Überladung

Microsoft.WindowsMobile.DirectX.Direct3D-Namespace