· Home
· Contact
· News
· Links
· Download

· OzTeX
· Anagrams
· Alchemy
· LifeLab
· Googolator
· Odd Jobs

Software by Andrew Trevorrow

OzTeX FAQ

The most Frequently Asked Questions about OzTeX:


Why is previewing slower on Panther?

A few people reported a dramatic slowdown when OzTeX displays a dvi page containing PK fonts. This was due to a bug in Panther and has been fixed in OzTeX 5.2.


Why is printing slower on Panther?

OzTeX 5.1 on Panther fails to detect if your current printer supports PostScript, so it doesn't call dvips but uses a slow bitmap printing method. In OzTeX 5.2 the "Force PostScript Printing" flag is always ticked on Panther or later and so OzTeX always calls dvips. This is possible because Gimp-Print (which comes installed with Panther) allows PostScript data to be sent to a non-PostScript printer.


Why can't OzTeX find %cmmi10 on Panther?

OzTeX's previewer has trouble locating certain hidden screen fonts, like %cmmi10, on Panther. I'm not sure if this is a bug in Panther or a problem in the TrueType fonts created by Selwyn Hollis, but the solution is to install the non-hidden fonts available at Selwyn's site: www.appliedsymbols.com/cmps/.


Does OzTeX run natively on OS X?

Yes, see the OzTeX on OS X page.


Why can't OzTeX find my text editor?

If OzTeX reports that it can't find your specified text editor (or any other helper application) then try upgrading to OzTeX 5.1 or later. It uses a more reliable strategy to find user-specified applications.


Does OzTeX come with pdftex/pdflatex?

No, but if using OS X you can install Gerben Wierda's port of teTeX and then you can call pdftex or pdflatex from OzTeX's Tools menu.


Why has pdflatex stopped working?

After updating to Gerben Wierda's latest teTeX distribution you might discover that the pdflatex item in OzTeX's Tools menu no longer works. The problem is that teTeX no longer supports the pdflatex.fmt file. The LaTeX team have decreed that e-TeX is to be the default typesetting engine and so pdflatex now runs pdfetex with a format called pdflatex.efmt.

The best solution is to edit TeX/Configs/Default and replace the existing extra_tools entry for pdflatex:

"unix,pdftex -shell -fmt=pdflatex -int=nonstopmode %f,pdflatex,tex" |

with this:

"unix,pdflatex -shell -int=nonstopmode %f,pdflatex,tex" |

I'll be making this change in the next release of OzTeX so it's quite okay to modify the supplied Default file. If for some reason you don't want to change the Default pdflatex item then you can create (or update) the pdflatex.fmt file -- start up Terminal and run the following commands:

pdftex -ini -jobname=pdflatex -progname=pdflatex pdflatex.ini
rm pdflatex.log texsys.aux
sudo mv pdflatex.fmt /usr/local/teTeX/share/texmf.local/web2c/pdflatex.fmt
sudo chown root:admin /usr/local/teTeX/share/texmf.local/web2c/pdflatex.fmt


Can pdflatex include eps files?

Not directly, but you can tell pdflatex to convert eps files to pdf files on the fly. Edit your LaTeX file and add these lines before \begin{document}:

\ifx\pdfoutput\undefined
% we are running LaTeX, not pdflatex
\usepackage{graphicx}
\else
% we are running pdflatex, so convert .eps files to .pdf
\usepackage[pdftex]{graphicx}
\usepackage{epstopdf}
\fi

If you have an existing document with commands like \includegraphics{foo.eps} then LaTeX will include foo.eps but pdflatex will automatically convert it to foo.pdf and include that.

Note that it is better to leave off the extension; ie. use \includegraphics{foo}. Then pdflatex will include foo.pdf if it exists, but if not it will look for foo.eps and call epstopdf to create foo.pdf.


Why do my eps files appear black when previewed?

It's caused by a bug in OS X. A fix was added in OzTeX 5.1.


