File: TrackInfo.h

package info (click to toggle)
webkit2gtk 2.51.4-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 481,584 kB
  • sloc: cpp: 3,903,132; javascript: 198,251; ansic: 165,758; python: 51,432; asm: 21,819; ruby: 18,095; perl: 16,963; xml: 4,623; sh: 2,408; yacc: 2,356; java: 2,019; lex: 1,358; pascal: 372; makefile: 203
file content (264 lines) | stat: -rw-r--r-- 8,276 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
/*
 * Copyright (C) 2025 Apple Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 * THE POSSIBILITY OF SUCH DAMAGE.
 */

#pragma once

#include <WebCore/FloatSize.h>
#include <WebCore/FourCC.h>
#include <WebCore/ImmersiveVideoMetadata.h>
#include <WebCore/MediaPlayerEnums.h>
#include <WebCore/PlatformVideoColorSpace.h>
#include <WebCore/SharedBuffer.h>
#include <wtf/Ref.h>
#include <wtf/RefPtr.h>
#include <wtf/ThreadSafeRefCounted.h>
#include <wtf/Variant.h>

namespace IPC {
template<typename> struct ArgumentCoder;
}

namespace WebCore {

using TrackID = uint64_t;
class AudioInfo;
class VideoInfo;

enum class TrackInfoTrackType : uint8_t {
    Unknown,
    Audio,
    Video,
    Text
};

String convertEnumerationToString(TrackInfoTrackType);

enum class EncryptionBoxType : uint8_t {
    CommonEncryptionTrackEncryptionBox,
    TransportStreamEncryptionInitData
};

using TrackInfoAtomData = std::pair<FourCC, Ref<SharedBuffer>>;
#if ENABLE(ENCRYPTED_MEDIA)
using TrackInfoEncryptionData = std::pair<EncryptionBoxType, Ref<SharedBuffer>>;
using TrackInfoEncryptionInitData = TrackInfoAtomData;

struct EncryptionDataCollection {
    TrackInfoEncryptionData encryptionData;
    FourCC encryptionOriginalFormat;
    Vector<TrackInfoEncryptionInitData> encryptionInitDatas { };

    bool operator==(const EncryptionDataCollection&) const = default;
};
#endif

struct TrackInfoData {
    const FourCC codecName { };
    const String codecString { };
    TrackID trackID { 0 };

#if ENABLE(ENCRYPTED_MEDIA)
    std::optional<EncryptionDataCollection> encryptionData { };
#endif

    bool operator==(const TrackInfoData&) const = default;
};

class TrackInfo : public ThreadSafeRefCounted<TrackInfo> {
public:
    virtual ~TrackInfo() = default;
    using TrackType = TrackInfoTrackType;

    bool isAudio() const { return type() == TrackType::Audio; }
    bool isVideo() const { return type() == TrackType::Video; }

    TrackType type() const { return m_type; }

    bool operator==(const TrackInfo& other) const
    {
        if (m_data != other.m_data)
            return false;
        return equalTo(other);
    }

    FourCC codecName() const { return m_data.codecName; }
    const String& codecString() const { return m_data.codecString; }

    TrackID trackID() const { return m_data.trackID; };
    void setTrackID(TrackID trackID) { m_data.trackID = trackID; }

    using AtomData = TrackInfoAtomData;
#if ENABLE(ENCRYPTED_MEDIA)
    const std::optional<EncryptionDataCollection>& encryptionDataCollection() const { return m_data.encryptionData; }
#endif

protected:
    TrackInfo(TrackType type, TrackInfoData&& data)
        : m_data(WTFMove(data))
        , m_type(type)
    {
    }

    virtual bool equalTo(const TrackInfo& other) const = 0;
    const TrackInfoData& trackInfoData() const { return m_data; }
    TrackInfoData& trackInfoData() { return m_data; }

private:
    TrackInfoData m_data;

    friend struct IPC::ArgumentCoder<TrackInfo>;
    Variant<Ref<AudioInfo>, Ref<VideoInfo>> toVariant() const
    {
        if (isAudio())
            return const_cast<AudioInfo&>(downcast<AudioInfo>(*this));
        return const_cast<VideoInfo&>(downcast<VideoInfo>(*this));
    }

