DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

videoobject

videoobject — A wrapper for video data and its associated meta-information.

Synopsis

videoobject ::=

  • Sequence of:

Description

A videoobject is a wrapper containing videodata and its associated meta-information.

Processing expectations

May be formatted inline or as a displayed block, depending on context. It might not be rendered at all, depending on its placement within a mediaobject or inlinemediaobject and the constraints on the publishing system. For a more detailed description of the semantics involved, see mediaobject.

Parents

These elements contain videoobject: inlinemediaobject, mediaobject.

Children

The following elements occur in videoobject: info (db.titleforbidden.info), videodata.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example videoobject</title>

<mediaobject>
  <videoobject>
    <videodata fileref='movie.avi'/>
  </videoobject>
  <imageobject>
    <imagedata fileref='movie-frame.gif'/>
  </imageobject>
  <textobject>
    <para>This video illustrates the proper way to assemble an
    inverting time distortion device.
    </para>
    <warning>
      <para>It is imperative that the primary and secondary temporal
      couplings not be mounted in the wrong order. Temporal
      catastrophe is the likely result. The future you destroy
      may be your own.
      </para>
    </warning>
  </textobject>
</mediaobject>

</article>

DocBook V5.1 introduces new controls providing greater control over the features of the media player in environments like a web browser. 

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example videoobject</title>

<mediaobject>
  <videoobject>
    <videodata fileref='movie.avi' autoplay="true" classid="com.example.player">
      <multimediaparam name="crossfade" value="false"/>
    </videodata>
  </videoobject>
  <imageobject>
    <imagedata fileref='movie-frame.gif'/>
  </imageobject>
  <textobject>
    <para>This video illustrates the proper way to assemble an
    inverting time distortion device.
    </para>
    <warning>
      <para>It is imperative that the primary and secondary temporal
      couplings not be mounted in the wrong order. Temporal
      catastrophe is the likely result. The future you destroy
      may be your own.
      </para>
    </warning>
  </textobject>
</mediaobject>

</article>

DocBook V5.1 also introduces the possibility of having more than one videodata in a videoobject.

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example videoobject</title>

<mediaobject>
  <videoobject>
    <videodata fileref='movie.ogg' autoplay="true" classid="com.example.player">
      <multimediaparam name="type" value="video/ogg"/>
    </videodata>
    <videodata fileref='movie.mp4' autoplay="true" classid="com.example.player">
      <multimediaparam name="type" value="vidoe/mp4"/>
    </videodata>
    <videodata fileref='movie.webm' autoplay="true" classid="com.example.player">
      <multimediaparam name="type" value="video/webm"/>
    </videodata>
  </videoobject>
  <imageobject>
    <imagedata fileref='movie-frame.gif'/>
  </imageobject>
  <textobject>
    <para>This video illustrates the proper way to assemble an
    inverting time distortion device.
    </para>
    <warning>
      <para>It is imperative that the primary and secondary temporal
      couplings not be mounted in the wrong order. Temporal
      catastrophe is the likely result. The future you destroy
      may be your own.
      </para>
    </warning>
  </textobject>
</mediaobject>

</article>