openkylin
/
crystalhd
mirror of https://gitee.com/openkylin/crystalhd.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity
crystalhd/include/vdec_info.h

467 lines
14 KiB
C
Raw Blame History

/********************************************************************
* Copyright (c) 2004-2009 Broadcom Corporation.
*
* Common Video Decoder Information
*
********************************************************************
* This header is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published
* by the Free Software Foundation, either version 2.1 of the License.
*
* This header 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 Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General Public License
* along with this header. If not, see <http://www.gnu.org/licenses/>.
***************************************************************************/
#ifndef __INC_VDEC_INFO_H__
#define __INC_VDEC_INFO_H__
#include "bc_dts_types.h"
#pragma pack (1)
/* User Data Header */
typedef struct user_data {
struct user_data* next;
uint32_t type;
uint32_t size;
} UD_HDR;
/*------------------------------------------------------*
* MPEG Extension to the PPB *
*------------------------------------------------------*/
#define MPEG_VALID_PANSCAN (1)
#define MPEG_VALID_USER_DATA (2)
#define MPEG_USER_DATA_OVERFLOW (4)
#define MPEG_USER_DATA_TYPE_SEQ (1)
#define MPEG_USER_DATA_TYPE_GOP (2)
#define MPEG_USER_DATA_TYPE_PIC (4)
#define MPEG_USER_DATA_TYPE_TOP (8)
#define MPEG_USER_DATA_TYPE_BTM (16)
#define MPEG_USER_DATA_TYPE_I (32)
#define MPEG_USER_DATA_TYPE_P (64)
#define MPEG_USER_DATA_TYPE_B (128)
typedef struct {
uint32_t to_be_defined;
uint32_t valid;
/* Always valid, defaults to picture size if no
sequence display extension in the stream. */
uint32_t display_horizontal_size;
uint32_t display_vertical_size;
/* MPEG_VALID_PANSCAN
Offsets are a copy values from the MPEG stream. */
uint32_t offset_count;
int32_t horizontal_offset[3];
int32_t vertical_offset[3];
/* MPEG_VALID_USERDATA
User data is in the form of a linked list. */
int32_t userDataSize;
UD_HDR* userData;
} PPB_MPEG;
/*------------------------------------------------------*
* VC1 Extension to the PPB *
*------------------------------------------------------*/
#define VC1_VALID_PANSCAN (1)
#define VC1_VALID_USER_DATA (2)
#define VC1_USER_DATA_OVERFLOW (4)
#define VC1_USER_DATA_TYPE_SEQ (1)
#define VC1_USER_DATA_TYPE_ENTRYPOINT (2)
#define VC1_USER_DATA_TYPE_FRM (4)
#define VC1_USER_DATA_TYPE_FLD (8)
#define VC1_USER_DATA_TYPE_SLICE (16)
typedef struct {
uint32_t to_be_defined;
uint32_t valid;
/* Always valid, defaults to picture size if no
sequence display extension in the stream. */
uint32_t display_horizontal_size;
uint32_t display_vertical_size;
/* VC1 pan scan windows
*/
uint32_t num_panscan_windows;
int32_t ps_horiz_offset[4];
int32_t ps_vert_offset[4];
int32_t ps_width[4];
int32_t ps_height[4];
/* VC1_VALID_USERDATA
User data is in the form of a linked list. */
int32_t userDataSize;
UD_HDR* userData;
} PPB_VC1;
/*------------------------------------------------------*
* H.264 Extension to the PPB *
*------------------------------------------------------*/
/**
* @brief Film grain SEI message.
*
* Content of the film grain SEI message.
*/
//maximum number of model-values as for Thomson spec(standard says 5)
#define MAX_FGT_MODEL_VALUE (3)
//maximum number of intervals(as many as 256 intervals?)
#define MAX_FGT_VALUE_INTERVAL (256)
typedef struct FGT_SEI {
struct FGT_SEI* next;
unsigned char model_values[3][MAX_FGT_VALUE_INTERVAL][MAX_FGT_MODEL_VALUE];
unsigned char upper_bound[3][MAX_FGT_VALUE_INTERVAL];
unsigned char lower_bound[3][MAX_FGT_VALUE_INTERVAL];
unsigned char cancel_flag; /**< Cancel flag: 1 no film grain. */
unsigned char model_id; /**< Model id. */
//+unused SE based on Thomson spec
unsigned char color_desc_flag; /**< Separate color descrition flag. */
unsigned char bit_depth_luma; /**< Bit depth luma minus 8. */
unsigned char bit_depth_chroma; /**< Bit depth chroma minus 8. */
unsigned char full_range_flag; /**< Full range flag. */
unsigned char color_primaries; /**< Color primaries. */
unsigned char transfer_charact; /**< Transfer characteristics. */
unsigned char matrix_coeff; /**< Matrix coefficients. */
//-unused SE based on Thomson spec
unsigned char blending_mode_id; /**< Blending mode. */
unsigned char log2_scale_factor; /**< Log2 scale factor (2-7). */
unsigned char comp_flag[3]; /**< Components [0,2] parameters present flag. */
unsigned char num_intervals_minus1[3]; /**< Number of intensity level intervals. */
unsigned char num_model_values[3]; /**< Number of model values. */
uint16_t repetition_period; /**< Repetition period (0-16384) */
} FGT_SEI;
/* Bit definitions for H.264 user data type field
*/
#define AVC_USERDATA_TYPE_REGISTERED 4
#define AVC_USERDATA_TYPE_TOP 8
#define AVC_USERDATA_TYPE_BOT 16
/* Bit definitions for 'other.h264.valid' field */
#define H264_VALID_PANSCAN (1)
#define H264_VALID_SPS_CROP (2)
#define H264_VALID_VUI (4)
#define H264_VALID_USER (8)
#define H264_VALID_CT_TYPE (16)
#define H264_USER_OVERFLOW (32)
#define H264_FILM_GRAIN_MSG (64)
typedef struct {
/* 'valid' specifies which fields (or sets of
* fields) below are valid. If the corresponding
* bit in 'valid' is NOT set then that field(s)
* is (are) not initialized. */
uint32_t valid;
int32_t poc_top; /* POC for Top Field/Frame */
int32_t poc_bottom; /* POC for Bottom Field */
uint32_t idr_pic_id;
/* H264_VALID_PANSCAN */
uint32_t pan_scan_count;
int32_t pan_scan_left [3];
int32_t pan_scan_right [3];
int32_t pan_scan_top [3];
int32_t pan_scan_bottom[3];
/* H264_VALID_CT_TYPE */
uint32_t ct_type_count;
uint32_t ct_type[3];
/* H264_VALID_SPS_CROP */
int32_t sps_crop_left;
int32_t sps_crop_right;
int32_t sps_crop_top;
int32_t sps_crop_bottom;
/* H264_VALID_VUI */
uint32_t chroma_top;
uint32_t chroma_bottom;
/* H264_VALID_USER */
uint32_t user_data_size;
UD_HDR* user_data;
/* H264 VALID FGT */
FGT_SEI* pfgt;
} PPB_H264;
/*------------------------------------------------------*
* Picture Parameter Block *
*------------------------------------------------------*/
/* Bit definitions for 'flags' field */
#define VDEC_FLAG_PTS_PRESENT (0x0001)
#define VDEC_FLAG_PTS_MSB (0x0002)
#define VDEC_FLAG_EOS (0x0004)
#define VDEC_FLAG_FRAME (0x0000)
#define VDEC_FLAG_FIELDPAIR (0x0008)
#define VDEC_FLAG_TOPFIELD (0x0010)
#define VDEC_FLAG_BOTTOMFIELD (0x0018)
#define VDEC_FLAG_PROGRESSIVE_SRC (0x0000)
#define VDEC_FLAG_INTERLACED_SRC (0x0020)
#define VDEC_FLAG_UNKNOWN_SRC (0x0040)
#define VDEC_FLAG_BOTTOM_FIRST (0x0080)
#define VDEC_FLAG_LAST_PICTURE (0x0100)
#define VDEC_FLAG_STC_IS_CRAP (0x0200)
#define VDEC_FLAG_PCR_OFFSET_PRESENT (0x0400)
#define VDEC_FLAG_REF_CNTR_TYPE_PCR (0x0800)
#define VDEC_FLAG_DISCONT_PCR_OFFSET (0x1000)
#define VDEC_FLAG_PICTURE_TAG_VALID (0x2000)
#define VDEC_FLAG_PICTURE_DONE_MARKER_PRESENT (0x20000)
#define VDEC_FLAG_PICTURE_META_DATA_PRESENT (0x40000)
#define VDEC_FLAG_RESOLUTION_CHANGE (0x80000)
/* Values for the 'chroma_format' field. */
enum {
vdecChroma420 = 0x420,
vdecChroma422 = 0x422,
vdecChroma444 = 0x444,
};
#if !defined(_WIN32) && !defined(_WIN64) && !defined(__LINUX_USER__)
//////////////////////////////////////////////////////////////////////
/////// Moved to bc_dts_defs.h file for external Exports /////////////
//////////////////////////////////////////////////////////////////////
/* Values for 'pulldown' field. '0' means no pulldown information
* was present for this picture. */
enum {
vdecNoPulldownInfo = 0,
vdecTop = 1,
vdecBottom = 2,
vdecTopBottom = 3,
vdecBottomTop = 4,
vdecTopBottomTop = 5,
vdecBottomTopBottom = 6,
vdecFrame_X2 = 7,
vdecFrame_X3 = 8,
vdecFrame_X1 = 9,
vdecFrame_X4 = 10,
};
/* Values for 'protocol' field. */
enum {
protocolH264 = 0,
protocolMPEG2,
protocolH261,
protocolH263,
protocolVC1,
protocolMPEG1,
protocolMPEG2DTV,
protocolVC1ASF,
};
/* Values for the 'frame_rate' field. */
enum {
vdecFrameRateUnknown = 0,
vdecFrameRate23_97,
vdecFrameRate24,
vdecFrameRate25,
vdecFrameRate29_97,
vdecFrameRate30,
vdecFrameRate50,
vdecFrameRate59_94,
vdecFrameRate60,
};
/* Values for the 'matrix_coeff' field. */
enum {
vdecMatrixCoeffUnknown = 0,
vdecMatrixCoeffBT709,
vdecMatrixCoeffUnspecified,
vdecMatrixCoeffReserved,
vdecMatrixCoeffFCC = 4,
vdecMatrixCoeffBT740_2BG,
vdecMatrixCoeffSMPTE170M,
vdecMatrixCoeffSMPTE240M,
vdecMatrixCoeffSMPTE293M,
};
/* Values for the 'aspect_ratio' field. */
enum {
vdecAspectRatioUnknown = 0,
vdecAspectRatioSquare,
vdecAspectRatio12_11,
vdecAspectRatio10_11,
vdecAspectRatio16_11,
vdecAspectRatio40_33,
vdecAspectRatio24_11,
vdecAspectRatio20_11,
vdecAspectRatio32_11,
vdecAspectRatio80_33,
vdecAspectRatio18_11,
vdecAspectRatio15_11,
vdecAspectRatio64_33,
vdecAspectRatio160_99,
vdecAspectRatio4_3,
vdecAspectRatio16_9,
vdecAspectRatio221_1,
vdecAspectRatioOther = 255,
};
/* Values for the 'colour_primaries' field. */
enum {
vdecColourPrimariesUnknown = 0,
vdecColourPrimariesBT709,
vdecColourPrimariesUnspecified,
vdecColourPrimariesReserved,
vdecColourPrimariesBT470_2M = 4,
vdecColourPrimariesBT470_2BG,
vdecColourPrimariesSMPTE170M,
vdecColourPrimariesSMPTE240M,
vdecColourPrimariesGenericFilm,
};
/* Values for the 'transfer_char' field. */
enum {
vdecTransferCharUnknown = 0,
vdecTransferCharBT709,
vdecTransferCharUnspecified,
vdecTransferCharReserved,
vdecTransferCharBT479_2M = 4,
vdecTransferCharBT479_2BG,
vdecTransferCharSMPTE170M,
vdecTransferCharSMPTE240M,
vdecTransferCharLinear,
vdecTransferCharLog100_1,
vdecTransferCharLog31622777_1,
vdecColourPrimariesBT1361,
};
#endif // _WIN32
typedef struct {
/* Common fields. */
uint32_t picture_number; /* Ordinal display number */
uint32_t video_buffer; /* Video (picbuf) number */
uint32_t video_address; /* Address of picbuf Y */
uint32_t video_address_uv; /* Address of picbuf UV */
uint32_t video_stripe; /* Picbuf stripe */
uint32_t video_width; /* Picbuf width */
uint32_t video_height; /* Picbuf height */
uint32_t channel_id; /* Decoder channel ID */
uint32_t status; /* reserved */
uint32_t width; /* pixels */
uint32_t height; /* pixels */
uint32_t chroma_format; /* see above */
uint32_t pulldown; /* see above */
uint32_t flags; /* see above */
uint32_t pts; /* 32 LSBs of PTS */
uint32_t protocol; /* protocolXXX (above) */
uint32_t frame_rate; /* see above */
uint32_t matrix_coeff; /* see above */
uint32_t aspect_ratio; /* see above */
uint32_t colour_primaries; /* see above */
uint32_t transfer_char; /* see above */
uint32_t pcr_offset; /* 45kHz if PCR type; else 27MHz */
uint32_t n_drop; /* Number of pictures to be dropped */
uint32_t custom_aspect_ratio_width_height; /* upper 16-bits is Y and lower 16-bits is X */
uint32_t picture_tag; /* Indexing tag from BUD packets */
uint32_t picture_done_payload;
uint32_t picture_meta_payload;
uint32_t reserved[1];
/* Protocol-specific extensions. */
union
{
PPB_H264 h264;
PPB_MPEG mpeg;
PPB_VC1 vc1;
} other;
} PPB;
typedef struct {
/* Approximate number of pictures in
* the CPB */
uint32_t codein_picture_count;
/* GOP time code */
uint32_t time_code_hours;
uint32_t time_code_minutes;
uint32_t time_code_seconds;
uint32_t time_code_pictures;
uint32_t pic_done_marker_btp_payload;
uint32_t start_decode_time;
uint32_t chan_open_time;
uint32_t chan_close_start_time;
uint32_t chan_close_end_time;
uint32_t first_pic_delivery_time;
uint32_t first_code_in_packet_time;
uint32_t ts_fifo_byte_non_zero_time;
uint32_t ts_video_packet_count_non_zero_time;
} VdecStatusBlock;
#if defined(CHIP_7401A)
/* Display Manager: STC and Parity Information in DRAM for host to use */
typedef struct {
uint32_t stc_snapshot;
uint32_t vsync_parity;
uint32_t vsync_count; /* used only for debug */
} DisplayInfo;
/* Parameters passed from Display Manager (host) to DMS */
typedef struct {
uint32_t write_offset;
uint32_t drop_count;
} DMS_Info;
/* Picture Delivery parameters required by Display Manager */
typedef struct {
uint32_t queue_read_offset; /* offset is w.r.t base of this data struct so value of 0-1 prohibited */
uint32_t queue_write_offset; /* offset is w.r.t base of this data struct so value of 0-1 prohibited */
/* queue if full if (write_offset+1 == read_offset) */
/* write_offset modified by firmware and read_offset modified by Display Manager in host */
PPB* display_elements[62];
} PictureDeliveryQueue;
/* Picture Release parameters returned by Display Manager to firmware */
typedef struct {
uint32_t queue_read_offset; /* offset is w.r.t base of this data struct so value of 0-1 prohibited */
uint32_t queue_write_offset; /* offset is w.r.t base of this data struct so value of 0-1 prohibited */
/* queue if full if (write_offset+1 == read_offset) */
/* read_offset modified by firmware and write_offset modified by Display Manager in host */
PPB* display_elements[62];
} PictureReleaseQueue;
#endif
#pragma pack ()
#endif // __INC_VDEC_INFO_H__
Reference in New Issue View Git Blame Copy Permalink