HOME - SMIL: Version 1.0 vom 04.04.2000 © Wolfgang von Keitz


Vorwort
Grundlagen
Layout
Zeit
Bilder und Texte
SMIL und HTML

Referenz

Beispiele
Anhang
Quellen

6. Referenz der SMIL-Elemente

Mit der Referenz der SMIL-Elemente soll eine detaillierte Übersicht über die Elemente und ihre Attribute gegeben werden.

6.1. <smil>

Das <smil>-Element steht am Beginn und am Ende eines SMIL-Dokuments. Elemente der nächsten Stufe (Kinder) sind <head> und <body>. Das <smil>-Element ist obligatorisch.

<smil 	id="identifier">
</smil>

Das <smil>-Element kennt folgende Attribute:

    id - identifiziert eindeutig ein Element innerhalb eines SMIL-Dokuments.
6.2. <head>

Das <head>-Element enhält alle <layout> und <meta>-Elemente. Elemente der nächsten Stufe (Kinder) können sein: <meta>, <layout> und <switch>. Das <head>-Element ist optional.

<head	id="identifier">
</head>

Das <head>-Element kennt folgende Attribute:

    id - identifiziert eindeutig ein Element innerhalb eines SMIL-Dokuments.
6.2.1. <meta>

Das <meta>-Element enthält Informationen über die Präsentation.


<
meta id="identifier"
name=
"string" content="string"
skip-content=
"true|false" />

Das <meta>-Element kennt folgende Attribute:

    id – eindeutige Bezeichnung des SMIL-Dokuments.
    name – Benennung eines Parameters des SMIL-Dokuments.
      Parameter sind:
      base
      – Basis-URI bei relativer Adressierung.
      pics-label
      – Rating-Label des SMIL-Dokuments.
      title
      – Titel der Präsentation.
    content – Wert eines Parameters des SMIL-Dokuments.
    skip-content
    - zur Zeit nicht benutzt.
6.2.2. <layout>

Mit dem <layout>-Element wird das Bildschirmlayout definiert. Elemente nächster Stufe (Kinder) sind <root-layout> und <region>. Enthält ein Dokument kein <layout>-Element, ist die Positionierung der Multimediaobjekte installationsabhängig. Ein SMIL-Dokument kann als Teil von <switch> unterschiedliche Layouts enthalten.

<layout 	id="identifier"
 	type="string">
</layout>
<!-- Voreinstellung: -->
<layout 	type="text/smil-basic-layout" />
</layout>

Das <layout>-Element kennt folgende Attribute:

    id – eindeutige Bezeichnung des Layouts.
    type
    – spezifiziert, welche Layoutsprache benutzt wird. Die Voreinstellung ist: "text/smil-basic-layout".
6.2.2.1. <root-layout>

Mit dem <root-layout>-Element wird die Breite und Höhe eines Präsentationsfensters definiert; ferner wird der Präsentation ein Titel zugewiesen.

<root-layout id="identifier"
	width="integer"
	height="integer"
	title="string"
	background color="color in hex or predefined"
	skip-content="true|false" />

Das <root-layout>-Element kennt folgende Attribute:

    id - eindeutige Bezeichnung des Layouts.
    width
    - Breite in Pixel.
    height -
    Höhenangabe in Pixel.
    title
    - Benennung des Layout.
    background color
    - gibt die Hintergrundfarbe an; ist keine Hintergrundfarbe angegeben, ist der Hintergrund transparent.
    skip-content
    - zur Zeit nicht benutzt.
6.2.2.2. <region>

Mit dem <region>-Element wird ein Präsentationsbereich als Teil des Präsentationssfensters definiert.

<region	id="identifier"
	background color="color in hex or predefined"
	fit="hidden|fill|meet|scroll|slice"
	height="integer"
	left="integer"
	top="integer"
	width="integer"
	z-index="integer"
	title="string"
	skip-content="true|false" />

