PS to IMAGE Converter SDK/COM User Manual
     
  (1). Introduction  
  (2). Functions  
  (3). System requestment  
  (4). SDK Methods  
  (5). SDK Constants  
  (6). SDK Properties  
  (7). Registration  
  (8). Copyright & License  
     
 (1) Introduction  
      OakDoc PS to PDF Converter is a windows application which can offer the best performance available to provide speedy conversions from PostScript and Encapsulated PostScript to Portable Document Format (PDF). It supports to convert multiple PS/EPS files into one PDF file. Set encryption options to output PDF files. It doesn't depend on Windows Printer Driver technology or any other products.
    OakDoc PS to PDF Converter supports the fast, affordable way to create professional-quality PDF format files. Its easy-to-use interface allows you to create PDF files, and it offers convenient features to optimize and manipulate PDF files in ways that most other packages do not. It is clearly to see why it is one of the most powerful and efficient tools for your office on the market today.
 

 (2) Functions
■   It quickly converts PS/EPS document to PDF format.
■   It supports batch PS/EPS to PDF conversion.
■   It supports to convert multiple PS/EPS files into one PDF file.
■   Set encryption options to output PDF files.
■   Password protection for PDF files with 40 or 128 bit encryption.
■   Set the PDF document title, subject, author and keywords options.
■   It supports drag and drop of files.
■   It supports windows 2000/xp/2003/vista platform.
■   It can automatically view the PDF file after it was converted.
■   It allows you to preserve original document layout.
■   Support multilateral language, such as English, French, German, Italian, Chinese Simplified, Chinese Traditional, Czech, Danish, Dutch, Japanese, Korean, Norwegian, Polish, Portuguese, Russian, Spanish, Swedish, Thai, etc.

  (3) System requestment

     Supported Operation Systems  
     The following operation systems listed have been tested with PS to PDF Converter SDK/COM and are officially supported.  
      ■ Microsoft Windows 2003 Server 32-bit Web Edition, Standard Edition and Enterprise Edition;
      ■ Microsoft Windows 2003 Server x64 Web Edition, Standard Edition and Enterprise Edition;
      ■ Microsoft Windows XP Professional and Home Edition;
      ■ Microsoft Windows XP x64 Professional;
      ■ Microsoft Windows 2000 Server and Advanced Server;
      ■ Microsoft Windows 2000 Professional;

     Recommended hardware  
      ■ CPU: Intel(or Standard PC) 800MHz or faster compatible x86 processor;
      ■ RAM: 256MB or more RAM recommended, 128MB minimum;
      ■ Hard-disk: 100MB free space recommended, 50MB free space required;

  (4) SDK Methods

    long __stdcall apCreate()
    void __stdcall apClose(long id)
    long __stdcall apSetFunc(long id, long code, long nOptVal1, long nOptVal2, char *pOptVal1, char *pOptVal2)
    long __stdcall apGetFunc(long id, long code, long nOptVal1, long nOptVal2, char *pOptVal1, char *pOptVal2)
    long __stdcall apConvert(long id)
   Example

    long __stdcall apCreate()
   Description:
          Creating a ps to image converter. If creates success, it will return a converter's handle.
   Parameters:
          None.
   Return Value:
          If the function succeeds, it returns a converter's handle, otherwise the function fails, it returns a error code. For more error codes, please click here.
 

    void __stdcall apClose(long id)
   Description:
          Closing the ps to image converter and releasing the converter's handle.
   Parameters:
          id : A handle of ps to image converter which created by function 'apCreate()'.
   Return Value:
          None.

    long __stdcall apSetFunc(long id, long code, long nOptVal1, long nOptVal2, char *pOptVal1, char *pOptVal2)
   Description:
          This functon is used to set the ps to image converter's properties, the converter is created by function 'apCreate()'.
   Parameters:
id : A handle of ps to image converter which created by function 'apCreate()'.
code:  Property tag, refer to the section of definitions of apSetFunc properties.
nOptVal1: An integer value of the property.
nOptVal2: An integer value of the property.
pOptVal1: A String value of the property.
pOptVal2:2 A String value of the property.
   Return Value
          If the function succeeds, it returns RTN_OK, otherwise the function fails, it returns a error code. For more error codes, please click here.

    long __stdcall apGetFunc(long id, long code, long nOptVal1, long nOptVal2, char *pOptVal1, char *pOptVal2)
   Description:
          This functon is used to get the ps to image converter's properties, the converter is created by function 'apCreate()'.
   Parameters:
