adultpdf.com Inc


PDF Split/Merge COM/SDK v3.1
User manual

 

    Introduction

PDF Split Merge is a stand-alone tool for splitting, merging  PDF documents,allows you to 
split large PDF files into smaller PDF files,and merge one or more PDF files.
The split functionality lets you split one or more PDF files based on page groups, page ranges. 
The merge functionality lets you quickly combine a collection of PDF documents and page sets.

 

    Features

 

 

    Limitations in the trial version

                Insert a watermark string in the every page in the PDF file

    

    Functions description

Note: 
[SDK] = for SDK function name
[COM] = for COM function name

 

Open and Close

[SDK] apOpenSplit
[COM] apOpenSplitEx

long  apOpenSplit( char *input )

Description

Open an existing PDF file for split. Split parameter use apSetFunction function.

Parameters

input

Open an existing PDF file.

Return Value

Each of these functions returns a PDF File id for the Open file. A return value of 0 or less 0 indicates an error, otherwise is succeed.

Follow is error code:

Code error

Meaning

0

Parameter error.

-1

Open the PDF file failed.

-2

Encrypted PDF file.

-3

Version too low (must above PDF-1.1) or nonsupport of version

Less -3

Other abnormity.


[SDK] apOpenSplit2
[COM] apOpenSplit2Ex

long  apOpenSplit2( char *input , char *OwnerPassword, char *UserPassword)

Description

Open an existing PDF file for split. Split parameter use apSetFunction function.
            unlike apOpenSplit , which is designed for split that have been encrypted pdf file.           

Parameters

input

Open an existing PDF file.

OwnerPassword

Owner password of  PDF file. may be is NULL

UserPassword

User password of  PDF file. may be is NULL

Return Value

Each of these functions returns a PDF File id for the Open file. A return value of 0 or less 0 indicates an error, otherwise is succeed.

Follow is error code:

Code error

Meaning

0

Parameter error.

-1

Open the PDF file failed.

-2

Encrypted PDF file.

-3

Version too low (must above PDF-1.1) or nonsupport of version

Less -3

Other abnormity.

 

 

[SDK] apCreateMerge
[COM] apCreateMergeEx

long  apCreateMerge( char *input )

Description

Create an new PDF file for merge. Merge additive  use apSetFunction function.

Parameters

input

Create an PDF file.

Return Value

Each of these functions returns a PDF File id for the Create file. A return value of 0 or less 0 indicates an error, otherwise is succeed.

Follow is error code:

Code error

Meaning

0

Parameter error.

-1

Create the PDF file failed.

 

[SDK] apClose
[COM] apCloseEx

void apClose ( long id )

Description

Close the opened PDF file.

Parameters

id

         Returned by apOpenSplit and apOpenSplit2 and apCreateMerge function.

Return Value

None.

 

Add split  and merge paratemer

[SDK] apSetFunction  (code=170)
[COM] apSetFunctionEx  (code=170)

long apSetFunction(  long id, long code, long para1, long para2,char *para3,char *para4)

Description

Add split page range and output base. 

Parameters

id

        Returned by apOpenSplit and apOpenSplit2 and apCreateMerge function.

           code

                      Must be 170.

           Para1

                      Must be 1. (split by page ranges)

           Para2

                      para2 =1 split from every page to single file.
                      para2 =2 split from specify page range

           Para3

                      If para2 equal 2 then set page range sequences,
                      else it is i
gnored.
                      e.g. "1,3;5-10;2,4,6,8-10"

 PDF Split allows operation of individual pages, page ranges and page sets, For example: 

para2 Parameter Description
2 Extract page number 2 into a new document.
2,7 Extract pages 2 and 7 into a new document.
1-9 Create a single output file containing pages 1 through 9.
8;9 Extract page 8 to a file and extract page 9 to other one.

           Para4

                      specify output pdf base file name, it may equal NULL.
                      if para4 equal NULL then identical to split file name.

Return Value

Nonzero if it is successful; otherwise, it is zero.

 

[SDK] apSetFunction  (code=175)
[COM] apSetFunctionEx  (code=175)

long apSetFunction(  long id, long code, long para1, long para2,char *para3,char *para4)

Description

Add pdf files and page range for merge.

Parameters

id

        Returned by apOpenSplit and apOpenSplit2 and apCreateMerge function.

           code

                      Must be 175.

           Para1 and Para2

                      Ignore

           Para3

                      Add a pdf file, every call for add a file.

           Para4

                      Set the merge range sequences , it may equal NULL.
                      e.g. "1,3,5-10,2"            
                      if para4 equal NULL then merge all page to merge file.

 PDF Merge allows operation of individual pages, page ranges and page sets, For example: 

Merge Parameters Description
2 Extract page number 2 into a new merge document.
2,7  Extract pages 2 and 7 into a new merge document.
1-9 Extract pages 1 through 9 into a new merge document. 

Return Value

Nonzero if it is successful; otherwise, it is zero.

 

[SDK] apGetFunction  (code=206)
[COM] apGetFunctionEx  (code=206)

long apGetFunction(  long id, long code, long para1, long para2,char *para3,char *para4)

Description

Get page count. 

Parameters

id

        Returned by apOpenSplit and apOpenSplit2 and apCreateMerge function.

           code

                      Must be 206.

           Para1,Para2,Para3 and Para4

                      Ignore.

Return Value

Page count if it is successful; otherwise, it is zero.

 

 

Other Parameter

[SDK] apSetFunction  (code=172)
[COM] apSetFunctionEx  (code=172)

long apSetFunction(  long id,long code,long para1,long para2,char *para3,char *para4)

Description

Set log file for log information contain rights and errors,default do not log.

Parameters

id

        Returned by apOpenSplit and apOpenSplit2 and apCreateMerge function.

           code

                      Must be 172.

           Para1,Para2 and Para4

                      Ignore

           Para3

                      Log file name.

Return Value

Nonzero if it is successful; otherwise, it is zero.

 

[SDK] apAddInfo
[COM] apAddInfoEx

long  apAddInfo(long id, char * Title, char * Subject, char * Author, char * Keywords, char * Creator)

Description

Add document informations. 

Parameters

id

        Returned by apOpenSplit and apOpenSplit2 and apCreateMerge function.

           Title

                      document title.

           Subject

                      document subject.

           Author

                      document author.

           Keywords

                      document keywords.

           Creator

                      document creator.

Return Value

Nonzero if it is successful; otherwise, it is zero.

 

 

    Example

        Please reference directory "example_for_asp","example_for_vc","example_for_vb" and "example_for_delphi".

 

    Contact

        Info page
        http://www.adultpdf.com/products/pdfsplitmerge/index.html      
        http://www.adultpdf.com/products/pdfsplitmerge/help_com.html   
        Order page
       
https://www.regnow.com/softsell/nph-softsell.cgi?item=13446-61
        https://www.regnow.com/softsell/nph-softsell.cgi?item=13446-62
        Web site (more other software)
        http://www.adultpdf.com

    Technical Support and Feedback

         If you have any technical questions, suggests, bug reports, please contact us at support@adultpdf.com
         If you have ideas and suggestions on how could improve PDF Split/Merge, we would love to hear your thoughts.


Copyright @ 2008 Adultpdf.com Inc. All rights reserved.