SaveToHTTP(Int32,DocumentFormat,Int32,String,String,String) Method

In This Topic

Saves a GdPicture image into a HTTP server using authentication. 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, _
   ByVal Login As String, _
   ByVal Password As String _
) As GdPictureStatus

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

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

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

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

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

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.

Login

User Login.

Password

User Password.

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.

Remarks

This method requires the Image Documents component to run.

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", "user", "password") != GdPictureStatus.OK)
    {
        MessageBox.Show("Saving failed. Status: " + gdpictureImaging.GetStat() + "\nError: " + gdpictureImaging.GetLastTransferError(),
                        "Saving using HTTP", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
 
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
GetLastTransferError Method