id : A handle of ps to image converter which created by function 'apCreate()'.
code:  Property tag, refer to the section of definitions of apGetFunc properties.
nOptVal1: An integer value of the property.
nOptVal2: An integer value of the property.
pOptVal1: A String value of the property.
pOptVal2:2 A String value of the property.
   Return Value
          If the function succeeds, it returns RTN_OK, otherwise the function fails, it returns a error code. For more error codes, please click here.

   long __stdcall apConvert(long id)
   Description:
          Converting ps/eps to image file.
   Parameters:
          id : A handle of ps to image converter which created by function 'apCreate()'.
   Return Value:
          If the function succeeds, it returns RTN_OK, otherwise the function fails, it returns a error code. For more error codes, please click here.
 
  (5) SDK Constants
    Function 'apSetFunc() & apGetFunc()' properties definition.
 
Name Value Type Description
AP_Set_Output 3000 string Source ps/eps file(Supports absolute path and relative path).
AP_Set_Input 3001 string Destination image file(Supports absolute path and relative path).
AP_Set_PDFInfo 3006 string PDF header informations.
AP_Set_PDFEncrypt 3007 integer The length of key.
Notice: For more detial properties, please click here.

   Return value definitions.
 
Name Value Description
RTN_OK  1 Operation success.
RTN_FAILURE  0 Operation failure.
RTN_ERR_NONE_OUTPUT -1 Destination file unspecified.
RTN_ERR_NONE_INPUT -2 Source file unspecified.
RTN_ERR_INVALID_HANDLE -3 Invalid converter handle.
RTN_ERR_MEMORY -4 Memory operation failure.
RTN_ERR_INVALID_FORMAT -5 Invalid format of destination file.

   Supported pdf header informations.
 
Name Value Description
AP_PDF_TITLE "title" title
AP_PDF_SUBJECT "subject" subject
AP_PDF_AUTHOR "author" author
AP_PDF_KEYWORDS "keywords" keywords
AP_PDF_APPLICATION "creator" application

   Supported encryption mode.
 
Constant Name Value Description
AP_PDF_ENCRYPT_40 40 40 bits key.
AP_PDF_ENCRYPT_128 128 128 bits key.

   Supported user access permissions.
 
Name Value Description
AP_PDF_PERMISSION_NONE 0 Limite all permissions.
AP_PDF_PERMISSION_PRINT 1 Print the document.
AP_PDF_PERMISSION_COPYING 2 Copying the contents of the document.
AP_PDF_PERMISSION_MODIFY 4 Modify the contents of the document.
AP_PDF_PERMISSION_ALL 7 Allow all permissions.
 
  (6) SDK Properties
  This section describes the properties of the functions apSetFunc and apGetFunc detailedly.

 

   AP_Set_Output
  This property can be using to set destination pdf files(Supports absolute path and relative path).
The paramater pValue1 is the output file.
Note:if the settings more than once, the last setting is comfirmed.
 
   AP_Set_Input
  This property can be using to set source ps/eps files(Supports absolute path and relative path).
The paramater pValue1 is the input file.
 
   AP_Set_PDFInfo
  This property sets the pdf header informations.
The paramater pValue1 is the information keywords.
The paramater pValue2 is the content of pdf header information.
 
   AP_Set_PDFEncrypt
  This property sets encryption mode of PDF document.
 
  Example:
  Here is a simple examples to make c. For more examples, you can refer to the directory "example".
 

