git.sesse.net Git - ffmpeg/blob - libavcodec/av1_metadata_bsf.c

   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/common.h"
  20 #include "libavutil/opt.h"
  21
  22 #include "bsf.h"
  23 #include "cbs.h"
  24 #include "cbs_av1.h"
  25
  26 enum {
  27     PASS,
  28     INSERT,
  29     REMOVE,
  30 };
  31
  32 typedef struct AV1MetadataContext {
  33     const AVClass *class;
  34
  35     CodedBitstreamContext *cbc;
  36     CodedBitstreamFragment access_unit;
  37
  38     int td;
  39
  40     int color_primaries;
  41     int transfer_characteristics;
  42     int matrix_coefficients;
  43
  44     int color_range;
  45     int chroma_sample_position;
  46
  47     AVRational tick_rate;
  48     int num_ticks_per_picture;
  49
  50     int delete_padding;
  51 } AV1MetadataContext;
  52
  53
  54 static int av1_metadata_update_sequence_header(AVBSFContext *bsf,
  55                                                AV1RawSequenceHeader *seq)
  56 {
  57     AV1MetadataContext *ctx = bsf->priv_data;
  58     AV1RawColorConfig  *clc = &seq->color_config;
  59     AV1RawTimingInfo   *tim = &seq->timing_info;
  60
  61     if (ctx->color_primaries >= 0          ||
  62         ctx->transfer_characteristics >= 0 ||
  63         ctx->matrix_coefficients >= 0) {
  64         if (!clc->color_description_present_flag) {
  65             clc->color_description_present_flag = 1;
  66             clc->color_primaries          = AVCOL_PRI_UNSPECIFIED;
  67             clc->transfer_characteristics = AVCOL_TRC_UNSPECIFIED;
  68             clc->matrix_coefficients      = AVCOL_SPC_UNSPECIFIED;
  69         }
  70
  71         if (ctx->color_primaries >= 0)
  72             clc->color_primaries = ctx->color_primaries;
  73         if (ctx->transfer_characteristics >= 0)
  74             clc->transfer_characteristics = ctx->transfer_characteristics;
  75         if (ctx->matrix_coefficients >= 0)
  76             clc->matrix_coefficients = ctx->matrix_coefficients;
  77     }
  78
  79     if (ctx->color_range >= 0) {
  80         if (clc->color_primaries          == AVCOL_PRI_BT709        &&
  81             clc->transfer_characteristics == AVCOL_TRC_IEC61966_2_1 &&
  82             clc->matrix_coefficients      == AVCOL_SPC_RGB) {
  83             av_log(bsf, AV_LOG_WARNING, "Warning: color_range cannot be set "
  84                    "on RGB streams encoded in BT.709 sRGB.\n");
  85         } else {
  86             clc->color_range = ctx->color_range;
  87         }
  88     }
  89
  90     if (ctx->chroma_sample_position >= 0) {
  91         if (clc->mono_chrome || !clc->subsampling_x || !clc->subsampling_y) {
  92             av_log(bsf, AV_LOG_WARNING, "Warning: chroma_sample_position "
  93                    "can only be set for 4:2:0 streams.\n");
  94         } else {
  95             clc->chroma_sample_position = ctx->chroma_sample_position;
  96         }
  97     }
  98
  99     if (ctx->tick_rate.num && ctx->tick_rate.den) {
 100         int num, den;
 101
 102         av_reduce(&num, &den, ctx->tick_rate.num, ctx->tick_rate.den,
 103                   UINT32_MAX > INT_MAX ? UINT32_MAX : INT_MAX);
 104
 105         tim->time_scale                = num;
 106         tim->num_units_in_display_tick = den;
 107         seq->timing_info_present_flag  = 1;
 108
 109         if (ctx->num_ticks_per_picture > 0) {
 110             tim->equal_picture_interval = 1;
 111             tim->num_ticks_per_picture_minus_1 =
 112                 ctx->num_ticks_per_picture - 1;
 113         }
 114     }
 115
 116     return 0;
 117 }
 118
 119 static int av1_metadata_filter(AVBSFContext *bsf, AVPacket *pkt)
 120 {
 121     AV1MetadataContext *ctx = bsf->priv_data;
 122     CodedBitstreamFragment *frag = &ctx->access_unit;
 123     AV1RawOBU td, *obu;
 124     int err, i;
 125
 126     err = ff_bsf_get_packet_ref(bsf, pkt);
 127     if (err < 0)
 128         return err;
 129
 130     err = ff_cbs_read_packet(ctx->cbc, frag, pkt);
 131     if (err < 0) {
 132         av_log(bsf, AV_LOG_ERROR, "Failed to read packet.\n");
 133         goto fail;
 134     }
 135
 136     if (frag->nb_units == 0) {
 137         av_log(bsf, AV_LOG_ERROR, "No OBU in packet.\n");
 138         err = AVERROR_INVALIDDATA;
 139         goto fail;
 140     }
 141
 142     for (i = 0; i < frag->nb_units; i++) {
 143         if (frag->units[i].type == AV1_OBU_SEQUENCE_HEADER) {
 144             obu = frag->units[i].content;
 145             err = av1_metadata_update_sequence_header(bsf, &obu->obu.sequence_header);
 146             if (err < 0)
 147                 goto fail;
 148         }
 149     }
 150
 151     // If a Temporal Delimiter is present, it must be the first OBU.
 152     if (frag->units[0].type == AV1_OBU_TEMPORAL_DELIMITER) {
 153         if (ctx->td == REMOVE)
 154             ff_cbs_delete_unit(ctx->cbc, frag, 0);
 155     } else if (ctx->td == INSERT) {
 156         td = (AV1RawOBU) {
 157             .header.obu_type = AV1_OBU_TEMPORAL_DELIMITER,
 158         };
 159
 160         err = ff_cbs_insert_unit_content(ctx->cbc, frag, 0, AV1_OBU_TEMPORAL_DELIMITER,
 161                                          &td, NULL);
 162         if (err < 0) {
 163             av_log(bsf, AV_LOG_ERROR, "Failed to insert Temporal Delimiter.\n");
 164             goto fail;
 165         }
 166     }
 167
 168     if (ctx->delete_padding) {
 169         for (i = frag->nb_units - 1; i >= 0; i--) {
 170             if (frag->units[i].type == AV1_OBU_PADDING)
 171                 ff_cbs_delete_unit(ctx->cbc, frag, i);
 172         }
 173     }
 174
 175     err = ff_cbs_write_packet(ctx->cbc, pkt, frag);
 176     if (err < 0) {
 177         av_log(bsf, AV_LOG_ERROR, "Failed to write packet.\n");
 178         goto fail;
 179     }
 180
 181     err = 0;
 182 fail:
 183     ff_cbs_fragment_reset(ctx->cbc, frag);
 184
 185     if (err < 0)
 186         av_packet_unref(pkt);
 187
 188     return err;
 189 }
 190
 191 static int av1_metadata_init(AVBSFContext *bsf)
 192 {
 193     AV1MetadataContext *ctx = bsf->priv_data;
 194     CodedBitstreamFragment *frag = &ctx->access_unit;
 195     AV1RawOBU *obu;
 196     int err, i;
 197
 198     err = ff_cbs_init(&ctx->cbc, AV_CODEC_ID_AV1, bsf);
 199     if (err < 0)
 200         return err;
 201
 202     if (bsf->par_in->extradata) {
 203         err = ff_cbs_read_extradata(ctx->cbc, frag, bsf->par_in);
 204         if (err < 0) {
 205             av_log(bsf, AV_LOG_ERROR, "Failed to read extradata.\n");
 206             goto fail;
 207         }
 208
 209         for (i = 0; i < frag->nb_units; i++) {
 210             if (frag->units[i].type == AV1_OBU_SEQUENCE_HEADER) {
 211                 obu = frag->units[i].content;
 212                 err = av1_metadata_update_sequence_header(bsf, &obu->obu.sequence_header);
 213                 if (err < 0)
 214                     goto fail;
 215             }
 216         }
 217
 218         err = ff_cbs_write_extradata(ctx->cbc, bsf->par_out, frag);
 219         if (err < 0) {
 220             av_log(bsf, AV_LOG_ERROR, "Failed to write extradata.\n");
 221             goto fail;
 222         }
 223     }
 224
 225     err = 0;
 226 fail:
 227     ff_cbs_fragment_reset(ctx->cbc, frag);
 228     return err;
 229 }
 230
 231 static void av1_metadata_close(AVBSFContext *bsf)
 232 {
 233     AV1MetadataContext *ctx = bsf->priv_data;
 234
 235     ff_cbs_fragment_free(ctx->cbc, &ctx->access_unit);
 236     ff_cbs_close(&ctx->cbc);
 237 }
 238
 239 #define OFFSET(x) offsetof(AV1MetadataContext, x)
 240 #define FLAGS (AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_BSF_PARAM)
 241 static const AVOption av1_metadata_options[] = {
 242     { "td", "Temporal Delimiter OBU",
 243         OFFSET(td), AV_OPT_TYPE_INT,
 244         { .i64 = PASS }, PASS, REMOVE, FLAGS, "td" },
 245     { "pass",   NULL, 0, AV_OPT_TYPE_CONST,
 246         { .i64 = PASS   }, .flags = FLAGS, .unit = "td" },
 247     { "insert", NULL, 0, AV_OPT_TYPE_CONST,
 248         { .i64 = INSERT }, .flags = FLAGS, .unit = "td" },
 249     { "remove", NULL, 0, AV_OPT_TYPE_CONST,
 250         { .i64 = REMOVE }, .flags = FLAGS, .unit = "td" },
 251
 252     { "color_primaries", "Set color primaries (section 6.4.2)",
 253         OFFSET(color_primaries), AV_OPT_TYPE_INT,
 254         { .i64 = -1 }, -1, 255, FLAGS },
 255     { "transfer_characteristics", "Set transfer characteristics (section 6.4.2)",
 256         OFFSET(transfer_characteristics), AV_OPT_TYPE_INT,
 257         { .i64 = -1 }, -1, 255, FLAGS },
 258     { "matrix_coefficients", "Set matrix coefficients (section 6.4.2)",
 259         OFFSET(matrix_coefficients), AV_OPT_TYPE_INT,
 260         { .i64 = -1 }, -1, 255, FLAGS },
 261
 262     { "color_range", "Set color range flag (section 6.4.2)",
 263         OFFSET(color_range), AV_OPT_TYPE_INT,
 264         { .i64 = -1 }, -1, 1, FLAGS, "cr" },
 265     { "tv", "TV (limited) range", 0, AV_OPT_TYPE_CONST,
 266         { .i64 = 0 }, .flags = FLAGS, .unit = "cr" },
 267     { "pc", "PC (full) range",    0, AV_OPT_TYPE_CONST,
 268         { .i64 = 1 }, .flags = FLAGS, .unit = "cr" },
 269
 270     { "chroma_sample_position", "Set chroma sample position (section 6.4.2)",
 271         OFFSET(chroma_sample_position), AV_OPT_TYPE_INT,
 272         { .i64 = -1 }, -1, 3, FLAGS, "csp" },
 273     { "unknown",   "Unknown chroma sample position",  0, AV_OPT_TYPE_CONST,
 274         { .i64 = AV1_CSP_UNKNOWN },   .flags = FLAGS, .unit = "csp" },
 275     { "vertical",  "Left chroma sample position",     0, AV_OPT_TYPE_CONST,
 276         { .i64 = AV1_CSP_VERTICAL },  .flags = FLAGS, .unit = "csp" },
 277     { "colocated", "Top-left chroma sample position", 0, AV_OPT_TYPE_CONST,
 278         { .i64 = AV1_CSP_COLOCATED }, .flags = FLAGS, .unit = "csp" },
 279
 280     { "tick_rate", "Set display tick rate (num_units_in_display_tick / time_scale)",
 281         OFFSET(tick_rate), AV_OPT_TYPE_RATIONAL,
 282         { .dbl = 0.0 }, 0, UINT_MAX, FLAGS },
 283     { "num_ticks_per_picture", "Set display ticks per picture for CFR streams",
 284         OFFSET(num_ticks_per_picture), AV_OPT_TYPE_INT,
 285         { .i64 = -1 }, -1, INT_MAX, FLAGS },
 286
 287     { "delete_padding", "Delete all Padding OBUs",
 288         OFFSET(delete_padding), AV_OPT_TYPE_BOOL,
 289         { .i64 = 0 }, 0, 1, FLAGS},
 290
 291     { NULL }
 292 };
 293
 294 static const AVClass av1_metadata_class = {
 295     .class_name = "av1_metadata_bsf",
 296     .item_name  = av_default_item_name,
 297     .option     = av1_metadata_options,
 298     .version    = LIBAVUTIL_VERSION_INT,
 299 };
 300
 301 static const enum AVCodecID av1_metadata_codec_ids[] = {
 302     AV_CODEC_ID_AV1, AV_CODEC_ID_NONE,
 303 };
 304
 305 const AVBitStreamFilter ff_av1_metadata_bsf = {
 306     .name           = "av1_metadata",
 307     .priv_data_size = sizeof(AV1MetadataContext),
 308     .priv_class     = &av1_metadata_class,
 309     .init           = &av1_metadata_init,
 310     .close          = &av1_metadata_close,
 311     .filter         = &av1_metadata_filter,
 312     .codec_ids      = av1_metadata_codec_ids,
 313 };