diff mbox series

[FFmpeg-devel,09/10] avcodec/avcodec, options_table: Deprecate sub_text_format

Message ID AM7PR03MB666042FFB36FB31A17F0EAF68FD99@AM7PR03MB6660.eurprd03.prod.outlook.com
State Accepted
Headers show
Series [FFmpeg-devel,01/10] avcodec/mpegvideo: Move startcodes to mpeg12.h | expand

Checks

Context Check Description
andriy/make_x86 success Make finished
andriy/make_fate_x86 success Make fate finished
andriy/make_ppc success Make finished
andriy/make_fate_ppc success Make fate finished

Commit Message

Andreas Rheinhardt Sept. 13, 2021, 1:53 p.m. UTC
Unused since 1f63665ca567fbc49fa80166d468a822c2999efa.

Found-by: Soft Works <softworkz@hotmail.com>
Signed-off-by: Andreas Rheinhardt <andreas.rheinhardt@outlook.com>
---
 doc/APIchanges             | 4 ++++
 libavcodec/avcodec.h       | 7 ++++---
 libavcodec/options_table.h | 4 +++-
 libavcodec/version.h       | 3 +++
 4 files changed, 14 insertions(+), 4 deletions(-)

Comments

Soft Works Sept. 13, 2021, 5:36 p.m. UTC | #1
> -----Original Message-----
> From: Andreas Rheinhardt <andreas.rheinhardt@outlook.com>
> Sent: Monday, 13 September 2021 15:54
> To: ffmpeg-devel@ffmpeg.org
> Cc: Andreas Rheinhardt <andreas.rheinhardt@outlook.com>; Soft Works
> <softworkz@hotmail.com>
> Subject: [PATCH 09/10] avcodec/avcodec, options_table: Deprecate
> sub_text_format
> 
> Unused since 1f63665ca567fbc49fa80166d468a822c2999efa.
> 
> Found-by: Soft Works <softworkz@hotmail.com>
> Signed-off-by: Andreas Rheinhardt <andreas.rheinhardt@outlook.com>
> ---
>  doc/APIchanges             | 4 ++++
>  libavcodec/avcodec.h       | 7 ++++---
>  libavcodec/options_table.h | 4 +++-
>  libavcodec/version.h       | 3 +++
>  4 files changed, 14 insertions(+), 4 deletions(-)
> 
> diff --git a/doc/APIchanges b/doc/APIchanges
> index cffab2059f..5c52490392 100644
> --- a/doc/APIchanges
> +++ b/doc/APIchanges
> @@ -14,6 +14,10 @@ libavutil:     2021-04-27
> 
>  API changes, most recent first:
> 
> +2021-09-xx - xxxxxxxxxx - lavc 59.x.100 - avcodec.h
> +  Deprecate AVCodecContext.sub_text_format and the corresponding
> +  AVOptions. It is unused since the last major bump.
> +
>  2021-09-xx - xxxxxxxxxx - lavc 59.x.100 - avcodec.h codec.h
>    Deprecate AV_CODEC_FLAG_TRUNCATED and AV_CODEC_CAP_TRUNCATED,
>    as they are redundant with parsers.
> diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
> index 1b70a08980..7ee8bc2b7c 100644
> --- a/libavcodec/avcodec.h
> +++ b/libavcodec/avcodec.h
> @@ -1857,13 +1857,14 @@ typedef struct AVCodecContext {
>       */
>      AVBufferRef *hw_frames_ctx;
> 
> +#if FF_API_SUB_TEXT_FORMAT
>      /**
> -     * Control the form of AVSubtitle.rects[N]->ass
> -     * - decoding: set by user
> -     * - encoding: unused
> +     * @deprecated unused
>       */
> +    attribute_deprecated
>      int sub_text_format;
>  #define FF_SUB_TEXT_FMT_ASS              0
> +#endif
> 
>      /**
>       * Audio only. The amount of padding (in samples) appended by
> the encoder to
> diff --git a/libavcodec/options_table.h b/libavcodec/options_table.h
> index e740112d6a..130341a2ec 100644
> --- a/libavcodec/options_table.h
> +++ b/libavcodec/options_table.h
> @@ -368,8 +368,10 @@ static const AVOption avcodec_options[] = {
>  {"auto",        NULL, 0, AV_OPT_TYPE_CONST, {.i64 =
> FF_SUB_CHARENC_MODE_AUTOMATIC},   INT_MIN, INT_MAX, S|D,
> "sub_charenc_mode"},
>  {"pre_decoder", NULL, 0, AV_OPT_TYPE_CONST, {.i64 =
> FF_SUB_CHARENC_MODE_PRE_DECODER}, INT_MIN, INT_MAX, S|D,
> "sub_charenc_mode"},
>  {"ignore",      NULL, 0, AV_OPT_TYPE_CONST, {.i64 =
> FF_SUB_CHARENC_MODE_IGNORE},      INT_MIN, INT_MAX, S|D,
> "sub_charenc_mode"},
> -{"sub_text_format", "set decoded text subtitle format",
> OFFSET(sub_text_format), AV_OPT_TYPE_INT, {.i64 =
> FF_SUB_TEXT_FMT_ASS}, 0, 1, S|D, "sub_text_format"},
> +#if FF_API_SUB_TEXT_FORMAT
> +{"sub_text_format", "Deprecated, does nothing",
> OFFSET(sub_text_format), AV_OPT_TYPE_INT, {.i64 =
> FF_SUB_TEXT_FMT_ASS}, 0, 1, S|D | AV_OPT_FLAG_DEPRECATED,
> "sub_text_format"},
>  {"ass",              NULL, 0, AV_OPT_TYPE_CONST, {.i64 =
> FF_SUB_TEXT_FMT_ASS},              INT_MIN, INT_MAX, S|D,
> "sub_text_format"},
> +#endif
>  {"apply_cropping", NULL, OFFSET(apply_cropping), AV_OPT_TYPE_BOOL, {
> .i64 = 1 }, 0, 1, V | D },
>  {"skip_alpha", "Skip processing alpha", OFFSET(skip_alpha),
> AV_OPT_TYPE_BOOL, {.i64 = 0 }, 0, 1, V|D },
>  {"field_order", "Field order", OFFSET(field_order), AV_OPT_TYPE_INT,
> {.i64 = AV_FIELD_UNKNOWN }, 0, 5, V|D|E, "field_order" },
> diff --git a/libavcodec/version.h b/libavcodec/version.h
> index bb70d4d152..8da80a3670 100644
> --- a/libavcodec/version.h
> +++ b/libavcodec/version.h
> @@ -84,5 +84,8 @@
>  #ifndef FF_API_FLAG_TRUNCATED
>  #define FF_API_FLAG_TRUNCATED      (LIBAVCODEC_VERSION_MAJOR < 60)
>  #endif
> +#ifndef FF_API_SUB_TEXT_FORMAT
> +#define FF_API_SUB_TEXT_FORMAT     (LIBAVCODEC_VERSION_MAJOR < 60)
> +#endif
> 
>  #endif /* AVCODEC_VERSION_H */
> --
> 2.30.2

LGTM.
diff mbox series

Patch

diff --git a/doc/APIchanges b/doc/APIchanges
index cffab2059f..5c52490392 100644
--- a/doc/APIchanges
+++ b/doc/APIchanges
@@ -14,6 +14,10 @@  libavutil:     2021-04-27
 
 API changes, most recent first:
 
+2021-09-xx - xxxxxxxxxx - lavc 59.x.100 - avcodec.h
+  Deprecate AVCodecContext.sub_text_format and the corresponding
+  AVOptions. It is unused since the last major bump.
+
 2021-09-xx - xxxxxxxxxx - lavc 59.x.100 - avcodec.h codec.h
   Deprecate AV_CODEC_FLAG_TRUNCATED and AV_CODEC_CAP_TRUNCATED,
   as they are redundant with parsers.
diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index 1b70a08980..7ee8bc2b7c 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -1857,13 +1857,14 @@  typedef struct AVCodecContext {
      */
     AVBufferRef *hw_frames_ctx;
 
+#if FF_API_SUB_TEXT_FORMAT
     /**
-     * Control the form of AVSubtitle.rects[N]->ass
-     * - decoding: set by user
-     * - encoding: unused
+     * @deprecated unused
      */
+    attribute_deprecated
     int sub_text_format;
 #define FF_SUB_TEXT_FMT_ASS              0
+#endif
 
     /**
      * Audio only. The amount of padding (in samples) appended by the encoder to
diff --git a/libavcodec/options_table.h b/libavcodec/options_table.h
index e740112d6a..130341a2ec 100644
--- a/libavcodec/options_table.h
+++ b/libavcodec/options_table.h
@@ -368,8 +368,10 @@  static const AVOption avcodec_options[] = {
 {"auto",        NULL, 0, AV_OPT_TYPE_CONST, {.i64 = FF_SUB_CHARENC_MODE_AUTOMATIC},   INT_MIN, INT_MAX, S|D, "sub_charenc_mode"},
 {"pre_decoder", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = FF_SUB_CHARENC_MODE_PRE_DECODER}, INT_MIN, INT_MAX, S|D, "sub_charenc_mode"},
 {"ignore",      NULL, 0, AV_OPT_TYPE_CONST, {.i64 = FF_SUB_CHARENC_MODE_IGNORE},      INT_MIN, INT_MAX, S|D, "sub_charenc_mode"},
-{"sub_text_format", "set decoded text subtitle format", OFFSET(sub_text_format), AV_OPT_TYPE_INT, {.i64 = FF_SUB_TEXT_FMT_ASS}, 0, 1, S|D, "sub_text_format"},
+#if FF_API_SUB_TEXT_FORMAT
+{"sub_text_format", "Deprecated, does nothing", OFFSET(sub_text_format), AV_OPT_TYPE_INT, {.i64 = FF_SUB_TEXT_FMT_ASS}, 0, 1, S|D | AV_OPT_FLAG_DEPRECATED, "sub_text_format"},
 {"ass",              NULL, 0, AV_OPT_TYPE_CONST, {.i64 = FF_SUB_TEXT_FMT_ASS},              INT_MIN, INT_MAX, S|D, "sub_text_format"},
+#endif
 {"apply_cropping", NULL, OFFSET(apply_cropping), AV_OPT_TYPE_BOOL, { .i64 = 1 }, 0, 1, V | D },
 {"skip_alpha", "Skip processing alpha", OFFSET(skip_alpha), AV_OPT_TYPE_BOOL, {.i64 = 0 }, 0, 1, V|D },
 {"field_order", "Field order", OFFSET(field_order), AV_OPT_TYPE_INT, {.i64 = AV_FIELD_UNKNOWN }, 0, 5, V|D|E, "field_order" },
diff --git a/libavcodec/version.h b/libavcodec/version.h
index bb70d4d152..8da80a3670 100644
--- a/libavcodec/version.h
+++ b/libavcodec/version.h
@@ -84,5 +84,8 @@ 
 #ifndef FF_API_FLAG_TRUNCATED
 #define FF_API_FLAG_TRUNCATED      (LIBAVCODEC_VERSION_MAJOR < 60)
 #endif
+#ifndef FF_API_SUB_TEXT_FORMAT
+#define FF_API_SUB_TEXT_FORMAT     (LIBAVCODEC_VERSION_MAJOR < 60)
+#endif
 
 #endif /* AVCODEC_VERSION_H */