LPDFCompressor::InsertSegments

#include "ltwrappr.h"

L_INT LPDFCompressor::InsertSegments( pBitmap, uSegmentCnt, pSegmentInfo, bIsThereBackGround, rgbBackGroundColor)

LBitmapBase * pBitmap;

/* pointer to bitmap */

L_UINT uSegmentCnt;

/* number of elements in segment array */

LPSEGMENTINFO pSegmentInfo;

/* pointer to the SEGMENTINFO structure */

L_BOOL bIsThereBackGround;

/* flag */

COLORREF rgbBackGroundColor;

/* background color */

Applies the segments specified in pSegmentInfo to the specified bitmap, then compresses and inserts the resulting image into the PDF file in memory.

Parameter

Description

pBitmap

Pointer to the LBitmapBase class that references the image to be inserted in the PDF file.

uSegmentCnt

Number of elements in the pSegmentInfo parameter. It represents the number of segments that will be applied to pBitmap.

pSegmentInfo

Pointer to the SEGMENTINFO structure that contains an array that has the information for each segment.

bIsThereBackGround

Flag that indicates whether to use the average background color to represent the background of the page in the PDF file. Possible values are:

 

Value

Meaning

 

TRUE

Use the average color to draw a background color in the generated PDF page before drawing the segments.

 

FALSE

Leave the background of the PDF page untouched.

rgbBackGroundColor

Average background color. This parameter is ignored if bIsThereBackGround is FALSE.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To insert the bitmap using MRC segmentation, use LPDFCompressor::InsertMRC.

Required DLLs and Libraries

LCMRC
LCPDF
LCENC
LCZIB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LPDFCompressor::InsertMRC, LPDFCompressor::InsertNormal, LPDFCompressor::SetCompression

Topics:

Creating a Compressed PDF File

 

Class Library Function Groups

Example

// This example inserts an image to pdf document with using user Segments 
L_INT InsertSegmentExample(LBitmapBase* pBitmap, L_UINT uSegmentCnt, LPSEGMENTINFO pSegmentInfo ,  COLORREF rgbBackGroundColor, L_BOOL bIsThereBackGround) 
{
   L_INT nRet; 
   LPDFCompressor Pdf; 

   nRet = Pdf.Init ();
   if(nRet != SUCCESS) 
      return nRet; 

   nRet = Pdf.InsertSegments( pBitmap, uSegmentCnt, pSegmentInfo, bIsThereBackGround, rgbBackGroundColor); 
   if(nRet != SUCCESS) 
   {
      Pdf.Free ();
      return nRet; 
   }

   nRet = pdf.Write (TEXT("C:\\Output.pdf"));

   Pdf.Free();
   return nRet; 
}