├── schema-validator
    ├── src
    │   ├── __init__.py
    │   └── validate.py
    ├── test
    │   ├── __init__.py
    │   ├── test_validate.py
    │   └── fixtures
    │   │   └── valid_dapt.ttml
    ├── pyproject.toml
    ├── README.md
    ├── uv.lock
    └── poetry.lock
├── .pr-preview.json
├── figures
    ├── direction.png
    ├── fingerprint.png
    ├── sources
    │   ├── audio-mixing.puml
    │   ├── webaudio-nodes.puml
    │   └── class-diagram.puml
    ├── audio-mixing.svg
    └── webaudio-nodes.svg
├── examples
    ├── audio-single-external-source.xml
    ├── bidi-in-p.xml
    ├── metadata-ttml2.xml
    ├── intro-script-with-audio-clipped.xml
    ├── audio-single-embedded-inline-source.xml
    ├── audio-multiple-external-source.xml
    ├── intro-times-only.xml
    ├── intro-script-with-speak.xml
    ├── event-desc-descType.xml
    ├── audio-single-embedded-referenced-source.xml
    ├── metadata-proprietary.xml
    ├── intro-script-with-embedded-audio.xml
    ├── audio-multiple-embedded-referenced-source.xml
    ├── intro-script-with-gain.xml
    ├── sourceMediaIdentifier.xml
    ├── non-dapt-div-with-begin-and-lang.xml
    ├── event-desc.xml
    ├── intro-times-and-text.xml
    ├── intro-original-language.xml
    ├── event-desc-multiple-descType.xml
    ├── non-dapt-divs.xml
    ├── intro-times-and-text-with-visual-text.xml
    ├── intro-original-language-with-dub-language.xml
    ├── intro-original-language-with-dub-language-and-adaptation.xml
    └── intro-top-level.xml
├── w3c.json
├── .gitmodules
├── LICENSE.md
├── CODE_OF_CONDUCT.md
├── xml-schemas
    ├── ttml2-parameters.xsd
    ├── ttml2-metadata-attribs.xsd
    ├── ttml2-audio-attribs.xsd
    ├── ttml2-timing-attribs.xsd
    ├── dapt-datatypes.xsd
    ├── ttml2-core-attribs.xsd
    ├── ttml2-metadata.xsd
    ├── ttml2-head.xsd
    ├── ttml2-layout.xsd
    ├── dapt-metadata.xsd
    ├── README.md
    ├── ttml2-animation.xsd
    ├── ttml2-styling.xsd
    ├── ttml2-parameter-attribs.xsd
    ├── dapt.xsd
    ├── ttml2-parameter-items.xsd
    ├── ttml2-metadata-items.xsd
    ├── ttml2-styling-attribs.xsd
    ├── ttml2-embedded.xsd
    ├── ttml2-content.xsd
    ├── xml.xsd
    ├── xlink.xsd
    └── ttml2-datatypes.xsd
├── .github
    └── workflows
    │   └── auto-publish.yml
├── CONTRIBUTING.md
├── registries
    ├── descType.json
    ├── README.md
    └── content-descriptor.json
├── README.md
├── substantive-changes-summary.txt
└── profiles
    ├── dapt-processor-profile.xml
    └── dapt-content-profile.xml


/schema-validator/src/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/schema-validator/test/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/.pr-preview.json:
--------------------------------------------------------------------------------
1 | {
2 |     "src_file": "index.html",
3 |     "type": "respec"
4 | }


--------------------------------------------------------------------------------
/figures/direction.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/w3c/dapt/HEAD/figures/direction.png


--------------------------------------------------------------------------------
/figures/fingerprint.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/w3c/dapt/HEAD/figures/fingerprint.png


--------------------------------------------------------------------------------
/examples/audio-single-external-source.xml:
--------------------------------------------------------------------------------
1 | <audio src="https://example.com/audio.wav" type="audio/wave"/>
2 | 


--------------------------------------------------------------------------------
/w3c.json:
--------------------------------------------------------------------------------
1 | {
2 |     "group": [ "34314" ]
3 |    ,"contacts": [ "himorin" ]
4 |    , "repo-type": "rec-track"
5 | }
6 | 


--------------------------------------------------------------------------------
/.gitmodules:
--------------------------------------------------------------------------------
1 | [submodule "xml-schemas/ebu-tt-m-xsd"]
2 | 	path = xml-schemas/ebu-tt-m-xsd
3 | 	url = https://github.com/ebu/ebu-tt-m-xsd.git
4 | 


--------------------------------------------------------------------------------
/examples/bidi-in-p.xml:
--------------------------------------------------------------------------------
1 | <p>
2 | The title of the book is
3 | "<span tts:unicodeBidi="embed" tts:direction="rtl">نشاط التدويل، W3C</span>"
4 | </p>
5 | 


