1 /* GStreamer 2 * Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu> 3 * 4 * This library is free software; you can redistribute it and/or 5 * modify it under the terms of the GNU Library General Public 6 * License as published by the Free Software Foundation; either 7 * version 2 of the License, or (at your option) any later version. 8 * 9 * This library is distributed in the hope that it will be useful, 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 12 * Library General Public License for more details. 13 * 14 * You should have received a copy of the GNU Library General Public 15 * License along with this library; if not, write to the 16 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, 17 * Boston, MA 02110-1301, USA. 18 */ 19 20 #ifndef __GST_FFMPEG_CODECMAP_H__ 21 #define __GST_FFMPEG_CODECMAP_H__ 22 23 #include <libavcodec/avcodec.h> 24 #include <gst/gst.h> 25 #include <gst/audio/audio.h> 26 #include <gst/video/video.h> 27 28 /** 29 * GstFFMpegCompliance: 30 * @GST_FFMPEG_VERY_STRICT: Strictly conform to an older 31 * more strict version of the spec or reference software 32 * @GST_FFMPEG_STRICT: Strictly conform to all the things 33 * in the spec no matter what consequences. 34 * @GST_FFMPEG_NORMAL: 35 * @GST_FFMPEG_UNOFFICIAL: Allow unofficial extensions 36 * @GST_FFMPEG_EXPERIMENTAL: Allow nonstandardized 37 * experimental things. 38 * 39 * This setting instructs libav on how strictly it should follow the 40 * associated standard. 41 * 42 * From avcodec.h: 43 * Setting this to STRICT or higher means the encoder and decoder will 44 * generally do stupid things, whereas setting it to unofficial or lower 45 * will mean the encoder might produce output that is not supported by all 46 * spec-compliant decoders. Decoders don't differentiate between normal, 47 * unofficial and experimental (that is, they always try to decode things 48 * when they can) unless they are explicitly asked to behave stupidly 49 * (=strictly conform to the specs) 50 */ 51 typedef enum { 52 GST_FFMPEG_VERY_STRICT = FF_COMPLIANCE_VERY_STRICT, 53 GST_FFMPEG_STRICT = FF_COMPLIANCE_STRICT, 54 GST_FFMPEG_NORMAL = FF_COMPLIANCE_NORMAL, 55 GST_FFMPEG_UNOFFICIAL = FF_COMPLIANCE_UNOFFICIAL, 56 GST_FFMPEG_EXPERIMENTAL = FF_COMPLIANCE_EXPERIMENTAL, 57 } GstFFMpegCompliance; 58 59 /* 60 * _compliance_get_type () Returns an enum type that can be 61 * used as a property to indicate desired FFMpeg adherence to 62 * an associated specification 63 */ 64 65 GType 66 gst_ffmpeg_compliance_get_type (void); 67 #define GST_TYPE_FFMPEG_COMPLIANCE (gst_ffmpeg_compliance_get_type ()) 68 #define FFMPEG_DEFAULT_COMPLIANCE GST_FFMPEG_NORMAL 69 70 /* 71 * _codecid_is_image() returns TRUE for image formats 72 */ 73 gboolean 74 gst_ffmpeg_codecid_is_image (enum AVCodecID codec_id); 75 76 /* 77 * _codecid_to_caps () gets the GstCaps that belongs to 78 * a certain CodecID for a pad with compressed data. 79 */ 80 81 GstCaps * 82 gst_ffmpeg_codecid_to_caps (enum AVCodecID codec_id, 83 AVCodecContext *context, 84 gboolean encode); 85 86 /* 87 * _codectype_to_caps () gets the GstCaps that belongs to 88 * a certain AVMediaType for a pad with uncompressed data. 89 */ 90 91 GstCaps * 92 gst_ffmpeg_codectype_to_audio_caps (AVCodecContext *context, 93 enum AVCodecID codec_id, 94 gboolean encode, 95 AVCodec *codec); 96 GstCaps * 97 gst_ffmpeg_codectype_to_video_caps (AVCodecContext *context, 98 enum AVCodecID codec_id, 99 gboolean encode, 100 AVCodec *codec); 101 102 /* 103 * caps_to_codecid () transforms a GstCaps that belongs to 104 * a pad for compressed data to (optionally) a filled-in 105 * context and a codecID. 106 */ 107 108 enum AVCodecID 109 gst_ffmpeg_caps_to_codecid (const GstCaps *caps, 110 AVCodecContext *context); 111 112 /* 113 * caps_with_codecid () transforms a GstCaps for a known codec 114 * ID into a filled-in context. 115 */ 116 117 void 118 gst_ffmpeg_caps_with_codecid (enum AVCodecID codec_id, 119 enum AVMediaType codec_type, 120 const GstCaps *caps, 121 AVCodecContext *context); 122 123 /* 124 * caps_with_codectype () transforms a GstCaps that belongs to 125 * a pad for uncompressed data to a filled-in context. 126 */ 127 128 void 129 gst_ffmpeg_caps_with_codectype (enum AVMediaType type, 130 const GstCaps *caps, 131 AVCodecContext *context); 132 133 void 134 gst_ffmpeg_videoinfo_to_context (GstVideoInfo *info, 135 AVCodecContext *context); 136 137 void 138 gst_ffmpeg_audioinfo_to_context (GstAudioInfo *info, 139 AVCodecContext *context); 140 141 GstVideoFormat gst_ffmpeg_pixfmt_to_videoformat (enum AVPixelFormat pixfmt); 142 enum AVPixelFormat gst_ffmpeg_videoformat_to_pixfmt (GstVideoFormat format); 143 144 GstAudioFormat gst_ffmpeg_smpfmt_to_audioformat (enum AVSampleFormat sample_fmt, 145 GstAudioLayout * layout); 146 147 /* 148 * _formatid_to_caps () is meant for muxers/demuxers, it 149 * transforms a name (ffmpeg way of ID'ing these, why don't 150 * they have unique numerical IDs?) to the corresponding 151 * caps belonging to that mux-format 152 */ 153 154 GstCaps * 155 gst_ffmpeg_formatid_to_caps (const gchar *format_name); 156 157 /* 158 * _formatid_get_codecids () can be used to get the codecIDs 159 * (AV_CODEC_ID_NONE-terminated list) that fit that specific 160 * output format. 161 */ 162 163 gboolean 164 gst_ffmpeg_formatid_get_codecids (const gchar *format_name, 165 enum AVCodecID ** video_codec_list, 166 enum AVCodecID ** audio_codec_list, 167 AVOutputFormat * plugin); 168 169 170 gboolean 171 gst_ffmpeg_channel_layout_to_gst (guint64 channel_layout, gint channels, 172 GstAudioChannelPosition * pos); 173 174 #endif /* __GST_FFMPEG_CODECMAP_H__ */ 175