1 /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2 /* vim:set ts=2 sw=2 sts=2 et cindent: */
3 /* This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
7 #ifndef MediaMIMETypes_h_
8 #define MediaMIMETypes_h_
10 #include "VideoUtils.h"
11 #include "mozilla/Maybe.h"
17 struct AudioConfiguration
;
18 struct VideoConfiguration
;
21 // Class containing pointing at a media MIME "type/subtype" string literal.
22 // See IsMediaMIMEType for restrictions.
23 // Mainly used to help construct a MediaMIMEType through the statically-checked
24 // MEDIAMIMETYPE macro, or to compare a MediaMIMEType to a literal.
25 class DependentMediaMIMEType
{
27 // Construction from a literal. Checked in debug builds.
28 // Use MEDIAMIMETYPE macro instead, for static checking.
30 explicit DependentMediaMIMEType(const char (&aType
)[N
])
31 : mMIMEType(aType
, N
- 1) {
32 MOZ_ASSERT(IsMediaMIMEType(aType
, N
- 1), "Invalid media MIME type");
35 // MIME "type/subtype".
36 const nsDependentCString
& AsDependentString() const { return mMIMEType
; }
39 nsDependentCString mMIMEType
;
42 // Instantiate a DependentMediaMIMEType from a literal. Statically checked.
43 #define MEDIAMIMETYPE(LIT) \
44 static_cast<const DependentMediaMIMEType&>([]() { \
45 static_assert(IsMediaMIMEType(LIT), "Invalid media MIME type"); \
46 return DependentMediaMIMEType(LIT); \
49 // Class containing only pre-parsed lowercase media MIME type/subtype.
52 // Construction from a DependentMediaMIMEType, with its inherent checks.
53 // Implicit so MEDIAMIMETYPE can be used wherever a MediaMIMEType is expected.
54 MOZ_IMPLICIT
MediaMIMEType(const DependentMediaMIMEType
& aType
)
55 : mMIMEType(aType
.AsDependentString()) {}
57 // MIME "type/subtype", always lowercase.
58 const nsCString
& AsString() const { return mMIMEType
; }
60 // Comparison with DependentMediaMIMEType.
61 // Useful to compare to MEDIAMIMETYPE literals.
62 bool operator==(const DependentMediaMIMEType
& aOther
) const {
63 return mMIMEType
.Equals(aOther
.AsDependentString());
65 bool operator!=(const DependentMediaMIMEType
& aOther
) const {
66 return !mMIMEType
.Equals(aOther
.AsDependentString());
69 bool operator==(const MediaMIMEType
& aOther
) const {
70 return mMIMEType
.Equals(aOther
.mMIMEType
);
72 bool operator!=(const MediaMIMEType
& aOther
) const {
73 return !mMIMEType
.Equals(aOther
.mMIMEType
);
76 // True if type starts with "application/".
77 bool HasApplicationMajorType() const;
78 // True if type starts with "audio/".
79 // Note that some audio content could be stored in a "video/..." container!
80 bool HasAudioMajorType() const;
81 // True if type starts with "video/".
82 // Note that this does not guarantee 100% that the content is actually video!
83 // (e.g., "video/webm" could contain a vorbis audio track.)
84 bool HasVideoMajorType() const;
86 size_t SizeOfExcludingThis(mozilla::MallocSizeOf aMallocSizeOf
) const;
89 friend Maybe
<MediaMIMEType
> MakeMediaMIMEType(const nsAString
& aType
);
90 friend class MediaExtendedMIMEType
;
91 explicit MediaMIMEType(const nsACString
& aType
);
93 nsCString mMIMEType
; // UTF8 MIME "type/subtype".
96 Maybe
<MediaMIMEType
> MakeMediaMIMEType(const nsAString
& aType
);
97 Maybe
<MediaMIMEType
> MakeMediaMIMEType(const nsACString
& aType
);
98 Maybe
<MediaMIMEType
> MakeMediaMIMEType(const char* aType
);
100 // A list of case-sensitive codecs attached to a MediaExtendedMIMEType.
104 // Construction from a comma-separated list of codecs. Unchecked.
105 explicit MediaCodecs(const nsAString
& aCodecs
) : mCodecs(aCodecs
) {}
106 // Construction from a literal comma-separated list of codecs. Unchecked.
108 explicit MediaCodecs(const char (&aCodecs
)[N
])
109 : mCodecs(NS_ConvertUTF8toUTF16(aCodecs
, N
- 1)) {}
111 bool IsEmpty() const { return mCodecs
.IsEmpty(); }
112 const nsString
& AsString() const { return mCodecs
; }
115 const StringListRange
<nsString
,
116 StringListRangeEmptyItems::ProcessEmptyItems
>;
118 // Produces a range object with begin()&end(), can be used in range-for loops.
119 // This will iterate through all codecs, even empty ones (except if the
120 // original list was an empty string). Iterators dereference to
121 // 'const nsDependentString', valid for as long as this MediaCodecs object.
122 RangeType
Range() const { return RangeType(mCodecs
); };
124 // Does this list of codecs contain the given aCodec?
125 bool Contains(const nsAString
& aCodec
) const;
126 // Does this list of codecs contain *all* the codecs in the given list?
127 bool ContainsAll(const MediaCodecs
& aCodecs
) const;
129 // Does this list of codecs contain a codec starting with the given prefix?
130 bool ContainsPrefix(const nsAString
& aCodecPrefix
) const;
133 bool operator==(const char (&aType
)[N
]) const {
134 return mCodecs
.EqualsASCII(aType
, N
- 1);
137 size_t SizeOfExcludingThis(mozilla::MallocSizeOf aMallocSizeOf
) const;
140 // UTF16 comma-separated list of codecs.
141 // See http://www.rfc-editor.org/rfc/rfc4281.txt for the description
142 // of the 'codecs' parameter.
146 // Electro-Optical Transfer Functions
153 // Class containing pre-parsed media MIME type parameters, e.g.:
154 // MIME type/subtype, optional codecs, etc.
155 class MediaExtendedMIMEType
{
157 explicit MediaExtendedMIMEType(const MediaMIMEType
& aType
);
158 explicit MediaExtendedMIMEType(MediaMIMEType
&& aType
);
160 // MIME "type/subtype".
161 const MediaMIMEType
& Type() const { return mMIMEType
; }
163 // Was there an explicit 'codecs' parameter provided?
164 bool HaveCodecs() const { return mHaveCodecs
; }
165 // Codecs. May be empty if not provided or explicitly provided as empty.
166 const MediaCodecs
& Codecs() const { return mCodecs
; }
169 Maybe
<int32_t> GetWidth() const { return GetMaybeNumber(mWidth
); }
170 Maybe
<int32_t> GetHeight() const { return GetMaybeNumber(mHeight
); }
171 Maybe
<double> GetFramerate() const { return GetMaybeNumber(mFramerate
); }
172 Maybe
<int32_t> GetBitrate() const { return GetMaybeNumber(mBitrate
); }
173 Maybe
<int32_t> GetChannels() const { return GetMaybeNumber(mChannels
); }
174 Maybe
<int32_t> GetSamplerate() const { return GetMaybeNumber(mSamplerate
); }
175 Maybe
<EOTF
> GetEOTF() const {
176 return (mEOTF
== EOTF::UNSPECIFIED
) ? Nothing() : Some(mEOTF
);
179 // Original string. Note that "type/subtype" may not be lowercase,
180 // use Type().AsString() instead to get the normalized "type/subtype".
181 const nsCString
& OriginalString() const { return mOriginalString
; }
183 size_t SizeOfExcludingThis(mozilla::MallocSizeOf aMallocSizeOf
) const;
185 // aFrac is either a floating-point number or a fraction made of two
186 // floating-point numbers.
187 static Maybe
<double> ComputeFractionalString(const nsAString
& aFrac
);
190 friend Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(
191 const nsAString
& aType
);
192 friend Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(
193 const dom::VideoConfiguration
& aConfig
);
194 friend Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(
195 const dom::AudioConfiguration
& aConfig
);
197 MediaExtendedMIMEType(const nsACString
& aOriginalString
,
198 const nsACString
& aMIMEType
, bool aHaveCodecs
,
199 const nsAString
& aCodecs
, int32_t aWidth
,
200 int32_t aHeight
, double aFramerate
, int32_t aBitrate
,
201 EOTF aEOTF
= EOTF::UNSPECIFIED
, int32_t aChannels
= -1);
202 MediaExtendedMIMEType(const nsACString
& aOriginalString
,
203 const nsACString
& aMIMEType
, bool aHaveCodecs
,
204 const nsAString
& aCodecs
, int32_t aChannels
,
205 int32_t aSamplerate
, int32_t aBitrate
);
207 template <typename T
>
208 Maybe
<T
> GetMaybeNumber(T aNumber
) const {
209 return (aNumber
< 0) ? Maybe
<T
>(Nothing()) : Some(T(aNumber
));
212 nsCString mOriginalString
; // Original full string.
213 MediaMIMEType mMIMEType
; // MIME type/subtype.
214 bool mHaveCodecs
= false; // If false, mCodecs must be empty.
217 int32_t mWidth
= -1; // -1 if not provided.
218 int32_t mHeight
= -1; // -1 if not provided.
219 double mFramerate
= -1; // -1 if not provided.
220 EOTF mEOTF
= EOTF::UNSPECIFIED
;
222 int32_t mChannels
= -1; // -1 if not provided.
223 int32_t mSamplerate
= -1; // -1 if not provided.
224 // For both audio and video.
225 int32_t mBitrate
= -1; // -1 if not provided.
228 Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(const nsAString
& aType
);
229 Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(const nsACString
& aType
);
230 Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(const char* aType
);
231 Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(
232 const dom::VideoConfiguration
& aConfig
);
233 Maybe
<MediaExtendedMIMEType
> MakeMediaExtendedMIMEType(
234 const dom::AudioConfiguration
& aConfig
);
236 } // namespace mozilla
238 #endif // MediaMIMETypes_h_