HTTPDownloadEx Method

Description

Downloads an image from the HTTP server.

ActiveX Edition	Plug-in Edition	Mac Edition
Since V5.0	Since V5.0	Since V6.4

Syntax

Boolean ObjectName. HTTPDownloadEx(String HTTPServer, String HTTPRemoteFile, Long ImageType)

Parameters

String HTTPServer: the name of the HTTP server.

String HTTPRemoteFile: the name of the image to be downloaded. It should be the relative path of the file on the HTTP server.

Long ImageType: the image format of the file to be downloaded.

Return value

Boolean.

TRUE indicates success. FALSE indicates failure.

When an error occurs and IfThrowException property is TRUE, an exception will be thrown.

When FALSE is returned or an exception is thrown, check ErrorCode property and ErrorString property for error information.

Remarks

Dynamic Webcam processes the image format according to the value of the ImageType.

Allowed Values	ImageType
0	BMP
1	JPEG
2	TIFF
3	PNG
4	PDF

HTTPRemoteFile parameter should include the HTTP directory of the file.

The image downloaded will be displayed in Dynamic Webcam, just as it is acquired from a webcam.

See also

FTPUserName property, FTPPassword property, FTPPort property, ProxyServer property, FTPDownloadEx(), HTTPPort property, HTTPUserName property, HTTPPassword property, HTTPDownload(), HTTPUploadThroughPutEx(), HTTPUploadThroughPostEx()

Sample

A JavaScript sample is provided.

<script language="javascript" type="text/javascript">
Webcam = document.getElementById("iDynamicWebcam");//iDynamicWebcam is the id of the Dynamic Webcam on the page (An object or an embed).
  function btnHTTPDownloadEx_onclick() {
    Webcam.HTTPDownloadEx("localhost", "/webcam/Images/ImageData.jpg",1);
  }
	
</script>