SurfaceLoader.SaveToStream Method

 Language:

Saves a surface to a stream.

Definition

Visual Basic Public Shared Function SaveToStream( _
    ByVal destFormat As ImageFileFormat, _
    ByVal srcSurface As Surface, _
    ByRef sourcePalette As PaletteEntry, _
    ByVal srcRectangle As Rectangle _
) As GraphicsStream
C# public static GraphicsStream SaveToStream(
    ImageFileFormat destFormat,
    Surface srcSurface,
    out PaletteEntry sourcePalette,
    Rectangle srcRectangle
);
C++ public:
static GraphicsStream^ SaveToStream(
    ImageFileFormat destFormat,
    Surface^ srcSurface,
    [Out] PaletteEntry% sourcePalette,
    Rectangle srcRectangle
);
JScript public static function SaveToStream(
    destFormat : ImageFileFormat,
    srcSurface : Surface,
    sourcePalette : PaletteEntry,
    srcRectangle : Rectangle
) : GraphicsStream;

Parameters

destFormat Microsoft.DirectX.Direct3D.ImageFileFormat
An ImageFileFormat object that specifies the file format to use when saving the surface to a stream. This method supports saving to all ImageFileFormat types except Portable Pixmap (.ppm) and Targa/Truevision Graphics Adapter (.tga).
srcSurface Microsoft.DirectX.Direct3D.Surface
A Surface object that represents the source surface to save to a file.
sourcePalette Microsoft.DirectX.Direct3D.PaletteEntry[]
A PaletteEntry array that contains the source palette entries.
srcRectangle System.Drawing.Rectangle
A Rectangle Leave Site object that represents the source rectangle.

Return Value

Microsoft.DirectX.GraphicsStream
A GraphicsStream object that contains the saved surface data.

Remarks

This method handles conversion to and from compressed texture formats.

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

Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.

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