IKJ2kFileSaveEx

This function saves raster image data, including exif information, in a JPEG file.

[C++Builder/Visual C++] BOOL IKJpegFileSaveEx(LPCTSTR FileName, HANDLE Handle, int Type, int Quality, int SubSamp, LPCSTR Comment, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button, PTR_EXIF_INFO exifInfo);

[Delphi] function IKJpegFileSaveEx(FileName: PChar; Handle: THandle; Type_, Quality, SubSamp: Integer; Comment: PAnsiChar; UserProc: LONG_PTR; Caption, Message, Button: PChar; var ExifInfo: EXIF_INFO): LongBool;

[Visual Basic] Function IKJpegFileSaveEx(ByVal FileName As String, ByVal Handle As Long, ByVal Type As Long, ByVal Quality As Long, ByVal SubSamp As Long, ByVal Comment As String, ByVal UserProc As Long, ByVal Caption As String, ByVal Message As String, ByVal Button As String, ExifInfo As EXIF_INFO) As Long

Parameters

Name	Explanation
FileName	The name of the file where the image data is saved
Handle	The image handle of the raster image
Type	0: Standard DCT, 1: ProgressiveDCT
Quality	JPEG compression quality coefficient (from 0 to 100: 75 is recommended)
SubSamp	Subsampling (enabled for 24 bit color). Y:Cb:Cr (0: 4:1:1, 1: 4:2:2, 2: 4:4:4)
Comment	The comment text to be saved (MAX:1023 bytes)
UserProc	The address of the user function (If not using the user function then set to 0)
Caption	Sets the text displayed in the title bar of the progress dialog box
Message	Sets the message displayed in the progress dialog box
Button	Sets the name of the button displayed in the progress dialog box
ExifInfo	Exif information structured variable (user defined)

Return Value

Returns True (nonzero) if successful. Returns False (0) if unsuccessful.

Explanation

The IKJpegFileSave function saves raster image data, including exif information, in a JPEG file. Supports 8 bit grayscale and 24 bit color. In the SubSamp parameter, Y refers to luminance, Cr and Cb refer to chrominance.

If the user function is set or if the Caption, Message, and Button parameters are blank then the Progress dialog box is not displayed. If the Progress dialog box is displayed, it indicates the percentage of the current process completed. For more information about the user function please refer to the Definition of User Function in the Ik9File.dll, Ik9FileA.dll, Ik9File64.dll, Ik9File64A.dll section.

For information regarding EXIF_INFO, please see the explanation of the EXIF_INFO member variables in the Ik9File.dll, Ik9FileA.dll, Ik9File64.dll, Ik9File64A.dll section.

For more information about the user function please refer to the Definition of User Function in the Ik9File.dll, Ik9FileA.dll, Ik9File64.dll, Ik9File64A.dll section.

It is possible to save the file directly to FTP server or HTTP(S) server by setting the FTP or HTTP(S) server name in the FileName parameter.

(1) When saving the file to a local drive or network drive:
IKJpegFileSaveEx("c:\abc.jpg", .....)

(2) When saving the file to FTP server:
IKJpegFileSaveEx("FTP://www.newtone.co.jp/image/abc.jpg;;;true;user;password", .....)

(*)Parameter order when setting the FileName:
FTP://ServerName/FolderName/FileName;ProxyName;PortNumber;PassiveMode;UserName;Password

When setting or changing the proxy server, the port number, and passive (PASV) mode connection, please be sure to pass in this information seperated by semicolons. Set the FTP server name or IP address, the proxy server name or IP address, the port number, passive mode connection, etc. If the port number is omitted, the defaul port number will be used. Passive mode connection can be either "true" or "false" in upper case or lower case letters. If omitted, passive mode connection will be used.

(3) When saving the file to HTTP(S) server:
IKJpegFileSaveEx("http://www.newtone.co.jp/image/abc.jpg;;;;user;password", .....)

(*)Parameter order when setting the FileName:
HTTP://ServerName/FolderName/FileName;ProxyName;PortNumber;HTTPS;UserName;Password

When setting or changing the proxy server, the port number, or using HTTPS, please be sure to pass in this information seperated by semicolons. Set the HTTP(S) server name or IP address, the proxy server name or IP address, the port number, HTTPS, etc. If the port number is omitted, the defaul port number will be used. IF HTTPS is omitted then HTTP server will be used.

[Differences from ImageKit7 ActiveX]
The ImageKit7 ActiveX only allowed files from local drives or network drives to be loaded.The ImageKit9 ActiveX allows files to be loaded or saved to FTP and HTTP(S) servers.
IKJpegFileSaveEx method has been added.