共用方式為


Texture3D.FromFile Method (GraphicsDevice, String, TextureCreationParameters)

Note

This method is available only when developing for Windows.

Creates a volume texture resource from a file, specifying the parameters to be used in creation of the texture.

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

Syntax

public static Texture3D FromFile (
         GraphicsDevice graphicsDevice,
         string filename,
         TextureCreationParameters creationParameters
)

Parameters

  • graphicsDevice
    The graphics device to use to create the texture resource.
  • filename
    The name of the file containing the texture.
  • creationParameters
    The parameters to use when creating this 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

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

Platforms

Windows XP SP2, Windows Vista