<RefEntry ID="dbre.elem.Graphic">
<!-- Created by DTDParseRefentry version 0.94 -->
<!-- Consult http://www.ora.com/homepages/dtdparse/ -->
<!-- for more information. -->

<![ %dbre.ms.refmeta [
<RefMeta>
<IndexTerm><Primary>Graphic Element</Primary></IndexTerm>
<RefEntryTitle>Graphic</RefEntryTitle>
<RefMiscInfo>Element</RefMiscInfo>
</RefMeta>
]]>

<RefNameDiv>
<RefName>Graphic</RefName>
<RefPurpose>
Graphical data, or a
pointer to an external entity containing such data,
to be rendered as an object, not in-line

</RefPurpose>
</RefNameDiv>

<![ %dbre.ms.refsynopsisdiv [
<RefSynopsisDiv><Title>Content Model</Title>
<Synopsis>
  CDATA
</Synopsis>

<![ %dbre.ms.refsynopsisdiv.attr [
<RefSect2><Title>Attributes</Title>
<Para>
This element has <link linkend="dbre.x.common">common</link> and <link linkend="dbre.x.role"><sgmltag class=attribute>Role</></link> attributes.
</Para>
<INFORMALTABLE>
<TGROUP COLS=4>
<COLSPEC COLNUM=2 COLNAME=C2>
<COLSPEC COLNUM=4 COLNAME=C4>
<SPANSPEC SPANNAME=C2C4 NAMEST=C2 NAMEEND=C4>
<THEAD>
<ROW>
  <ENTRY>Name</ENTRY>
  <ENTRY>Value(s)</ENTRY>
  <ENTRY>Type</ENTRY>
  <ENTRY>Default Value</ENTRY>
</ROW>
</THEAD>
<TBODY>
<ROW>
  <ENTRY>Align</ENTRY>
  <ENTRY>(Left |Right |Center)</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>Depth</ENTRY>
  <ENTRY>NUTOKEN</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>EntityRef</ENTRY>
  <ENTRY>ENTITY</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>FileRef</ENTRY>
  <ENTRY>CDATA</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>Format</ENTRY>
  <ENTRY>(BMP| CGM-CHAR | CGM-BINARY | CGM-CLEAR | DITROFF | DVI | EPS | EQN | FAX | GIF | GIF87a | GIF89a | IGES | PCX | PIC | PS | SGML | TBL | TEX | TIFF | WMF | WPG | linespecific )</ENTRY>
  <ENTRY>NOTATION</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
</ROW>
<ROW>
  <ENTRY>Scale</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>Scalefit</ENTRY>
  <ENTRY>NUMBER</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>SrcCredit</ENTRY>
  <ENTRY>CDATA</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
<ROW>
  <ENTRY>Width</ENTRY>
  <ENTRY>NUTOKEN</ENTRY>
  <ENTRY>#IMPLIED</ENTRY>
  <ENTRY>&nbsp;</ENTRY>
</ROW>
</TBODY>

</TGROUP>

</INFORMALTABLE>

</RefSect2>
]]>

<![ %dbre.ms.refsynopsisdiv.tagmin [
<RefSect2><Title>Tag Minimization</Title>
<Para>
Both the start- and end-tags are required for this element.
</Para>
</RefSect2>
]]>

</RefSynopsisDiv>
]]>