Das <region>-Element kann folgende Attribute besitzen:

    id - eindeutige Benennung der Region.
    background color
    : gibt die Hintergrundfarbe an; ist keine Hintergrundfarbe angegeben, ist der Hintergrund transparent.
    fit
    : legt automatisch die Höhe und Breite eines visuellen Objektes fest; der voreingestellte Wert ist "hidden"; mögliche Parameter sind:
      fill: automatische Anpassung des Objekts an die Größe der Region;
      hidden: ist das Objekt kleiner als die Region, wird die verbleibende Fläche mit der Hintergrundfarbe gefüllt; ist das Objekt größer als die Region, werden die überstehenden Teile abgeschnitten;
      meet: das Objekt wird ohne Verzerrung beginnend beim linken oberen Eck vergrößert; freibleibende Flächen werden mit Hintergrundfarbe gefüllt;
      scroll: ist das Objekt größer als die Region, werden Rollbalken eingefügt;
      slice: das Objekt wird ohne Verzerrung vergrößert, wobei die Region vollständig ausgefüllt wird; überstehende Teile werden abgeschnitten.
    height: Höhenangabe in Prozent oder Pixel.
    left:
    Abstand vom linken Rand in Prozent oder Pixel.
    top
    : Abstand vom oberen Rand in Prozent oder Pixel.
    width
    : Breite in Prozent oder Pixel.
    z-index
    : werden zwei oder mehr Präsentationsbereiche definiert, bestimmt der z-index, welcher Bereich im Vordergrund und welcher im Hintergrund gezeigt wird; der z-index ist durch ganzzahlige Werte definiert. Je kleiner der z-Wert ist, desto weiter rückt der Präsentationsbereich in den Hintergrund.
    title
    : Benennung der Region.
    skip-content
    : zur Zeit nicht benutzt.
6.3. <body>

Das <body>-Element konstituiert nach dem <head>-Element den zweiten Teil eines SMIL-Dokuments. Es definiert automatisch ein <seq>-Element als Synchronisationselement. Dies bedeutet, dass die nachfolgenden Elemente Zeile für Zeile abgearbeitet werden. Während das <head>-Element überwiegend der Festlegung des Layouts dient, enthält das <body>-Element die Medienobjekte, die in der Präsentation verwendet werden sollen. Elemente nächster Stufe sind <switch>, <a>, <par>, <seq>, <animation>, <audio>, <img>, <text>, <textstream>, <video>. Das <body>-Element ist obligatorisch.

<body id="identifier">
[...]
</body>

Das <body>-Element kennt folgende Attribute:

    id - eindeutige Benennung des Textkörpers
6.3.1. Synchronisationselemente
6.3.1.1. <par>

Das par-<Element> definiert eine Folge von Elementen, die parallel abgearbeitet werden. Elemente nächster Stufe sind <switch>, <a>, <par>, <seq>, <animation>, <audio>, <img>, <text>, <textstream>, <video>.

<par	id="identifier"
	title="string"
	abstract="string"
	author="string"
	copyright="string"
	begin="clock-value"
	end="clock-value"
	dur="clock-value"
	end-sync="identifier|last|first"
	repeat="integer"
	system-bitrate="integer"
	system-captions="on|off"
	system-language="coma-separated-list"
	system-overdub-or-captions="captions|overdub"
	system-required="string"
	system-screen-depth="integer"
	system-screen-size="integerXinteger" />

Das< par>-Element kennt die folgenden Attribute:

    id - eindeutige Benennung der Elementfolge
    title
    - Titel des Inhalts der Elementfolge
    abstract
    - Zusammenfassung des Inhalts der Elementfolge
    author
    - Autor des Inhalts der Elementfolge
    copyright
    - Rechte bzgl. der Medienobjekte der Elementfolge
    begin
    - Zeitangabe nach dem SMIL-Zeitschema
    end
    - Zeitangabe nach dem SMIL-Zeitschema
    dur
    - Zeitangabe nach dem SMIL-Zeitschema
    end-sync
    -
    repeat
    - Wiederholungsangabe
    system-bitrate
    - Übertragungsgeschwindigkeit
    system-captions
    - Untertitel
    system-language
    - Sprache
    system-overdup-or-captions
    - Synchronisation oder Untertitel
    system-required
    - Extension
    system-screen-depth
    - Farbpalette
    system-screen-size
    - Bildschirmgrösse in Pixeln