Can I get more magnification scales when previewing?

Yes, just increase OzTeX's viewing_resolution parameter. For example, put lines like these in your Local file's OzTeX-only section:

viewing_resolution = 720
viewing_mode = esphi

Or if you want even more magnification scales:

viewing_resolution = 1200
viewing_mode = ljfzzz

The above mode names come from MF/Inputs/Etc/modes.mf. Note that the pixels_per_inch setting in the mode_def must match the viewing_resolution if you want OzTeX to make missing PK fonts on the fly.

If you disable PK font making (untick "Make missing PK fonts" in the View DVI dialog), or if your docs only use outline fonts, then you can set the viewing_mode to any unknown mode like "xxx". Don't use a known mode like "laserwriter" because OzTeX checks the more common modes to make sure the viewing_resolution matches.


Why wrong glyphs when previewing PostScript fonts?

This can happen due to bugs in the PostScript font renderer built into OS X. Unfortunately the OS X renderer does not produce the same results as ATM on OS 8/9 when using PostScript fonts in their traditional format; ie. a suitcase file with one or more printer font files (of type LWFN).

The simplest solution is to use TrueType fonts instead of PostScript fonts. Selwyn Hollis has created TrueType versions of the CM and AMS fonts. Both hidden and visible versions are available at www.appliedsymbols.com/cmps/.

If you only want to use the fonts with OzTeX then best to get the hidden versions to avoid cluttering up the font menu in other apps. Download and unpack the appropriate .sit archive, put the .dfont files in ~/Library/Fonts and remove any existing PostScript versions of the CM and AMS fonts. Restart OzTeX and it will use the new fonts.


How can I improve readability when previewing?

If you're using OzTeX on OS 8/9 then the best solution is to install the free PostScript versions of the Computer Modern and AMS fonts. They are available from CTAN sites. You'll also need to install ATM. Once all the fonts and ATM are installed, just select the "Add Outline Fonts" config file before previewing or printing.

If you're using OS X then upgrade to OzTeX 5.1 or later. This version uses a smarter smoothing algorithm for outline fonts, plus you can adjust the darkness level of outline fonts and PK fonts separately. As discussed elsewhere, use TrueType fonts instead of PostScript fonts to avoid bugs in the OS X font renderer.

Commercial PostScript fonts for Lucida, MathTime and European Modern are available from Y&Y. The OzTeX support files for these fonts are in Extras/Y&Y/. If you'd like to preview these fonts on OS X, try asking Y&Y to supply TrueType or OpenType versions.


How do I install ATM?

If you want to see nice-looking PostScript fonts when OzTeX is previewing on OS 8/9 then you must have ATM (Adobe Type Manager) installed. A free copy of ATM is supplied with Acrobat Reader (version 3.02 or later) which you might still be able to download from Adobe. After installing Acrobat Reader, open its Fonts subfolder and drag the ATM extension to your system folder, then restart your Mac. ATM will now render PostScript screen fonts in all applications.


Can absolute or relative paths be used to include files?

Yes, but I don't recommend it because it reduces the portability of your document. See the OzTeX User Guide's section on "Path names in input files".


How do I use a .mf file to make a .tfm file?

In general, you can't simply open a .mf file in OzMF to create a .tfm file. This is because most .mf files require a suitable mode and magnification to be set up first (and Metafont's default mode does not create a tfm file). The solution is to create a .make file that can be opened by MakeTeXPK. Assuming you have a file called foo.mf, use a text editor to create a foo.make file with a line like this:

MakeTeXPK foo 303 101 3.0 nullmode

Add similar lines for every different .mf file. Put the new tfm files into a folder where OzTeX can find them.


How do I install a new LaTeX package?

A LaTeX package usually consists of a .ins file, plus one or more .dtx files, and possibly some .fdd files. To install a package so that OzTeX can use it, run LaTeX on the .ins file. This should create one or more files with extensions of the form .sty, .cfg or .fd. Move these files into a folder where TeX can find them.