<![ %dbre.ms.description [
<RefSect1><Title>Description</Title>
<para>Graphical data or a
pointer to an external entity containing such data,
to be rendered as an object, not in-line.
It has Format,
Fileref, Entityref, SrcCredit, and ID attributes,
and also the graphics scaling attributes Width, Depth,
Align, Scale, and Scalefit.
The format attribute may have the value of
any of the Notations defined at the head of the DTD.
</para>
<refsect2 id="dbreproc.graphic"><title>Processing Expectations</title>
<para>If data is given as the
content of Graphic, both Entityref and Fileref,
if present at all, should
be ignored, but a Format value should be provided and used.
If no data is given as the content of
Graphic and a value for Entityref
is given, the values of Fileref and Format, if provided, should be ignored.
Finally, if there is no content for Graphic and
Entityref is absent or null, Fileref must be
used.
</para><para>The scaling attributes can interact:</para>
<variablelist>
<varlistentry>
<term>Width and Depth</term>
<listitem><para>
These are equivalent to the CALS reprowid (desired width) and reprodep
(desired depth) of the "reproduction area," which is the rectangle in
the rendered output where the graphic will get placed (which is
potentially independent of the size of the graphic precisely because of
the possibility of scaling).  The #IMPLIED default is to use the
(possibly scaled) size of the graphic as the size of the reproduction
area.
Both Width and Depth take as values a number followed by an abbreviation
standing for a unit of measure, which should be drawn from this list:
</para><screen>
pi      picas
pt      points
in      inches
mm      millimeters
cm      centimeters
em      em spaces
</screen>
<para>
You can use different units for the two dimensions.
</para></listitem></varlistentry>
<varlistentry><term>Align</term>
<listitem><para>
This is equivalent to the CALS hplace (with the None option removed),
which is the desired horizontal alignment within the reproduction area.
This is only relevant when, and in directions in which, the graphic's
size is less than the size of the reproduction area.
</para></listitem></varlistentry>
<varlistentry><term>Scale</term>
<listitem><para>
This conflates the CALS hscale and vscale by providing an integer
representing a percentage scaling factor (retaining the relative
dimensions of the original graphic).  The #IMPLIED default is 100
(percent).
</para></listitem></varlistentry>
<varlistentry><term>Scalefit</term>
<listitem><para>
This is equivalent to the CALS scalefit, a Boolean toggle for scaling to
fit the desired width and/or depth.  0=no, 1=yes.  If "yes", the graphic
should be scaled using the same factor both horizontally and vertically.
If the proportions of the graphic differ from those of the reproduction
area, some white space will be left within the reproduction area.  The
#IMPLIED default is 0 ("no").
</para></listitem></varlistentry>
<varlistentry><term>
Attribute interactions</term>
<listitem><itemizedlist><listitem><para>
If the (possibly scaled) graphic is too large for the available area
  (column width, page width, or page depth) -- for example, if the
  specified Width and/or Depth is too large, or if the Scale percentage
  results in a too-large graphic -- results are undefined.  Some
  possibilities are that the graphic overflows the area or is (further)
  scaled in order to fit.
</para></listitem><listitem><para>
If Scalefit is 1 ("yes") but Width and Depth are unspecified, the
  system should act as though Width is either the column or the page
  width (as appropriate for the style currently being used) and Depth is
  the page height.  This behavior may be different from CALS.
</para></listitem><listitem><para>
If only one of Width and Depth is specified, the system should act as
  though the other value is the column/page width (for Width) or the
  page depth (for Depth), as explained just above, and the more
  constraining dimension is used for scaling.  This behavior may be
  different from CALS.
</para></listitem><listitem><para>If 
Scalefit and Scale are both specified, ignore Scalefit (along with
  any specified or implied width/depth values) and scale to the
  specified percentage.  This behavior may be different from CALS.
</para></listitem>
</itemizedlist>
</listitem></varlistentry></variablelist>
</refsect2> 


<![ %dbre.ms.description.parents [
<RefSect2><Title>Parents</Title>
<Para>
These elements contain Graphic:
<SimpleList Type=Inline>
<Member><Link LinkEnd="dbre.elem.Appendix">Appendix</Link></Member>
<Member><Link LinkEnd="dbre.elem.Article">Article</Link></Member>
<Member><Link LinkEnd="dbre.elem.BiblioDiv">BiblioDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Bibliography">Bibliography</Link></Member>
<Member><Link LinkEnd="dbre.elem.BlockQuote">BlockQuote</Link></Member>
<Member><Link LinkEnd="dbre.elem.BookInfo">BookInfo</Link></Member>
<Member><Link LinkEnd="dbre.elem.Callout">Callout</Link></Member>
<Member><Link LinkEnd="dbre.elem.Caution">Caution</Link></Member>
<Member><Link LinkEnd="dbre.elem.Chapter">Chapter</Link></Member>
<Member><Link LinkEnd="dbre.elem.DocInfo">DocInfo</Link></Member>
<Member><Link LinkEnd="dbre.elem.Equation">Equation</Link></Member>
<Member><Link LinkEnd="dbre.elem.Example">Example</Link></Member>
<Member><Link LinkEnd="dbre.elem.Figure">Figure</Link></Member>
<Member><Link LinkEnd="dbre.elem.Footnote">Footnote</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossDef">GlossDef</Link></Member>
<Member><Link LinkEnd="dbre.elem.GlossDiv">GlossDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.Glossary">Glossary</Link></Member>
<Member><Link LinkEnd="dbre.elem.GraphicCO">GraphicCO</Link></Member>
<Member><Link LinkEnd="dbre.elem.Important">Important</Link></Member>
<Member><Link LinkEnd="dbre.elem.Index">Index</Link></Member>
<Member><Link LinkEnd="dbre.elem.IndexDiv">IndexDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.InformalEquation">InformalEquation</Link></Member>
<Member><Link LinkEnd="dbre.elem.InformalExample">InformalExample</Link></Member>
<Member><Link LinkEnd="dbre.elem.InformalTable">InformalTable</Link></Member>
<Member><Link LinkEnd="dbre.elem.InlineEquation">InlineEquation</Link></Member>
<Member><Link LinkEnd="dbre.elem.ListItem">ListItem</Link></Member>
<Member><Link LinkEnd="dbre.elem.MsgExplan">MsgExplan</Link></Member>
<Member><Link LinkEnd="dbre.elem.MsgText">MsgText</Link></Member>
<Member><Link LinkEnd="dbre.elem.Note">Note</Link></Member>
<Member><Link LinkEnd="dbre.elem.Para">Para</Link></Member>
<Member><Link LinkEnd="dbre.elem.PartIntro">PartIntro</Link></Member>
<Member><Link LinkEnd="dbre.elem.Preface">Preface</Link></Member>
<Member><Link LinkEnd="dbre.elem.Procedure">Procedure</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect1">RefSect1</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect1Info">RefSect1Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect2">RefSect2</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect2Info">RefSect2Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect3">RefSect3</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSect3Info">RefSect3Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSynopsisDiv">RefSynopsisDiv</Link></Member>
<Member><Link LinkEnd="dbre.elem.RefSynopsisDivInfo">RefSynopsisDivInfo</Link></Member>
<Member><Link LinkEnd="dbre.elem.ScreenShot">ScreenShot</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect1">Sect1</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect1Info">Sect1Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect2">Sect2</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect2Info">Sect2Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect3">Sect3</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect3Info">Sect3Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect4">Sect4</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect4Info">Sect4Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect5">Sect5</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sect5Info">Sect5Info</Link></Member>
<Member><Link LinkEnd="dbre.elem.SetIndex">SetIndex</Link></Member>
<Member><Link LinkEnd="dbre.elem.SetInfo">SetInfo</Link></Member>
<Member><Link LinkEnd="dbre.elem.Sidebar">Sidebar</Link></Member>
<Member><Link LinkEnd="dbre.elem.SimpleSect">SimpleSect</Link></Member>
<Member><Link LinkEnd="dbre.elem.Step">Step</Link></Member>
<Member><Link LinkEnd="dbre.elem.Synopsis">Synopsis</Link></Member>
<Member><Link LinkEnd="dbre.elem.Table">Table</Link></Member>
<Member><Link LinkEnd="dbre.elem.Tip">Tip</Link></Member>
<Member><Link LinkEnd="dbre.elem.Warning">Warning</Link></Member>
<Member><Link LinkEnd="dbre.elem.entry">entry</Link></Member>
</SimpleList>.
</Para>

</RefSect2>
]]>

<![ %dbre.ms.description.children [
<RefSect2><Title>Children</Title>
<Para>
Graphic contains
<Link LinkEnd="dbre.elem.CDATA">CDATA</Link>.
</Para>

<Para>
In some contexts, additional elements may be allowed
by inclusions in parent elements.
Similarly, in some contexts, some of these elements
may be invalid due to exclusions in parent elements.
</Para>
</RefSect2>
]]>


</RefSect1>
]]>

