xmlgraphics-fop/xmlgraphics-fop-fontmetrics.xml

104 lines
3.7 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.docbook.org/xml/4.5/docbookx.dtd"
[
<!ENTITY product "xmlgraphics-fop-fontmetrics">
]>
<refentry id="fop-fontmetrics">
<refentryinfo>
<productname>&product;</productname>
<authorgroup>
<corpcredit>Apache Foundation</corpcredit>
<author>
<firstname>Thomas</firstname>
<surname>Schraitle</surname>
<contrib>Manpage</contrib>
</author>
</authorgroup>
</refentryinfo>
<refmeta>
<refentrytitle>&product;</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="version">1.1</refmiscinfo>
<!--<refmiscinfo class="source"></refmiscinfo>-->
<refmiscinfo class="manual"
>http://xmlgraphics.apache.org/fop/1.0/fonts.html#advanced</refmiscinfo>
</refmeta>
<refnamediv>
<refname>&product;</refname>
<refpurpose>Reads TTF files and Generates Appropriate Font Metrics</refpurpose>
</refnamediv>
<refsynopsisdiv id="fontmetrics.synopsis">
<title>Synopsis</title>
<para>Classnames:
<classname>org.apache.fop.fonts.apps.PFMReader</classname> and
<classname>org.apache.fop.fonts.apps.TTFReader</classname></para>
<cmdsynopsis><command>&product;</command>
<group choice="opt">
<arg choice="plain">-t</arg>
<arg choice="plain">-p</arg>
</group>
<group choice="opt">options</group>
<arg>fontfile.ttf</arg>
<arg>xmlfile.xml</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsection id="fontmetrics.options">
<title>Options</title>
<para>The first argument has to be <option>-t</option> or
<option>-p</option>. The option <option>-t</option> (default)
activates the TrueTypeReader, option <option>-p</option> activates
the PostSriptReader.</para>
<para>The following options in alphabetical order are
available:</para>
<variablelist>
<varlistentry>
<term><option>-d</option></term>
<listitem>
<para>debug mode</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-enc ansi</option></term>
<listitem>
<para>With this option you create a WinAnsi encoded font. The
default is to create a CID keyed font. If you're not going
to use characters outside the pdfencoding range (almost the
same as iso-8889-1) you can add this option.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-fn <replaceable>FONTNAME</replaceable></option></term>
<listitem>
<para>default is to use the fontname in the <filename
class="extension">.ttf</filename> file, but you can
override that name to make sure that the embedded font is
used (if you're embedding fonts) instead of installed fonts
when viewing documents with Acrobat Reader.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-ttcname <replaceable>FONTNAME</replaceable></option></term>
<listitem>
<para>If you're reading data from a TrueType Collection
(<filename class="extension">.ttc</filename> file) you
must specify which font from the collection you will read
metrics from. If you read from a <filename class="extension"
>.ttc</filename> file without this option, the fontnames
will be listed for you.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-q</option></term>
<listitem>
<para>quiet mode</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
</refentry>