If you want to read detailed documentation about the package then use LaTeX to process the .dtx file and create a .dvi file. After using the package and verifying that everything works, you can safely delete the .ins/.dtx/.fdd files.


How can I override a supplied file?

OzTeX's Golden Rule: Never delete, replace or modify a supplied file. This reduces the chances of OzTeX behaving strangely and also makes it much easier to upgrade to future versions. (There is only one exception to this rule: Occasionally I tell users it is okay to change a supplied file, but I only do this when the change is going to be part of the next release.)

All localized changes should be isolated in your Local config file, and that includes overriding supplied files. For example, suppose a newer version of one of the .sty files in TeX/Inputs/LaTeX/ is released. To override the old file, put the new version in a folder like mytex/inputs/ and then add this line to your Local file's OzTeX-only section:

input_folders = mytex/inputs/ $c

Or if you want to override the supplied config.ps file used by dvips then copy the file from TeX/DVIPS/Inputs/, put it in a folder like mytex/dvips/, make the changes to that file, then add this line to your Local file's OzTeX-only section:

ps_folders = mytex/dvips/ $c

By telling OzTeX to search your folders first, files in those folders will override any supplied files that have the same names. The OzTeX User Guide's section on "Search paths and subfolder expansion" has a list of all the parameters that control file searching.

Note that it is also possible to override files on a per-document basis. TeX and dvips always search for input files in the current folder first.


How can I rotate a table or piece of text?

LaTeX users can use the \rotatebox command defined in the graphics package; see the examples in TeX/Inputs/Graphics/grfguide.tex. Plain TeX users should study the examples in TeX/DVIPS/Docs/rotsample.tex.


Does OzTeX support printers with non-square pixels?

If it's a PostScript printer then no problem. Create a config.xxx file for dvips that specifies a suitable mode and corresponding X and Y resolutions, then add the option "-Pxxx" when you print.

If you don't have a PostScript printer then use dvips to create a .ps file, convert it to a .pdf file (using Ghostscript or Distiller), then print the .pdf file using Acrobat.


Why is my output printed at the wrong size?

The most likely reason is that OzTeX's printing_resolution parameter does not match the actual resolution of your printer. If you don't know your printer's resolution then see if the printer's name is mentioned in MF/Inputs/Etc/modes.mf. If it is then set printing_resolution to the pixels_per_inch value used in the mode_def.

The printing_resolution parameter is always used by OzTeX when printing a dvi file on a non-PostScript printer. It is also used when printing on a PostScript printer, but only if the "Use Standard PostScript" option is ticked.


Why can't dvips find my font/header files?

The ps_folders parameter is used by OzTeX's implementation of dvips to search for various types of input files (config.*, psfonts.*, *.map, *.pro, *.enc, *.pfa, *.pfb and LWFN files). If dvips can't find a file then check your ps_folders search paths by selecting Show -> Files and Folders from OzTeX's Config menu.


Is OzTeX freeware or shareware?

Depends which version you are talking about. All versions up to and including 1.42 are freeware; versions 1.5 and later are shareware. OzTeX's main page has more information about the shareware fee.


Can OzTeX run on System 7 or earlier?

Not the latest version -- it requires OS 8.6 or later. OzTeX 4.1 is the last Classic version to run on Mac systems prior to 8.6.


Can OzTeX run on old Macs with 680x0 chips?

Not the latest version -- it requires PowerPC Macs. OzTeX 4.1 is a "fat" application that runs in native mode on both 680x0 and PowerPC machines. Ditto for OzMF, OzMP and nearly all the other applications distributed with OzTeX.


What is the correct way to typeset "OzTeX"?

Use this macro:

\def\OzTeX{O\kern-.03em z\kern-.15em\TeX}

(There is no kerning in OzMF, OzMP and OzTtH.)

* * *

Home