inlinemediaobject
inlinemediaobject — An inline media object (video, audio, image, and so on).
Synopsis
inlinemediaobject ::=
Attributes
Common attributes and common linking attributes.
No additional attributes.
Additional Constraints
- If this element is the root element, it must have a version attribute.
Description
The inlinemediaobject
element contains a set of
alternative “graphical objects”: videoobject
,
audioobject
, and imageobject
.
Additional textual descriptions may be provided with
textobject
s.
An inlinemediaobject
provides a wrapper for a
set of alternative presentations for some, usually graphical,
information. It is the “inline” equivalent of
mediaobject
.
In almost all contexts where text is allowed,
inlinemediaobject
is also allowed. This allows an
author to provide a graphic for a character or glyph—for example, one
that is not available in the publisher’s fonts or perhaps is not
available in Unicode. Authors should exercise care when using
inlinemediaobject
for this purpose as graphics may be
difficult or impossible to display in some contexts on some presentation
systems.
Processing expectations
Formatted inline.
If possible, the processing system should use the content of the
first object within the inlinemediaobject
. If the
first object cannot be used, the remaining objects should be
considered in the order that they occur. A processor should use the
first object that it can, although it is free to choose any of the
remaining objects if the primary one cannot be used.
Under no circumstances may more than one object in an
inlinemediaobject
be used or presented at the same
time.
For example, an inlinemediaobject
might
contain a high-resolution image, a low-resolution image, and a text
description. For print publishing, the high-resolution image is used;
for online systems, either the high- or low-resolution image is used,
possibly including the text description as an online alternative. In a
text-only environment, the text description is used.
Attributes
Common attributes and common linking attributes.
- any attribute
Any attribute in any other explicit namespace
Parents
These elements contain inlinemediaobject
: abbrev
, accel
, acronym
, address
, alt
, application
, arg
, artpagenums
, attribution
, authorinitials
, bibliocoverage
, biblioid
, bibliomisc
, bibliomixed
, bibliomset
, bibliorelation
, bibliosource
, bridgehead
, buildtarget
, caption
(db.html.caption), citation
, citebiblioid
, citetitle
, city
, classname
, classsynopsisinfo
, code
, command
, computeroutput
, confdates
, confnum
, confsponsor
, conftitle
, constant
, contractnum
, contractsponsor
, contrib
, country
, database
, description
, edition
, email
, emphasis
(db._emphasis), emphasis
(db.emphasis), entry
, enumidentifier
, enumitemdescription
, enumname
, enumvalue
, envar
, errorcode
, errorname
, errortext
, errortype
, exceptionname
, fax
, filename
, firstname
, firstterm
(db._firstterm), firstterm
(db.firstterm), foreignphrase
(db._foreignphrase), foreignphrase
(db.foreignphrase), funcdef
, funcparams
, funcsynopsisinfo
, function
, givenname
, glosssee
, glossseealso
, glossterm
(db._glossterm), glossterm
(db.glossterm), guibutton
, guiicon
, guilabel
, guimenu
, guimenuitem
, guisubmenu
, hardware
, holder
, honorific
, initializer
, inlineequation
, interfacename
, issuenum
, jobtitle
, keycap
, keycode
, keysym
, label
, lineage
, lineannotation
, link
, literal
, literallayout
, macroname
, manvolnum
, markup
, mathphrase
, member
, meta
(db.meta.content), methodname
, modifier
, mousebutton
, msgaud
, msglevel
, msgorig
, olink
, option
, optional
, orgdiv
, orgname
, otheraddr
, othername
, package
, pagenums
, para
, paramdef
, parameter
, personname
, phone
, phrase
(db._phrase), phrase
(db.phrase), pob
, postcode
, primary
, primaryie
, productname
, productnumber
, programlisting
, prompt
, property
, publishername
, quote
(db._quote), quote
(db.quote), refdescriptor
, refentrytitle
, refmiscinfo
, refname
, refpurpose
, releaseinfo
, remark
, replaceable
, returnvalue
, revnumber
, revremark
, screen
, secondary
, secondaryie
, see
, seealso
, seealsoie
, seeie
, seg
, segtitle
, seriesvolnums
, shortaffil
, simpara
, specializedtemplate
, state
, street
, subscript
, subtitle
, superscript
, surname
, symbol
, synopsis
, synopsisinfo
, systemitem
, tag
, td
, template
, templatename
, term
, termdef
, tertiary
, tertiaryie
, th
, title
, titleabbrev
, tocentry
, token
, trademark
, type
, typedefname
, unionname
, uri
, userinput
, varname
, volumenum
, wordasword
, year
.
Children
The following elements occur in inlinemediaobject
: alt
, audioobject
, imageobject
, imageobjectco
, info
(db.titleforbidden.info), textobject
, videoobject
.
See Also
Related elements: audioobject
, caption
, imageobject
, mediaobject
, textobject
, videoobject
.
Examples
1 |<?xml version="1.0" encoding="UTF-8"?>
|<article xmlns="http://docbook.org/ns/docbook">
|<title>Example inlinemediaobject</title>
|5 |
<para>Einstein's most famous equation,
|<inlineequation>
|<inlinemediaobject>
|<imageobject condition="print">
|<imagedata fileref="figs/print/db5d_refeqn03.pdf"/>
10 |</imageobject>
|<imageobject condition="web">
|<imagedata fileref="figs/web/db5d_refeqn03.png"/>
|</imageobject>
|<textobject>
15 |<phrase>E=mc<superscript>2</superscript></phrase>
|</textobject>
|</inlinemediaobject>
|</inlineequation>, expresses the relationship between matter and energy.
|</para>
20 ||
</article>
Einstein's most famous equation, , expresses the relationship between matter and energy.