CreateGdPictureImageFromStream(Stream,DocumentFormat) Method

In This Topic

Creates a new GdPicture image from an image stored into a Stream Object. This method uses a GdPicture DocumentFormat enumerator.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function CreateGdPictureImageFromStream( _
   ByVal Stream As Stream, _
   ByVal ImageFormat As DocumentFormat _
) As Integer

public int CreateGdPictureImageFromStream( 
   Stream Stream,
   DocumentFormat ImageFormat
)

public function CreateGdPictureImageFromStream( 
    Stream: Stream;
    ImageFormat: DocumentFormat
): Integer;

public function CreateGdPictureImageFromStream( 
   Stream : Stream,
   ImageFormat : DocumentFormat
) : int;

public: int CreateGdPictureImageFromStream( 
   Stream* Stream,
   DocumentFormat ImageFormat
)

public:
int CreateGdPictureImageFromStream( 
   Stream^ Stream,
   DocumentFormat ImageFormat
)

Parameters

Stream: System.IO.Stream object storing the image data.
ImageFormat: A member of the DocumentFormat enumeration specifying the input image format.

Return Value

0: The image could not be created. Use the GetStat() method to determine the reason this method failed. Non-zero: GdPicture image identifier. The created image. The ReleaseGdPictureImage() method must be subsequently used to release the image from the memory.

Remarks

The provided stream must support seeking.

Supported formats are listed here: http://www.gdpicture.com/solutions/supported-formats/.

Notes for multipage images (TIFF and GIF): By default, the class loads multipage images (GIF and TIFF) in read & write mode. To open multipage images in read-only mode call the TiffOpenMultiPageForWrite() method specifying False for tiff images or the GifOpenMultiFrameForWrite() method for gif images. If the image is a multipage file (TIFF, JBIG2, GIFF), the stream should be kept open until the image is released.

Example

Cloning an area of a jpeg image into a new jpeg image using streams.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    using (System.IO.Stream inputStream = new System.IO.FileStream("image.jpg", System.IO.FileMode.Open))
    {
        int imageID1 = gdpictureImaging.CreateGdPictureImageFromStream(inputStream, GdPicture14.DocumentFormat.DocumentFormatJPEG);
        //Clone an area of the source image into a mew image.
        int imageID2 = gdpictureImaging.CreateClonedGdPictureImageArea(imageID1, 50, 50, 100, 250);
        //Process the cloned image.
        gdpictureImaging.FxPixelize(imageID2);
        using (System.IO.Stream outputStream = new System.IO.FileStream("output.png", System.IO.FileMode.CreateNew))
        {
            //Save a result into a new image file.
            gdpictureImaging.SaveAsStream(imageID2, outputStream, GdPicture14.DocumentFormat.DocumentFormatPNG, 6);
        }
        gdpictureImaging.ReleaseGdPictureImage(imageID2);
        gdpictureImaging.ReleaseGdPictureImage(imageID1);
    }
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
GetStat Method