graphic
graphic — A displayed graphical object (not an inline)
Synopsis
Content Model
graphic ::=
EMPTY
Attributes
Name | Type | Default | ||||||||||||||||||||||||||||||
width | CDATA | None | ||||||||||||||||||||||||||||||
srccredit | CDATA | None | ||||||||||||||||||||||||||||||
contentdepth | CDATA | None | ||||||||||||||||||||||||||||||
entityref | ENTITY | None | ||||||||||||||||||||||||||||||
scalefit | CDATA | None | ||||||||||||||||||||||||||||||
contentwidth | CDATA | None | ||||||||||||||||||||||||||||||
align |
| None | ||||||||||||||||||||||||||||||
valign |
| None | ||||||||||||||||||||||||||||||
depth | CDATA | None | ||||||||||||||||||||||||||||||
fileref | CDATA | None | ||||||||||||||||||||||||||||||
format |
| None | ||||||||||||||||||||||||||||||
scale | CDATA | None |
Description
This element contains graphical data, or a pointer to an external entity containing graphical data. One of the deficiencies of the DocBook Graphic
element is that there is no way to specify an alternate text description of the graphic. This has been rectified by the introduction of MediaObject
.
Processing expectations
Formatted as a displayed block.
There are several ways to provide content for a Graphic
. 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 EntityRef
or FileRef
and EntityRef
should be used in favor of FileRef
.
Future Changes
In DocBook V4.0, Graphic
will be declared EMPTY
. This change will require that any embedded graphic content be stored outside the SGML source and pointed to with an EntityRef
or FileRef
attribute.
Future Changes
In DocBook V5.0, Graphic
will be discarded. At that time, graphics will have to be incorporated using MediaObject
or InlineMediaObject
.
Parents
These elements contain graphic: answer
, appendix
, appendixinfo
, article
, articleinfo
, bibliodiv
, bibliography
, bibliographyinfo
, blockinfo
, blockquote
, bookinfo
, callout
, caution
, chapter
, chapterinfo
, constraintdef
, entry
, equation
, example
, figure
, footnote
, glossary
, glossaryinfo
, glossdef
, glossdiv
, graphicco
, important
, index
, indexdiv
, indexinfo
, informalequation
, informalexample
, informalfigure
, informaltable
, inlineequation
, itemizedlist
, listitem
, msgexplan
, msgtext
, note
, objectinfo
, orderedlist
, para
, partinfo
, partintro
, preface
, prefaceinfo
, procedure
, qandadiv
, qandaset
, question
, refentryinfo
, referenceinfo
, refsect1
, refsect1info
, refsect2
, refsect2info
, refsect3
, refsect3info
, refsection
, refsectioninfo
, refsynopsisdiv
, refsynopsisdivinfo
, revdescription
, screenshot
, sect1
, sect1info
, sect2
, sect2info
, sect3
, sect3info
, sect4
, sect4info
, sect5
, sect5info
, section
, sectioninfo
, setindex
, setindexinfo
, setinfo
, sidebar
, sidebarinfo
, simplesect
, step
, synopsis
, table
, taskprerequisites
, taskrelated
, tasksummary
, td
, th
, tip
, variablelist
, warning
.
Attributes
align
Align
specifies the horizontal alignment of the graphic on the page or within the element that frames it.depth
Depth
specifies the desired depth (vertical distance, at least in horizontal writing systems) of the image.entityref
EntityRef
identifies the general entity which contains (or points to) the content of the graphic.fileref
FileRef
specifies the name of the file which contains the content of the graphic.format
Format
identifies the format of the graphic content. TheFormat
must be a defined notation.scale
Scale
specifies integer representing a percentage scaling factor (retaining the relative dimensions of the original graphic). If unspecified, the value 100 (100%) is assumed.scalefit
If
ScaleFit
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 theScale
attribute).srccredit
SrcCredit
contains details about the source of theGraphic
.width
Width
indicates the width of the graphic.
See Also
alt
, audioobject
, caption
, imageobject
, inlinegraphic
, inlinemediaobject
, mediaobject
, textobject
, videoobject
.
Examples
<!DOCTYPE figure PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<figure><title>Notre Dame Cathedral</title>
<graphic srccredit="Norman Walsh, 1998" fileref="figures/notredame.png"/>
</figure>
For additional examples, see also equation
, figure
, graphicco
, informalequation
, inlineequation
, screenshot
.