FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
libxavs2.c
Go to the documentation of this file.
1 /*
2  * AVS2 encoding using the xavs2 library
3  *
4  * Copyright (C) 2018 Yiqun Xu, <yiqun.xu@vipl.ict.ac.cn>
5  * Falei Luo, <falei.luo@gmail.com>
6  * Huiwen Ren, <hwrenx@gmail.com>
7  *
8  * This file is part of FFmpeg.
9  *
10  * FFmpeg is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Lesser General Public
12  * License as published by the Free Software Foundation; either
13  * version 2.1 of the License, or (at your option) any later version.
14  *
15  * FFmpeg is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18  * Lesser General Public License for more details.
19  *
20  * You should have received a copy of the GNU Lesser General Public
21  * License along with FFmpeg; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23  */
24 
25 #include "xavs2.h"
26 #include "mpeg12.h"
27 #include "libavutil/avstring.h"
28 
29 #define xavs2_opt_set2(name, format, ...) do{ \
30  char opt_str[16] = {0}; \
31  int err; \
32  av_strlcatf(opt_str, sizeof(opt_str), format, __VA_ARGS__); \
33  err = cae->api->opt_set2(cae->param, name, opt_str); \
34  if (err) {\
35  av_log(avctx, AV_LOG_WARNING, "Invalid value for %s: %s\n", name, opt_str);\
36  }\
37 } while(0);
38 
39 typedef struct XAVS2EContext {
40  AVClass *class;
41 
44  int qp;
45  int max_qp;
46  int min_qp;
48  int log_level;
50 
51  void *encoder;
52  char *xavs2_opts;
53 
54  xavs2_outpacket_t packet;
55  xavs2_param_t *param;
56 
57  const xavs2_api_t *api;
58 
60 
61 static av_cold int xavs2_init(AVCodecContext *avctx)
62 {
63  XAVS2EContext *cae= avctx->priv_data;
64  int bit_depth, code;
65 
66  bit_depth = avctx->pix_fmt == AV_PIX_FMT_YUV420P ? 8 : 10;
67 
68  /* get API handler */
69  cae->api = xavs2_api_get(bit_depth);
70  if (!cae->api) {
71  av_log(avctx, AV_LOG_ERROR, "api get failed\n");
72  return AVERROR_EXTERNAL;
73  }
74 
75  cae->param = cae->api->opt_alloc();
76  if (!cae->param) {
77  av_log(avctx, AV_LOG_ERROR, "param alloc failed\n");
78  return AVERROR(ENOMEM);
79  }
80 
81  xavs2_opt_set2("Width", "%d", avctx->width);
82  xavs2_opt_set2("Height", "%d", avctx->height);
83  xavs2_opt_set2("BFrames", "%d", avctx->max_b_frames);
84  xavs2_opt_set2("BitDepth", "%d", bit_depth);
85  xavs2_opt_set2("Log", "%d", cae->log_level);
86  xavs2_opt_set2("Preset", "%d", cae->preset_level);
87 
88  xavs2_opt_set2("IntraPeriodMax", "%d", avctx->gop_size);
89  xavs2_opt_set2("IntraPeriodMin", "%d", avctx->gop_size);
90 
91  xavs2_opt_set2("ThreadFrames", "%d", avctx->thread_count);
92  xavs2_opt_set2("ThreadRows", "%d", cae->lcu_row_threads);
93 
94  xavs2_opt_set2("OpenGOP", "%d", !(avctx->flags & AV_CODEC_FLAG_CLOSED_GOP));
95 
96  if (cae->xavs2_opts) {
97  AVDictionary *dict = NULL;
98  AVDictionaryEntry *en = NULL;
99 
100  if (!av_dict_parse_string(&dict, cae->xavs2_opts, "=", ":", 0)) {
101  while ((en = av_dict_get(dict, "", en, AV_DICT_IGNORE_SUFFIX))) {
102  xavs2_opt_set2(en->key, "%s", en->value);
103  }
104  av_dict_free(&dict);
105  }
106  }
107 
108  /* Rate control */
109  if (avctx->bit_rate > 0) {
110  xavs2_opt_set2("RateControl", "%d", 1);
111  xavs2_opt_set2("TargetBitRate", "%"PRId64"", avctx->bit_rate);
112  xavs2_opt_set2("InitialQP", "%d", cae->initial_qp);
113  xavs2_opt_set2("MaxQP", "%d", cae->max_qp);
114  xavs2_opt_set2("MinQP", "%d", cae->min_qp);
115  } else {
116  xavs2_opt_set2("InitialQP", "%d", cae->qp);
117  }
118 
119 
121 
122  xavs2_opt_set2("FrameRate", "%d", code);
123 
124  cae->encoder = cae->api->encoder_create(cae->param);
125 
126  if (!cae->encoder) {
127  av_log(avctx,AV_LOG_ERROR, "Can not create encoder. Null pointer returned\n");
128  return AVERROR(EINVAL);
129  }
130 
131  return 0;
132 }
133 
134 static void xavs2_copy_frame_with_shift(xavs2_picture_t *pic, const AVFrame *frame, const int shift_in)
135 {
136  int j, k;
137  for (k = 0; k < 3; k++) {
138  int i_stride = pic->img.i_stride[k];
139  for (j = 0; j < pic->img.i_lines[k]; j++) {
140  uint16_t *p_plane = (uint16_t *)&pic->img.img_planes[k][j * i_stride];
141  int i;
142  uint8_t *p_buffer = frame->data[k] + frame->linesize[k] * j;
143  memset(p_plane, 0, i_stride);
144  for (i = 0; i < pic->img.i_width[k]; i++) {
145  p_plane[i] = p_buffer[i] << shift_in;
146  }
147  }
148  }
149 }
150 
151 static void xavs2_copy_frame(xavs2_picture_t *pic, const AVFrame *frame)
152 {
153  int j, k;
154  for (k = 0; k < 3; k++) {
155  for (j = 0; j < pic->img.i_lines[k]; j++) {
156  memcpy( pic->img.img_planes[k] + pic->img.i_stride[k] * j,
157  frame->data[k]+frame->linesize[k] * j,
158  pic->img.i_width[k] * pic->img.in_sample_size);
159  }
160  }
161 }
162 
164  const AVFrame *frame, int *got_packet)
165 {
166  XAVS2EContext *cae = avctx->priv_data;
167  xavs2_picture_t pic;
168  int ret;
169 
170  /* create the XAVS2 video encoder */
171  /* read frame data and send to the XAVS2 video encoder */
172  if (cae->api->encoder_get_buffer(cae->encoder, &pic) < 0) {
173  av_log(avctx,AV_LOG_ERROR, "failed to get frame buffer\n");
174  return AVERROR_EXTERNAL;
175  }
176  if (frame) {
177  switch (frame->format) {
178  case AV_PIX_FMT_YUV420P:
179  if (pic.img.in_sample_size == pic.img.enc_sample_size) {
180  xavs2_copy_frame(&pic, frame);
181  } else {
182  const int shift_in = atoi(cae->api->opt_get(cae->param, "SampleShift"));
183  xavs2_copy_frame_with_shift(&pic, frame, shift_in);
184  }
185  break;
187  if (pic.img.in_sample_size == pic.img.enc_sample_size) {
188  xavs2_copy_frame(&pic, frame);
189  break;
190  }
191  default:
192  av_log(avctx, AV_LOG_ERROR, "Unsupported pixel format\n");
193  return AVERROR(EINVAL);
194  break;
195  }
196 
197  pic.i_state = 0;
198  pic.i_pts = frame->pts;
199  pic.i_type = XAVS2_TYPE_AUTO;
200 
201  ret = cae->api->encoder_encode(cae->encoder, &pic, &cae->packet);
202 
203  if (ret) {
204  av_log(avctx, AV_LOG_ERROR, "encode failed\n");
205  return AVERROR_EXTERNAL;
206  }
207 
208  } else {
209  cae->api->encoder_encode(cae->encoder, NULL, &cae->packet);
210  }
211 
212  if ((cae->packet.len) && (cae->packet.state != XAVS2_STATE_FLUSH_END)){
213 
214  if (av_new_packet(pkt, cae->packet.len) < 0){
215  av_log(avctx, AV_LOG_ERROR, "packet alloc failed\n");
216  cae->api->encoder_packet_unref(cae->encoder, &cae->packet);
217  return AVERROR(ENOMEM);
218  }
219 
220  pkt->pts = cae->packet.pts;
221  pkt->dts = cae->packet.dts;
222 
223  memcpy(pkt->data, cae->packet.stream, cae->packet.len);
224  pkt->size = cae->packet.len;
225 
226  cae->api->encoder_packet_unref(cae->encoder, &cae->packet);
227 
228  *got_packet = 1;
229  } else {
230  *got_packet = 0;
231  }
232 
233  return 0;
234 }
235 
237 {
238  XAVS2EContext *cae = avctx->priv_data;
239  /* destroy the encoder */
240  if (cae->api) {
241  cae->api->encoder_destroy(cae->encoder);
242 
243  if (cae->param) {
244  cae->api->opt_destroy(cae->param);
245  }
246  }
247  return 0;
248 }
249 
250 #define OFFSET(x) offsetof(XAVS2EContext, x)
251 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
252 
253 static const AVOption options[] = {
254  { "lcu_row_threads" , "number of parallel threads for rows" , OFFSET(lcu_row_threads) , AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX, VE },
255  { "initial_qp" , "Quantization initial parameter" , OFFSET(initial_qp) , AV_OPT_TYPE_INT, {.i64 = 34 }, 1, 63, VE },
256  { "qp" , "Quantization parameter" , OFFSET(qp) , AV_OPT_TYPE_INT, {.i64 = 34 }, 1, 63, VE },
257  { "max_qp" , "max qp for rate control" , OFFSET(max_qp) , AV_OPT_TYPE_INT, {.i64 = 55 }, 0, 63, VE },
258  { "min_qp" , "min qp for rate control" , OFFSET(min_qp) , AV_OPT_TYPE_INT, {.i64 = 20 }, 0, 63, VE },
259  { "speed_level" , "Speed level, higher is better but slower", OFFSET(preset_level) , AV_OPT_TYPE_INT, {.i64 = 0 }, 0, 9, VE },
260  { "log_level" , "log level: -1: none, 0: error, 1: warning, 2: info, 3: debug", OFFSET(log_level) , AV_OPT_TYPE_INT, {.i64 = 0 }, -1, 3, VE },
261  { "xavs2-params" , "set the xavs2 configuration using a :-separated list of key=value parameters", OFFSET(xavs2_opts), AV_OPT_TYPE_STRING, { 0 }, 0, 0, VE },
262  { NULL },
263 };
264 
265 static const AVClass libxavs2 = {
266  .class_name = "XAVS2EContext",
267  .item_name = av_default_item_name,
268  .option = options,
269  .version = LIBAVUTIL_VERSION_INT,
270 };
271 
272 static const AVCodecDefault xavs2_defaults[] = {
273  { "b", "0" },
274  { "g", "48" },
275  { "bf", "7" },
276  { NULL },
277 };
278 
280  .name = "libxavs2",
281  .long_name = NULL_IF_CONFIG_SMALL("libxavs2 AVS2-P2/IEEE1857.4"),
282  .type = AVMEDIA_TYPE_VIDEO,
283  .id = AV_CODEC_ID_AVS2,
284  .priv_data_size = sizeof(XAVS2EContext),
285  .init = xavs2_init,
286  .encode2 = xavs2_encode_frame,
287  .close = xavs2_close,
289  .pix_fmts = (const enum AVPixelFormat[]) { AV_PIX_FMT_YUV420P,
290  AV_PIX_FMT_NONE },
291  .priv_class = &libxavs2,
292  .defaults = xavs2_defaults,
293  .wrapper_name = "libxavs2",
294 } ;
char * xavs2_opts
Definition: libxavs2.c:52
#define NULL
Definition: coverity.c:32
AVRational framerate
Definition: avcodec.h:3056
int preset_level
Definition: libxavs2.c:47
This structure describes decoded (raw) audio or video data.
Definition: frame.h:226
AVOption.
Definition: opt.h:246
int64_t bit_rate
the average bitrate
Definition: avcodec.h:1583
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
int max_b_frames
maximum number of B-frames between non-B-frames Note: The output will be delayed by max_b_frames+1 re...
Definition: avcodec.h:1793
int size
Definition: avcodec.h:1446
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:191
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:1743
static AVPacket pkt
#define AV_CODEC_CAP_AUTO_THREADS
Codec supports avctx->thread_count == 0 (auto).
Definition: avcodec.h:1036
AVCodec.
Definition: avcodec.h:3424
static int xavs2_encode_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *frame, int *got_packet)
Definition: libxavs2.c:163
static void xavs2_copy_frame(xavs2_picture_t *pic, const AVFrame *frame)
Definition: libxavs2.c:151
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
#define AV_CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
Definition: avcodec.h:993
AVCodec ff_libxavs2_encoder
Definition: libxavs2.c:279
uint8_t
#define av_cold
Definition: attributes.h:82
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:319
static AVFrame * frame
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
Definition: dict.c:40
uint8_t * data
Definition: avcodec.h:1445
const xavs2_api_t * api
Definition: libxavs2.c:57
#define VE
Definition: libxavs2.c:251
#define av_log(a,...)
int av_new_packet(AVPacket *pkt, int size)
Allocate the payload of a packet and initialize its fields with default values.
Definition: avpacket.c:86
int lcu_row_threads
Definition: libxavs2.c:42
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
static const AVOption options[]
Definition: libxavs2.c:253
#define AVERROR(e)
Definition: error.h:43
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values. ...
Definition: dict.c:203
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:1613
const char * name
Name of the codec implementation.
Definition: avcodec.h:3431
int initial_qp
Definition: libxavs2.c:43
void ff_mpeg12_find_best_frame_rate(AVRational frame_rate, int *code, int *ext_n, int *ext_d, int nonstandard)
void * encoder
Definition: libxavs2.c:51
static av_cold int xavs2_close(AVCodecContext *avctx)
Definition: libxavs2.c:236
int width
picture width / height.
Definition: avcodec.h:1706
static void bit_depth(AudioStatsContext *s, uint64_t mask, uint64_t imask, AVRational *depth)
Definition: af_astats.c:155
int log_level
Definition: libxavs2.c:48
int thread_count
thread count is used to decide how many independent tasks should be passed to execute() ...
Definition: avcodec.h:2785
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:299
int av_dict_parse_string(AVDictionary **pm, const char *str, const char *key_val_sep, const char *pairs_sep, int flags)
Parse the key/value pairs list and add the parsed entries to a dictionary.
Definition: dict.c:180
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:257
int hierarchical_reference
Definition: libxavs2.c:49
main external API structure.
Definition: avcodec.h:1533
#define AV_PIX_FMT_YUV420P10
Definition: pixfmt.h:379
#define OFFSET(x)
Definition: libxavs2.c:250
Describe the class of an AVClass context structure.
Definition: log.h:67
static const AVCodecDefault xavs2_defaults[]
Definition: libxavs2.c:272
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:266
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:240
static av_cold int xavs2_init(AVCodecContext *avctx)
Definition: libxavs2.c:61
int gop_size
the number of pictures in a group of pictures, or 0 for intra_only
Definition: avcodec.h:1728
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:66
char * key
Definition: dict.h:86
static const AVClass libxavs2
Definition: libxavs2.c:265
void * priv_data
Definition: avcodec.h:1560
char * value
Definition: dict.h:87
xavs2_outpacket_t packet
Definition: libxavs2.c:54
#define xavs2_opt_set2(name, format,...)
Definition: libxavs2.c:29
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed...
Definition: avcodec.h:1444
#define AV_DICT_IGNORE_SUFFIX
Return first entry in a dictionary whose first part corresponds to the search key, ignoring the suffix of the found key string.
Definition: dict.h:70
#define AV_CODEC_FLAG_CLOSED_GOP
Definition: avcodec.h:905
xavs2_param_t * param
Definition: libxavs2.c:55
static void xavs2_copy_frame_with_shift(xavs2_picture_t *pic, const AVFrame *frame, const int shift_in)
Definition: libxavs2.c:134
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition: error.h:57
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
This structure stores compressed data.
Definition: avcodec.h:1422
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: avcodec.h:1438