TextureLoader.FromCubeStream Method ()

  • Article

Creates a cube texture from a file in memory.

Overload List

public static CubeTexture FromCubeStream(Device, Stream);
public static CubeTexture FromCubeStream(Device, Stream, int);
public static CubeTexture FromCubeStream(Device, Stream, int, int, int, Usage, Format, Pool, Filter, Filter, int);
public static CubeTexture FromCubeStream(Device, Stream, int, int, int, Usage, Format, Pool, Filter, Filter, int, ref ImageInformation);
public static CubeTexture FromCubeStream(Device, Stream, int, int, int, Usage, Format, Pool, Filter, Filter, int, ref ImageInformation, out PaletteEntry);
public static CubeTexture FromCubeStream(Device, Stream, int, int, int, Usage, Format, Pool, Filter, Filter, int, out PaletteEntry);
public static CubeTexture FromCubeStream(Device, Stream, int, int, Usage, Format, Pool, Filter, Filter, int);
public static CubeTexture FromCubeStream(Device, Stream, int, int, Usage, Format, Pool, Filter, Filter, int, ref ImageInformation);
public static CubeTexture FromCubeStream(Device, Stream, 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.

OutOfMemoryExceptionLeave Site

Direct3D could not allocate sufficient memory to complete the call.

See Also