Rendering
Previous  Top  Next

A detailed document on FACSys 5.0 Enterprising Rendering is available in the Documentation Package.

Before the FACSys fax server transmits an outbound fax message, FACSys converts the message into fax format. If a message includes file attachments, the attachments are also converted into fax format.

The process of preparing a message for faxing is referred to as "rendering." FACSys renders files by using the print services of an application to output file attachments into a faxable file format. Depending on the way in which you configure FACSys, file attachment rendering may occur at the client workstation or at the fax server. Furthermore, attachment rendering may be performed using either the print services of an application or the optional Outside In™ Viewer technology option.

How and where rendering occurs:
Print to Fax
FACSys Printer Driver
Client-side (workstation) rendering unless the advanced client option to render locally is turned off.
e-mail to fax
FACSys Print Driver
Client-side (workstation) rendering unless the advanced client option to render locally is turned off.
File attachment from an email application or from AFM-SDK
from an e-mail gateway such as Outlook, SMTP, Lotus Notes, GroupWise
or
from the Active Fax Messaging Software Development Kit.
Server-Side rendering. Native application is launched to render the attachment. (eg MS OFFICE or ADOBE ACROBAT). Rendering will also occur if no native application is associated with the file type but the option 'Use the server's Outside In™ Rendering Services' is turned ON. If neither of these options are available, rendering will fail with the error "image sub-system failed to render the document"
Embedded codes in HPCL or PS files
from an application using print-stream embedded tokens. EG SAP, AMS, FileNet.
Server-side Rendering. This print process requires the optional FACSys (HPCL-PS) Renderer to convert the printer stream's embedded codes through the FXQ: port. You need to also install the FACSys Queue Monitor






Supported File Formats

The print services of the FACSys server software include the ability to render the following image file types. This means that no additional configuration is required to enable users to attach the following file types to outbound faxes.

TIFF G3/G4/MH
Intel DCX
PCX
HPGL2
ASCII Text
Basic-RTF Documents
BMP (1,4,16,256, 24-bit color)
Postscript Level 1 and 2 AND PCL5e w/ TrueType**
   

** With the optional add-on FACSys HPCL renderer : Postscript Level 1 and 2 AND PCL5e w/ TrueType   

In addition, if users will be attaching any of the following file types, you can configure FACSys to render the files using the print services of the native applications or the optional Outside In™ Viewer:
Microsoft Excel XLS
Lotus WordPro
Microsoft Write WRI
Adobe Acrobat PDF**
WordPad TXT
JetForm Central JFM   
Outlook V-card
PowerPoint PPT   
Lotus 123 WKS
Visio
Microsoft Word DOC, HTML, RTF

      
** Rendering of Adobe PDF documents REQUIRES the installation of Adobe Acrobat FULL PRODUCT Version 7 or greater on the FACSys server. It is not sufficient to install Acrobat Reader only.

** Another option to installing Adobe FULL PRODUCT ON THE FACSys Server is the installation of Ghostscript.

Rendering PDF files with Ghostscript

Starting with FACSys 4.91, it is possible to have the FACSys server use the external GhostScript
application for rendering PostScript and PDF files. Here's the procedure for enabling this feature:

Download and install the most recent version of GhostScript. There are various places on Internet where it can be obtained. Alternately, you can use this URL for downloading from our web site: http://download.emfast.com/utils/GhostScript.zip
Also, you need to update some FACSys files. The updates can be downloaded from here http://download.emfast.com/utils/491_pdfrender_gs.zip.
To install these files:

- stop all the FACSys services and close the Desktop client from the System Tray  
- replace C:\FACSys\faxmngr.exe with the one included in the ZIP file  
- replace the C:\Windows\System32\imglib32.dll and C:\Windows\System32\FxPrinter.dll with the ones included in the ZIP file  
- edit the following registry key HKLM\Software\FACSys\ImageLibrary\ShellFlags and add 40 hexadecimal to the current value. For example if the ShellFlags are 0, make it 40 hexadecimal, if the ShellFlags are 8, then make it 48 hexadecimal and so on.  
- start all the FACSys services and test  

About the Outside In™ (formerly INSO) Viewer

NEW INFORMATION

Owing to the change in licensing arrangments with the owners of the Outside In™ technology, the Outside In™ 6.01 Viewer technology is no longer installed automatically with the FACSys server software. It is necessary to:
·Purchase the Optional Outside In™ Rendering Service  
·Download the FACSys-OutsideIn.zip file and install the Outside In™ engine  
·Acquire and install a FACSys Outside In™ Rendering Service License from emFAST.  

If you have FACSys 4.8 or earlier and are updating to 5.0 then Outside In™ (formerly INSO) is already installed on your system but you will still need a FACSys Outside In™ Rendering Service License to activate it.


