<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
                          "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % entities.ent SYSTEM "entities.ent">
%entities.ent;
]>

<refentry id="pdftex.cfg">

<?dbhh topicname="MIKTEXHELP_PDFTEX_CFG" topicid="0"?>

<refmeta>
<refentrytitle>pdftex.cfg</refentrytitle>
<manvolnum>5</manvolnum>
<refmiscinfo class="source">&PACKAGE_NAME;</refmiscinfo>
<refmiscinfo class="version">&miktexrev;</refmiscinfo>
<refmiscinfo class="manual">File Formats</refmiscinfo>
</refmeta>

<refnamediv>
<refname>pdftex.cfg</refname>
<refpurpose>configuration settings for &MiKTeXpdfTeX;</refpurpose>
</refnamediv>

<refsect1>

<title>Description</title>

<para>&MiKTeXpdfTeX; configurations settings are read from the file
<filename>pdftex.cfg</filename> when a format file is being created by
&MiKTeXpdfTeX;.</para>

<caution><para>Do not edit this file directly. Run <userinput>initexmf
--edit-config-file pdftex.cfg</userinput> to edit configuration
settings for &MiKTeXpdfTeX;.</para></caution>

</refsect1>

<refsect1>

<title>Instructions</title>

<para>A typical <filename>pdftex.cfg</filename> file looks like this,
setting up output for A4 paper size and the standard &TeX; offset of
1&nbsp;inch:</para>

<programlisting>compress_level 9
decimal_digits 3
horigin 1 true in
vorigin 1 true in
image_resolution 300
move_chars 1
output_format 1
page_width 210 true mm
page_height 297 true mm
pdf_minorversion 4
pk_resolution 600</programlisting>

<para>The configuration file sets default values for these parameters,
and they all can be overridden in the &TeX; source file.  Dimensions
can be specified as <constant>true</constant>, which makes them immune
for magnification (when set).</para>

<variablelist>
<varlistentry>
<term>compress_level</term>
<listitem><para>This integer parameter specifies the level of text and
in||line graphics compression.  &MiKTeXpdfTeX; uses Zip compression.
A value of&nbsp;0 means no compression, 1&nbsp;means fastest,
9&nbsp;means best, 2..8 means something in between.  Just set this
value to&nbsp;9, unless there is a good reason to do otherwise; 0 is
great for testing macros that use <markup
role="tex">\pdfliteral</markup>.</para></listitem>
</varlistentry>
<varlistentry>
<term>decimal_digits</term>
<listitem><para>This integer specifies the preciseness of real numbers
in &PDF; page descriptions. It gives the maximal number of decimal
digits after the decimal point of real numbers. Valid values are in
range 0..5. A higher value means more precise output, but also results
in a much larger file size and more time to display or print. In most
cases the optimal value is&nbsp;2. This parameter does
<emphasis>not</emphasis> influence the precision of numbers used in
raw &PDF; code, like that used in <markup
role="tex">\pdfliteral</markup> and annotation action
specifications.</para></listitem>
</varlistentry>
<varlistentry>
<term>horigin &amp; vorigin</term>
<listitem><para>These dimension parameters can be used to set the
offset of the &TeX; output box from the top left corner of the
<quote>paper</quote>.</para></listitem>
</varlistentry>
<varlistentry>
<term>image_resolution</term>
<listitem><para>When &MiKTeXpdfTeX; is not able to determine the natural
dimensions of an image, it assumes a resolution of type 72&nbsp;dots
per inch.  Use this variable to change this default
value.</para></listitem>
</varlistentry>
<varlistentry>
<term>move_chars</term>
<listitem><para>Although &PDF; output is claimed to be portable,
especially when all font information is included in the file, problems
with printing and viewing have a persistent nature.  Moving the
characters in range 0&ndash;31 sometimes helps a lot.  When set
to&nbsp;1, characters are only moved when a font has less than 128
glyphs, when set to&nbsp;2 higher slots are used
too.</para></listitem>
</varlistentry>
<varlistentry>
<term>output_format</term>
<listitem><para>This integer parameter specifies whether the output
format should be &DVI; or &PDF;.  A positive value means &PDF; output,
otherwise we get &DVI; output.</para></listitem>
</varlistentry>
<varlistentry>
<term>page_width &amp; page_height</term>
<listitem><para>These two dimension parameters
<indexterm>
<primary>paper size</primary>
<secondary>changing</secondary>
</indexterm>
specify the output medium dimensions (the paper, screen or whatever
the page is put on).  If they are not specified, these values are
calculated.</para></listitem>
</varlistentry>
<varlistentry>
<term>pdf_minorversion</term>
<listitem><para>Sets the &PDF; version of the generated file and the
latest allowed &PDF; version of included &PDF;s.  The value&nbsp;3
tells &MiKTeXpdfTeX; to set the &PDF; version to 1.3 and allows only
included &PDF;s with versions less than 1.3.  A suitable default value
is 4.</para></listitem>
</varlistentry>
<varlistentry>
<term>pk_resolution</term>
<listitem><para>One can use this entry to specify the resolution for
bitmap fonts.  Nowadays most printers are capable to print at least
600 dots per inch, so this is a reasonable default.</para></listitem>
</varlistentry>
</variablelist>

</refsect1>

</refentry>
