Description

Inserts a DIB image as a new page into an MO:DCA file.

If the file does not exist, a new file is created, but it is more efficient to create multi-page MO:DCA files using the CreateMODCAFile, AddMODCAPage, and CloseMODCAFile functions.

Syntax

Result = [BITIFF.] InsertMODCAPage FileName InserBeforePage, Dib, Compression, Quality

Parameters

FileName

String

Full path to the MO:DCA file to write.

InsertBeforePage

Long

0-based page number. The new page is inserted before the specified page. If -1 is specified, the new page is inserted after the last page.

Dib

LONGLONG

Handle to a DIB image.

Compression

Long

The compression to use. The following compression types are supported:

·         1: IBM MMR (1 bit)

·         3: Not compressed (1 bit)

·         128: CCITT Group 3, 1 Dimensional (1 bit)

·         129: CCITT Group 3, 2 Dimensional (1 bit)

·         130: CCITT Group 4 (1 bit)

·         131: JPEG (8 bit grayscale or 24 bit)

Quality

Long

Compression quality. It is only used by the JPEG compression type. The value must be between 1 and 99.

Return Value

Zero on success, or an error code on failure. For the possible error codes, please see the BiTiff.ocx error codes.