6.3.1.2. <seq>

Das <seq>-Element definiert eine Folge von Elementen, die sequentiell abgearbeitet werden. Elemente nächster Stufe sind <switch>, <a>, <par>, <seq>, <animation>, <audio>, <img>, <text>, <textstream>, <video>.

<seq	id="identifier"
	title="string"
	abstract="string"
	author="string"
	copyright="string"
	begin="clock-value"
	end="clock-value"
	dur="clock-value"
	repeat="integer"
	system-bitrate="integer"
	system-captions="on|off"
	system-language="coma-separated-list"
	system-overdub-or-captions="captions|overdub"
	system-required="string"
	system-screen-depth="integer"
	system-screen-size="integerXinteger" />

Das <seq>-Element kennt die folgenden Attribute:

    id - eindeutige Benennung der Elementfolge
    title
    - Titel des Inhalts der Elementfolge
    abstract
    - Zusammenfassung des Inhalts der Elementfolge
    author
    - Autor des Inhalts der Elementfolge
    copyright
    - Rechte bzgl. der Medienobjekte der Elementfolge
    begin
    - Zeitangabe nach dem SMIL-Zeitschema
    end
    - Zeitangabe nach dem SMIL-Zeitschema
    dur
    - Zeitangabe nach dem SMIL-Zeitschema
    end-sync
    -
    repeat
    - Wiederholungsangabe
    system-bitrate
    - Übertragungsgeschwindigkeit
    system-captions
    - Untertitel
    system-language
    - Sprache
    system-overdup-or-captions
    - Synchronisation oder Untertitel
    system-required
    - Extension
    system-screen-depth
    - Farbpalette
    system-screen-size
    - Bildschirmgrösse in Pixeln
6.3.2. Boole΄sche Abfragen mit <switch>

Das <switch>-Element definiert eine Folge alternativer Elemente, deren Testattribute nacheinander analysiert werden. Das erste Element, dessen Testattribute als wahr erkannt werden, wird ausgeführt. Elemente nächste Stufe können sein: Im <head>-Teil des SMIL-Dokuments <layout> und im <body>-Teil <a>, <par>, <seq>, jedes Media-Element ohne oder mit Clip-Attribute.

<switch	id="identifier"
	title="string">
	
 	<!—1. Element -->
	<!—2. Element -->
	<!—3. Element-->
	<!-- etc -->
</switch>

Das <switch>-Element kennt folgende Attribute:

    id - eindeutige Benennung der Elementfolge
    title
    - Titel des Inhalts der Elementfolge

Testattribute sind folgende, den Synchronisationselementen zugeordnete Attribute:

    system-bitrate: Übertragungsgeschwindigkeit in bps
    system-captions:
    on, Untertitel werden übertragen; off, Untertitel werden nicht übertragen
    system-language:
    Sprachkürzel; mehrere Sprachangaben können durch Kommata getrennt angegeben werden
    system-overdup-or-captions:
    caption, Untertitel werden gesendet; overdup, Sprachsynchronisation wird gesendet
    system-required:
    zur Zeit nicht besetzt
    system-screen-depth:
    Zahl der Farben der Farbpalette in bits
    system-screen-size
    : Bildschirmgrößenangabe nach dem Schema screen-size-val ::= screen-height"X"screen-width
6.3.3. Link-Elemente

Mit Link-Elementen werden Navigationsverbindungen zwischen Objekten oder Dokumenten hergestellt.

6.3.3.1. Das <a>-Element

Das <a>-Element hat in SMIL nahezu dieselbe Bedeutung wie in HTML. Mit dem <a>-Element wird eine URL spezifiziert, die durch Klicken ausgewählt werden kann. Um ein neues Fenster zu öffnen, kann der show-Parameter mit show="the_target_frame" benutzt werden. Elemente nächste Stufe können sein: <par>, <seq>, jedes Media-Element ohne oder mit Clip-Attributen.

<a	id="identifier"
	show="replace|new|pause"
	href="URL">

</a>