    WEBCORE_EXPORT static Ref<TrackInfo> fromVariant(Variant<Ref<AudioInfo>, Ref<VideoInfo>>);
    const TrackType m_type { TrackType::Unknown };
};

struct VideoSpecificInfoData {
    FloatSize size { };
    // Size in pixels at which the video is rendered. This is after it has
    // been scaled by its aspect ratio.
    FloatSize displaySize { };
    uint8_t bitDepth { 8 };
    PlatformVideoColorSpace colorSpace { };
    Vector<TrackInfo::AtomData> extensionAtoms { };

#if PLATFORM(VISION)
    std::optional<ImmersiveVideoMetadata> immersiveVideoMetadata { };
#endif

    bool operator==(const VideoSpecificInfoData&) const = default;
};

using VideoInfoData = std::pair<TrackInfoData, VideoSpecificInfoData>;

class VideoInfo : public TrackInfo {
public:
    static Ref<VideoInfo> create(VideoInfoData&& data) { return adoptRef(*new VideoInfo(WTFMove(data))); }

    const FloatSize& size() const { return m_data.size; }
    // Size in pixels at which the video is rendered. This is after it has
    // been scaled by its aspect ratio.
    const FloatSize& displaySize() const { return m_data.displaySize; }
    uint8_t bitDepth() const { return m_data.bitDepth; }
    const PlatformVideoColorSpace& colorSpace() const { return m_data.colorSpace; }

    const Vector<AtomData>& extensionAtoms() const { return m_data.extensionAtoms; }

#if PLATFORM(VISION)
    const std::optional<ImmersiveVideoMetadata>& immersiveVideoMetadata() const { return m_data.immersiveVideoMetadata; }
#endif

    VideoInfoData toVideoInfoData() const
    {
        return { trackInfoData(), m_data };
    }

private:
    const VideoSpecificInfoData m_data;

private:
    explicit VideoInfo(VideoInfoData&& data)
        : TrackInfo(TrackType::Video, WTFMove(data.first))
        , m_data(WTFMove(data.second))
    {
    }

    bool equalTo(const TrackInfo& otherVideoInfo) const final
    {
        auto& other = downcast<const VideoInfo>(otherVideoInfo);
        return m_data == other.m_data;
    }
};

struct AudioSpecificInfoData {
    uint32_t rate { 0 };
    uint32_t channels { 0 };
    uint32_t framesPerPacket { 0 };
    uint8_t bitDepth { 16 };

    RefPtr<SharedBuffer> cookieData { };

    bool operator==(const AudioSpecificInfoData&) const = default;
};

using AudioInfoData = std::pair<TrackInfoData, AudioSpecificInfoData>;

class AudioInfo : public TrackInfo {
public:
    static Ref<AudioInfo> create(AudioInfoData&& data) { return adoptRef(*new AudioInfo(WTFMove(data))); }

    uint32_t rate() const { return m_data.rate; }
    uint32_t channels() const { return m_data.channels; }
    uint32_t framesPerPacket() const { return m_data.framesPerPacket; }
    uint8_t bitDepth() const { return m_data.bitDepth; }

    RefPtr<SharedBuffer> cookieData() const { return m_data.cookieData; }

    AudioInfoData toAudioInfoData() const
    {
        return { trackInfoData(), m_data };
    }

private:
    explicit AudioInfo(AudioInfoData&& data)
        : TrackInfo(TrackType::Audio, WTFMove(data.first))
        , m_data(WTFMove(data.second))
    {
    }

    bool equalTo(const TrackInfo& otherAudioInfo) const final
    {
        auto& other = downcast<const AudioInfo>(otherAudioInfo);
        return m_data == other.m_data;
    }
    const AudioSpecificInfoData m_data;
};

} // namespace WebCore

SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::VideoInfo)
    static bool isType(const WebCore::TrackInfo& info) { return info.isVideo(); }
SPECIALIZE_TYPE_TRAITS_END()

SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::AudioInfo)
    static bool isType(const WebCore::TrackInfo& info) { return info.isAudio(); }
SPECIALIZE_TYPE_TRAITS_END()

namespace WTF {

template <>
struct LogArgument<WebCore::TrackInfoTrackType> {
    static String toString(const WebCore::TrackInfoTrackType type)
    {
        return convertEnumerationToString(type);
    }
};

}