History

libavcodec: Add an OpenH264 encoder wrapper

Compared to existing, common opensource H264 encoders, this can be useful since it has got a different license (BSD instead of GPL). Performance- and qualitywise it is comparable to x264 in ultrafast mode. Hooking it up as an encoder in libavcodec also simplifies comparing it against other common encoders. This requires OpenH264 1.3 or newer. Since the OpenH264 API and ABI changes frequently, only releases are supported. To take advantage of the OpenH264 patent offer, the OpenH264 library must not be redistributed, but downloaded at runtime at the end-user's system.

Martin Storsjö committed 12 years ago

Commit 8a3d9ca1 parent 2a1500f6 files · +236 −1Browse files

Unified · Split

6 files
  1. Changelog +1 −0
  2. configure +4 −0
  3. libavcodec/Makefile +1 −0
  4. libavcodec/allcodecs.c +1 −0
  5. libavcodec/libopenh264enc.c +228 −0
  6. libavcodec/version.h +1 −1
Changelog+1−0
@@ -10,6 +10,7 @@ version <next>: · 9 unmodified lines
1010 - H.261 RTP payload format (RFC 4587) depacketizer and experimental packetizer
1111 - RTP/mpegts muxer
1212 - VP8 in Ogg demuxing
13+- OpenH264 encoder wrapper
1314
1415
1516 version 11:
configure+4−0
@@ -193,6 +193,7 @@ External library support: · 192 unmodified lines
193193 --enable-libopencore-amrnb enable AMR-NB de/encoding via libopencore-amrnb [no]
194194 --enable-libopencore-amrwb enable AMR-WB decoding via libopencore-amrwb [no]
195195 --enable-libopencv enable video filtering via libopencv [no]
196+ --enable-libopenh264 enable H264 encoding via OpenH264 [no]
196197 --enable-libopenjpeg enable JPEG 2000 de/encoding via OpenJPEG [no]
197198 --enable-libopus enable Opus de/encoding via libopus [no]
198199 --enable-libpulse enable Pulseaudio input via libpulse [no]
@@ -1156,6 +1157,7 @@ EXTERNAL_LIBRARY_LIST=" · 957 unmodified lines
11561157 libopencore_amrnb
11571158 libopencore_amrwb
11581159 libopencv
1160+ libopenh264
11591161 libopenjpeg
11601162 libopus
11611163 libpulse
@@ -2002,6 +2004,7 @@ libopencore_amrnb_decoder_deps="libopencore_amrnb" · 840 unmodified lines
20022004 libopencore_amrnb_encoder_deps="libopencore_amrnb"
20032005 libopencore_amrnb_encoder_select="audio_frame_queue"
20042006 libopencore_amrwb_decoder_deps="libopencore_amrwb"
2007+libopenh264_encoder_deps="libopenh264"
20052008 libopenjpeg_decoder_deps="libopenjpeg"
20062009 libopenjpeg_encoder_deps="libopenjpeg"
20072010 libopus_decoder_deps="libopus"
@@ -4189,6 +4192,7 @@ enabled libmp3lame && require "libmp3lame >= 3.98.3" lame/lame.h lame_set · 2181 unmodified lines
41894192 enabled libopencore_amrnb && require libopencore_amrnb opencore-amrnb/interf_dec.h Decoder_Interface_init -lopencore-amrnb
41904193 enabled libopencore_amrwb && require libopencore_amrwb opencore-amrwb/dec_if.h D_IF_init -lopencore-amrwb
41914194 enabled libopencv && require_pkg_config opencv opencv/cv.h cvCreateImageHeader
4195+enabled libopenh264 && require_pkg_config openh264 wels/codec_api.h WelsGetCodecVersion
41924196 enabled libopenjpeg && { { check_header openjpeg.h && check_lib2 openjpeg.h opj_version -lopenjpeg -DOPJ_STATIC; } ||
41934197 { require_pkg_config libopenjpeg1 openjpeg.h opj_version -DOPJ_STATIC; } }
41944198 enabled libopus && require_pkg_config opus opus_multistream.h opus_multistream_decoder_create
libavcodec/Makefile+1−0
@@ -611,6 +611,7 @@ OBJS-$(CONFIG_LIBMP3LAME_ENCODER) += libmp3lame.o mpegaudiodecheader.o · 610 unmodified lines
611611 OBJS-$(CONFIG_LIBOPENCORE_AMRNB_DECODER) += libopencore-amr.o
612612 OBJS-$(CONFIG_LIBOPENCORE_AMRNB_ENCODER) += libopencore-amr.o
613613 OBJS-$(CONFIG_LIBOPENCORE_AMRWB_DECODER) += libopencore-amr.o
614+OBJS-$(CONFIG_LIBOPENH264_ENCODER) += libopenh264enc.o
614615 OBJS-$(CONFIG_LIBOPENJPEG_DECODER) += libopenjpegdec.o
615616 OBJS-$(CONFIG_LIBOPENJPEG_ENCODER) += libopenjpegenc.o
616617 OBJS-$(CONFIG_LIBOPUS_DECODER) += libopusdec.o libopus.o \
libavcodec/allcodecs.c+1−0
@@ -442,6 +442,7 @@ void avcodec_register_all(void) · 441 unmodified lines
442442 REGISTER_ENCODER(LIBMP3LAME, libmp3lame);
443443 REGISTER_ENCDEC (LIBOPENCORE_AMRNB, libopencore_amrnb);
444444 REGISTER_DECODER(LIBOPENCORE_AMRWB, libopencore_amrwb);
445+ REGISTER_ENCODER(LIBOPENH264, libopenh264);
445446 REGISTER_ENCDEC (LIBOPENJPEG, libopenjpeg);
446447 REGISTER_ENCDEC (LIBOPUS, libopus);
447448 REGISTER_ENCDEC (LIBSCHROEDINGER, libschroedinger);
libavcodec/libopenh264enc.c+228−0
@@ -0,0 +1,228 @@
1+/*
2+ * OpenH264 video encoder
3+ * Copyright (C) 2014 Martin Storsjo
4+ *
5+ * This file is part of Libav.
6+ *
7+ * Libav 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+ * Libav 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 Libav; if not, write to the Free Software
19+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20+ */
21+
22+#include <wels/codec_api.h>
23+#include <wels/codec_ver.h>
24+
25+#include "libavutil/attributes.h"
26+#include "libavutil/common.h"
27+#include "libavutil/opt.h"
28+#include "libavutil/intreadwrite.h"
29+#include "libavutil/mathematics.h"
30+
31+#include "avcodec.h"
32+#include "internal.h"
33+
34+typedef struct SVCContext {
35+ const AVClass *av_class;
36+ ISVCEncoder *encoder;
37+ int slice_mode;
38+ int loopfilter;
39+ char *profile;
40+} SVCContext;
41+
42+#define OFFSET(x) offsetof(SVCContext, x)
43+#define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
44+static const AVOption options[] = {
45+ { "slice_mode", "Slice mode", OFFSET(slice_mode), AV_OPT_TYPE_INT, { .i64 = SM_AUTO_SLICE }, SM_SINGLE_SLICE, SM_RESERVED, VE, "slice_mode" },
46+ { "fixed", "A fixed number of slices", 0, AV_OPT_TYPE_CONST, { .i64 = SM_FIXEDSLCNUM_SLICE }, 0, 0, VE, "slice_mode" },
47+ { "rowmb", "One slice per row of macroblocks", 0, AV_OPT_TYPE_CONST, { .i64 = SM_ROWMB_SLICE }, 0, 0, VE, "slice_mode" },
48+ { "auto", "Automatic number of slices according to number of threads", 0, AV_OPT_TYPE_CONST, { .i64 = SM_AUTO_SLICE }, 0, 0, VE, "slice_mode" },
49+ { "loopfilter", "Enable loop filter", OFFSET(loopfilter), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, VE },
50+ { "profile", "Set profile restrictions", OFFSET(profile), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
51+ { NULL }
52+};
53+
54+static const AVClass class = {
55+ "libopenh264enc", av_default_item_name, options, LIBAVUTIL_VERSION_INT
56+};
57+
58+static av_cold int svc_encode_close(AVCodecContext *avctx)
59+{
60+ SVCContext *s = avctx->priv_data;
61+
62+ if (s->encoder)
63+ WelsDestroySVCEncoder(s->encoder);
64+ return 0;
65+}
66+
67+static av_cold int svc_encode_init(AVCodecContext *avctx)
68+{
69+ SVCContext *s = avctx->priv_data;
70+ SEncParamExt param = { 0 };
71+ int err = AVERROR_UNKNOWN;
72+ av_unused OpenH264Version libver;
73+ (void)g_strCodecVer; // Avoid warnings due to unused static members from codec_ver.h
74+
75+ // Mingw GCC < 4.7 on x86_32 uses an incorrect/buggy ABI for the WelsGetCodecVersion
76+ // function (for functions returning larger structs), thus skip the check in those
77+ // configurations.
78+#if !defined(_WIN32) || !defined(__GNUC__) || !ARCH_X86_32 || AV_GCC_VERSION_AT_LEAST(4, 7)
79+ libver = WelsGetCodecVersion();
80+ if (memcmp(&libver, &g_stCodecVersion, sizeof(libver))) {
81+ av_log(avctx, AV_LOG_ERROR, "Incorrect library version loaded\n");
82+ return AVERROR(EINVAL);
83+ }
84+#endif
85+
86+ if (WelsCreateSVCEncoder(&s->encoder)) {
87+ av_log(avctx, AV_LOG_ERROR, "Unable to create encoder\n");
88+ return AVERROR_UNKNOWN;
89+ }
90+
91+ (*s->encoder)->GetDefaultParams(s->encoder, &param);
92+
93+ param.fMaxFrameRate = avctx->time_base.den / avctx->time_base.num;
94+ param.iPicWidth = avctx->width;
95+ param.iPicHeight = avctx->height;
96+ param.iTargetBitrate = avctx->bit_rate;
97+ param.iMaxBitrate = FFMAX(avctx->rc_max_rate, avctx->bit_rate);
98+ param.iRCMode = RC_QUALITY_MODE;
99+ param.iTemporalLayerNum = 1;
100+ param.iSpatialLayerNum = 1;
101+ param.bEnableDenoise = 0;
102+ param.bEnableBackgroundDetection = 1;
103+ param.bEnableAdaptiveQuant = 1;
104+ param.bEnableFrameSkip = 0;
105+ param.bEnableLongTermReference = 0;
106+ param.iLtrMarkPeriod = 30;
107+ param.uiIntraPeriod = avctx->gop_size;
108+ param.bEnableSpsPpsIdAddition = 0;
109+ param.bPrefixNalAddingCtrl = 0;
110+ param.iLoopFilterDisableIdc = !s->loopfilter;
111+ param.iEntropyCodingModeFlag = 0;
112+ param.iMultipleThreadIdc = avctx->thread_count;
113+ if (s->profile && !strcmp(s->profile, "main"))
114+ param.iEntropyCodingModeFlag = 1;
115+ else if (!s->profile && avctx->coder_type == FF_CODER_TYPE_AC)
116+ param.iEntropyCodingModeFlag = 1;
117+
118+ param.sSpatialLayers[0].iVideoWidth = param.iPicWidth;
119+ param.sSpatialLayers[0].iVideoHeight = param.iPicHeight;
120+ param.sSpatialLayers[0].fFrameRate = param.fMaxFrameRate;
121+ param.sSpatialLayers[0].iSpatialBitrate = param.iTargetBitrate;
122+ param.sSpatialLayers[0].iMaxSpatialBitrate = param.iMaxBitrate;
123+
124+ if (avctx->slices > 1)
125+ s->slice_mode = SM_FIXEDSLCNUM_SLICE;
126+ param.sSpatialLayers[0].sSliceCfg.uiSliceMode = s->slice_mode;
127+ param.sSpatialLayers[0].sSliceCfg.sSliceArgument.uiSliceNum = avctx->slices;
128+
129+ if ((*s->encoder)->InitializeExt(s->encoder, &param) != cmResultSuccess) {
130+ av_log(avctx, AV_LOG_ERROR, "Initialize failed\n");
131+ goto fail;
132+ }
133+
134+ if (avctx->flags & CODEC_FLAG_GLOBAL_HEADER) {
135+ SFrameBSInfo fbi = { 0 };
136+ int i, size = 0;
137+ (*s->encoder)->EncodeParameterSets(s->encoder, &fbi);
138+ for (i = 0; i < fbi.sLayerInfo[0].iNalCount; i++)
139+ size += fbi.sLayerInfo[0].pNalLengthInByte[i];
140+ avctx->extradata = av_mallocz(size + FF_INPUT_BUFFER_PADDING_SIZE);
141+ if (!avctx->extradata) {
142+ err = AVERROR(ENOMEM);
143+ goto fail;
144+ }
145+ avctx->extradata_size = size;
146+ memcpy(avctx->extradata, fbi.sLayerInfo[0].pBsBuf, size);
147+ }
148+
149+ return 0;
150+
151+fail:
152+ svc_encode_close(avctx);
153+ return err;
154+}
155+
156+static int svc_encode_frame(AVCodecContext *avctx, AVPacket *avpkt,
157+ const AVFrame *frame, int *got_packet)
158+{
159+ SVCContext *s = avctx->priv_data;
160+ SFrameBSInfo fbi = { 0 };
161+ int i, ret;
162+ int encoded;
163+ SSourcePicture sp = { 0 };
164+ int size = 0, layer, first_layer = 0;
165+ int layer_size[MAX_LAYER_NUM_OF_FRAME] = { 0 };
166+
167+ sp.iColorFormat = videoFormatI420;
168+ for (i = 0; i < 3; i++) {
169+ sp.iStride[i] = frame->linesize[i];
170+ sp.pData[i] = frame->data[i];
171+ }
172+ sp.iPicWidth = avctx->width;
173+ sp.iPicHeight = avctx->height;
174+
175+ encoded = (*s->encoder)->EncodeFrame(s->encoder, &sp, &fbi);
176+ if (encoded != cmResultSuccess) {
177+ av_log(avctx, AV_LOG_ERROR, "EncodeFrame failed\n");
178+ return AVERROR_UNKNOWN;
179+ }
180+ if (fbi.eFrameType == videoFrameTypeSkip) {
181+ av_log(avctx, AV_LOG_DEBUG, "frame skipped\n");
182+ return 0;
183+ }
184+ first_layer = 0;
185+ // Normal frames are returned with one single layers, while IDR
186+ // frames have two layers, where the first layer contains the SPS/PPS.
187+ // If using global headers, don't include the SPS/PPS in the returned
188+ // packet - thus, only return one layer.
189+ if (avctx->flags & CODEC_FLAG_GLOBAL_HEADER)
190+ first_layer = fbi.iLayerNum - 1;
191+
192+ for (layer = first_layer; layer < fbi.iLayerNum; layer++) {
193+ for (i = 0; i < fbi.sLayerInfo[layer].iNalCount; i++)
194+ layer_size[layer] += fbi.sLayerInfo[layer].pNalLengthInByte[i];
195+ size += layer_size[layer];
196+ }
197+ av_log(NULL, AV_LOG_DEBUG, "%d slices\n", fbi.sLayerInfo[fbi.iLayerNum - 1].iNalCount);
198+
199+ if ((ret = ff_alloc_packet(avpkt, size))) {
200+ av_log(avctx, AV_LOG_ERROR, "Error getting output packet\n");
201+ return ret;
202+ }
203+ size = 0;
204+ for (layer = first_layer; layer < fbi.iLayerNum; layer++) {
205+ memcpy(avpkt->data + size, fbi.sLayerInfo[layer].pBsBuf, layer_size[layer]);
206+ size += layer_size[layer];
207+ }
208+ avpkt->pts = frame->pts;
209+ if (fbi.eFrameType == videoFrameTypeIDR)
210+ avpkt->flags |= AV_PKT_FLAG_KEY;
211+ *got_packet = 1;
212+ return 0;
213+}
214+
215+AVCodec ff_libopenh264_encoder = {
216+ .name = "libopenh264",
217+ .type = AVMEDIA_TYPE_VIDEO,
218+ .id = AV_CODEC_ID_H264,
219+ .priv_data_size = sizeof(SVCContext),
220+ .init = svc_encode_init,
221+ .encode2 = svc_encode_frame,
222+ .close = svc_encode_close,
223+ .capabilities = CODEC_CAP_AUTO_THREADS,
224+ .pix_fmts = (const enum PixelFormat[]){ AV_PIX_FMT_YUV420P,
225+ AV_PIX_FMT_NONE },
226+ .long_name = NULL_IF_CONFIG_SMALL("OpenH264"),
227+ .priv_class = &class,
228+};
libavcodec/version.h+1−1
@@ -29,7 +29,7 @@ · 28 unmodified lines
2929 #include "libavutil/version.h"
3030
3131 #define LIBAVCODEC_VERSION_MAJOR 56
32−#define LIBAVCODEC_VERSION_MINOR 10
32+#define LIBAVCODEC_VERSION_MINOR 11
3333 #define LIBAVCODEC_VERSION_MICRO 0
3434
3535 #define LIBAVCODEC_VERSION_INT AV_VERSION_INT(LIBAVCODEC_VERSION_MAJOR, \

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t