dvb_av.h

DVB软件,基于CT216软件的开发源程序.

\brief Setting the IFrame screen position.
\param enIframe_mode (Input) The iframe show mode
\param u16PosX (Input) the position of X
\param u16PoxY (Input) the position of Y
\return TRUE - success
\return FALSE - fail
*/

void DVB_IFrameHide (void);
/*! \fn void DVB_IFrameHide (void)
\brief Hide the IFrame.
*/

void DVB_AudioSetPID (u16 u16AudPID);
/*! \fn void DVB_AudioSetPID (u16 u16AudPID)
\brief Setting the audio PID.
\param u16AudPID (Input) the audio PID.
*/

u16 DVB_AudioGetPID (void);
/*! \fn u16 DVB_AudioGetPID (void)
\brief Get the audio PID. If the return is 0 or 0x2000, the audio PID is disabled.
\return the audio PID.
*/


void DVB_AudioSetMute (bool8 b8Mute);
/*! \fn void DVB_AudioSetMute (bool8 b8Mute)
\brief Mute or unmute the audio output.
\param b8Mute (Input) Mute or not.
*/

bool8 DVB_AudioGetMute (void);
/*! \fn bool8 DVB_AudioGetMute (void)
\brief Get mute or unmute the audio output.
\return TRUE - the audio is muted.
\return FALSE - the audio isn't muted.
*/

void DVB_SetService(u8 u8ServiceType, u16 u16SrvIdx);
/*! \fn void DVB_SetVolumeToService(EN_SERVICE_TYPE enServiceType, u16 u16SrvIdx, u8 u8Volume)
\brief Set volume to service.
\param enServiceType (Input) This is service type. TV: 0 Radio: 1
\param u16SrvIdx (Input) This is channel number.
*/

void DVB_AudioSetVolume(u8 u8Volume);
/*! \fn void DVB_AudioSetVolume(u8 u8Volume)
\brief Set volume output level.
\param u8Volume (Input) This is volume level. If this value is 0, the volume is muted.
The maximum number is MAX_VOLUME_LEVEL.
*/

u8 DVB_AudioGetVolume(void);
/*! \fn u8 DVB_AudioGetVolume(void)
\brief Get volume output level.
\return This is volume level. If this value is 0, the volume is muted.
The maximum number is MAX_VOLUME_LEVEL.
*/

void DVB_AudioMode(EN_AUD_MODE enAudMode);
/*! \fn void DVB_AudioMode(EN_AUD_MODE enAudMode)
\brief Setting audio output mode is stereo or others.
\param enAudMode (Input) the audio output mode
*/

void DVB_AudioVideoPlay(void);
/*! \fn void DVB_AudioVideoPlay(void)
\brief Start decode the audio and video stream.
*/

void DVB_AudioVideoStop(void);
/*! \fn void DVB_AudioVideoStop(void)
\brief Stop the video and audio decoder.
The video shows black screen. The audio is muted.
*/

void DVB_AudioVideoPause(bool8 b8Pause);
/*! \fn void DVB_AudioVideoPause(bool8 b8Pause)
\brief Pause the video and mute audio.
\param b8Pause (Input) TRUE - pause.
*/

bool8 DVB_GetAudioVideoPause(void);
/*! \fn bool8 DVB_GetAudioVideoPause(void)
\brief Get the pause status of video and audio.
\return TURE- pause
*/

EN_STREAM_TYPE DVB_GetStreamType(void);
/*! \fn EN_STREAM_TYPE DVB_GetStreamType()
\brief Get the stream type in decoder.
\return Stream type.
*/

EN_VID_MODE DVB_GetTVSystem(void);
/*! \fn EN_VID_MODE DVB_GetTVSystem(void)
\brief Get current TV system type.
\return TV system type.
*/

void DVB_SetTVSystem (EN_VID_MODE enVidMode);
/*! \fn void DVB_SetTVSystem (EN_VID_MODE enVidMode)
\brief Setting the base band video output format.
\param enVidMode (Input) the base band video type
*/

bool8 DVB_SetVideoFormat_AutoMode (EN_VID_FIELD_FREQ enFreq, EN_VID_MODE enVidMode);
/*! \fn bool8 DVB_SetVideoFormat_AutoMode (EN_VID_FIELD_FREQ enFreq, EN_VID_MODE enVidMode)
\brief Setting the base band video output format on auto mode.
\default : EN_VID_FIELD_FREQ_50HZ = EN_VID_MODE_PAL, EN_VID_FIELD_FREQ_60HZ = EN_VID_MODE_NTSC
\param enFreq (Input) the base band video format frequency
\param enVidMode (Input) the base band video type
\return TRUE - success
\return FALSE - fail
*/


