Microsoft DirectX 9.0 SDK Update (October 2004)

TextureLoader.FromCubeStream Method

Language:

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

Creates a cube texture from a file in memory.

Definition

Visual Basic .NET Public Shared Function FromCubeStream( _
    ByVal device As Device, _
    ByVal stream As Stream _
) As CubeTexture
C# public static CubeTexture FromCubeStream(
    Device device,
    Stream stream
);
Managed C++ public: static CubeTexture* FromCubeStream(
    Device *device,
    Stream *stream
);
JScript .NET public static function FromCubeStream(
    device : Device,
    stream : Stream
) : CubeTexture;

Parameters

device Microsoft.DirectX.Direct3D.Device. A Device object that represents the device to associate with the cube texture.
stream System.IO.Stream. A Stream Leave Site from which to create the cube texture. See Remarks.

Return Value

Microsoft.DirectX.Direct3D.CubeTexture . A CubeTexture object that represents the created cube texture object.

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