<refentry id="imagedata.default.scale">

  <refmeta>

    <refentrytitle>imagedata.default.scale</refentrytitle>

  </refmeta>

  <refnamediv>

    <refname><parameter>imagedata.default.scale</parameter></refname>

    <refpurpose>Specifies the default image scaling properties</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <programlisting>

      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="syn/imagedata.default.scale.xml"/></programlisting>

  </refsynopsisdiv>

  <refsection id="sec-defaultscale">

    <title>Description</title>

    <para>Default scale to apply to every <sgmltag>imagedata</sgmltag> that does not contain any scaling attribute.</para>

<para>By default this parameter is set to `pagebound`

so that the included images keep their natural size up to the page

boundaries.</para>

<para>Two other special parameters are available:

'maxwidth=<replaceable>width</replaceable>' and

'maxheight=<replaceable>height</replaceable>' where <replaceable>width</replaceable>

and <replaceable>height</replaceable> define the maximum image

dimensions, i.e. the image keeps its natural size up to the specified

maximum dimension. Both 'maxwidth' and 'maxheight' settings can be combined in a

comma separated list.</para>

<para>Example:

<programlisting>dblatex -P imagedata.default.scale=maxwidth=10cm,maxheight=8cm file.xml</programlisting>

</para>

<para>Except these special reserved values, the expected value of the parameter

must be some valid options passed to the \includegraphics command.</para>

  </refsection>

</refentry>