<media>

Media Object

Description of and pointer to an external file that holds a media object (for example, an animation, a movie).

Remarks

The “content” of the <media> element is not the media object itself, but information concerning the object. The external file that contains the object is named by the @xlink:href attribute.
Position: The @position attribute may be used to indicate whether this element must be anchored at its exact location within the text or whether it may float, but best practice is to anchor graphics and media objects. The few media objects that float loose in text should be anchored there, and all the media objects inside figures, tables, etc., should be anchored as well, although the outer structure (figure, boxed text) may be allowed to float.
Usage: Display component elements, such as <caption>, should always be used at the highest possible level; in other words, if a <media> element is inside a <fig>, the <caption>, <long-desc>, etc., should be part of the <fig>, not part of the <media>. Use a <caption> element on a <media> only when the media object is not enclosed in any other structure or when a figure contains multiple media objects, each of which must have its own <caption>. For similar reasons, the @position attribute should be set to “anchor” for a <media> element that is inside a larger display container such as a <fig>.

Related Elements

This Suite contains several elements that describe and point to non-XML material: <graphic>, <inline-graphic>, <media>, <inline-media>, <supplementary-material>, and <inline-supplementary-material>. The elements <graphic> and <inline-graphic> contain a pointer to a still image (such as a photograph, diagram, line drawing, etc.) that is part of the document. The elements <media> and <inline-media> contain a pointer to a non-XML, frequently binary, object (such as a movie, audio clip, dataset, or other non-XML format) that is integral to the document’s content, where  “integral” means that the media object is discussed within (and possibly displayed within) the document; the media object is part of the document.
In contrast, the elements <supplementary-material> and <inline-supplementary-material> are used to describe either XML material (such as figures, tables, and sections) or non-XML material (such as graphics, films, audio clips, datasets, or other material) that are considered to be “additional material” (non-integral) accompanying a document. Like <graphic>, <inline-graphic>, <inline-media>, and <media>, the supplementary material elements never contain the object they describe, even if it is an XML object such as a figure, although they may point to it.
The element <inline-supplementary-material> is used to mark up references to additional material, where the reference appears within the regular flow of the text and does not have a preview image or separate caption. The <supplementary-material> element is used to describe a more complicated reference, where the description of the supplementary object resembles a figure in that it can be positioned as a floating or anchored object and may take a caption.
Best Practice: Unlabeled media objects should be tagged as <media>s, not as <fig>s. A common test to determine whether an object is a <fig> versus a <media> is to ask, “If there were a “List of Figures” for this article, should this object appear in that list?”

Attributes

Content Model

<!ELEMENT  media        %media-model;                                >

Expanded Content Model

(alt-text | long-desc | abstract | email | ext-link | uri | caption | object-id | kwd-group | label | attrib | permissions)*

Description

This element may be contained in:

Example 1

Video object with DOI:
...
<media id="v1" mime-subtype="avi" mimetype="video" orientation="portrait" 
position="anchor" specific-use="original-format" xlink:href="v1">
<object-id pub-id-type="doi" specific-use="metadata">10.1063/1.4807071.1</object-id>
</media>
...

Example 2

Several media objects as processing alternatives inside an <alternatives> wrapper as part of a figure caption:
...
<fig id="f1" orientation="portrait" position="float">
<label>FIG. 1.</label>
<caption>
<p>(a) Schematic of the working principles of HFM, (b) a typical application
scheme for an electric bias in HFM, (c) regulation the conformations and
dynamics (trapping, concentration, and sudden stretching) of λ-DNA molecules
in HFM, and (d) schematic of the trapping location regulation (enhanced online).
[URL: <ext-link ext-link-type="uri" xlink:href="http://dx.doi.org/10.1063/1.4762852.1">
http://dx.doi.org/10.1063/1.4762852.1</ext-link>]
<alternatives>
  <media id="v1" mime-subtype="avi" mimetype="video" orientation="portrait"
    position="anchor" specific-use="original-format" xlink:href="v1"/>
  <media mime-subtype="mpeg" mimetype="video" orientation="portrait"
    position="anchor" specific-use="archival-format" xlink:href="v1"/>
  <media mime-subtype="x-flv" mimetype="video" orientation="portrait"
     position="anchor" specific-use="online-format" xlink:href="v1"/>
</alternatives>
</p>
</caption>
<graphic orientation="portrait" position="float" xlink:href="f1"/>
<graphic id="f1a" orientation="portrait" position="float" xlink:href="dummy1.png"/>
<graphic id="f1b" orientation="portrait" position="float" xlink:href="dummy2.png"/>
<graphic id="f1c" orientation="portrait" position="float" xlink:href="dummy3.png"/>
<graphic id="f1d" orientation="portrait" position="float" xlink:href="dummy4.png"/>
</fig>
...