| DocBook: The Definitive Guide 2.0.17 (Alpha)

# graphicco

$Revision$

$Date$

graphicco — A graphic that contains callout areas

## Synopsis

### Content Model

    graphicco ::=
    (areaspec,graphic,calloutlist*)

### Attributes

Common attributes

## Description

`Callout`s, such as numbered bullets, are an annotation mechanism. In an online system, these bullets are frequently “hot,” and clicking on them sends you to the corresponding annotation.

A `GraphicCO` is a wrapper around an `AreaSpec` and a `Graphic`. An `AreaSpec` identifies the locations (coordinates) on the `Graphic` in which the callouts occur. The `GraphicCO` may also contain the list of annotations in a `CalloutList`, although the `CalloutList` may also occur outside of the wrapper, elsewhere in the document.

### Processing expectations

Formatted as a displayed block.

The mandatory processing expectations of a `GraphicCO` are minimal: a system is expected to render the graphic, if possible, and the callout list, if present.

In online environments, the processing system may be able to instantiate the linking relationships between the callout marks on the graphic and the annotations. For example, an HTML presentation system might use the coordinate information to construct a client-side image map. Some processing systems may even be able to go a step further and generate the callout marks automatically from the coordinate information. But this level of sophistication is not mandatory.

### Future Changes

In DocBook V5.0, `GraphicCO` will be discarded. In its place, use `MediaObjectCO`.

### Parents

These elements contain graphicco: `answer`, `appendix`, `article`, `bibliodiv`, `bibliography`, `blockquote`, `callout`, `caution`, `chapter`, `constraintdef`, `example`, `figure`, `footnote`, `glossary`, `glossdef`, `glossdiv`, `important`, `index`, `indexdiv`, `informalexample`, `informalfigure`, `itemizedlist`, `listitem`, `msgexplan`, `msgtext`, `note`, `orderedlist`, `para`, `partintro`, `preface`, `procedure`, `qandadiv`, `qandaset`, `question`, `refsect1`, `refsect2`, `refsect3`, `refsection`, `refsynopsisdiv`, `revdescription`, `screenshot`, `sect1`, `sect2`, `sect3`, `sect4`, `sect5`, `section`, `setindex`, `sidebar`, `simplesect`, `step`, `taskprerequisites`, `taskrelated`, `tasksummary`, `tip`, `variablelist`, `warning`.

### Children

The following elements occur in graphicco: `areaspec`, `calloutlist`, `graphic`.

## See Also

`areaspec`, `calloutlist`, `co`, `coref`, `imageobjectco`, `mediaobjectco`, `programlistingco`, `screenco`.

## Examples

    <!DOCTYPE graphicco PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
              "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
    <graphicco>
    <areaspec units="calspair">
      <areaset id="oneway" coords="">
        <area id="oneway1" coords="300 400"/>
        <area id="oneway2" coords="325 340"/>
      </areaset>
      <area id="myhouse" coords="425 590"/>
    </areaspec>
    <!-- This is not a real URL! -->
    <graphic fileref="http://maps.example.com/EARTH?USA?MA?AMHERST"/>
    </graphicco>

graphic |  | group

Copyright © 1999, 2000, 2001, 2002, 2003 O'Reilly & Associates, Inc. All rights reserved.