Evaluation Mode:

PDFOCX can be run and is fully functional in evaluation mode. The evaluation effects that you will have are:

• Time
  The component will function for 30 days only from the date of the first execution. Reinstalling the component will not change this. The component will remain active on your system, but the Convert event will become disabled after 30 days. You will receive a message regarding the disabling of the component after 30 days every time the 'Convert' event is fired.
  
  
• Messages
  Every time your code calls the 'Convert' event, you will receive a message box "PDFOCX is functioning in evaluation mode".
  

Deployment:

When you prepare the installation of your finished software which has the PDFOCX component within it, you will need to distribute and register the following files to ensure your .exe will function.

• ISED.DLL
• PDFOCX.OCX
• FreeImage.DLL
• msvbvm60.DLL
• AdvImgLib.dll
  

Functions and Events:

• Convert - METHOD
  This method performs the actual conversion of image to PDF The Done event is fired on the control when the Convert event is finished. The convert event will raise an error if it is unable to create the PDF file. You will need to check the value of the 'success' parameter in the DONE event to determine if the conversion was completed or not. See the section of this help file on Error Codes for a list of possible errors generated from this method.
  
  
• Done - EVENT
  This event is fired when the Convert method is successfully executed. If the Convert event encounters an error during execution, the Done event will be raised with a 'success' parameter having a value greater than 0. If the 'success' parameter has a value greater than 0, the PDF file was not created.
  
  Possible values for the 'success' parameter are:

CR_Success	0	Successful creation
CR_Failure_General	1	Could not convert file
CR_Failure_NoInput	2	No input file specified or file does not exist
CR_Failure_NoOutput	3	No output file specified
CR_Failure_TrialExpired	4	30 day trial period has expired
CR_Failure_InvalidImageType	5	File does not match file type

Properties

• AppendToExisting (Boolean)
  Append source image to end of existing PDF. Creates PDF if PDF does not exist.
  
  
• DestinationFile (String)
  Destination path/file name for PDF.
  
  
• FileType (Custom DataType (int) - CR_FileType)
  The setting to indicate what type of image file has been provided. The JPG file can be of any compression level and color depth. The TIFF file must be a CITT 4 compressed TIFF file to correctly embed into the PDF file. Attempting to use CITT 3 or non-compressed TIFF images may result in strange PDF results.
  

  FT_AUTO	-1	Auto-detect the file format
  FT_BMP	0	Windows Bitmap (*.bmp)
  FT_ICO	1	Windows Icon (*.ico)
  FT_JPEG	2	Independent JPEG Group (*.jpg)
  FT_JNG	3	JPEG Network Graphic (*.jng)
  FT_KOALA	4	Commodore 64 Koala format (*.koa)
  FT_LBM	5	Deluxe Paint Format (*.lbm)
  FT_MNG	6	Multiple Network Graphics (*.mng)
  FT_PBM	7	ASCII Portable Bitmap (*.pbm)
  FT_PBM_RAW	8	Binary Portable Bitmap (*.pbm)
  FT_PCD	9	Kodak PhotoCD (*.pcd)
  FT_PCX	10	PCX bitmap format (*.pcx)
  FT_PGM	11	ASCII Graymap (*.pgm)
  FT_PGM_RAW	12	Binary Graymap (*.pgm)
  FT_PNG	13	Portable Network Graphics (*.png)
  FT_PPM	14	ASCII Portable Pixelmap (*.ppm)
  FT_PPMRAW	15	Binary Portable Pixelman (*.ppm)
  FT_RAS	16	Sun Rasterfile (*.ras)
  FT_TARGA	17	Targa File (*.tga)
  FT_TIFF	18	Tagged Image File Format (*.tif)
  FT_WBMP	19	Wireless Bitmap (*.wbmp)
  FT_PSD	20	Photoshop Image (*.psd)
  FT_CUT	21	Dr. Halo (*.cut)

  
  
  
• PDFAuthor (String)
  MetaData author for PDF
  
  
• PDFCreator (String)
  MetaData creator for PDF
  
  
• PDFKeyword (String)
  MetaData keywords for PDF
  
  
• PDFSubject (String)
  MetaData subject for PDF
  
  
• PDFTitle (String)
  MetaData title of PDF
  
  
• RegisterKey (String)
  When you purchase the control, you will receive a registration key which will remove both the timeout feature (30 days), and the message box on the Convert function call. Set the RegisterKey property to the value provided to register your copy. This property set must be done before any other property settings or event calls are made the the component to ensure the evaluation limitations will not be called.
  
  
• SourceFile (String)
  The file name and path of the image to be converted to a PDF Example: "C:/temp/testimage.tif". The file extension is not used to determine the file type. You must supply the extension to ensure the control is able to correctly locate and load the indicated file, but it is possible to have this control work with images that are not names in the typical convention. Example: "C:/temp/testimage.tiff"