Besides the built-in formatting objects processor (Apache FOP) the user can use other external processors. <oXygen/> has implemented an easy way to add RenderX XEP as external FO processor if the user has the XEP installed.
The FO Processors preferences panel is opened from menu → +XML+XSLT/FO/XQuery+FO Processors
- Enable the output of the built-in FOP
When checked all FOP output will be displayed in a results pane at the bottom of the editor window including warning messages about FO instructions not supported by FOP.
- Memory available to the built-in FOP
If your FOP transformations fail with an "Out of Memory" error select from this combo box a larger value for the amount of memory reserved for FOP transformations.
- Configuration file for the built-in FOP
You should specify here the path to a FOP configuration file, necessary for example to render to PDF using a special true type font a document containing Unicode content.
- The built-in FOP generates PDF/A-1b output
When selected PDF/A-1b output is generated.
![[Note]](img/note.gif)
Note All fonts have to be embedded, even the implicit ones. More information about configuring metrics files for the embedded fonts can be found in How to Add a Font to the <oXygen/> Built-in FO processor article available on the oXygen documentation page.
Note You cannot use the
<filterList>key in the configuration file. FOP will generate the following error: The Filter key is prohibited when PDF/A-1 is active.
The users can configure the external processors for use with <oXygen/> in the following dialog.
- Name
The name that will be displayed in the list of available FOP processors on the FOP tab of the Transforming Configuration dialog.
- Description
The description of the FO processor displayed in the Preferences->FO Processors option.
- Output Encoding
The encoding used for the output stream of the FO processor which will be displayed in a results panel at the bottom of the <oXygen/> window.
- Error Encoding
The encoding used for the error stream of the FO processor which will be displayed in a results panel at the bottom of the <oXygen/> window.
- Working directory
The directory in which the intermediate and final results of the processing will be stored. Here you can use one of the following editor variables:
-
${homeDir} The path to user home directory.
-
${cfd} The path of current file directory. If the current file is not a local file the directory will be the user's Desktop directory.
-
${pd} The project directory.
-
${pn} The project name.
-
- Command line
The command line that will start the FO processor, specific to each processor. Here you can use one of the following editor variables:
- ${method}
The FOP transformation method (pdf, ps, txt).
- ${fo}
The input FO file.
- ${out}
The output file.