diff options
Diffstat (limited to 'include/gst/codecparsers/gsth265parser.h')
| -rw-r--r-- | include/gst/codecparsers/gsth265parser.h | 1815 |
1 files changed, 1815 insertions, 0 deletions
diff --git a/include/gst/codecparsers/gsth265parser.h b/include/gst/codecparsers/gsth265parser.h new file mode 100644 index 0000000000..0d80c19b36 --- /dev/null +++ b/include/gst/codecparsers/gsth265parser.h @@ -0,0 +1,1815 @@ +/* Gstreamer H.265 bitstream parser + * Copyright (C) 2013 Intel Corporation + * Copyright (C) 2013 Sreerenj Balachandran <sreerenj.balachandran@intel.com> + * + * Contact: Sreerenj Balachandran <sreerenj.balachandran@intel.com> + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the + * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, + * Boston, MA 02110-1301, USA. + */ + +#ifndef __GST_H265_PARSER_H__ +#define __GST_H265_PARSER_H__ + +#ifndef GST_USE_UNSTABLE_API +#warning "The H.265 parsing library is unstable API and may change in future." +#warning "You can define GST_USE_UNSTABLE_API to avoid this warning." +#endif + +#include <gst/gst.h> +#include <gst/codecparsers/codecparsers-prelude.h> + +G_BEGIN_DECLS + +#define GST_H265_MAX_SUB_LAYERS 8 +#define GST_H265_MAX_VPS_COUNT 16 +#define GST_H265_MAX_SPS_COUNT 16 +#define GST_H265_MAX_PPS_COUNT 64 + +#define GST_H265_IS_B_SLICE(slice) ((slice)->type == GST_H265_B_SLICE) +#define GST_H265_IS_P_SLICE(slice) ((slice)->type == GST_H265_P_SLICE) +#define GST_H265_IS_I_SLICE(slice) ((slice)->type == GST_H265_I_SLICE) + +/** + * GST_H265_IS_NAL_TYPE_IDR: + * @nal_type: a #GstH265NalUnitType + * + * Check whether @nal_type is IDR or not + * + * Since: 1.18 + */ +#define GST_H265_IS_NAL_TYPE_IDR(nal_type) \ + ((nal_type) == GST_H265_NAL_SLICE_IDR_W_RADL || (nal_type) == GST_H265_NAL_SLICE_IDR_N_LP) + +/** + * GST_H265_IS_NAL_TYPE_IRAP: + * @nal_type: a #GstH265NalUnitType + * + * Check whether @nal_type is IRAP or not + * + * Since: 1.18 + */ +#define GST_H265_IS_NAL_TYPE_IRAP(nal_type) \ + ((nal_type) >= GST_H265_NAL_SLICE_BLA_W_LP && (nal_type) <= RESERVED_IRAP_NAL_TYPE_MAX) + +/** + * GST_H265_IS_NAL_TYPE_BLA: + * @nal_type: a #GstH265NalUnitType + * + * Check whether @nal_type is BLA or not + * + * Since: 1.18 + */ +#define GST_H265_IS_NAL_TYPE_BLA(nal_type) \ + ((nal_type) >= GST_H265_NAL_SLICE_BLA_W_LP && (nal_type) <= GST_H265_NAL_SLICE_BLA_N_LP) + +/** + * GST_H265_IS_NAL_TYPE_CRA: + * @nal_type: a #GstH265NalUnitType + * + * Check whether @nal_type is CRA or not + * + * Since: 1.18 + */ +#define GST_H265_IS_NAL_TYPE_CRA(nal_type) \ + ((nal_type) == GST_H265_NAL_SLICE_CRA_NUT) + +/** + * GST_H265_IS_NAL_TYPE_RADL: + * @nal_type: a #GstH265NalUnitType + * + * Check whether @nal_type is RADL or not + * + * Since: 1.18 + */ +#define GST_H265_IS_NAL_TYPE_RADL(nal_type) \ + ((nal_type) == GST_H265_NAL_SLICE_RADL_N || (nal_type) == GST_H265_NAL_SLICE_RADL_R) + +/** + * GST_H265_IS_NAL_TYPE_RASL: + * @nal_type: a #GstH265NalUnitType + * + * Check whether @nal_type is RASL or not + * + * Since: 1.18 + */ +#define GST_H265_IS_NAL_TYPE_RASL(nal_type) \ + ((nal_type) == GST_H265_NAL_SLICE_RASL_N || (nal_type) == GST_H265_NAL_SLICE_RASL_R) + +/** + * GstH265Profile: + * @GST_H265_PROFILE_MAIN: Main profile (A.3.2) + * @GST_H265_PROFILE_MAIN_10: Main 10 profile (A.3.3) + * @GST_H265_PROFILE_MAIN_STILL_PICTURE: Main Still Picture profile (A.3.4) + * @GST_H265_PROFILE_MONOCHROME: Monochrome profile (A.3.4) + * @GST_H265_PROFILE_MONOCHROME_12: Monochrome 12-bits profile (A.3.4) + * @GST_H265_PROFILE_MONOCHROME_16: Monochrome 16-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_12: Main profile 12-bits (A.3.4) + * @GST_H265_PROFILE_MAIN_422_10: Main 4:2:2 profile 10-bits (A.3.4) + * @GST_H265_PROFILE_MAIN_422_12: Main 4:2:2 profile 12-bits (A.3.4) + * @GST_H265_PROFILE_MAIN_444: Main 4:4:4 profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_10: Main 4:4:4 10-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_12: Main 4:4:4 12-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_INTRA: Main Intra profile (A.3.4) + * @GST_H265_PROFILE_MAIN_10_INTRA: Main Intra 10-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_12_INTRA: Main Intra 12-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_422_10_INTRA: Main Intra 4:2:2 10-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_422_12_INTRA: Main Intra 4:2:2 12-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_INTRA: Main Intra 4:4:4 profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_10_INTRA: Main Intra 4:4:4 10-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_12_INTRA: Main Intra 4:4:4 12-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_16_INTRA: Main Intra 4:4:4 16-bits profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_STILL_PICTURE: Main 4:4:4 Still Picture profile (A.3.4) + * @GST_H265_PROFILE_MAIN_444_16_STILL_PICTURE: Main 4:4:4 16-bits Still Picture profile (A.3.4) + * @GST_H265_PROFILE_MONOCHROME_10: Monochrome 10-bits profile (A.3.5) (Since: 1.18) + * @GST_H265_PROFILE_HIGH_THROUGHPUT_444: High Throughput 4:4:4 profile (A.3.6) (Since: 1.18) + * @GST_H265_PROFILE_HIGH_THROUGHPUT_444_10: High Throughput 4:4:4 10-bits profile (A.3.6) (Since: 1.18) + * @GST_H265_PROFILE_HIGH_THROUGHPUT_444_14: High Throughput 4:4:4 14-bits profile (A.3.6) (Since: 1.18) + * @GST_H265_PROFILE_HIGH_THROUGHPUT_444_16_INTRA: High Throughput 4:4:4 16-bits Intra profile (A.3.6) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_MAIN: Screen-Extended Main profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_MAIN_10: Screen-Extended Main 10-bits profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_MAIN_444: Screen-Extended Main 4:4:4 profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_MAIN_444_10: Screen-Extended Main 4:4:4 10-bits profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_HIGH_THROUGHPUT_444: Screen-Extended High Throughput 4:4:4 profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_HIGH_THROUGHPUT_444_10: Screen-Extended High Throughput 4:4:4 10-bits profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_SCREEN_EXTENDED_HIGH_THROUGHPUT_444_14: Screen-Extended High Throughput 4:4:4 14-bits profile (A.3.7) (Since: 1.18) + * @GST_H265_PROFILE_MULTIVIEW_MAIN: Multiview Main profile (G.11.1) (Since: 1.18) + * @GST_H265_PROFILE_SCALABLE_MAIN: Scalable Main profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_SCALABLE_MAIN_10: Scalable Main 10-bits profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_SCALABLE_MONOCHROME: Scalable Monochrome profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_SCALABLE_MONOCHROME_12: Scalable Monochrome 12-bits profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_SCALABLE_MONOCHROME_16: Scalable Monochrome 16-bits profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_SCALABLE_MAIN_444: Scalable Main 4:4:4 profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_3D_MAIN: 3D Main 4:4:4 profile (I.11.1) (Since: 1.18) + * + * H.265 Profiles. + * + */ +typedef enum { + GST_H265_PROFILE_INVALID = -1, + GST_H265_PROFILE_MAIN = 1, + GST_H265_PROFILE_MAIN_10 = 2, + GST_H265_PROFILE_MAIN_STILL_PICTURE = 3, + GST_H265_PROFILE_MONOCHROME, + GST_H265_PROFILE_MONOCHROME_12, + GST_H265_PROFILE_MONOCHROME_16, + GST_H265_PROFILE_MAIN_12, + GST_H265_PROFILE_MAIN_422_10, + GST_H265_PROFILE_MAIN_422_12, + GST_H265_PROFILE_MAIN_444, + GST_H265_PROFILE_MAIN_444_10, + GST_H265_PROFILE_MAIN_444_12, + GST_H265_PROFILE_MAIN_INTRA, + GST_H265_PROFILE_MAIN_10_INTRA, + GST_H265_PROFILE_MAIN_12_INTRA, + GST_H265_PROFILE_MAIN_422_10_INTRA, + GST_H265_PROFILE_MAIN_422_12_INTRA, + GST_H265_PROFILE_MAIN_444_INTRA, + GST_H265_PROFILE_MAIN_444_10_INTRA, + GST_H265_PROFILE_MAIN_444_12_INTRA, + GST_H265_PROFILE_MAIN_444_16_INTRA, + GST_H265_PROFILE_MAIN_444_STILL_PICTURE, + GST_H265_PROFILE_MAIN_444_16_STILL_PICTURE, + GST_H265_PROFILE_MONOCHROME_10, + GST_H265_PROFILE_HIGH_THROUGHPUT_444, + GST_H265_PROFILE_HIGH_THROUGHPUT_444_10, + GST_H265_PROFILE_HIGH_THROUGHPUT_444_14, + GST_H265_PROFILE_HIGH_THROUGHPUT_444_16_INTRA, + GST_H265_PROFILE_SCREEN_EXTENDED_MAIN, + GST_H265_PROFILE_SCREEN_EXTENDED_MAIN_10, + GST_H265_PROFILE_SCREEN_EXTENDED_MAIN_444, + GST_H265_PROFILE_SCREEN_EXTENDED_MAIN_444_10, + GST_H265_PROFILE_SCREEN_EXTENDED_HIGH_THROUGHPUT_444, + GST_H265_PROFILE_SCREEN_EXTENDED_HIGH_THROUGHPUT_444_10, + GST_H265_PROFILE_SCREEN_EXTENDED_HIGH_THROUGHPUT_444_14, + GST_H265_PROFILE_MULTIVIEW_MAIN, + GST_H265_PROFILE_SCALABLE_MAIN, + GST_H265_PROFILE_SCALABLE_MAIN_10, + GST_H265_PROFILE_SCALABLE_MONOCHROME, + GST_H265_PROFILE_SCALABLE_MONOCHROME_12, + GST_H265_PROFILE_SCALABLE_MONOCHROME_16, + GST_H265_PROFILE_SCALABLE_MAIN_444, + GST_H265_PROFILE_3D_MAIN, + + /* end of the profiles */ + GST_H265_PROFILE_MAX +} GstH265Profile; + +/** + * GstH265ProfileIDC: + * @GST_H265_PROFILE_IDC_MAIN: Main profile (A.3.2) + * @GST_H265_PROFILE_IDC_MAIN_10: Main 10 profile (A.3.3) + * @GST_H265_PROFILE_IDC_MAIN_STILL_PICTURE: Main Still Picture profile (A.3.4) + * @GST_H265_PROFILE_IDC_FORMAT_RANGE_EXTENSION: Format range extensions profile (A.3.5) + * @GST_H265_PROFILE_IDC_HIGH_THROUGHPUT: High throughput profiles (A.3.6) + * @GST_H265_PROFILE_IDC_MULTIVIEW_MAIN: Multiview Main profiles (G.11.1) (Since: 1.18) + * @GST_H265_PROFILE_IDC_SCALABLE_MAIN: Scalable Main and Scalable Main 10 profile (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_IDC_SCREEN_CONTENT_CODING: Screen content coding extensions profiles (A.3.7) + * @GST_H265_PROFILE_IDC_3D_MAIN: 3D Main profile (I.11.1) (Since: 1.18) + * @GST_H265_PROFILE_IDC_SCALABLE_FORMAT_RANGE_EXTENSION: Scalable Format range extensions profiles (H.11.1) (Since: 1.18) + * @GST_H265_PROFILE_IDC_HIGH_THROUGHPUT_SCREEN_CONTENT_CODING_EXTENSION: High throughput screen content coding extensions profiles (A.3.8) (Since: 1.18) + * + * Valid values for the profile_idc field. This is different from + * #GstH265Profile as an extension idc can be used to encode a whole variety of + * profiles. + * + */ +typedef enum { + GST_H265_PROFILE_IDC_MAIN = 1, + GST_H265_PROFILE_IDC_MAIN_10 = 2, + GST_H265_PROFILE_IDC_MAIN_STILL_PICTURE = 3, + GST_H265_PROFILE_IDC_FORMAT_RANGE_EXTENSION = 4, + GST_H265_PROFILE_IDC_HIGH_THROUGHPUT = 5, + GST_H265_PROFILE_IDC_MULTIVIEW_MAIN = 6, + GST_H265_PROFILE_IDC_SCALABLE_MAIN = 7, + GST_H265_PROFILE_IDC_3D_MAIN = 8, + GST_H265_PROFILE_IDC_SCREEN_CONTENT_CODING = 9, + GST_H265_PROFILE_IDC_SCALABLE_FORMAT_RANGE_EXTENSION = 10, + GST_H265_PROFILE_IDC_HIGH_THROUGHPUT_SCREEN_CONTENT_CODING_EXTENSION = 11, +} GstH265ProfileIDC; + +/** + * GstH265NalUnitType: + * @GST_H265_NAL_SLICE_TRAIL_N: Slice nal of a non-TSA, non-STSA trailing picture + * @GST_H265_NAL_SLICE_TRAIL_R: Slice nal of a non-TSA, non-STSA trailing picture + * @GST_H265_NAL_SLICE_TSA_N: Slice nal of a TSA picture + * @GST_H265_NAL_SLICE_TSA_R: Slice nal of a TSA picture + * @GST_H265_NAL_SLICE_STSA_N: Slice nal of a STSA picture + * @GST_H265_NAL_SLICE_STSA_R: Slice nal of a STSA picture + * @GST_H265_NAL_SLICE_RADL_N: Slice nal of a RADL picture + * @GST_H265_NAL_SLICE_RADL_R: Slice nal of a RADL piicture + * @GST_H265_NAL_SLICE_RASL_N: Slice nal of a RASL picture + * @GST_H265_NAL_SLICE_RASL_R: Slice nal of a RASL picture + * @GST_H265_NAL_SLICE_BLA_W_LP: Slice nal of a BLA picture + * @GST_H265_NAL_SLICE_BLA_W_RADL: Slice nal of a BLA picture + * @GST_H265_NAL_SLICE_BLA_N_LP: Slice nal of a BLA picture + * @GST_H265_NAL_SLICE_IDR_W_RADL: Slice nal of an IDR picture + * @GST_H265_NAL_SLICE_IDR_N_LP: Slice nal of an IDR picture + * @GST_H265_NAL_SLICE_CRA_NUT: Slice nal of a CRA picture + * @GST_H265_NAL_VPS: Video parameter set(VPS) nal unit + * @GST_H265_NAL_SPS: Sequence parameter set (SPS) nal unit + * @GST_H265_NAL_PPS: Picture parameter set (PPS) nal unit + * @GST_H265_NAL_AUD: Access unit (AU) delimiter nal unit + * @GST_H265_NAL_EOS: End of sequence (EOS) nal unit + * @GST_H265_NAL_EOB: End of bitstream (EOB) nal unit + * @GST_H265_NAL_FD: Filler data (FD) nal lunit + * @GST_H265_NAL_PREFIX_SEI: Supplemental enhancement information prefix nal unit + * @GST_H265_NAL_SUFFIX_SEI: Suppliemental enhancement information suffix nal unit + * + * Indicates the type of H265 Nal Units + */ +typedef enum +{ + GST_H265_NAL_SLICE_TRAIL_N = 0, + GST_H265_NAL_SLICE_TRAIL_R = 1, + GST_H265_NAL_SLICE_TSA_N = 2, + GST_H265_NAL_SLICE_TSA_R = 3, + GST_H265_NAL_SLICE_STSA_N = 4, + GST_H265_NAL_SLICE_STSA_R = 5, + GST_H265_NAL_SLICE_RADL_N = 6, + GST_H265_NAL_SLICE_RADL_R = 7, + GST_H265_NAL_SLICE_RASL_N = 8, + GST_H265_NAL_SLICE_RASL_R = 9, + GST_H265_NAL_SLICE_BLA_W_LP = 16, + GST_H265_NAL_SLICE_BLA_W_RADL = 17, + GST_H265_NAL_SLICE_BLA_N_LP = 18, + GST_H265_NAL_SLICE_IDR_W_RADL = 19, + GST_H265_NAL_SLICE_IDR_N_LP = 20, + GST_H265_NAL_SLICE_CRA_NUT = 21, + GST_H265_NAL_VPS = 32, + GST_H265_NAL_SPS = 33, + GST_H265_NAL_PPS = 34, + GST_H265_NAL_AUD = 35, + GST_H265_NAL_EOS = 36, + GST_H265_NAL_EOB = 37, + GST_H265_NAL_FD = 38, + GST_H265_NAL_PREFIX_SEI = 39, + GST_H265_NAL_SUFFIX_SEI = 40 +} GstH265NalUnitType; + +#define RESERVED_NON_IRAP_SUBLAYER_NAL_TYPE_MIN 10 +#define RESERVED_NON_IRAP_SUBLAYER_NAL_TYPE_MAX 15 + +#define RESERVED_IRAP_NAL_TYPE_MIN 22 +#define RESERVED_IRAP_NAL_TYPE_MAX 23 + +#define RESERVED_NON_IRAP_NAL_TYPE_MIN 24 +#define RESERVED_NON_IRAP_NAL_TYPE_MAX 31 + +#define RESERVED_NON_VCL_NAL_TYPE_MIN 41 +#define RESERVED_NON_VCL_NAL_TYPE_MAX 47 + +#define UNSPECIFIED_NON_VCL_NAL_TYPE_MIN 48 +#define UNSPECIFIED_NON_VCL_NAL_TYPE_MAX 63 + +/** + * GstH265ParserResult: + * @GST_H265_PARSER_OK: The parsing succeeded + * @GST_H265_PARSER_BROKEN_DATA: The data to parse is broken + * @GST_H265_PARSER_BROKEN_LINK: The link to structure needed for the parsing couldn't be found + * @GST_H265_PARSER_ERROR: An error accured when parsing + * @GST_H265_PARSER_NO_NAL: No nal found during the parsing + * @GST_H265_PARSER_NO_NAL_END: Start of the nal found, but not the end. + * + * The result of parsing H265 data. + */ +typedef enum +{ + GST_H265_PARSER_OK, + GST_H265_PARSER_BROKEN_DATA, + GST_H265_PARSER_BROKEN_LINK, + GST_H265_PARSER_ERROR, + GST_H265_PARSER_NO_NAL, + GST_H265_PARSER_NO_NAL_END +} GstH265ParserResult; + +/** + * GstH265SEIPayloadType: + * @GST_H265_SEI_BUF_PERIOD: Buffering Period SEI Message + * @GST_H265_SEI_PIC_TIMING: Picture Timing SEI Message + * @GST_H265_SEI_REGISTERED_USER_DATA: Registered user data (D.2.5) + * @GST_H265_SEI_RECOVERY_POINT: Recovery Point SEI Message (D.3.8) + * @GST_H265_SEI_TIME_CODE: Time code SEI message (D.2.27) (Since: 1.16) + * @GST_H265_SEI_MASTERING_DISPLAY_COLOUR_VOLUME: Mastering display colour volume information SEI message (D.2.28) (Since: 1.18) + * @GST_H265_SEI_CONTENT_LIGHT_LEVEL: Content light level information SEI message (D.2.35) (Since: 1.18) + * ... + * + * The type of SEI message. + */ +typedef enum +{ + GST_H265_SEI_BUF_PERIOD = 0, + GST_H265_SEI_PIC_TIMING = 1, + GST_H265_SEI_REGISTERED_USER_DATA = 4, + GST_H265_SEI_RECOVERY_POINT = 6, + GST_H265_SEI_TIME_CODE = 136, + GST_H265_SEI_MASTERING_DISPLAY_COLOUR_VOLUME = 137, + GST_H265_SEI_CONTENT_LIGHT_LEVEL = 144, + /* and more... */ +} GstH265SEIPayloadType; + +/** + * GstH265SEIPicStructType: + * @GST_H265_SEI_PIC_STRUCT_FRAME: Picture is a frame + * @GST_H265_SEI_PIC_STRUCT_TOP_FIELD: Top field of frame + * @GST_H265_SEI_PIC_STRUCT_BOTTOM_FIELD: Botom field of frame + * @GST_H265_SEI_PIC_STRUCT_TOP_BOTTOM: Top bottom field of frame + * @GST_H265_SEI_PIC_STRUCT_BOTTOM_TOP: bottom top field of frame + * @GST_H265_SEI_PIC_STRUCT_TOP_BOTTOM_TOP: top bottom top field of frame + * @GST_H265_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM: bottom top bottom field of frame + * @GST_H265_SEI_PIC_STRUCT_FRAME_DOUBLING: indicates that the frame should + * be displayed two times consecutively + * @GST_H265_SEI_PIC_STRUCT_FRAME_TRIPLING: indicates that the frame should be + * displayed three times consecutively + * @GST_H265_SEI_PIC_STRUCT_TOP_PAIRED_PREVIOUS_BOTTOM: top field paired with + * previous bottom field in output order + * @GST_H265_SEI_PIC_STRUCT_BOTTOM_PAIRED_PREVIOUS_TOP: bottom field paried with + * previous top field in output order + * @GST_H265_SEI_PIC_STRUCT_TOP_PAIRED_NEXT_BOTTOM: top field paired with next + * bottom field in output order + * @GST_H265_SEI_PIC_STRUCT_BOTTOM_PAIRED_NEXT_TOP: bottom field paired with + * next top field in output order + * + * SEI pic_struct type + */ +typedef enum +{ + GST_H265_SEI_PIC_STRUCT_FRAME = 0, + GST_H265_SEI_PIC_STRUCT_TOP_FIELD = 1, + GST_H265_SEI_PIC_STRUCT_BOTTOM_FIELD = 2, + GST_H265_SEI_PIC_STRUCT_TOP_BOTTOM = 3, + GST_H265_SEI_PIC_STRUCT_BOTTOM_TOP = 4, + GST_H265_SEI_PIC_STRUCT_TOP_BOTTOM_TOP = 5, + GST_H265_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM = 6, + GST_H265_SEI_PIC_STRUCT_FRAME_DOUBLING = 7, + GST_H265_SEI_PIC_STRUCT_FRAME_TRIPLING = 8, + GST_H265_SEI_PIC_STRUCT_TOP_PAIRED_PREVIOUS_BOTTOM = 9, + GST_H265_SEI_PIC_STRUCT_BOTTOM_PAIRED_PREVIOUS_TOP = 10, + GST_H265_SEI_PIC_STRUCT_TOP_PAIRED_NEXT_BOTTOM = 11, + GST_H265_SEI_PIC_STRUCT_BOTTOM_PAIRED_NEXT_TOP = 12 +} GstH265SEIPicStructType; + +/** + * GstH265SliceType: + * + * Type of Picture slice + */ + +typedef enum +{ + GST_H265_B_SLICE = 0, + GST_H265_P_SLICE = 1, + GST_H265_I_SLICE = 2 +} GstH265SliceType; + +typedef enum +{ + GST_H265_QUANT_MATIX_4X4 = 0, + GST_H265_QUANT_MATIX_8X8 = 1, + GST_H265_QUANT_MATIX_16X16 = 2, + GST_H265_QUANT_MATIX_32X32 = 3 +} GstH265QuantMatrixSize; + +typedef struct _GstH265Parser GstH265Parser; + +typedef struct _GstH265NalUnit GstH265NalUnit; + +typedef struct _GstH265VPS GstH265VPS; +typedef struct _GstH265SPS GstH265SPS; +typedef struct _GstH265PPS GstH265PPS; +typedef struct _GstH265ProfileTierLevel GstH265ProfileTierLevel; +typedef struct _GstH265SubLayerHRDParams GstH265SubLayerHRDParams; +typedef struct _GstH265HRDParams GstH265HRDParams; +typedef struct _GstH265VUIParams GstH265VUIParams; +typedef struct _GstH265SPSExtensionParams GstH265SPSExtensionParams; +typedef struct _GstH265SPSSccExtensionParams GstH265SPSSccExtensionParams; +typedef struct _GstH265PPSExtensionParams GstH265PPSExtensionParams; +typedef struct _GstH265PPSSccExtensionParams GstH265PPSSccExtensionParams; + +typedef struct _GstH265ScalingList GstH265ScalingList; +typedef struct _GstH265RefPicListModification GstH265RefPicListModification; +typedef struct _GstH265PredWeightTable GstH265PredWeightTable; +typedef struct _GstH265ShortTermRefPicSet GstH265ShortTermRefPicSet; +typedef struct _GstH265SliceHdr GstH265SliceHdr; + +typedef struct _GstH265PicTiming GstH265PicTiming; +typedef struct _GstH265RegisteredUserData GstH265RegisteredUserData; +typedef struct _GstH265BufferingPeriod GstH265BufferingPeriod; +typedef struct _GstH265RecoveryPoint GstH265RecoveryPoint; +typedef struct _GstH265TimeCode GstH265TimeCode; +typedef struct _GstH265MasteringDisplayColourVolume GstH265MasteringDisplayColourVolume; +typedef struct _GstH265ContentLightLevel GstH265ContentLightLevel; +typedef struct _GstH265SEIMessage GstH265SEIMessage; + +/** + * GstH265NalUnit: + * @type: A #GstH265NalUnitType + * @layer_id: A nal unit layer id + * @temporal_id_plus1: A nal unit temporal identifier + * @size: The size of the nal unit starting from @offset + * @offset: The offset of the actual start of the nal unit + * @sc_offset:The offset of the start code of the nal unit + * @valid: If the nal unit is valid, which mean it has + * already been parsed + * @data: The data from which the Nalu has been parsed + * + * Structure defining the Nal unit headers + */ +struct _GstH265NalUnit +{ + guint8 type; + guint8 layer_id; + guint8 temporal_id_plus1; + + /* calculated values */ + guint size; + guint offset; + guint sc_offset; + gboolean valid; + + guint8 *data; + guint8 header_bytes; +}; + +/** + * GstH265ProfileTierLevel: + * @profile_space: specifies the context for the interpretation of + * general_profile_idc and general_profile_combatibility_flag + * @tier_flag: the tier context for the interpretation of general_level_idc + * @profile_idc: profile id + * @profile_compatibility_flag: compatibility flags + * @progressive_source_flag: flag to indicate the type of stream + * @interlaced_source_flag: flag to indicate the type of stream + * @non_packed_constraint_flag: indicate the presence of frame packing + * arrangement sei message + * @frame_only_constraint_flag: recognize the field_seq_flag + * @max_12bit_constraint_flag: used to define profile extensions, see Annex A + * @max_10bit_constraint_flag: used to define profile extensions, see Annex A + * @max_8bit_constraint_flag: used to define profile extensions, see Annex A + * @max_422chroma_constraint_flag: used to define profile extensions, see Annex A + * @max_420chroma_constraint_flag: used to define profile extensions, see Annex A + * @max_monochrome_constraint_flag: used to define profile extensions, see Annex A + * @intra_constraint_flag: used to define profile extensions, see Annex A + * @one_picture_only_constraint_flag: used to define profile extensions, see Annex A + * @lower_bit_rate_constraint_flag: used to define profile extensions, see Annex A + * @max_14bit_constraint_flag: used to define profile extensions, see Annex A + * @level idc: indicate the level which the CVS confirms + * @sub_layer_profile_present_flag: sublayer profile presence ind + * @sub_layer_level_present_flag:sublayer level presence indicator. + * @sub_layer_profile_space: profile space for sublayers + * @sub_layer_tier_flag: tier flags for sublayers. + * @sub_layer_profile_idc: conformant profile indicator for sublayers. + * @sub_layer_profile_compatibility_flag[6][32]: compatibility flags for sublayers + * @sub_layer_progressive_source_flag:progressive stream indicator for sublayer + * @sub_layer_interlaced_source_flag: interlaced stream indicator for sublayer + * @sub_layer_non_packed_constraint_flag: indicate the presence of + * frame packing arrangement sei message with in sublayers + * @sub_layer_frame_only_constraint_flag:recognize the sublayer + * specific field_seq_flag + * @sub_layer_level_idc:indicate the sublayer specific level + * + * Define ProfileTierLevel parameters + */ +struct _GstH265ProfileTierLevel { + guint8 profile_space; + guint8 tier_flag; + guint8 profile_idc; + + guint8 profile_compatibility_flag[32]; + + guint8 progressive_source_flag; + guint8 interlaced_source_flag; + guint8 non_packed_constraint_flag; + guint8 frame_only_constraint_flag; + + guint8 max_12bit_constraint_flag; + guint8 max_10bit_constraint_flag; + guint8 max_8bit_constraint_flag; + guint8 max_422chroma_constraint_flag; + guint8 max_420chroma_constraint_flag; + guint8 max_monochrome_constraint_flag; + guint8 intra_constraint_flag; + guint8 one_picture_only_constraint_flag; + guint8 lower_bit_rate_constraint_flag; + guint8 max_14bit_constraint_flag; + + guint8 level_idc; + + guint8 sub_layer_profile_present_flag[6]; + guint8 sub_layer_level_present_flag[6]; + + guint8 sub_layer_profile_space[6]; + guint8 sub_layer_tier_flag[6]; + guint8 sub_layer_profile_idc[6]; + guint8 sub_layer_profile_compatibility_flag[6][32]; + guint8 sub_layer_progressive_source_flag[6]; + guint8 sub_layer_interlaced_source_flag[6]; + guint8 sub_layer_non_packed_constraint_flag[6]; + guint8 sub_layer_frame_only_constraint_flag[6]; + guint8 sub_layer_level_idc[6]; +}; + +/** + * GstH265SubLayerHRDParams: + * @bit_rate_value_minus1:togeter with bit_rate_scale, it specifies + * the maximum input bitrate when the CPB operates at the access + * unit level + * @cpb_size_value_minus1: is used together with cpb_size_scale to + * specify the CPB size when the CPB operates at the access unit + * level + * @cpb_size_du_value_minus1: is used together with cpb_size_du_scale + * to specify the CPB size when the CPB operates at sub-picture + * level + * @bit_rate_du_value_minus1: together with bit_rate_scale, it + * specifies the maximum input bit rate when the CPB operates at the + * sub-picture level + * @cbr_flag: indicate whether HSS operates in intermittent bit rate + * mode or constant bit rate mode. + * + * Defines the Sublayer HRD parameters + */ +struct _GstH265SubLayerHRDParams +{ + guint32 bit_rate_value_minus1[32]; + guint32 cpb_size_value_minus1[32]; + + guint32 cpb_size_du_value_minus1[32]; + guint32 bit_rate_du_value_minus1[32]; + + guint8 cbr_flag[32]; +}; + +/** + * GstH265HRDParams: + * @nal_hrd_parameters_present_flag: indicate the presence of NAL HRD parameters + * @vcl_hrd_parameters_present_flag: indicate the presence of VCL HRD parameters + * @sub_pic_hrd_params_present_flag: indicate the presence of sub_pic_hrd_params + * @tick_divisor_minus2: is used to specify the clock sub-tick + * @du_cpb_removal_delay_increment_length_minus1: specifies the length, + * in bits, of the nal_initial_cpb_removal_delay + * @sub_pic_cpb_params_in_pic_timing_sei_flag: specifies the length, in bits, of + * the cpb_delay_offset and the au_cpb_removal_delay_minus1 syntax elements. + * @dpb_output_delay_du_length_minu1: specifies the length, in bits, of the + * dpb_delay_offset and the pic_dpb_output_delay syntax elements + * @bit_rate_scale: maximum input bitrate + * @cpb_size_scale: CPB size when operates in access unit level + * @cpb_size_du_scale: CPB size when operates in sub-picture level + * @initial_cpb_removal_delay_length_minus1: specifies the length, in bits, of the + * nal_initial_cpb_removal_delay, nal_initial_cpb_removal_offset, + * vcl_initial_cpb_removal_delay and vcl_initial_cpb_removal_offset. + * @au_cpb_removal_delay_length_minus1: specifies the length, in bits, of the + * cpb_delay_offset and the au_cpb_removal_delay_minus1 syntax elements + * @dpb_output_delay_length_minus1: specifies the length, in bits, of the + * dpb_delay_offset and the pic_dpb_output_delay syntax elements + * @fixed_pic_rate_general_flag: flag to indicate the presence of constraint + * on the temporal distance between the HRD output times of consecutive + * pictures in output order + * @fixed_pic_rate_within_cvs_flag: same as fixed_pic_rate_general_flag + * @elemental_duration_in_tc_minus1: temporal distance in clock ticks + * @low_delay_hrd_flag: specifies the HRD operational mode + * @cpb_cnt_minus1:specifies the number of alternative CPS specifications. + * @sublayer_hrd_params: Sublayer HRD parameters. + * + * Defines the HRD parameters + */ +struct _GstH265HRDParams +{ + guint8 nal_hrd_parameters_present_flag; + guint8 vcl_hrd_parameters_present_flag; + guint8 sub_pic_hrd_params_present_flag; + + guint8 tick_divisor_minus2; + guint8 du_cpb_removal_delay_increment_length_minus1; + guint8 sub_pic_cpb_params_in_pic_timing_sei_flag; + guint8 dpb_output_delay_du_length_minus1; + + guint8 bit_rate_scale; + guint8 cpb_size_scale; + guint8 cpb_size_du_scale; + + guint8 initial_cpb_removal_delay_length_minus1; + guint8 au_cpb_removal_delay_length_minus1; + guint8 dpb_output_delay_length_minus1; + + guint8 fixed_pic_rate_general_flag [7]; + guint8 fixed_pic_rate_within_cvs_flag [7]; + guint16 elemental_duration_in_tc_minus1 [7]; + guint8 low_delay_hrd_flag [7]; + guint8 cpb_cnt_minus1[7]; + + GstH265SubLayerHRDParams sublayer_hrd_params[7]; +}; + +/** + * GstH265VPS: + * @id: vps id + * @base_layer_internal_flag and @base_layer_available_flag: + * specify availability of base layer + * @max_layers_minus1: should be zero, but can be other values in future + * @max_sub_layers_minus1:specifies the maximum number of temporal sub-layers + * @temporal_id_nesting_flag: specifies whether inter prediction is + * additionally restricted + * @profile_tier_level: ProfileTierLevel info + * @sub_layer_ordering_info_present_flag: indicates the presence of + * vps_max_dec_pic_buffering_minus1, vps_max_num_reorder_pics and + * vps_max_latency_increase_plus1 + * @max_dec_pic_buffering_minus1: specifies the maximum required size + * of the decoded picture buffer + * @max_num_reorder_pics: indicates the maximum allowed number of + * pictures that can precede any picture in the CVS in decoding + * order + * @max_latency_increase_plus1: is used to compute the value of + * VpsMaxLatencyPictures + * @max_layer_id: specifies the maximum allowed value of nuh_layer_id + * @num_layer_sets_minus1: specifies the number of layer sets + * @layer_id_included_flag: specifies whether a nuh_layer_id included + * in the layer identifier list + * @timing_info_present_flag: indicate the presence of + * num_units_in_tick, time_scale, poc_proportional_to_timing_flag + * and num_hrd_parameters + * @num_units_in_tick: number of time units in a tick + * @time_scale: number of time units that pass in one second + * @poc_proportional_to_timing_flag: indicate whether the picture + * order count is proportional to output timin + * @num_ticks_poc_diff_one_minus1: specifies the number of clock ticks + * corresponding to a difference of picture order count values equal + * to 1 + * @num_hrd_parameters: number of hrd_parameters present + * @hrd_layer_set_idx: index to the list of layer hrd params. + * @hrd_params: the GstH265HRDParams list + * + * Defines the VPS parameters + */ +struct _GstH265VPS { + guint8 id; + + guint8 base_layer_internal_flag; + guint8 base_layer_available_flag; + + guint8 max_layers_minus1; + guint8 max_sub_layers_minus1; + guint8 temporal_id_nesting_flag; + + GstH265ProfileTierLevel profile_tier_level; + + guint8 sub_layer_ordering_info_present_flag; + guint8 max_dec_pic_buffering_minus1[GST_H265_MAX_SUB_LAYERS]; + guint8 max_num_reorder_pics[GST_H265_MAX_SUB_LAYERS]; + guint32 max_latency_increase_plus1[GST_H265_MAX_SUB_LAYERS]; + + guint8 max_layer_id; + guint16 num_layer_sets_minus1; + + guint8 timing_info_present_flag; + guint32 num_units_in_tick; + guint32 time_scale; + guint8 poc_proportional_to_timing_flag; + guint32 num_ticks_poc_diff_one_minus1; + + guint16 num_hrd_parameters; + + /* FIXME: following HRD related info should be an array */ + guint16 hrd_layer_set_idx; + guint8 cprms_present_flag; + GstH265HRDParams hrd_params; + + guint8 vps_extension; + + gboolean valid; +}; +/** + * GstH265ShortTermRefPicSet: + * @inter_ref_pic_set_prediction_flag: %TRUE specifies that the stRpsIdx-th candidate + * short-term RPS is predicted from another candidate short-term RPS + * @delta_idx_minus1: plus 1 specifies the difference between the value of source and + * candidate short term RPS. + * @delta_rps_sign: delta_rps_sign and abs_delta_rps_minus1 together specify + * the value of the variable deltaRps. + * @abs_delta_rps_minus1: delta_rps_sign and abs_delta_rps_minus1 together specify + * the value of the variable deltaRps + * @NumDeltaPocs: sum of @NumNegativePics and @NumPositivePics. + * @NumNegativePics: Derived value depending on inter_ref_pic_set_prediction_flag. + * If inter_ref_pic_set_prediction_flag is equal to 0, this specifies + * the number of entries in the stRpsIdx-th candidate + * short-term RPS that have poc values less than the poc of the current picture. + * @NumPositivePics: Derived value depending on inter_ref_pic_set_prediction_flag. + * If inter_ref_pic_set_prediction_flag is equal to 0, this specifies + * the number of entires in the stRpsIdx-th candidate + * short-term RPS that have poc values greater than the poc value of the current picture. + * @UsedByCurrPicS0: Derived value depending on inter_ref_pic_set_prediction_flag. + * If inter_ref_pic_set_prediction_flag is equal to 0, + * equal to zero specifies that the i-th entry in the stRpsIdx-th + * candidate short-term RPS that has poc value less than of the current picture + * is not used for reference by the current picture + * @UsedByCurrPicS1: Derived value depending on inter_ref_pic_set_prediction_flag. + * If inter_ref_pic_set_prediction_flag is equal to 0, + * equal to zero specifies that the i-th entry in the current + * candidate short-term RPS that has poc value greater than that of the current picture + * is not used for reference by the current picture. + * @DeltaPocS0: Derived value depending on inter_ref_pic_set_prediction_flag. + * See 7.4.8 Short-term reference picture set semantics + * @DeltaPocS1: Derived value depending on inter_ref_pic_set_prediction_flag. + * See 7.4.8 Short-term reference picture set semantics + * @NumDeltaPocsOfRefRpsIdx: The value of NumDeltaPocs[RefRpsIdx]. + * If inter_ref_pic_set_prediction_flag is equal to 0, + * this value should be ignored (Since: 1.18) + * + * Defines the #GstH265ShortTermRefPicSet params + */ +struct _GstH265ShortTermRefPicSet +{ + guint8 inter_ref_pic_set_prediction_flag; + guint8 delta_idx_minus1; + guint8 delta_rps_sign; + guint16 abs_delta_rps_minus1; + + /* calculated values */ + guint8 NumDeltaPocs; + guint8 NumNegativePics; + guint8 NumPositivePics; + guint8 UsedByCurrPicS0[16]; + guint8 UsedByCurrPicS1[16]; + gint32 DeltaPocS0[16]; + gint32 DeltaPocS1[16]; + guint8 NumDeltaPocsOfRefRpsIdx; +}; + +/** + * GstH265VUIParams: + * @aspect_ratio_info_present_flag: %TRUE specifies that aspect_ratio_idc is present. + * %FALSE specifies that aspect_ratio_idc is not present + * @aspect_ratio_idc specifies the value of the sample aspect ratio of the luma samples + * @sar_width indicates the horizontal size of the sample aspect ratio + * @sar_height indicates the vertical size of the sample aspect ratio + * @overscan_info_present_flag: %TRUE overscan_appropriate_flag is present %FALSE otherwise + * @overscan_appropriate_flag: %TRUE indicates that the cropped decoded pictures + * output are suitable for display using overscan. %FALSE the cropped decoded pictures + * output contain visually important information + * @video_signal_type_present_flag: %TRUE specifies that video_format, video_full_range_flag and + * colour_description_present_flag are present. + * @video_format: indicates the representation of the picture + * @video_full_range_flag: indicates the black level and range of the luma and chroma signals + * @colour_description_present_flag: %TRUE specifies that colour_primaries, + * transfer_characteristics and matrix_coefficients are present + * @colour_primaries: indicates the chromaticity coordinates of the source primaries + * @transfer_characteristics: indicates the opto-electronic transfer characteristic + * @matrix_coefficients: describes the matrix coefficients used in deriving luma and chroma signals + * @chroma_loc_info_present_flag: %TRUE specifies that chroma_sample_loc_type_top_field and + * chroma_sample_loc_type_bottom_field are present, %FALSE otherwise + * @chroma_sample_loc_type_top_field: specify the location of chroma for top field + * @chroma_sample_loc_type_bottom_field specify the location of chroma for bottom field + * @neutral_chroma_indication_flag: %TRUE indicate that the value of chroma samples is equla + * to 1<<(BitDepthchrom-1). + * @field_seq_flag: %TRUE indicate field and %FALSE indicate frame + * @frame_field_info_present_flag: %TRUE indicate picture timing SEI messages are present for every + * picture and include the pic_struct, source_scan_type, and duplicate_flag syntax elements. + * @default_display_window_flag: %TRUE indicate that the default display window parameters present + * def_disp_win_left_offset:left offset of display rect + * def_disp_win_right_offset: right offset of display rect + * def_disp_win_top_offset: top offset of display rect + * def_disp_win_bottom_offset: bottom offset of display rect + * @timing_info_present_flag: %TRUE specifies that num_units_in_tick, + * time_scale and fixed_frame_rate_flag are present in the bitstream + * @num_units_in_tick: is the number of time units of a clock operating at the frequency time_scale Hz + * @time_scale: is the number of time units that pass in one second + * @poc_proportional_to_timing_flag: %TRUE indicates that the picture order count value for each picture + * in the CVS that is not the first picture in the CVS, in decoding order, is proportional to the output + * time of the picture relative to the output time of the first picture in the CVS. + * @num_ticks_poc_diff_one_minus1: plus 1 specifies the number of clock ticks corresponding to a + * difference of picture order count values equal to 1 + * @hrd_parameters_present_flag: %TRUE if hrd parameters present in the bitstream + * @bitstream_restriction_flag: %TRUE specifies that the following coded video sequence bitstream restriction + * parameters are present + * @tiles_fixed_structure_flag: %TRUE indicates that each PPS that is active in the CVS has the same value + * of the syntax elements num_tile_columns_minus1, num_tile_rows_minus1, uniform_spacing_flag, + * column_width_minus1, row_height_minus1 and loop_filter_across_tiles_enabled_flag, when present + * @motion_vectors_over_pic_boundaries_flag: %FALSE indicates that no sample outside the + * picture boundaries and no sample at a fractional sample position, %TRUE indicates that one or more + * samples outside picture boundaries may be used in inter prediction + * @restricted_ref_pic_list_flag: %TRUE indicates that all P and B slices (when present) that belong to + * the same picture have an identical reference picture list 0, and that all B slices (when present) + * that belong to the same picture have an identical reference picture list 1 + * @min_spatial_segmentation_idc: when not equal to 0, establishes a bound on the maximum possible size + * of distinct coded spatial segmentation regions in the pictures of the CVS + * @max_bytes_per_pic_denom: indicates a number of bytes not exceeded by the sum of the sizes of + * the VCL NAL units associated with any coded picture in the coded video sequence. + * @max_bits_per_min_cu_denom: indicates an upper bound for the number of coded bits of coding_unit + * data for any coding block in any picture of the CVS + * @log2_max_mv_length_horizontal: indicate the maximum absolute value of a decoded horizontal + * motion vector component + * @log2_max_mv_length_vertical: indicate the maximum absolute value of a decoded vertical + * motion vector component + * + * The structure representing the VUI parameters. + */ +struct _GstH265VUIParams +{ + guint8 aspect_ratio_info_present_flag; + guint8 aspect_ratio_idc; + /* if aspect_ratio_idc == 255 */ + guint16 sar_width; + guint16 sar_height; + + guint8 overscan_info_present_flag; + /* if overscan_info_present_flag */ + guint8 overscan_appropriate_flag; + + guint8 video_signal_type_present_flag; + guint8 video_format; + guint8 video_full_range_flag; + guint8 colour_description_present_flag; + guint8 colour_primaries; + guint8 transfer_characteristics; + guint8 matrix_coefficients; + + guint8 chroma_loc_info_present_flag; + guint8 chroma_sample_loc_type_top_field; + guint8 chroma_sample_loc_type_bottom_field; + + guint8 neutral_chroma_indication_flag; + guint8 field_seq_flag; + guint8 frame_field_info_present_flag; + guint8 default_display_window_flag; + guint32 def_disp_win_left_offset; + guint32 def_disp_win_right_offset; + guint32 def_disp_win_top_offset; + guint32 def_disp_win_bottom_offset; + + guint8 timing_info_present_flag; + /* if timing_info_present_flag */ + guint32 num_units_in_tick; + guint32 time_scale; + guint8 poc_proportional_to_timing_flag; + /* if poc_proportional_to_timing_flag */ + guint32 num_ticks_poc_diff_one_minus1; + guint8 hrd_parameters_present_flag; + /*if hrd_parameters_present_flat */ + GstH265HRDParams hrd_params; + + guint8 bitstream_restriction_flag; + /* if bitstream_restriction_flag */ + guint8 tiles_fixed_structure_flag; + guint8 motion_vectors_over_pic_boundaries_flag; + guint8 restricted_ref_pic_lists_flag; + guint16 min_spatial_segmentation_idc; + guint8 max_bytes_per_pic_denom; + guint8 max_bits_per_min_cu_denom; + guint8 log2_max_mv_length_horizontal; + guint8 log2_max_mv_length_vertical; + + /* calculated values */ + guint par_n; + guint par_d; +}; + +/** + * GstH265SPSExtensionParams: + * @transform_skip_rotation_enabled_flag: %TRUE specifies that a rotation is applied to + * the residual data block from intra 4X4 blocks coded using a transform skip operation. + * @transform_skip_context_enabled_flag: %TRUE specifies tspecifies that a particular + * context is used for the parsing of the sig_coeff_flag for transform blocks with a skipped + * transform. + * @implicit_residual_dpcm_enabled_flag: %TRUE specifies that the residual modification process + * for blocks using a transform bypass may be used for intra blocks in the CVS + * @explicit_residual_dpcm_enabled_flag: %TRUE specifies that the residual modification process + * for blocks using a transform bypass may be used for inter blocks in the CVS + * @extended_precision_processing_flag: %TRUE specifies that an extended dynamic range is used + * for coefficient parsing and inverse transform processing + * @intra_smoothing_disabled_flag: %TRUE specifies that the filtering process of neighbouring + * samples is unconditionally disabled for intra prediction + * @high_precision_offsets_enabled_flag: %TRUE specifies that weighted prediction offset values + * are signalled using a bit-depth-dependent precision. + * @persistent_rice_adaptation_enabled_flag: %TRUE specifies that the Rice parameter derivation + * for the binarization of coeff_abs_level_remaining[] is initialized at the start of each + * sub-block using mode dependent statistics accumulated from previous sub-blocks. + * @cabac_bypass_alignment_enabled_flag: %TRUE specifies that a context-based adaptive binary + * arithmetic coding (CABAC) alignment process is used prior to bypass decoding of the syntax + * elements coeff_sign_flag[] and coeff_abs_level_remaining[] + * + * Defines the GstH265SPSExtensionParams + */ +struct _GstH265SPSExtensionParams { + guint8 transform_skip_rotation_enabled_flag; + guint8 transform_skip_context_enabled_flag; + guint8 implicit_rdpcm_enabled_flag; + guint8 explicit_rdpcm_enabled_flag; + guint8 extended_precision_processing_flag; + guint8 intra_smoothing_disabled_flag; + guint8 high_precision_offsets_enabled_flag; + guint8 persistent_rice_adaptation_enabled_flag; + guint8 cabac_bypass_alignment_enabled_flag; +}; + +/** + * GstH265SPSSccExtensionParams: + * @sps_curr_pic_ref_enabled_flag: equal to 1 specifies that a picture in the CVS may be + * included in a reference picture list of a slice of the picture itself. + * @palette_mode_enabled_flag: equal to 1 specifies that the decoding process for palette mode + * may be used for intra blocks. Equal to 0 specifies that the decoding process for palette + * mode is not applied. + * @palette_max_size: specifies the maximum allowed palette size. + * @delta_palette_max_predictor_size: specifies the difference between the maximum allowed + * palette predictor size and the maximum allowed palette size. + * @sps_palette_predictor_initializers_present_flag: equal to 1 specifies that the sequence + * palette predictors are initialized using the sps_palette_predictor_initializer specified + * in clause 7.3.2.2.3. + * @sps_num_palette_predictor_initializer_minus1: plus 1 specifies the number of entries in + * the sequence palette predictor initializer. + * @sps_palette_predictor_initializer: specifies the value of the comp-th component of the + * i-th palette entry in the SPS that is used to initialize the array PredictorPaletteEntries. + * @motion_vector_resolution_control_idc: controls the presence and inference of the + * use_integer_mv_flag that specifies the resolution of motion vectors for inter prediction. + * @intra_boundary_filtering_disabled_flag: equal to 1 specifies that the intra boundary + * filtering process is unconditionally disabled for intra prediction. + * Defines the _GstH265SPSSccExtensionParams + * + * Since: 1.18 + */ +struct _GstH265SPSSccExtensionParams { + guint8 sps_curr_pic_ref_enabled_flag; + guint8 palette_mode_enabled_flag; + guint8 palette_max_size; + guint8 delta_palette_max_predictor_size; + guint8 sps_palette_predictor_initializers_present_flag; + guint8 sps_num_palette_predictor_initializer_minus1; + guint32 sps_palette_predictor_initializer[3][128]; + guint8 motion_vector_resolution_control_idc; + guint8 intra_boundary_filtering_disabled_flag; +}; + +/** + * GstH265PPSExtensionParams: + * @log2_max_transform_skip_block_size_minus2: plus 2 specifies the maximum transform block size for which + * transform_skip_flag may be present in coded pictures referring to the PPS. + * @cross_component_prediction_enabled_flag: equal to 1 specifies that log2_res_scale_abs_plus1 and + * res_scale_sign_flag may be present in the transform unit syntax for pictures referring to the PPS. + * @chroma_qp_offset_list_enabled_flag: equal to 1 specifies that the cu_chroma_qp_offset_flag may be + * present in the transform unit syntax. + * @diff_cu_chroma_qp_offset_depth: specifies the difference between the luma coding tree block size and + * the minimum luma coding block size of coding units that convey cu_chroma_qp_offset_flag. + * @chroma_qp_offset_list_len_minus1: plus 1 specifies the number of cb_qp_offset_list[] and + * cr_qp_offset_list[] syntax elements that are present in the PPS. + * @cb_qp_offset_list: specify offsets used in the derivation of qp cb. + * @cr_qp_offset_list: specify offsets used in the derivation of qp cr. + * @log2_sao_offset_scale_luma: the base 2 logarithm of the scaling parameter that is used to scale sample + * adaptive offset (SAO) offset values for luma samples. + * @log2_sao_offset_scale_chroma: the base 2 logarithm of the scaling parameter that is used to scale SAO + * offset values for chroma samples. + * + * Defines the GstH265SPSExtensionParams + */ +struct _GstH265PPSExtensionParams { + guint32 log2_max_transform_skip_block_size_minus2; + guint8 cross_component_prediction_enabled_flag; + guint8 chroma_qp_offset_list_enabled_flag; + guint8 diff_cu_chroma_qp_offset_depth; + guint8 chroma_qp_offset_list_len_minus1; + gint8 cb_qp_offset_list[6]; + gint8 cr_qp_offset_list[6]; + guint8 log2_sao_offset_scale_luma; + guint8 log2_sao_offset_scale_chroma; +}; + +/** + * GstH265PPSSccExtensionParams: + * @pps_curr_pic_ref_enabled_flag: equal to 1 specifies that a picture referring to the PPS may + * be included in a reference picture list of a slice of the picture itself. + * @residual_adaptive_colour_transform_enabled_flag: equal to 1 specifies that an adaptive + * colour transform may be applied to the residual in the decoding process. + * @pps_slice_act_qp_offsets_present_flag: equal to 1 specifies that slice_act_y_qp_offset, + * slice_act_cb_qp_offset, slice_act_cr_qp_offset are present in the slice header. + * @pps_act_y_qp_offset_plus5 @pps_act_cb_qp_offset_plus5 @pps_act_cr_qp_offset_plus3: + * are used to determine the offsets that are applied to the quantization parameter values + * qp derived in clause 8.6.2 for the luma, Cb and Cr components, respectively, when + * tu_residual_act_flag[ xTbY ][ yTbY ] is equal to 1. + * @pps_palette_predictor_initializers_present_flag: equal to 1 specifies that the palette + * predictor initializers used for the pictures referring to the PPS are derived based on + * the palette predictor initializers specified by the PPS. + * @pps_num_palette_predictor_initializer: specifies the number of entries in the picture + * palette predictor initializer. + * @monochrome_palette_flag: equal to 1 specifies that the pictures that refer to this PPS + * are monochrome. Equal to 0 specifies that the pictures that refer to this PPS have + * multiple components. + * @luma_bit_depth_entry_minus8: plus 8 specifies the bit depth of the luma component of the + * entries of the palette predictor initializer. + * @chroma_bit_depth_entry_minus8: plus 8 specifies the bit depth of the chroma components of + * the entries of the palette predictor initializer. + * @pps_palette_predictor_initializer: specifies the value of the comp-th component of the + * i-th palette entry in the PPS that is used to initialize the array PredictorPaletteEntries. + * Defines the _GstH265PPSSccExtensionParams + * + * Since: 1.18 + */ +struct _GstH265PPSSccExtensionParams { + guint8 pps_curr_pic_ref_enabled_flag; + guint8 residual_adaptive_colour_transform_enabled_flag; + guint8 pps_slice_act_qp_offsets_present_flag; + guint8 pps_act_y_qp_offset_plus5; + guint8 pps_act_cb_qp_offset_plus5; + guint8 pps_act_cr_qp_offset_plus3; + guint8 pps_palette_predictor_initializers_present_flag; + guint8 pps_num_palette_predictor_initializer; + guint8 monochrome_palette_flag; + guint8 luma_bit_depth_entry_minus8; + guint32 chroma_bit_depth_entry_minus8; + guint32 pps_palette_predictor_initializer[3][128]; +}; + +/** + * GstH265ScalingList: + * @scaling_list_dc_coef_minus8_16x16: this plus 8 specifies the DC + * Coefficient values for 16x16 scaling list + * @scaling_list_dc_coef_minus8_32x32: this plus 8 specifies the DC + * Coefficient values for 32x32 scaling list + * @scaling_lists_4x4: 4x4 scaling list + * @scaling_lists_8x8: 8x8 scaling list + * @scaling_lists_16x16: 16x16 scaling list + * @guint8 scaling_lists_32x32: 32x32 scaling list + * + * Defines the GstH265ScalingList + */ +struct _GstH265ScalingList { + + gint16 scaling_list_dc_coef_minus8_16x16[6]; + gint16 scaling_list_dc_coef_minus8_32x32[2]; + + guint8 scaling_lists_4x4 [6][16]; + guint8 scaling_lists_8x8 [6][64]; + guint8 scaling_lists_16x16 [6][64]; + guint8 scaling_lists_32x32 [2][64]; +}; + +/** + * GstH265SPS: + * @id: The ID of the sequence parameter set + * @profile_idc: indicate the profile to which the coded video sequence conforms + * + * H265 Sequence Parameter Set (SPS) + */ +struct _GstH265SPS +{ + guint8 id; + + GstH265VPS *vps; + + guint8 max_sub_layers_minus1; + guint8 temporal_id_nesting_flag; + + GstH265ProfileTierLevel profile_tier_level; + + guint8 chroma_format_idc; + guint8 separate_colour_plane_flag; + guint16 pic_width_in_luma_samples; + guint16 pic_height_in_luma_samples; + + guint8 conformance_window_flag; + /* if conformance_window_flag */ + guint32 conf_win_left_offset; + guint32 conf_win_right_offset; + guint32 conf_win_top_offset; + guint32 conf_win_bottom_offset; + + guint8 bit_depth_luma_minus8; + guint8 bit_depth_chroma_minus8; + guint8 log2_max_pic_order_cnt_lsb_minus4; + + guint8 sub_layer_ordering_info_present_flag; + guint8 max_dec_pic_buffering_minus1[GST_H265_MAX_SUB_LAYERS]; + guint8 max_num_reorder_pics[GST_H265_MAX_SUB_LAYERS]; + guint8 max_latency_increase_plus1[GST_H265_MAX_SUB_LAYERS]; + + guint8 log2_min_luma_coding_block_size_minus3; + guint8 log2_diff_max_min_luma_coding_block_size; + guint8 log2_min_transform_block_size_minus2; + guint8 log2_diff_max_min_transform_block_size; + guint8 max_transform_hierarchy_depth_inter; + guint8 max_transform_hierarchy_depth_intra; + + guint8 scaling_list_enabled_flag; + /* if scaling_list_enabled_flag */ + guint8 scaling_list_data_present_flag; + + GstH265ScalingList scaling_list; + + guint8 amp_enabled_flag; + guint8 sample_adaptive_offset_enabled_flag; + guint8 pcm_enabled_flag; + /* if pcm_enabled_flag */ + guint8 pcm_sample_bit_depth_luma_minus1; + guint8 pcm_sample_bit_depth_chroma_minus1; + guint8 log2_min_pcm_luma_coding_block_size_minus3; + guint8 log2_diff_max_min_pcm_luma_coding_block_size; + guint8 pcm_loop_filter_disabled_flag; + + guint8 num_short_term_ref_pic_sets; + GstH265ShortTermRefPicSet short_term_ref_pic_set[65]; + + guint8 long_term_ref_pics_present_flag; + /* if long_term_ref_pics_present_flag */ + guint8 num_long_term_ref_pics_sps; + guint16 lt_ref_pic_poc_lsb_sps[32]; + guint8 used_by_curr_pic_lt_sps_flag[32]; + + guint8 temporal_mvp_enabled_flag; + guint8 strong_intra_smoothing_enabled_flag; + guint8 vui_parameters_present_flag; + + /* if vui_parameters_present_flat */ + GstH265VUIParams vui_params; + + guint8 sps_extension_flag; + + /* if sps_extension_present_flag */ + guint8 sps_range_extension_flag; + guint8 sps_multilayer_extension_flag; + guint8 sps_3d_extension_flag; + guint8 sps_scc_extension_flag; + guint8 sps_extension_4bits; + + /* if sps_range_extension_flag */ + GstH265SPSExtensionParams sps_extnsion_params; + /* if sps_scc_extension_flag */ + GstH265SPSSccExtensionParams sps_scc_extension_params; + + /* calculated values */ + guint8 chroma_array_type; + gint width, height; + gint crop_rect_width, crop_rect_height; + gint crop_rect_x, crop_rect_y; + gint fps_num, fps_den; + gboolean valid; +}; + +/** + * GstH265PPS: + * + * H265 Picture Parameter Set + */ +struct _GstH265PPS +{ + guint id; + + GstH265SPS *sps; + + guint8 dependent_slice_segments_enabled_flag; + guint8 output_flag_present_flag; + guint8 num_extra_slice_header_bits; + guint8 sign_data_hiding_enabled_flag; + guint8 cabac_init_present_flag; + guint8 num_ref_idx_l0_default_active_minus1; + guint8 num_ref_idx_l1_default_active_minus1; + gint8 init_qp_minus26; + guint8 constrained_intra_pred_flag; + guint8 transform_skip_enabled_flag; + guint8 cu_qp_delta_enabled_flag; + /*if cu_qp_delta_enabled_flag */ + guint8 diff_cu_qp_delta_depth; + + gint8 cb_qp_offset; + gint8 cr_qp_offset; + guint8 slice_chroma_qp_offsets_present_flag; + guint8 weighted_pred_flag; + guint8 weighted_bipred_flag; + guint8 transquant_bypass_enabled_flag; + guint8 tiles_enabled_flag; + guint8 entropy_coding_sync_enabled_flag; + + guint8 num_tile_columns_minus1; + guint8 num_tile_rows_minus1; + guint8 uniform_spacing_flag; + guint32 column_width_minus1[20]; + guint32 row_height_minus1[22]; + guint8 loop_filter_across_tiles_enabled_flag; + + guint8 loop_filter_across_slices_enabled_flag; + guint8 deblocking_filter_control_present_flag; + guint8 deblocking_filter_override_enabled_flag; + guint8 deblocking_filter_disabled_flag; + gint8 beta_offset_div2; + gint8 tc_offset_div2; + + guint8 scaling_list_data_present_flag; + + GstH265ScalingList scaling_list; + + guint8 lists_modification_present_flag; + guint8 log2_parallel_merge_level_minus2; + guint8 slice_segment_header_extension_present_flag; + + guint8 pps_extension_flag; + + /* if pps_extension_flag*/ + guint8 pps_range_extension_flag; + guint8 pps_multilayer_extension_flag; + guint8 pps_3d_extension_flag; + guint8 pps_scc_extension_flag; + guint8 pps_extension_4bits; + + /* if pps_range_extension_flag*/ + GstH265PPSExtensionParams pps_extension_params; + /* if pps_scc_extension_flag*/ + GstH265PPSSccExtensionParams pps_scc_extension_params; + + /* calculated values */ + guint32 PicWidthInCtbsY; + guint32 PicHeightInCtbsY; + gboolean valid; +}; + +struct _GstH265RefPicListModification +{ + guint8 ref_pic_list_modification_flag_l0; + guint32 list_entry_l0[15]; + guint8 ref_pic_list_modification_flag_l1; + guint32 list_entry_l1[15]; +}; + +struct _GstH265PredWeightTable +{ + guint8 luma_log2_weight_denom; + gint8 delta_chroma_log2_weight_denom; + + guint8 luma_weight_l0_flag[15]; + guint8 chroma_weight_l0_flag[15]; + gint8 delta_luma_weight_l0[15]; + gint8 luma_offset_l0[15]; + gint8 delta_chroma_weight_l0 [15][2]; + gint16 delta_chroma_offset_l0 [15][2]; + + guint8 luma_weight_l1_flag[15]; + guint8 chroma_weight_l1_flag[15]; + gint8 delta_luma_weight_l1[15]; + gint8 luma_offset_l1[15]; + gint8 delta_chroma_weight_l1[15][2]; + gint16 delta_chroma_offset_l1[15][2]; +}; + +/** + * GstH265SliceHdr: + * @first_slice_segment_in_pic_flag: equal to 1 if this slice segment is + * the first slice segment of the picture in decoding order + * @no_output_of_prior_pics_flag: affects the output of previously-decoded pictures + * in the decoded picture buffer after the decoding of an IDR or a BLA picture + * that is not the first picture in the bitstream as specified in Annex C + * @pps: a #GstH265PPS + * @dependent_slice_segment_flag: equal to 1 if the value of each slice segment header + * syntax element that is not present is inferred to be equal to the value of corresponding + * slice segment header syntax element in the slice header. + * @segment_address: the address of the first CTB in the slice segment + * @type: slice type (B, P, or I) + * @pic_output_flag: affects the decoded picture output and removal processes + * as specified in Annex C. + * @colour_plane_id: specifies the colour plane associated with the current slice RBSP + * when separate_colour_plane_flag is equal to 1 + * @pic_order_cnt_lsb: the picture order count modulo MaxPicOrderCntLsb for the current picture + * @short_term_ref_pic_set_sps_flag: equal to 1 specifies that the short-term RPS + * of the current picture is derived based on the active SPS. + * @short_term_ref_pic_sets: a #GstH265ShortTermRefPicSet structure + * @short_term_ref_pic_set_idx: the index of st_ref_pic_set syntax structure + * that is used for derivation of the short-term RPS of the current picture. + * @num_long_term_sps: the number of entries in the long-term RPS of current picture + * that are derived based on the syntax in active SPS. + * @num_long_term_pics: the number of entries in the long-term RPS of the current picture + * that are directly signalled in the slice header. + * @lt_idx_sps: the index of candidate long-term reference pictures + * specified in the active SPS. + * @poc_lsb_lt: the value of the picture order count modulo MaxPicOrderCntLsb + * of the each entry in the long-term RPS of the current picture. + * @used_by_curr_pic_lt_flag: equal to 0 if the entry in the long-term RPS + * of the current picture is not used for reference by the current picture. + * @delta_poc_msb_present_flag: equal to 1 if i-th delta_poc_msb_cycle_lt[] is present. + * @delta_poc_msb_cycle_lt: used to determine the value of the most significant bits + * of the picture order count value of the i-th entry in the long-term RPS of the current picture. + * @temporal_mvp_enabled_flag: whether temporal motion vector predictors can be used for inter prediction. + * @sao_luma_flag: equal to 1 if SAO is enabled for the luma component in the current slice. + * @sao_chroma_flag: equal to 1 if SAO is enabled for the chroma component in the current slice. + * @num_ref_idx_active_override_flag: equal to 1 specifies that the syntax elements + * num_ref_idx_l0_active_minus1 and num_ref_idx_l1_active_minus1 are present. + * @num_ref_idx_l0_active_minus1: the maximum reference index for reference picture list 0 + * that may be used to decode the slice. + * @num_ref_idx_l1_active_minus1: the maximum reference index for reference picture list 1 + * that may be used to decode the slice. + * @ref_pic_list_modification: a #GstH265RefPicListModification + * @mvd_l1_zero_flag: equal to 1 if the mvd_coding sytanx structure is not parsed + * @cabac_init_flag: specifies the method for determining the initialization table + * used in the initialization process for context variables. + * @collocated_from_l0_flag: equal to 1 specifies that the collocated picture + * used for temporal motion vector prediction is derived from reference picture list 0. + * @collocated_ref_idx: the reference index of the collocated picture + * used for temporal motion vector prediction. + * @pred_weight_table: a #GstH265PredWeightTable + * @five_minus_max_num_merge_cand: specifies the maximum number of merging motion vector prediction (MVP) + * candidates supported in the slice. + * @use_integer_mv_flag: equal to 1 specifies that the resolution of motion vectors for inter + * prediction in the current slice is integer. (Since: 1.18) + * @qp_delta: specifies the inital value of QPy to be used for the coding blocks in the slice. + * @cb_qp_offset: a difference to be added to the value of pps_cb_qp_offset. + * @cr_qp_offset: a difference to be added to the value of pps_cr_qp_offset. + * @slice_act_y_qp_offset: specify offsets to the quantization parameter values qP derived in + * clause 8.6.2 for luma components. (Since: 1.18) + * @slice_act_cb_qp_offset: specify offsets to the quantization parameter values qP derived in + * clause 8.6.2 for Cb components. (Since: 1.18) + * @slice_act_cr_qp_offset: specify offsets to the quantization parameter values qP derived in + * clause 8.6.2 for Cr components. (Since: 1.18) + * @cu_chroma_qp_offset_enabled_flag: equal to 1 if the cu_chroma_qp_offset_flag + * may be present in the transform unit syntax. (Since: 1.18) + * @deblocking_filter_override_flag: equal to 1 if deblocking paramertes are present in the slice header. + * @deblocking_filter_disabled_flag: equal to 1 specifies that the operation of + * the deblocking filter is not applied for the current slice. + * @beta_offset_div2: deblocking parameter offset for beta divided by 2 for the current slice. + * @tc_offset_div2: deblocking parameter offset for tC divided by 2 for the current slice. + * @loop_filter_across_slices_enabled_flag: equal to 1 specifies that in-loop filtering + * operation may be performed across the left and upper boundaries of the current slice. + * @num_entry_point_offsets: specifies the number of entry_point_offset_minus1 syntax elements + * in the slice header. + * @offset_len_minus1: specifies the length of the entry_point_minus1 syntax elements + * in bits. + * @entry_point_offset_minus1: the entry point offset in bytes. + * @NumPocTotalCurr: calculated NumPocTotalCurr which is used for + * decoding process for reference picture set + * @header_size: the calculated size of the slice_header\() in bits. + * @n_emulation_prevention_bytes: number of emulation prevention bytes (EPB) + * in this slice_header\() + * @short_term_ref_pic_set_size: the calculated size of short_term_ref_pic_set\() + * in bits. (Since: 1.18) + */ +struct _GstH265SliceHdr +{ + guint8 first_slice_segment_in_pic_flag; + guint8 no_output_of_prior_pics_flag; + + GstH265PPS *pps; + + guint8 dependent_slice_segment_flag; + guint32 segment_address; + + guint8 type; + + guint8 pic_output_flag; + guint8 colour_plane_id; + guint16 pic_order_cnt_lsb; + + guint8 short_term_ref_pic_set_sps_flag; + GstH265ShortTermRefPicSet short_term_ref_pic_sets; + guint8 short_term_ref_pic_set_idx; + + guint8 num_long_term_sps; + guint8 num_long_term_pics; + guint8 lt_idx_sps[16]; + guint32 poc_lsb_lt[16]; + guint8 used_by_curr_pic_lt_flag[16]; + guint8 delta_poc_msb_present_flag[16]; + guint32 delta_poc_msb_cycle_lt[16]; + + guint8 temporal_mvp_enabled_flag; + guint8 sao_luma_flag; + guint8 sao_chroma_flag; + guint8 num_ref_idx_active_override_flag; + guint8 num_ref_idx_l0_active_minus1; + guint8 num_ref_idx_l1_active_minus1; + + GstH265RefPicListModification ref_pic_list_modification; + + guint8 mvd_l1_zero_flag; + guint8 cabac_init_flag; + guint8 collocated_from_l0_flag; + guint8 collocated_ref_idx; + + GstH265PredWeightTable pred_weight_table; + + guint8 five_minus_max_num_merge_cand; + guint8 use_integer_mv_flag; + + gint8 qp_delta; + gint8 cb_qp_offset; + gint8 cr_qp_offset; + gint8 slice_act_y_qp_offset; + gint8 slice_act_cb_qp_offset; + gint8 slice_act_cr_qp_offset; + + guint8 cu_chroma_qp_offset_enabled_flag; + + guint8 deblocking_filter_override_flag; + guint8 deblocking_filter_disabled_flag; + gint8 beta_offset_div2; + gint8 tc_offset_div2; + + guint8 loop_filter_across_slices_enabled_flag; + + guint32 num_entry_point_offsets; + guint8 offset_len_minus1; + guint32 *entry_point_offset_minus1; + + /* calculated values */ + + gint NumPocTotalCurr; + /* Size of the slice_header() in bits */ + guint header_size; + /* Number of emulation prevention bytes (EPB) in this slice_header() */ + guint n_emulation_prevention_bytes; + + /* Size of short_term_ref_pic_set() in bits */ + guint short_term_ref_pic_set_size; +}; + +struct _GstH265PicTiming +{ + guint8 pic_struct; + guint8 source_scan_type; + guint8 duplicate_flag; + + guint8 au_cpb_removal_delay_minus1; + guint8 pic_dpb_output_delay; + guint8 pic_dpb_output_du_delay; + guint32 num_decoding_units_minus1; + guint8 du_common_cpb_removal_delay_flag; + guint8 du_common_cpb_removal_delay_increment_minus1; + guint32 *num_nalus_in_du_minus1; + guint8 *du_cpb_removal_delay_increment_minus1; +}; + +struct _GstH265BufferingPeriod +{ + GstH265SPS *sps; + + guint8 irap_cpb_params_present_flag; + guint8 cpb_delay_offset; + guint8 dpb_delay_offset; + guint8 concatenation_flag; + guint8 au_cpb_removal_delay_delta_minus1; + + /* seq->vui_parameters->nal_hrd_parameters_present_flag */ + guint8 nal_initial_cpb_removal_delay[32]; + guint8 nal_initial_cpb_removal_offset[32]; + guint8 nal_initial_alt_cpb_removal_delay[32]; + guint8 nal_initial_alt_cpb_removal_offset [32]; + + /* seq->vui_parameters->vcl_hrd_parameters_present_flag */ + guint8 vcl_initial_cpb_removal_delay[32]; + guint8 vcl_initial_cpb_removal_offset[32]; + guint8 vcl_initial_alt_cpb_removal_delay[32]; + guint8 vcl_initial_alt_cpb_removal_offset[32]; +}; + +struct _GstH265RecoveryPoint +{ + gint32 recovery_poc_cnt; + guint8 exact_match_flag; + guint8 broken_link_flag; +}; + +/** + * GstH265RegisteredUserData: + * The User data registered by Rec. ITU-T T.35 SEI message. + * @country_code: an itu_t_t35_country_code. + * @country_code_extension: an itu_t_t35_country_code_extension_byte. + * Should be ignored when @country_code is not 0xff + * @data: the data of itu_t_t35_payload_byte + * excluding @country_code and @country_code_extension + * @size: the size of @data in bytes + * + * Since: 1.18 + */ +struct _GstH265RegisteredUserData +{ + guint8 country_code; + guint8 country_code_extension; + const guint8 *data; + guint size; +}; + + +/** + * GstH265TimeCode: + * The time code SEI message provides time code information similar to that + * defined by SMPTE ST 12-1 (2014) for field(s) or frame(s) of the current + * picture. + * + * D.2.27 + * + * Since: 1.16 + */ +struct _GstH265TimeCode +{ + guint8 num_clock_ts; + guint8 clock_timestamp_flag[3]; + guint8 units_field_based_flag[3]; + guint8 counting_type[3]; + guint8 full_timestamp_flag[3]; + guint8 discontinuity_flag[3]; + guint8 cnt_dropped_flag[3]; + guint16 n_frames[3]; + guint8 seconds_flag[3]; + guint8 seconds_value[3]; + guint8 minutes_flag[3]; + guint8 minutes_value[3]; + guint8 hours_flag[3]; + guint8 hours_value[3]; + guint8 time_offset_length[3]; + guint32 time_offset_value[3]; +}; + +/** + * GstH265MasteringDisplayColourVolume: + * The colour volume (primaries, white point and luminance range) of display + * defined by SMPTE ST 2086. + * + * D.2.28 + * + * Since: 1.18 + */ +struct _GstH265MasteringDisplayColourVolume +{ + guint16 display_primaries_x[3]; + guint16 display_primaries_y[3]; + guint16 white_point_x; + guint16 white_point_y; + guint32 max_display_mastering_luminance; + guint32 min_display_mastering_luminance; +}; + +/** + * GstH265ContentLightLevel: + * The upper bounds for the nominal target brightness light level + * as specified in CEA-861.3 + * + * D.2.35 + * + * Since: 1.18 + */ +struct _GstH265ContentLightLevel +{ + guint16 max_content_light_level; + guint16 max_pic_average_light_level; +}; + +struct _GstH265SEIMessage +{ + GstH265SEIPayloadType payloadType; + + union { + GstH265BufferingPeriod buffering_period; + GstH265PicTiming pic_timing; + GstH265RegisteredUserData registered_user_data; + GstH265RecoveryPoint recovery_point; + GstH265TimeCode time_code; + GstH265MasteringDisplayColourVolume mastering_display_colour_volume; + GstH265ContentLightLevel content_light_level; + /* ... could implement more */ + } payload; +}; + +/** + * GstH265Parser: + * + * H265 NAL Parser (opaque structure). + */ +struct _GstH265Parser +{ + /*< private >*/ + GstH265VPS vps[GST_H265_MAX_VPS_COUNT]; + GstH265SPS sps[GST_H265_MAX_SPS_COUNT]; + GstH265PPS pps[GST_H265_MAX_PPS_COUNT]; + GstH265VPS *last_vps; + GstH265SPS *last_sps; + GstH265PPS *last_pps; +}; + +GST_CODEC_PARSERS_API +GstH265Parser * gst_h265_parser_new (void); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_identify_nalu (GstH265Parser * parser, + const guint8 * data, + guint offset, + gsize size, + GstH265NalUnit * nalu); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_identify_nalu_unchecked (GstH265Parser * parser, + const guint8 * data, + guint offset, + gsize size, + GstH265NalUnit * nalu); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_identify_nalu_hevc (GstH265Parser * parser, + const guint8 * data, + guint offset, + gsize size, + guint8 nal_length_size, + GstH265NalUnit * nalu); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_parse_nal (GstH265Parser * parser, + GstH265NalUnit * nalu); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_parse_slice_hdr (GstH265Parser * parser, + GstH265NalUnit * nalu, + GstH265SliceHdr * slice); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_parse_vps (GstH265Parser * parser, + GstH265NalUnit * nalu, + GstH265VPS * vps); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_parse_sps (GstH265Parser * parser, + GstH265NalUnit * nalu, + GstH265SPS * sps, + gboolean parse_vui_params); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_parse_pps (GstH265Parser * parser, + GstH265NalUnit * nalu, + GstH265PPS * pps); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_parse_sei (GstH265Parser * parser, + GstH265NalUnit * nalu, + GArray **messages); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_update_vps (GstH265Parser * parser, + GstH265VPS * vps); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_update_sps (GstH265Parser * parser, + GstH265SPS * sps); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parser_update_pps (GstH265Parser * parser, + GstH265PPS * pps); + +GST_CODEC_PARSERS_API +void gst_h265_parser_free (GstH265Parser * parser); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parse_vps (GstH265NalUnit * nalu, + GstH265VPS * vps); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parse_sps (GstH265Parser * parser, + GstH265NalUnit * nalu, + GstH265SPS * sps, + gboolean parse_vui_params); + +GST_CODEC_PARSERS_API +GstH265ParserResult gst_h265_parse_pps (GstH265Parser * parser, + GstH265NalUnit * nalu, + GstH265PPS * pps); + +GST_CODEC_PARSERS_API +gboolean gst_h265_slice_hdr_copy (GstH265SliceHdr * dst_slice, + const GstH265SliceHdr * src_slice); + +GST_CODEC_PARSERS_API +void gst_h265_slice_hdr_free (GstH265SliceHdr * slice_hdr); + +GST_CODEC_PARSERS_API +gboolean gst_h265_sei_copy (GstH265SEIMessage * dest_sei, + const GstH265SEIMessage * src_sei); + +GST_CODEC_PARSERS_API +void gst_h265_sei_free (GstH265SEIMessage * sei); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_4x4_get_zigzag_from_raster (guint8 out_quant[16], + const guint8 quant[16]); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_4x4_get_raster_from_zigzag (guint8 out_quant[16], + const guint8 quant[16]); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_8x8_get_zigzag_from_raster (guint8 out_quant[64], + const guint8 quant[64]); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_8x8_get_raster_from_zigzag (guint8 out_quant[64], + const guint8 quant[64]); + +#define gst_h265_quant_matrix_16x16_get_zigzag_from_raster \ + gst_h265_quant_matrix_8x8_get_zigzag_from_raster +#define gst_h265_quant_matrix_16x16_get_raster_from_zigzag \ + gst_h265_quant_matrix_8x8_get_raster_from_zigzag +#define gst_h265_quant_matrix_32x32_get_zigzag_from_raster \ + gst_h265_quant_matrix_8x8_get_zigzag_from_raster +#define gst_h265_quant_matrix_32x32_get_raster_from_zigzag \ + gst_h265_quant_matrix_8x8_get_raster_from_zigzag + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_4x4_get_uprightdiagonal_from_raster (guint8 out_quant[16], + const guint8 quant[16]); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_4x4_get_raster_from_uprightdiagonal (guint8 out_quant[16], + const guint8 quant[16]); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_8x8_get_uprightdiagonal_from_raster (guint8 out_quant[64], + const guint8 quant[64]); + +GST_CODEC_PARSERS_API +void gst_h265_quant_matrix_8x8_get_raster_from_uprightdiagonal (guint8 out_quant[64], + const guint8 quant[64]); + +#define gst_h265_quant_matrix_16x16_get_uprightdiagonal_from_raster \ + gst_h265_quant_matrix_8x8_get_uprightdiagonal_from_raster +#define gst_h265_quant_matrix_16x16_get_raster_from_uprightdiagonal\ + gst_h265_quant_matrix_8x8_get_raster_from_uprightdiagonal +#define gst_h265_quant_matrix_32x32_get_uprightdiagonal_from_raster \ + gst_h265_quant_matrix_8x8_get_uprightdiagonal_from_raster +#define gst_h265_quant_matrix_32x32_get_raster_from_uprightdiagonal\ + gst_h265_quant_matrix_8x8_get_raster_from_uprightdiagonal + +GST_CODEC_PARSERS_API +GstH265Profile gst_h265_profile_tier_level_get_profile (const GstH265ProfileTierLevel * ptl); + +GST_CODEC_PARSERS_API +const gchar * gst_h265_profile_to_string (GstH265Profile profile); + +GST_CODEC_PARSERS_API +GstH265Profile gst_h265_profile_from_string (const gchar * string); + +GST_CODEC_PARSERS_API +GstMemory * gst_h265_create_sei_memory (guint8 layer_id, + guint8 temporal_id_plus1, + guint8 start_code_prefix_length, + GArray * messages); + +GST_CODEC_PARSERS_API +GstMemory * gst_h265_create_sei_memory_hevc (guint8 layer_id, + guint8 temporal_id_plus1, + guint8 nal_length_size, + GArray * messages); + +GST_CODEC_PARSERS_API +GstBuffer * gst_h265_parser_insert_sei (GstH265Parser * parser, + GstBuffer * au, + GstMemory * sei); + +GST_CODEC_PARSERS_API +GstBuffer * gst_h265_parser_insert_sei_hevc (GstH265Parser * parser, + guint8 nal_length_size, + GstBuffer * au, + GstMemory * sei); + +GST_CODEC_PARSERS_API +GstH265Profile gst_h265_get_profile_from_sps (GstH265SPS * sps); + +G_END_DECLS +#endif |