FFmpeg
prores_metadata_bsf.c
Go to the documentation of this file.
1 /*
2  * Prores Metadata bitstream filter
3  * Copyright (c) 2018 Jokyo Images
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg 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  * FFmpeg 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 FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 /**
23  * @file
24  * Prores Metadata bitstream filter
25  * set frame colorspace property
26  */
27 
28 #include "libavutil/common.h"
29 #include "libavutil/intreadwrite.h"
30 #include "libavutil/opt.h"
31 
32 #include "bsf.h"
33 #include "bsf_internal.h"
34 
35 typedef struct ProresMetadataContext {
36  const AVClass *class;
37 
38  int color_primaries;
39  int transfer_characteristics;
40  int matrix_coefficients;
41 } ProresMetadataContext;
42 
43 static int prores_metadata(AVBSFContext *bsf, AVPacket *pkt)
44 {
45  ProresMetadataContext *ctx = bsf->priv_data;
46  int ret = 0;
47  int buf_size;
48  uint8_t *buf;
49 
50  ret = ff_bsf_get_packet_ref(bsf, pkt);
51  if (ret < 0)
52  return ret;
53 
54  ret = av_packet_make_writable(pkt);
55  if (ret < 0)
56  goto fail;
57 
58  buf = pkt->data;
59  buf_size = pkt->size;
60 
61  /* check start of the prores frame */
62  if (buf_size < 28) {
63  av_log(bsf, AV_LOG_ERROR, "not enough data in prores frame\n");
64  ret = AVERROR_INVALIDDATA;
65  goto fail;
66  }
67 
68  if (AV_RL32(buf + 4) != AV_RL32("icpf")) {
69  av_log(bsf, AV_LOG_ERROR, "invalid frame header\n");
70  ret = AVERROR_INVALIDDATA;
71  goto fail;
72  }
73 
74  if (AV_RB16(buf + 8) < 28) {
75  av_log(bsf, AV_LOG_ERROR, "invalid frame header size\n");
76  ret = AVERROR_INVALIDDATA;
77  goto fail;
78  }
79 
80  /* set the new values */
81  if (ctx->color_primaries != -1)
82  buf[8+14] = ctx->color_primaries;
83  if (ctx->transfer_characteristics != -1)
84  buf[8+15] = ctx->transfer_characteristics;
85  if (ctx->matrix_coefficients != -1)
86  buf[8+16] = ctx->matrix_coefficients;
87 
88 fail:
89  if (ret < 0)
90  av_packet_unref(pkt);
91  return ret;
92 }
93 
94 static const enum AVCodecID codec_ids[] = {
95  AV_CODEC_ID_PRORES, AV_CODEC_ID_NONE,
96 };
97 
98 static int prores_metadata_init(AVBSFContext *bsf)
99 {
100  ProresMetadataContext *ctx = bsf->priv_data;
101  /*! check options */
102  switch (ctx->color_primaries) {
103  case -1:
104  case 0:
105  case AVCOL_PRI_BT709:
106  case AVCOL_PRI_BT470BG:
107  case AVCOL_PRI_SMPTE170M:
108  case AVCOL_PRI_BT2020:
109  case AVCOL_PRI_SMPTE431:
110  case AVCOL_PRI_SMPTE432:
111  break;
112  default:
113  av_log(bsf, AV_LOG_ERROR, "Color primaries %d is not a valid value\n", ctx->color_primaries);
114  return AVERROR(EINVAL);
115  }
116 
117  switch (ctx->matrix_coefficients) {
118  case -1:
119  case 0:
120  case AVCOL_SPC_BT709:
121  case AVCOL_SPC_SMPTE170M:
122  case AVCOL_SPC_BT2020_NCL:
123  break;
124  default:
125  av_log(bsf, AV_LOG_ERROR, "Colorspace %d is not a valid value\n", ctx->matrix_coefficients);
126  return AVERROR(EINVAL);
127  }
128 
129  return 0;
130 }
131 
132 #define OFFSET(x) offsetof(ProresMetadataContext, x)
133 #define FLAGS (AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_BSF_PARAM)
134 static const AVOption options[] = {
135  {"color_primaries", "select color primaries", OFFSET(color_primaries), AV_OPT_TYPE_INT, {.i64=-1}, -1, AVCOL_PRI_SMPTE432, FLAGS, "color_primaries"},
136  {"auto", "keep the same color primaries", 0, AV_OPT_TYPE_CONST, {.i64=-1}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
137  {"unknown", NULL, 0, AV_OPT_TYPE_CONST, {.i64=0}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
138  {"bt709", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_PRI_BT709}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
139  {"bt470bg", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_PRI_BT470BG}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
140  {"smpte170m", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_PRI_SMPTE170M}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
141  {"bt2020", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_PRI_BT2020}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
142  {"smpte431", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_PRI_SMPTE431}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
143  {"smpte432", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_PRI_SMPTE432}, INT_MIN, INT_MAX, FLAGS, "color_primaries"},
144 
145  {"color_trc", "select color transfer", OFFSET(transfer_characteristics), AV_OPT_TYPE_INT, {.i64=-1}, -1, AVCOL_TRC_NB - 1, FLAGS, "color_trc"},
146  {"auto", "keep the same color transfer", 0, AV_OPT_TYPE_CONST, {.i64=-1}, INT_MIN, INT_MAX, FLAGS, "color_trc"},
147  {"unknown", NULL, 0, AV_OPT_TYPE_CONST, {.i64=0}, INT_MIN, INT_MAX, FLAGS, "color_trc"},
148  {"bt709", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_TRC_BT709}, INT_MIN, INT_MAX, FLAGS, "color_trc"},
149  {"smpte2084", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_TRC_SMPTE2084}, INT_MIN, INT_MAX, FLAGS, "color_trc"},
150  {"arib-std-b67", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_TRC_ARIB_STD_B67}, INT_MIN, INT_MAX, FLAGS, "color_trc"},
151 
152  {"colorspace", "select colorspace", OFFSET(matrix_coefficients), AV_OPT_TYPE_INT, {.i64=-1}, -1, AVCOL_SPC_BT2020_NCL, FLAGS, "colorspace"},
153  {"auto", "keep the same colorspace", 0, AV_OPT_TYPE_CONST, {.i64=-1}, INT_MIN, INT_MAX, FLAGS, "colorspace"},
154  {"unknown", NULL, 0, AV_OPT_TYPE_CONST, {.i64=0}, INT_MIN, INT_MAX, FLAGS, "colorspace"},
155  {"bt709", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_SPC_BT709}, INT_MIN, INT_MAX, FLAGS, "colorspace"},
156  {"smpte170m", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_SPC_SMPTE170M}, INT_MIN, INT_MAX, FLAGS, "colorspace"},
157  {"bt2020nc", NULL, 0, AV_OPT_TYPE_CONST, {.i64=AVCOL_SPC_BT2020_NCL}, INT_MIN, INT_MAX, FLAGS, "colorspace"},
158 
159  { NULL },
160 };
161 
162 static const AVClass prores_metadata_class = {
163  .class_name = "prores_metadata_bsf",
164  .item_name = av_default_item_name,
165  .option = options,
166  .version = LIBAVUTIL_VERSION_INT,
167 };
168 
169 const AVBitStreamFilter ff_prores_metadata_bsf = {
170  .name = "prores_metadata",
171  .init = prores_metadata_init,
172  .filter = prores_metadata,
173  .priv_data_size = sizeof(ProresMetadataContext),
174  .priv_class = &prores_metadata_class,
175  .codec_ids = codec_ids,
176 };
ProresMetadataContext::matrix_coefficients
int matrix_coefficients
Definition: prores_metadata_bsf.c:40
av_packet_unref
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:605
prores_metadata_class
static const AVClass prores_metadata_class
Definition: prores_metadata_bsf.c:162
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
bsf_internal.h
opt.h
AVBitStreamFilter::name
const char * name
Definition: bsf.h:99
options
static const AVOption options[]
Definition: prores_metadata_bsf.c:134
AVCOL_TRC_NB
@ AVCOL_TRC_NB
Not part of ABI.
Definition: pixfmt.h:502
AVPacket::data
uint8_t * data
Definition: packet.h:355
AVOption
AVOption.
Definition: opt.h:246
AVBSFContext
The bitstream filter state.
Definition: bsf.h:49
bsf.h
fail
#define fail()
Definition: checkasm.h:123
prores_metadata_init
static int prores_metadata_init(AVBSFContext *bsf)
Definition: prores_metadata_bsf.c:98
ProresMetadataContext::transfer_characteristics
int transfer_characteristics
Definition: prores_metadata_bsf.c:39
ProresMetadataContext
Definition: prores_metadata_bsf.c:35
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
intreadwrite.h
AVCOL_SPC_SMPTE170M
@ AVCOL_SPC_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC
Definition: pixfmt.h:516
ctx
AVFormatContext * ctx
Definition: movenc.c:48
ff_prores_metadata_bsf
const AVBitStreamFilter ff_prores_metadata_bsf
Definition: prores_metadata_bsf.c:169
AVCOL_PRI_BT470BG
@ AVCOL_PRI_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM
Definition: pixfmt.h:462
AVCOL_PRI_SMPTE170M
@ AVCOL_PRI_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC
Definition: pixfmt.h:463
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
AVCOL_PRI_BT709
@ AVCOL_PRI_BT709
also ITU-R BT1361 / IEC 61966-2-4 / SMPTE RP177 Annex B
Definition: pixfmt.h:457
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:235
AVCodecID
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: codec_id.h:46
AVCOL_PRI_BT2020
@ AVCOL_PRI_BT2020
ITU-R BT2020.
Definition: pixfmt.h:466
AVCOL_TRC_SMPTE2084
@ AVCOL_TRC_SMPTE2084
SMPTE ST 2084 for 10-, 12-, 14- and 16-bit systems.
Definition: pixfmt.h:497
AVCOL_PRI_SMPTE431
@ AVCOL_PRI_SMPTE431
SMPTE ST 431-2 (2011) / DCI P3.
Definition: pixfmt.h:469
AVPacket::size
int size
Definition: packet.h:356
OFFSET
#define OFFSET(x)
Definition: prores_metadata_bsf.c:132
transfer_characteristics
static const struct TransferCharacteristics transfer_characteristics[AVCOL_TRC_NB]
Definition: vf_colorspace.c:176
AVCOL_TRC_BT709
@ AVCOL_TRC_BT709
also ITU-R BT1361
Definition: pixfmt.h:482
AV_CODEC_ID_NONE
@ AV_CODEC_ID_NONE
Definition: codec_id.h:47
AVCOL_SPC_BT2020_NCL
@ AVCOL_SPC_BT2020_NCL
ITU-R BT2020 non-constant luminance system.
Definition: pixfmt.h:520
common.h
codec_ids
static enum AVCodecID codec_ids[]
Definition: prores_metadata_bsf.c:94
uint8_t
uint8_t
Definition: audio_convert.c:194
AVBSFContext::priv_data
void * priv_data
Opaque filter-specific private data.
Definition: bsf.h:70
ret
ret
Definition: filter_design.txt:187
AVClass::class_name
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
FLAGS
#define FLAGS
Definition: prores_metadata_bsf.c:133
AV_RL32
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_RL32
Definition: bytestream.h:88
AVCOL_TRC_ARIB_STD_B67
@ AVCOL_TRC_ARIB_STD_B67
ARIB STD-B67, known as "Hybrid log-gamma".
Definition: pixfmt.h:501
pkt
static AVPacket pkt
Definition: demuxing_decoding.c:54
AVBitStreamFilter
Definition: bsf.h:98
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:223
av_packet_make_writable
int av_packet_make_writable(AVPacket *pkt)
Create a writable reference for the data described by a given packet, avoiding data copy if possible.
Definition: avpacket.c:690
AVCOL_PRI_SMPTE432
@ AVCOL_PRI_SMPTE432
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
Definition: pixfmt.h:470
AVPacket
This structure stores compressed data.
Definition: packet.h:332
ProresMetadataContext::color_primaries
int color_primaries
Definition: prores_metadata_bsf.c:38
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
prores_metadata
static int prores_metadata(AVBSFContext *bsf, AVPacket *pkt)
Definition: prores_metadata_bsf.c:43
ff_bsf_get_packet_ref
int ff_bsf_get_packet_ref(AVBSFContext *ctx, AVPacket *pkt)
Called by bitstream filters to get packet for filtering.
Definition: bsf.c:249
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
AVCOL_SPC_BT709
@ AVCOL_SPC_BT709
also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / SMPTE RP177 Annex B
Definition: pixfmt.h:511
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:232
color_primaries
static const struct ColorPrimaries color_primaries[AVCOL_PRI_NB]
Definition: vf_colorspace.c:209
AV_CODEC_ID_PRORES
@ AV_CODEC_ID_PRORES
Definition: codec_id.h:197
AV_RB16
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_WL32 unsigned int_TMPL AV_WL24 unsigned int_TMPL AV_WL16 uint64_t_TMPL AV_WB64 unsigned int_TMPL AV_WB32 unsigned int_TMPL AV_WB24 unsigned int_TMPL AV_RB16
Definition: bytestream.h:94
Generated on Wed Aug 24 2022 21:31:31 for FFmpeg by   doxygen 1.8.17