IKJ2kFileSaveMem

This function saves raster image data in JPEG2000 format as raw image data.

[C++Builder/Visual C++] BOOL IKJ2kFileSaveMem(HANDLE InHandle, HANDLE *OutHandle, BOOL JP2kFormat, BOOL Reversible, double Size, long TileWidth, long TileHeight, short NumrResLevel, short PrecinctWidth, short PrecinctHeight, short CodeBlockWidth, short CodeBlockHeight, LPCSTR Comment, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

[Delphi] function IKJ2kFileSaveMem(InHandle: THandle; var OutHandle: THandle; JP2kFormat, Reversible: LongBool; Size: Double; TileWidth, TileHeight: Longint; NumrResLevel, PrecinctWidth, PrecinctHeight, CodeBlockWidth, CodeBlockHeight: Smallint; Comment: PChar; UserProc: LONG_PTR; Caption, Message, Button: PChar): LongBool;

[Visual Basic] Function IKJ2kFileSaveMem(ByVal InHandle As Long, OutHandle As Long, ByVal JP2kFormat As Long, ByVal Reversible As Long, ByVal Size As Double, ByVal TileWidth As Long, ByVal TileHeight As Long, ByVal NumrResLevel As Integer, ByVal PrecinctWidth As Integer, ByVal PrecinctHeight As Integer, ByVal CodeBlockWidth As Integer, ByVal CodeBlockHeight As Integer, ByVal Comment As String, ByVal UserProc As Long, ByVal Caption As String, ByVal Message As String, ByVal Button As String) As Long

Parameters

Name	Explanation
InHandle	The image handle of the raster image
OutHandle	The raw image data to be saved
JP2kFormat	The format (False(0): JPEG2000 Part1, True(nonzero): JPEG2000 Code Stream)
Reversible	The compression method (False(0): Non reversible, True(nonzero): Reversible)
Size	The size of the saved file as a factor of the size of the uncompressed image.
TileWidth	The width of the JPEG2000 format tile size (in pixels)
TileHeight	The height of the JPEG2000 format tile size (in pixels)
NumrResLevel	The level of the JPEG2000 format resolution. (from 0)
PrecinctWidth	The width of the JPEG2000 format precinct size (measured by 2 to certain power (from 0 to 15))
PrecinctHeight	The height of the JPEG2000 format precinct size (measured by 2 to certain power (from 0 to 15))
CodeBlockWidth	The width of the JPEG2000 format code block size (measured by 2 to certain power (from 0 to 10))
CodeBlockHeight	The height of the JPEG2000 format code block size (measured by 2 to certain power (from 0 to 10))
Comment	The comment text to be saved (MAX:1023 bytes) Set as follows: [title + 0x0d + Subject + ... + 0x0d] title: The image title Subject: The subject of the image Author: The creator of the image Comment: The comment * In Delphi replace the above 0x with $, and in Visual Basic, replace the 0x with &H.
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

Return Value

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

Explanation

The IKJ2kFileSaveMem function saves raster image data in JPEG2000 format as raw image data. Supports 8 bit grayscale and 24 bit color.

In general, when JP2kFormat is False(0), the file extension is jpc or j2k. When True(nonzero) it is jp2. When Reversible is False(0), nonreversible ICT (nonreversible component conversion) and 9/7 nonreversible wavelet conversion is used. When True(nonzero), reversible RCT (reversible component conversion) and 5/3 reversible wavelet conversion is used. Size is a factor of the size of the uncompressed image. When Size is 0.01, for example, the compressed image will be 1/100th the size of the uncompressed image. Size is enabled when Reversible is False(0). The default value of Size is 0 meaning uncompressed.

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.

Except for the fact that the raster image is saved as raw image data, this function operates in the same way as the IKJ2kFileSave function.