EN_VID_MODE DVB_GetSetupVideoMode(void);
/*! \fn EN_VID_MODE DVB_GetTVSystem(void)
\brief Get Setup TV system type.
\return TV system type.
*/

EN_VID_MODE DVB_GetLiftVideoMode(void);
/*! \fn EN_VID_MODE DVB_GetLiftVideoMode(void)
\brief Get Lift Bistream TV system type. The EN_VID_MODE_AUTO will be replay by EN_VID_MODE_PAL or EN_VID_MODE_NTSC
\return TV system type.
*/

void DVB_VideoScreenEnable (bool8 b8Enable);
/*! \fn void DVB_VideoScreenEnable (bool8 b8Enable)
\brief Setup the video screen show or hidden flag.
\param b8Enable (Input) TURE - enable, FALSE - disable
*/

bool8 DVB_GetVideoScreenEnable (void);
/*! \fn bool8 DVB_GetVideoScreenEnable (void)
\brief Get the video screen show or hidden flag.
\return TURE - enable
\return FALSE - disable
*/

void DVB_VideoScreenShow (bool8 b8Show);
/*! \fn void DVB_VideoScreenShow (bool8 b8Show)
\brief Show or hidden the video screen.  This function is depend
the DVB_VideoScreenEnable() setting.
\param b8Show (Input) TURE - enable, FALSE - disable
*/

void DVB_TVScreenEnable (bool8 b8Enable);
/*! \fn void DVB_TVScreenEnable (bool8 b8Enable)
\brief Setup the video and OSD screen.
\param b8Enable (Input) TURE - enable, FALSE - disable
*/

void DVB_AVDemuxEnable(void);
/*! \fn void DVB_AVDemuxEnable(void)
\brief Enable the AV demux.
*/

void DVB_AVDemuxDisable(void);
/*! \fn void DVB_AVDemuxDisable(void)
\brief Disable the AV demux.
*/

u8 DVB_GetAudioFreq(void);
/*! \fn u8 DVB_GetAudioFreq(void)
\brief get audio sample frequency
\return sample frequency.
\verbatim
            0  =    AUDIO_FREQ_16K
            1  =    AUDIO_FREQ_32K
            2  =    AUDIO_FREQ_64K
            3  =    AUDIO_FREQ_24K
            4  =    AUDIO_FREQ_48K
            5  =    AUDIO_FREQ_96K
            6  =    AUDIO_FREQ_22K
            7  =    AUDIO_FREQ_44K
            8  =    AUDIO_FREQ_88K
\endverbatim
*/

void DVB_SetAudioFreq(u8 u8Freq);
/*! \fn void DVB_SetAudioFreq(u8 u8Freq)
\brief set audio sample frequency
\param u8Freq (Input) audio sample frequency
\verbatim
            0  =    AUDIO_FREQ_16K
            1  =    AUDIO_FREQ_32K
            2  =    AUDIO_FREQ_64K
            3  =    AUDIO_FREQ_24K
            4  =    AUDIO_FREQ_48K
            5  =    AUDIO_FREQ_96K
            6  =    AUDIO_FREQ_22K
            7  =    AUDIO_FREQ_44K
            8  =    AUDIO_FREQ_88K
\endverbatim
*/

EN_VID_DISPLAY DVB_GetVideoDAR(void);
/*! \fn EN_VID_DISPLAY DVB_GetVideoDAR(void)
\brief get display aspect ratio of video content.
\return display type.
*/

void DVB_NIM_Reset(bool8 b8num);
/*! \fn void DVB_NIM_Reset(bool8 b8num)
\brief select as TRUE or FALSE.
\param b8num (Input).
*/

void DVB_Select_Source(EN_DVB_NIM_ID enNIM);
/*! \fn void DVB_Select_Source(EN_DVB_NIM_ID enNIM)
\brief select NIM ID as 0 or 1.
\param enNIM (Input) see EN_DVB_NIM_ID.
*/

void DVB_SetTvType(EN_VID_DISPLAY enType);
/*! \fn void DVB_SetTvType(EN_VID_DISPLAY enType)
\brief set TV type as 16:9 or 4:3.
\param enType (Input) see EN_VID_DISPLAY.
*/

EN_VID_DISPLAY DVB_GetTvType(void);
/*! \fn EN_VID_DISPLAY DVB_GetTvType(void)
\brief get TV type as 16:9 or 4:3.
\return see EN_VID_DISPLAY.
*/

