FFmpeg
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 "libavutil/avassert.h"
20 #include "libavutil/frame.h"
21 #include "libavutil/imgutils.h"
22 #include "libavutil/log.h"
23 #include "libavutil/mem.h"
24 #include "libavutil/refstruct.h"
25 
26 #include "decode.h"
27 #include "lcevcdec.h"
28 
29 static LCEVC_ColorFormat map_format(int format)
30 {
31  switch (format) {
32  case AV_PIX_FMT_YUV420P:
33  return LCEVC_I420_8;
35  return LCEVC_I420_10_LE;
36  case AV_PIX_FMT_NV12:
37  return LCEVC_NV12_8;
38  case AV_PIX_FMT_NV21:
39  return LCEVC_NV21_8;
40  case AV_PIX_FMT_GRAY8:
41  return LCEVC_GRAY_8;
42  }
43 
44  return LCEVC_ColorFormat_Unknown;
45 }
46 
47 static int alloc_base_frame(void *logctx, FFLCEVCContext *lcevc,
48  const AVFrame *frame, LCEVC_PictureHandle *picture)
49 {
50  LCEVC_PictureDesc desc;
51  LCEVC_ColorFormat fmt = map_format(frame->format);
52  LCEVC_PictureLockHandle lock;
53  uint8_t *data[4] = { NULL };
54  int linesizes[4] = { 0 };
55  uint32_t planes;
56  LCEVC_ReturnCode res;
57 
58  res = LCEVC_DefaultPictureDesc(&desc, fmt, frame->width, frame->height);
59  if (res != LCEVC_Success)
60  return AVERROR_EXTERNAL;
61 
62  desc.cropTop = frame->crop_top;
63  desc.cropBottom = frame->crop_bottom;
64  desc.cropLeft = frame->crop_left;
65  desc.cropRight = frame->crop_right;
66  desc.sampleAspectRatioNum = frame->sample_aspect_ratio.num;
67  desc.sampleAspectRatioDen = frame->sample_aspect_ratio.den;
68 
69  /* Allocate LCEVC Picture */
70  res = LCEVC_AllocPicture(lcevc->decoder, &desc, picture);
71  if (res != LCEVC_Success) {
72  return AVERROR_EXTERNAL;
73  }
74  res = LCEVC_LockPicture(lcevc->decoder, *picture, LCEVC_Access_Write, &lock);
75  if (res != LCEVC_Success)
76  return AVERROR_EXTERNAL;
77 
78  res = LCEVC_GetPicturePlaneCount(lcevc->decoder, *picture, &planes);
79  if (res != LCEVC_Success)
80  return AVERROR_EXTERNAL;
81 
82  for (unsigned i = 0; i < planes; i++) {
83  LCEVC_PicturePlaneDesc plane;
84 
85  res = LCEVC_GetPictureLockPlaneDesc(lcevc->decoder, lock, i, &plane);
86  if (res != LCEVC_Success)
87  return AVERROR_EXTERNAL;
88 
89  data[i] = plane.firstSample;
90  linesizes[i] = plane.rowByteStride;
91  }
92 
93  av_image_copy2(data, linesizes, frame->data, frame->linesize,
94  frame->format, frame->width, frame->height);
95 
96  res = LCEVC_UnlockPicture(lcevc->decoder, lock);
97  if (res != LCEVC_Success)
98  return AVERROR_EXTERNAL;
99 
100  return 0;
101 }
102 
103 static int alloc_enhanced_frame(void *logctx, FFLCEVCFrame *frame_ctx,
104  LCEVC_PictureHandle *picture)
105 {
106  FFLCEVCContext *lcevc = frame_ctx->lcevc;
107  LCEVC_PictureDesc desc ;
108  LCEVC_ColorFormat fmt = map_format(frame_ctx->frame->format);
109  LCEVC_PicturePlaneDesc planes[4] = { 0 };
110  LCEVC_ReturnCode res;
111 
112  res = LCEVC_DefaultPictureDesc(&desc, fmt, frame_ctx->frame->width, frame_ctx->frame->height);
113  if (res != LCEVC_Success)
114  return AVERROR_EXTERNAL;
115 
116  /* Set plane description */
117  for (int i = 0; i < 4; i++) {
118  planes[i].firstSample = frame_ctx->frame->data[i];
119  planes[i].rowByteStride = frame_ctx->frame->linesize[i];
120  }
121 
122  /* Allocate LCEVC Picture */
123  res = LCEVC_AllocPictureExternal(lcevc->decoder, &desc, NULL, planes, picture);
124  if (res != LCEVC_Success) {
125  return AVERROR_EXTERNAL;
126  }
127  return 0;
128 }
129 
130 static int lcevc_send_frame(void *logctx, FFLCEVCFrame *frame_ctx, const AVFrame *in)
131 {
132  FFLCEVCContext *lcevc = frame_ctx->lcevc;
134  LCEVC_PictureHandle picture;
135  LCEVC_ReturnCode res;
136  int ret = 0;
137 
138  if (!sd)
139  return 1;
140 
141  res = LCEVC_SendDecoderEnhancementData(lcevc->decoder, in->pts, sd->data, sd->size);
142  if (res != LCEVC_Success)
143  return AVERROR_EXTERNAL;
144 
145  ret = alloc_base_frame(logctx, lcevc, in, &picture);
146  if (ret < 0)
147  return ret;
148 
149  res = LCEVC_SendDecoderBase(lcevc->decoder, in->pts, picture, -1, NULL);
150  if (res != LCEVC_Success)
151  return AVERROR_EXTERNAL;
152 
153  memset(&picture, 0, sizeof(picture));
154  ret = alloc_enhanced_frame(logctx, frame_ctx, &picture);
155  if (ret < 0)
156  return ret;
157 
158  res = LCEVC_SendDecoderPicture(lcevc->decoder, picture);
159  if (res != LCEVC_Success)
160  return AVERROR_EXTERNAL;
161 
162  return 0;
163 }
164 
165 static int generate_output(void *logctx, FFLCEVCFrame *frame_ctx, AVFrame *out)
166 {
167  FFLCEVCContext *lcevc = frame_ctx->lcevc;
168  LCEVC_PictureDesc desc;
169  LCEVC_DecodeInformation info;
170  LCEVC_PictureHandle picture;
171  LCEVC_ReturnCode res;
172 
173  res = LCEVC_ReceiveDecoderPicture(lcevc->decoder, &picture, &info);
174  if (res != LCEVC_Success)
175  return AVERROR_EXTERNAL;
176 
177  res = LCEVC_GetPictureDesc(lcevc->decoder, picture, &desc);
178  if (res != LCEVC_Success)
179  return AVERROR_EXTERNAL;
180 
181  out->crop_top = desc.cropTop;
182  out->crop_bottom = desc.cropBottom;
183  out->crop_left = desc.cropLeft;
184  out->crop_right = desc.cropRight;
185  out->sample_aspect_ratio.num = desc.sampleAspectRatioNum;
186  out->sample_aspect_ratio.den = desc.sampleAspectRatioDen;
187 
188  av_frame_copy_props(frame_ctx->frame, out);
190  av_frame_move_ref(out, frame_ctx->frame);
191 
192  out->width = desc.width + out->crop_left + out->crop_right;
193  out->height = desc.height + out->crop_top + out->crop_bottom;
194 
195  res = LCEVC_FreePicture(lcevc->decoder, picture);
196  if (res != LCEVC_Success)
197  return AVERROR_EXTERNAL;
198 
199  return 0;
200 }
201 
202 static int lcevc_receive_frame(void *logctx, FFLCEVCFrame *frame_ctx, AVFrame *out)
203 {
204  FFLCEVCContext *lcevc = frame_ctx->lcevc;
205  LCEVC_PictureHandle picture;
206  LCEVC_ReturnCode res;
207  int ret;
208 
209  ret = generate_output(logctx, frame_ctx, out);
210  if (ret < 0)
211  return ret;
212 
213  while (1) {
214  res = LCEVC_ReceiveDecoderBase (lcevc->decoder, &picture);
215  if (res != LCEVC_Success && res != LCEVC_Again)
216  return AVERROR_EXTERNAL;
217 
218  if (res == LCEVC_Again)
219  break;
220 
221  res = LCEVC_FreePicture(lcevc->decoder, picture);
222  if (res != LCEVC_Success)
223  return AVERROR_EXTERNAL;
224  }
225 
226  return 0;
227 }
228 
229 static void event_callback(LCEVC_DecoderHandle dec, LCEVC_Event event,
230  LCEVC_PictureHandle pic, const LCEVC_DecodeInformation *info,
231  const uint8_t *data, uint32_t size, void *logctx)
232 {
233  switch (event) {
234  case LCEVC_Log:
235  av_log(logctx, AV_LOG_INFO, "%s\n", data);
236  break;
237  default:
238  break;
239  }
240 }
241 
242 static void lcevc_free(AVRefStructOpaque unused, void *obj)
243 {
244  FFLCEVCContext *lcevc = obj;
245  if (lcevc->initialized)
246  LCEVC_DestroyDecoder(lcevc->decoder);
247  memset(lcevc, 0, sizeof(*lcevc));
248 }
249 
250 static int lcevc_init(FFLCEVCContext *lcevc, void *logctx)
251 {
252  LCEVC_AccelContextHandle dummy = { 0 };
253  const int32_t event = LCEVC_Log;
254 
255  if (LCEVC_CreateDecoder(&lcevc->decoder, dummy) != LCEVC_Success) {
256  av_log(logctx, AV_LOG_ERROR, "Failed to create LCEVC decoder\n");
257  return AVERROR_EXTERNAL;
258  }
259 
260  LCEVC_ConfigureDecoderInt(lcevc->decoder, "log_level", 4);
261  LCEVC_ConfigureDecoderIntArray(lcevc->decoder, "events", 1, &event);
262  LCEVC_SetDecoderEventCallback(lcevc->decoder, event_callback, logctx);
263 
264  if (LCEVC_InitializeDecoder(lcevc->decoder) != LCEVC_Success) {
265  av_log(logctx, AV_LOG_ERROR, "Failed to initialize LCEVC decoder\n");
266  LCEVC_DestroyDecoder(lcevc->decoder);
267  return AVERROR_EXTERNAL;
268  }
269 
270  lcevc->initialized = 1;
271 
272  return 0;
273 }
274 
275 int ff_lcevc_process(void *logctx, AVFrame *frame)
276 {
277  FrameDecodeData *fdd = frame->private_ref;
278  FFLCEVCFrame *frame_ctx = fdd->post_process_opaque;
279  FFLCEVCContext *lcevc = frame_ctx->lcevc;
280  int ret;
281 
282  if (!lcevc->initialized) {
283  ret = lcevc_init(lcevc, logctx);
284  if (ret < 0)
285  return ret;
286  }
287 
288  av_assert0(frame_ctx->frame);
289 
290 
291  ret = lcevc_send_frame(logctx, frame_ctx, frame);
292  if (ret)
293  return ret < 0 ? ret : 0;
294 
295  lcevc_receive_frame(logctx, frame_ctx, frame);
296  if (ret < 0)
297  return ret;
298 
300 
301  return 0;
302 }
303 
305 {
306  FFLCEVCContext *lcevc = NULL;
307  lcevc = av_refstruct_alloc_ext(sizeof(*lcevc), 0, NULL, lcevc_free);
308  if (!lcevc)
309  return AVERROR(ENOMEM);
310  *plcevc = lcevc;
311  return 0;
312 }
313 
314 void ff_lcevc_unref(void *opaque)
315 {
316  FFLCEVCFrame *lcevc = opaque;
317  av_refstruct_unref(&lcevc->lcevc);
318  av_frame_free(&lcevc->frame);
319  av_free(opaque);
320 }
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:659
ff_lcevc_alloc
int ff_lcevc_alloc(FFLCEVCContext **plcevc)
Definition: lcevcdec.c:304
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:64
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:427
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:529
AVFrame::width
int width
Definition: frame.h:499
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:250
AV_PIX_FMT_YUV420P10
#define AV_PIX_FMT_YUV420P10
Definition: pixfmt.h:539
FFLCEVCContext::initialized
int initialized
Definition: lcevcdec.h:33
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:448
dummy
int dummy
Definition: motion.c:64
ff_lcevc_process
int ff_lcevc_process(void *logctx, AVFrame *frame)
Definition: lcevcdec.c:275
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:285
FrameDecodeData::post_process_opaque
void * post_process_opaque
Definition: decode.h:45
info
MIPS optimizations info
Definition: mips.txt:2
lcevc_free
static void lcevc_free(AVRefStructOpaque unused, void *obj)
Definition: lcevcdec.c:242
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
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
map_format
static LCEVC_ColorFormat map_format(int format)
Definition: lcevcdec.c:29
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:599
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:314
FFLCEVCFrame::lcevc
FFLCEVCContext * lcevc
Definition: lcevcdec.h:39
AV_PIX_FMT_GRAY8
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
Definition: pixfmt.h:81
alloc_base_frame
static int alloc_base_frame(void *logctx, FFLCEVCContext *lcevc, const AVFrame *frame, LCEVC_PictureHandle *picture)
Definition: lcevcdec.c:47
event_callback
static void event_callback(LCEVC_DecoderHandle dec, LCEVC_Event event, LCEVC_PictureHandle pic, const LCEVC_DecodeInformation *info, const uint8_t *data, uint32_t size, void *logctx)
Definition: lcevcdec.c:229
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
AVFrameSideData::data
uint8_t * data
Definition: frame.h:284
generate_output
static int generate_output(void *logctx, FFLCEVCFrame *frame_ctx, AVFrame *out)
Definition: lcevcdec.c:165
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:514
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:725
AVERROR_EXTERNAL
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition: error.h:59
alloc_enhanced_frame
static int alloc_enhanced_frame(void *logctx, FFLCEVCFrame *frame_ctx, LCEVC_PictureHandle *picture)
Definition: lcevcdec.c:103
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:523
av_frame_unref
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:496
planes
static const struct @546 planes[]
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:265
AVFrame::height
int height
Definition: frame.h:499
lcevc_send_frame
static int lcevc_send_frame(void *logctx, FFLCEVCFrame *frame_ctx, const AVFrame *in)
Definition: lcevcdec.c:130
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:78
mem.h
AVFrameSideData
Structure to hold side data for an AVFrame.
Definition: frame.h:282
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:472
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
lcevc_receive_frame
static int lcevc_receive_frame(void *logctx, FFLCEVCFrame *frame_ctx, AVFrame *out)
Definition: lcevcdec.c:202