Das <a>-Element kennt folgende Attribute:

    id - eindeutige Benennung des Links
    show
    - Dieses Attribut steuert die Präsentation des Ausgangs- und des Zieldokuments. Folgende Attributwerte sind definiert:
      replace - die laufende Präsentation wird auf Halt gesetzt und durch eine neue Präsentation ersetzt; Voreinstellung ist replace.
      new
      - die Präsentation wird in einem neuen Fenster gestartet;
      pause
      - die laufende Präsentation wird auf Halt gesetzt, und die neue Präsentation wird in einem neuen Fenster gestartet.
    href - URL des Dokuments, auf den der Link verweist
6.3.3.2. Das <anchor>-Element

Das <anchor>-Element erzeugt einen Link zu einem einzigen Multimediaobjekt. Die image-map-Funktion in HTML hat gezeigt, dass es erforderlich sein kann, Teile von Objekten als Linkflächen zu definieren. Diese Funktionalität wird in SMIL durch das <anchor>-Element ermöglicht:

  • mit dem <anchor>-Element kann ein Link mit Hilfe des href-Attributs auf einen flächenmäßig und/oder zeitlich begrenzten Teil eines Mediaobjekts definiert werden;
  • mit dem id-Attribut lassen sich Teilflächen eines Multimediaobjekts als Linkflächen benennen;
  • mit dem coords-Attributs lassen sich Teilflächen eines Multimediaobjekts räumlich definieren;
  • mit dem begin- und end-Attribut kann die Präsentation eines Multimediaobjekts in zeitliche Teilabschnitte zerlegt werden; die Zeitschiene des begin- und end-Attributs des <anchor>-Elements ist relativ zum Beginn der Präsentation des Multimediaobjekts zu sehen.
<anchor	id="identifier"
	show="replace|new|pause"
	href="URL"
	skip-content="true|false"
	coords="x1,y1,x2,y2"
	begin="clock-value"
	end="clock-value" />

Das <anchor>-Element kennt folgende Attribute:

    id: eindeutige Benennung des Links show - Dieses Attribut steuert das Verhalten des Quelldokuments. Folgende Attributwerte sind definiert:
      replace - die laufende Präsentation wird auf Halt gesetzt und durch eine neue Präsentation ersetzt; Voreinstellung ist "replace".
      new
      - die Präsentation wird in einem neuen Fenster gestartet;
      pause
      - die laufende Präsentation wird auf Halt gesetzt, und die neue Präsentation wird in einem neuen Fenster gestartet.
    href - URL des Dokuments, auf den der Link verweist.
    skip-content
    - Zur Zeit nicht besetzt
    coords
    - die Werte dieses Attributs spezifizieren ein Rechteck in der Präsentationsfläche eine visuellen Multimediaobjekts; die ersten beiden Werte definieren die obere linke Ecke des Rechtecks, die nächsten beiden Werte definieren die rechte untere Ecke des Rechtecks.
    begin:
    Zeitangabe nach dem SMIL-Zeitschema, um den Beginn der Gültigkeit des Links festzulegen.
    end:
    Zeitangabe nach dem SMIL-Zeitschema, um das Ende der Gültigkeit des Links festzulegen.
6.3.4. Media-Elemente<animation>, <img>, <ref>, <text> und <textstream>

Mit Media-Elementen werden Multimediaobjekte in einem bestimmten Bereich eines Präsentationsfensters präsentiert. Das <a>-Element und das <anchor>-Element sind die einzigen Elemente der nächsten Stufe.

Die Media-Elemente <animation>, <img>, <ref>, <text> und <textstream> besitzen keine Clip-Attribute, da sie über keine innere Zeitleiste verfügen.

<img	id="identifier"
	src="URL"
	alt="string"
	 region="identifier"
	title="string"
	abstract="string"
	author="string"
	copyright="string"
	longdesc="string"
	type="string"
	begin="clock-value"
	end="clock-value"
	dur="clock-value"
	repeat="integer"
	fill="remove|freeze"
	system-bitrate="integer"
	system-captions="on|off"
	system-language="coma-separated-list"
	system-overdub-or-caption="caption|overdub"
	system-required="string"
	system-screen-depth="integer"
	system-screen-size="integerXinteger" />