--------------------------------------------------------------------------------
/examples/metadata-ttml2.xml:
--------------------------------------------------------------------------------
1 | ...
2 |   <head>
3 |     <metadata>
4 |       <ttm:title>A example document title</ttm:title>
5 |     </metadata>
6 |   </head>
7 | ...


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
1 | All documents in this Repository are licensed by contributors
2 | under the 
3 | [W3C Document License](https://www.w3.org/Consortium/Legal/copyright-documents).
4 | 
5 | 


--------------------------------------------------------------------------------
/examples/intro-script-with-audio-clipped.xml:
--------------------------------------------------------------------------------
1 | ...
2 |   <span><audio src="long_audio.wav" clipBegin="5s" clipEnd="8s"/>
3 |   A woman climbs into a small sailing boat.</span>
4 | ...
5 | 


--------------------------------------------------------------------------------
/examples/audio-single-embedded-inline-source.xml:
--------------------------------------------------------------------------------
1 | <audio>
2 |   <source>
3 |     <data type="audio/wave">
4 |         [base64-encoded WAV audio resource]
5 |     </data>
6 |   </source>
7 | </audio>
8 | 


--------------------------------------------------------------------------------
/examples/audio-multiple-external-source.xml:
--------------------------------------------------------------------------------
1 | <audio>
2 |   <source src="https://example.com/audio.wav" type="audio/wave"/>
3 |   <source src="https://example.com/audio.aac" type="audio/aac"/>
4 | </audio>
5 | 


--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
1 | # Code of Conduct
2 | 
3 | All documentation, code and communication under this repository are covered by the [W3C Code of Ethics and Professional Conduct](https://www.w3.org/Consortium/cepc/).
4 | 


--------------------------------------------------------------------------------
/examples/intro-times-only.xml:
--------------------------------------------------------------------------------
1 | ...
2 |   <body daptm:represents="...">
3 |     <div xml:id="id1" begin="10s" end="13s">
4 |     </div>
5 |     <div xml:id="id2" begin="18s" end="20s">
6 |     </div>
7 |   </body>
8 | ...


--------------------------------------------------------------------------------
/examples/intro-script-with-speak.xml:
--------------------------------------------------------------------------------
1 | ...
2 |     <div begin="18s" end="20s" xml:id="a2">
3 |       <p>
4 |         <span tta:speak="normal">
5 |           The woman pulls the tiller and the boat turns.</span>
6 |       </p>
7 |     </div>
8 | ...
9 | 


--------------------------------------------------------------------------------
/examples/event-desc-descType.xml:
--------------------------------------------------------------------------------
1 | ...
2 |   <body>
3 |     <div begin="10s" end="13s" xml:id="a123">
4 |       <ttm:desc daptm:descType="pronunciationNote">[oːnʲ]</ttm:desc>
5 |       <p>Eóin looks around at the other assembly members.</p>
6 |     </div>
7 |   </body>
8 | ...


--------------------------------------------------------------------------------
/examples/audio-single-embedded-referenced-source.xml:
--------------------------------------------------------------------------------
 1 | <tt>
 2 |   <head>
 3 |     <resources>
 4 |       <audio type="audio/wave" xml:id="audio1">
 5 |         <source><data>[base64-encoded WAV audio resource]</data></source>
 6 |       </audio>
 7 |     </resources>
 8 |   </head>
 9 |   <body>
10 |     ..
11 |     <audio src="#audio1"/>
12 |     ..
13 |   </body>
14 | </tt>
15 | 


--------------------------------------------------------------------------------
/examples/metadata-proprietary.xml:
--------------------------------------------------------------------------------
 1 | ...
 2 |   <metadata xmlns:vendorm="http://www.example-vendor.com/ns/ttml#metadata">
 3 |     <vendorm:programType>Episode</vendorm:programType>
 4 |     <vendorm:episodeSeason>5</vendorm:episodeSeason>
 5 |     <vendorm:episodeNumber>8</vendorm:episodeNumber>
 6 |     <vendorm:internalId>15734</vendorm:internalId>
 7 |     <vendorm:information>Some proprietary information</vendorm:information>
 8 |   </metadata>
 9 | ...
10 | 


--------------------------------------------------------------------------------
/examples/intro-script-with-embedded-audio.xml:
--------------------------------------------------------------------------------
 1 | ...
 2 |     <div begin="25s" end="28s" xml:id="a3">
 3 |       <p>
 4 |         <animate begin="0.0s" end="0.3s" tta:gain="1;0.39" fill="freeze"/>
 5 |         <animate begin="2.7s" end="3s" tta:gain="0.39;1"/>
 6 |         <span begin="0.3s" end="2.7s">
 7 |           <audio><source><data type="audio/wave">
 8 |             [base64-encoded audio data]
 9 |           </data></source></audio>
10 |           The sails billow in the wind.</span>
11 |       </p>
12 |     </div>
13 | ...
14 | 


--------------------------------------------------------------------------------
/examples/audio-multiple-embedded-referenced-source.xml:
--------------------------------------------------------------------------------
 1 | <tt>
 2 |   <head>
 3 |     <resources>
 4 |       <data type="audio/wave" xml:id="audio1wav">
 5 |         [base64-encoded WAV audio resource]
 6 |       </data>
 7 |       <data type="audio/mpeg" xml:id="audio1mp3">
 8 |         [base64-encoded MP3 audio resource]
 9 |       </data>
10 |     </resources>
11 |   </head>
12 |   <body>
13 |     ..
14 |     <audio>
15 |       <source src="#audio1wav"/>
16 |       <source src="#audio1mp3"/>
17 |     </audio>
18 |     ..
19 |   </body>
20 | </tt>
21 | 


--------------------------------------------------------------------------------
/examples/intro-script-with-gain.xml:
--------------------------------------------------------------------------------
 1 | <tt ...
 2 |   daptm:scriptRepresents="visual.nonText"
 3 |   daptm:scriptType="asRecorded"
 4 |   xml:lang="en"
 5 |   daptm:langSrc="zxx">
 6 |   ...
 7 |     <div begin="25s" end="28s" xml:id="a3" daptm:represents="visual.nonText">
 8 |       <p>
 9 |         <animate begin="0.0s" end="0.3s" tta:gain="1;0.39" fill="freeze"/>
10 |         <animate begin="2.7s" end="3s" tta:gain="0.39;1"/>
11 |         <span begin="0.3s" end="2.7s">
12 |           <audio src="clip3.wav"/>
13 |           The sails billow in the wind.</span>
14 |       </p>
15 |     </div>
16 | ...
17 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-parameters.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter">
 6 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
 7 |   <xs:import namespace="http://www.w3.org/ns/ttml#parameter"
 8 |     schemaLocation="ttml2-parameter-items.xsd"/>
 9 |   <xs:group name="Parameters.class">
10 |     <xs:choice>
11 |       <xs:group ref="ttp:ParameterItems.class"/>
12 |     </xs:choice>
13 |   </xs:group>
14 | </xs:schema>
15 | 


--------------------------------------------------------------------------------
/examples/sourceMediaIdentifier.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml" 
 2 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 3 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 4 |     xmlns:ebuttm="urn:ebu:tt:metadata"
 5 |     xml:lang="en" 
 6 |     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 7 |     daptm:scriptRepresents="audio.dialogue"
 8 |     daptm:scriptType="originalTranscript">
 9 |   <head>
10 |     <metadata>
11 |       <ebuttm:sourceMediaIdentifier>https://example.org/programme.mov</ebuttm:sourceMediaIdentifier>
12 |     </metadata>
13 |   </head>
14 |   <body>
15 |     ...
16 |   </body>
17 | </tt>
18 | 


--------------------------------------------------------------------------------
/examples/non-dapt-div-with-begin-and-lang.xml:
--------------------------------------------------------------------------------
 1 | <tt ... xml:lang="en">
 2 |     <body>
 3 |         <div xml:id="d1" begin="00:01:00" end="00:01:10">
 4 |             <!-- Script Event beginning at 1 minute, duration 10 seconds -->
 5 |             <p> <!-- This is a Text, language "en" --> </p>
 6 |         </div>
 7 |         <div begin="00:10:00" xml:lang="fr"> <!-- div that is not a Script Event -->
 8 |             <div xml:id="d2" begin="00:01:00" end="00:01:10">
 9 |                 <!-- Script Event beginning at 11 minutes, duration 10 seconds -->
10 |                 <p> <!-- This is a Text, language "fr" --> </p>
11 |             </div>
12 |         </div>
13 |     </body>
14 | </tt>
15 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-metadata-attribs.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#metadata"
 3 |   xml:lang="en" xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
 5 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata">
 6 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
 7 |     schemaLocation="ttml2-datatypes.xsd"/>
 8 |   <xs:attribute name="agent" type="ttd:agent"/>
 9 |   <xs:attribute name="role" type="ttd:role"/>
10 |   <xs:attributeGroup name="Metadata.attrib.class">
11 |     <xs:attribute ref="ttm:agent"/>
12 |     <xs:attribute ref="ttm:role"/>
13 |   </xs:attributeGroup>
14 | </xs:schema>
15 | 


--------------------------------------------------------------------------------
/examples/event-desc.xml:
--------------------------------------------------------------------------------
 1 | ...
 2 |   <body daptm:langSrc="zxx">
 3 |     <div begin="10s" end="13s" xml:id="a1">
 4 |       <ttm:desc>Scene 1</ttm:desc>
 5 |       <p xml:lang="en">
 6 |         <span>A woman climbs into a small sailing boat.</span>
 7 |       </p>
 8 |       <p xml:lang="fr" daptm:langSrc="en">
 9 |         <span>Une femme monte à bord d'un petit bateau à voile.</span>
10 |       </p>
11 |     </div>
12 |     <div begin="18s" end="20s" xml:id="a2">
13 |       <ttm:desc>Scene 1</ttm:desc>
14 |       <p xml:lang="en">
15 |         <span>The woman pulls the tiller and the boat turns.</span>
16 |       </p>
17 |       <p xml:lang="fr" daptm:langSrc="en">
18 |         <span>La femme tire sur la barre et le bateau tourne.</span>
19 |       </p>
20 |     </div>
21 |   </body>
22 | ...
23 | 


--------------------------------------------------------------------------------
/examples/intro-times-and-text.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml"
 2 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 3 |   xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 4 |   xmlns:xml="http://www.w3.org/XML/1998/namespace"
 5 |   ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 6 |   xml:lang="en"
 7 |   daptm:langSrc="zxx"
 8 |   daptm:scriptRepresents="visual.nonText"
 9 |   daptm:scriptType="preRecording">
10 |   <body>
11 |     <div begin="10s" end="13s" xml:id="a1" daptm:represents="visual.nonText">
12 |       <p>
13 |         A woman climbs into a small sailing boat.
14 |       </p>
15 |     </div>
16 |     <div begin="18s" end="20s" xml:id="a2" daptm:represents="visual.nonText">
17 |       <p>
18 |         The woman pulls the tiller and the boat turns.
19 |       </p>
20 |     </div>
21 |   </body>
22 | </tt>


--------------------------------------------------------------------------------
/examples/intro-original-language.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml" 
 2 |     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 3 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 4 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 5 |     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 6 |     xml:lang="fr"
 7 |     daptm:langSrc="fr"
 8 |     daptm:scriptRepresents="audio.dialogue"
 9 |     daptm:scriptType="originalTranscript">
10 |   <head>
11 |     <metadata>
12 |       <ttm:agent type="character" xml:id="character_1">
13 |         <ttm:name type="alias">ASSANE</ttm:name>
14 |       </ttm:agent>
15 |     </metadata>
16 |   </head>
17 |   <body>
18 |     <div begin="10s" end="13s" xml:id="d1" daptm:represents="audio.dialogue">
19 |       <p ttm:agent="character_1">
20 |         <span>Et c'est grâce à ça qu'on va devenir riches.</span>
21 |       </p>
22 |     </div>
23 |   </body>
24 | </tt>
25 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-audio-attribs.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#audio"
 3 |   xml:lang="en" xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
 5 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 6 |   xmlns:tta="http://www.w3.org/ns/ttml#audio">
 7 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
 8 |     schemaLocation="ttml2-datatypes.xsd"/>
 9 |   <xs:attribute name="gain" type="ttd:gain"/>
10 |   <xs:attribute name="pan" type="ttd:pan"/>
11 |   <xs:attribute name="pitch" type="ttd:pitch"/>
12 |   <xs:attribute name="speak" type="ttd:speak"/>        
13 |   <xs:attributeGroup name="Styling.Audio.attrib.class">
14 |     <xs:attribute ref="tta:gain"/>
15 |     <xs:attribute ref="tta:pan"/>
16 |     <xs:attribute ref="tta:pitch"/>
17 |     <xs:attribute ref="tta:speak"/>
18 |   </xs:attributeGroup>
19 | </xs:schema>
20 | 


--------------------------------------------------------------------------------
/.github/workflows/auto-publish.yml:
--------------------------------------------------------------------------------
 1 | name: Build, and publish spec to GitHub Pages and /TR/
 2 | 
 3 | on:
 4 |   pull_request: {}
 5 |   push:
 6 |     branches: [main]
 7 |     paths:
 8 |       - 'index.html'
 9 |       - 'examples/**.xml'
10 |       - 'figures/**.svg'
11 |       - 'profiles/**.xml'
12 |       - 'registries/**.json'
13 |       - 'substantive-changes-summary.txt'
14 | 
15 | jobs:
16 |   main:
17 |     name: Build, Validate and Deploy
18 |     runs-on: ubuntu-latest
19 |     steps:
20 |       - uses: actions/checkout@v3
21 |       - uses: w3c/spec-prod@v2
22 |         with:
23 |           TOOLCHAIN: respec
24 |           SOURCE: index.html
25 |           W3C_ECHIDNA_TOKEN: ${{ secrets.W3C_TR_TOKEN }}
26 |           W3C_WG_DECISION_URL: https://www.w3.org/2023/04/13-tt-minutes.html#x059
27 |           W3C_BUILD_OVERRIDE: |
28 |             specStatus: CRD
29 | 
30 | # not set 'warning' to BUILD_FAIL_ON (not to cause error by bikeshed warning?)
31 | 
32 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-timing-attribs.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
 5 |   xmlns:tt="http://www.w3.org/ns/ttml">
 6 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
 7 |     schemaLocation="ttml2-datatypes.xsd"/>
 8 |   <xs:attributeGroup name="TimingInterval.attrib.class">
 9 |     <xs:attribute name="begin" type="ttd:timeCoordinate"/>
10 |     <xs:attribute name="dur" type="ttd:timeDuration"/>
11 |     <xs:attribute name="end" type="ttd:timeCoordinate"/>
12 |   </xs:attributeGroup>
13 |   <xs:attributeGroup name="Timed.attrib.class">
14 |     <xs:attributeGroup ref="tt:TimingInterval.attrib.class"/>
15 |   </xs:attributeGroup>
16 |   <xs:attributeGroup name="TimedContainer.attrib.class">
17 |     <xs:attributeGroup ref="tt:Timed.attrib.class"/>
18 |   </xs:attributeGroup>
19 | </xs:schema>
20 | 


--------------------------------------------------------------------------------
/examples/event-desc-multiple-descType.xml:
--------------------------------------------------------------------------------
 1 | ...
 2 |   <body daptm:langSrc="zxx">
 3 |     <div begin="10s" end="13s" xml:id="a1">
 4 |       <ttm:desc daptm:descType="scene">Scene 1</ttm:desc>
 5 |       <ttm:desc daptm:descType="plotSignificance">High</ttm:desc>
 6 |       <p xml:lang="en">
 7 |         <span>A woman climbs into a small sailing boat.</span>
 8 |       </p>
 9 |       <p xml:lang="fr" daptm:langSrc="en">
10 |         <span>Une femme monte à bord d'un petit bateau à voile.</span>
11 |       </p>
12 |     </div>
13 |     <div begin="18s" end="20s" xml:id="a2">
14 |       <ttm:desc daptm:descType="scene">Scene 1</ttm:desc>
15 |       <ttm:desc daptm:descType="plotSignificance">Low</ttm:desc>
16 |       <p xml:lang="en">
17 |         <span>The woman pulls the tiller and the boat turns.</span>
18 |       </p>
19 |       <p xml:lang="fr" daptm:langSrc="en">
20 |         <span>La femme tire sur la barre et le bateau tourne.</span>
21 |       </p>
22 |     </div>
23 |   </body>
24 | ...
25 | 


--------------------------------------------------------------------------------
/examples/non-dapt-divs.xml:
--------------------------------------------------------------------------------
 1 | <body>
 2 |     <div xml:id="d1"> <!-- This is a Script Event -->
 3 |         <p> <!-- This is a Text --> </p>
 4 |     </div>
 5 |     <div> <!-- This cannot be a Script Event because it has no xml:id -->
 6 |         <p> <!-- Would be a Text if its parent were a Script Event --> </p>
 7 |     </div>
 8 |     <div xml:id="d2_1"> <!-- div parent of another div -->
 9 |         <div xml:id="d2"> <!-- Possibly a Script Event --></div>
10 |     </div>
11 |     <div xml:id="d3_1"> <!-- double layer of nesting -->
12 |         <div xml:id="d3_1_1">
13 |             <div xml:id="d3" begin="..." end="..." xml:lang="ja" foo:bar="baz">
14 |                 <!-- A Script Event with possibly unexpected attributes -->
15 |             </div>
16 |         </div>
17 |     </div>
18 |     <div xml:id="d4_1"> <!-- mixed div and p children -->
19 |         <div xml:id="d4_2"> <!-- This possible Script Event has a sibling <p> --> </div>
20 |         <p> <!-- Possible Text, but not if its parent is not a Script Event --> </p>
21 |     </div>
22 | </body>
23 | 


--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
 1 | # Timed Text Working Group
 2 | 
 3 | Contributions to this repository are intended to become part of Recommendation-track documents governed by the
 4 | [W3C Patent Policy](https://www.w3.org/Consortium/Patent-Policy-20040205/) and
 5 | [Document License](https://www.w3.org/Consortium/Legal/copyright-documents). To make substantive contributions to specifications, you must either participate
 6 | in the relevant W3C Working Group or make a non-member patent licensing commitment.
 7 | 
 8 | If you are not the sole contributor to a contribution (pull request), please identify all 
 9 | contributors in the pull request comment.
10 | 
11 | To add a contributor (other than yourself, that's automatic), mark them one per line as follows:
12 | 
13 | ```
14 | +@github_username
15 | ```
16 | 
17 | If you added a contributor by mistake, you can remove them in a comment with:
18 | 
19 | ```
20 | -@github_username
21 | ```
22 | 
23 | If you are making a pull request on behalf of someone else but you had no part in designing the 
24 | feature, you can remove yourself with the above syntax.
25 | 


--------------------------------------------------------------------------------
/schema-validator/pyproject.toml:
--------------------------------------------------------------------------------
 1 | [project]
 2 | name = "dapt-xsd-val"
 3 | version = "0.1.0"
 4 | description = "Thin wrapper around xmlschema to support XSD validation using the supplied DAPT XSD"
 5 | authors = [ {name = "Nigel Megitt <nigel.megitt@bbc.co.uk>"} ]
 6 | readme = "README.md"
 7 | requires-python = ">=3.11.7"
 8 | dependencies = [
 9 |     "xmlschema >= 4.1.0"
10 | ]
11 | 
12 | [project.scripts]
13 | validate = "src.validate:main"
14 | 
15 | [tool.poetry]
16 | name = "dapt-xsd-val"
17 | version = "0.1.0"
18 | description = "Thin wrapper around xmlschema to support XSD validation using the supplied DAPT XSD"
19 | authors = ["Nigel Megitt <nigel.megitt@bbc.co.uk>"]
20 | readme = "README.md"
21 | packages = [
22 |     { include = "src" },
23 |     { include = "test" },
24 | ]
25 | 
26 | [tool.poetry.dependencies]
27 | python = ">=3.11.7"
28 | xmlschema = "^4.1.0"
29 | 
30 | [tool.poetry.group.dev.dependencies]
31 | flake8 = "^7.2.0"
32 | 
33 | [build-system]
34 | requires = ["poetry-core"]
35 | build-backend = "poetry.core.masonry.api"
36 | 
37 | [tool.poetry.scripts]
38 | validate = "src.validate:main"
39 | 


--------------------------------------------------------------------------------
/examples/intro-times-and-text-with-visual-text.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml"
 2 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 3 |   xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 4 |   xmlns:xml="http://www.w3.org/XML/1998/namespace"
 5 |   ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 6 |   xml:lang="en"
 7 |   daptm:langSrc="zxx"
 8 |   daptm:scriptRepresents="visual.nonText visual.text"
 9 |   daptm:scriptType="preRecording">
10 |   <body>
11 |     <div begin="7s" end="8.5s" xml:id="at1"
12 |          daptm:represents="visual.text.location" daptm:langSrc="en">
13 |       <p>
14 |         The Lake District, England
15 |       </p>
16 |     </div>
17 |     <div begin="10s" end="13s" xml:id="a1"
18 |          daptm:represents="visual.nonText">
19 |       <p>
20 |         A woman climbs into a small sailing boat.
21 |       </p>
22 |     </div>
23 |     <div begin="18s" end="20s" xml:id="a2"
24 |          daptm:represents="visual.nonText">
25 |       <p>
26 |         The woman pulls the tiller and the boat turns.
27 |       </p>
28 |     </div>
29 |   </body>
30 | </tt>


--------------------------------------------------------------------------------
/schema-validator/test/test_validate.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | import unittest
 3 | from argparse import Namespace
 4 | from src.validate import validate_dapt
 5 | 
 6 | fixture_dur = \
 7 |     os.path.join(
 8 |         os.path.dirname(__file__),
 9 |         'fixtures')
10 | 
11 | 
12 | class testValidate(unittest.TestCase):
13 |     maxDiff = None
14 | 
15 |     def testValidFileAfterPruning(self):
16 |         with open(
17 |             os.path.join(fixture_dur, 'valid_dapt.ttml'),
18 |             mode='rb') \
19 |                 as dapt_file:
20 |             result = validate_dapt(
21 |                 args=Namespace(
22 |                     dapt_in=dapt_file,
23 |                     noprune=False))
24 | 
25 |         self.assertEqual(result, 0)
26 | 
27 |     def testInvalidFileBeforePruning(self):
28 |         with open(
29 |             os.path.join(fixture_dur, 'valid_dapt.ttml'),
30 |             mode='rb') \
31 |                 as dapt_file:
32 |             result = validate_dapt(
33 |                 args=Namespace(
34 |                     dapt_in=dapt_file,
35 |                     noprune=True))
36 | 
37 |         self.assertEqual(result, -1)
38 | 


--------------------------------------------------------------------------------
/examples/intro-original-language-with-dub-language.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml"
 2 |     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 3 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 4 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 5 |     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 6 |     xml:lang="en"
 7 |     daptm:langSrc="fr"
 8 |     daptm:scriptRepresents="audio.dialogue"
 9 |     daptm:scriptType="translatedTranscript">
10 |   <head>
11 |     <metadata>
12 |       <ttm:agent type="character" xml:id="character_1">
13 |         <ttm:name type="alias">ASSANE</ttm:name>
14 |       </ttm:agent>
15 |     </metadata>
16 |   </head>
17 |   <body>
18 |     <div begin="10s" end="13s" xml:id="d1" ttm:agent="character_1" daptm:represents="audio.dialogue">
19 |       <p xml:lang="fr" daptm:langSrc="fr"> <!-- original -->
20 |         <span>Et c'est grâce à ça qu'on va devenir riches.</span>
21 |       </p>
22 |       <p xml:lang="en" daptm:langSrc="fr"> <!-- translated -->
23 |         <span>And thanks to that, we're gonna get rich.</span>
24 |       </p>
25 |     </div>
26 |   </body>
27 | </tt>
28 | 


--------------------------------------------------------------------------------
/examples/intro-original-language-with-dub-language-and-adaptation.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml"
 2 |     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 3 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 4 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 5 |     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 6 |     xml:lang="en"
 7 |     daptm:langSrc="fr"
 8 |     daptm:scriptRepresents="audio.dialogue"
 9 |     daptm:scriptType="preRecording">
10 |   <head>
11 |     <metadata>
12 |       <ttm:agent type="character" xml:id="character_1">
13 |         <ttm:name type="alias">ASSANE</ttm:name>
14 |       </ttm:agent>
15 |     </metadata>
16 |   </head>
17 |   <body>
18 |     <div begin="10s" end="13s" xml:id="d1" ttm:agent="character_1" daptm:onScreen="ON_OFF" daptm:represents="audio.dialogue">
19 |       <p xml:lang="fr" daptm:langSrc="fr">
20 |         <span>Et c'est grâce à ça qu'on va devenir riches.</span>
21 |       </p>
22 |       <p xml:lang="en" daptm:langSrc="fr">
23 |         <span begin="0s">And thanks to that,</span><span begin="1.5s"> we're gonna get rich.</span>
24 |       </p>
25 |     </div>
26 |   </body>
27 | </tt>
28 | 


--------------------------------------------------------------------------------
/figures/sources/audio-mixing.puml:
--------------------------------------------------------------------------------
 1 | @startuml audio-mixing
 2 | !theme plain
 3 | !pragma ratio 1.3
 4 | skinparam groupInheritance 2
 5 | skinparam linetype ortho
 6 | skinparam DefaultFontName sans-serif
 7 | skinparam DefaultFontSize 16
 8 | skinparam ArrowFontSize 13
 9 | skinparam ArrowMessageAlignment direction
10 | skinparam Padding 3
11 | skinparam Nodesep 65
12 | skinparam Ranksep 40
13 | ' skinparam MinClassWidth 220
14 | 
15 | hide empty description
16 | 
17 | state fork_state <<fork>> 
18 | state join_state <<join>>
19 | state ScriptEvent as "(active) ScriptEvent"
20 | state AudioRecording as "(active) AudioRecording"
21 | state Text as "(active) Text"
22 | 
23 | [*] --> fork_state : programme\naudio
24 | fork_state --> ScriptEvent
25 | note on link
26 |   When audio
27 |   mixing is active
28 | end note
29 | 
30 | ScriptEvent --> Text
31 | AudioRecording --> Text
32 | Text --> join_state
33 | join_state --> [*]
34 | 
35 | AudioRecording : Pan
36 | AudioRecording : Gain
37 | 
38 | Text : Pan
39 | Text : Gain
40 | 
41 | ScriptEvent : Pan
42 | ScriptEvent : Gain
43 | 
44 | fork_state --> join_state
45 | note on link
46 |   When no audio
47 |   mixing is active
48 | end note
49 | 
50 | @enduml


--------------------------------------------------------------------------------
/figures/sources/webaudio-nodes.puml:
--------------------------------------------------------------------------------
 1 | @startuml webaudio-nodes
 2 | !theme plain
 3 | !pragma ratio 1.3
 4 | skinparam groupInheritance 2
 5 | ' skinparam linetype ortho
 6 | skinparam DefaultFontName sans-serif
 7 | skinparam DefaultFontSize 16
 8 | skinparam ArrowFontSize 13
 9 | skinparam ArrowMessageAlignment direction
10 | skinparam Padding 3
11 | skinparam Nodesep 65
12 | skinparam Ranksep 40
13 | ' skinparam MinClassWidth 220
14 | 
15 | hide empty description
16 | 
17 | state GN1 as "GainNode (ScriptEvent)"
18 | state PN1 as "PanNode (ScriptEvent)"
19 | state GN2 as "GainNode (Text)"
20 | state PN2 as "PanNode (Text)"
21 | state GN3 as "GainNode (AudioRecording)"
22 | state PN3 as "PanNode (AudioRecording)"
23 | state MB as "Master Bus" <<join>>
24 | state M1 as "+" <<join>>
25 | state AS as "AudioRecording Source" <<start>>
26 | 
27 | [*] --> GN1 : Programme Audio
28 | GN1 --> PN1
29 | 
30 | AS --> GN3 : AudioRecording\lSource Audio
31 | GN3 --> PN3
32 | 
33 | PN1 --> M1
34 | PN3 --> M1
35 | 
36 | note left of M1
37 |   Implicit mixer
38 | end note
39 | 
40 | M1 --> PN2
41 | PN2 --> GN2
42 | 
43 | GN2 --> MB
44 | MB --> [*] : Output Audio
45 | 
46 | note left of MB
47 |   Master bus
48 | end note
49 | 
50 | @enduml


--------------------------------------------------------------------------------
/xml-schemas/dapt-datatypes.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
 3 |     targetNamespace="http://www.w3.org/ns/ttml/profile/dapt#datatype"
 4 |     xmlns:daptd="http://www.w3.org/ns/ttml/profile/dapt#datatype">
 5 |     <xs:simpleType name="contentDescriptorType">
 6 |         <xs:annotation>
 7 |             <xs:documentation>
 8 |                     descriptor-token ( descriptor-delimiter descriptor-token )*
 9 |                     
10 |                     descriptor-token
11 |                         : (descriptorTokenChar)+
12 |                         
13 |                     descriptorTokenChar  # xsd:NMtoken without the "."
14 |                     : NameStartChar | "-" | [0-9] | #xB7 | [#x0300-#x036F] | [#x203F-#x2040]
15 |                     
16 |                     descriptor-delimiter
17 |                         : "."  # FULL STOP U+002E
18 |             </xs:documentation>
19 |         </xs:annotation>
20 |         <xs:restriction base="xs:string"/>
21 |     </xs:simpleType>
22 |     <xs:simpleType name="emptyValueType">
23 |         <xs:restriction base="xs:normalizedString"><xs:enumeration value=""/></xs:restriction>
24 |     </xs:simpleType>
25 | </xs:schema>
26 | 


--------------------------------------------------------------------------------
/examples/intro-top-level.xml:
--------------------------------------------------------------------------------
 1 | <tt xmlns="http://www.w3.org/ns/ttml" 
 2 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 3 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 4 |     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
 5 |     xml:lang="en"
 6 |     daptm:langSrc="en"
 7 |     daptm:scriptRepresents="audio"
 8 |     daptm:scriptType="originalTranscript">
 9 |   <head>
10 |     <metadata>
11 |       <!-- Additional metadata may be placed here -->
12 |       <!-- Any characters must be defined here as a set of ttm:agent elements -->
13 |     </metadata>
14 |     <styling>
15 |       <!-- Styling is optional and consists of a set of style elements -->
16 |     </styling>
17 |     <layout>
18 |       <!-- Layout is optional and consists of a set of region elements -->
19 |     </layout>
20 |   </head>
21 |   <body>
22 |     <!-- Content goes here and consists of a div for each Script Event -->
23 |     <div xml:id="d1" begin="..." end="..." daptm:represents="audio.dialogue">
24 |       <p>
25 |         <!-- Text blocks are contained in p elements -->
26 |       </p>
27 |       <p xml:lang="fr" daptm:langSrc="en">
28 |         <!-- Translation text is related to the source language for the translation -->
29 |       </p>
30 |     </div>
31 |   </body>
32 | </tt>
33 | 


--------------------------------------------------------------------------------
/registries/descType.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "columns": [
 3 |         {
 4 |             "header": "daptm:descType",
 5 |             "isKey": true,
 6 |             "rowKey": "value",
 7 |             "isType": false
 8 |         },
 9 |         {
10 |             "header": "Status",
11 |             "rowKey": "status"
12 |         },
13 |         {
14 |             "header": "Description",
15 |             "rowKey": "description"
16 |         },
17 |         {
18 |             "header": "Notes",
19 |             "rowKey": "notes"
20 |         }
21 |     ],
22 |     "values": [
23 |         {
24 |             "value": "pronunciationNote",
25 |             "status": "Provisional",
26 |             "description": "Notes for how to pronounce the content.",
27 |             "notes": ""
28 |         },
29 |         {
30 |             "value": "scene",
31 |             "status": "Provisional",
32 |             "description": "Contains a scene identifier",
33 |             "notes": ""
34 |         },
35 |         {
36 |             "value": "plotSignificance",
37 |             "status": "Provisional",
38 |             "description": "Defines a measure of how significant the content is to the plot.",
39 |             "notes": "Contents are undefined and may be low, medium or high, or a numerical scale."
40 |         }
41 |     ]
42 | }


--------------------------------------------------------------------------------
/xml-schemas/ttml2-core-attribs.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:xml="http://www.w3.org/XML/1998/namespace">
 6 |   <xs:import namespace="http://www.w3.org/XML/1998/namespace"
 7 |     schemaLocation="xml.xsd"/>
 8 |   <xs:attributeGroup name="Core.Condition.attrib.class">
 9 |     <xs:attribute name="condition" type="xs:string"/>
10 |   </xs:attributeGroup>
11 |   <xs:attributeGroup name="Core.ID.attrib.class">
12 |     <xs:attribute ref="xml:id"/>
13 |   </xs:attributeGroup>
14 |   <xs:attributeGroup name="Core.attrib.class">
15 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
16 |     <xs:attribute ref="xml:base"/>
17 |     <xs:attribute ref="xml:lang"/>
18 |     <xs:attribute ref="xml:space"/>
19 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
20 |   </xs:attributeGroup>
21 |   <xs:attributeGroup name="Core.required.attrib.class">
22 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
23 |     <xs:attribute ref="xml:lang" use="required"/>
24 |     <xs:attribute ref="xml:space"/>
25 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
26 |   </xs:attributeGroup>
27 | </xs:schema>
28 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-metadata.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata" elementFormDefault="qualified">
 6 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
 7 |   <xs:import namespace="http://www.w3.org/ns/ttml#metadata"
 8 |     schemaLocation="ttml2-metadata-items.xsd"/>
 9 |   <xs:include schemaLocation="ttml2-embedded.xsd"/>
10 |   <xs:attributeGroup name="metadata.attlist">
11 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
12 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
13 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
14 |   </xs:attributeGroup>
15 |   <xs:complexType name="metadata.eltype">
16 |     <xs:sequence>
17 |       <xs:choice minOccurs="0" maxOccurs="unbounded">
18 |         <xs:group ref="tt:Data.class"/>
19 |         <xs:any namespace="##other" processContents="lax"/>
20 |       </xs:choice>
21 |     </xs:sequence>
22 |     <xs:attributeGroup ref="tt:metadata.attlist"/>
23 |   </xs:complexType>
24 |   <xs:element name="metadata" type="tt:metadata.eltype"/>
25 |   <xs:group name="Metadata.class">
26 |     <xs:choice>
27 |       <xs:group ref="ttm:MetadataItems.class"/>
28 |       <xs:element ref="tt:metadata"/>
29 |     </xs:choice>
30 |   </xs:group>
31 | </xs:schema>
32 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-head.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 6 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 7 |   xmlns:tts="http://www.w3.org/ns/ttml#styling">
 8 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
 9 |   <xs:include schemaLocation="ttml2-metadata.xsd"/>
10 |   <xs:include schemaLocation="ttml2-parameters.xsd"/>
11 |   <xs:include schemaLocation="ttml2-embedded.xsd"/>
12 |   <xs:include schemaLocation="ttml2-styling.xsd"/>
13 |   <xs:include schemaLocation="ttml2-layout.xsd"/>
14 |   <xs:include schemaLocation="ttml2-animation.xsd"/>
15 |   <xs:attributeGroup name="head.attlist">
16 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
17 |   </xs:attributeGroup>
18 |   <xs:complexType name="dapt_head.eltype">
19 |     <xs:sequence>
20 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
21 |       <xs:group ref="tt:Parameters.class" minOccurs="0" maxOccurs="unbounded"/>
22 |       <xs:element ref="tt:resources" minOccurs="0" maxOccurs="1"/>
23 |       <xs:element ref="tt:styling" minOccurs="0" maxOccurs="1"/>
24 |       <xs:element ref="tt:layout" minOccurs="0" maxOccurs="1"/>
25 |       <!--  <xs:element ref="tt:animation" minOccurs="0" maxOccurs="1"/> animation prohibited by DAPT -->
26 |     </xs:sequence>
27 |     <xs:attributeGroup ref="tt:head.attlist"/>
28 |   </xs:complexType>
29 |   <xs:element name="head" type="tt:dapt_head.eltype"/>
30 | </xs:schema>
31 | 


--------------------------------------------------------------------------------
/schema-validator/README.md:
--------------------------------------------------------------------------------
 1 | # DAPT XSD Validator
 2 | 
 3 | Basic command line utility for validating DAPT documents using
 4 | the XML Schema Definition in the w3c/dapt repository.
 5 | 
 6 | This script uses the MIT licensed [`xmlschema`](https://github.com/sissaschool/xmlschema) library.
 7 | 
 8 | This script is provided as-is with no warranties of any kind.
 9 | The repository's `LICENSE.md` applies, with the contents of this folder
10 | being considered a _code example_.
11 | 
12 | ## Build
13 | 
14 | 1. Install a python build and launch tool such as:
15 |   1. poetry - [installation instructions](https://python-poetry.org/docs/#installing-with-the-official-installer) or
16 |   2. uv - [installation instructions](https://docs.astral.sh/uv/getting-started/installation/)
17 | 2. Ensure you have a version of Python greater than or equal to 3.11 available
18 | for example with the command `poetry env use 3.11` or `uv python install 3.11 && uv python pin 3.11.13` (check current available versions first)
19 | 3. Install the dependencies by running `poetry install` or `uv build`
20 | 
21 | ## Usage
22 | 
23 | Replacing `$launchtool` with `poetry` or `uv` according to your environment:
24 | 
25 | ```sh
26 | $launchtool run validate -dapt_in path/to/dapt_file.ttml
27 | ```
28 | 
29 | or pass the document for validating in via stdin, e.g.:
30 | 
31 | ```sh
32 | $launchtool run validate < path/to/dapt_file.ttml
33 | ```
34 | 
35 | ### Validating without pruning unrecognised vocabulary
36 | 
37 | By default this script prunes unrecognised vocabulary before
38 | XSD validation, as required by
39 | [DAPT §5.2.1 Unrecognised vocabulary](https://www.w3.org/TR/dapt/#unrecognised-elements-and-attributes);
40 | this behaviour can be disabled via the command line parameter
41 | `-noprune`.
42 | 
43 | 
44 | ## Tests
45 | 
46 | ```sh
47 | $launchtool run python -m unittest
48 | ```
49 | 


--------------------------------------------------------------------------------
/schema-validator/uv.lock:
--------------------------------------------------------------------------------
 1 | version = 1
 2 | revision = 2
 3 | requires-python = ">=3.11.7"
 4 | 
 5 | [[package]]
 6 | name = "dapt-xsd-val"
 7 | version = "0.1.0"
 8 | source = { editable = "." }
 9 | dependencies = [
10 |     { name = "xmlschema" },
11 | ]
12 | 
13 | [package.metadata]
14 | requires-dist = [{ name = "xmlschema", specifier = ">=4.1.0" }]
15 | 
16 | [[package]]
17 | name = "elementpath"
18 | version = "5.0.1"
19 | source = { registry = "https://pypi.org/simple" }
20 | sdist = { url = "https://files.pythonhosted.org/packages/ea/3d/0be6a0e373ac54bd53ab6c3b0722de9752dbd62e19d3d4d0f3f70ecbb246/elementpath-5.0.1.tar.gz", hash = "sha256:d3e4807b7e38e190e382eefef93f35ce6f71adf63b33e3f01d0e11f22e5d5cc7", size = 363233, upload-time = "2025-05-11T16:01:20.425Z" }
21 | wheels = [
22 |     { url = "https://files.pythonhosted.org/packages/dd/09/fbd26adb51ccd29fa65798fe9bf6e8a73720e37e437ac2cf1d51133bd1f5/elementpath-5.0.1-py3-none-any.whl", hash = "sha256:334f796578d1d273e99838b6a731d265985ea9ab399e22b74ea1c3a3faa73c83", size = 245130, upload-time = "2025-05-11T16:01:16.615Z" },
23 | ]
24 | 
25 | [[package]]
26 | name = "xmlschema"
27 | version = "4.1.0"
28 | source = { registry = "https://pypi.org/simple" }
29 | dependencies = [
30 |     { name = "elementpath" },
31 | ]
32 | sdist = { url = "https://files.pythonhosted.org/packages/dd/cb/dc0236ae209c924c1a7f4d3ae9d3371980beda85d1e0b5bd2d4f07372e48/xmlschema-4.1.0.tar.gz", hash = "sha256:88ac771cf94d5fc6bbd1a763db8c157f3d683ad23120b0d0b8c46fe4537f2adf", size = 633811, upload-time = "2025-06-05T21:17:39.32Z" }
33 | wheels = [
34 |     { url = "https://files.pythonhosted.org/packages/c5/2c/3ba8f8aeb3cb566e88a61ab0b0b767d5398d1e7293a0f7a76df9051e2b08/xmlschema-4.1.0-py3-none-any.whl", hash = "sha256:eabf610f398a58700bc4ac94380ad9ce558297a3f9ca8b7722ed3f7888eb4498", size = 458466, upload-time = "2025-06-05T21:17:35.265Z" },
35 | ]
36 | 


--------------------------------------------------------------------------------
/schema-validator/test/fixtures/valid_dapt.ttml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <tt xmlns="http://www.w3.org/ns/ttml"
 3 |     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |     xmlns:tta="http://www.w3.org/ns/ttml#audio"
 5 |     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 6 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
 7 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 8 |     xmlns:ebuttm="urn:ebu:tt:metadata"
 9 |     ttp:contentProfiles="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
10 |     daptm:scriptRepresents="audio visual"
11 |     daptm:scriptType="originalTranscript"
12 |     daptm:represents="audio.dialogue"
13 |     xml:lang="en">
14 |     <head>
15 |         <metadata xmlns:otherns="urn:some:other:namespace">
16 |             <ttm:agent xmlns:nttm="http://www.netflix.com/ns/ttml#metadata" 
17 |                 nttm:voice="en-US-Wavenet-B" foo="bar" otherns:test="x" type="person" xml:id="actor_A" id="huh">
18 |                 <ttm:name type="full">Matthias Schoenaerts</ttm:name>
19 |             </ttm:agent>
20 |             <ttm:agent type="character" xml:id="character_2">
21 |                 <ttm:name type="alias">BOOKER</ttm:name>
22 |                 <ttm:actor agent="actor_A"/>
23 |             </ttm:agent>
24 |             <otherns:x/>
25 |             <otherns:y/>
26 |         </metadata>
27 |     </head>
28 |     <body daptm:represents="visual.nonText">
29 |         <div xml:id="se1" begin="3s" end="10s" ttm:agent="character_2" daptm:represents="audio.dialogue" daptm:onScreen="ON">
30 |             <ttm:desc daptm:descType="scene">high mountain valley</ttm:desc>
31 |             <metadata></metadata>
32 |             <p daptm:langSrc="en"><span>Look at this beautiful valley.</span></p>
33 |         </div>
34 |         <div xml:id="se2" begin="13s" end="20s" daptm:represents="visual.nonText">
35 |             <metadata></metadata>
36 |             <p daptm:langSrc="en" daptm:represents="visual.text"><span daptm:represents="visual.text.title">The Old Guard</span><br/><span daptm:represents="visual.text.location">Afghanistan</span></p>
37 |         </div>
38 |     </body>
39 | </tt>


--------------------------------------------------------------------------------
/registries/README.md:
--------------------------------------------------------------------------------
 1 | # Registry JSON files
 2 | 
 3 | This directory includes JSON files containing the Registry table data for
 4 | the registries defined in DAPT.
 5 | 
 6 | ## Structure
 7 | 
 8 | The JSON has the following structure:
 9 | 
10 | ```json
11 | {
12 |     "columns": [
13 |         {
14 |             "header": "some human readable thing",
15 |             "isKey": true,
16 |             "rowKey": "value",
17 |             "isType": false
18 |         },
19 |         {
20 |             "header": "some other human readable thing",
21 |             "rowKey": "foo"
22 |         }
23 |     ],
24 |     "values": [
25 |         {
26 |             "value": "first value",
27 |             "foo": "bar1"
28 |         },
29 |         {
30 |             "value": "second value",
31 |             "foo": "bar2"
32 |         }
33 |     ]
34 | }
35 | ```
36 | 
37 | The `header` in each object in `columns` is a human readable column header.
38 | 
39 | The `rowKey` in each object in `columns` is used as the key in each entry in
40 | the `values` array so that the header text does not need
41 | to be reproduced in every entry, but a simpler string can be used instead.
42 | 
43 | For each object in the `columns` array there MUST be a corresponding
44 | key and value in every object in the `values` array.
45 | Within the DAPT specification those values are mapped into the relevant
46 | registry table.
47 | Additional keys and values in a `values` array object, where the key does not
48 | match a `rowKey` will not be reflected in the specification.
49 | 
50 | If `isKey` is `true` that indicates that the column contains a registry key.
51 | 
52 | If `isType` is `true` and `isKey` is `true` that indicates that the column
53 | header is a data type, which will be formatted surrounded by angle brackets
54 | as per the TTML document conventions.
55 | 
56 | ## Use of the registry JSON files in DAPT implementations
57 | 
58 | Implementations can check find the set of permitted values in DAPT documents
59 | by iterating through the `values` array, and getting the objects whose
60 | key(s) is/are identified in `columns` with `isKey: true`.
61 | 
62 | The `status` of each value is also relevant to identify Deprecated values.
63 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-layout.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 6 |   xmlns:tts="http://www.w3.org/ns/ttml#styling">
 7 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
 8 |   <xs:include schemaLocation="ttml2-timing-attribs.xsd"/>
 9 |   <xs:include schemaLocation="ttml2-metadata.xsd"/>
10 |   <xs:include schemaLocation="ttml2-animation.xsd"/>
11 |   <xs:include schemaLocation="ttml2-layout.xsd"/>
12 |   <xs:include schemaLocation="ttml2-styling.xsd"/>
13 |   <xs:import namespace="http://www.w3.org/ns/ttml#styling"
14 |     schemaLocation="ttml2-styling-attribs.xsd"/>
15 |   <xs:attributeGroup name="RegionBinding.attrib.class">
16 |     <xs:attribute name="region" type="xs:IDREF"/>
17 |   </xs:attributeGroup>
18 |   <xs:attributeGroup name="layout.attlist">
19 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
20 |   </xs:attributeGroup>
21 |   <xs:attributeGroup name="region.attlist">
22 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
23 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
24 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
25 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
26 |     <!-- <xs:attributeGroup ref="tt:AnimationBinding.attrib.class"/> out of line animation prohibited in DAPT -->
27 |   </xs:attributeGroup>
28 |   <xs:complexType name="layout.eltype">
29 |     <xs:sequence>
30 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
31 |       <xs:element ref="tt:region" minOccurs="0" maxOccurs="unbounded"/>
32 |     </xs:sequence>
33 |     <xs:attributeGroup ref="tt:layout.attlist"/>
34 |   </xs:complexType>
35 |   <xs:complexType name="region.eltype">
36 |     <xs:sequence>
37 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
38 |       <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
39 |       <xs:element ref="tt:style" minOccurs="0" maxOccurs="unbounded"/>
40 |     </xs:sequence>
41 |     <xs:attributeGroup ref="tt:region.attlist"/>
42 |   </xs:complexType>
43 |   <xs:element name="layout" type="tt:layout.eltype"/>
44 |   <xs:element name="region" type="tt:region.eltype"/>
45 |   <xs:group name="Layout.class">
46 |     <xs:choice>
47 |       <xs:element ref="tt:region"/>
48 |     </xs:choice>
49 |   </xs:group>
50 | </xs:schema>
51 | 


--------------------------------------------------------------------------------
/xml-schemas/dapt-metadata.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
 3 |      version="2024-11-13" attributeFormDefault="qualified"
 4 |      targetNamespace="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 5 |      xmlns:daptd="http://www.w3.org/ns/ttml/profile/dapt#datatype"
 6 |      xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata">
 7 |      <xs:import namespace="http://www.w3.org/ns/ttml/profile/dapt#datatype"
 8 |           schemaLocation="dapt-datatypes.xsd"/>
 9 |      <xs:attribute name="descType">
10 |           <xs:simpleType>
11 |                <xs:restriction base="xs:string"/>
12 |           </xs:simpleType>
13 |      </xs:attribute>
14 |      <xs:attribute name="langSrc">
15 |           <xs:simpleType>
16 |                <xs:union memberTypes="daptd:emptyValueType xs:language"></xs:union>
17 |           </xs:simpleType>
18 |      </xs:attribute>
19 |      <xs:attribute name="onScreen">
20 |           <xs:simpleType>
21 |                <xs:restriction base="xs:token">
22 |                     <xs:enumeration value="ON"/>
23 |                     <xs:enumeration value="OFF"/>
24 |                     <xs:enumeration value="ON_OFF"/>
25 |                     <xs:enumeration value="OFF_ON"/>
26 |                </xs:restriction>
27 |           </xs:simpleType>
28 |      </xs:attribute>
29 |      <xs:attribute name="represents" type="daptd:contentDescriptorType"/>
30 |      <xs:attribute name="scriptRepresents" type="daptd:contentDescriptorType"/>
31 |      <xs:attribute name="scriptType">
32 |           <xs:simpleType>
33 |                <xs:restriction base="xs:token">
34 |                     <xs:enumeration value="originalTranscript"/>
35 |                     <xs:enumeration value="translatedTranscript"/>
36 |                     <xs:enumeration value="preRecording"/>
37 |                     <xs:enumeration value="asRecorded"/>
38 |                </xs:restriction>
39 |           </xs:simpleType>
40 |      </xs:attribute>
41 |      <xs:element name="daptOriginTimecode">
42 |           <xs:simpleType>
43 |                <xs:restriction base="xs:string">
44 |                     <xs:pattern value="\d[\d]+:\d\d:\d\d:\d\d"></xs:pattern>
45 |                </xs:restriction>
46 |           </xs:simpleType>
47 |      </xs:element>
48 |      <xs:group name="Metadata.class">
49 |           <xs:choice>
50 |                <xs:element ref="daptm:daptOriginTimecode"/>
51 |           </xs:choice>
52 |      </xs:group>
53 | </xs:schema>
54 | 


--------------------------------------------------------------------------------
/xml-schemas/README.md:
--------------------------------------------------------------------------------
 1 | # DAPT XSD Readme
 2 | 
 3 | The [DAPT](https://www.w3.org/TR/dapt/) XML Schema is provided as an informative (i.e. non-normative) addition
 4 | to the specification as an aid to implementers.
 5 | 
 6 | The XML Schema is provided as an [XSD 1](https://www.w3.org/TR/xmlschema-1/) (XML Schema definition language) document.
 7 | 
 8 | ## Usage
 9 | 
10 | An XSD 1 conformant XML validator should be able to validate a DAPT document against the top level [`dapt.xsd`](dapt.xsd)
11 | schema document.
12 | 
13 | Since part of the schema is pulled in via a git submodule,
14 | either clone the repository recursively or manually ensure that the submodule is cloned
15 | to your local machine.
16 | 
17 | As a convenience, a Python script is provided to allow use of the XSDs to validate
18 | a DAPT document using only open source libraries. The script is in the `schema-validator` folder.
19 | 
20 | ## Design
21 | 
22 | The DAPT XSD is designed to be inclusive of all content predicted from the DAPT specification,
23 | rather than defining attributes and elements from the DAPT specification
24 | and relying on external XSDs for other namespace vocabulary.
25 | This also permits DAPT-specific constraints, such as the prohibition of the `<animation>` element,
26 | or the requirement for the `daptm:scriptRepresents` attribute on the root `<tt>` element,
27 | can be applied.
28 | 
29 | ### Sources
30 | 
31 | Structurally, much of the XSD consists of a copy of the [TTML2 XSD](https://github.com/w3c/ttml2/tree/main/spec/xsd), though in some cases changes have been
32 | made to represent those additional DAPT constraints.
33 | This means that if the TTML2 XSD changes, there could be a maintenance task to update the DAPT XSD.
34 | However it also simplifies usage.
35 | 
36 | Additionally, DAPT namespaces and DAPT-specific data types are defined in imported files whose name is prefixed `dapt-`.
37 | 
38 | EBU-TT Metadata is imported via a git submodule pointed at the XSD 1 version of the
39 | [EBU-TT Metadata schema](https://github.com/ebu/ebu-tt-m-xsd/tree/issue-0030-schema-v1).
40 | 
41 | ### Type restrictions
42 | 
43 | Two mechanisms are used to enforce DAPT-specific type restrictions:
44 | 
45 | 1. DAPT-specific complex type definitions with `xs:complexContent` containing `xs:restriction` based on the TTML2 type.
46 | This method is used where attributes permitted on the TTML2 type are prohibited in DAPT, and/or when additional
47 | DAPT-specific attributes need to be permitted as extensions to the TTML2 element.
48 | The relevant element definitions then point to the restricted DAPT type rather than the base TTML2 type.
49 | 2. Edits to remove DAPT-prohibited elements or attribute groups from TTML2 types - where this
50 | pattern is used, XML comments highlight the change in the XSD file.
51 | 
52 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-animation.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
 6 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 7 |   xmlns:tts="http://www.w3.org/ns/ttml#styling"
 8 |   xmlns:xlink="http://www.w3.org/1999/xlink">
 9 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
10 |   <xs:include schemaLocation="ttml2-timing-attribs.xsd"/>
11 |   <xs:include schemaLocation="ttml2-metadata.xsd"/>
12 |   <xs:include schemaLocation="ttml2-styling.xsd"/>
13 |   <xs:import namespace="http://www.w3.org/ns/ttml#styling"
14 |     schemaLocation="ttml2-styling-attribs.xsd"/>
15 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
16 |     schemaLocation="ttml2-datatypes.xsd"/>
17 |   <xs:import namespace="http://www.w3.org/1999/xlink"
18 |     schemaLocation="xlink.xsd"/>
19 |   <xs:attributeGroup name="animate.attlist">
20 |     <xs:attributeGroup ref="tt:Core.attrib.class" />
21 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
22 |     <xs:attributeGroup ref="tt:Timed.attrib.class" />
23 |     <xs:attributeGroup ref="tt:Styled.NoBinding.attrib.class"/>
24 |     <xs:attribute name="calcMode" type="ttd:calcMode"/>
25 |     <xs:attribute name="fill" type="ttd:fill"/>
26 |     <xs:attribute name="keySplines" type="ttd:keySplines"/>
27 |     <xs:attribute name="keyTimes" type="ttd:keyTimes"/>
28 |     <xs:attribute name="repeatCount" type="ttd:repeatCount"/>
29 |   </xs:attributeGroup>
30 |   <xs:complexType name="animate.eltype">
31 |     <xs:sequence>
32 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
33 |     </xs:sequence>
34 |     <xs:attributeGroup ref="tt:animate.attlist"/>
35 |   </xs:complexType>
36 |   <xs:attributeGroup name="set.attlist">
37 |     <xs:attributeGroup ref="tt:Core.attrib.class" />
38 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
39 |     <xs:attributeGroup ref="tt:Timed.attrib.class" />
40 |     <xs:attributeGroup ref="tt:Styled.NoBinding.attrib.class"/>
41 |     <xs:attribute name="fill" type="ttd:fill"/>
42 |     <xs:attribute name="repeatCount" type="ttd:repeatCount"/>
43 |   </xs:attributeGroup>
44 |   <xs:complexType name="set.eltype">
45 |     <xs:sequence>
46 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
47 |     </xs:sequence>
48 |     <xs:attributeGroup ref="tt:set.attlist"/>
49 |   </xs:complexType>
50 |   <xs:element name="animate" type="tt:animate.eltype"/>
51 |   <xs:element name="set" type="tt:set.eltype"/>
52 |   <xs:group name="Animation.class">
53 |     <xs:choice>
54 |       <xs:element ref="tt:animate"/>
55 |       <xs:element ref="tt:set"/>
56 |     </xs:choice>
57 |   </xs:group>
58 | </xs:schema>
59 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-styling.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
 6 |   xmlns:tts="http://www.w3.org/ns/ttml#styling"
 7 |   xmlns:tta="http://www.w3.org/ns/ttml#audio">
 8 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
 9 |   <xs:include schemaLocation="ttml2-metadata.xsd"/>
10 |   <xs:import namespace="http://www.w3.org/ns/ttml#styling"
11 |     schemaLocation="ttml2-styling-attribs.xsd"/>
12 |   <xs:import namespace="http://www.w3.org/ns/ttml#audio"
13 |     schemaLocation="ttml2-audio-attribs.xsd"/>
14 |   <xs:attributeGroup name="StyleBinding.attrib.class">
15 |     <xs:attribute name="style" type="xs:IDREFS"/>
16 |   </xs:attributeGroup>
17 |   <xs:attributeGroup name="Styled.attrib.class">
18 |     <xs:attributeGroup ref="tt:StyleBinding.attrib.class"/>
19 |     <xs:attributeGroup ref="tts:Styling.attrib.class"/>
20 |     <xs:attributeGroup ref="tta:Styling.Audio.attrib.class"/>
21 |   </xs:attributeGroup>
22 |   <xs:attributeGroup name="Styled.NoBinding.attrib.class">
23 |     <xs:attributeGroup ref="tts:Styling.attrib.class"/>
24 |     <xs:attributeGroup ref="tta:Styling.Audio.attrib.class"/>
25 |   </xs:attributeGroup>
26 |   <xs:attributeGroup name="styling.attlist">
27 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
28 |   </xs:attributeGroup>
29 |   <xs:attributeGroup name="style.attlist">
30 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
31 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
32 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
33 |   </xs:attributeGroup>
34 |   <xs:attributeGroup name="initial.attlist">
35 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
36 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
37 |     <xs:attributeGroup ref="tt:Styled.NoBinding.attrib.class"/>
38 |   </xs:attributeGroup>
39 |   <xs:complexType name="styling.eltype">
40 |     <xs:sequence>
41 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
42 |       <xs:element ref="tt:initial" minOccurs="0" maxOccurs="unbounded"/>
43 |       <xs:element ref="tt:style" minOccurs="0" maxOccurs="unbounded"/>
44 |     </xs:sequence>
45 |     <xs:attributeGroup ref="tt:styling.attlist"/>
46 |   </xs:complexType>
47 |   <xs:complexType name="style.eltype">
48 |     <xs:sequence>
49 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
50 |     </xs:sequence>
51 |     <xs:attributeGroup ref="tt:style.attlist"/>
52 |   </xs:complexType>
53 |   <xs:complexType name="initial.eltype">
54 |     <xs:sequence>
55 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
56 |     </xs:sequence>
57 |     <xs:attributeGroup ref="tt:initial.attlist"/>
58 |   </xs:complexType>
59 |   <xs:element name="styling" type="tt:styling.eltype"/>
60 |   <xs:element name="style" type="tt:style.eltype"/>
61 |   <xs:element name="initial" type="tt:initial.eltype"/>
62 | </xs:schema>
63 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-parameter-attribs.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#parameter"
 3 |   xml:lang="en" xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
 5 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter">
 6 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
 7 |     schemaLocation="ttml2-datatypes.xsd"/>
 8 |   <xs:attribute name="cellResolution" type="ttd:cellResolution"/>
 9 |   <xs:attribute name="clockMode" type="ttd:clockMode"/>
10 |   <xs:attribute name="contentProfiles" type="ttd:contentProfiles"/>
11 |   <xs:attribute name="contentProfileCombination" type="ttd:profileCombination"/>
12 |   <xs:attribute name="displayAspectRatio" type="ttd:displayAspectRatio"/>
13 |   <xs:attribute name="dropMode" type="ttd:dropMode"/>
14 |   <xs:attribute name="frameRate" type="ttd:frameRate"/>
15 |   <xs:attribute name="frameRateMultiplier" type="ttd:frameRateMultiplier"/>
16 |   <xs:attribute name="inferProcessorProfileMethod" type="ttd:inferProcessorProfileMethod"/>
17 |   <xs:attribute name="inferProcessorProfileSource" type="ttd:inferProcessorProfileSource"/>
18 |   <xs:attribute name="markerMode" type="ttd:markerMode"/>
19 |   <xs:attribute name="pixelAspectRatio" type="ttd:pixelAspectRatio"/>
20 |   <xs:attribute name="processorProfiles" type="ttd:processorProfiles"/>
21 |   <xs:attribute name="processorProfileCombination" type="ttd:profileCombination"/>
22 |   <xs:attribute name="permitFeatureNarrowing" type="ttd:permitFeatureNarrowingOrWidening"/>
23 |   <xs:attribute name="permitFeatureWidening" type="ttd:permitFeatureNarrowingOrWidening"/>
24 |   <xs:attribute name="profile" type="ttd:profile"/>
25 |   <xs:attribute name="subFrameRate" type="ttd:subFrameRate"/>
26 |   <xs:attribute name="tickRate" type="ttd:tickRate"/>
27 |   <xs:attribute name="timeBase" type="ttd:timeBase"/>
28 |   <xs:attribute name="validation" type="ttd:validation"/>
29 |   <xs:attribute name="validationAction" type="ttd:validationAction"/>
30 |   <xs:attributeGroup name="Parameter.attrib.class">
31 |     <xs:attribute ref="ttp:cellResolution"/>
32 |     <xs:attribute ref="ttp:clockMode"/>
33 |     <xs:attribute ref="ttp:contentProfiles"/>
34 |     <xs:attribute ref="ttp:contentProfileCombination"/>
35 |     <xs:attribute ref="ttp:displayAspectRatio"/>
36 |     <xs:attribute ref="ttp:dropMode"/>
37 |     <xs:attribute ref="ttp:frameRate"/>
38 |     <xs:attribute ref="ttp:frameRateMultiplier"/>
39 |     <xs:attribute ref="ttp:inferProcessorProfileMethod"/>
40 |     <xs:attribute ref="ttp:inferProcessorProfileSource"/>
41 |     <xs:attribute ref="ttp:markerMode"/>
42 |     <xs:attribute ref="ttp:permitFeatureNarrowing"/>
43 |     <xs:attribute ref="ttp:permitFeatureWidening"/>
44 |     <xs:attribute ref="ttp:pixelAspectRatio"/>
45 |     <xs:attribute ref="ttp:processorProfiles"/>
46 |     <xs:attribute ref="ttp:processorProfileCombination"/>
47 |     <xs:attribute ref="ttp:profile"/>
48 |     <xs:attribute ref="ttp:subFrameRate"/>
49 |     <xs:attribute ref="ttp:tickRate"/>
50 |     <xs:attribute ref="ttp:timeBase"/>
51 |     <xs:attribute ref="ttp:validation"/>
52 |     <xs:attribute ref="ttp:validationAction"/>
53 |   </xs:attributeGroup>
54 | </xs:schema>
55 | 


--------------------------------------------------------------------------------
/xml-schemas/dapt.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
 3 |     vc:minVersion="1.0" vc:maxVersion="1.1" version="2024-11-13"
 4 |     xmlns:vc="http://www.w3.org/2007/XMLSchema-versioning"
 5 |     xmlns:xs="http://www.w3.org/2001/XMLSchema"
 6 |     xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 7 |     xmlns:ebuttm="urn:ebu:tt:metadata"
 8 |     xmlns:tt="http://www.w3.org/ns/ttml"
 9 |     xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
10 |     xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
11 |     xmlns:tts="http://www.w3.org/ns/ttml#styling">
12 |     <xs:import namespace="http://www.w3.org/XML/1998/namespace"
13 |         schemaLocation="xml.xsd"></xs:import>
14 |     <xs:import namespace="http://www.w3.org/ns/ttml#metadata"
15 |         schemaLocation="ttml2-metadata-items.xsd"/>
16 |     <xs:import namespace="http://www.w3.org/ns/ttml/profile/dapt#metadata"
17 |         schemaLocation="dapt-metadata.xsd"/>
18 |     <xs:import namespace="urn:ebu:tt:metadata"
19 |         schemaLocation="ebu-tt-m-xsd/ebu-tt-metadata.xsd"/>
20 |     <xs:import namespace="http://www.w3.org/ns/ttml#parameter"
21 |         schemaLocation="ttml2-parameter-items.xsd"/>
22 |     <xs:import namespace="http://www.w3.org/ns/ttml#styling"
23 |         schemaLocation="ttml2-styling-attribs.xsd"/>
24 |     <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
25 |     <xs:include schemaLocation="ttml2-timing-attribs.xsd"/>
26 |     <xs:include schemaLocation="ttml2-head.xsd"/>
27 |     <xs:include schemaLocation="ttml2-content.xsd"/>
28 |     <xs:include schemaLocation="ttml2-embedded.xsd"/>
29 |     <xs:attributeGroup name="tt.attlist">
30 |         <xs:attributeGroup ref="tt:Core.required.attrib.class"/>
31 |         <xs:attributeGroup ref="ttp:Parameter.attrib.class"/>
32 |         <xs:attribute ref="tts:extent"/>
33 |     </xs:attributeGroup>
34 |     <xs:complexType name="tt.eltype">
35 |         <xs:sequence>
36 |             <xs:element ref="tt:head" minOccurs="0" maxOccurs="1"/>
37 |             <xs:element ref="tt:body" minOccurs="0" maxOccurs="1"/>
38 |         </xs:sequence>
39 |         <xs:attributeGroup ref="tt:tt.attlist"/>
40 |     </xs:complexType>
41 |     <xs:complexType name="dapt_tt.eltype">
42 |         <xs:complexContent>
43 |             <xs:restriction base="tt:tt.eltype">
44 |                 <xs:sequence>
45 |                     <xs:element ref="tt:head" minOccurs="0" maxOccurs="1"/>
46 |                     <xs:element ref="tt:body" minOccurs="0" maxOccurs="1"/>
47 |                 </xs:sequence>
48 |                 <xs:attribute ref="ttp:clockMode" use="prohibited"/>
49 |                 <xs:attribute ref="ttp:contentProfiles" use="required"/>
50 |                 <xs:attribute ref="ttp:dropMode" use="prohibited"/>
51 |                 <xs:attribute ref="ttp:markerMode" use="prohibited"/>
52 |                 <xs:attribute ref="ttp:profile" use="prohibited"/>
53 |                 <xs:attribute ref="ttp:subFrameRate" use="prohibited"/>
54 |                 <xs:attribute ref="daptm:langSrc"/>
55 |                 <xs:attribute ref="daptm:represents"/>
56 |                 <xs:attribute ref="daptm:scriptRepresents" use="required"/>
57 |                 <xs:attribute ref="daptm:scriptType" use="required"/>
58 |             </xs:restriction>
59 |         </xs:complexContent>
60 |     </xs:complexType>
61 |     <xs:element name="tt" type="tt:dapt_tt.eltype"/>
62 | </xs:schema>
63 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # dapt
 2 | The Dubbing and Audio description Profiles of TTML2, 
 3 | by the [Timed Text Working Group](https://www.w3.org/AudioVideo/TT/) 
 4 | is a profile of TTML2 suitable for the scripting, voicing and audio mixing 
 5 | of dubbing tracks and audio description for video.
 6 | This work was originally a combination of 
 7 | The [Audio Description Profile of TTML2](https://w3c.github.io/adpt/) 
 8 | , which was originally made by the [Audio Description Community Group](https://www.w3.org/community/audio-description/), 
 9 | and [Timed Text Authoring Lineage (TTAL)](https://netflixtechblog.com/introducing-netflix-timed-text-authoring-lineage-6fb57b72ad41). 
10 | 
11 | It is intended to meet the requirements set out in the 
12 | [Requirements for Dubbing and Audio description](https://w3c.github.io/dapt-reqs/). 
13 | 
14 | The Editor's Draft can be viewed at https://w3c.github.io/dapt/
15 | 
16 | ## Building
17 | 
18 | The specification is built using [Respec](https://respec.org/) and needs no
19 | additional build steps for the main body. The figures are written in
20 | [PlantUML](https://plantuml.com) and need to be exported in SVG format
21 | after any changes.
22 | 
23 | ### PlantUML Figures
24 | 
25 | The PlantUML figures' source files are in `/figures/sources`.
26 | 
27 | The PlantUML figures can be exported as SVG via the command line,
28 | but IDE support in e.g. VSCode can make the editing experience simpler.
29 | 
30 | #### Using VSCode with PlantUML Extension
31 | 
32 | If using VSCode with the [PlantUML Extension](https://marketplace.visualstudio.com/items?itemName=jebbs.plantuml), the following workspace settings may be helpful:
33 | 
34 | ```json
35 | {
36 |     "plantuml.diagramsRoot": "figures/sources",
37 |     "plantuml.exportFormat": "svg",
38 |     "plantuml.exportOutDir": "figures",
39 |     "plantuml.exportSubFolder": false,
40 | }
41 | ```
42 | 
43 | Then while editing the source, running "PlantUML: Export Current Diagram"
44 | from the command palette will regenerate the SVG and write the output to
45 | the correct location, `/figures`.
46 | 
47 | ### Tidying the SVG output for validation
48 | 
49 | Unfortunately the SVG that PlantUML generates from our source files has some structural issues that cause it to fail the W3C's HTML validator.
50 | The following steps can be taken to fix them. It'd be neat to automate this somehow, one day...
51 | 1. delete `contentStyleType="text/css"`
52 | 2. delete text matching the regexp ` title="[#a-zA-Z\-]+"`
53 | 3. delete text matching the regexp = ` codeline="[#a-zA-Z0-9\-]+"`
54 | 4. deduplicate id values, e.g. id="link_Text_Style" in more than one place - a specific problem with the two links from Text to Style in the class diagram. E.g. change the "other" link with `id="link_Text_Style"` to `id="link_Text_Style_other"`
55 | 5. Move <a> wrappers from around boxes which contain other <a> elements, which therefore get nested, so the link is not on the box but is on the top text.
56 |    * Specifically, where there is `/svg/a/g/text` move the `<a>` wrappers to being around the `<text>` that includes the text that's relevant.
57 |    * It then becomes `/svg/g/a/text` (where the `a` has is the second child of the `g`, the first being a `rect`)
58 |    * Atsushi also moved the `<rect>` at `/svg/a/g/rect` out of the `<g>` so there is `/svg/rect` followed by `/svg/g/a/text` but why? Seems okay without doing that.
59 | 6. Remove the `stroke-width:1.0;` property from all `rect`, `line`, `path` and `polygon` elements' `style` children. (they override the CSS styling that highlights links on hover or focus)


--------------------------------------------------------------------------------
/substantive-changes-summary.txt:
--------------------------------------------------------------------------------
 1 | **********************************
 2 | *                                *
 3 | * Summary of substantive changes *
 4 | *                                *
 5 | **********************************
 6 | 
 7 | 
 8 | NOTE 1: This summary is provided for illustration only. For an exhaustive list of changes, please
 9 | refer to the changesets at https://github.com/w3c/dapt or use the W3C diff tool at
10 | http://services.w3.org/htmldiff across published versions of the specification.
11 | 
12 | NOTE 2: Issues and their dispositions are documented at https://github.com/w3c/dapt/issues
13 | 
14 | NOTE 3: The publication history of this specification is at https://www.w3.org/standards/history/dapt/
15 | 
16 | From FPWD (20230425)
17 | ====================
18 | 
19 | * Introduce workflowType and restructure scriptType values (#11) (note that workflowType was later removed)
20 | 
21 | * Add trailing / to DAPT Extension namespace (#141)
22 | 
23 | * Clarify that Script Events, not Texts, are associated with a Character (#149)
24 | 
25 | * Define the TTML representation of Text content (#17)
26 | 
27 | * Write a Privacy and Security section (#166)
28 | 
29 | * Identify the original language on top of the current language #148  (introduce daptm:langSrc) (#148, #173)
30 | 
31 | * Script Event Description should be an object (#174)
32 | 
33 | * Remove Character Style (#124, #162)
34 | 
35 | * Create inline Registry Tables and Registry Definition (#195)
36 | 
37 | * Discuss extensibility and backwards compatible behavior; add section about mapping TTML to the DAPT data model (#110, #214, #234)
38 | 
39 | * Replace workflowType with represents; support within workflowType for generic script origination (#169, #194)
40 | 
41 | * Add nested div feature and mark as permitted, at risk (#237)
42 | 
43 | * Required metadata field for earliest SMPTE time code to allow conversion between DAPT and ESEF (#232)
44 | 
45 | * Remove Script Event Type, use Represents instead (#227)
46 | 
47 | * Defining restrictions per Script Type (#75)
48 | 
49 | * At-risk: support for `src` attribute in `<audio>` for external resource PR-must-have (#218)
50 | 
51 | * At-risk: support for `<source>` element child of `<audio>` for external resource PR-must-have (#219)
52 | 
53 | * At-risk: support for `src` attribute of `<audio>` element pointing to embedded resource PR-must-have (#220)
54 | 
55 | * At-risk: support for `<source>` child of `<audio>` element pointing to embedded resource PR-must-have (#221)
56 | 
57 | * At-risk: support for inline audio resources PR-must-have (#222)
58 | 
59 | * At-risk: each of the potential values of `encoding` in `<data>` PR-must-have (#223)
60 | 
61 | * At-risk: support for the `length` attribute on `<data>` PR-must-have (#224)
62 | 
63 | * At-risk: Script Event Grouping and Script Event Mapping PR-must-have (#239)
64 | 
65 | * Make "Using computed attribute values" normative (#249)
66 | 
67 | From CRS (20250311)
68 | ====================
69 | 
70 | * Rename `#scriptRepresents` to `#scriptRepresents-root` for consistency (#296)
71 | 
72 | * Remove the `#xmlId-div` feature (#297)
73 | 
74 | * Clarify usage of Represents and Script Represents (#262)
75 | 
76 | * Allow Represents to apply to Text (#295)
77 | 
78 | * Replace the `#scriptEventGrouping` extension feature with the TTML1 feature `#nested-div` (#303)
79 | 
80 | * Clarify which elements the `src` attribute can reference using a fragment identifier, and align with TTML2 (#312)
81 | 
82 | * Allow for non-linguistic language codes in `daptm:langSrc` (#320, #321, #330)
83 | 
84 | * Prohibit the use of byte order marks while continuing to require UTF-8 encoding (#329)
85 | 


--------------------------------------------------------------------------------
/schema-validator/poetry.lock:
--------------------------------------------------------------------------------
 1 | # This file is automatically @generated by Poetry 1.7.1 and should not be changed by hand.
 2 | 
 3 | [[package]]
 4 | name = "elementpath"
 5 | version = "4.7.0"
 6 | description = "XPath 1.0/2.0/3.0/3.1 parsers and selectors for ElementTree and lxml"
 7 | optional = false
 8 | python-versions = ">=3.8"
 9 | files = [
10 |     {file = "elementpath-4.7.0-py3-none-any.whl", hash = "sha256:607804a1b4250ac448c1e2bfaec4ee1c980b0a07cfdb0d9057b57102038ed480"},
11 |     {file = "elementpath-4.7.0.tar.gz", hash = "sha256:a2029dc8752fcfec49663d1ed1b412c6daf278c0c91938f50f63c4fe9ed1848e"},
12 | ]
13 | 
14 | [package.extras]
15 | dev = ["Sphinx", "coverage", "flake8", "lxml", "lxml-stubs", "memory-profiler", "memray", "mypy", "tox", "xmlschema (>=3.3.2)"]
16 | 
17 | [[package]]
18 | name = "flake8"
19 | version = "7.1.2"
20 | description = "the modular source code checker: pep8 pyflakes and co"
21 | optional = false
22 | python-versions = ">=3.8.1"
23 | files = [
24 |     {file = "flake8-7.1.2-py2.py3-none-any.whl", hash = "sha256:1cbc62e65536f65e6d754dfe6f1bada7f5cf392d6f5db3c2b85892466c3e7c1a"},
25 |     {file = "flake8-7.1.2.tar.gz", hash = "sha256:c586ffd0b41540951ae41af572e6790dbd49fc12b3aa2541685d253d9bd504bd"},
26 | ]
27 | 
28 | [package.dependencies]
29 | mccabe = ">=0.7.0,<0.8.0"
30 | pycodestyle = ">=2.12.0,<2.13.0"
31 | pyflakes = ">=3.2.0,<3.3.0"
32 | 
33 | [[package]]
34 | name = "mccabe"
35 | version = "0.7.0"
36 | description = "McCabe checker, plugin for flake8"
37 | optional = false
38 | python-versions = ">=3.6"
39 | files = [
40 |     {file = "mccabe-0.7.0-py2.py3-none-any.whl", hash = "sha256:6c2d30ab6be0e4a46919781807b4f0d834ebdd6c6e3dca0bda5a15f863427b6e"},
41 |     {file = "mccabe-0.7.0.tar.gz", hash = "sha256:348e0240c33b60bbdf4e523192ef919f28cb2c3d7d5c7794f74009290f236325"},
42 | ]
43 | 
44 | [[package]]
45 | name = "pycodestyle"
46 | version = "2.12.1"
47 | description = "Python style guide checker"
48 | optional = false
49 | python-versions = ">=3.8"
50 | files = [
51 |     {file = "pycodestyle-2.12.1-py2.py3-none-any.whl", hash = "sha256:46f0fb92069a7c28ab7bb558f05bfc0110dac69a0cd23c61ea0040283a9d78b3"},
52 |     {file = "pycodestyle-2.12.1.tar.gz", hash = "sha256:6838eae08bbce4f6accd5d5572075c63626a15ee3e6f842df996bf62f6d73521"},
53 | ]
54 | 
55 | [[package]]
56 | name = "pyflakes"
57 | version = "3.2.0"
58 | description = "passive checker of Python programs"
59 | optional = false
60 | python-versions = ">=3.8"
61 | files = [
62 |     {file = "pyflakes-3.2.0-py2.py3-none-any.whl", hash = "sha256:84b5be138a2dfbb40689ca07e2152deb896a65c3a3e24c251c5c62489568074a"},
63 |     {file = "pyflakes-3.2.0.tar.gz", hash = "sha256:1c61603ff154621fb2a9172037d84dca3500def8c8b630657d1701f026f8af3f"},
64 | ]
65 | 
66 | [[package]]
67 | name = "xmlschema"
68 | version = "3.4.3"
69 | description = "An XML Schema validator and decoder"
70 | optional = false
71 | python-versions = ">=3.8"
72 | files = [
73 |     {file = "xmlschema-3.4.3-py3-none-any.whl", hash = "sha256:eea4e5a1aac041b546ebe7b2eb68eb5eaebf5c5258e573cfc182375676b2e4e3"},
74 |     {file = "xmlschema-3.4.3.tar.gz", hash = "sha256:0c638dac81c7d6c9da9a8d7544402c48cffe7ee0e13cc47fc0c18794d1395dfb"},
75 | ]
76 | 
77 | [package.dependencies]
78 | elementpath = ">=4.4.0,<5.0.0"
79 | 
80 | [package.extras]
81 | codegen = ["elementpath (>=4.4.0,<5.0.0)", "jinja2"]
82 | dev = ["Sphinx", "coverage", "elementpath (>=4.4.0,<5.0.0)", "flake8", "jinja2", "lxml", "lxml-stubs", "memory-profiler", "mypy", "sphinx-rtd-theme", "tox"]
83 | docs = ["Sphinx", "elementpath (>=4.4.0,<5.0.0)", "jinja2", "sphinx-rtd-theme"]
84 | 
85 | [metadata]
86 | lock-version = "2.0"
87 | python-versions = ">=3.11"
88 | content-hash = "a6d74d71acfdd39d86fa00bb5c576c716bfdfa94dfc9e49ad24ea0e73ccd81fe"
89 | 


--------------------------------------------------------------------------------
/registries/content-descriptor.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "columns": [
 3 |         {
 4 |             "header": "content-descriptor",
 5 |             "isKey": true,
 6 |             "rowKey": "value",
 7 |             "isType": true
 8 |         },
 9 |         {
10 |             "header": "Status",
11 |             "rowKey": "status"
12 |         },
13 |         {
14 |             "header": "Description",
15 |             "rowKey": "description"
16 |         },
17 |         {
18 |             "header": "Example usage",
19 |             "rowKey": "example_usage"
20 |         }
21 |     ],
22 |     "values": [
23 |         {
24 |             "value": "audio",
25 |             "status": "Provisional",
26 |             "description": "Indicates that the DAPT content represents any part of the audio programme.",
27 |             "example_usage": "Dubbing, translation and hard of hearing subtitles and captions, pre- and post- production scripts"
28 |         },
29 |         {
30 |             "value": "audio.dialogue",
31 |             "status": "Provisional",
32 |             "description": "Indicates that the DAPT content represents verbal communication in the audio programme, for example, a spoken conversation.",
33 |             "example_usage": "Dubbing, translation and hard of hearing subtitles and captions, pre- and post- production scripts"
34 |         },
35 |         {
36 |             "value": "audio.nonDialogueSounds",
37 |             "status": "Provisional",
38 |             "description": "Indicates that the DAPT content represents a part of the audio programme corresponding to sounds that are not verbal communication, for example, significant sounds, such as a door being slammed in anger.",
39 |             "example_usage": "Translation and hard of hearing subtitles and captions, pre- and post- production scripts"
40 |         },
41 |         {
42 |             "value": "visual",
43 |             "status": "Provisional",
44 |             "description": "Indicates that the DAPT content represents any part of the visual image of the programme.",
45 |             "example_usage": "Audio Description"
46 |         },
47 |         {
48 |             "value": "visual.dialogue",
49 |             "status": "Provisional",
50 |             "description": "Indicates that the DAPT content represents verbal communication, within the visual image of the programme, for example, a signed conversation.",
51 |             "example_usage": "Dubbing or Audio Description, translation and hard of hearing subtitles and captions, pre- and post- production scripts"
52 |         },
53 |         {
54 |             "value": "visual.nonText",
55 |             "status": "Provisional",
56 |             "description": "Indicates that the DAPT content represents non-textual parts of the visual image of the programme, for example, a significant object in the scene.",
57 |             "example_usage": "Audio Description"
58 |         },
59 |         {
60 |             "value": "visual.text",
61 |             "status": "Provisional",
62 |             "description": "Indicates that the DAPT content represents textual content in the visual image of the programme, for example, a signpost, a clock, a newspaper headline, an instant message etc.",
63 |             "example_usage": "Audio Description"
64 |         },
65 |         {
66 |             "value": "visual.text.title",
67 |             "status": "Provisional",
68 |             "description": "A <a>sub-type</a> of <code>visual.text</code> where the text is the title of the related media.",
69 |             "example_usage": "Audio Description"
70 |         },
71 |         {
72 |             "value": "visual.text.credit",
73 |             "status": "Provisional",
74 |             "description": "A <a>sub-type</a> of <code>visual.text</code> where the text is a credit, e.g. the name of an actor.",
75 |             "example_usage": "Audio Description"
76 |         },
77 |         {
78 |             "value": "visual.text.location",
79 |             "status": "Provisional",
80 |             "description": "A <a>sub-type</a> of <code>visual.text</code> where the text indicates the location where the content is occurring.",
81 |             "example_usage": "Audio Description"
82 |         }
83 |     ]
84 | }


--------------------------------------------------------------------------------
/figures/sources/class-diagram.puml:
--------------------------------------------------------------------------------
  1 | @startuml class-diagram
  2 | !theme plain
  3 | !pragma ratio 1
  4 | ' skinparam groupInheritance 2
  5 | skinparam linetype ortho
  6 | skinparam DefaultFontName sans-serif
  7 | skinparam DefaultFontSize 16
  8 | skinparam ArrowFontSize 13
  9 | skinparam ArrowMessageAlignment direction
 10 | skinparam Padding 4
 11 | skinparam Nodesep 70
 12 | skinparam Ranksep 80
 13 | skinparam MinClassWidth 220
 14 | 
 15 | Class DAPTScript as "**DAPT Script**" [[#dapt-script]] {
 16 |     Script Represents [[[#script-represents]]]
 17 |     Script Type [[[#script-type]]]
 18 |     Default Language [[[#default-language]]]
 19 |     {field} (optional) Text Language Source [[[#text-language-source]]]
 20 | }
 21 | 
 22 | together {
 23 |     Class Character as "**Character**" [[#character]] {
 24 |         Character Identifier [[[#dfn-character-identifier]]]
 25 |         Name [[[#dfn-character-name]]]
 26 |         {field} (optional) Talent Name [[[#dfn-character-talent-name]]]
 27 |     }
 28 | 
 29 |     Class ScriptEvent as "**Script Event**" [[#script-event]] {
 30 |         Script Event Identifier [[[#dfn-script-event-identifier]]]
 31 |         {field} Represents [[[#represents]]]
 32 |         {field} {abstract} (optional) Begin [[[#dfn-begin]]]
 33 |         {field} {abstract} (optional) End [[[#dfn-end]]]
 34 |         {field} {abstract} (optional) Duration [[[#dfn-duration]]]
 35 |         {field} (optional) On Screen [[[#on-screen]]]
 36 |     }
 37 | 
 38 |     Class ScriptEventDescription as "**Script Event Description**" [[#dfn-script-event-description]] {
 39 |         {field} Description
 40 |         {field} (optional) Description Type [[[#dfn-description-type]]]
 41 |         {field} (optional) Language
 42 |     }
 43 | 
 44 |     Class Text as "**Text**" [[#text]] {
 45 |         Text content [[[#dfn-text]]]
 46 |         {field} (optional) Text Language Source [[[#text-language-source]]]
 47 |         {field} (optional) Language
 48 |         {field} (optional) Represents [[[#represents]]]
 49 |         ' {field} (optional) Inline Style Attributes
 50 |     }
 51 | }
 52 | 
 53 | together {
 54 |     abstract Class Audio as "**Audio**" [[#dfn-audio]] {
 55 |     }
 56 | 
 57 |     Class SynthesizedAudio as "**Synthesized Audio**" [[#dfn-synthesized-audio]] {
 58 |         Rate [[[#dfn-rate]]]
 59 |         {field} (optional) Pitch [[[#dfn-pitch]]]
 60 |     }
 61 | 
 62 |     Class AudioRecording as "**Audio Recording**" [[#dfn-audio-recording]] {
 63 |         Source [ ] [[[#dfn-source]]]
 64 |         Type [ ] [[[#dfn-type]]]
 65 |         {field} {abstract} (optional) Begin [[[#dfn-begin]]]
 66 |         {field} {abstract} (optional) End [[[#dfn-end]]]
 67 |         {field} {abstract} (optional) Duration [[[#dfn-duration]]]
 68 |         {field} (optional) In Time [[[#dfn-in-time]]]
 69 |         {field} (optional) Out Time [[[#dfn-out-time]]]
 70 |     }
 71 | 
 72 | }
 73 | 
 74 | class MixingInstruction as "**Mixing Instruction**" [[#dfn-mixing-instruction]] {
 75 |     {field} (optional) Gain [[[#dfn-gain]]]
 76 |     {field} (optional) Pan [[[#dfn-pan]]]
 77 |     {field} {abstract} (optional) Begin [[[#dfn-begin]]]
 78 |     {field} {abstract} (optional) End [[[#dfn-end]]]
 79 |     {field} {abstract} (optional) Duration [[[#dfn-duration]]]
 80 |     {field} (optional) Fill [[[#dfn-fill]]]
 81 | }
 82 | 
 83 | ' MixingInstruction -[hidden]r-AudioRecording
 84 | 
 85 | 
 86 | DAPTScript *-down- "0..* " ScriptEvent : contains\n >
 87 | DAPTScript *-- "0..*" Character : contains >
 88 | ScriptEvent *-down- "0..*" MixingInstruction : contains\n >
 89 | Text *-left- "0..* " Audio : contains\n <
 90 | Text *-- "0..* " MixingInstruction : contains\n >
 91 | Character "0..*" <.right. "0..*" ScriptEvent
 92 | ScriptEvent *-left- "0..*" ScriptEventDescription : contains\n <
 93 | ScriptEvent *-down- "0..*" Text : contains\n >
 94 | AudioRecording *-- "0..* " MixingInstruction : contains >
 95 | Audio <|-down- SynthesizedAudio : is\n <
 96 | Audio <|-down- AudioRecording : is\n <
 97 | 
 98 | SynthesizedAudio -[hidden]r- AudioRecording
 99 | 
100 | ' Hidden links to persuade the layout to look nicer
101 | ' MixingInstruction -[hidden]left- Text
102 | ' Text -[hidden]down- Audio
103 | AudioRecording -[hidden]left- SynthesizedAudio
104 | Audio -[hidden]left- MixingInstruction
105 | ' ScriptEventDescription -[hidden]down- MixingInstruction
106 | 
107 | hide empty members
108 | hide circle
109 | @enduml


--------------------------------------------------------------------------------
/xml-schemas/ttml2-parameter-items.xsd:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#parameter"
 3 |   xml:lang="en" xmlns:xs="http://www.w3.org/2001/XMLSchema"
 4 |   xmlns:tt="http://www.w3.org/ns/ttml"
 5 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
 6 |   xmlns:ttp="http://www.w3.org/ns/ttml#parameter">
 7 |   <xs:import namespace="http://www.w3.org/XML/1998/namespace"
 8 |     schemaLocation="xml.xsd"/>
 9 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
10 |     schemaLocation="ttml2-datatypes.xsd"/>
11 |   <xs:import namespace="http://www.w3.org/ns/ttml"
12 |     schemaLocation="ttml2-core-attribs.xsd"/>
13 |   <xs:include schemaLocation="ttml2-parameter-attribs.xsd"/>
14 |   <xs:attributeGroup name="profile.attlist">
15 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
16 |     <xs:attribute name="combine" type="ttd:profileCombination"/>
17 |     <xs:attribute name="designator" type="ttd:profile"/>
18 |     <xs:attribute name="type" type="ttd:profileType"/>
19 |     <xs:attribute name="use" type="ttd:profile"/>
20 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
21 |   </xs:attributeGroup>
22 |   <xs:attributeGroup name="features.attlist">
23 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
24 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
25 |   </xs:attributeGroup>
26 |   <xs:attributeGroup name="feature.attlist">
27 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
28 |     <xs:attribute name="extends" type="ttd:extends"/>
29 |     <xs:attribute name="restricts" type="ttd:restricts"/>
30 |     <xs:attribute name="value" type="ttd:featureValue"/>
31 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
32 |   </xs:attributeGroup>
33 |   <xs:attributeGroup name="extensions.attlist">
34 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
35 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
36 |   </xs:attributeGroup>
37 |   <xs:attributeGroup name="extension.attlist">
38 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
39 |     <xs:attribute name="extends" type="ttd:extends"/>
40 |     <xs:attribute name="restricts" type="ttd:restricts"/>
41 |     <xs:attribute name="value" type="ttd:extensionValue"/>
42 |     <xs:anyAttribute namespace="##other" processContents="lax"/>
43 |   </xs:attributeGroup>
44 |   <xs:complexType name="profile.eltype">
45 |     <xs:sequence>
46 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
47 |       <xs:choice>
48 |         <xs:sequence>
49 |           <xs:element ref="ttp:features" minOccurs="0" maxOccurs="unbounded"/>
50 |           <xs:element ref="ttp:extensions" minOccurs="0" maxOccurs="unbounded"/>
51 |         </xs:sequence>
52 |         <xs:sequence>
53 |           <xs:element ref="ttp:profile" minOccurs="0" maxOccurs="unbounded"/>
54 |         </xs:sequence>
55 |       </xs:choice>
56 |     </xs:sequence>
57 |     <xs:attributeGroup ref="ttp:profile.attlist"/>
58 |   </xs:complexType>
59 |   <xs:complexType name="features.eltype">
60 |     <xs:sequence>
61 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
62 |       <xs:element ref="ttp:feature" minOccurs="0" maxOccurs="unbounded"/>
63 |     </xs:sequence>
64 |     <xs:attributeGroup ref="ttp:features.attlist"/>
65 |   </xs:complexType>
66 |   <xs:complexType name="feature.eltype">
67 |     <xs:simpleContent>
68 |       <xs:extension base="ttd:featureDesignator">
69 |         <xs:attributeGroup ref="ttp:feature.attlist"/>
70 |       </xs:extension>
71 |     </xs:simpleContent>
72 |   </xs:complexType>
73 |   <xs:complexType name="extensions.eltype">
74 |     <xs:sequence>
75 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
76 |       <xs:element ref="ttp:extension" minOccurs="0" maxOccurs="unbounded"/>
77 |     </xs:sequence>
78 |     <xs:attributeGroup ref="ttp:extensions.attlist"/>
79 |   </xs:complexType>
80 |   <xs:complexType name="extension.eltype">
81 |     <xs:simpleContent>
82 |       <xs:extension base="ttd:extensionDesignator">
83 |         <xs:attributeGroup ref="ttp:extension.attlist"/>
84 |       </xs:extension>
85 |     </xs:simpleContent>
86 |   </xs:complexType>
87 |   <xs:element name="profile" type="ttp:profile.eltype"/>
88 |   <xs:element name="features" type="ttp:features.eltype"/>
89 |   <xs:element name="feature" type="ttp:feature.eltype"/>
90 |   <xs:element name="extensions" type="ttp:extensions.eltype"/>
91 |   <xs:element name="extension" type="ttp:extension.eltype"/>
92 |   <xs:group name="ParameterItems.class">
93 |     <xs:choice>
94 |       <xs:element ref="ttp:profile"/>
95 |     </xs:choice>
96 |   </xs:group>
97 | </xs:schema>
98 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-metadata-items.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#metadata" elementFormDefault="qualified"
  3 |   xml:lang="en" xmlns:xs="http://www.w3.org/2001/XMLSchema"
  4 |   xmlns:xml="http://www.w3.org/XML/1998/namespace"
  5 |   xmlns:tt="http://www.w3.org/ns/ttml"
  6 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
  7 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
  8 |   xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata">
  9 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
 10 |     schemaLocation="ttml2-datatypes.xsd"/>
 11 |   <xs:import namespace="http://www.w3.org/ns/ttml"
 12 |     schemaLocation="ttml2-core-attribs.xsd"/>
 13 |   <xs:import namespace="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 14 |     schemaLocation="dapt-metadata.xsd"/>
 15 |   <xs:import namespace="http://www.w3.org/XML/1998/namespace"
 16 |     schemaLocation="xml.xsd"/>
 17 |   <xs:include schemaLocation="ttml2-metadata-attribs.xsd"/>
 18 |   <xs:attributeGroup name="actor.attlist">
 19 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 20 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 21 |     <xs:attribute name="agent" type="xs:IDREF" use="required"/>
 22 |   </xs:attributeGroup>
 23 |   <xs:attributeGroup name="agent.attlist">
 24 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 25 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 26 |     <xs:attribute name="type" type="ttd:metadataAgentType" use="required"/>
 27 |   </xs:attributeGroup>
 28 |   <xs:attributeGroup name="copyright.attlist">
 29 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 30 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 31 |   </xs:attributeGroup>
 32 |   <xs:attributeGroup name="desc.attlist">
 33 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 34 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 35 |     <xs:attribute ref="daptm:descType"/>
 36 |   </xs:attributeGroup>
 37 |   <xs:attributeGroup name="item.attlist">
 38 |     <xs:attribute name="name" type="ttd:metadataItemName" use="required"/>
 39 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 40 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 41 |   </xs:attributeGroup>
 42 |   <xs:attributeGroup name="name.attlist">
 43 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 44 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 45 |     <xs:attribute name="type" type="ttd:metadataNameType" use="required"/>
 46 |   </xs:attributeGroup>
 47 |   <xs:attributeGroup name="title.attlist">
 48 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 49 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 50 |   </xs:attributeGroup>
 51 |   <xs:complexType name="actor.eltype">
 52 |     <xs:attributeGroup ref="ttm:actor.attlist"/>
 53 |   </xs:complexType>
 54 |   <xs:complexType name="agent.eltype">
 55 |     <xs:sequence>
 56 |       <xs:element ref="ttm:name" minOccurs="0" maxOccurs="unbounded"/>
 57 |       <xs:element ref="ttm:actor" minOccurs="0" maxOccurs="1"/>
 58 |     </xs:sequence>
 59 |     <xs:attributeGroup ref="ttm:agent.attlist"/>
 60 |   </xs:complexType>
 61 |   <xs:complexType name="dapt_agent.eltype">
 62 |     <xs:complexContent>
 63 |       <xs:restriction base="ttm:agent.eltype">
 64 |         <xs:sequence>
 65 |           <xs:element ref="ttm:name" minOccurs="1" maxOccurs="unbounded"/>
 66 |           <xs:element ref="ttm:actor" minOccurs="0" maxOccurs="1"/>
 67 |         </xs:sequence>
 68 |         <xs:attribute ref="xml:id" use="required"/>
 69 |       </xs:restriction>
 70 |     </xs:complexContent>
 71 |   </xs:complexType>
 72 |   <xs:complexType name="copyright.eltype" mixed="true">
 73 |     <xs:attributeGroup ref="ttm:copyright.attlist"/>
 74 |   </xs:complexType>
 75 |   <xs:complexType name="desc.eltype" mixed="true">
 76 |     <xs:attributeGroup ref="ttm:desc.attlist"/>
 77 |   </xs:complexType>
 78 |   <xs:complexType name="item.eltype" mixed="true">
 79 |     <xs:sequence>
 80 |       <xs:element ref="ttm:item" minOccurs="0" maxOccurs="unbounded"/>
 81 |     </xs:sequence>
 82 |     <xs:attributeGroup ref="ttm:item.attlist"/>
 83 |   </xs:complexType>
 84 |   <xs:complexType name="name.eltype" mixed="true">
 85 |     <xs:attributeGroup ref="ttm:name.attlist"/>
 86 |   </xs:complexType>
 87 |   <xs:complexType name="title.eltype" mixed="true">
 88 |     <xs:attributeGroup ref="ttm:title.attlist"/>
 89 |   </xs:complexType>
 90 |   <xs:element name="actor" type="ttm:actor.eltype"/>
 91 |   <xs:element name="agent" type="ttm:dapt_agent.eltype"/>
 92 |   <xs:element name="copyright" type="ttm:copyright.eltype"/>
 93 |   <xs:element name="desc" type="ttm:desc.eltype"/>
 94 |   <xs:element name="item" type="ttm:item.eltype"/>
 95 |   <xs:element name="name" type="ttm:name.eltype"/>
 96 |   <xs:element name="title" type="ttm:title.eltype"/>
 97 |   <xs:group name="MetadataItems.class">
 98 |     <xs:choice>
 99 |       <xs:element ref="ttm:agent"/>
100 |       <xs:element ref="ttm:copyright"/>
101 |       <xs:element ref="ttm:desc"/>
102 |       <xs:element ref="ttm:item"/>
103 |       <xs:element ref="ttm:title"/>
104 |     </xs:choice>
105 |   </xs:group>
106 | </xs:schema>
107 | 


--------------------------------------------------------------------------------
/schema-validator/src/validate.py:
--------------------------------------------------------------------------------
  1 | import os
  2 | import sys
  3 | import argparse
  4 | import xmlschema
  5 | import xml.etree.ElementTree as ElementTree
  6 | from xml.etree.ElementTree import Element as Element
  7 | import logging
  8 | 
  9 | logging.getLogger().setLevel(logging.INFO)
 10 | 
 11 | 
 12 | schema_path = os.path.normpath(
 13 |     os.path.join(
 14 |         os.path.dirname(__file__),
 15 |         '../../xml-schemas/dapt.xsd')
 16 | )
 17 | metadata_items_schema_path = os.path.normpath(
 18 |     os.path.join(
 19 |         os.path.dirname(__file__),
 20 |         '../../xml-schemas/ttml2-metadata-items.xsd')
 21 | )
 22 | 
 23 | recognised_namespaces = set([
 24 |     'http://www.w3.org/XML/1998/namespace', # xml
 25 |     'http://www.w3.org/ns/ttml', # tt
 26 |     'http://www.w3.org/ns/ttml#parameter', # ttp
 27 |     'http://www.w3.org/ns/ttml#audio', # tta
 28 |     'http://www.w3.org/ns/ttml#metadata', # ttm
 29 |     'http://www.w3.org/ns/ttml/feature/',
 30 |     'http://www.w3.org/ns/ttml/profile/dapt#metadata', # daptm
 31 |     'http://www.w3.org/ns/ttml/profile/dapt/extension/',
 32 |     'urn:ebu:tt:metadata', # ebuttm
 33 | ])
 34 | 
 35 | # We will not prune attributes in no namespace if they are
 36 | # defined on any element in TTML or DAPT, even if they are
 37 | # not defined on the specific element on which they occur.
 38 | known_no_ns_attributes = set([
 39 |     'agent',
 40 |     'animate',
 41 |     'begin',
 42 |     'calcMode',
 43 |     'clipBegin',
 44 |     'clipEnd',
 45 |     'condition',
 46 |     'dur',
 47 |     'encoding',
 48 |     'end',
 49 |     'family',
 50 |     'fill',
 51 |     'format',
 52 |     'keySplines',
 53 |     'keyTimes',
 54 |     'length',
 55 |     'name',
 56 |     'range',
 57 |     'region',
 58 |     'repeatCount',
 59 |     'src',
 60 |     'style',
 61 |     'timeContainer',
 62 |     'type',
 63 |     'weight',
 64 | ])
 65 | 
 66 | 
 67 | def get_namespace(tag: str) -> str:
 68 |     if (len(tag) == 0 or tag[0] != '{'):
 69 |         return ''
 70 | 
 71 |     if '}' not in tag:
 72 |         raise ValueError('No closing brace found')
 73 | 
 74 |     return tag.split('{', 1)[1].split('}', 1)[0]
 75 | 
 76 | 
 77 | def get_unqualified_name(tag: str) -> str:
 78 |     if '}' not in tag:
 79 |         return tag
 80 | 
 81 |     return tag.split('}', 1)[1]
 82 | 
 83 | 
 84 | def prune_unrecognised_vocabulary(el: Element):
 85 |     to_remove = []
 86 |     for child in el:
 87 |         if get_namespace(child.tag) not in recognised_namespaces:
 88 |             logging.debug('pruning element {}'.format(child.tag))
 89 |             to_remove.append(child)
 90 |         else:
 91 |             prune_unrecognised_vocabulary(child)
 92 | 
 93 |     for e in to_remove:
 94 |         el.remove(e)
 95 | 
 96 |     for attr_key in el.keys():
 97 |         attr_ns = get_namespace(attr_key)
 98 | 
 99 |         attr_name = get_unqualified_name(attr_key)
100 |         if (attr_ns and attr_ns not in recognised_namespaces) \
101 |            or \
102 |            (not attr_ns and attr_name not in known_no_ns_attributes):
103 |             logging.debug('pruning {}@{}'.format(el.tag, attr_key))
104 |             el.attrib.pop(attr_key)
105 | 
106 |     return el
107 | 
108 | 
109 | def validate_dapt(args):
110 |     # xmlschema gets baffled following the import of metadata_items,
111 |     # so make it load it explicitly instead, which seems to work.
112 |     schema_paths = [schema_path, metadata_items_schema_path]
113 |     logging.info('Creating schema from XSDs at {}'.format(schema_paths))
114 |     schema = xmlschema.XMLSchema(schema_paths)
115 |     schema.build()
116 |     if schema.validity:
117 |         logging.info('Schemas are valid')
118 |     else:
119 |         logging.error('Schemas are not valid, exiting early')
120 |         return -1
121 | 
122 |     try:
123 |         logging.info('Validating document at {}'.format(args.dapt_in.name))
124 |         dapt_in_bytes = args.dapt_in.read()
125 |         in_xml_str = str(dapt_in_bytes, encoding='utf-8', errors='strict')
126 |         root = ElementTree.fromstring(in_xml_str)
127 | 
128 |         if not args.noprune:
129 |             logging.info('Pruning unrecognised vocabulary')
130 |             prune_unrecognised_vocabulary(el=root)
131 |         schema.validate(source=root)
132 |     except xmlschema.XMLSchemaValidationError as valex:
133 |         logging.error(str(valex))
134 |         logging.error(
135 |             'Document is not valid {} pruning unrecognised vocabulary.'.format(
136 |                 'before' if args.noprune else 'after'
137 |             ))
138 |         return -1
139 | 
140 |     logging.info(
141 |         'Document is syntactically valid with respect to the '
142 |         'DAPT XML Schema Definition{}; '
143 |         'this does not check all semantic requirements of the '
144 |         'DAPT specification.'.format(
145 |             '' if args.noprune else ' after pruning unrecognised vocabulary'
146 |         ))
147 |     return 0
148 | 
149 | 
150 | def main():
151 |     parser = argparse.ArgumentParser()
152 | 
153 |     parser.add_argument(
154 |         '-dapt_in',
155 |         type=argparse.FileType('rb'),
156 |         default=sys.stdin,
157 |         nargs='?',
158 |         action='store',
159 |         help='Input DAPT file to validate')
160 |     parser.add_argument(
161 |         '-noprune',
162 |         default=False,
163 |         required=False,
164 |         action='store_true',
165 |         help='If set, attempts to validate without '
166 |              'pruning unrecognised vocabulary.')
167 |     parser.set_defaults(func=validate_dapt)
168 | 
169 |     args = parser.parse_args()
170 |     return args.func(args)
171 | 
172 | 
173 | if __name__ == "__main__":
174 |     # execute only if run as a script
175 |     sys.exit(main())
176 | 


--------------------------------------------------------------------------------
/profiles/dapt-processor-profile.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <!-- this file defines the "dapt-processor" profile of ttml -->
  3 | <profile xmlns="http://www.w3.org/ns/ttml#parameter"
  4 |   designator="http://www.w3.org/ns/ttml/profile/dapt1.0/processor"
  5 |   combine="mostRestrictive"
  6 |   type="processor">
  7 |   <features xml:base="http://www.w3.org/ns/ttml/feature/">
  8 |     <!-- required (mandatory) feature support -->
  9 |     <feature value="required">#animate-fill</feature>
 10 |     <feature value="required">#animate-minimal</feature>
 11 |     <feature value="required">#audio</feature>
 12 |     <feature value="required">#audio-description</feature>
 13 |     <feature value="required">#audio-speech</feature>
 14 |     <feature value="required">#bidi</feature>
 15 |     <feature value="required" extends="#bidi">#bidi-version-2</feature>
 16 |     <feature value="required">#chunk</feature>
 17 |     <feature value="required">#content</feature>
 18 |     <feature value="required">#contentProfiles</feature>
 19 |     <feature value="required">#core</feature>
 20 |     <feature value="required">#data</feature>
 21 |     <feature value="required">#direction</feature>
 22 |     <feature value="required">#embedded-audio</feature>
 23 |     <feature value="required">#embedded-data</feature>
 24 |     <feature value="required">#frameRate</feature>
 25 |     <feature value="required">#frameRateMultiplier</feature>
 26 |     <feature value="required">#gain</feature>
 27 |     <feature value="required">#metadata</feature>
 28 |     <feature value="required">#metadata-item</feature>
 29 |     <feature value="required">#nested-div</feature>
 30 |     <feature value="required" extends="#metadata">#metadata-version-2</feature>
 31 |     <feature value="required">#pan</feature>
 32 |     <feature value="required">#pitch</feature>
 33 |     <feature value="required">#presentation-audio</feature>
 34 |     <feature value="required">#resources</feature>
 35 |     <feature value="required" extends="#animation">#set</feature>
 36 |     <feature value="required">#set-fill</feature>
 37 |     <feature value="required">#set-multiple-styles</feature>
 38 |     <feature value="required">#source</feature>
 39 |     <feature value="required">#speak</feature>
 40 |     <feature value="required">#speech</feature>
 41 |     <feature value="required">#structure</feature>
 42 |     <feature value="required">#styling</feature>
 43 |     <feature value="required">#styling-chained</feature>
 44 |     <feature value="required">#styling-inheritance-content</feature>
 45 |     <feature value="required">#styling-inline</feature>
 46 |     <feature value="required">#styling-referential</feature>
 47 |     <feature value="required">#tickRate</feature>
 48 |     <feature value="required">#time-clock</feature>
 49 |     <feature value="required">#time-offset</feature>
 50 |     <feature value="required">#time-offset-with-frames</feature>
 51 |     <feature value="required">#time-offset-with-ticks</feature>
 52 |     <feature value="required">#timeBase-media</feature>
 53 |     <feature value="required">#timing</feature>
 54 |     <feature value="required">#transformation</feature>
 55 |     <feature value="required">#unicodeBidi</feature>
 56 |     <feature value="required">#unicodeBidi-isolate</feature>
 57 |     <feature value="required" extends="#unicodeBidi">#unicodeBidi-version-2</feature>
 58 |     <feature value="required">#xlink</feature>
 59 |     <!-- optional (voluntary) feature support -->
 60 |     <feature value="optional">#animation-out-of-line</feature>
 61 |     <feature value="optional">#clockMode</feature>
 62 |     <feature value="optional">#clockMode-gps</feature>
 63 |     <feature value="optional">#clockMode-local</feature>
 64 |     <feature value="optional">#clockMode-utc</feature>
 65 |     <feature value="optional">#contentProfiles-combined</feature>
 66 |     <feature value="optional">#dropMode</feature>
 67 |     <feature value="optional">#dropMode-dropNTSC</feature>
 68 |     <feature value="optional">#dropMode-dropPAL</feature>
 69 |     <feature value="optional">#dropMode-nonDrop</feature>
 70 |     <feature value="optional">#markerMode</feature>
 71 |     <feature value="optional">#markerMode-continuous</feature>
 72 |     <feature value="optional">#markerMode-discontinuous</feature>
 73 |     <feature value="optional">#permitFeatureNarrowing</feature>
 74 |     <feature value="optional">#permitFeatureWidening</feature>
 75 |     <feature value="optional">#processorProfiles</feature>
 76 |     <feature value="optional">#processorProfiles-combined</feature>
 77 |     <feature value="optional">#subFrameRate</feature>
 78 |     <feature value="optional">#time-clock-with-frames</feature>
 79 |     <feature value="optional">#time-wall-clock</feature>
 80 |     <feature value="optional">#timeBase-clock</feature>
 81 |     <feature value="optional">#timeBase-smpte</feature>
 82 |     <feature value="optional">#timeContainer</feature>
 83 |   </features>
 84 |   <extensions xml:base="http://www.w3.org/ns/ttml/profile/dapt/extension/">
 85 |     <!-- required (mandatory) extension support -->
 86 |     <extension value="required">#agent</extension>
 87 |     <extension value="required">#contentProfiles-root</extension>
 88 |     <extension value="required">#daptOriginTimecode</extension>
 89 |     <extension value="required">#descType</extension>
 90 |     <extension value="required">#onScreen</extension>
 91 |     <extension value="required">#represents</extension>
 92 |     <extension value="required">#scriptRepresents-root</extension>
 93 |     <extension value="required">#scriptType-root</extension>
 94 |     <extension value="required">#serialization</extension>
 95 |     <extension value="required">#textLanguageSource</extension>
 96 |     <extension value="required">#xmlLang-root</extension>
 97 |     <!-- optional (voluntary) extension support -->
 98 |     <extension value="optional">#profile-root</extension>
 99 |     <extension value="optional">#scriptEventMapping</extension>
100 |     <extension value="optional">#source-data</extension>
101 |     <extension value="optional">#xmlLang-audio-nonMatching</extension>
102 | </extensions>
103 | </profile>
104 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-styling-attribs.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#styling" xml:lang="en"
  3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
  4 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
  5 |   xmlns:tts="http://www.w3.org/ns/ttml#styling">
  6 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
  7 |     schemaLocation="ttml2-datatypes.xsd"/>
  8 |   <xs:attribute name="backgroundClip" type="ttd:areaRectangle"/>
  9 |   <xs:attribute name="backgroundColor" type="ttd:color"/>
 10 |   <xs:attribute name="backgroundExtent" type="ttd:extent"/>
 11 |   <xs:attribute name="backgroundImage" type="ttd:backgroundImage"/>
 12 |   <xs:attribute name="backgroundOrigin" type="ttd:areaRectangle"/>
 13 |   <xs:attribute name="backgroundPosition" type="ttd:position"/>
 14 |   <xs:attribute name="backgroundRepeat" type="ttd:backgroundRepeat"/>
 15 |   <xs:attribute name="border" type="ttd:border"/>
 16 |   <xs:attribute name="bpd" type="ttd:measure"/>
 17 |   <xs:attribute name="color" type="ttd:color"/>
 18 |   <xs:attribute name="direction" type="ttd:direction"/>
 19 |   <xs:attribute name="disparity" type="ttd:disparity"/>
 20 |   <xs:attribute name="display" type="ttd:display"/>
 21 |   <xs:attribute name="displayAlign" type="ttd:displayAlign"/>
 22 |   <xs:attribute name="extent" type="ttd:extent"/>
 23 |   <xs:attribute name="fontFamily" type="ttd:fontFamily"/>
 24 |   <xs:attribute name="fontKerning" type="ttd:fontKerning"/>
 25 |   <xs:attribute name="fontSelectionStrategy" type="ttd:fontSelectionStrategy"/>
 26 |   <xs:attribute name="fontShear" type="ttd:shear"/>
 27 |   <xs:attribute name="fontSize" type="ttd:fontSize"/>
 28 |   <xs:attribute name="fontStyle" type="ttd:fontStyle"/>
 29 |   <xs:attribute name="fontVariant" type="ttd:fontVariant"/>
 30 |   <xs:attribute name="fontWeight" type="ttd:fontWeight"/>
 31 |   <xs:attribute name="ipd" type="ttd:measure"/>
 32 |   <xs:attribute name="letterSpacing" type="ttd:letterSpacing"/>
 33 |   <xs:attribute name="lineHeight" type="ttd:lineHeight"/>
 34 |   <xs:attribute name="lineShear" type="ttd:shear"/>
 35 |   <xs:attribute name="luminanceGain" type="ttd:luminanceGain"/>
 36 |   <xs:attribute name="opacity" type="ttd:opacity"/>
 37 |   <xs:attribute name="origin" type="ttd:origin"/>
 38 |   <xs:attribute name="overflow" type="ttd:overflow"/>
 39 |   <xs:attribute name="padding" type="ttd:padding"/>
 40 |   <xs:attribute name="position" type="ttd:position"/>
 41 |   <xs:attribute name="ruby" type="ttd:ruby"/>
 42 |   <xs:attribute name="rubyAlign" type="ttd:rubyAlign"/>
 43 |   <xs:attribute name="rubyPosition" type="ttd:rubyPosition"/>
 44 |   <xs:attribute name="rubyReserve" type="ttd:rubyReserve"/>
 45 |   <xs:attribute name="script" type="ttd:script"/>
 46 |   <xs:attribute name="shear" type="ttd:shear"/>
 47 |   <xs:attribute name="showBackground" type="ttd:showBackground"/>
 48 |   <xs:attribute name="textAlign" type="ttd:textAlign"/>
 49 |   <xs:attribute name="textCombine" type="ttd:textCombine"/>
 50 |   <xs:attribute name="textDecoration" type="ttd:textDecoration"/>
 51 |   <xs:attribute name="textEmphasis" type="ttd:textEmphasis"/>
 52 |   <xs:attribute name="textOrientation" type="ttd:textOrientation"/>
 53 |   <xs:attribute name="textOutline" type="ttd:textOutline"/>
 54 |   <xs:attribute name="textShadow" type="ttd:textShadow"/>
 55 |   <xs:attribute name="unicodeBidi" type="ttd:unicodeBidi"/>
 56 |   <xs:attribute name="visibility" type="ttd:visibility"/>
 57 |   <xs:attribute name="wrapOption" type="ttd:wrapOption"/>
 58 |   <xs:attribute name="writingMode" type="ttd:writingMode"/>
 59 |   <xs:attribute name="zIndex" type="ttd:zIndex"/>
 60 |   <xs:attributeGroup name="Styling.attrib.class">
 61 |     <xs:attribute ref="tts:backgroundClip"/>
 62 |     <xs:attribute ref="tts:backgroundColor"/>
 63 |     <xs:attribute ref="tts:backgroundExtent"/>
 64 |     <xs:attribute ref="tts:backgroundImage"/>
 65 |     <xs:attribute ref="tts:backgroundOrigin"/>
 66 |     <xs:attribute ref="tts:backgroundPosition"/>
 67 |     <xs:attribute ref="tts:backgroundRepeat"/>
 68 |     <xs:attribute ref="tts:border"/>
 69 |     <xs:attribute ref="tts:bpd"/>
 70 |     <xs:attribute ref="tts:color"/>
 71 |     <xs:attribute ref="tts:direction"/>
 72 |     <xs:attribute ref="tts:disparity"/>
 73 |     <xs:attribute ref="tts:display"/>
 74 |     <xs:attribute ref="tts:displayAlign"/>
 75 |     <xs:attribute ref="tts:extent"/>
 76 |     <xs:attribute ref="tts:fontFamily"/>
 77 |     <xs:attribute ref="tts:fontKerning"/>
 78 |     <xs:attribute ref="tts:fontSelectionStrategy"/>
 79 |     <xs:attribute ref="tts:fontShear"/>
 80 |     <xs:attribute ref="tts:fontSize"/>
 81 |     <xs:attribute ref="tts:fontStyle"/>
 82 |     <xs:attribute ref="tts:fontVariant"/>
 83 |     <xs:attribute ref="tts:fontWeight"/>
 84 |     <xs:attribute ref="tts:ipd"/>
 85 |     <xs:attribute ref="tts:letterSpacing"/>
 86 |     <xs:attribute ref="tts:lineHeight"/>
 87 |     <xs:attribute ref="tts:lineShear"/>
 88 |     <xs:attribute ref="tts:luminanceGain"/>
 89 |     <xs:attribute ref="tts:opacity"/>
 90 |     <xs:attribute ref="tts:origin"/>
 91 |     <xs:attribute ref="tts:overflow"/>
 92 |     <xs:attribute ref="tts:padding"/>
 93 |     <xs:attribute ref="tts:position"/>
 94 |     <xs:attribute ref="tts:ruby"/>
 95 |     <xs:attribute ref="tts:rubyAlign"/>
 96 |     <xs:attribute ref="tts:rubyPosition"/>
 97 |     <xs:attribute ref="tts:rubyReserve"/>
 98 |     <xs:attribute ref="tts:script"/>
 99 |     <xs:attribute ref="tts:shear"/>
100 |     <xs:attribute ref="tts:showBackground"/>
101 |     <xs:attribute ref="tts:textAlign"/>
102 |     <xs:attribute ref="tts:textCombine"/>
103 |     <xs:attribute ref="tts:textDecoration"/>
104 |     <xs:attribute ref="tts:textEmphasis"/>
105 |     <xs:attribute ref="tts:textOrientation"/>
106 |     <xs:attribute ref="tts:textOutline"/>
107 |     <xs:attribute ref="tts:textShadow"/>
108 |     <xs:attribute ref="tts:unicodeBidi"/>
109 |     <xs:attribute ref="tts:visibility"/>
110 |     <xs:attribute ref="tts:wrapOption"/>
111 |     <xs:attribute ref="tts:writingMode"/>
112 |     <xs:attribute ref="tts:zIndex"/>
113 |   </xs:attributeGroup>
114 | </xs:schema>
115 | 


--------------------------------------------------------------------------------
/profiles/dapt-content-profile.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <!-- this file defines the "dapt-content" profile of ttml -->
  3 | <profile xmlns="http://www.w3.org/ns/ttml#parameter"
  4 |   designator="http://www.w3.org/ns/ttml/profile/dapt1.0/content"
  5 |   combine="mostRestrictive"
  6 |   type="content">
  7 |   <features xml:base="http://www.w3.org/ns/ttml/feature/">
  8 |     <!-- required (mandatory) feature support -->
  9 |     <feature value="required">#structure</feature>
 10 |     <feature value="required">#timeBase-media</feature>
 11 |     <!-- optional (voluntary) feature support -->
 12 |     <feature value="optional">#animate-fill</feature>
 13 |     <feature value="optional">#animate-minimal</feature>
 14 |     <feature value="optional">#audio</feature>
 15 |     <feature value="optional">#audio-description</feature>
 16 |     <feature value="optional">#audio-speech</feature>
 17 |     <feature value="optional">#bidi</feature>
 18 |     <feature value="optional" extends="#bidi">#bidi-version-2</feature>
 19 |     <feature value="optional">#chunk</feature>
 20 |     <feature value="optional">#content</feature>
 21 |     <feature value="optional">#contentProfiles</feature>
 22 |     <feature value="optional">#contentProfiles-combined</feature>
 23 |     <feature value="optional">#core</feature>
 24 |     <feature value="optional">#data</feature>
 25 |     <feature value="optional">#direction</feature>
 26 |     <feature value="optional">#embedded-audio</feature>
 27 |     <feature value="optional">#embedded-data</feature>
 28 |     <feature value="optional">#frameRate</feature>
 29 |     <feature value="optional">#frameRateMultiplier</feature>
 30 |     <feature value="optional">#gain</feature>
 31 |     <feature value="optional">#metadata</feature>
 32 |     <feature value="optional">#metadata-item</feature>
 33 |     <feature value="optional">#nested-div</feature>
 34 |     <feature value="optional" extends="#metadata">#metadata-version-2</feature>
 35 |     <feature value="optional">#pan</feature>
 36 |     <feature value="optional">#permitFeatureNarrowing</feature>
 37 |     <feature value="optional">#permitFeatureWidening</feature>
 38 |     <feature value="optional">#pitch</feature>
 39 |     <feature value="optional">#presentation-audio</feature>
 40 |     <feature value="optional">#processorProfiles</feature>
 41 |     <feature value="optional">#processorProfiles-combined</feature>
 42 |     <feature value="optional">#resources</feature>
 43 |     <feature value="optional" extends="#animation">#set</feature>
 44 |     <feature value="optional">#set-fill</feature>
 45 |     <feature value="optional">#set-multiple-styles</feature>
 46 |     <feature value="optional">#source</feature>
 47 |     <feature value="optional">#speak</feature>
 48 |     <feature value="optional">#speech</feature>
 49 |     <feature value="optional">#styling</feature>
 50 |     <feature value="optional">#styling-chained</feature>
 51 |     <feature value="optional">#styling-inheritance-content</feature>
 52 |     <feature value="optional">#styling-inline</feature>
 53 |     <feature value="optional">#styling-referential</feature>
 54 |     <feature value="optional">#tickRate</feature>
 55 |     <feature value="optional">#time-clock</feature>
 56 |     <feature value="optional">#time-offset</feature>
 57 |     <feature value="optional">#time-offset-with-frames</feature>
 58 |     <feature value="optional">#time-offset-with-ticks</feature>
 59 |     <feature value="optional">#timing</feature>
 60 |     <feature value="optional">#transformation</feature>
 61 |     <feature value="optional">#unicodeBidi</feature>
 62 |     <feature value="optional">#unicodeBidi-isolate</feature>
 63 |     <feature value="optional" extends="#unicodeBidi">#unicodeBidi-version-2</feature>
 64 |     <feature value="optional">#xlink</feature>
 65 |     <!-- prohibited feature support -->
 66 |     <feature value="prohibited">#animation-out-of-line</feature>
 67 |     <feature value="prohibited">#clockMode</feature>
 68 |     <feature value="prohibited">#clockMode-gps</feature>
 69 |     <feature value="prohibited">#clockMode-local</feature>
 70 |     <feature value="prohibited">#clockMode-utc</feature>
 71 |     <feature value="prohibited">#dropMode</feature>
 72 |     <feature value="prohibited">#dropMode-dropNTSC</feature>
 73 |     <feature value="prohibited">#dropMode-dropPAL</feature>
 74 |     <feature value="prohibited">#dropMode-nonDrop</feature>
 75 |     <feature value="prohibited">#markerMode</feature>
 76 |     <feature value="prohibited">#markerMode-continuous</feature>
 77 |     <feature value="prohibited">#markerMode-discontinuous</feature>
 78 |     <feature value="prohibited">#subFrameRate</feature>
 79 |     <feature value="prohibited">#time-clock-with-frames</feature>
 80 |     <feature value="prohibited">#time-wall-clock</feature>
 81 |     <feature value="prohibited">#timeBase-clock</feature>
 82 |     <feature value="prohibited">#timeBase-smpte</feature>
 83 |     <feature value="prohibited">#timeContainer</feature>
 84 |   </features>
 85 |   <extensions xml:base="http://www.w3.org/ns/ttml/profile/dapt/extension/">
 86 |     <!-- required (mandatory) extension support -->
 87 |     <extension value="required">#contentProfiles-root</extension>
 88 |     <extension value="required">#represents</extension>
 89 |     <extension value="required">#scriptRepresents-root</extension>
 90 |     <extension value="required">#scriptType-root</extension>
 91 |     <extension value="required">#serialization</extension>
 92 |     <extension value="required">#xmlLang-root</extension>
 93 |     <!-- optional (voluntary) extension support -->
 94 |     <extension value="optional">#agent</extension>
 95 |     <extension value="optional">#daptOriginTimecode</extension>
 96 |     <extension value="optional">#descType</extension>
 97 |     <extension value="optional">#onScreen</extension>
 98 |     <extension value="optional">#scriptEventMapping</extension>
 99 |     <extension value="optional">#textLanguageSource</extension>
100 |     <!-- prohibited extension support -->
101 |     <extension value="prohibited">#profile-root</extension>
102 |     <extension value="prohibited">#source-data</extension>
103 |     <extension value="prohibited">#xmlLang-audio-nonMatching</extension>
104 | </extensions>
105 | </profile>
106 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-embedded.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
  3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
  4 |   xmlns:tt="http://www.w3.org/ns/ttml"
  5 |   xmlns:ttd="http://www.w3.org/ns/ttml#datatype"
  6 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
  7 |   xmlns:xlink="http://www.w3.org/1999/xlink">
  8 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
  9 |   <xs:include schemaLocation="ttml2-metadata.xsd"/>
 10 |   <xs:import namespace="http://www.w3.org/ns/ttml#metadata"
 11 |     schemaLocation="ttml2-metadata-attribs.xsd"/>
 12 |   <xs:import namespace="http://www.w3.org/ns/ttml#datatype"
 13 |     schemaLocation="ttml2-datatypes.xsd"/>
 14 |   <xs:import namespace="http://www.w3.org/1999/xlink"
 15 |     schemaLocation="xlink.xsd"/>
 16 |   <xs:attributeGroup name="audio.attlist">
 17 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 18 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 19 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 20 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
 21 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 22 |     <xs:attribute name="clipBegin" type="ttd:timeCoordinate"/>
 23 |     <xs:attribute name="clipEnd" type="ttd:timeCoordinate"/>
 24 |     <xs:attribute name="src" type="ttd:dataSource"/>
 25 |     <xs:attribute name="type" type="ttd:dataType"/>
 26 |   </xs:attributeGroup>
 27 |   <xs:attributeGroup name="chunk.attlist">
 28 |     <xs:attributeGroup ref="tt:Core.ID.attrib.class"/>
 29 |     <xs:attribute name="encoding" type="ttd:dataEncoding"/>
 30 |     <xs:attribute name="length" type="ttd:dataLength"/>
 31 |   </xs:attributeGroup>
 32 |   <xs:attributeGroup name="data.attlist">
 33 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 34 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 35 |     <xs:attribute name="encoding" type="ttd:dataEncoding"/>
 36 |     <xs:attribute name="format" type="ttd:dataFormat"/>
 37 |     <xs:attribute name="length" type="ttd:dataLength"/>
 38 |     <xs:attribute name="src" type="ttd:dataSource"/>
 39 |     <xs:attribute name="type" type="ttd:dataType"/>
 40 |   </xs:attributeGroup>
 41 |   <xs:attributeGroup name="font.attlist">
 42 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 43 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 44 |     <xs:attribute name="family" type="ttd:fontFamily"/>
 45 |     <xs:attribute name="range" type="ttd:fontRange"/>
 46 |     <xs:attribute name="src" type="ttd:dataSource"/>
 47 |     <xs:attribute name="style" type="ttd:fontStyle"/>
 48 |     <xs:attribute name="type" type="ttd:dataType"/>
 49 |     <xs:attribute name="weight" type="ttd:fontWeight"/>
 50 |   </xs:attributeGroup>
 51 |   <xs:attributeGroup name="image.attlist">
 52 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 53 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 54 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 55 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
 56 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 57 |     <xs:attributeGroup ref="xlink:simpleAttrs"/>
 58 |     <xs:attribute name="src" type="ttd:dataSource"/>
 59 |     <xs:attribute name="type" type="ttd:dataType"/>
 60 |   </xs:attributeGroup>
 61 |   <xs:attributeGroup name="resources.attlist">
 62 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 63 |   </xs:attributeGroup>
 64 |   <xs:attributeGroup name="source.attlist">
 65 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 66 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 67 |     <xs:attribute name="format" type="ttd:dataFormat"/>
 68 |     <xs:attribute name="src" type="ttd:dataSource"/>
 69 |     <xs:attribute name="type" type="ttd:dataType"/>
 70 |   </xs:attributeGroup>
 71 |   <xs:complexType name="audio.eltype">
 72 |     <xs:sequence>
 73 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
 74 |       <xs:element ref="tt:source" minOccurs="0" maxOccurs="unbounded"/>
 75 |     </xs:sequence>
 76 |     <xs:attributeGroup ref="tt:audio.attlist"/>
 77 |   </xs:complexType>
 78 |   <xs:complexType name="chunk.eltype" mixed="true">
 79 |     <xs:attributeGroup ref="tt:chunk.attlist"/>
 80 |   </xs:complexType>
 81 |   <xs:complexType name="data.eltype" mixed="true">
 82 |     <xs:annotation>
 83 |       <xs:documentation>#PCDATA | (Metadata.class*) | (Metadata.class*, chunk+) | (Metadata.class*, source+)</xs:documentation>
 84 |       <xs:documentation>The following is an over-generalization of the above content model.</xs:documentation>
 85 |     </xs:annotation>
 86 |     <xs:sequence>
 87 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
 88 |       <xs:choice minOccurs="0" maxOccurs="1">
 89 |         <xs:element ref="tt:chunk" minOccurs="1" maxOccurs="unbounded"/>
 90 |         <!-- <xs:element ref="tt:source" minOccurs="1" maxOccurs="unbounded"/> source element child of data is prohibited in DAPT -->
 91 |       </xs:choice>
 92 |     </xs:sequence>
 93 |     <xs:attributeGroup ref="tt:data.attlist"/>
 94 |   </xs:complexType>
 95 |   <xs:complexType name="font.eltype">
 96 |     <xs:sequence>
 97 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
 98 |       <xs:element ref="tt:source" minOccurs="0" maxOccurs="unbounded"/>
 99 |     </xs:sequence>
100 |     <xs:attributeGroup ref="tt:font.attlist"/>
101 |   </xs:complexType>
102 |   <xs:complexType name="image.eltype">
103 |     <xs:sequence>
104 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
105 |       <xs:element ref="tt:source" minOccurs="0" maxOccurs="unbounded"/>
106 |     </xs:sequence>
107 |     <xs:attributeGroup ref="tt:image.attlist"/>
108 |   </xs:complexType>
109 |   <xs:complexType name="resources.eltype">
110 |     <xs:sequence>
111 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
112 |       <xs:group ref="tt:Resource.class" minOccurs="0" maxOccurs="unbounded"/>
113 |     </xs:sequence>
114 |     <xs:attributeGroup ref="tt:resources.attlist"/>
115 |   </xs:complexType>
116 |   <xs:complexType name="source.eltype">
117 |     <xs:sequence>
118 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
119 |       <xs:element ref="tt:data" minOccurs="0" maxOccurs="1"/>
120 |     </xs:sequence>
121 |     <xs:attributeGroup ref="tt:source.attlist"/>
122 |   </xs:complexType>
123 |   <xs:element name="audio" type="tt:audio.eltype"/>
124 |   <xs:element name="chunk" type="tt:chunk.eltype"/>
125 |   <xs:element name="data" type="tt:data.eltype"/>
126 |   <xs:element name="font" type="tt:font.eltype"/>
127 |   <xs:element name="image" type="tt:image.eltype"/>
128 |   <xs:element name="resources" type="tt:resources.eltype"/>
129 |   <xs:element name="source" type="tt:source.eltype"/>
130 |   <xs:group name="Audio.class">
131 |     <xs:choice>
132 |       <xs:element ref="tt:audio"/>
133 |     </xs:choice>
134 |   </xs:group>
135 |   <xs:group name="Data.class">
136 |     <xs:choice>
137 |       <xs:element ref="tt:data"/>
138 |     </xs:choice>
139 |   </xs:group>
140 |   <xs:group name="Font.class">
141 |     <xs:choice>
142 |       <xs:element ref="tt:font"/>
143 |     </xs:choice>
144 |   </xs:group>
145 |   <xs:group name="Image.class">
146 |     <xs:choice>
147 |       <xs:element ref="tt:image"/>
148 |     </xs:choice>
149 |   </xs:group>
150 |   <xs:group name="Embedded.class">
151 |     <xs:choice>
152 |       <xs:element ref="tt:audio"/>
153 |       <xs:element ref="tt:image"/>
154 |     </xs:choice>
155 |   </xs:group>
156 |   <xs:group name="Resource.class">
157 |     <xs:choice>
158 |       <xs:group ref="tt:Data.class"/>
159 |       <xs:group ref="tt:Embedded.class"/>
160 |       <xs:group ref="tt:Font.class"/>
161 |     </xs:choice>
162 |   </xs:group>
163 | </xs:schema>
164 | 


--------------------------------------------------------------------------------
/xml-schemas/ttml2-content.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml" xml:lang="en"
  3 |   xmlns:xs="http://www.w3.org/2001/XMLSchema"
  4 |   xmlns:daptm="http://www.w3.org/ns/ttml/profile/dapt#metadata"
  5 |   xmlns:tt="http://www.w3.org/ns/ttml"
  6 |   xmlns:ttm="http://www.w3.org/ns/ttml#metadata"
  7 |   xmlns:tts="http://www.w3.org/ns/ttml#styling"
  8 |   xmlns:xlink="http://www.w3.org/1999/xlink"
  9 |   xmlns:xml="http://www.w3.org/XML/1998/namespace">
 10 |   <xs:include schemaLocation="ttml2-core-attribs.xsd"/>
 11 |   <xs:include schemaLocation="ttml2-timing-attribs.xsd"/>
 12 |   <xs:include schemaLocation="ttml2-metadata.xsd"/>
 13 |   <xs:include schemaLocation="ttml2-animation.xsd"/>
 14 |   <xs:include schemaLocation="ttml2-embedded.xsd"/>
 15 |   <xs:include schemaLocation="ttml2-layout.xsd"/>
 16 |   <xs:include schemaLocation="ttml2-styling.xsd"/>
 17 |   <xs:import namespace="http://www.w3.org/ns/ttml#metadata"
 18 |     schemaLocation="ttml2-metadata-attribs.xsd"/>
 19 |   <xs:import namespace="http://www.w3.org/ns/ttml/profile/dapt#metadata"
 20 |     schemaLocation="dapt-metadata.xsd"/>
 21 |   <xs:import namespace="http://www.w3.org/1999/xlink"
 22 |     schemaLocation="xlink.xsd"/>
 23 |   <xs:import namespace="http://www.w3.org/XML/1998/namespace"
 24 |     schemaLocation="xml.xsd"/>
 25 |   <xs:attributeGroup name="body.attlist">
 26 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 27 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 28 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
 29 |     <xs:attributeGroup ref="tt:RegionBinding.attrib.class"/>
 30 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 31 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 32 |   </xs:attributeGroup>
 33 |   <xs:attributeGroup name="div.attlist">
 34 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 35 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 36 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
 37 |     <xs:attributeGroup ref="tt:RegionBinding.attrib.class"/>
 38 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 39 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 40 |   </xs:attributeGroup>
 41 |   <xs:attributeGroup name="p.attlist">
 42 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 43 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 44 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
 45 |     <xs:attributeGroup ref="tt:RegionBinding.attrib.class"/>
 46 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 47 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 48 |   </xs:attributeGroup>
 49 |   <xs:attributeGroup name="span.attlist">
 50 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 51 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 52 |     <xs:attributeGroup ref="tt:TimedContainer.attrib.class"/>
 53 |     <xs:attributeGroup ref="tt:RegionBinding.attrib.class"/>
 54 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 55 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 56 |     <xs:attributeGroup ref="xlink:simpleAttrs"/>
 57 |   </xs:attributeGroup>
 58 |   <xs:attributeGroup name="br.attlist">
 59 |     <xs:attributeGroup ref="tt:Core.attrib.class"/>
 60 |     <xs:attributeGroup ref="tt:Core.Condition.attrib.class"/>
 61 |     <xs:attributeGroup ref="tt:Styled.attrib.class"/>
 62 |     <xs:attributeGroup ref="ttm:Metadata.attrib.class"/>
 63 |   </xs:attributeGroup>
 64 |   <xs:complexType name="body.eltype">
 65 |     <xs:sequence>
 66 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
 67 |       <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
 68 |       <xs:group ref="tt:DivOrEmbedded.class" minOccurs="0" maxOccurs="unbounded"/>
 69 |     </xs:sequence>
 70 |     <xs:attributeGroup ref="tt:body.attlist"/>
 71 |   </xs:complexType>
 72 |   <xs:complexType name="dapt_body.eltype">
 73 |     <xs:complexContent>
 74 |       <xs:extension base="tt:body.eltype">
 75 |         <xs:attribute ref="daptm:langSrc"/>
 76 |         <xs:attribute ref="daptm:represents"/>
 77 |       </xs:extension>
 78 |     </xs:complexContent>
 79 |   </xs:complexType>
 80 |   <xs:complexType name="div.eltype">
 81 |     <xs:sequence>
 82 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
 83 |       <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
 84 |       <xs:group ref="tt:BlockOrEmbedded.class" minOccurs="0" maxOccurs="unbounded"/>
 85 |     </xs:sequence>
 86 |     <xs:attributeGroup ref="tt:div.attlist"/>
 87 |   </xs:complexType>
 88 |   <xs:complexType name="dapt_div.eltype">
 89 |     <xs:complexContent>
 90 |       <xs:restriction base="tt:div.eltype">
 91 |         <xs:sequence>
 92 |           <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
 93 |           <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
 94 |           <xs:group ref="tt:BlockOrEmbedded.class" minOccurs="0" maxOccurs="unbounded"/>
 95 |         </xs:sequence>
 96 |         <xs:attribute ref="daptm:langSrc"/>
 97 |         <xs:attribute ref="daptm:onScreen"/>
 98 |         <xs:attribute ref="daptm:represents"/>
 99 |       </xs:restriction>
100 |     </xs:complexContent>
101 |   </xs:complexType>
102 |   <xs:complexType name="p.eltype" mixed="true">
103 |     <xs:sequence>
104 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
105 |       <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
106 |       <xs:group ref="tt:InlineOrEmbedded.class" minOccurs="0" maxOccurs="unbounded"/>
107 |     </xs:sequence>
108 |     <xs:attributeGroup ref="tt:p.attlist"/>
109 |   </xs:complexType>
110 |   <xs:complexType name="dapt_p.eltype">
111 |     <xs:complexContent>
112 |       <xs:extension base="tt:p.eltype">
113 |         <xs:attribute ref="daptm:langSrc"/>
114 |         <xs:attribute ref="daptm:represents"/>
115 |       </xs:extension>
116 |     </xs:complexContent>
117 |   </xs:complexType>
118 |   <xs:complexType name="span.eltype" mixed="true">
119 |     <xs:sequence>
120 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
121 |       <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
122 |       <xs:group ref="tt:InlineOrEmbedded.class" minOccurs="0" maxOccurs="unbounded"/>
123 |     </xs:sequence>
124 |     <xs:attributeGroup ref="tt:span.attlist"/>
125 |   </xs:complexType>
126 |   <xs:complexType name="dapt_span.eltype" mixed="true">
127 |     <xs:complexContent>
128 |       <xs:extension base="tt:span.eltype">
129 |         <xs:attribute ref="daptm:langSrc"/>
130 |         <xs:attribute ref="daptm:represents"/>
131 |       </xs:extension>
132 |     </xs:complexContent>
133 |   </xs:complexType>
134 |   <xs:complexType name="br.eltype">
135 |     <xs:sequence>
136 |       <xs:group ref="tt:Metadata.class" minOccurs="0" maxOccurs="unbounded"/>
137 |       <xs:group ref="tt:Animation.class" minOccurs="0" maxOccurs="unbounded"/>
138 |     </xs:sequence>
139 |     <xs:attributeGroup ref="tt:br.attlist"/>
140 |   </xs:complexType>
141 |   <xs:element name="body" type="tt:dapt_body.eltype"/>
142 |   <xs:element name="div" type="tt:dapt_div.eltype"/>
143 |   <xs:element name="p" type="tt:dapt_p.eltype"/>
144 |   <xs:element name="span" type="tt:dapt_span.eltype"/>
145 |   <xs:element name="br" type="tt:br.eltype"/>
146 |   <xs:group name="BlockNoDiv.class">
147 |     <xs:choice>
148 |       <xs:element ref="tt:p"/>
149 |     </xs:choice>
150 |   </xs:group>
151 |   <xs:group name="Block.class">
152 |     <xs:choice>
153 |       <xs:group ref="tt:BlockNoDiv.class"/>
154 |       <xs:element ref="tt:div"/>
155 |     </xs:choice>
156 |   </xs:group>
157 |   <xs:group name="BlockOrEmbedded.class">
158 |     <xs:choice>
159 |       <xs:group ref="tt:Block.class"/>
160 |       <xs:group ref="tt:Embedded.class"/>
161 |     </xs:choice>
162 |   </xs:group>
163 |   <xs:group name="DivOrEmbedded.class">
164 |     <xs:choice>
165 |       <xs:element ref="tt:div"/>
166 |       <xs:group ref="tt:Embedded.class"/>
167 |     </xs:choice>
168 |   </xs:group>
169 |   <xs:group name="InlineNoSpan.class">
170 |     <xs:choice>
171 |       <xs:element ref="tt:br"/>
172 |     </xs:choice>
173 |   </xs:group>
174 |   <xs:group name="Inline.class">
175 |     <xs:choice>
176 |       <xs:group ref="tt:InlineNoSpan.class"/>
177 |       <xs:element ref="tt:span"/>
178 |     </xs:choice>
179 |   </xs:group>
180 |   <xs:group name="InlineOrEmbedded.class">
181 |     <xs:choice>
182 |       <xs:group ref="tt:Inline.class"/>
183 |       <xs:group ref="tt:Embedded.class"/>
184 |     </xs:choice>
185 |   </xs:group>
186 | </xs:schema>
187 | 


--------------------------------------------------------------------------------
/xml-schemas/xml.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0"?>
  2 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.w3.org/1999/xhtml"
  3 | 	xmlns:xml="http://www.w3.org/XML/1998/namespace"
  4 | 	targetNamespace="http://www.w3.org/XML/1998/namespace" xml:lang="en">
  5 | 	<xs:annotation>
  6 | 		<xs:documentation>
  7 | 			<div>
  8 | 				<h1>About the XML namespace</h1>
  9 | 				<div class="bodytext">
 10 | 					<p> This schema document describes the XML namespace, in a form suitable for
 11 | 						import by other schema documents. </p>
 12 | 					<p> See <a href="http://www.w3.org/XML/1998/namespace.html">
 13 | 							http://www.w3.org/XML/1998/namespace.html</a> and <a
 14 | 							href="http://www.w3.org/TR/REC-xml"> http://www.w3.org/TR/REC-xml</a>
 15 | 						for information about this namespace. </p>
 16 | 					<p> Note that local names in this namespace are intended to be defined only by
 17 | 						the World Wide Web Consortium or its subgroups. The names currently defined
 18 | 						in this namespace are listed below. They should not be used with conflicting
 19 | 						semantics by any Working Group, specification, or document instance. </p>
 20 | 					<p> See further below in this document for more information about <a
 21 | 							href="#usage">how to refer to this schema document from your own XSD
 22 | 							schema documents</a> and about <a href="#nsversioning">the
 23 | 							namespace-versioning policy governing this schema document</a>. </p>
 24 | 				</div>
 25 | 			</div>
 26 | 		</xs:documentation>
 27 | 	</xs:annotation>
 28 | 	<xs:attribute name="lang">
 29 | 		<xs:annotation>
 30 | 			<xs:documentation>
 31 | 				<div>
 32 | 					<h3>lang (as an attribute name)</h3>
 33 | 					<p> denotes an attribute whose value is a language code for the natural language
 34 | 						of the content of any element; its value is inherited. This name is reserved
 35 | 						by virtue of its definition in the XML specification.</p>
 36 | 				</div>
 37 | 				<div>
 38 | 					<h4>Notes</h4>
 39 | 					<p> Attempting to install the relevant ISO 2- and 3-letter codes as the
 40 | 						enumerated possible values is probably never going to be a realistic
 41 | 						possibility. </p>
 42 | 					<p> See BCP 47 at <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt">
 43 | 							http://www.rfc-editor.org/rfc/bcp/bcp47.txt</a> and the IANA language
 44 | 						subtag registry at <a
 45 | 							href="http://www.iana.org/assignments/language-subtag-registry">
 46 | 							http://www.iana.org/assignments/language-subtag-registry</a> for further
 47 | 						information. </p>
 48 | 					<p> The union allows for the 'un-declaration' of xml:lang with the empty string.
 49 | 					</p>
 50 | 				</div>
 51 | 			</xs:documentation>
 52 | 		</xs:annotation>
 53 | 		<xs:simpleType>
 54 | 			<xs:union memberTypes="xs:language">
 55 | 				<xs:simpleType>
 56 | 					<xs:restriction base="xs:string">
 57 | 						<xs:enumeration value=""/>
 58 | 					</xs:restriction>
 59 | 				</xs:simpleType>
 60 | 			</xs:union>
 61 | 		</xs:simpleType>
 62 | 	</xs:attribute>
 63 | 	<xs:attribute name="space">
 64 | 		<xs:annotation>
 65 | 			<xs:documentation>
 66 | 				<div>
 67 | 					<h3>space (as an attribute name)</h3>
 68 | 					<p> denotes an attribute whose value is a keyword indicating what whitespace
 69 | 						processing discipline is intended for the content of the element; its value
 70 | 						is inherited. This name is reserved by virtue of its definition in the XML
 71 | 						specification.</p>
 72 | 				</div>
 73 | 			</xs:documentation>
 74 | 		</xs:annotation>
 75 | 		<xs:simpleType>
 76 | 			<xs:restriction base="xs:NCName">
 77 | 				<xs:enumeration value="default"/>
 78 | 				<xs:enumeration value="preserve"/>
 79 | 			</xs:restriction>
 80 | 		</xs:simpleType>
 81 | 	</xs:attribute>
 82 | 	<xs:attribute name="base" type="xs:anyURI">
 83 | 		<xs:annotation>
 84 | 			<xs:documentation>
 85 | 				<div>
 86 | 					<h3>base (as an attribute name)</h3>
 87 | 					<p> denotes an attribute whose value provides a URI to be used as the base for
 88 | 						interpreting any relative URIs in the scope of the element on which it
 89 | 						appears; its value is inherited. This name is reserved by virtue of its
 90 | 						definition in the XML Base specification.</p>
 91 | 					<p> See <a href="http://www.w3.org/TR/xmlbase/"
 92 | 							>http://www.w3.org/TR/xmlbase/</a> for information about this attribute.
 93 | 					</p>
 94 | 				</div>
 95 | 			</xs:documentation>
 96 | 		</xs:annotation>
 97 | 	</xs:attribute>
 98 | 	<xs:attribute name="id" type="xs:ID">
 99 | 		<xs:annotation>
100 | 			<xs:documentation>
101 | 				<div>
102 | 					<h3>id (as an attribute name)</h3>
103 | 					<p> denotes an attribute whose value should be interpreted as if declared to be
104 | 						of type ID. This name is reserved by virtue of its definition in the xml:id
105 | 						specification.</p>
106 | 					<p> See <a href="http://www.w3.org/TR/xml-id/">http://www.w3.org/TR/xml-id/</a>
107 | 						for information about this attribute. </p>
108 | 				</div>
109 | 			</xs:documentation>
110 | 		</xs:annotation>
111 | 	</xs:attribute>
112 | 	<xs:attributeGroup name="specialAttrs">
113 | 		<xs:attribute ref="xml:base"/>
114 | 		<xs:attribute ref="xml:lang"/>
115 | 		<xs:attribute ref="xml:space"/>
116 | 		<xs:attribute ref="xml:id"/>
117 | 	</xs:attributeGroup>
118 | 	<xs:annotation>
119 | 		<xs:documentation>
120 | 			<div>
121 | 				<h3>Father (in any context at all)</h3>
122 | 				<div class="bodytext">
123 | 					<p> denotes Jon Bosak, the chair of the original XML Working Group. This name is
124 | 						reserved by the following decision of the W3C XML Plenary and XML
125 | 						Coordination groups: </p>
126 | 					<blockquote>
127 | 						<p> In appreciation for his vision, leadership and dedication the W3C XML
128 | 							Plenary on this 10th day of February, 2000, reserves for Jon Bosak in
129 | 							perpetuity the XML name "xml:Father". </p>
130 | 					</blockquote>
131 | 				</div>
132 | 			</div>
133 | 		</xs:documentation>
134 | 	</xs:annotation>
135 | 	<xs:annotation>
136 | 		<xs:documentation>
137 | 			<div xml:id="usage" id="usage">
138 | 				<h2>
139 | 					<a name="usage">About this schema document</a>
140 | 				</h2>
141 | 				<div class="bodytext">
142 | 					<p> This schema defines attributes and an attribute group suitable for use by
143 | 						schemas wishing to allow <code>xml:base</code>, <code>xml:lang</code>,
144 | 							<code>xml:space</code> or <code>xml:id</code> attributes on elements
145 | 						they define. </p>
146 | 					<p> To enable this, such a schema must import this schema for the XML namespace,
147 | 						e.g. as follows: </p>
148 | 					<pre>
149 |           &lt;schema . . .>
150 |            . . .
151 |            &lt;import namespace="http://www.w3.org/XML/1998/namespace"
152 |                       schemaLocation="http://www.w3.org/2001/xml.xsd"/>
153 |      </pre>
154 | 					<p> or </p>
155 | 					<pre>
156 |            &lt;import namespace="http://www.w3.org/XML/1998/namespace"
157 |                       schemaLocation="http://www.w3.org/2009/01/xml.xsd"/>
158 |      </pre>
159 | 					<p> Subsequently, qualified reference to any of the attributes or the group
160 | 						defined below will have the desired effect, e.g. </p>
161 | 					<pre>
162 |           &lt;type . . .>
163 |            . . .
164 |            &lt;attributeGroup ref="xml:specialAttrs"/>
165 |      </pre>
166 | 					<p> will define a type which will schema-validate an instance element with any
167 | 						of those attributes. </p>
168 | 				</div>
169 | 			</div>
170 | 		</xs:documentation>
171 | 	</xs:annotation>
172 | 	<xs:annotation>
173 | 		<xs:documentation>
174 | 			<div id="nsversioning" xml:id="nsversioning">
175 | 				<h2>
176 | 					<a name="nsversioning">Versioning policy for this schema document</a>
177 | 				</h2>
178 | 				<div class="bodytext">
179 | 					<p> In keeping with the XML Schema WG's standard versioning policy, this schema
180 | 						document will persist at <a href="http://www.w3.org/2009/01/xml.xsd">
181 | 							http://www.w3.org/2009/01/xml.xsd</a>. </p>
182 | 					<p> At the date of issue it can also be found at <a
183 | 							href="http://www.w3.org/2001/xml.xsd">
184 | 							http://www.w3.org/2001/xml.xsd</a>. </p>
185 | 					<p> The schema document at that URI may however change in the future, in order
186 | 						to remain compatible with the latest version of XML Schema itself, or with
187 | 						the XML namespace itself. In other words, if the XML Schema or XML
188 | 						namespaces change, the version of this document at <a
189 | 							href="http://www.w3.org/2001/xml.xsd"> http://www.w3.org/2001/xml.xsd
190 | 						</a> will change accordingly; the version at <a
191 | 							href="http://www.w3.org/2009/01/xml.xsd">
192 | 							http://www.w3.org/2009/01/xml.xsd </a> will not change. </p>
193 | 					<p> Previous dated (and unchanging) versions of this schema document are at: </p>
194 | 					<ul>
195 | 						<li>
196 | 							<a href="http://www.w3.org/2009/01/xml.xsd">
197 | 								http://www.w3.org/2009/01/xml.xsd</a>
198 | 						</li>
199 | 						<li>
200 | 							<a href="http://www.w3.org/2007/08/xml.xsd">
201 | 								http://www.w3.org/2007/08/xml.xsd</a>
202 | 						</li>
203 | 						<li>
204 | 							<a href="http://www.w3.org/2004/10/xml.xsd">
205 | 								http://www.w3.org/2004/10/xml.xsd</a>
206 | 						</li>
207 | 						<li>
208 | 							<a href="http://www.w3.org/2001/03/xml.xsd">
209 | 								http://www.w3.org/2001/03/xml.xsd</a>
210 | 						</li>
211 | 					</ul>
212 | 				</div>
213 | 			</div>
214 | 		</xs:documentation>
215 | 	</xs:annotation>
216 | </xs:schema>
217 | 


--------------------------------------------------------------------------------
/xml-schemas/xlink.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version='1.0' encoding='UTF-8'?>
  2 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink">
  3 |     
  4 |     <xs:annotation>
  5 |         <xs:documentation>This schema document provides attribute declarations and
  6 |             attribute group, complex type and simple type definitions which can be used in
  7 |             the construction of user schemas to define the structure of particular linking
  8 |             constructs, e.g.
  9 |             <![CDATA[
 10 | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
 11 |            xmlns:xl="http://www.w3.org/1999/xlink">
 12 | 
 13 |  <xs:import namespace="http://www.w3.org/1999/xlink"
 14 |             location="http://www.w3.org/1999/xlink.xsd">
 15 | 
 16 |  <xs:element name="mySimple">
 17 |   <xs:complexType>
 18 |    ...
 19 |    <xs:attributeGroup ref="xl:simpleAttrs"/>
 20 |    ...
 21 |   </xs:complexType>
 22 |  </xs:element>
 23 |  ...
 24 | </xs:schema>]]></xs:documentation>
 25 |     </xs:annotation>
 26 |     
 27 |     <xs:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="http://www.w3.org/2001/xml.xsd"/>
 28 |     
 29 |     <xs:attribute name="type" type="xlink:typeType"/>
 30 |     
 31 |     <xs:simpleType name="typeType">
 32 |         <xs:restriction base="xs:token">
 33 |             <xs:enumeration value="simple"/>
 34 |             <xs:enumeration value="extended"/>
 35 |             <xs:enumeration value="title"/>
 36 |             <xs:enumeration value="resource"/>
 37 |             <xs:enumeration value="locator"/>
 38 |             <xs:enumeration value="arc"/>
 39 |         </xs:restriction>
 40 |     </xs:simpleType>
 41 |     
 42 |     <xs:attribute name="href" type="xlink:hrefType"/>
 43 |     
 44 |     <xs:simpleType name="hrefType">
 45 |         <xs:restriction base="xs:anyURI"/>
 46 |     </xs:simpleType>
 47 |     
 48 |     <xs:attribute name="role" type="xlink:roleType"/>
 49 |     
 50 |     <xs:simpleType name="roleType">
 51 |         <xs:restriction base="xs:anyURI">
 52 |             <xs:minLength value="1"/>
 53 |         </xs:restriction>
 54 |     </xs:simpleType>
 55 |     
 56 |     <xs:attribute name="arcrole" type="xlink:arcroleType"/>
 57 |     
 58 |     <xs:simpleType name="arcroleType">
 59 |         <xs:restriction base="xs:anyURI">
 60 |             <xs:minLength value="1"/>
 61 |         </xs:restriction>
 62 |     </xs:simpleType>
 63 |     
 64 |     <xs:attribute name="title" type="xlink:titleAttrType"/>
 65 |     
 66 |     <xs:simpleType name="titleAttrType">
 67 |         <xs:restriction base="xs:string"/>
 68 |     </xs:simpleType>
 69 |     
 70 |     <xs:attribute name="show" type="xlink:showType"/>
 71 |     
 72 |     <xs:simpleType name="showType">
 73 |         <xs:restriction base="xs:token">
 74 |             <xs:enumeration value="new"/>
 75 |             <xs:enumeration value="replace"/>
 76 |             <xs:enumeration value="embed"/>
 77 |             <xs:enumeration value="other"/>
 78 |             <xs:enumeration value="none"/>
 79 |         </xs:restriction>
 80 |     </xs:simpleType>
 81 |     
 82 |     <xs:attribute name="actuate" type="xlink:actuateType"/>
 83 |     
 84 |     <xs:simpleType name="actuateType">
 85 |         <xs:restriction base="xs:token">
 86 |             <xs:enumeration value="onLoad"/>
 87 |             <xs:enumeration value="onRequest"/>
 88 |             <xs:enumeration value="other"/>
 89 |             <xs:enumeration value="none"/>
 90 |         </xs:restriction>
 91 |     </xs:simpleType>
 92 |     
 93 |     <xs:attribute name="label" type="xlink:labelType"/>
 94 |     
 95 |     <xs:simpleType name="labelType">
 96 |         <xs:restriction base="xs:NCName"/>
 97 |     </xs:simpleType>
 98 |     
 99 |     <xs:attribute name="from" type="xlink:fromType"/>
100 |     
101 |     <xs:simpleType name="fromType">
102 |         <xs:restriction base="xs:NCName"/>
103 |     </xs:simpleType>
104 |     
105 |     <xs:attribute name="to" type="xlink:toType"/>
106 |     
107 |     <xs:simpleType name="toType">
108 |         <xs:restriction base="xs:NCName"/>
109 |     </xs:simpleType>
110 |     
111 |     <xs:attributeGroup name="simpleAttrs">
112 |         <xs:attribute ref="xlink:type" fixed="simple"/>
113 |         <xs:attribute ref="xlink:href"/>
114 |         <xs:attribute ref="xlink:role"/>
115 |         <xs:attribute ref="xlink:arcrole"/>
116 |         <xs:attribute ref="xlink:title"/>
117 |         <xs:attribute ref="xlink:show"/>
118 |         <xs:attribute ref="xlink:actuate"/>
119 |     </xs:attributeGroup>
120 |     
121 |     <xs:group name="simpleModel">
122 |         <xs:sequence>
123 |             <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
124 |         </xs:sequence>
125 |     </xs:group>
126 |     
127 |     <xs:complexType mixed="true" name="simple">
128 |         <xs:annotation>
129 |             <xs:documentation>
130 |                 Intended for use as the type of user-declared elements to make them
131 |                 simple links.
132 |             </xs:documentation>
133 |         </xs:annotation>
134 |         <xs:group ref="xlink:simpleModel"/>
135 |         <xs:attributeGroup ref="xlink:simpleAttrs"/>
136 |     </xs:complexType>
137 |     
138 |     <xs:attributeGroup name="extendedAttrs">
139 |         <xs:attribute ref="xlink:type" fixed="extended" use="required"/>
140 |         <xs:attribute ref="xlink:role"/>
141 |         <xs:attribute ref="xlink:title"/>
142 |     </xs:attributeGroup>
143 |     
144 |     <xs:group name="extendedModel">
145 |         <xs:choice>
146 |             <xs:element ref="xlink:title"/>
147 |             <xs:element ref="xlink:resource"/>
148 |             <xs:element ref="xlink:locator"/>
149 |             <xs:element ref="xlink:arc"/>
150 |         </xs:choice>
151 |     </xs:group>
152 |     
153 |     <xs:complexType name="extended">
154 |         <xs:annotation>
155 |             <xs:documentation>
156 |                 Intended for use as the type of user-declared elements to make them
157 |                 extended links.
158 |                 Note that the elements referenced in the content model are all abstract.
159 |                 The intention is that by simply declaring elements with these as their
160 |                 substitutionGroup, all the right things will happen.
161 |             </xs:documentation>
162 |         </xs:annotation>
163 |         <xs:group ref="xlink:extendedModel" minOccurs="0" maxOccurs="unbounded"/>
164 |         <xs:attributeGroup ref="xlink:extendedAttrs"/>
165 |     </xs:complexType>
166 |     
167 |     <xs:element name="title" type="xlink:titleEltType" abstract="true"/>
168 |     
169 |     <xs:attributeGroup name="titleAttrs">
170 |         <xs:attribute ref="xlink:type" fixed="title" use="required"/>
171 |         <xs:attribute ref="xml:lang">
172 |             <xs:annotation>
173 |                 <xs:documentation>
174 |                     xml:lang is not required, but provides much of the
175 |                     motivation for title elements in addition to attributes, and so
176 |                     is provided here for convenience.
177 |                 </xs:documentation>
178 |             </xs:annotation>
179 |         </xs:attribute>
180 |     </xs:attributeGroup>
181 |     
182 |     <xs:group name="titleModel">
183 |         <xs:sequence>
184 |             <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
185 |         </xs:sequence>
186 |     </xs:group>
187 |     
188 |     <xs:complexType mixed="true" name="titleEltType">
189 |         <xs:group ref="xlink:titleModel"/>
190 |         <xs:attributeGroup ref="xlink:titleAttrs"/>
191 |     </xs:complexType>
192 |     
193 |     <xs:element name="resource" type="xlink:resourceType" abstract="true"/>
194 |     
195 |     <xs:attributeGroup name="resourceAttrs">
196 |         <xs:attribute ref="xlink:type" fixed="resource" use="required"/>
197 |         <xs:attribute ref="xlink:role"/>
198 |         <xs:attribute ref="xlink:title"/>
199 |         <xs:attribute ref="xlink:label"/>
200 |     </xs:attributeGroup>
201 |     
202 |     <xs:group name="resourceModel">
203 |         <xs:sequence>
204 |             <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
205 |         </xs:sequence>
206 |     </xs:group>
207 |     
208 |     <xs:complexType mixed="true" name="resourceType">
209 |         <xs:group ref="xlink:resourceModel"/>
210 |         <xs:attributeGroup ref="xlink:resourceAttrs"/>
211 |     </xs:complexType>
212 |     
213 |     <xs:element name="locator" type="xlink:locatorType" abstract="true"/>
214 |     
215 |     <xs:attributeGroup name="locatorAttrs">
216 |         <xs:attribute ref="xlink:type" fixed="locator" use="required"/>
217 |         <xs:attribute ref="xlink:href" use="required"/>
218 |         <xs:attribute ref="xlink:role"/>
219 |         <xs:attribute ref="xlink:title"/>
220 |         <xs:attribute ref="xlink:label">
221 |             <xs:annotation>
222 |                 <xs:documentation>
223 |                     label is not required, but locators have no particular
224 |                     XLink function if they are not labeled.
225 |                 </xs:documentation>
226 |             </xs:annotation>
227 |         </xs:attribute>
228 |     </xs:attributeGroup>
229 |     
230 |     <xs:group name="locatorModel">
231 |         <xs:sequence>
232 |             <xs:element ref="xlink:title" minOccurs="0" maxOccurs="unbounded"/>
233 |         </xs:sequence>
234 |     </xs:group>
235 |     
236 |     <xs:complexType name="locatorType">
237 |         <xs:group ref="xlink:locatorModel"/>
238 |         <xs:attributeGroup ref="xlink:locatorAttrs"/>
239 |     </xs:complexType>
240 |     
241 |     <xs:element name="arc" type="xlink:arcType" abstract="true"/>
242 |     
243 |     <xs:attributeGroup name="arcAttrs">
244 |         <xs:attribute ref="xlink:type" fixed="arc" use="required"/>
245 |         <xs:attribute ref="xlink:arcrole"/>
246 |         <xs:attribute ref="xlink:title"/>
247 |         <xs:attribute ref="xlink:show"/>
248 |         <xs:attribute ref="xlink:actuate"/>
249 |         <xs:attribute ref="xlink:from"/>
250 |         <xs:attribute ref="xlink:to">
251 |             <xs:annotation>
252 |                 <xs:documentation>
253 |                     from and to have default behavior when values are missing
254 |                 </xs:documentation>
255 |             </xs:annotation>
256 |         </xs:attribute>
257 |     </xs:attributeGroup>
258 |     
259 |     <xs:group name="arcModel">
260 |         <xs:sequence>
261 |             <xs:element ref="xlink:title" minOccurs="0" maxOccurs="unbounded"/>
262 |         </xs:sequence>
263 |     </xs:group>
264 |     
265 |     <xs:complexType name="arcType">
266 |         <xs:group ref="xlink:arcModel"/>
267 |         <xs:attributeGroup ref="xlink:arcAttrs"/>
268 |     </xs:complexType>
269 |     
270 | </xs:schema>
271 | 


--------------------------------------------------------------------------------
/figures/audio-mixing.svg:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" height="649px" preserveAspectRatio="none" style="width:645px;height:649px;background:#FFFFFF;" version="1.1" viewBox="0 0 645 649" width="645px" zoomAndPan="magnify"><defs/><g><rect fill="#000000" height="8" style="stroke:none;stroke-width:1.0;" width="80" x="426.5" y="97"/><rect fill="#000000" height="8" style="stroke:none;stroke-width:1.0;" width="80" x="426.5" y="549"/><g id="active-ScriptEvent"><rect fill="#FFFFFF" height="88.5313" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="173" x="288" y="186.5"/><line style="stroke:#000000;stroke-width:1.0;" x1="288" x2="461" y1="221.3438" y2="221.3438"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="147" x="301" y="209.9688">(active) ScriptEvent</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="28" x="296" y="244.8125">Pan</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="36" x="296" y="263.6563">Gain</text></g><g id="active-AudioRecording"><rect fill="#FFFFFF" height="88.5313" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="211" x="12" y="186.5"/><line style="stroke:#000000;stroke-width:1.0;" x1="12" x2="223" y1="221.3438" y2="221.3438"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="185" x="25" y="209.9688">(active) AudioRecording</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="28" x="20" y="244.8125">Pan</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="36" x="20" y="263.6563">Gain</text></g><g id="active-Text"><rect fill="#FFFFFF" height="88.5313" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="121" x="314" y="377.5"/><line style="stroke:#000000;stroke-width:1.0;" x1="314" x2="435" y1="412.3438" y2="412.3438"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="95" x="327" y="400.9688">(active) Text</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="28" x="322" y="435.8125">Pan</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="36" x="322" y="454.6563">Gain</text></g><ellipse cx="466.5" cy="21" fill="#000000" rx="10" ry="10" style="stroke:none;stroke-width:1.0;"/><ellipse cx="466.5" cy="633" fill="none" rx="10" ry="10" style="stroke:#000000;stroke-width:1.0;"/><ellipse cx="467" cy="633.5" fill="#000000" rx="6" ry="6" style="stroke:none;stroke-width:1.0;"/><!--MD5=[242ad121cef04112e9b0ee8f25f52375]
  2 | link *start to fork_state--><g id="link_start_fork_state"><path d="M466.5,31.46 C466.5,31.46 466.5,90.28 466.5,90.28 " fill="none" id="start-to-fork_state" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="466.5,95.28,470.5,86.28,466.5,90.28,462.5,86.28,466.5,95.28" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="72" x="390.5" y="39.4384">programme</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="35" x="409" y="54.7489">audio</text></g><!--MD5=[eb2058352870739e7902bab6b882f216]
  3 | link fork_state to ScriptEvent--><g id="link_fork_state_ScriptEvent"><path d="M443.75,105.33 C443.75,105.33 443.75,179.69 443.75,179.69 " fill="none" id="fork_state-to-ScriptEvent" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="443.75,184.69,447.75,175.69,443.75,179.69,439.75,175.69,443.75,184.69" style="stroke:#000000;stroke-width:1.0;"/><path d="M288.75,84.51 L288.75,137.51 L438.75,137.51 L438.75,94.51 L428.75,84.51 L288.75,84.51 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><path d="M428.75,84.51 L428.75,94.51 L438.75,94.51 L428.75,84.51 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="92" x="297.75" y="107.9787">When audio</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="123" x="297.75" y="126.8225">mixing is active</text></g><!--MD5=[b6528a061c3f232f512af1a3dbec1fad]
  4 | link ScriptEvent to Text--><g id="link_active-ScriptEvent_Text"><path d="M374.5,275.78 C374.5,275.78 374.5,370.66 374.5,370.66 " fill="none" id="ScriptEvent-to-Text" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="374.5,375.66,378.5,366.66,374.5,370.66,370.5,366.66,374.5,375.66" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[9b13eb2f0260baa8e638ed5ef935a12b]
  5 | link AudioRecording to Text--><g id="link_AudioRecording_Text"><path d="M117.5,275.78 C117.5,332.23 117.5,422 117.5,422 C117.5,422 307.08,422 307.08,422 " fill="none" id="AudioRecording-to-Text" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="312.08,422,303.08,418,307.08,422,303.08,426,312.08,422" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[08d98a56e15f6c8cee03f127815ba1e2]
  6 | link Text to join_state--><g id="link_Text_join_state"><path d="M430.75,466.72 C430.75,466.72 430.75,542.15 430.75,542.15 " fill="none" id="Text-to-join_state" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="430.75,547.15,434.75,538.15,430.75,542.15,426.75,538.15,430.75,547.15" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[afabed5d69869b60cd0a02386788f0d9]
  7 | link join_state to *end--><g id="link_join_state_end"><path d="M466.5,557.3 C466.5,557.3 466.5,616.17 466.5,616.17 " fill="none" id="join_state-to-end" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="466.5,621.17,470.5,612.17,466.5,616.17,462.5,612.17,466.5,621.17" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[70f362e88fdbe538e938a9fbc3171645]
  8 | link fork_state to join_state--><g id="link_fork_state_join_state"><path d="M483.75,105.47 C483.75,105.47 483.75,542.25 483.75,542.25 " fill="none" id="fork_state-to-join_state" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="483.75,547.25,487.75,538.25,483.75,542.25,479.75,538.25,483.75,547.25" style="stroke:#000000;stroke-width:1.0;"/><path d="M488.75,265.86 L488.75,318.86 L638.75,318.86 L638.75,275.86 L628.75,265.86 L488.75,265.86 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><path d="M628.75,265.86 L628.75,275.86 L638.75,275.86 L628.75,265.86 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="117" x="497.75" y="289.3288">When no audio</text><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="123" x="497.75" y="308.1725">mixing is active</text></g><!--MD5=[69e46cdc37a262f452ebd9a4c606dcfd]
  9 | @startuml audio-mixing
 10 | !theme plain
 11 | !pragma ratio 1.3
 12 | skinparam groupInheritance 2
 13 | skinparam linetype ortho
 14 | skinparam DefaultFontName sans-serif
 15 | skinparam DefaultFontSize 16
 16 | skinparam ArrowFontSize 13
 17 | skinparam ArrowMessageAlignment direction
 18 | skinparam Padding 3
 19 | skinparam Nodesep 65
 20 | skinparam Ranksep 40
 21 | ' skinparam MinClassWidth 220
 22 | 
 23 | hide empty description
 24 | 
 25 | state fork_state <<fork>> 
 26 | state join_state <<join>>
 27 | state ScriptEvent as "(active) ScriptEvent"
 28 | state AudioRecording as "(active) AudioRecording"
 29 | state Text as "(active) Text"
 30 | 
 31 | [*] - -> fork_state : programme\naudio
 32 | fork_state - -> ScriptEvent
 33 | note on link
 34 |   When audio
 35 |   mixing is active
 36 | end note
 37 | 
 38 | ScriptEvent - -> Text
 39 | AudioRecording - -> Text
 40 | Text - -> join_state
 41 | join_state - -> [*]
 42 | 
 43 | AudioRecording : Pan
 44 | AudioRecording : Gain
 45 | 
 46 | Text : Pan
 47 | Text : Gain
 48 | 
 49 | ScriptEvent : Pan
 50 | ScriptEvent : Gain
 51 | 
 52 | fork_state - -> join_state
 53 | note on link
 54 |   When no audio
 55 |   mixing is active
 56 | end note
 57 | 
 58 | @enduml
 59 | 
 60 | @startuml audio-mixing
 61 | 
 62 | 
 63 | 
 64 | 
 65 | 
 66 | 
 67 | 
 68 | <style>
 69 |   root {
 70 |     BackgroundColor white
 71 |     FontColor black
 72 |     FontName Verdana
 73 |     HyperLinkColor blue
 74 |     LineColor black
 75 |     LineThickness 1
 76 |     Margin 5
 77 |   }
 78 |   caption {
 79 |     LineThickness 0
 80 |   }
 81 |   footer {
 82 |     LineThickness 0
 83 |   }
 84 |   header {
 85 |     LineThickness 0
 86 |   }
 87 |   node {
 88 |     MaximumWidth 300
 89 |   }
 90 |   title {
 91 |     FontSize 22
 92 |     LineThickness 0
 93 |   }
 94 | </style>
 95 | 
 96 | skinparam ArrowLollipopColor black
 97 | skinparam BackgroundColor white
 98 | skinparam DefaultFontName Verdana
 99 | skinparam DefaultMonospacedFontName Courier
100 | skinparam LifelineStrategy nosolid
101 | skinparam ParticipantPadding 10
102 | skinparam SequenceLifeLineBorderColor black
103 | skinparam Shadowing false
104 | skinparam UseBetaStyle true
105 | 
106 | skinparam Activity {
107 |   BackgroundColor white
108 |   BarColor black
109 |   BorderColor black
110 |   FontColor black
111 |   FontName Verdana
112 | }
113 | skinparam Boundary {
114 |   FontColor black
115 | }
116 | skinparam Box {
117 |   Padding 5
118 | }
119 | skinparam CircledCharacter {
120 |   FontColor black
121 |   FontName Courier
122 |   Radius 9
123 | }
124 | skinparam Class {
125 |   BackgroundColor white
126 |   BorderColor black
127 |   FontColor black
128 |   FontName Verdana
129 | }
130 | skinparam ClassAttribute {
131 |   FontColor black
132 |   FontName Verdana
133 | }
134 | skinparam ClassStereotype {
135 |   FontColor black
136 |   FontName Verdana
137 | }
138 | skinparam Footer {
139 |   FontColor black
140 |   FontName Verdana
141 | }
142 | skinparam Header {
143 |   FontColor black
144 |   FontName Verdana
145 | }
146 | skinparam Hyperlink {
147 |   Color blue
148 | }
149 | skinparam IconPackage {
150 |   Color black
151 |   BackgroundColor white
152 | }
153 | skinparam IconPrivate {
154 |   Color black
155 |   BackgroundColor white
156 | }
157 | skinparam IconProtected {
158 |   Color black
159 |   BackgroundColor white
160 | }
161 | skinparam IconPublic {
162 |   Color black
163 |   BackgroundColor white
164 | }
165 | skinparam Note {
166 |   FontColor black
167 |   FontName Verdana
168 | }
169 | skinparam Object {
170 |   BorderColor black
171 | }
172 | skinparam Package {
173 |   BorderColor black
174 |   FontColor black
175 |   FontName Verdana
176 | }
177 | skinparam State {
178 |   BackgroundColor white
179 |   BorderColor black
180 | }
181 | skinparam StereotypeA {
182 |   BackgroundColor white
183 |   BorderColor black
184 | }
185 | skinparam StereotypeC {
186 |   BackgroundColor white
187 |   BorderColor black
188 | }
189 | skinparam StereotypeE {
190 |   BackgroundColor white
191 |   BorderColor black
192 | }
193 | skinparam StereotypeI {
194 |   BackgroundColor white
195 |   BorderColor black
196 | }
197 | skinparam StereotypeN {
198 |   BackgroundColor white
199 |   BorderColor black
200 | }
201 | skinparam UseCaseStereoType {
202 |   FontColor black
203 |   FontName Verdana
204 | }
205 | !pragma ratio 1.3
206 | skinparam groupInheritance 2
207 | skinparam linetype ortho
208 | skinparam DefaultFontName sans-serif
209 | skinparam DefaultFontSize 16
210 | skinparam ArrowFontSize 13
211 | skinparam ArrowMessageAlignment direction
212 | skinparam Padding 3
213 | skinparam Nodesep 65
214 | skinparam Ranksep 40
215 | 
216 | hide empty description
217 | 
218 | state fork_state <<fork>> 
219 | state join_state <<join>>
220 | state ScriptEvent as "(active) ScriptEvent"
221 | state AudioRecording as "(active) AudioRecording"
222 | state Text as "(active) Text"
223 | 
224 | [*] - -> fork_state : programme\naudio
225 | fork_state - -> ScriptEvent
226 | note on link
227 |   When audio
228 |   mixing is active
229 | end note
230 | 
231 | ScriptEvent - -> Text
232 | AudioRecording - -> Text
233 | Text - -> join_state
234 | join_state - -> [*]
235 | 
236 | AudioRecording : Pan
237 | AudioRecording : Gain
238 | 
239 | Text : Pan
240 | Text : Gain
241 | 
242 | ScriptEvent : Pan
243 | ScriptEvent : Gain
244 | 
245 | fork_state - -> join_state
246 | note on link
247 |   When no audio
248 |   mixing is active
249 | end note
250 | 
251 | @enduml
252 | 
253 | PlantUML version 1.2022.7(Mon Aug 22 18:01:30 BST 2022)
254 | (GPL source distribution)
255 | Java Runtime: OpenJDK Runtime Environment
256 | JVM: OpenJDK 64-Bit Server VM
257 | Default Encoding: UTF-8
258 | Language: en
259 | Country: GB
260 | --></g></svg>


--------------------------------------------------------------------------------
/figures/webaudio-nodes.svg:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" height="657px" preserveAspectRatio="none" style="width:511px;height:657px;background:#FFFFFF;" version="1.1" viewBox="0 0 511 657" width="511px" zoomAndPan="magnify"><defs/><g><rect fill="#FFFFFF" height="40" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="195" x="12" y="113"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="179" x="20" y="139.0469">GainNode (ScriptEvent)</text><rect fill="#FFFFFF" height="40" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="187" x="22" y="197"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="171" x="30" y="223.0469">PanNode (ScriptEvent)</text><rect fill="#FFFFFF" height="40" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="143" x="204" y="445"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="127" x="212" y="471.0469">GainNode (Text)</text><rect fill="#FFFFFF" height="40" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="135" x="208" y="360"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="119" x="216" y="386.0469">PanNode (Text)</text><rect fill="#FFFFFF" height="40" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="233" x="272" y="113"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="217" x="280" y="139.0469">GainNode (AudioRecording)</text><rect fill="#FFFFFF" height="40" rx="12.5" ry="12.5" style="stroke:#000000;stroke-width:1.0;" width="225" x="275" y="197"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="209" x="283" y="223.0469">PanNode (AudioRecording)</text><rect fill="#000000" height="8" style="stroke:none;stroke-width:1.0;" width="80" x="235.5" y="542"/><rect fill="#000000" height="8" style="stroke:none;stroke-width:1.0;" width="80" x="235.5" y="295"/><ellipse cx="388.5" cy="21" fill="#000000" rx="10" ry="10" style="stroke:none;stroke-width:1.0;"/><ellipse cx="109.5" cy="21" fill="#000000" rx="10" ry="10" style="stroke:none;stroke-width:1.0;"/><g id="elem_GMN18"><path d="M33,281.5 L33,316.3438 A0,0 0 0 0 33,316.3438 L170,316.3438 A0,0 0 0 0 170,316.3438 L170,303 L235.3,299 L170,295 L170,291.5 L160,281.5 L33,281.5 A0,0 0 0 0 33,281.5 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><path d="M160,281.5 L160,291.5 L170,291.5 L160,281.5 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="110" x="42" y="304.9688">Implicit mixer</text></g><ellipse cx="275.5" cy="641" fill="none" rx="10" ry="10" style="stroke:#000000;stroke-width:1.0;"/><ellipse cx="276" cy="641.5" fill="#000000" rx="6" ry="6" style="stroke:none;stroke-width:1.0;"/><g id="elem_GMN26"><path d="M57,528.5 L57,563.3438 A0,0 0 0 0 57,563.3438 L170,563.3438 A0,0 0 0 0 170,563.3438 L170,550 L235.29,546 L170,542 L170,538.5 L160,528.5 L57,528.5 A0,0 0 0 0 57,528.5 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><path d="M160,528.5 L160,538.5 L170,538.5 L160,528.5 " fill="#FFFFFF" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="16" lengthAdjust="spacing" textLength="86" x="66" y="551.9688">Master bus</text></g><!--MD5=[78b84c9344a1481ca2e7569d755b7791]
  2 | link *start to GN1--><g id="link_start_GN1"><path d="M109.5,31.38 C109.5,47.81 109.5,82.34 109.5,106.33 " fill="none" id="start-to-GN1" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="109.5,111.28,113.5,102.28,109.5,106.28,105.5,102.28,109.5,111.28" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="112" x="113.5" y="76.0684">Programme Audio</text></g><!--MD5=[64ab020211cf346a2e3b3e5eba9983bf]
  3 | link GN1 to PN1--><g id="link_GN1_PN1"><path d="M110.92,153.43 C111.73,164.46 112.75,178.4 113.62,190.32 " fill="none" id="GN1-to-PN1" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="113.98,195.2,117.3003,185.9277,113.6085,190.2138,109.3224,186.522,113.98,195.2" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[6232ff64b2dab6949129b8cedba842c2]
  4 | link AS to GN3--><g id="link_AS_GN3"><path d="M388.5,31.38 C388.5,47.81 388.5,82.34 388.5,106.33 " fill="none" id="AS-to-GN3" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="388.5,111.28,392.5,102.28,388.5,106.28,384.5,102.28,388.5,111.28" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="100" x="392.5" y="68.5684">AudioRecording</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="83" x="392.5" y="83.8789">Source Audio</text></g><!--MD5=[8c9f34730db7b39be9c5d185a8c223b9]
  5 | link GN3 to PN3--><g id="link_GN3_PN3"><path d="M388.26,153.43 C388.13,164.46 387.96,178.4 387.81,190.32 " fill="none" id="GN3-to-PN3" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="387.75,195.19,391.8526,186.2363,387.8071,190.1903,383.8531,186.1449,387.75,195.19" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[7b9117d3f4916ae39ac847a760edb77a]
  6 | link PN1 to M1--><g id="link_PN1_M1"><path d="M154.23,237.37 C189.57,255.03 239.7,280.1 262.86,291.68 " fill="none" id="PN1-to-M1" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="267.29,293.9,261.0193,286.3054,262.815,291.6697,257.4507,293.4654,267.29,293.9" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[392c4814316265b60afd116479656829]
  7 | link PN3 to M1--><g id="link_PN3_M1"><path d="M360.39,237.37 C336.17,254.66 302.03,279.05 285.39,290.94 " fill="none" id="PN3-to-M1" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="281.34,293.83,290.9912,291.8666,285.4125,290.9292,286.3499,285.3506,281.34,293.83" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[b0470ef9598eb3db2fc9964596078660]
  8 | link M1 to PN2--><g id="link_M1_PN2"><path d="M275.5,303.39 C275.5,311.99 275.5,335.25 275.5,353.72 " fill="none" id="M1-to-PN2" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="275.5,358.26,279.5,349.26,275.5,353.26,271.5,349.26,275.5,358.26" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[d6a6dfaf610f79e560e3287744bb55f4]
  9 | link PN2 to GN2--><g id="link_PN2_GN2"><path d="M275.5,400.25 C275.5,411.59 275.5,426.07 275.5,438.36 " fill="none" id="PN2-to-GN2" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="275.5,443.05,279.5,434.05,275.5,438.05,271.5,434.05,275.5,443.05" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[8e9f8947328f5c06802704de4eb671b5]
 10 | link GN2 to MB--><g id="link_GN2_MB"><path d="M275.5,485.12 C275.5,501.16 275.5,523.36 275.5,535.73 " fill="none" id="GN2-to-MB" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="275.5,540.5,279.5,531.5,275.5,535.5,271.5,531.5,275.5,540.5" style="stroke:#000000;stroke-width:1.0;"/></g><!--MD5=[0d9006013d38754aabeedef9354d7659]
 11 | link MB to *end--><g id="link_MB_end"><path d="M275.5,550.09 C275.5,561.52 275.5,601.83 275.5,624.4 " fill="none" id="MB-to-end" style="stroke:#000000;stroke-width:1.0;"/><polygon fill="#000000" points="275.5,629.27,279.5,620.27,275.5,624.27,271.5,620.27,275.5,629.27" style="stroke:#000000;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="85" x="279.5" y="602.0684">Output Audio</text></g><!--MD5=[935a21dbf86ba8b57ffd0a43401515cc]
 12 | @startuml webaudio-nodes
 13 | !theme plain
 14 | !pragma ratio 1.3
 15 | skinparam groupInheritance 2
 16 | ' skinparam linetype ortho
 17 | skinparam DefaultFontName sans-serif
 18 | skinparam DefaultFontSize 16
 19 | skinparam ArrowFontSize 13
 20 | skinparam ArrowMessageAlignment direction
 21 | skinparam Padding 3
 22 | skinparam Nodesep 65
 23 | skinparam Ranksep 40
 24 | ' skinparam MinClassWidth 220
 25 | 
 26 | hide empty description
 27 | 
 28 | state GN1 as "GainNode (ScriptEvent)"
 29 | state PN1 as "PanNode (ScriptEvent)"
 30 | state GN2 as "GainNode (Text)"
 31 | state PN2 as "PanNode (Text)"
 32 | state GN3 as "GainNode (AudioRecording)"
 33 | state PN3 as "PanNode (AudioRecording)"
 34 | state MB as "Master Bus" <<join>>
 35 | state M1 as "+" <<join>>
 36 | state AS as "AudioRecording Source" <<start>>
 37 | 
 38 | [*] - -> GN1 : Programme Audio
 39 | GN1 - -> PN1
 40 | 
 41 | AS - -> GN3 : AudioRecording\lSource Audio
 42 | GN3 - -> PN3
 43 | 
 44 | PN1 - -> M1
 45 | PN3 - -> M1
 46 | 
 47 | note left of M1
 48 |   Implicit mixer
 49 | end note
 50 | 
 51 | M1 - -> PN2
 52 | PN2 - -> GN2
 53 | 
 54 | GN2 - -> MB
 55 | MB - -> [*] : Output Audio
 56 | 
 57 | note left of MB
 58 |   Master bus
 59 | end note
 60 | 
 61 | @enduml
 62 | 
 63 | @startuml webaudio-nodes
 64 | 
 65 | 
 66 | 
 67 | 
 68 | 
 69 | 
 70 | 
 71 | <style>
 72 |   root {
 73 |     BackgroundColor white
 74 |     FontColor black
 75 |     FontName Verdana
 76 |     HyperLinkColor blue
 77 |     LineColor black
 78 |     LineThickness 1
 79 |     Margin 5
 80 |   }
 81 |   caption {
 82 |     LineThickness 0
 83 |   }
 84 |   footer {
 85 |     LineThickness 0
 86 |   }
 87 |   header {
 88 |     LineThickness 0
 89 |   }
 90 |   node {
 91 |     MaximumWidth 300
 92 |   }
 93 |   title {
 94 |     FontSize 22
 95 |     LineThickness 0
 96 |   }
 97 | </style>
 98 | 
 99 | skinparam ArrowLollipopColor black
100 | skinparam BackgroundColor white
101 | skinparam DefaultFontName Verdana
102 | skinparam DefaultMonospacedFontName Courier
103 | skinparam LifelineStrategy nosolid
104 | skinparam ParticipantPadding 10
105 | skinparam SequenceLifeLineBorderColor black
106 | skinparam Shadowing false
107 | skinparam UseBetaStyle true
108 | 
109 | skinparam Activity {
110 |   BackgroundColor white
111 |   BarColor black
112 |   BorderColor black
113 |   FontColor black
114 |   FontName Verdana
115 | }
116 | skinparam Boundary {
117 |   FontColor black
118 | }
119 | skinparam Box {
120 |   Padding 5
121 | }
122 | skinparam CircledCharacter {
123 |   FontColor black
124 |   FontName Courier
125 |   Radius 9
126 | }
127 | skinparam Class {
128 |   BackgroundColor white
129 |   BorderColor black
130 |   FontColor black
131 |   FontName Verdana
132 | }
133 | skinparam ClassAttribute {
134 |   FontColor black
135 |   FontName Verdana
136 | }
137 | skinparam ClassStereotype {
138 |   FontColor black
139 |   FontName Verdana
140 | }
141 | skinparam Footer {
142 |   FontColor black
143 |   FontName Verdana
144 | }
145 | skinparam Header {
146 |   FontColor black
147 |   FontName Verdana
148 | }
149 | skinparam Hyperlink {
150 |   Color blue
151 | }
152 | skinparam IconPackage {
153 |   Color black
154 |   BackgroundColor white
155 | }
156 | skinparam IconPrivate {
157 |   Color black
158 |   BackgroundColor white
159 | }
160 | skinparam IconProtected {
161 |   Color black
162 |   BackgroundColor white
163 | }
164 | skinparam IconPublic {
165 |   Color black
166 |   BackgroundColor white
167 | }
168 | skinparam Note {
169 |   FontColor black
170 |   FontName Verdana
171 | }
172 | skinparam Object {
173 |   BorderColor black
174 | }
175 | skinparam Package {
176 |   BorderColor black
177 |   FontColor black
178 |   FontName Verdana
179 | }
180 | skinparam State {
181 |   BackgroundColor white
182 |   BorderColor black
183 | }
184 | skinparam StereotypeA {
185 |   BackgroundColor white
186 |   BorderColor black
187 | }
188 | skinparam StereotypeC {
189 |   BackgroundColor white
190 |   BorderColor black
191 | }
192 | skinparam StereotypeE {
193 |   BackgroundColor white
194 |   BorderColor black
195 | }
196 | skinparam StereotypeI {
197 |   BackgroundColor white
198 |   BorderColor black
199 | }
200 | skinparam StereotypeN {
201 |   BackgroundColor white
202 |   BorderColor black
203 | }
204 | skinparam UseCaseStereoType {
205 |   FontColor black
206 |   FontName Verdana
207 | }
208 | !pragma ratio 1.3
209 | skinparam groupInheritance 2
210 | skinparam DefaultFontName sans-serif
211 | skinparam DefaultFontSize 16
212 | skinparam ArrowFontSize 13
213 | skinparam ArrowMessageAlignment direction
214 | skinparam Padding 3
215 | skinparam Nodesep 65
216 | skinparam Ranksep 40
217 | 
218 | hide empty description
219 | 
220 | state GN1 as "GainNode (ScriptEvent)"
221 | state PN1 as "PanNode (ScriptEvent)"
222 | state GN2 as "GainNode (Text)"
223 | state PN2 as "PanNode (Text)"
224 | state GN3 as "GainNode (AudioRecording)"
225 | state PN3 as "PanNode (AudioRecording)"
226 | state MB as "Master Bus" <<join>>
227 | state M1 as "+" <<join>>
228 | state AS as "AudioRecording Source" <<start>>
229 | 
230 | [*] - -> GN1 : Programme Audio
231 | GN1 - -> PN1
232 | 
233 | AS - -> GN3 : AudioRecording\lSource Audio
234 | GN3 - -> PN3
235 | 
236 | PN1 - -> M1
237 | PN3 - -> M1
238 | 
239 | note left of M1
240 |   Implicit mixer
241 | end note
242 | 
243 | M1 - -> PN2
244 | PN2 - -> GN2
245 | 
246 | GN2 - -> MB
247 | MB - -> [*] : Output Audio
248 | 
249 | note left of MB
250 |   Master bus
251 | end note
252 | 
253 | @enduml
254 | 
255 | PlantUML version 1.2022.7(Mon Aug 22 18:01:30 BST 2022)
256 | (GPL source distribution)
257 | Java Runtime: OpenJDK Runtime Environment
258 | JVM: OpenJDK 64-Bit Server VM
259 | Default Encoding: UTF-8
260 | Language: en
261 | Country: GB
262 | --></g></svg>


--------------------------------------------------------------------------------
/xml-schemas/ttml2-datatypes.xsd:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <xs:schema targetNamespace="http://www.w3.org/ns/ttml#datatype"
  3 |         xml:lang="en" xmlns:xs="http://www.w3.org/2001/XMLSchema"
  4 |         xmlns:ttd="http://www.w3.org/ns/ttml#datatype">
  5 |   <xs:simpleType name="agent">
  6 |     <xs:restriction base="xs:IDREFS"/>
  7 |   </xs:simpleType>
  8 |   <xs:simpleType name="alpha">
  9 |     <xs:restriction base="xs:float"/>
 10 |   </xs:simpleType>
 11 |   <xs:simpleType name="animationValue">
 12 |     <xs:restriction base="xs:string"/>
 13 |   </xs:simpleType>
 14 |   <xs:simpleType name="animationValueList">
 15 |     <xs:annotation>
 16 |       <xs:documentation>animationValue [ ";" animationValue ]*</xs:documentation>
 17 |     </xs:annotation>
 18 |     <xs:restriction base="xs:string"/>
 19 |   </xs:simpleType>
 20 |   <xs:simpleType name="annotationPosition">
 21 |     <xs:restriction base="xs:token">
 22 |       <xs:enumeration value="before"/>
 23 |       <xs:enumeration value="after"/>
 24 |       <xs:enumeration value="outside"/>
 25 |     </xs:restriction>
 26 |   </xs:simpleType>
 27 |   <xs:simpleType name="areaRectangle">
 28 |     <xs:restriction base="xs:token">
 29 |       <xs:enumeration value="border"/>
 30 |       <xs:enumeration value="padding"/>
 31 |       <xs:enumeration value="content"/>
 32 |     </xs:restriction>
 33 |   </xs:simpleType>
 34 |   <xs:simpleType name="backgroundImage">
 35 |     <xs:union>
 36 |       <xs:simpleType>
 37 |         <xs:restriction base="xs:anyURI"/>
 38 |       </xs:simpleType>
 39 |       <xs:simpleType>
 40 |         <xs:restriction base="xs:token">
 41 |           <xs:enumeration value="none"/>
 42 |         </xs:restriction>
 43 |       </xs:simpleType>
 44 |     </xs:union>
 45 |   </xs:simpleType>
 46 |   <xs:simpleType name="backgroundRepeat">
 47 |     <xs:restriction base="xs:token">
 48 |       <xs:enumeration value="noRepeat"/>
 49 |       <xs:enumeration value="repeat"/>
 50 |       <xs:enumeration value="repeatX"/>
 51 |       <xs:enumeration value="repeatY"/>
 52 |     </xs:restriction>
 53 |   </xs:simpleType>
 54 |   <xs:simpleType name="border">
 55 |     <xs:annotation>
 56 |       <xs:documentation>[ borderThickness || borderStyle || borderColor ]</xs:documentation>
 57 |     </xs:annotation>
 58 |     <xs:restriction base="xs:string"/>
 59 |   </xs:simpleType>
 60 |   <xs:simpleType name="calcMode">
 61 |     <xs:restriction base="xs:token">
 62 |       <xs:enumeration value="discrete"/>
 63 |       <xs:enumeration value="linear"/>
 64 |       <xs:enumeration value="paced"/>
 65 |       <xs:enumeration value="spline"/>
 66 |     </xs:restriction>
 67 |   </xs:simpleType>
 68 |   <xs:simpleType name="cellResolution">
 69 |     <xs:annotation>
 70 |       <xs:documentation>non-negative-integer non-negative-integer</xs:documentation>
 71 |     </xs:annotation>
 72 |     <xs:restriction base="xs:string">
 73 |       <xs:pattern value="\p{Nd}+\s+\p{Nd}+"/>
 74 |     </xs:restriction>
 75 |   </xs:simpleType>
 76 |   <xs:simpleType name="clockMode">
 77 |     <xs:restriction base="xs:token">
 78 |       <xs:enumeration value="local"/>
 79 |       <xs:enumeration value="gps"/>
 80 |       <xs:enumeration value="utc"/>
 81 |     </xs:restriction>
 82 |   </xs:simpleType>
 83 |   <xs:simpleType name="color">
 84 |     <xs:restriction base="xs:string"/>
 85 |   </xs:simpleType>
 86 |   <xs:simpleType name="contentProfiles">
 87 |     <xs:restriction base="xs:string"/>
 88 |   </xs:simpleType>
 89 |   <xs:simpleType name="dataEncoding">
 90 |     <xs:restriction base="xs:token">
 91 |       <xs:enumeration value="base16"/>
 92 |       <xs:enumeration value="base32"/>
 93 |       <xs:enumeration value="base32hex"/>
 94 |       <xs:enumeration value="base64"/>
 95 |       <xs:enumeration value="base64url"/>
 96 |     </xs:restriction>
 97 |   </xs:simpleType>
 98 |   <xs:simpleType name="dataFormat">
 99 |     <xs:union>
100 |       <xs:simpleType>
101 |         <xs:restriction base="xs:anyURI"/>
102 |       </xs:simpleType>
103 |       <xs:simpleType>
104 |         <xs:restriction base="xs:token"/>
105 |       </xs:simpleType>
106 |     </xs:union>
107 |   </xs:simpleType>
108 |   <xs:simpleType name="dataLength">
109 |     <xs:annotation>
110 |       <xs:documentation>non-negative-integer</xs:documentation>
111 |     </xs:annotation>
112 |     <xs:restriction base="xs:string">
113 |       <xs:pattern value="\p{Nd}+"/>
114 |     </xs:restriction>
115 |   </xs:simpleType>
116 |   <xs:simpleType name="dataSource">
117 |     <xs:restriction base="xs:anyURI"/>
118 |   </xs:simpleType>
119 |   <xs:simpleType name="dataType">
120 |     <xs:restriction base="xs:string"/>
121 |   </xs:simpleType>
122 |   <xs:simpleType name="direction">
123 |     <xs:restriction base="xs:token">
124 |       <xs:enumeration value="ltr"/>
125 |       <xs:enumeration value="rtl"/>
126 |     </xs:restriction>
127 |   </xs:simpleType>
128 |   <xs:simpleType name="disparity">
129 |     <xs:annotation>
130 |       <xs:documentation>length</xs:documentation>
131 |     </xs:annotation>
132 |     <xs:restriction base="xs:string"/>
133 |   </xs:simpleType>
134 |   <xs:simpleType name="display">
135 |     <xs:restriction base="xs:token">
136 |       <xs:enumeration value="auto"/>
137 |       <xs:enumeration value="none"/>
138 |       <xs:enumeration value="inlineBlock"/>
139 |     </xs:restriction>
140 |   </xs:simpleType>
141 |   <xs:simpleType name="displayAlign">
142 |     <xs:restriction base="xs:token">
143 |       <xs:enumeration value="before"/>
144 |       <xs:enumeration value="center"/>
145 |       <xs:enumeration value="after"/>
146 |       <xs:enumeration value="justify"/>
147 |     </xs:restriction>
148 |   </xs:simpleType>
149 |   <xs:simpleType name="displayAspectRatio">
150 |     <xs:annotation>
151 |       <xs:documentation>non-negative-integer non-negative-integer</xs:documentation>
152 |     </xs:annotation>
153 |     <xs:restriction base="xs:string">
154 |       <xs:pattern value="\p{Nd}+\s+\p{Nd}+"/>
155 |     </xs:restriction>
156 |   </xs:simpleType>
157 |   <xs:simpleType name="dropMode">
158 |     <xs:restriction base="xs:token">
159 |       <xs:enumeration value="dropNTSC"/>
160 |       <xs:enumeration value="dropPAL"/>
161 |       <xs:enumeration value="nonDrop"/>
162 |     </xs:restriction>
163 |   </xs:simpleType>
164 |   <xs:simpleType name="extends">
165 |     <xs:restriction base="xs:anyURI"/>
166 |   </xs:simpleType>
167 |   <xs:simpleType name="extensionDesignator">
168 |     <xs:restriction base="xs:anyURI"/>
169 |   </xs:simpleType>
170 |   <xs:simpleType name="extensionValue">
171 |     <xs:restriction base="xs:token">
172 |       <xs:enumeration value="optional"/>
173 |       <xs:enumeration value="required"/>
174 |       <xs:enumeration value="use"/>
175 |       <xs:enumeration value="prohibited"/>
176 |     </xs:restriction>
177 |   </xs:simpleType>
178 |   <xs:simpleType name="extent">
179 |     <xs:annotation>
180 |       <xs:documentation>auto | contain | cover | measure measure</xs:documentation>
181 |     </xs:annotation>
182 |     <xs:restriction base="xs:string"/>
183 |   </xs:simpleType>
184 |   <xs:simpleType name="featureDesignator">
185 |     <xs:restriction base="xs:anyURI"/>
186 |   </xs:simpleType>
187 |   <xs:simpleType name="featureValue">
188 |     <xs:restriction base="xs:token">
189 |       <xs:enumeration value="optional"/>
190 |       <xs:enumeration value="required"/>
191 |       <xs:enumeration value="use"/>
192 |       <xs:enumeration value="prohibited"/>
193 |     </xs:restriction>
194 |   </xs:simpleType>
195 |   <xs:simpleType name="fill">
196 |     <xs:restriction base="xs:token">
197 |       <xs:enumeration value="freeze"/>
198 |       <xs:enumeration value="remove"/>
199 |     </xs:restriction>
200 |   </xs:simpleType>
201 |   <xs:simpleType name="fontFamily">
202 |     <xs:restriction base="xs:string"/>
203 |   </xs:simpleType>
204 |   <xs:simpleType name="fontKerning">
205 |     <xs:restriction base="xs:token">
206 |       <xs:enumeration value="none"/>
207 |       <xs:enumeration value="normal"/>
208 |     </xs:restriction>
209 |   </xs:simpleType>
210 |   <xs:simpleType name="fontRange">
211 |     <xs:restriction base="xs:string"/>
212 |   </xs:simpleType>
213 |   <xs:simpleType name="fontSelectionStrategy">
214 |     <xs:restriction base="xs:token">
215 |       <xs:enumeration value="auto"/>
216 |       <xs:enumeration value="character"/>
217 |     </xs:restriction>
218 |   </xs:simpleType>
219 |   <xs:simpleType name="fontSize">
220 |     <xs:annotation>
221 |       <xs:documentation>length | length length</xs:documentation>
222 |     </xs:annotation>
223 |     <xs:restriction base="xs:string"/>
224 |   </xs:simpleType>
225 |   <xs:simpleType name="fontStyle">
226 |     <xs:restriction base="xs:token">
227 |       <xs:enumeration value="normal"/>
228 |       <xs:enumeration value="italic"/>
229 |       <xs:enumeration value="oblique"/>
230 |     </xs:restriction>
231 |   </xs:simpleType>
232 |   <xs:simpleType name="fontVariant">
233 |     <xs:annotation>
234 |       <xs:documentation>normal | [ super | sub ] || [ full | half ] || ruby</xs:documentation>
235 |     </xs:annotation>
236 |     <xs:restriction base="xs:string"/>
237 |   </xs:simpleType>
238 |   <xs:simpleType name="fontWeight">
239 |     <xs:restriction base="xs:token">
240 |       <xs:enumeration value="normal"/>
241 |       <xs:enumeration value="bold"/>
242 |     </xs:restriction>
243 |   </xs:simpleType>
244 |   <xs:simpleType name="fragmentIdentifier">
245 |     <xs:annotation>
246 |       <xs:documentation>
247 |         fragmentIdentifier
248 |           : "#" fragment
249 | 
250 |         fragment
251 |           : uric+
252 | 
253 |         uric
254 |           : reserved
255 |           | unreserved
256 |           | escaped
257 | 
258 |         reserved
259 |           : [;/?:@&amp;=+$,]
260 | 
261 |         unreserved
262 |           : [a-zA-Z]
263 |           | [0-9]
264 |           | [-_.!~*'()]
265 | 
266 |         escaped
267 |           : "%" hex hex
268 | 
269 |         hex
270 |           : [0-9a-fA-F]
271 |       </xs:documentation>
272 |     </xs:annotation>
273 |     <xs:restriction base="xs:anyURI"/>
274 |   </xs:simpleType>
275 |   <xs:simpleType name="frameRate">
276 |     <xs:annotation>
277 |       <xs:documentation>non-negative-integer</xs:documentation>
278 |     </xs:annotation>
279 |     <xs:restriction base="xs:string">
280 |       <xs:pattern value="\p{Nd}+"/>
281 |     </xs:restriction>
282 |   </xs:simpleType>
283 |   <xs:simpleType name="frameRateMultiplier">
284 |     <xs:annotation>
285 |       <xs:documentation>non-negative-integer non-negative-integer</xs:documentation>
286 |     </xs:annotation>
287 |     <xs:restriction base="xs:string">
288 |       <xs:pattern value="\p{Nd}+\s+\p{Nd}+"/>
289 |     </xs:restriction>
290 |   </xs:simpleType>
291 |   <xs:simpleType name="gain">
292 |     <xs:annotation>
293 |       <xs:documentation>number</xs:documentation>
294 |     </xs:annotation>
295 |     <xs:restriction base="xs:string"/>   
296 |   </xs:simpleType>
297 |   <xs:simpleType name="inferProcessorProfileMethod">
298 |     <xs:restriction base="xs:token">
299 |       <xs:enumeration value="loose"/>
300 |       <xs:enumeration value="strict"/>
301 |     </xs:restriction>
302 |   </xs:simpleType>
303 |   <xs:simpleType name="inferProcessorProfileSource">
304 |     <xs:restriction base="xs:token">
305 |       <xs:enumeration value="combined"/>
306 |       <xs:enumeration value="first"/>
307 |     </xs:restriction>
308 |   </xs:simpleType>
309 |   <xs:simpleType name="keySplines">
310 |     <xs:annotation>
311 |       <xs:documentation>
312 |         keySplines
313 |           : control [ lwsp? ";" lwsp? control ]*
314 | 
315 |         control
316 |           : x1 comma? y1 comma? x2 comma? y2
317 | 
318 |         x1, x2, y1, y2
319 |           : coordinate
320 | 
321 |         coordinate                                // 0 ≥ value ≥ 1
322 |           : whole
323 |           | whole "." fraction
324 |           | "." fraction
325 | 
326 |         whole, fraction
327 |           : non-negative-integer
328 | 
329 |         comma
330 |           : ","
331 | 
332 |         lwsp
333 |           : ( ' ' | '\t' | '\n' | '\r' )+
334 |       </xs:documentation>
335 |     </xs:annotation>
336 |     <xs:restriction base="xs:string"/>
337 |   </xs:simpleType>
338 |   <xs:simpleType name="keyTimes">
339 |     <xs:annotation>
340 |       <xs:documentation>
341 |         keyTimes
342 |           : time [ lwsp? ";" lwsp? time ]*
343 | 
344 |         time                                // 0 ≥ value ≥ 1
345 |           : whole
346 |           | whole "." fraction
347 |           | "." fraction
348 | 
349 |         whole, fraction
350 |           : non-negative-integer
351 | 
352 |         lwsp
353 |           : ( ' ' | '\t' | '\n' | '\r' )+
354 |       </xs:documentation>
355 |     </xs:annotation>
356 |     <xs:restriction base="xs:string"/>
357 |   </xs:simpleType>
358 |   <xs:simpleType name="letterSpacing">
359 |     <xs:annotation>
360 |       <xs:documentation>normal | length</xs:documentation>
361 |     </xs:annotation>
362 |     <xs:restriction base="xs:string"/>
363 |   </xs:simpleType>
364 |   <xs:simpleType name="lineHeight">
365 |     <xs:annotation>
366 |       <xs:documentation>normal | length</xs:documentation>
367 |     </xs:annotation>
368 |     <xs:restriction base="xs:string"/>
369 |   </xs:simpleType>
370 |   <xs:simpleType name="luminanceGain">
371 |     <xs:annotation>
372 |       <xs:documentation>string</xs:documentation>
373 |     </xs:annotation>
374 |     <xs:restriction base="xs:string"/>
375 |   </xs:simpleType>
376 |   <xs:simpleType name="markerMode">
377 |     <xs:restriction base="xs:token">
378 |       <xs:enumeration value="continuous"/>
379 |       <xs:enumeration value="discontinuous"/>
380 |     </xs:restriction>
381 |   </xs:simpleType>
382 |   <xs:simpleType name="measure">
383 |     <xs:restriction base="xs:string"/>
384 |   </xs:simpleType>
385 |   <xs:simpleType name="metadataAgentType">
386 |     <xs:restriction base="xs:token">
387 |       <xs:enumeration value="person"/>
388 |       <xs:enumeration value="character"/>
389 |       <xs:enumeration value="group"/>
390 |       <xs:enumeration value="organization"/>
391 |       <xs:enumeration value="other"/>
392 |     </xs:restriction>
393 |   </xs:simpleType>
394 |   <xs:simpleType name="metadataItemName">
395 |     <xs:union>
396 |       <xs:simpleType>
397 |         <xs:restriction base="xs:token">
398 |           <xs:enumeration value="altText"/>
399 |           <xs:enumeration value="usesForced"/>
400 |         </xs:restriction>
401 |       </xs:simpleType>
402 |       <xs:simpleType>
403 |         <xs:restriction base="xs:QName"/>
404 |       </xs:simpleType>
405 |     </xs:union>
406 |   </xs:simpleType>
407 |   <xs:simpleType name="metadataNameType">
408 |     <xs:restriction base="xs:token">
409 |       <xs:enumeration value="full"/>
410 |       <xs:enumeration value="family"/>
411 |       <xs:enumeration value="given"/>
412 |       <xs:enumeration value="alias"/>
413 |       <xs:enumeration value="other"/>
414 |     </xs:restriction>
415 |   </xs:simpleType>
416 |   <xs:simpleType name="metadataRoleBaseType">
417 |     <xs:restriction base="xs:token">
418 |       <xs:enumeration value="action"/>
419 |       <xs:enumeration value="caption"/>
420 |       <xs:enumeration value="description"/>
421 |       <xs:enumeration value="dialog"/>
422 |       <xs:enumeration value="expletive"/>
423 |       <xs:enumeration value="kinesic"/>
424 |       <xs:enumeration value="lyrics"/>
425 |       <xs:enumeration value="music"/>
426 |       <xs:enumeration value="narration"/>
427 |       <xs:enumeration value="quality"/>
428 |       <xs:enumeration value="sound"/>
429 |       <xs:enumeration value="source"/>
430 |       <xs:enumeration value="suppressed"/>
431 |       <xs:enumeration value="reproduction"/>
432 |       <xs:enumeration value="thought"/>
433 |       <xs:enumeration value="title"/>
434 |       <xs:enumeration value="transcription"/>
435 |     </xs:restriction>
436 |   </xs:simpleType>
437 |   <xs:simpleType name="opacity">
438 |     <xs:annotation>
439 |       <xs:documentation>alpha</xs:documentation>
440 |     </xs:annotation>
441 |     <xs:restriction base="xs:string"/>
442 |   </xs:simpleType>
443 |   <xs:simpleType name="origin">
444 |     <xs:annotation>
445 |       <xs:documentation>auto | length length</xs:documentation>
446 |     </xs:annotation>
447 |     <xs:restriction base="xs:string"/>
448 |   </xs:simpleType>
449 |   <xs:simpleType name="overflow">
450 |     <xs:restriction base="xs:token">
451 |       <xs:enumeration value="visible"/>
452 |       <xs:enumeration value="hidden"/>
453 |     </xs:restriction>
454 |   </xs:simpleType>
455 |   <xs:simpleType name="padding">
456 |     <xs:annotation>
457 |       <xs:documentation>length length | length length length | length length length length</xs:documentation>
458 |     </xs:annotation>
459 |     <xs:restriction base="xs:string"/>
460 |   </xs:simpleType>
461 |   <xs:simpleType name="pan">
462 |     <xs:annotation>
463 |       <xs:documentation>number</xs:documentation>
464 |     </xs:annotation>
465 |     <xs:restriction base="xs:string"/>
466 |   </xs:simpleType>
467 |   <xs:simpleType name="permitFeatureNarrowingOrWidening">
468 |     <xs:restriction base="xs:boolean"/>
469 |   </xs:simpleType>
470 |   <xs:simpleType name="pitch">
471 |     <xs:annotation>
472 |       <xs:documentation>
473 |         pitch
474 |           : percentage
475 |           | number pitch-units?
476 | 
477 |         pitch-units
478 |           : "hz" | "st"
479 |       </xs:documentation>
480 |     </xs:annotation>
481 |     <xs:restriction base="xs:string"/>
482 |   </xs:simpleType>
483 |   <xs:simpleType name="pixelAspectRatio">
484 |     <xs:annotation>
485 |       <xs:documentation>non-negative-integer non-negative-integer</xs:documentation>
486 |     </xs:annotation>
487 |     <xs:restriction base="xs:string">
488 |       <xs:pattern value="\p{Nd}+\s+\p{Nd}+"/>
489 |     </xs:restriction>
490 |   </xs:simpleType>
491 |   <xs:simpleType name="position">
492 |     <xs:restriction base="xs:string"/>
493 |   </xs:simpleType>
494 |   <xs:simpleType name="processorProfiles">
495 |     <xs:restriction base="xs:string"/>
496 |   </xs:simpleType>
497 |   <xs:simpleType name="profile">
498 |     <xs:restriction base="xs:anyURI"/>
499 |   </xs:simpleType>
500 |   <xs:simpleType name="profileCombination">
501 |     <xs:restriction base="xs:token">
502 |       <xs:enumeration value="mostRestrictive"/>
503 |       <xs:enumeration value="leastRestrictive"/>
504 |       <xs:enumeration value="replace"/>
505 |       <xs:enumeration value="ignore"/>
506 |     </xs:restriction>
507 |   </xs:simpleType>
508 |   <xs:simpleType name="profileType">
509 |     <xs:restriction base="xs:token">
510 |       <xs:enumeration value="content"/>
511 |       <xs:enumeration value="processor"/>
512 |     </xs:restriction>
513 |   </xs:simpleType>
514 |   <xs:simpleType name="qualifiedName">
515 |     <xs:restriction base="xs:QName"/>
516 |   </xs:simpleType>
517 |   <xs:simpleType name="repeatCount">
518 |     <xs:annotation>
519 |       <xs:documentation>
520 |         repeatCount
521 |           : count                          // value &gt; 0
522 |           | "indefinite"
523 | 
524 |         count:
525 |           : whole
526 |           | whole "." fraction
527 |           | "." fraction
528 | 
529 |         whole, fraction
530 |           : non-negative-integer
531 |       </xs:documentation>
532 |     </xs:annotation>
533 |     <xs:restriction base="xs:string"/>
534 |   </xs:simpleType>
535 |   <xs:simpleType name="restricts">
536 |     <xs:restriction base="xs:anyURI"/>
537 |   </xs:simpleType>
538 |   <xs:simpleType name="role">
539 |     <xs:restriction>
540 |       <xs:simpleType>
541 |         <xs:list itemType="ttd:roleItem"/>
542 |       </xs:simpleType>
543 |     </xs:restriction>
544 |   </xs:simpleType>
545 |   <xs:simpleType name="roleItem">
546 |     <xs:annotation>
547 |       <xs:documentation>metadataRoleBaseType | "x-"string</xs:documentation>
548 |     </xs:annotation>
549 |     <xs:union>
550 |       <xs:simpleType>
551 |         <xs:restriction base="ttd:metadataRoleBaseType"/>
552 |       </xs:simpleType>
553 |       <xs:simpleType>
554 |         <xs:restriction base="xs:NMTOKEN">
555 |           <xs:pattern value="x-\c+"/>
556 |         </xs:restriction>
557 |       </xs:simpleType>
558 |     </xs:union>
559 |   </xs:simpleType>
560 |   <xs:simpleType name="ruby">
561 |     <xs:restriction base="xs:token">
562 |       <xs:enumeration value="none"/>
563 |       <xs:enumeration value="container"/>
564 |       <xs:enumeration value="base"/>
565 |       <xs:enumeration value="baseContainer"/>
566 |       <xs:enumeration value="text"/>
567 |       <xs:enumeration value="textContainer"/>
568 |       <xs:enumeration value="delimiter"/>
569 |     </xs:restriction>
570 |   </xs:simpleType>
571 |   <xs:simpleType name="rubyAlign">
572 |     <xs:restriction base="xs:token">
573 |       <xs:enumeration value="start"/>
574 |       <xs:enumeration value="center"/>
575 |       <xs:enumeration value="end"/>
576 |       <xs:enumeration value="spaceAround"/>
577 |       <xs:enumeration value="spaceBetween"/>
578 |       <xs:enumeration value="withBase"/>
579 |     </xs:restriction>
580 |   </xs:simpleType>
581 |   <xs:simpleType name="rubyPosition">
582 |     <xs:restriction base="ttd:annotationPosition"/>
583 |   </xs:simpleType>
584 |   <xs:simpleType name="rubyReserve">
585 |     <xs:restriction base="xs:string"/>
586 |   </xs:simpleType>
587 |   <xs:simpleType name="script">
588 |     <xs:restriction base="xs:string"/>
589 |   </xs:simpleType>
590 |   <xs:simpleType name="shear">
591 |     <xs:annotation>
592 |       <xs:documentation>percentage</xs:documentation>
593 |     </xs:annotation>
594 |     <xs:restriction base="xs:string"/>
595 |   </xs:simpleType>
596 |   <xs:simpleType name="showBackground">
597 |     <xs:restriction base="xs:token">
598 |       <xs:enumeration value="always"/>
599 |       <xs:enumeration value="whenActive"/>
600 |     </xs:restriction>
601 |   </xs:simpleType>
602 |   <xs:simpleType name="size">
603 |     <xs:annotation>
604 |       <xs:documentation>non-negative-integer</xs:documentation>
605 |     </xs:annotation>
606 |     <xs:restriction base="xs:string">
607 |       <xs:pattern value="\p{Nd}+"/>
608 |     </xs:restriction>
609 |   </xs:simpleType>
610 |   <xs:simpleType name="speak">
611 |     <xs:restriction base="xs:token">
612 |       <xs:enumeration value="none"/>
613 |       <xs:enumeration value="normal"/>
614 |       <xs:enumeration value="fast"/>
615 |       <xs:enumeration value="slow"/>
616 |     </xs:restriction>
617 |   </xs:simpleType>
618 |   <xs:simpleType name="subFrameRate">
619 |     <xs:annotation>
620 |       <xs:documentation>non-negative-integer</xs:documentation>
621 |     </xs:annotation>
622 |     <xs:restriction base="xs:string">
623 |       <xs:pattern value="\p{Nd}+"/>
624 |     </xs:restriction>
625 |   </xs:simpleType>
626 |   <xs:simpleType name="textAlign">
627 |     <xs:restriction base="xs:token">
628 |       <xs:enumeration value="left"/>
629 |       <xs:enumeration value="center"/>
630 |       <xs:enumeration value="right"/>
631 |       <xs:enumeration value="start"/>
632 |       <xs:enumeration value="end"/>
633 |       <xs:enumeration value="justify"/>
634 |     </xs:restriction>
635 |   </xs:simpleType>
636 |   <xs:simpleType name="textCombine">
637 |     <xs:restriction base="xs:token">
638 |       <xs:enumeration value="none"/>
639 |       <xs:enumeration value="all"/>
640 |     </xs:restriction>
641 |   </xs:simpleType>
642 |   <xs:simpleType name="textDecoration">
643 |     <xs:annotation>
644 |       <xs:documentation>none | [ [ underline | noUnderline ] || [ lineThrough | noLineThrough ] || [ overline | noOverline ] ]</xs:documentation>
645 |     </xs:annotation>
646 |     <xs:restriction base="xs:string">
647 |       <xs:enumeration value="none"/>
648 |       <xs:enumeration value="underline"/>
649 |       <xs:enumeration value="noUnderline"/>
650 |       <xs:enumeration value="lineThrough"/>
651 |       <xs:enumeration value="noLineThrough"/>
652 |       <xs:enumeration value="overline"/>
653 |       <xs:enumeration value="noOverline"/>
654 |       <xs:enumeration value="noUnderline noLineThrough"/>
655 |       <xs:enumeration value="noLineThrough noUnderline"/>
656 |       <xs:enumeration value="noUnderline lineThrough"/>
657 |       <xs:enumeration value="lineThrough noUnderline"/>
658 |       <xs:enumeration value="underline noLineThrough"/>
659 |       <xs:enumeration value="noLineThrough underline"/>
660 |       <xs:enumeration value="underline lineThrough"/>
661 |       <xs:enumeration value="lineThrough underline"/>
662 |       <xs:enumeration value="noUnderline noOverline"/>
663 |       <xs:enumeration value="noOverline noUnderline"/>
664 |       <xs:enumeration value="noUnderline overline"/>
665 |       <xs:enumeration value="overline noUnderline"/>
666 |       <xs:enumeration value="underline noOverline"/>
667 |       <xs:enumeration value="noOverline underline"/>
668 |       <xs:enumeration value="underline overline"/>
669 |       <xs:enumeration value="overline underline"/>
670 |       <xs:enumeration value="noUnderline noLineThrough noOverline"/>
671 |       <xs:enumeration value="noUnderline noOverline noLineThrough"/>
672 |       <xs:enumeration value="noLineThrough noUnderline noOverline"/>
673 |       <xs:enumeration value="noLineThrough noOverline noUnderline"/>
674 |       <xs:enumeration value="noOverline noUnderline noLineThrough"/>
675 |       <xs:enumeration value="noOverline noLineThrough noUnderline"/>
676 |       <xs:enumeration value="noUnderline noLineThrough overline"/>
677 |       <xs:enumeration value="noUnderline overline noLineThrough"/>
678 |       <xs:enumeration value="noLineThrough noUnderline overline"/>
679 |       <xs:enumeration value="noLineThrough overline noUnderline"/>
680 |       <xs:enumeration value="overline noUnderline noLineThrough"/>
681 |       <xs:enumeration value="overline noLineThrough noUnderline"/>
682 |       <xs:enumeration value="noUnderline lineThrough noOverline"/>
683 |       <xs:enumeration value="noUnderline noOverline lineThrough"/>
684 |       <xs:enumeration value="lineThrough noUnderline noOverline"/>
685 |       <xs:enumeration value="lineThrough noOverline noUnderline"/>
686 |       <xs:enumeration value="noOverline noUnderline lineThrough"/>
687 |       <xs:enumeration value="noOverline lineThrough noUnderline"/>
688 |       <xs:enumeration value="noUnderline lineThrough overline"/>
689 |       <xs:enumeration value="noUnderline overline lineThrough"/>
690 |       <xs:enumeration value="lineThrough noUnderline overline"/>
691 |       <xs:enumeration value="lineThrough overline noUnderline"/>
692 |       <xs:enumeration value="overline noUnderline lineThrough"/>
693 |       <xs:enumeration value="overline lineThrough noUnderline"/>
694 |       <xs:enumeration value="underline noLineThrough noOverline"/>
695 |       <xs:enumeration value="underline noOverline noLineThrough"/>
696 |       <xs:enumeration value="noLineThrough underline noOverline"/>
697 |       <xs:enumeration value="noLineThrough noOverline underline"/>
698 |       <xs:enumeration value="noOverline underline noLineThrough"/>
699 |       <xs:enumeration value="noOverline noLineThrough underline"/>
700 |       <xs:enumeration value="underline noLineThrough overline"/>
701 |       <xs:enumeration value="underline overline noLineThrough"/>
702 |       <xs:enumeration value="noLineThrough underline overline"/>
703 |       <xs:enumeration value="noLineThrough overline underline"/>
704 |       <xs:enumeration value="overline underline noLineThrough"/>
705 |       <xs:enumeration value="overline noLineThrough underline"/>
706 |       <xs:enumeration value="underline lineThrough noOverline"/>
707 |       <xs:enumeration value="underline noOverline lineThrough"/>
708 |       <xs:enumeration value="lineThrough underline noOverline"/>
709 |       <xs:enumeration value="lineThrough noOverline underline"/>
710 |       <xs:enumeration value="noOverline underline lineThrough"/>
711 |       <xs:enumeration value="noOverline lineThrough underline"/>
712 |       <xs:enumeration value="underline lineThrough overline"/>
713 |       <xs:enumeration value="underline overline lineThrough"/>
714 |       <xs:enumeration value="lineThrough underline overline"/>
715 |       <xs:enumeration value="lineThrough overline underline"/>
716 |       <xs:enumeration value="overline underline lineThrough"/>
717 |       <xs:enumeration value="overline lineThrough underline"/>
718 |     </xs:restriction>
719 |   </xs:simpleType>
720 |   <xs:simpleType name="textEmphasis">
721 |     <xs:annotation>
722 |       <xs:documentation>[ emphasisStyle || emphasisColor || emphasisPosition ]</xs:documentation>
723 |     </xs:annotation>
724 |     <xs:restriction base="xs:string"/>
725 |   </xs:simpleType>
726 |   <xs:simpleType name="textOrientation">
727 |     <xs:restriction base="xs:token">
728 |       <xs:enumeration value="mixed"/>
729 |       <xs:enumeration value="sideways"/>
730 |       <xs:enumeration value="upright"/>
731 |     </xs:restriction>
732 |   </xs:simpleType>
733 |   <xs:simpleType name="textOutline">
734 |     <xs:annotation>
735 |       <xs:documentation>none | length | length length | color length | color length length</xs:documentation>
736 |     </xs:annotation>
737 |     <xs:restriction base="xs:string"/>
738 |   </xs:simpleType>
739 |   <xs:simpleType name="textShadow">
740 |     <xs:annotation>
741 |       <xs:documentation>none | ( shadow )+</xs:documentation>
742 |     </xs:annotation>
743 |     <xs:restriction base="xs:string"/>
744 |   </xs:simpleType>
745 |   <xs:simpleType name="tickRate">
746 |     <xs:annotation>
747 |       <xs:documentation>non-negative-integer</xs:documentation>
748 |     </xs:annotation>
749 |     <xs:restriction base="xs:string">
750 |       <xs:pattern value="\p{Nd}+"/>
751 |     </xs:restriction>
752 |   </xs:simpleType>
753 |   <xs:simpleType name="timeBase">
754 |     <xs:restriction base="xs:token">
755 |       <xs:enumeration value="media"/>
756 |       <!-- <xs:enumeration value="smpte"/> smpte and clock are prohibited in DAPT
757 |       <xs:enumeration value="clock"/> -->
758 |     </xs:restriction>
759 |   </xs:simpleType>
760 |   <xs:simpleType name="timeContainer">
761 |     <xs:restriction base="xs:token">
762 |       <xs:enumeration value="par"/>
763 |       <!-- <xs:enumeration value="seq"/> timeContainer is prohibited in DAPT, default par value effectively the only one permitted -->
764 |     </xs:restriction>
765 |   </xs:simpleType>
766 |   <xs:simpleType name="timeCoordinate">
767 |     <xs:annotation>
768 |       <xs:documentation>timeExpression</xs:documentation>
769 |     </xs:annotation>
770 |     <xs:restriction base="xs:string"/>
771 |   </xs:simpleType>
772 |   <xs:simpleType name="timeDuration">
773 |     <xs:annotation>
774 |       <xs:documentation>timeExpression</xs:documentation>
775 |     </xs:annotation>
776 |     <xs:restriction base="xs:string"/>
777 |   </xs:simpleType>
778 |   <xs:simpleType name="unicodeBidi">
779 |     <xs:restriction base="xs:token">
780 |       <xs:enumeration value="normal"/>
781 |       <xs:enumeration value="embed"/>
782 |       <xs:enumeration value="bidiOverride"/>
783 |       <xs:enumeration value="isolate"/>
784 |     </xs:restriction>
785 |   </xs:simpleType>
786 |   <xs:simpleType name="validation">
787 |     <xs:restriction base="xs:token">
788 |       <xs:enumeration value="required"/>
789 |       <xs:enumeration value="optional"/>
790 |       <xs:enumeration value="prohibited"/>
791 |     </xs:restriction>
792 |   </xs:simpleType>
793 |   <xs:simpleType name="validationAction">
794 |     <xs:restriction base="xs:token">
795 |       <xs:enumeration value="abort"/>
796 |       <xs:enumeration value="warn"/>
797 |       <xs:enumeration value="ignore"/>
798 |     </xs:restriction>
799 |   </xs:simpleType>
800 |   <xs:simpleType name="version">
801 |     <xs:annotation>
802 |       <xs:documentation>
803 |         non-negative-integer               // value &gt; 0
804 |       </xs:documentation>
805 |     </xs:annotation>
806 |     <xs:restriction base="xs:string">
807 |       <xs:pattern value="\p{Nd}+"/>
808 |     </xs:restriction>
809 |   </xs:simpleType>
810 |   <xs:simpleType name="visibility">
811 |     <xs:restriction base="xs:token">
812 |       <xs:enumeration value="hidden"/>
813 |       <xs:enumeration value="visible"/>
814 |     </xs:restriction>
815 |   </xs:simpleType>
816 |   <xs:simpleType name="wrapOption">
817 |     <xs:restriction base="xs:token">
818 |       <xs:enumeration value="wrap"/>
819 |       <xs:enumeration value="noWrap"/>
820 |     </xs:restriction>
821 |   </xs:simpleType>
822 |   <xs:simpleType name="writingMode">
823 |     <xs:restriction base="xs:token">
824 |       <xs:enumeration value="lrtb"/>
825 |       <xs:enumeration value="rltb"/>
826 |       <xs:enumeration value="tbrl"/>
827 |       <xs:enumeration value="tblr"/>
828 |       <xs:enumeration value="lr"/>
829 |       <xs:enumeration value="rl"/>
830 |       <xs:enumeration value="tb"/>
831 |     </xs:restriction>
832 |   </xs:simpleType>
833 |   <xs:simpleType name="zIndex">
834 |     <xs:annotation>
835 |       <xs:documentation>auto | integer</xs:documentation>
836 |     </xs:annotation>
837 |     <xs:restriction base="xs:string"/>
838 |   </xs:simpleType>
839 | </xs:schema>
840 | 


--------------------------------------------------------------------------------