FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
matroska.c
Go to the documentation of this file.
1 /*
2  * Matroska common data
3  * Copyright (c) 2003-2004 The FFmpeg project
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 #include "libavutil/stereo3d.h"
23 
24 #include "matroska.h"
25 
26 /* If you add a tag here that is not in ff_codec_bmp_tags[]
27  or ff_codec_wav_tags[], add it also to additional_audio_tags[]
28  or additional_video_tags[] in matroskaenc.c */
30  {"A_AAC" , AV_CODEC_ID_AAC},
31  {"A_AC3" , AV_CODEC_ID_AC3},
32  {"A_ALAC" , AV_CODEC_ID_ALAC},
33  {"A_DTS" , AV_CODEC_ID_DTS},
34  {"A_EAC3" , AV_CODEC_ID_EAC3},
35  {"A_FLAC" , AV_CODEC_ID_FLAC},
36  {"A_MLP" , AV_CODEC_ID_MLP},
37  {"A_MPEG/L2" , AV_CODEC_ID_MP2},
38  {"A_MPEG/L1" , AV_CODEC_ID_MP1},
39  {"A_MPEG/L3" , AV_CODEC_ID_MP3},
40  {"A_OPUS" , AV_CODEC_ID_OPUS},
41  {"A_OPUS/EXPERIMENTAL",AV_CODEC_ID_OPUS},
42  {"A_PCM/FLOAT/IEEE" , AV_CODEC_ID_PCM_F32LE},
43  {"A_PCM/FLOAT/IEEE" , AV_CODEC_ID_PCM_F64LE},
44  {"A_PCM/INT/BIG" , AV_CODEC_ID_PCM_S16BE},
45  {"A_PCM/INT/BIG" , AV_CODEC_ID_PCM_S24BE},
46  {"A_PCM/INT/BIG" , AV_CODEC_ID_PCM_S32BE},
47  {"A_PCM/INT/LIT" , AV_CODEC_ID_PCM_S16LE},
48  {"A_PCM/INT/LIT" , AV_CODEC_ID_PCM_S24LE},
49  {"A_PCM/INT/LIT" , AV_CODEC_ID_PCM_S32LE},
50  {"A_PCM/INT/LIT" , AV_CODEC_ID_PCM_U8},
51  {"A_QUICKTIME/QDMC" , AV_CODEC_ID_QDMC},
52  {"A_QUICKTIME/QDM2" , AV_CODEC_ID_QDM2},
53  {"A_REAL/14_4" , AV_CODEC_ID_RA_144},
54  {"A_REAL/28_8" , AV_CODEC_ID_RA_288},
55  {"A_REAL/ATRC" , AV_CODEC_ID_ATRAC3},
56  {"A_REAL/COOK" , AV_CODEC_ID_COOK},
57  {"A_REAL/SIPR" , AV_CODEC_ID_SIPR},
58  {"A_TRUEHD" , AV_CODEC_ID_TRUEHD},
59  {"A_TTA1" , AV_CODEC_ID_TTA},
60  {"A_VORBIS" , AV_CODEC_ID_VORBIS},
61  {"A_WAVPACK4" , AV_CODEC_ID_WAVPACK},
62 
63  {"D_WEBVTT/SUBTITLES" , AV_CODEC_ID_WEBVTT},
64  {"D_WEBVTT/CAPTIONS" , AV_CODEC_ID_WEBVTT},
65  {"D_WEBVTT/DESCRIPTIONS", AV_CODEC_ID_WEBVTT},
66  {"D_WEBVTT/METADATA" , AV_CODEC_ID_WEBVTT},
67 
68  {"S_TEXT/UTF8" , AV_CODEC_ID_SUBRIP},
69  {"S_TEXT/UTF8" , AV_CODEC_ID_TEXT},
70  {"S_TEXT/ASCII" , AV_CODEC_ID_TEXT},
71  {"S_TEXT/ASS" , AV_CODEC_ID_ASS},
72  {"S_TEXT/SSA" , AV_CODEC_ID_ASS},
73  {"S_ASS" , AV_CODEC_ID_ASS},
74  {"S_SSA" , AV_CODEC_ID_ASS},
75  {"S_VOBSUB" , AV_CODEC_ID_DVD_SUBTITLE},
76  {"S_DVBSUB" , AV_CODEC_ID_DVB_SUBTITLE},
77  {"S_HDMV/PGS" , AV_CODEC_ID_HDMV_PGS_SUBTITLE},
78  {"S_HDMV/TEXTST" , AV_CODEC_ID_HDMV_TEXT_SUBTITLE},
79 
80  {"V_AV1" , AV_CODEC_ID_AV1},
81  {"V_DIRAC" , AV_CODEC_ID_DIRAC},
82  {"V_FFV1" , AV_CODEC_ID_FFV1},
83  {"V_MJPEG" , AV_CODEC_ID_MJPEG},
84  {"V_MPEG1" , AV_CODEC_ID_MPEG1VIDEO},
85  {"V_MPEG2" , AV_CODEC_ID_MPEG2VIDEO},
86  {"V_MPEG4/ISO/ASP" , AV_CODEC_ID_MPEG4},
87  {"V_MPEG4/ISO/AP" , AV_CODEC_ID_MPEG4},
88  {"V_MPEG4/ISO/SP" , AV_CODEC_ID_MPEG4},
89  {"V_MPEG4/ISO/AVC" , AV_CODEC_ID_H264},
90  {"V_MPEGH/ISO/HEVC" , AV_CODEC_ID_HEVC},
91  {"V_MPEG4/MS/V3" , AV_CODEC_ID_MSMPEG4V3},
92  {"V_PRORES" , AV_CODEC_ID_PRORES},
93  {"V_REAL/RV10" , AV_CODEC_ID_RV10},
94  {"V_REAL/RV20" , AV_CODEC_ID_RV20},
95  {"V_REAL/RV30" , AV_CODEC_ID_RV30},
96  {"V_REAL/RV40" , AV_CODEC_ID_RV40},
97  {"V_SNOW" , AV_CODEC_ID_SNOW},
98  {"V_THEORA" , AV_CODEC_ID_THEORA},
99  {"V_UNCOMPRESSED" , AV_CODEC_ID_RAWVIDEO},
100  {"V_VP8" , AV_CODEC_ID_VP8},
101  {"V_VP9" , AV_CODEC_ID_VP9},
102 
103  {"" , AV_CODEC_ID_NONE}
104 };
105 
107  {"V_VP8" , AV_CODEC_ID_VP8},
108  {"V_VP9" , AV_CODEC_ID_VP9},
109  {"V_AV1" , AV_CODEC_ID_AV1},
110 
111  {"A_VORBIS" , AV_CODEC_ID_VORBIS},
112  {"A_OPUS" , AV_CODEC_ID_OPUS},
113 
114  {"D_WEBVTT/SUBTITLES" , AV_CODEC_ID_WEBVTT},
115  {"D_WEBVTT/CAPTIONS" , AV_CODEC_ID_WEBVTT},
116  {"D_WEBVTT/DESCRIPTIONS", AV_CODEC_ID_WEBVTT},
117  {"D_WEBVTT/METADATA" , AV_CODEC_ID_WEBVTT},
118 
119  {"" , AV_CODEC_ID_NONE}
120 };
121 
123  {"image/gif" , AV_CODEC_ID_GIF},
124  {"image/jpeg" , AV_CODEC_ID_MJPEG},
125  {"image/png" , AV_CODEC_ID_PNG},
126  {"image/tiff" , AV_CODEC_ID_TIFF},
127 
128  {"" , AV_CODEC_ID_NONE}
129 };
130 
132  {"text/plain" , AV_CODEC_ID_TEXT},
133  {"application/x-truetype-font", AV_CODEC_ID_TTF},
134  {"application/x-font" , AV_CODEC_ID_TTF},
135  {"application/vnd.ms-opentype", AV_CODEC_ID_OTF},
136  {"binary" , AV_CODEC_ID_BIN_DATA},
137 
138  {"" , AV_CODEC_ID_NONE}
139 };
140 
142  { "LEAD_PERFORMER", "performer" },
143  { "PART_NUMBER" , "track" },
144  { 0 }
145 };
146 
148  "mono",
149  "left_right",
150  "bottom_top",
151  "top_bottom",
152  "checkerboard_rl",
153  "checkerboard_lr",
154  "row_interleaved_rl",
155  "row_interleaved_lr",
156  "col_interleaved_rl",
157  "col_interleaved_lr",
158  "anaglyph_cyan_red",
159  "right_left",
160  "anaglyph_green_magenta",
161  "block_lr",
162  "block_rl",
163 };
164 
166  "left",
167  "right",
168  "background",
169 };
170 
172 {
173  AVStereo3D *stereo;
174  int ret;
175 
176  stereo = av_stereo3d_alloc();
177  if (!stereo)
178  return AVERROR(ENOMEM);
179 
180  // note: the missing breaks are intentional
181  switch (stereo_mode) {
183  stereo->type = AV_STEREO3D_2D;
184  break;
186  stereo->flags |= AV_STEREO3D_FLAG_INVERT;
188  stereo->type = AV_STEREO3D_SIDEBYSIDE;
189  break;
191  stereo->flags |= AV_STEREO3D_FLAG_INVERT;
193  stereo->type = AV_STEREO3D_TOPBOTTOM;
194  break;
196  stereo->flags |= AV_STEREO3D_FLAG_INVERT;
198  stereo->type = AV_STEREO3D_CHECKERBOARD;
199  break;
201  stereo->flags |= AV_STEREO3D_FLAG_INVERT;
203  stereo->type = AV_STEREO3D_LINES;
204  break;
206  stereo->flags |= AV_STEREO3D_FLAG_INVERT;
208  stereo->type = AV_STEREO3D_COLUMNS;
209  break;
211  stereo->flags |= AV_STEREO3D_FLAG_INVERT;
214  break;
215  }
216 
218  sizeof(*stereo));
219  if (ret < 0) {
220  av_freep(&stereo);
221  return ret;
222  }
223 
224  return 0;
225 }
#define AV_STEREO3D_FLAG_INVERT
Inverted views, Right/Bottom represents the left view.
Definition: stereo3d.h:167
const char *const ff_matroska_video_stereo_plane[MATROSKA_VIDEO_STEREO_PLANE_COUNT]
Definition: matroska.c:165
This side data should be associated with a video stream and contains Stereoscopic 3D information in f...
Definition: avcodec.h:1226
Views are next to each other.
Definition: stereo3d.h:67
AVStereo3D * av_stereo3d_alloc(void)
Allocate an AVStereo3D structure and set its fields to default values.
Definition: stereo3d.c:28
MatroskaVideoStereoModeType
Definition: matroska.h:300
uint8_t
Stereo 3D type: this structure describes how two videos are packed within a single video surface...
Definition: stereo3d.h:176
int ff_mkv_stereo3d_conv(AVStream *st, MatroskaVideoStereoModeType stereo_mode)
Definition: matroska.c:171
Video is not stereoscopic (and metadata has to be there).
Definition: stereo3d.h:55
int flags
Additional information about the frame packing.
Definition: stereo3d.h:185
#define AVERROR(e)
Definition: error.h:43
Views are packed per line, as if interlaced.
Definition: stereo3d.h:129
const char *const ff_matroska_video_stereo_mode[MATROSKA_VIDEO_STEREOMODE_TYPE_NB]
Definition: matroska.c:147
preferred ID for decoding MPEG audio layer 1, 2 or 3
Definition: avcodec.h:559
const CodecMime ff_mkv_mime_tags[]
Definition: matroska.c:131
const CodecTags ff_webm_codec_tags[]
Definition: matroska.c:106
Views are alternated temporally.
Definition: stereo3d.h:92
int av_stream_add_side_data(AVStream *st, enum AVPacketSideDataType type, uint8_t *data, size_t size)
Wrap an existing array as stream side data.
Definition: utils.c:5491
#define MATROSKA_VIDEO_STEREO_PLANE_COUNT
Definition: matroska.h:360
preferred ID for MPEG-1/2 video decoding
Definition: avcodec.h:220
Stream structure.
Definition: avformat.h:874
enum AVStereo3DType type
How views are packed within the video.
Definition: stereo3d.h:180
Views are packed in a checkerboard-like structure per pixel.
Definition: stereo3d.h:104
Views are on top of each other.
Definition: stereo3d.h:79
const AVMetadataConv ff_mkv_metadata_conv[]
Definition: matroska.c:141
raw UTF-8 text
Definition: avcodec.h:653
Stereoscopic video.
Views are packed per column.
Definition: stereo3d.h:141
#define av_freep(p)
const CodecMime ff_mkv_image_mime_tags[]
Definition: matroska.c:122
const CodecTags ff_mkv_codec_tags[]
Definition: matroska.c:29