[Prev] [Next]

Graphic

Name

Synopsis

  CDATA

Attributes

This element has common and Role attributes.

Name	Value(s)	Type	Default Value
Align	(Left |Right |Center)	#IMPLIED
Depth	NUTOKEN	#IMPLIED
EntityRef	ENTITY	#IMPLIED
FileRef	CDATA	#IMPLIED
Format	(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 )	NOTATION	#IMPLIED
Scale	NUMBER	#IMPLIED
Scalefit	NUMBER	#IMPLIED
SrcCredit	CDATA	#IMPLIED
Width	NUTOKEN	#IMPLIED

Tag Minimization

Both the start- and end-tags are required for this element.

Description

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.

Processing Expectations

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.

The scaling attributes can interact:

Width and Depth

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:

pi      picas
pt      points
in      inches
mm      millimeters
cm      centimeters
em      em spaces

You can use different units for the two dimensions.

Align

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.

Scale

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).

Scalefit

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").

Attribute interactions

• 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.

• 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.

• 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.

• 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.

Parents

These elements contain Graphic: Appendix, Article, BiblioDiv, Bibliography, BlockQuote, BookInfo, Callout, Caution, Chapter, DocInfo, Equation, Example, Figure, Footnote, GlossDef, GlossDiv, Glossary, GraphicCO, Important, Index, IndexDiv, InformalEquation, InformalExample, InformalTable, InlineEquation, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, RefSect1, RefSect1Info, RefSect2, RefSect2Info, RefSect3, RefSect3Info, RefSynopsisDiv, RefSynopsisDivInfo, ScreenShot, Sect1, Sect1Info, Sect2, Sect2Info, Sect3, Sect3Info, Sect4, Sect4Info, Sect5, Sect5Info, SetIndex, SetInfo, Sidebar, SimpleSect, Step, Synopsis, Table, Tip, Warning, and entry.

Children

Graphic contains CDATA.

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.

Attributes

EntityRef

EntityRef holds the name of an external entity containing the content of the graphic.

FileRef

FileRef holds the filename, qualified by a pathname if desired, designating as file containing the content of the graphic.

Format

Line ends and leading white space must be preserved in output.

SrcCredit

SrcCredit holds information about the source of the graphic or LoTentry, as for use in a list of illustrations.

Width

Width indicates the width of the longest line in the element to which it pertains, in number of characters.

Depth

Depth indicates the desired depth of the repro area.

Align

Align indicates the horizontal alignment of the graphic within the repro area.

Scale

Scale provides an integer representing a percentage scaling factor (retaining the relative dimensions of the original graphic). The #IMPLIED default is 100 (percent).

Scalefit

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").

Examples

<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>

[Prev] graphics.attrib
[Next] GraphicCO
[Reference Home] [Davenport Group Home]