mv_dec.h

tuner扫描

   void
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_set_sync_mode

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Select the video decoder synchronisation mode.
    4 different synchronisation mode can be choosen :

    MV_DEC_SYNC_MODE_DTS_LOCKED
    - Decoding of each picture is done when the corresponding DTS value
    matches the STC value.

    MV_DEC_SYNC_MODE_DTS_FREE_RUNNING
    - Decoding of the first picture is done when the corresponding DTS
    value matches the STC value. Consecutive pictures are decoded
    without further checks.

    MV_DEC_SYNC_MODE_BUF_CONTROLLED
    - In the buffer controlled play mode, decoding of pictures is started
    when the video input buffer fullness reaches the video input buffer
    overflow warning level.
    The video input buffer overflow and underflow levels can
    be configured using MV_INP_set_warning_levels() API.

    MV_DEC_SYNC_MODE_SW_CONTROLLED
    - In the software controlled play mode, decoding of pictures is started
    when the MV_DEC_play() API is called.

    Initially the play sync is MV_DEC_SYNC_MODE_DTS_LOCKED.
    
    Changing the video play mode takes effect the next time MV_DEC_play is
    called if it's the first time or if video decoder is stopped,
    otherwise if MV_DEC_play has been already called (video decoder is still
    running) synchronisation mode will be changed on the fly.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None
    
    CALLING SEQUENCE:
