SaveToHTTP(Int32,DocumentFormat,Int32,String) Method

In This Topic

Saves a GdPicture image into a HTTP server. This method uses HTTP PUT protocol method.

Syntax

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

'Declaration
 
Public Overloads Function SaveToHTTP( _
   ByVal ImageID As Integer, _
   ByVal ImageFormat As DocumentFormat, _
   ByVal EncoderParameter As Integer, _
   ByVal Address As String _
) As GdPictureStatus

public GdPictureStatus SaveToHTTP( 
   int ImageID,
   DocumentFormat ImageFormat,
   int EncoderParameter,
   string Address
)

public function SaveToHTTP( 
    ImageID: Integer;
    ImageFormat: DocumentFormat;
    EncoderParameter: Integer;
    Address: String
): GdPictureStatus;

public function SaveToHTTP( 
   ImageID : int,
   ImageFormat : DocumentFormat,
   EncoderParameter : int,
   Address : String
) : GdPictureStatus;

public: GdPictureStatus SaveToHTTP( 
   int ImageID,
   DocumentFormat ImageFormat,
   int EncoderParameter,
   string* Address
)

public:
GdPictureStatus SaveToHTTP( 
   int ImageID,
   DocumentFormat ImageFormat,
   int EncoderParameter,
   String^ Address
)

Parameters

ImageID

GdPicture image identifier.

ImageFormat

A member of the DocumentFormat enumeration. Currently supported formats are:

DocumentFormatBMP.

DocumentFormatJPEG.

DocumentFormatPNG.

DocumentFormatTIFF.

DocumentFormatGIF.

DocumentFormatJ2K (JPEG2000 codestream).

DocumentFormatJP2 (JPEG2000)

DocumentFormatTARGA.

DocumentFormatEXR.

DocumentFormatWBMP.

DocumentFormatXPM.

DocumentFormatPBM.

DocumentFormatWMF.

DocumentFormatWEBP.

EncoderParameter

Compression or encoding quality to use.

For JPEG format: the parameter defines the quality between 1 (lower) and 100 (higher).

For WebP format: the parameter defines the quality between 1 (lower) and 100 (higher - lossless encoding).

For TIFF format: the parameter defines the compression scheme to be used: 1 for none, 2 for RLE, 3 for CCITT3, 4 for CCITT4, 5 for LZW, 7 for JPEG, 32946 for Deflate and 65536 for automatic compression adjustment. For more options the SaveAsTiff() method taking a Stream object as parameter can be used.

For JPEG2000 format: the parameter defines the compression rate Between [1(MaxQuality - Lossless) ... 512(Poor quality)]. Default value is 16.

For PNG format: the parameter defines the compression level Between [0(no compression - faster encoding) ... 9(max compression - slower encoding)]. Default value is 6.

For other formats use 0.

Address

Address of destination. IE: http://www.google.com/uploads/myimage.jpg.

Return Value

A member of the GdPictureStatus enumeration. If HTTP or FTP error status is returned the GetLastTransferError method can be used to diagnose the error.

Example

Saving an image to a file located on a distant server using HTTP transfer.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.bmp");
 
    // Set the packet size.
    gdpictureImaging.SetHttpTransferBufferSize(2048);
 
    if (gdpictureImaging.SaveToHTTP(imageID, GdPicture14.DocumentFormat.DocumentFormatJPEG, 75, "http://www.google.com/uploads/myimage.jpg") != GdPictureStatus.OK)
    {
        MessageBox.Show("Saving failed. Status: " + gdpictureImaging.GetStat() + "\nError: " + gdpictureImaging.GetLastTransferError(),
                        "Saving to HTTP", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
 
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
GetLastTransferError Method