IRun^* RTF Converter

version 1.11

This software converts RTF documents conforming to the RTF1.5 Specifications to XML or HTML. IRun supplies two options for HTML converison, you can choose to include inline CSS elements to create better results, or you can exclude them to support older browsers.

The “irun.dll” component allows you to integrate IRun to your applications. With this component you can write batch conversion code, you can convert documents within server extensions and you can add conversion feature to your applications.

We can help you convert huge amounts of documents to internet within a short time, by developing custom software for your needs. Please contact us if you have huge amounts of documents that are waiting to take place in the internet. The project may involve indexing, table of contents generation, custom page styles and navigation and other custom needs.

IRun source code is also available upon request. Please contact us if you need the source code.

IRun can handle most of the RTF features. Here is the list of features that are supported in the current release of IRun:

• Paragraph formatting including border and background color
• Character formatting
• Regular and irregular tables, table borders and background colors
• Embedded Images and OLE Objects
• Symbols
• Fields which have RTF results
• Lists and list levels
• RTF, Document, section properties
• Styles
• Bullets and numbering

What's new:

IRun.DLL Calling Syntax:

In order to call IRun from an application include “irun.dll” and “sbdll.dll” in your DLL calling path. Call EXRTF2WEB function with the following parameters.

int EXRTF2WEB (         char *   source,  // source file name
                                    char *   destination,  // destination file name
                                    int        options,  // an OR’ed list of options
                                    char *   bgcolor,  // HTML bgcolor
                                    char *   title,   // HTML title
                                    int        dpi)   // WMF-GIF conversion DPI (dots Per inch)

for the options use the following enumaration.

typedef enum
{

} exOptions ;

If bgcolor and title are NULL the values are extracted from the source document. The DPI value should be greater than 30. bgcolor is the string representation of background color as in the HTML.
The function returns 1 if everything is OK. If there are any errors the function returns negative values.

A second function makes the conversion on memory I/O buffers:
int

EXBufferRTF2WEB (	unsigned char*	inputBuffer, // address of the input buffer
	int	inputBufferSize, // size int bytes of the input buffer
	unsigned char**	outputBuffer, // address of the output buffer (as reference)
	int*	outputBufferSize, // output buffer size in bytes (as reference)
	exHTMLObject**	referencedObjects, // start address of the referenced object array (as reference)
	int*	referencedObjectCount, // number of referenced objects (as reference)
	int	options, // an OR'ed list of options (see above)
	char*	bgcolor, // HTML bgcolor
	char*	title, // HTML title
	int	dpi) // WMF-GIF conversion DPI (dots Per inch)

Images and other referenced objects are in a list with the exHTMLObject type:

typedef struct exHTMLObject_s
{
   int id;
   int size;
   unsigned char *data;
} exHTMLObject;

It is the callers reponsibility to free the memory allocated for the output buffers and objects.
This function creates image links in "_img_n.gif" format. Here "n" is the number of image in the referenced objects list.

Here is a “C” example:
/* proc definition */
typedef int __stdcall (* EXRTF2WEB)
                           (char* source,
                            char* dest,
                            int options,
                            char* title,
                            char* bgcolor,
                            int dpi);

void
Convert( void )
{
   HINSTANCE    inst;
   EXRTF2WEB   proc;
   int   ret;
   inst=LoadLibrary((LPCTSTR)"irun.dll");    
   if(inst)
   {
       proc=(EXRTF2WEB)GetProcAddress(inst,(LPCTSTR)"EXRTF2WEB");
       if(proc)
           ret=(*proc)(“test.rtf”,”test.html” ,0x0f,NULL,NULL,96);    
       FreeLibrary(inst);
   }
}

IRun.exe is a tiny program to that uses "irun.dll".

Compatibility:

Windows95,98,NT,2000. Currently only "ansi" RTF files are supported.


Please report bugs to gungors@superonline.com , you may attach the source file for which you encounter problems.

Gungor Senyurt
Pilot Software Ltd.
http://www.pilotltd.com