*/
extern void
MV_DEC_set_sync_mode(    
   MV_DEC_SYNC_MODE in_sync_mode         /* In: New video sync mode           */
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_freeze

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Freeze on the next decoded picture.

    Freeze modes can be :
    
    - MV_DEC_FREEZE_MODE_B : The displays freezes on the next correctly
                             decoded B picture
    - MV_DEC_FREEZE_MODE_IP : The displays freezes on the next correctly
                              decoded I or P picture
    - MV_DEC_FREEZE_MODE_NONE : Freeze mode is desactivated
                                  
    Normal decoding and display can be resumed by calling MV_DEC_play() API.

    NOTES:
    MV_DEC_freeze() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    Video Decoder is in state MV_DEC_DECODING_STATE_FREEZING
    
    CALLING SEQUENCE:
    */
extern void
MV_DEC_freeze(    
   MV_DEC_FREEZE_MODE in_freeze_mode /* In: The desired freeze mode */
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_play

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Launch the video decoding process.

    PRECONDITIONS:
    Before calling this API, application must have called
    MV_DEC_set_sync_mode().

    POSTCONDITIONS:
    Video Decoder is in state MV_DEC_DECODING_STATE_STARTING. It will
    change to MV_DEC_DECODING_STATE_STARTED once the first picture is
    decoded
    
    CALLING SEQUENCE:

*/
extern void
MV_DEC_play(    
   void
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_stop

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Freeze on the next decoded picture and stop decoding video data from
    the video input buffer.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    Video Decoder is in state MV_DEC_DECODING_STATE_STOPPED.

    CALLING SEQUENCE:
*/
extern void 
MV_DEC_stop(    
   void
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_scan

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Decode and display only the I or the I&P pictures.

    When the play mode requires waiting for the system time counter to
    reach the video decoding time stamp (DTS), or for the video input
    buffer contents to reach the over level, this is done asynchronously.
    This function returns immediately.

    Scan modes can be :
    
    - MV_DEC_SCAN_MODE_I_PICTURE : Decode and display only I pictures
    
    - MV_DEC_SCAN_MODE_IP_PICTURE : Decode and display only I and P
    pictures
    
    - MV_DEC_SCAN_MODE_NONE : Scan mode is desactivated
                                  
    Normal decoding and display can be resumed by calling MV_DEC_play() API.

    NOTES:
    MV_DEC_scan() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    Video Decoder is in state MV_DEC_DECODING_STATE_SCANNING
    
    CALLING SEQUENCE:
*/
extern void
MV_DEC_scan(    
   MV_DEC_SCAN_MODE in_scan_mode
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_step

    PACKAGE:           MV_DEC
 
    SCOPE:             PLATFORM

    DESCRIPTION:
    Perform a single step and display the next picture of the type
    selected with the step mode.

    - MV_DEC_STEP_MODE_I : Decode and display the next I picture
    from the input stream.

    - MV_DEC_STEP_MODE_IP : Decode and display the next I or P
    picture from the input stream.

    - MV_DEC_STEP_MODE_IPB : Decode and display the next I or P
    or B picture from the input stream.

    - MV_DEC_STEP_MODE_NONE : Step mode is desactivated

    The decoding process is stopped when the next picture is decoded.
    The data in the video input buffer is NOT discarded.
    So stepping should only be used when the incoming datastream is under
    application control. 

    Normal decoding and display can be resumed by calling MV_DEC_play() API.
    
    NOTES:
    MV_DEC_step() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    Video Decoder is in state MV_DEC_DECODING_STATE_STEPPING
    
    CALLING SEQUENCE:
*/
extern void                   
MV_DEC_step(    
   MV_DEC_STEP_MODE in_step_mode);
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_set_dts

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM
    
    DESCRIPTION:
    Sets a decoding time stamp (DTS) for the video decoder.

    NOTE:
    Only the last 24 bits of DTS will be loaded.
    MV_DEC_set_dts() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:
*/
void                              /* Returns: <description> */
extern MV_DEC_set_dts(    
   MV_DEC_DTS in_dts
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_set_stc

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Load immediately a new system time clock (STC) into the video decoder.

    NOTE:
    Only the last 24 bits of STC will be loaded.

    NOTES:
    MV_DEC_get_picture_info() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:
*/
extern void
MV_DEC_set_stc(    
   MV_DEC_STC in_stc);
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_get_stc

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    retrieve the system time clock (STC) use by the video decoder.

    NOTE:
    The STC retrieved will be given on 24 bits.
    MV_DEC_get_stc() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:
*/
extern void                              /* Returns: <description> */
MV_DEC_get_stc(    
   MV_DEC_STC * ou_stc_ptr);
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_discontinuity

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Prepare handling of discontinuity by video decoder.
    This function must be called by the application when the MSP finds a
    new PCR in the video data stream.

    NOTE:
    The PCR must be given on 24 bits.
    MV_DEC_discontinuity() can be call in an ISR.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:
*/
extern void                              /* Returns: <description> */
MV_DEC_discontinuity(    
   MV_DEC_STC in_new_pcr);
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_decode_picture_in_picture

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Decode a still picture while video is decoding a stream.
    Decoding of this picture is possible by skipping a B picture
    in the mpeg video stream.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:
*/
extern void
MV_DEC_decode_picture_in_picture(    
unsigned long in_still_pict_y_odd_addr,
unsigned long in_still_pict_y_even_addr,
unsigned long in_still_pict_c_odd_addr,
unsigned long in_still_pict_c_even_addr
);
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_set_pip_mode

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Prepare decoding of a still picture while video is decoding
    a stream.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:    
    */
extern void
MV_DEC_set_pip_mode(    
   MV_DEC_PIP_MODE in_pip_mode
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_set_low_delay_mode

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Prepare decoding of a still picture in low delay mode, which mean that
    each time a picture is decoded (in 2 or more Vs) each time it is
    displayed.

    PRECONDITIONS:
    None

    POSTCONDITIONS:
    None

    CALLING SEQUENCE:    
    */
extern void
MV_DEC_set_low_delay_mode(    
   MV_DEC_LOW_DELAY_MODE in_low_delay_mode
   );
/*EMP=======================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_soft_reset

    PACKAGE:           MV_DEC

    SCOPE:             PLATFORM

    DESCRIPTION:
    Performs a software reset of the video decoder core.

    PRECONDITIONS:
    None

    POSTCONDITIONS: