Append Method (CiImage)

Visual Basic
C#
Delphi
JScript
C++/CLI

'Declaration
 
Public Function Append( _
   ByVal FileName As System.String, _
   ByVal Format As EFileFormat _
) As System.Integer

'Usage
 
Dim instance As CiImage
Dim FileName As System.String
Dim Format As EFileFormat
Dim value As System.Integer
 
value = instance.Append(FileName, Format)

public System.int Append( 
   System.string FileName,
   EFileFormat Format
)

public function Append( 
    FileName: System.String;
    Format: EFileFormat
): System.Integer;

public function Append( 
   FileName : System.String,
   Format : EFileFormat
) : System.int;

public:
System.int Append( 
   System.String^ FileName,
   EFileFormat Format
)

Parameters

FileName
Format: Only formats starting with ciTIFF or cifPDF are valid. ciTIFF_G4 for Bi-tonal images and ciTIFF_LZW for Color and Grayscale images.

Open, Save, Append Image. List image properties

C#
VB.NET

void OpenSaveAppendImages(string imageFile1, string imageFile2, string pdfFileOut)
{
    CiServer ci = Inlite.ClearImageNet.Server.GetThreadServer();
    CiImage Image = ci.CreateImage();
    // Create PDF file with image from the first file
    Image.Open(imageFile1, 1);
    Image.SaveAs(pdfFileOut, EFileFormat.cifPDF);
    // Append to PDF file image from the second file
    Image.Open(imageFile2, 1);
    Image.Append(pdfFileOut, EFileFormat.cifPDF);
    // Open PDF page and show image information
    Image.Open(pdfFileOut, 2);
    ShowImageInfo(Image);
    // Close image
    Image.Close();
}

void ShowImageInfo(CiImage Image)
{
    Console.WriteLine("  File='" + Image.FileName + "'" + " Page=" + Image.PageNumber + " PageCount=" + Image.PageCount + "  Format=" + Image.Format);
    Console.WriteLine("  Width=" + Image.Width + "  Height=" + Image.Height + "  BPP=" + Image.BitsPerPixel + " HorzDpi=" + Image.HorzDpi + "   VertDpi=" + Image.VertDpi);
}

Sub OpenSaveAppendImages(imageFile1 As String, imageFile2 As String, pdfFileOut As String)
    Dim ci As CiServer = Inlite.ClearImageNet.Server.GetThreadServer()
    Dim Image As CiImage = ci.CreateImage()
    ' Create PDF file with image from the first file
    Image.Open(imageFile1, 1)
    Image.SaveAs(pdfFileOut, EFileFormat.cifPDF)
    ' Append to PDF file image from the second file
    Image.Open(imageFile2, 1)
    Image.Append(pdfFileOut, EFileFormat.cifPDF)
    '  Open PDF page and show image information
    Image.Open(pdfFileOut, 2)
    ShowImageInfo(Image)
    '  Close image
    Image.Close()
End Sub

Sub ShowImageInfo(Image As CiImage)
    Console.WriteLine("  File='" + Image.FileName + "'" + " Page=" + Image.PageNumber + " PageCount=" + Image.PageCount + "  Format=" + Image.Format)
    Console.WriteLine("  Width=" + Image.Width + "  Height=" + Image.Height + "  BPP=" + Image.BitsPerPixel + " HorzDpi=" + Image.HorzDpi + "   VertDpi=" + Image.VertDpi)
End Sub

Process multi-page file

C#
VB.NET

void ProcessMultiPageFile(string imageFile)
{
    CiServer ci = Inlite.ClearImageNet.Server.GetThreadServer();
    CiImage Image = ci.CreateImage();
    Image.Open(imageFile, 1);
    for (int page = 1; page <= Image.PageCount; page++)
    {
        Image.Open(imageFile, page);
        //  Process  image page, for example
        //  ==== Read barcodes
        //     BarcodePro.Image = Image;
        //     BarcodePro.Find(0);
        //     // process barcodes
        //  ==== Repair image
        //     Repair.Image = Image;
        //     Repair.AutoDeskew();
        //     Image.Append (pdfFileOut, EFileFormat.cifPDF);
    }
 }

Sub ProcessMultiPageFile(imageFile As String)
    Dim ci As CiServer = Inlite.ClearImageNet.Server.GetThreadServer()
    Dim Image As CiImage = ci.CreateImage()
    Dim page As Integer
    Image.Open(imageFile, 1)
    For page = 1 To Image.PageCount
        Image.Open(imageFile, page)
        '  Process  image page, for example
        '  ==== Read barcodes
        '     BarcodePro.Image = Image
        '     BarcodePro.Find(0)
        '     ' process barcodes
        '  ==== Repair image
        '     Repair.Image = Image
        '     Repair.AutoDeskew()
        '     Image.Append (pdfFileOut, EFileFormat.cifPDF)
    Next
End Sub

Reference

CiImage Class
CiImage Members
CiPdf Class
Append Method
Open Method
Save Method
SaveAs Method