DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

ImageData

Name

ImageData -- Pointer to external image data

Synopsis

Content Model

ImageData ::=
EMPTY

Attributes

Common attributes

Name	Type	Default
Width	NUTOKEN	None
SrcCredit	CDATA	None
Scale	NUMBER	None
Format	Enumeration: BMP CGM-BINARY CGM-CHAR CGM-CLEAR DITROFF DVI EPS EQN FAX GIF GIF87a GIF89a IGES JPEG JPG linespecific PCX PIC PS SGML TBL TEX TIFF WMF WPG	None
Scalefit	NUMBER	None
Align	Enumeration: Center Left Right	None
Depth	NUTOKEN	None
EntityRef	ENTITY	None
FileRef	CDATA	None

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Description

This element points to an external entity containing graphical image data.

Processing expectations

May be formatted inline or as a displayed block, depending on context. Render the image.

There are two ways to provide content for ImageData: EntityRef or FileRef. It is best to use only one of these methods, however, if multiple sources are provided, EntityRef will be used in favor of FileRef.

Parents

These elements contain ImageData: ImageObject.

Children

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

Attributes

Align

Align specifies the horizontal alignment of the image data 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 data.

EntityRef

EntityRef identifies the general entity which points to the content of the image data.

FileRef

FileRef specifies the name of the file which contains the content of the image data.

Format

Format identifies the format of the image data. The Format must be a defined notation.

Scale

Scale specifies integer representing a percentage scaling factor (retaining the relative dimensions of the original image data). If unspecified, the value 100 (100%) is assumed.

Scalefit

If ScaleFit has the value 1 (true), then the image data 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 Scale attribute).

SrcCredit

SrcCredit contains details about the source of the image data.

Width

Width indicates the width of the graphic.

Examples

For examples, see ImageObject, InformalFigure, InlineMediaObject, MediaObjectCO, VideoObject.

---

Prev	Home	Next
Honorific	Up	ImageObject

Back to: DocBook: The Definitive Guide