Microsoft DirectX 9.0 SDK Update (October 2004)

TextureLoader.FromCubeFile Method

Language:

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

Creates a cube texture from a file.

Overload List

public static CubeTexture FromCubeFile(Device, string);
public static CubeTexture FromCubeFile(Device, string, int, int, Usage, Format, Pool, Filter, Filter, int);
public static CubeTexture FromCubeFile(Device, string, int, int, Usage, Format, Pool, Filter, Filter, int, ref ImageInformation);
public static CubeTexture FromCubeFile(Device, string, int, int, Usage, Format, Pool, Filter, Filter, int, ref ImageInformation, out PaletteEntry);
public static CubeTexture FromCubeFile(Device, string, int, int, Usage, Format, Pool, Filter, Filter, int, out PaletteEntry);

Remarks

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

Cube textures differ from other surfaces in that they are collections of surfaces. To call Device.SetRenderTarget with a cube texture, select an individual face using CubeTexture.GetCubeMapSurface and pass the resulting surface to Device.SetRenderTarget.

The TextureLoader.FromCubeFile method uses the Microsoft® DirectDraw® surface (DDS) file format. The DXTex tool enables generation of a cube map from other file formats, and saves it as a .dds file.

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