GdPicture.NET.14.API
GdPicture14 Namespace / GdPictureImaging Class / SaveToHTTP Method / SaveToHTTP(Int32,DocumentFormat,Int32,String,String,String) Method
GdPicture image identifier.
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.

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 of destination. IE: http://www.google.com/uploads/myimage.jpg.
User Login.
User Password.
Example





In This Topic
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
'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);
}
See Also