TextureLoader.FromVolumeFile Method

Language:

Creates a volume texture from a file.

Definition

Visual Basic Public Shared Function FromVolumeFile( _
    ByVal device As Device, _
    ByVal srcFile As String _
) As VolumeTexture

C# public static VolumeTexture FromVolumeFile(
    Device device,
    string srcFile
);

C++ public:
static VolumeTexture^ FromVolumeFile(
    Device^ device,
    String^ srcFile
);

JScript public static function FromVolumeFile(
    device : Device,
    srcFile : String
) : VolumeTexture;

Visual Basic	Public Shared Function FromVolumeFile( _ ByVal device As Device, _ ByVal srcFile As String _ ) As VolumeTexture
C#	public static VolumeTexture FromVolumeFile( Device device, string srcFile );
C++	public: static VolumeTexture^ FromVolumeFile( Device^ device, String^ srcFile );
JScript	public static function FromVolumeFile( device : Device, srcFile : String ) : VolumeTexture;

Parameters

device Microsoft.DirectX.Direct3D.Device
A Device object that represents the device to associate with the volume texture.

srcFile System.String
String that specifies the file name.

Return Value

Microsoft.DirectX.Direct3D.VolumeTexture
Address of a pointer to a VolumeTexture object that represents the created texture object.

Remarks

This method supports the following file formats: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, and .tga.

Each level of a mipmapped texture is automatically filled with the loaded volume texture. When loading images into mipmapped textures, some devices are unable to switch to a 1x1 image. If this happens, the method fails, and the images must be loaded manually.

Exceptions

InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.

InvalidDataException The data is invalid.

NotAvailableException This device does not support the queried technique.

OutOfVideoMemoryException Microsoft Direct3D does not have enough display memory to perform the operation.

OutOfMemoryException Direct3D could not allocate sufficient memory to complete the call.

device	Microsoft.DirectX.Direct3D.Device A Device object that represents the device to associate with the volume texture.
srcFile	System.String String that specifies the file name.

InvalidCallException	The method call is invalid. For example, a method's parameter might contain an invalid value.
InvalidDataException	The data is invalid.
NotAvailableException	This device does not support the queried technique.
OutOfVideoMemoryException	Microsoft Direct3D does not have enough display memory to perform the operation.
OutOfMemoryException	Direct3D could not allocate sufficient memory to complete the call.