Share via

Texture2D.FromFile Method (GraphicsDevice, String)

Note

This method is available only when developing for Windows.

Creates a texture resource from a file.

Namespace: Microsoft.Xna.Framework.Graphics
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public static Texture2D FromFile (
         GraphicsDevice graphicsDevice,
         string filename
)

Parameters

  • graphicsDevice
    The graphics device to use to create the texture resource.
  • filename
    The name of the file containing the texture.

Return Value

The texture resource that has been created on the specified graphics device.

Exceptions

Exception type Condition
ArgumentException filename is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
ArgumentNullException filename is null.
PathTooLongException The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
DirectoryNotFoundException The specified path is invalid (for example, it is on an unmapped drive).
UnauthorizedAccessException The filename parameter specifies a directory, or the caller does not have the required permission to access the file specified by filename.
FileNotFoundException The file specified in filename was not found.
NotSupportedException filename is in an invalid format.

Remarks

The supported texture image file formats are described by the ImageFileFormat enumeration.

See Also

Reference

Texture2D Class
Texture2D Members
Microsoft.Xna.Framework.Graphics Namespace

Platforms

Windows XP SP2, Windows Vista