·When you install the FACSys fax server software, the Outside In Viewer technology can be optionally installed if you purchased this add-on feature. At Outside In core is a filtering technology that understands the file formats of more than 250 current and legacy applications, including the most popular word-processor, spreadsheet, database, bitmap, drawing and presentation formats.  
·When you configure FACSys to use the Outside In™ software for rendering/printing fax file attachments at the fax server, you eliminate the requirement of installing the Native applications on the fax server. For example, if users will be attaching Excel documents to their outbound faxes and you configure fax server rendering using the FACSys print services (rather than the Outside In™ print services), then you must install Excel on the fax server.  
·However, Outside In™ is a viewer program designed to provide a reasonable facsimile of the file content. Using Outside In™ for conversion is not as accurate as using the native application to obtain "What you see is what you fax" ("WYSIWYF").  
·If your outbound faxing results are not being rendered accurately enough by Outside In™ then install the native application for the document type and set the rendering option in the FACSys Server Properties, rendering tab, to use the native application.  
·An example of this would be the requirement to fax LEGAL, LANDSCAPE Excel file attachments. Outside In™ will tile them onto separate pages, but Microsoft Excel will render them properly.  
·Similarly if you are rendering HTML documents you must consider that the variety of HTML viewers and display techniques provides differing results. FACSys uses Word to render HTML documents. Therefore you must ensure that the formatting of the file displays properly in WORD, before attempting to have FACSys render it.  
·If you are planning to use the FACSys API to programmatically attach a created file it is preferable to submit a WORD or a PDF attachment rather than an HTML or an RTF attachment AND have WORD or Adobe FULL PRODUCT installed on the faxserver.  

Easy Rendering Configuration
·FACSys fully automates the installation and configuration of the software's rendering services by doing the following:  
·When you install the FACSys fax server software, a server-based FACSys Document Printer is created automatically. This printer outputs to a special port monitored by FACSys and is used for rendering file attachments on the server.  
·If you purchase the optional FACSys Outside In™ Rendering Service, and install it along with the FACSys Outside In™ Rendering Service License, the installation program installs the Outside In Viewer files and adds the INSO path to the system PATH environment variable. As an alternative to installing document applications on the fax server, Outside In understands the file formats of more than 250 applications.  
·When you install the FACSys Desktop client software, a local FACSys Fax Printer is created automatically. This printer is used by the client for "printing documents to fax format" and for rendering file attachments on the workstation.  

From within the FACSys Administrator program, you control the rendering configuration directly from the server properties Rendering tab (illustrated below). Easily enable or disable native application rendering simply by clicking on the desired options. Any changes to the dialog are made in real-time without having to stop or restart any fax services.

Where is this option?
Display the properties of the fax server, and click the Rendering tab:

A checked or selected option causes documents of that type to be rendered using the print services of the native application installed on the server. In the above example, if attachment rendering is configured to take place on the fax server, then all Acrobat, Excel, Word, Word RTF, Word HTML, and Visio file attachments are "printed" by their native applications to the FACSys Document Printer on the fax server. Note that this requires the installation of Acrobat 7 (Full Product) or better , Excel, Word, and Visio on the fax server.

In order to Render other attachment types you need to install the optional Outside In™ Rendering Service.
This is comprised of two parts:
·The Outside In™ installer files which can be purchased through your FACSys Authorized Reseller  
·The FACSys Outside In™ Rendering Service License, which will be provided at no cost when you purchase the optional Outside In™ Renderer.  

Add the Outside In™ Rendering Services License. Now the option is selectable

Faxing Document Files

FACSys provides several ways for users to include existing documents with their outbound faxes. The methods and configuration requirements are discussed below.


Printing to Fax
FACSys gives users the ability to "print documents to fax" from their Windows applications. Simply by printing a Windows document to the client's FACSys Fax Printer, the printed output is included as a file attachment in a new fax message. Depending on the type of print driver used by the FACSys Fax Printer, the format of the attachment is in either PCL/postscript format or TIFF-image format. If you configure the printer driver for HPCL or Postscript you need to purchase the optional add-on HPCL Renderer. To give users the ability to print documents to fax, users simply "print" their documents to the FACSys Fax Printer installed on their workstation. The FACSys Desktop client setup program installs and configures the FACSys Fax Printer automatically.

Printing to Mail
When a FACSys client is configured to "print to email," printing a document to the FACSys Fax Printer causes the printed output to be included as an attachment in a new email message (rather than in a new FACSys fax message). The user's message and printed document attachment is then sent via the server's FACSys mail gateway.

See Also: Configuring email gateways.

