<refentry id="graphic.element">
<?dbhtml filename="graphic.html"?>
<refentryinfo>
<pubdate>$Date$</pubdate>
<releaseinfo>$Revision$</releaseinfo>
</refentryinfo>

<refmeta>
<indexterm><primary>elements</primary>
<secondary>graphic</secondary></indexterm>
<refentrytitle>graphic</refentrytitle>
<refmiscinfo>Element</refmiscinfo>
</refmeta>
<refnamediv>
<refname>graphic</refname>
<refpurpose>&graphic.purpose;</refpurpose>
</refnamediv>

&graphic.synopsis.gen;
<refsect1 condition='ref.description'><title>Description</title>

<para>
This element contains graphical data, or a pointer to an
external entity containing graphical data. One of the
deficiencies of the DocBook <sgmltag>Graphic</sgmltag> element is that
there is no way to specify an alternate text description of the 
graphic.  This has been rectified by the introduction of
<sgmltag>MediaObject</sgmltag>.
</para>

<refsect2 id="dbreproc.graphic"><title>Processing expectations</title>
<para>
&format.block;
</para>
<para>
There are several ways to provide content for a
<sgmltag>Graphic</sgmltag>.  It is best to use only one of these
methods.  However, if multiple graphic sources are provided, the
processing expectations are as follows: element content should be used
in favor of either <sgmltag class='attribute'>EntityRef</sgmltag> or <sgmltag
class='attribute'>FileRef</sgmltag> and <sgmltag class='attribute'>EntityRef</sgmltag>
should be used in favor of <sgmltag class='attribute'>FileRef</sgmltag>.
</para>
</refsect2> 

<refsect2 role='fu' revision="4.0"><title>&FutureChanges;</title>
<para>
<indexterm><primary>DocBook DTD</primary><secondary>Changes for <acronym>V4.0</acronym></secondary>
</indexterm>
In DocBook <acronym>V4.0</acronym>, <sgmltag>Graphic</sgmltag> will be declared <literal>EMPTY</literal>.
This change will require that any embedded graphic content be stored outside the
&SGML; source and pointed to with an 
<sgmltag class='attribute'>EntityRef</sgmltag> or 
<sgmltag class='attribute'>FileRef</sgmltag> attribute.
</para>
</refsect2>

<refsect2 role='fu' revision="5.0"><title>&FutureChanges;</title>
<para>
<indexterm><primary>DocBook DTD</primary><secondary>Changes for <acronym>V5.0</acronym></secondary>
</indexterm>
In DocBook <acronym>V5.0</acronym>, <sgmltag>Graphic</sgmltag> will be discarded. At that
time, graphics will have to be incorporated using
<sgmltag>MediaObject</sgmltag> or <sgmltag>InlineMediaObject</sgmltag>.
</para>
</refsect2>



&graphic.parents.gen;
</refsect1>
<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>align</term>
<listitem>
<para>
<sgmltag class="attribute">Align</sgmltag> specifies the horizontal alignment
of the graphic on the page or within the element that frames it.
</para>
</listitem>
</varlistentry>
<varlistentry><term>depth</term>
<listitem>
<para>
<sgmltag class="attribute">Depth</sgmltag> specifies the desired depth (vertical
distance, at least in horizontal writing systems) of the
image.
</para>
</listitem>
</varlistentry>
<varlistentry><term>entityref</term>
<listitem>
<para>
<sgmltag class="attribute">EntityRef</sgmltag> identifies the general entity
which contains (or points to) the content of the graphic.
</para>
</listitem>
</varlistentry>
<varlistentry><term>fileref</term>
<listitem>
<para>
<sgmltag class="attribute">FileRef</sgmltag> specifies the name of the file
which contains the content of the graphic.
</para>
</listitem>
</varlistentry>
<varlistentry><term>format</term>
<listitem>
<para>
<sgmltag class="attribute">Format</sgmltag> identifies the format of the graphic
content. The <sgmltag class="attribute">Format</sgmltag> must be a defined
notation.
</para>
</listitem>
</varlistentry>
<varlistentry><term>scale</term>
<listitem>
<para>
<sgmltag class="attribute">Scale</sgmltag> specifies integer representing a 
percentage scaling factor (retaining the relative dimensions of the 
original graphic). If unspecified, the value 100 (100&percnt;) is assumed.
</para>
</listitem>
</varlistentry>
<varlistentry><term>scalefit</term>
<listitem>
<para>
If <sgmltag class="attribute">ScaleFit</sgmltag> has the value 1 (true), then
the graphic is to be scaled (uniformly) to the specified width or depth.
The default value of 0 (false) indicates that the image will not be
scaled to fit (although it may still be scaled by the
<sgmltag class="attribute">Scale</sgmltag> attribute).
</para>
</listitem>
</varlistentry>
<varlistentry><term>srccredit</term>
<listitem>
<para>
<sgmltag class="attribute">SrcCredit</sgmltag> contains details about the source 
of the <sgmltag>Graphic</sgmltag>.
</para>
</listitem>
</varlistentry>
<varlistentry><term>width</term>
<listitem>
<para>
<sgmltag class="attribute">Width</sgmltag> indicates the width of the graphic.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&graphic.seealso.gen;
</refsect1>
<refsect1><title>Examples</title>

<informalexample role="example-source">
<programlisting>&graphic.example.1.txt;</programlisting>
</informalexample>

<anchor id="ex.os.graphic.1" role="HACK-ex.out.start"/>
&graphic.example.1.gen;
<anchor id="ex.oe.graphic.1" role="HACK-ex.out.end"/>

&graphic.example.seealso.gen;
</refsect1>
</refentry>

