CreateGdPictureImageFromString Method (GdPictureImaging)

In This Topic

Creates a new GdPicture image from image data stored within string data (Encoding 1252).

Syntax

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

'Declaration
 
Public Function CreateGdPictureImageFromString( _
   ByVal ImageData As String _
) As Integer

public int CreateGdPictureImageFromString( 
   string ImageData
)

public function CreateGdPictureImageFromString( 
    ImageData: String
): Integer;

public function CreateGdPictureImageFromString( 
   ImageData : String
) : int;

public: int CreateGdPictureImageFromString( 
   string* ImageData
)

public:
int CreateGdPictureImageFromString( 
   String^ ImageData
)

Parameters

ImageData: String which contains the image file data.

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

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.

This method requires the Image Documents component to run.

Example

Creating a GdPicture image from an image file stored in a string and saving to a PNG file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
using (Stream stream = File.Open("image.bmp", FileMode.Open))
{
    // Load the file to a buffer for the sake of demonstration.
    // In a production context, the image file should be obviously loaded with CreateGdPictureImageFromFile.
    int size = (int)stream.Seek(0, SeekOrigin.End);
    byte[] buffer = new byte[size];
    stream.Seek(0, SeekOrigin.Begin);
    stream.Read(buffer, 0, size);
 
    // Encode the buffer to a string
    string encodedBuffer = Encoding.GetEncoding(1252).GetString(buffer, 0, size);
 
    // Create the GdPicture image and save it as a PNG.
    int imageID = gdpictureImaging.CreateGdPictureImageFromString(encodedBuffer);
    gdpictureImaging.SaveAsPNG(imageID, "image.png");
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
GetStat Method