Media-Elemente ohne Clip-Attribute kennen folgende Attribute:

    id - eindeutige Benennung der Elementfolge
    src
    - URL
    alt:
    alternative Textangabe, wenn der Clip nicht präsentiert werden kann
    region:
    definierter Bereich des Präsentationsfensters
    title:
    Titel des Inhalts der Elementfolge
    abstract
    : kurze Inhaltsangabe
    author:
    Autor des Inhalts der Elementfolge
    copyright:
    Rechte bezgl. des Inhalts der Elementfolge
    longdesc:
    längere Inhaltsangabe
    type:
    MIME-Typ
    begin:
    Zeitangabe nach dem SMIL-Zeitschema
    end:
    Zeitangabe nach dem SMIL-Zeitschema
    dur:
    Zeitangabe nach dem SMIL-Zeitschema
    fill:
    remove, letztes Clipbild wird nach dem Ende der Präsentation entfernt; freeze, letztes Clipbild bleibt nach dem Ende der Präsentation erhalten
    system-bitrate:
    Übertragungsgeschwindigkeit
    system-captions:
    Untertitel
    system-language:
    Sprache
    system-overdup-or-captions:
    Sprachsynchronisation oder Untertitel
    system-required:
    zur Zeit nicht besetzt
    system-screen-depth:
    Farbtiefe
    system-screen-size:
    Bildschirmgröße
6.3.5. Media-Elemente <video> und <audio>

Mit Media-Elementen werden Multimediaobjekte in einem bestimmten Bereich eines Präsentationsfensters präsentiert. Das <a>-Element und das <anchor>-Element sind die einzigen Elemente der nächsten Stufe. Die Media-Elemente <video> und <audio> besitzen Clip-Attribute für die Kontrolle des Clips auf der Grundlage der inneren Zeitleiste.

<video	id="identifier"
	src="URL"
	alt="string"
	 region="identifier"
	title="string"
	abstract="string"
	author="string"
	copyright="string"
	longdesc="string"
	type="string"
	begin="clock-value"
	end="clock-value"
	dur="clock-value"
	clip-begin="clock-value"
	clip-end="clock-value"
	repeat="integer"
	fill="remove|freeze"
	system-bitrate="integer"
	system-captions="on|off"
	system-language="coma-separated-list"
	system-overdub-or-caption="caption|overdub"
	system-required="string"
	system-screen-depth="integer"
	system-screen-size="integerXinteger" />

Media-Elemente mit Clip-Attributen kennen folgende Attribute:

    id - eindeutige Benennung der Elementfolge
    src:
    URL
    alt:
    alternative Textangabe, wenn der Clip nicht präsentiert werden kann
    region:
    definierter Bereich des Präsentationsfensters
    title:
    Titel des Inhalts der Elementfolge
    abstract
    : kurze Inhaltsangabe
    author:
    Autor des Inhalts der Elementfolge
    copyright:
    Rechte bezgl. des Inhalts der Elementfolge
    longdesc:
    längere Inhaltsangabe
    type:
    MIME-Typ
    begin:
    Zeitangabe nach dem SMIL-Zeitschema, startet die Objektpräsentation
    end:
    Zeitangabe nach dem SMIL-Zeitschema, beendet die Objektpräsentation
    dur:
    Zeitangabe nach dem SMIL-Zeitschema, Dauer der Objektpräsentation
    clip-begin
    : Zeitangabe nach dem SMIL-Zeitschema oder nach frame-Angaben, startet den Clip bezogen auf den Beginn der Objektpräsentation
    clip-end:
    Zeitangabe nach dem SMIL-Zeitschema oder nach frame-Angaben, beendet den Clip bezogen auf den Beginn der Objektpräsentation
    fill:
    remove, letztes Clipbild wird nach dem Ende der Präsentation entfernt; freeze, letztes Clipbild bleibt nach dem Ende der Präsentation erhalten
    system-bitrate:
    Übertragungsgeschwindigkeit
    system-captions:
    Untertitel
    system-language:
    Sprache
    system-overdup-or-captions:
    Sprachsynchronisation oder Untertitel
    system-required:
    zur Zeit nicht besetzt
    system-screen-depth:
    Farbtiefe
    system-screen-size:
    Bildschirmgröße