To give users the ability to print documents to email, the email gateway must be configured at the server. Also, at the client workstations, users must select the FACSys Desktop delivery option 'Use electronic mail transport when printing.' This option is on the Advanced Options window accessible from the Sending tab.

Printing to Mail Without the FACSys Desktop
The FACSys Mail Printer is a tool for Outlook and Lotus Notes users that provides the "print to mail" features and benefits of the FACSys Desktop program without requiring the FACSys client software to be installed. By installing the FACSys Mail Printer on the client workstation, the client user can simply "print" a document to the FACSys Mail Printer. The user's document is converted to .TIF format and placed as a file attachment in a new Outlook/Lotus Notes mail message. See Instructions for installing the FACSys Mail Printer. Instructions for using the FACSys Mail Printer are in the FACSys Desktop manual.

Attaching Document Files to Faxes
The document types supported by FACSys are listed above.

FACSys users can also attach document files to their outbound faxes. Depending on the way in which you configure FACSys, the document files are rendered either at the fax server or at the user's client workstation, and they are rendered either by the FACSys rendering services, the option add-on FACSys HPCL Renderer or by the optional Outside In™ Viewer technology.

To Render Document Attachments at the Client note the following:

·The user must have a FACSys Fax Printer installed on their workstation. (The FACSys Desktop client setup program installs and configures the FACSys Fax Printer automatically).  
·The user must enable the 'local rendering' option in their FACSys Desktop (this is the default setting).  
·The applications in which the document attachments were created must also be installed on the workstation.  

Using Native Applications to Render Document Attachments at the Server

·Document attachments can be rendered into fax format at the fax server either by the native applications (e.g., Word, Excel) or by the optional Outside In™ Viewer technology.  

To instruct FACSys to use the native application(s) to render document attachments at the fax server, you must configure the following:
·On the fax server, you must install the applications in which the document attachments were created. For example, to render Word attachments, you must install Microsoft Word on the fax server. Also, the application versions on the server must be the same as or greater than the application versions used at the FACSys clients.  
·On the fax server, you must associate the FACSys Fax Device Manager service with a Windows account that has local administrative privileges. See Services Associations.  
·In Pre 4.8 versions of FACSys the fax server's FACSys Document Printer was set to print to the FACSYS: port. Since FACSys 4.8 and on operating systems Windows 2000 and newer, this is now set to the FXS: port (The FACSys fax server setup program installs and configures the FACSys Document Printer automatically).  
·To satisfy any initial program prompts that may display the first time an application is opened, you must do the following: Using the Windows account that is associated with the FACSys Fax Device Manager service, log onto the fax server. Then open and close every application that will be used to output/print attachments. Clear any 'automatic update' dialogs and change them to 'manual'  

Note: Configuring Word to Render HTML Attachments

When opening and closing Word to satisfy initial program prompts for the rendering of HTML attachments, do the following:
1.On the fax server, launch Microsoft Word.  
2.Open an HTML file that WAS NOT created with Word. When you are prompted to use Word as your default HTML editor, answer NO.  
3.Close the Word application.  

Using Outside In™ to Render Document Attachments at the Server
To enable the Outside In™ Viewer to render native document file attachments at the fax server, you must do the following:
1.On the fax server, you must associate the FACSys Fax Device Manager service with a Windows account that has local administrative privileges. See Services Associations.  
2.In Pre 4.8 versions of FACSys the fax server's FACSys Document Printer was set to print to the FACSYS: port. With FACSys 4.8 on operating systems Windows 2000 and newer, this is now set to the FXS: port (The FACSys fax server setup program installs and configures the FACSys Document Printer automatically.)  
3.From the FACSys Administrator program, display the server's properties and define the options on the Rendering tab.  

Notes on Supported File Formats and Fonts
·In addition to the supported file listed above note the following:  
·If users will be attaching file types not supported directly by FACSys, you should implement the Outside In™ rendering technology.  
·Server-based rendering of Adobe Acrobat PDF file attachments requires that your fax server operate under Windows 2000 or better. Also, note that you must install the FULL Acrobat product on the server (i.e., not the Acrobat Reader). As of the printing of this manual, Acrobat 7 or better is the minimum supported version required for server-based rendering.  
·JetForm Central rendering by FACSys requires that you define the path to the JetForm Central program directory in the fax server's Registry. Detailed instructions are listed in a Technical Support Bulletin available from the FACSys Web site.  
·When preparing a fax message, FACSys will render cover page text and document attachments using the exact or closest True-Type font available. If users require specific fonts, then you must verify that the fonts are installed on the sending fax server.  