void DVB_SetAspectRatio( EN_RATIO_TYPE enType );
/*! \fn void DVB_SetAspectRatio( EN_RATIO_TYPE enType )
\brief set display aspect ratio, this function only work after DVB_MonitorVideoDAR(TRUE). Otherwise just save user setting
\param enType (Input) see EN_RATIO_TYPE.
*/

EN_RATIO_TYPE DVB_GetAspectRatio( void );
/*! \fn EN_RATIO_TYPE DVB_GetAspectRatio( void )
\brief get display aspect ratio.
\return see  EN_RATIO_TYPE.
*/

void DVB_SetVideoFormat( EN_VID_FORMAT enVideoFormat );
/*! \fn void DVB_SetVideoFormat( EN_VID_FORMAT enVideoFormat )
\brief setup video output format.
\param enVideoFormat (Input) see EN_VID_FORMAT.
*/

EN_VID_FORMAT DVB_GetVideoFormat(void);
/*! \fn EN_VID_FORMAT DVB_GetVideoFormat(void)
\brief Get video output format.
\return see EN_VID_FORMAT.
*/

void DVB_BackgroundDisplay(bool8 b8Display);
/*! \fn void DVB_BackgroundDisplay(bool8 b8Display)
\brief setting background display model.
\param b8Display (Input) true/false.
*/

void DVB_VideoWeight(u8 u8Value);
/*! \fn void DVB_VideoWeight(u8 u8Value)
\brief setting weight of vedio and background between.
\param u8Value (Input) 0-15 weight. 0: transparent
*/

u8 DVB_GetVideoWeight(void);
/*! \fn u8 DVB_GetVideoWeight(void)
\brief get the weight of vedio and background between.
\return 0-15 weight. 0: transparent
*/

void DVB_SetFirstScreenType(EN_FIRST_SCR_TYPE en1stScrType);
/*! \fn void DVB_SetFirstScreenType(EN_FIRST_SCR_TYPE en1stScrType)
\brief Setting the first video display style.
\param en1stScrType (Input) see EN_FIRST_SCR_TYPE.
*/
/* 	This function not just effects when to turn on video but also audio */
/* 				Strategy for Audio(Volume) Turn On					*/
/* EN_FIRST_SCR_TYPE_I_FRAME: ALWAYS Turn On Audio in Freq Task		*/
/* EN_FIRST_SCR_TYPE_AV_SYNC: IF TV, Turn On Audio While AV SYNC	*/
/* EN_FIRST_SCR_TYPE_AV_SYNC: IF Radio, Turn On Audio in Freq Task	*/


EN_FIRST_SCR_TYPE DVB_GetFirstScreenType(void);
/*! \fn EN_FIRST_SCR_TYPE DVB_GetFirstScreenType(void)
\brief Get the first video display style.
\return see EN_FIRST_SCR_TYPE.
*/


bool8 DVB_VideoPositionAnime (EN_VID_SCALING enScaling_type, u16 u16PosX, u16 u16PosY);
/*! \fn bool8 DVB_VideoPositionAnime (EN_VID_SCALING enScaling_type, u16 u16PosX, u16 u16PosY)
\brief Setting the video screen position, and the video screen will gradully change , like anime
\param enScaling_type (Input) the video scale type
\param u16PosX (Input) the position of X
\param u16PoxY (Input) the position of Y
\return TRUE - success
\return FALSE - fail
*/


void DVB_SetCCIR656Params(u16 u16HDS, u16 u16HDW);
/*! \fn void DVB_SetCCIR656Params(u16 u16HDS, u16 u16HDW)
\brief Setting the CCIR656 video screen horizontal start position, and the CCIR656 video screen width
\param u16HDS (Input) the horizontal start position of CCIR656 video screen
\param u16HDW (Input) the width of CCIR656 video screen
*/

void DVB_SetCCIR601Status(bool8 b8Enable);
/*! \fn void DVB_SetCCIR601Status(bool8 b8Enable)
\brief Enabled the CCIR601 processing or not.
\param b8Enable (Input) TRUE for enabled CCIR601, FALSE for disabled.
*/

void DVB_SetCCIR656Status(bool8 b8Enable);
/*! \fn void DVB_SetCCIR656Status(bool8 b8Enable)
\brief Enabled the CCIR656 processing or not.
\param b8Enable (Input) TRUE for enabled CCIR656, FALSE for disabled.
*/

void DVB_VideoErrorRatioSet(u8 u8ErrorRatio);
/*! \fn void DVB_VideoErrorRatioSet(u8 u8ErrorRatio)
\brief Set decoding error ratio.
\param u8ErrorRatio (Input) set decoding error ratio from 0 to 100.
*/

