Embedded TEX Configuration
When you install Embedded TEX, an icon will be added to your Start Menu allowing you to set various options related to Embedded TEX and its associated programs.
Options in this box are saved for the current user only. Selecting the "Save default options for all users" option will additionally save the options for any users that have not already configured their Embedded TEX installation.
Variables
Variables represent parts of applications and templates that are generally configurable. The three standard variables are as follows:
| Variable | Description |
|---|---|
| Ghostscript | The path to the bin directory of your GNU or AFPL Ghostscript installation. |
| Lilypond | The path to the bin directory of your Lilypond installation. |
| TeX | The path to the bin directory of your TEX installation. |
To edit a variable, double-click on it. The following dialog box will appear:
Click the File button to choose a file, or the Folder button to choose a folder on your disk. For the standard variables, you should choose the specified folder.
Options
The "Optimise for" list allows you to select whether newly-created Embedded TEX objects should be set to produce low-resolution output for the screen or high-resolution output for the printer. You can change this setting for individual objects in the preview box.
The "Automatic preview" option allows you to select whether the preview box should open with automatic preview enabled. You can also enable or disable preview in the preview box itself.
Applications (Advanced)
It is possible to modify the list of applications in Embedded TEX. You may even modify the built-in applications if necessary.
An application is made up of a number of steps. An application step is a single program with a set of parameters that describe how to call it and what files it produces. The steps are run in order with their log information concatenated, and the output of the last step is treated as a graphics file that contains the displayed information.
To add a new application, right-click in the list and select Add. To edit an application, double-click on it.
To add a step to the application, right-click and select Add. To edit an existing step, double-click on it. You may move steps up and down by right-clicking and selecting one of the movement options.
The path to the application is typically specified relative to a variable. You may add your own variables to the main list. If you browse for a file, the most applicable variable (if any) will be automatically selected to replace the path. Click the Variables button for a list of variables you can use in a field.
The "Check exit code" option indicates whether Embedded TEX will check the exit code of a program. If this option is selected, the exit code of the program will be tested and the generation will fail if the exit code is not zero. This is standard behaviour for most programs.
The arguments and file names may also use variables. The following special variables are also available:
| Variable | Description |
|---|---|
| InputFileName | The filename and path of the input file. |
| InputBaseName | The base filename (without extension) of the input file. |
| InputPath | The path to the input file. |
| Resolution | The target resolution in dpi, generally either the screen resolution or a printing resolution (600dpi). |
Diagnostic output from the program can come from several sources, indicated by the "Log source" list.
| Log source | Description |
|---|---|
| StdOutAndErr | The program outputs to both stderr and stdout. Most programs use this for the most useful diagnostic information. |
| StdOut | The program outputs to stdout only. |
| StdErr | The program outputs to stderr only. |
| File | The program outputs to the specified log file. |
| None | No log information should be collected. |
The "Other files" list displays a list of files that are produced by the program. These files will be deleted after the program is run. You should ensure that this list is complete to avoid littering the user's hard disk.
Templates (Advanced)
It is possible to modify the list of templates in Embedded TEX. You may even modify the built-in templates if necessary.
To add a new template, right-click in the list and select Add. To edit a template, double-click on it.
A template is a simple text string that contains variables that are replaced. In addition to the above special variables and any variables that are defined in the configuration, a further special variable called ${Source} is defined, which contains the text that the user entered.