FFmpeg
All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
lcevcdec.c
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg 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  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #include "config_components.h"
20 
21 #include "libavutil/avassert.h"
22 #include "libavutil/frame.h"
23 #include "libavutil/imgutils.h"
24 #include "libavutil/log.h"
25 #include "libavutil/mem.h"
26 #include "libavutil/refstruct.h"
27 
28 #include "decode.h"
29 #include "lcevcdec.h"
30 
31 #if CONFIG_LIBLCEVC_DEC
32 static LCEVC_ColorFormat map_format(int format)
33 {
34  switch (format) {
35  case AV_PIX_FMT_YUV420P:
36  return LCEVC_I420_8;
38  return LCEVC_I420_10_LE;
39  case AV_PIX_FMT_NV12:
40  return LCEVC_NV12_8;
41  case AV_PIX_FMT_NV21:
42  return LCEVC_NV21_8;
43  case AV_PIX_FMT_GRAY8:
44  return LCEVC_GRAY_8;
45  }
46 
47  return LCEVC_ColorFormat_Unknown;
48 }
49 
50 static int alloc_base_frame(void *logctx, FFLCEVCContext *lcevc,
51  const AVFrame *frame, LCEVC_PictureHandle *picture)
52 {
53  LCEVC_PictureDesc desc;
54  LCEVC_ColorFormat fmt = map_format(frame->format);
55  LCEVC_PictureLockHandle lock;
56  uint8_t *data[4] = { NULL };
57  int linesizes[4] = { 0 };
58  uint32_t planes;
59  LCEVC_ReturnCode res;
60 
61  res = LCEVC_DefaultPictureDesc(&desc, fmt, frame->width, frame->height);
62  if (res != LCEVC_Success)
63  return AVERROR_EXTERNAL;
64 
65  desc.cropTop = frame->crop_top;
66  desc.cropBottom = frame->crop_bottom;
67  desc.cropLeft = frame->crop_left;
68  desc.cropRight = frame->crop_right;
69  desc.sampleAspectRatioNum = frame->sample_aspect_ratio.num;
70  desc.sampleAspectRatioDen = frame->sample_aspect_ratio.den;
71 
72  /* Allocate LCEVC Picture */
73  res = LCEVC_AllocPicture(lcevc->decoder, &desc, picture);
74  if (res != LCEVC_Success) {
75  return AVERROR_EXTERNAL;
76  }
77  res = LCEVC_LockPicture(lcevc->decoder, *picture, LCEVC_Access_Write, &lock);
78  if (res != LCEVC_Success)
79  return AVERROR_EXTERNAL;
80 
81  res = LCEVC_GetPicturePlaneCount(lcevc->decoder, *picture, &planes);
82  if (res != LCEVC_Success)
83  return AVERROR_EXTERNAL;
84 
85  for (unsigned i = 0; i < planes; i++) {
86  LCEVC_PicturePlaneDesc plane;
87 
88  res = LCEVC_GetPictureLockPlaneDesc(lcevc->decoder, lock, i, &plane);
89  if (res != LCEVC_Success)
90  return AVERROR_EXTERNAL;
91 
92  data[i] = plane.firstSample;
93  linesizes[i] = plane.rowByteStride;
94  }
95 
96  av_image_copy2(data, linesizes, frame->data, frame->linesize,
97  frame->format, frame->width, frame->height);
98 
99  res = LCEVC_UnlockPicture(lcevc->decoder, lock);
100  if (res != LCEVC_Success)
101  return AVERROR_EXTERNAL;
102 
103  return 0;
104 }
105 
106 static int alloc_enhanced_frame(void *logctx, FFLCEVCFrame *frame_ctx,
107  LCEVC_PictureHandle *picture)
108 {
109  FFLCEVCContext *lcevc = frame_ctx->lcevc;
110  LCEVC_PictureDesc desc ;
111  LCEVC_ColorFormat fmt = map_format(frame_ctx->frame->format);
112  LCEVC_PicturePlaneDesc planes[4] = { 0 };
113  LCEVC_ReturnCode res;
114 
115  res = LCEVC_DefaultPictureDesc(&desc, fmt, frame_ctx->frame->width, frame_ctx->frame->height);
116  if (res != LCEVC_Success)
117  return AVERROR_EXTERNAL;
118 
119  /* Set plane description */
120  for (int i = 0; i < 4; i++) {
121  planes[i].firstSample = frame_ctx->frame->data[i];
122  planes[i].rowByteStride = frame_ctx->frame->linesize[i];
123  }
124 
125  /* Allocate LCEVC Picture */
126  res = LCEVC_AllocPictureExternal(lcevc->decoder, &desc, NULL, planes, picture);
127  if (res != LCEVC_Success) {
128  return AVERROR_EXTERNAL;
129  }
130  return 0;
131 }
132 
133 static int lcevc_send_frame(void *logctx, FFLCEVCFrame *frame_ctx, const AVFrame *in)
134 {
135  FFLCEVCContext *lcevc = frame_ctx->lcevc;
137  LCEVC_PictureHandle picture;
138  LCEVC_ReturnCode res;
139  int ret = 0;
140 
141  if (!sd)
142  return 1;
143 
144  res = LCEVC_SendDecoderEnhancementData(lcevc->decoder, in->pts, 0, sd->data, sd->size);
145  if (res != LCEVC_Success)
146  return AVERROR_EXTERNAL;
147 
148  ret = alloc_base_frame(logctx, lcevc, in, &picture);
149  if (ret < 0)
150  return ret;
151 
152  res = LCEVC_SendDecoderBase(lcevc->decoder, in->pts, 0, picture, -1, NULL);
153  if (res != LCEVC_Success)
154  return AVERROR_EXTERNAL;
155 
156  memset(&picture, 0, sizeof(picture));
157  ret = alloc_enhanced_frame(logctx, frame_ctx, &picture);
158  if (ret < 0)
159  return ret;
160 
161  res = LCEVC_SendDecoderPicture(lcevc->decoder, picture);
162  if (res != LCEVC_Success)
163  return AVERROR_EXTERNAL;
164 
165  return 0;
166 }
167 
168 static int generate_output(void *logctx, FFLCEVCFrame *frame_ctx, AVFrame *out)
169 {
170  FFLCEVCContext *lcevc = frame_ctx->lcevc;
171  LCEVC_PictureDesc desc;
172  LCEVC_DecodeInformation info;
173  LCEVC_PictureHandle picture;
174  LCEVC_ReturnCode res;
175 
176  res = LCEVC_ReceiveDecoderPicture(lcevc->decoder, &picture, &info);
177  if (res != LCEVC_Success)
178  return AVERROR_EXTERNAL;
179 
180  res = LCEVC_GetPictureDesc(lcevc->decoder, picture, &desc);
181  if (res != LCEVC_Success)
182  return AVERROR_EXTERNAL;
183 
184  out->crop_top = desc.cropTop;
185  out->crop_bottom = desc.cropBottom;
186  out->crop_left = desc.cropLeft;
187  out->crop_right = desc.cropRight;
188  out->sample_aspect_ratio.num = desc.sampleAspectRatioNum;
189  out->sample_aspect_ratio.den = desc.sampleAspectRatioDen;
190 
191  av_frame_copy_props(frame_ctx->frame, out);
193  av_frame_move_ref(out, frame_ctx->frame);
194 
195  out->width = desc.width + out->crop_left + out->crop_right;
196  out->height = desc.height + out->crop_top + out->crop_bottom;
197 
198  res = LCEVC_FreePicture(lcevc->decoder, picture);
199  if (res != LCEVC_Success)
200  return AVERROR_EXTERNAL;
201 
202  return 0;
203 }
204 
205 static int lcevc_receive_frame(void *logctx, FFLCEVCFrame *frame_ctx, AVFrame *out)
206 {
207  FFLCEVCContext *lcevc = frame_ctx->lcevc;
208  LCEVC_PictureHandle picture;
209  LCEVC_ReturnCode res;
210  int ret;
211 
212  ret = generate_output(logctx, frame_ctx, out);
213  if (ret < 0)
214  return ret;
215 
216  while (1) {
217  res = LCEVC_ReceiveDecoderBase (lcevc->decoder, &picture);
218  if (res != LCEVC_Success && res != LCEVC_Again)
219  return AVERROR_EXTERNAL;
220 
221  if (res == LCEVC_Again)
222  break;
223 
224  res = LCEVC_FreePicture(lcevc->decoder, picture);
225  if (res != LCEVC_Success)
226  return AVERROR_EXTERNAL;
227  }
228 
229  return 0;
230 }
231 
232 static void event_callback(LCEVC_DecoderHandle dec, LCEVC_Event event,
233  LCEVC_PictureHandle pic, const LCEVC_DecodeInformation *info,
234  const uint8_t *data, uint32_t size, void *logctx)
235 {
236  switch (event) {
237  case LCEVC_Log:
238  av_log(logctx, AV_LOG_INFO, "%s\n", data);
239  break;
240  default:
241  break;
242  }
243 }
244 
245 static void lcevc_free(AVRefStructOpaque unused, void *obj)
246 {
247  FFLCEVCContext *lcevc = obj;
248  if (lcevc->initialized)
249  LCEVC_DestroyDecoder(lcevc->decoder);
250  memset(lcevc, 0, sizeof(*lcevc));
251 }
252 #endif
253 
254 static int lcevc_init(FFLCEVCContext *lcevc, void *logctx)
255 {
256 #if CONFIG_LIBLCEVC_DEC
257  LCEVC_AccelContextHandle dummy = { 0 };
258  const int32_t event = LCEVC_Log;
259 
260  if (LCEVC_CreateDecoder(&lcevc->decoder, dummy) != LCEVC_Success) {
261  av_log(logctx, AV_LOG_ERROR, "Failed to create LCEVC decoder\n");
262  return AVERROR_EXTERNAL;
263  }
264 
265  LCEVC_ConfigureDecoderInt(lcevc->decoder, "log_level", 4);
266  LCEVC_ConfigureDecoderIntArray(lcevc->decoder, "events", 1, &event);
267  LCEVC_SetDecoderEventCallback(lcevc->decoder, event_callback, logctx);
268 
269  if (LCEVC_InitializeDecoder(lcevc->decoder) != LCEVC_Success) {
270  av_log(logctx, AV_LOG_ERROR, "Failed to initialize LCEVC decoder\n");
271  LCEVC_DestroyDecoder(lcevc->decoder);
272  return AVERROR_EXTERNAL;
273  }
274 
275 #endif
276  lcevc->initialized = 1;
277 
278  return 0;
279 }
280 
281 int ff_lcevc_process(void *logctx, AVFrame *frame)
282 {
283  FrameDecodeData *fdd = frame->private_ref;
284  FFLCEVCFrame *frame_ctx = fdd->post_process_opaque;
285  FFLCEVCContext *lcevc = frame_ctx->lcevc;
286  int ret;
287 
288  if (!lcevc->initialized) {
289  ret = lcevc_init(lcevc, logctx);
290  if (ret < 0)
291  return ret;
292  }
293 
294 #if CONFIG_LIBLCEVC_DEC
295  av_assert0(frame_ctx->frame);
296 
297 
298  ret = lcevc_send_frame(logctx, frame_ctx, frame);
299  if (ret)
300  return ret < 0 ? ret : 0;
301 
302  lcevc_receive_frame(logctx, frame_ctx, frame);
303  if (ret < 0)
304  return ret;
305 
307 #endif
308 
309  return 0;
310 }
311 
313 {
314  FFLCEVCContext *lcevc = NULL;
315 #if CONFIG_LIBLCEVC_DEC
316  lcevc = av_refstruct_alloc_ext(sizeof(*lcevc), 0, NULL, lcevc_free);
317  if (!lcevc)
318  return AVERROR(ENOMEM);
319 #endif
320  *plcevc = lcevc;
321  return 0;
322 }
323 
324 void ff_lcevc_unref(void *opaque)
325 {
326  FFLCEVCFrame *lcevc = opaque;
327  av_refstruct_unref(&lcevc->lcevc);
328  av_frame_free(&lcevc->frame);
329  av_free(opaque);
330 }
lcevcdec.h
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
out
FILE * out
Definition: movenc.c:55
av_frame_get_side_data
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition: frame.c:661
ff_lcevc_alloc
int ff_lcevc_alloc(FFLCEVCContext **plcevc)
Definition: lcevcdec.c:312
AVRefStructOpaque
RefStruct is an API for creating reference-counted objects with minimal overhead.
Definition: refstruct.h:58
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:63
FrameDecodeData
This struct stores per-frame lavc-internal data and is attached to it via private_ref.
Definition: decode.h:33
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:410
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:512
AVFrame::width
int width
Definition: frame.h:482
FFLCEVCContext
Definition: lcevcdec.h:31
data
const char data[16]
Definition: mxf.c:149
lcevc_init
static int lcevc_init(FFLCEVCContext *lcevc, void *logctx)
Definition: lcevcdec.c:254
AV_PIX_FMT_YUV420P10
#define AV_PIX_FMT_YUV420P10
Definition: pixfmt.h:528
FFLCEVCContext::initialized
int initialized
Definition: lcevcdec.h:33
map_format
static LCEVC_ColorFormat map_format(int format)
Definition: vf_lcevc.c:35
FFLCEVCContext::decoder
LCEVC_DecoderHandle decoder
Definition: lcevcdec.h:32
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:431
dummy
int dummy
Definition: motion.c:66
ff_lcevc_process
int ff_lcevc_process(void *logctx, AVFrame *frame)
Definition: lcevcdec.c:281
refstruct.h
avassert.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:210
AVFrameSideData::size
size_t size
Definition: frame.h:268
FrameDecodeData::post_process_opaque
void * post_process_opaque
Definition: decode.h:45
info
MIPS optimizations info
Definition: mips.txt:2
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:41
av_refstruct_alloc_ext
static void * av_refstruct_alloc_ext(size_t size, unsigned flags, void *opaque, void(*free_cb)(AVRefStructOpaque opaque, void *obj))
A wrapper around av_refstruct_alloc_ext_c() for the common case of a non-const qualified opaque.
Definition: refstruct.h:94
decode.h
planes
static const struct @506 planes[]
AV_PIX_FMT_YUV420P
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:73
alloc_enhanced_frame
static int alloc_enhanced_frame(AVFilterLink *inlink, const AVFrame *out, LCEVC_PictureHandle *picture)
Definition: vf_lcevc.c:161
generate_output
static int generate_output(AVFilterLink *inlink, AVFrame *out)
Definition: vf_lcevc.c:189
NULL
#define NULL
Definition: coverity.c:32
av_frame_copy_props
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:601
format
New swscale design to change SwsGraph is what coordinates multiple passes These can include cascaded scaling error diffusion and so on Or we could have separate passes for the vertical and horizontal scaling In between each SwsPass lies a fully allocated image buffer Graph passes may have different levels of e g we can have a single threaded error diffusion pass following a multi threaded scaling pass SwsGraph is internally recreated whenever the image format
Definition: swscale-v2.txt:14
ff_lcevc_unref
void ff_lcevc_unref(void *opaque)
Definition: lcevcdec.c:324
FFLCEVCFrame::lcevc
FFLCEVCContext * lcevc
Definition: lcevcdec.h:39
AV_PIX_FMT_GRAY8
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
Definition: pixfmt.h:81
AV_FRAME_DATA_LCEVC
@ AV_FRAME_DATA_LCEVC
Raw LCEVC payload data, as a uint8_t array, with NAL emulation bytes intact.
Definition: frame.h:236
size
int size
Definition: twinvq_data.h:10344
LCEVC_DecoderHandle
uintptr_t LCEVC_DecoderHandle
Definition: lcevcdec.h:28
alloc_base_frame
static int alloc_base_frame(AVFilterLink *inlink, const AVFrame *in, LCEVC_PictureHandle *picture)
Definition: vf_lcevc.c:79
AVFrameSideData::data
uint8_t * data
Definition: frame.h:267
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:497
frame.h
av_frame_remove_side_data
void av_frame_remove_side_data(AVFrame *frame, enum AVFrameSideDataType type)
Remove and free all side data instances of the given type.
Definition: frame.c:727
AVERROR_EXTERNAL
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition: error.h:59
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:221
av_refstruct_unref
void av_refstruct_unref(void *objp)
Decrement the reference count of the underlying object and automatically free the object if there are...
Definition: refstruct.c:120
lock
static pthread_mutex_t lock
Definition: ffjni.c:39
log.h
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:256
av_frame_move_ref
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
Definition: frame.c:525
av_frame_unref
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:498
AV_PIX_FMT_NV21
@ AV_PIX_FMT_NV21
as above, but U and V bytes are swapped
Definition: pixfmt.h:97
ret
ret
Definition: filter_design.txt:187
AV_PIX_FMT_NV12
@ AV_PIX_FMT_NV12
planar YUV 4:2:0, 12bpp, 1 plane for Y and 1 plane for the UV components, which are interleaved (firs...
Definition: pixfmt.h:96
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
AVFrame::height
int height
Definition: frame.h:482
av_image_copy2
static void av_image_copy2(uint8_t *const dst_data[4], const int dst_linesizes[4], uint8_t *const src_data[4], const int src_linesizes[4], enum AVPixelFormat pix_fmt, int width, int height)
Wrapper around av_image_copy() to workaround the limitation that the conversion from uint8_t * const ...
Definition: imgutils.h:184
desc
const char * desc
Definition: libsvtav1.c:79
mem.h
AVFrameSideData
Structure to hold side data for an AVFrame.
Definition: frame.h:265
av_free
#define av_free(p)
Definition: tableprint_vlc.h:34
int32_t
int32_t
Definition: audioconvert.c:56
imgutils.h
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
Definition: frame.h:455
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
FFLCEVCFrame
Definition: lcevcdec.h:38
FFLCEVCFrame::frame
struct AVFrame * frame
Definition: lcevcdec.h:40