int main()
{
    long id, iRet;
    char sOwnerPw[] = "1111";
    char sUserPw[] = "2222";

    //Load dynamic link library---ps2pdf.dll
    if( !LoadDLL() ) exit(FALSE);

    // Convert ps files to a general pdf file.
    id = apCreate();
    apSetFunc(id, AP_Set_Input, 0, 0, "test1.ps", NULL);
    apSetFunc(id, AP_Set_Input, 0, 0, "test2.ps", NULL);
    apSetFunc(id, AP_Set_Output, 0, 0, "test1.pdf", NULL);

    apSetFunc(id, AP_Set_PDFInfo, 0, 0, AP_PDF_TITLE, "untitled document");
    apSetFunc(id, AP_Set_PDFInfo, 0, 0, AP_PDF_AUTHOR, "adultpdf");
    apSetFunc(id, AP_Set_PDFInfo, 0, 0, AP_PDF_APPLICATION, "PS to PDF sdk demo");

    iRet = apConvert(id);
    apClose(id);

    // Convert ps files to an restricted pdf file.
    id = apCreate();
    apSetFunc(id, AP_Set_Input, 0, 0, "test1.ps", NULL);
    apSetFunc(id, AP_Set_Input, 0, 0, "test2.ps", NULL);
    apSetFunc(id, AP_Set_Output, 0, 0, "test2.pdf", NULL);

    apSetFunc(id, AP_Set_PDFInfo, 0, 0, AP_PDF_TITLE, "untitled document");
    apSetFunc(id, AP_Set_PDFInfo, 0, 0, AP_PDF_AUTHOR, "adultpdf");
    apSetFunc(id, AP_Set_PDFInfo, 0, 0, AP_PDF_APPLICATION, "PS to PDF sdk demo");

    apSetFunc(id, AP_Set_PDFEncrypt, AP_PDF_ENCRYPT_128, AP_PDF_PERMISSION_PRINT+AP_PDF_PERMISSION_COPYING, sUserPw, sOwnerPw);

    iRet = apConvert(id);
    apClose(id);
    //Free dynamic link library---ps2pdf.dll
    FreeDLL();
    exit(TRUE);
}


 (7) Registration
 
  a) Download  
    You can free download a demo version at http://www.adultpdf.com/products/pstopdf/index.html
 
  
Limitations of the demo version:
  Insert a watermark on each page of the generated pdf file.
 
 
  b) Buy now  
    You can order PS to PDF Converter SDK online.
  Single license - only $399,Click here to buy right now. Thanks for you support.
  Unlimited license - only $999,Click here to buy right now. Thanks for you support.
 
 
  c) Technology support  
 

  Guarantee: We are committed to provide excellent products and supports to our customers. If you are dissatisfied with an adultpdf product after your purchase, we will refund your money.

  Privacy Policy: We will not give, sell or otherwise transfer your personal information to third parties. Unless you ask us not to, we will send occasional email about new products and releases.

  Ongoing Open Dialog: Our customers are our most valuable resources. Please let us know how we can improve our products and we will try our best to implement your suggestions.

 

 (8) Copyright & License
 
  "PS to PDF Converter SDK/COM" Software License  
 

1. License.
    PS to PDF Converter software ("the Software"), documentation accompanying this License on any media or in any form are licensed, to you by adultpdf.com Inc. adultpdf.com Inc. retains title to the Software. The Software and any copies which this License authorizes you to make are subject to this License.

2. Authorized Use and Restrictions.
    This License allows you to install and use the Software on less than or up to the number of computers you have purchased the License for. If you purchased a License for one CPU, you may use the Software on only one machine at a time. A multi-processor computer is considered as one CPU for the purpose of this License. If you purchased the unlimited License, you may use the Software on anyone machine at any time and distribute the product to all your customers. You may not decompile, reverse engineer, disassemble, rent, lease, loan, distribute(not unlimited License), or produce derivative works from the Software. You may transfer your rights under this License provided that you transfer the related documentation, this License and a copy of the Software to a party who agrees to accept the terms of this License and destroy any and all copies of the Software in your possession. This License will terminate automatically without notice from adultpdf.com Inc if you fail to comply with any term(s) of this License.

3. Limitation of Liability.
    UNDER NO CIRCUMSTANCES, INCLUDING NEGLIGENCE, SHALL ADULTPDT.COM INC. BE LIABLE FOR ANY INCIDENTAL, SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR RELATING TO THIS LICENSE. SOME JURISDICTIONS DO NOT ALLOW THE LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS LIMITATION MAY NOT APPLY TO YOU. IN NO EVENT, ADULTPDT.COM INC.'S TOTAL LIABILITY TO YOU FOR ALL DAMAGES EXCEED THE AMOUNT YOU PAID TO ADULTPDT.COM INC. OR ITS AUTHORIZED DISTRIBUTOR.

4. Complete Agreement
    This License constitutes the entire agreement between the parties with respect to the use of the Software and supercedes all (if any) prior or contemporaneous understandings. No amendment to or modification of this License will be binding unless in writing and signed by an authorized officer of adultpdf.com Inc.

5. Note
Single License:
    Allowing you to install and use the software on only one computer at the same time.
Unlimited License:
    Allowing you to install and use the software on multiple computers at the same time.

--- end ---

 



http://www.adultpdf.com  
Copyright 2000-2008 by Adultpdf.com Inc. All rights reserved.