'Convert Document to Image' COM/ActiveX Interface

Using 'Convert Document to Image' as an ActiveX Component

Overview

For COM+ (i.e. with IIS) users click here.

 

One very important note is that the file, CDTI.EXE, is both an executable application AND an ActiveX component.  Again, the file CDTI.EXE, can be ran as a stand alone executable as well as be referenced as a component within your development environment. There is only one installation for 'Convert Document to Image'. CDTI.exe is installed in the Program Files folder of your operating system.


For Visual Basic users, simply make a reference to the CDTI.EXE application in the Tools\References menu item.  Once done you now have access to the component. In other development environments such as VBA you may use something similar to the lines of code below to create an instance of the application object:

    Dim oConvertAppObject as Object

    Set oConvertAppObject = CreateObject("ConvertDocToImage.clsConvertDocToImage")

    Call oConvertAppObject.DoCommandLine("/JE:\Jobs\Test.SII")


Directly below is some VBS (Visual Basic Script). You could put the following 3 lines in a text file, call it Test.VBS and give it a go:

   set converter = WScript.CreateObject("ConvertDocToImage.clsConvertDocToImage")
   result = converter.DoCommandLine("/JE:\Jobs\Test.SII")
   MsgBox(result)
 

To download demonstration source code (VB6 and VB.NET) click the following links:

Here is some sample VB code illustrating its usage:

Private Sub Command1_Click()

  Dim lRetVal As Long

  Dim oCDTI As ConvertDocToImage.clsConvertDocToImage

 

  Set oCDTI = New ConvertDocToImage.clsConvertDocToImage

' Assign Key To the 'Final Key', given upon purchase/registration.

  oCDTI.Key = ""

 

  ' Run by the command line.  See documentation for a full listing of

  ' switches and options. Switches are CASES SENSITIVE

 

  ' Convert Coffee.PDF to Coffee.JPG.

  '   Verbose output with /V. Remove /V to make it completely silent.

  '   Specify the input (/S) and output files (/T),

  '   the JPG format (/C1) of the target image file,

  '   also specify which page(s) to do with /1 * (in this case all),

  '   and the resolution with /5 (in this case 200 DPI),

  '   JPEG Quality 90% with /4:

  lRetVal = oCDTI.DoCommandLine("/S C:\Input\Coffee.PDF /T C:\Output\Coffee.JPG /C1  /1 * /4 90 /5 200 /V")

 

'  Example of specifying a 'Conversion Job File'

  lRetVal = oCDTI.DoCommandLine("/j""C:\Test\ConversionJob.sii""")

 

' DoCommandLine() Return Values

'  0 = Success

' -1 = Shareware expired

' -2 = Command line String Empty or invalid

' -3 = Missing required or invalid command line argument(s)

 

  If (lRetVal = 0) Then

    MsgBox ("Success!")

  Else

    MsgBox ("Failure.")

  End If

  Set oCDTI = Nothing

End Sub

 

As you can see from the code above, the ActiveX simply wraps the command line feature. So, to learn what you can do with the ActiveX, please refer to the 'Using the Command Line' section of the 'Convert Document to Image' users manual

METHODS

     DoCommandLine()
     DESCRIPTION:

      This function emulates doing the command line, but through the COM interface.

      RETURN VALUES:
         0 = Success
        -1 = Shareware expired
        -2 = Command line String empty or invalid
        -3 = Missing required command line argument(s)
        -X = Some error occurred during the processing, create a log or use verbose switch for details

 

PROPERITES

None

EVENTS

     OnError(lErrorNumber As Long, sErrorString As String)
     DESCRIPTION:

      When an error occurs this event is triggered supplying both the error code and description.  This can be very helpful while troubleshooting and developing.