blob: f381a420b644d9e1c520fa8fea99b94ff7f98fb2 [file] [log] [blame]
Jiho Chang502ad5d2012-06-05 09:10:01 +00001<?xml version="1.0" encoding="utf-8" ?>
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -07002<!-- Copyright (C) 2012 The Android Open Source Project
3
4 Licensed under the Apache License, Version 2.0 (the "License");
5 you may not use this file except in compliance with the License.
6 You may obtain a copy of the License at
7
8 http://www.apache.org/licenses/LICENSE-2.0
9
10 Unless required by applicable law or agreed to in writing, software
11 distributed under the License is distributed on an "AS IS" BASIS,
12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 See the License for the specific language governing permissions and
14 limitations under the License.
15-->
16
17<!--
18<!DOCTYPE MediaCodecs [
19<!ELEMENT MediaCodecs (Decoders,Encoders)>
20<!ELEMENT Decoders (MediaCodec*)>
21<!ELEMENT Encoders (MediaCodec*)>
22<!ELEMENT MediaCodec (Type*,Quirk*)>
23<!ATTLIST MediaCodec name CDATA #REQUIRED>
24<!ATTLIST MediaCodec type CDATA>
25<!ELEMENT Type EMPTY>
26<!ATTLIST Type name CDATA #REQUIRED>
27<!ELEMENT Quirk EMPTY>
28<!ATTLIST Quirk name CDATA #REQUIRED>
29]>
30
31There's a simple and a complex syntax to declare the availability of a
32media codec:
33
34A codec that properly follows the OpenMax spec and therefore doesn't have any
35quirks and that only supports a single content type can be declared like so:
36
37 <MediaCodec name="OMX.foo.bar" type="something/interesting" />
38
39If a codec has quirks OR supports multiple content types, the following syntax
40can be used:
41
42 <MediaCodec name="OMX.foo.bar" >
43 <Type name="something/interesting" />
44 <Type name="something/else" />
45 ...
46 <Quirk name="requires-allocate-on-input-ports" />
47 <Quirk name="requires-allocate-on-output-ports" />
48 <Quirk name="output-buffers-are-unreadable" />
49 </MediaCodec>
50
51Only the three quirks included above are recognized at this point:
52
53"requires-allocate-on-input-ports"
54 must be advertised if the component does not properly support specification
55 of input buffers using the OMX_UseBuffer(...) API but instead requires
56 OMX_AllocateBuffer to be used.
57
58"requires-allocate-on-output-ports"
59 must be advertised if the component does not properly support specification
60 of output buffers using the OMX_UseBuffer(...) API but instead requires
61 OMX_AllocateBuffer to be used.
62
63"output-buffers-are-unreadable"
64 must be advertised if the emitted output buffers of a decoder component
65 are not readable, i.e. use a custom format even though abusing one of
66 the official OMX colorspace constants.
67 Clients of such decoders will not be able to access the decoded data,
68 naturally making the component much less useful. The only use for
69 a component with this quirk is to render the output to the screen.
70 Audio decoders MUST NOT advertise this quirk.
71 Video decoders that advertise this quirk must be accompanied by a
72 corresponding color space converter for thumbnail extraction,
73 matching surfaceflinger support that can render the custom format to
74 a texture and possibly other code, so just DON'T USE THIS QUIRK.
75
76-->
77
78<MediaCodecs>
79 <Decoders>
Jiho Changbefcf4c2012-06-05 10:44:36 +000080 <MediaCodec name="OMX.Exynos.MPEG4.Decoder" type="video/mp4v-es" >
81 <Quirk name="requires-allocate-on-input-ports" />
82 <Quirk name="requires-allocate-on-output-ports" />
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -070083 </MediaCodec>
Jiho Changbefcf4c2012-06-05 10:44:36 +000084 <MediaCodec name="OMX.Exynos.H263.Decoder" type="video/3gpp" >
85 <Quirk name="requires-allocate-on-input-ports" />
86 <Quirk name="requires-allocate-on-output-ports" />
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -070087 </MediaCodec>
Jiho Changbefcf4c2012-06-05 10:44:36 +000088 <MediaCodec name="OMX.Exynos.AVC.Decoder" type="video/avc" >
89 <Quirk name="requires-allocate-on-input-ports" />
90 <Quirk name="requires-allocate-on-output-ports" />
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -070091 </MediaCodec>
Dima Zavin842cb0f2012-06-13 16:47:20 -070092 <MediaCodec name="OMX.Exynos.VP8.Decoder" type="video/x-vnd.on2.vp8" >
93 <Quirk name="requires-allocate-on-input-ports" />
94 <Quirk name="requires-allocate-on-output-ports" />
95 </MediaCodec>
96
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -070097 <MediaCodec name="OMX.google.mp3.decoder" type="audio/mpeg" />
98 <MediaCodec name="OMX.google.amrnb.decoder" type="audio/3gpp" />
99 <MediaCodec name="OMX.google.amrwb.decoder" type="audio/amr-wb" />
100 <MediaCodec name="OMX.google.aac.decoder" type="audio/mp4a-latm" />
101 <MediaCodec name="OMX.google.g711.alaw.decoder" type="audio/g711-alaw" />
102 <MediaCodec name="OMX.google.g711.mlaw.decoder" type="audio/g711-mlaw" />
103 <MediaCodec name="OMX.google.vorbis.decoder" type="audio/vorbis" />
104
105 <MediaCodec name="OMX.google.mpeg4.decoder" type="video/mp4v-es" />
106 <MediaCodec name="OMX.google.h263.decoder" type="video/3gpp" />
107 <MediaCodec name="OMX.google.h264.decoder" type="video/avc" />
108 <MediaCodec name="OMX.google.vpx.decoder" type="video/x-vnd.on2.vp8" />
109 </Decoders>
110
111 <Encoders>
SeungBeom Kimbc2e2ad2012-07-21 09:09:00 +0900112 <MediaCodec name="OMX.Exynos.AVC.Encoder" type="video/avc" >
113 <Quirk name="requires-allocate-on-input-ports" />
114 <Quirk name="requires-allocate-on-output-ports" />
115 </MediaCodec>
116 <MediaCodec name="OMX.Exynos.H263.Encoder" type="video/3gpp" >
117 <Quirk name="requires-allocate-on-input-ports" />
118 <Quirk name="requires-allocate-on-output-ports" />
119 </MediaCodec>
120 <MediaCodec name="OMX.Exynos.MPEG4.Encoder" type="video/mp4v-es" >
121 <Quirk name="requires-allocate-on-input-ports" />
122 <Quirk name="requires-allocate-on-output-ports" />
123 </MediaCodec>
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -0700124
125 <MediaCodec name="OMX.google.amrnb.encoder" type="audio/3gpp" />
126 <MediaCodec name="OMX.google.amrwb.encoder" type="audio/amr-wb" />
127 <MediaCodec name="OMX.google.aac.encoder" type="audio/mp4a-latm" />
Jean-Michel Trivi4baefaf2012-05-09 15:51:30 -0700128 <MediaCodec name="OMX.google.flac.encoder" type="audio/flac" />
Rebecca Schultz Zavinc2c95e12012-04-04 16:26:48 -0700129 </Encoders>
130</MediaCodecs>