void DVB_VideoErrorFreezeSet(bool8 b8Enable);
/*! \fn void DVB_VideoErrorFreezeSet(bool8 b8Enable)
\brief Enable video freeze when decoding error.
\param b8Enable (Input) enable this function or not. TRUE: enable, FALSE: disable. default is disable.
*/

bool8 DVB_VideoErrorFreezeGet(void);
/*! \fn bool8 DVB_VideoErrorFreezeGet(void)
\brief Get video with error freeze status.
\return TRUE: video with error freeze is enable
\return FALSE: video with error freeze is disable
*/

EN_TS_TYPE DVB_CheckStreamTSType(u16 u16PID);
/*! \fn EN_TS_TYPE DVB_CheckStreamTSType(u16 u16PID)
\brief check stream type of playing AV.
\param u16PID (Input) which pid stream shoule be checked, don't care it when define section filter.
\return EN_TS_TYPE reference define.
*/


void DVB_ProgramDACACLKInput(void);
/*! \fn void DVB_ProgramDACACLKInput(void)
\brief This function must be called by DVB_ProgramDACACLKInput(), It will Seup audio DAC ACCR Input.
*/

void DVB_ProgramAudioDAC(void);
/*! \fn void DVB_ProgramAudioDAC(void)
\brief This function must be called by DVB_ProgramDACACLKInput() and can, It will Seup the Audio DAC and will be called by system.
*/


bool8 DVB_GetProgressScanStatus(void);
/*! \fn bool8 DVB_GetProgressScanStatus(void)
\brief Get Progress Scan status. This function is for TV Encoder Setting.
\return TRUE: Progress Scan is enable
\return FALSE: Progress Scan is disable
*/

bool8 DVB_GetCCIR601Status(void);
/*! \fn bool8 DVB_GetCCIR601Status(void)
\brief Get CCIR601 status. This function is for TV Encoder Setting.
\return TRUE: CCIR601 is enable
\return FALSE: CCIR601 is disable
*/

bool8 DVB_GetCCIR656Status(void);
/*! \fn bool8 DVB_GetCCIR656Status(void)
\brief Get CCIR656 status. This function is for TV Encoder Setting.
\return TRUE: CCIR656 is enable
\return FALSE: CCIR656 is disable
*/

void DVB_SetCCIR601Status( bool8 b8Enable );
/*! \fn void DVB_SetCCIR601Status( bool8 b8Enable )
\brief Set CCIR656 status. This function is for TV Encoder Setting.
\param b8Enable (Input) TRUE is enable CCIR601, FALSE is disable CCIR656.
*/

void DVB_SetCCIR656Status( bool8 b8Enable );
/*! \fn void DVB_SetCCIR656Status( bool8 b8Enable )
\brief Set CCIR656 status. This function is for TV Encoder Setting.
\param b8Enable (Input) TRUE is enable CCIR656, FALSE is disable CCIR656.
*/

EN_TVE_OUTPUT_MODE DVB_GetTVEOutputMode(void);
/*! \fn EN_VID_MODE DVB_GetTVSystem(void)
\brief Get current TVE output mode.
\return TVE output mode.
*/

void DVB_TVESetMode(void);
/*! \fn void DVB_ProgramAudioDAC(void)
\brief Setup TVE register by EN_VID_FORMAT.
*/

void DVB_TVEDisable(void);
/*! \fn void DVB_ProgramAudioDAC(void)
\brief disable TVE output.
*/

EN_VID_SCALING DVB_GetVideoScalingType(void);
/*! \fn EN_VID_SCALING DVB_GetVideoScalingType(void)
\brief Get current Video Scaling Type.
\return EN_VID_SCALING: Video Scaling Type
*/

// Instant Replay
EN_TSSTRM_INIT_STATUS DVB_InstantReplayInit(u32 u32BufferSize, EN_CTOS_TASK_PRIORITY enPriority, u32 u32TimeSlice);
/*! \fn EN_TSSTRM_INIT_STATUS DVB_InstantReplayInit(u32 u32BufferSize, EN_CTOS_TASK_PRIORITY enPriority, u32 u32TimeSlice)
\brief Initialize of Instant Replay function.
\param u32BufferSize (Input) bytes of assign data
\param enPriority (Input) Specifies a priority value between 0 and 15.
\param u32TimeSlice (Input) Indicates the maximum amount of timer ticks that can expire while executing this task
\return EN_TSSTRM_INIT_STATUS