Configuring Word to Render All RTF Attachments
·By default, basic-RTF formatted attachments are rendered directly by FACSys without invoking the print services of another application. However, Word-RTF files generally include many extended RTF features. As a result, when Word-RTF attachments are rendered by the FACSys print services, the quality of the resulting faxed files may not be acceptable.  
To force Word to render all RTF attachments (e.g., regardless of whether they were created in Word), do the following:
·Select the 'Microsoft Word (Rich Text Format)' option on the server Properties Rendering tab.  
·Define a WordRTF registry key according to the Technical Support Bulletin on the FACSys Web site.  

Note: Changes to the FACSys Rendering System since V 4.7SP4a
The New Rendering System
·Research has shown that the majority of FACSys customers no longer use HPCL files to submit attachments to the rendering engine. Therefore, with the release of version 4.7 SP4a the HPCL rendering tool was removed from FACSys in favor of a new Enterprise Fax Rendering System designed to accommodate more file types and produce better results using native application rendering.  
·Any user who purchased FACSys 4.1 through FACSys 4.7 SP3 will receive the HPCL renderer at no cost.  
·The HPCL rendering functionality will continue to be available as an add-on option at additional cost.  

Client-Side Rendering
Users who submit jobs to the FACSys desktop printer, by 'print to fax' or 'e-mail to fax', will continue to create a faxable image on their workstation. This process uses the native application on the desktop, in conjunction with the FACSys FAX Printer installed by the client software. If the FACSys Fax Printer is configured to use a PCL or PS printer driver then the add-on renderer must also be purchased.
 
Server-Side Rendering
The remainder of this discussion refers only to file attachments, submitted through
·a mail gateway.  
·or through the AFM/SDK (Active Fax Messaging Software Development Kit, sometimes also referred to as an API – Application Programming Interface).  
·or as an attachment to the FACSys Desktop Client (if 'render locally' is not enabled on the client).  

Any user who wants to submit HPCL (Hewlett-Packard Control Language) files to the FACSys system will need the add-on renderer. This will include any application program that creates an HPCL print image and submits it to the FACSys system as an attachment.

Any user who wants to submit PS files of type I or II (with the exception of Legal and A4 sizes) MAY also use the add-on HPCL-PS renderer.
1.If, in the "FACSys Admin program, properties, rendering tab", no native applications are checked as being installed  
2.then FACSys will attempt to use the optional Outside In™ to convert the document.  
·If 'application rendering' options are checked, FACSys will use the native application.  
·(Note, these applications must be installed while logged in as the Account associated to the FACSys Fax Device Manager and opened at least once to clear any dialog screens that may launch on initial use).  
·The option 'if the Application fails, use the server's Outside In™ rendering services' is CHECKED, FACSys will also attempt to render using Outside In™.  
THEN, FACSys will:
2. Check the file content.  
·If the file is HPCL:  
·If the HPCL-PS renderer service is present, the HPCL attachment will be converted to TIF.  
If the renderer is not present, it will fail.

Resolution: install the optional HPCL renderer.
1.If the file is a Postscript File:  
·FACSys will first try the add-on HPCL-PS renderer. If the add-on renderer is present, and the file content is compatible with the add-on renderer (PS Level I and II), it will be converted to a TIF image and be submitted to the queue.  
·If that process fails, and if Acrobat 7 or better full product (not just Reader) is installed, FACSys will launch Adobe Acobat, convert the PS file to a PDF file, submit to Acrobat and convert to TIF. This is the default process. This process will take longer than converting the document with the optional HPCL Renderer.  
·If you have the renderer installed but don't want FACSys to ignore the renderer and want to FORCE the use of application rendering, then set the TryApplication Key to 2 as shown below:  
 
NEW TryApplication Key  
HKLM System\CurrentControlSet\Services\FaxManager\System\TryApplication  
TryApplication = 0 If renderer is installed use only the renderer for PS even though the application is installed  
TryApplication = 1 If renderer is installed then use it first. If that fails then use the application. This is the default  
2-- Always use the app even though renderer is present  


2.If the file is an MS Office-type file, then FACSys will launch the native application, convert to a TIF image, and submit to the queue.  
·Note that the behavior of MS Office attachments is different depending on what version of Office you have installed. There are known issues, for example, with PowerPoint attachments. MS Office 97 and XP behave one way, and Office 2000 behaves another way. To accommodate this, has introduced a new registry key as follows:  
Use the 'ShellFlags' DWORD key only if you have problems with Excel, PPT or Word.  
If you have difficulty with rendering RTF (Rich Text Format) documents (particularly those created by programs other than Microsoft Word), you may need to add a DWORD key as follows:  
·HKEY_LOCAL_MACHINE\SOFTWARE\FACSys\ImageLibrary\WordRTF and set the value to 1.  

Since FACSys Version 4.8, FACSys can now render Landscape XLS files with ShellFlags set to 2 or 7. There is a new feature to use the application rendering for any unknown file type like WMF etc.