15c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)/*
25c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Copyright (C) 2011 Google Inc.  All rights reserved.
35c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) *
45c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Redistribution and use in source and binary forms, with or without
55c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * modification, are permitted provided that the following conditions
65c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * are met:
75c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 1. Redistributions of source code must retain the above copyright
85c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) *    notice, this list of conditions and the following disclaimer.
95c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 2. Redistributions in binary form must reproduce the above copyright
105c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) *    notice, this list of conditions and the following disclaimer in the
115c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) *    documentation and/or other materials provided with the distribution.
125c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) *
135c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
145c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
155c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
165c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
175c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
185c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
195c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
205c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
215c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
225c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
2381a5157921f1d2a7ff6aae115bfe3c139b38a5c8Torne (Richard Coles) * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
245c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) */
255c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)
2619cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)enum TextTrackMode { "disabled",  "hidden",  "showing" };
2719cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)enum TextTrackKind { "subtitles",  "captions",  "descriptions",  "chapters",  "metadata" };
2819cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)
2910f88d5669dbd969c059d61ba09fa37dd72ac559Ben Murdoch[
3010f88d5669dbd969c059d61ba09fa37dd72ac559Ben Murdoch    SetWrapperReferenceFrom=owner,
31f91f5fa1608c2cdd9af1842fb5dadbe78275be2aBo Liu    WillBeGarbageCollected,
3210f88d5669dbd969c059d61ba09fa37dd72ac559Ben Murdoch] interface TextTrack : EventTarget {
3319cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)    readonly attribute TextTrackKind kind;
345c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)    readonly attribute DOMString label;
355c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)    readonly attribute DOMString language;
365c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)
37a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles)    readonly attribute DOMString id;
38a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles)
3919cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)             attribute TextTrackMode mode;
405c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)
415c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)    readonly attribute TextTrackCueList cues;
425c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)    readonly attribute TextTrackCueList activeCues;
435c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)
4453e740f4a82e17f3ae59772501622dc354e42336Torne (Richard Coles)    void addCue(TextTrackCue cue);
4553e740f4a82e17f3ae59772501622dc354e42336Torne (Richard Coles)    [RaisesException] void removeCue(TextTrackCue cue);
465c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)
4719cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)             attribute EventHandler oncuechange;
4819cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)
4919cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)    [RuntimeEnabled=WebVTTRegions] readonly attribute VTTRegionList regions;
5019cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)    [RuntimeEnabled=WebVTTRegions] void addRegion(VTTRegion region);
5119cde67944066db31e633d9e386f2aa9bf9fadb3Torne (Richard Coles)    [RaisesException, RuntimeEnabled=WebVTTRegions] void removeRegion(VTTRegion region);
525c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)};
53