<![ %dbre.ms.attrdesc [
<RefSect1><Title>Attributes</Title>

<variablelist>
<varlistentry><term>EntityRef</term>
<listitem>
<para>
EntityRef holds the name of an external entity
containing the content of the graphic.

</para>
</listitem>
</varlistentry>
<varlistentry><term>FileRef</term>
<listitem>
<para>
FileRef holds the filename, qualified by
a pathname if desired, designating as file containing
the content of the graphic.

</para>
</listitem>
</varlistentry>
<varlistentry><term>Format</term>
<listitem>
<para>
Line ends and leading white space must be preserved in output.

</para>
</listitem>
</varlistentry>
<varlistentry><term>SrcCredit</term>
<listitem>
<para>
SrcCredit holds information about the source
of the graphic or LoTentry, as for use in a list of illustrations.

</para>
</listitem>
</varlistentry>
<varlistentry><term>Width</term>
<listitem>
<para>
Width indicates the width of the longest line in the element
to which it pertains, in number of characters. 
</para>
</listitem>
</varlistentry>
<varlistentry><term>Depth</term>
<listitem>
<para>
Depth indicates the desired depth of the
repro area.

</para>
</listitem>
</varlistentry>
<varlistentry><term>Align</term>
<listitem>
<para>
Align indicates the horizontal alignment of the
graphic within the repro area.

</para>
</listitem>
</varlistentry>
<varlistentry><term>Scale</term>
<listitem>
<para>
Scale provides an integer
representing a percentage scaling factor (retaining the relative
dimensions of the original graphic).  The #IMPLIED default is 100
(percent).                     

</para>
</listitem>
</varlistentry>
<varlistentry><term>Scalefit</term>
<listitem>
<para>
Scalefit is a Boolean toggle for scaling to
fit the desired width and/or depth.  0=no, 1=yes.  If "yes", the graphic
should be scaled using the same factor both horizontally and vertically.
If the proportions of the graphic differ from those of the reproduction
area, some white space will be left within the reproduction area.  The
#IMPLIED default is 0 ("no").                                         

</para>
</listitem>
</varlistentry>
</variablelist>
</RefSect1>
]]>

<![ %dbre.ms.examples [
<RefSect1><Title>Examples</Title>
<programlisting>
<![ CDATA [
<FIGURE ID="FG-061-ch05-2" FLOAT="1">
<TITLE>The xdmlogwin Display
</TITLE>
<GRAPHIC FILEREF="gr061ch05t2.gif" FORMAT="GIF"></GRAPHIC>
<GRAPHIC ENTITYREF="gr061ch05t3.gif" FORMAT="GIF"></GRAPHIC>
</FIGURE>
]]>

</programlisting>

</RefSect1>
]]>

</RefEntry>