Microsoft DirectX 9.0 SDK Update (October 2004)

TextureLoader.FromVolumeFile Method

Language:

Note: This documentation is preliminary and is subject to change.

Creates a volume texture from a file.

Definition

Visual Basic .NET Public Shared Function FromVolumeFile( _
    ByVal device As Device, _
    ByVal srcFile As String _
) As VolumeTexture
C# public static VolumeTexture FromVolumeFile(
    Device device,
    string srcFile
);
Managed C++ public: static VolumeTexture* FromVolumeFile(
    Device *device,
    String *srcFile
);
JScript .NET 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 Leave Site Direct3D could not allocate sufficient memory to complete the call.

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center