rmhwlibprop.inc

神龙卡开发原代码

        @li evScartOutput_COMPOSITE
        @li evScartOutput_RGB
        @li evScartOutput_DISABLE
        @remark The default value is evScartOutput_DISABLE 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evScartOutput)
    /** Output Device for video display
        @li evOutputDevice_VGA
        @li evOutputDevice_TV
        @li evOutputDevice_HDTV
        @li evOutputDevice_DigOvOnly
        @remark The default value is evOutputDevice_VGA for analog boards and evOutputDevice_VGATV for digital boards. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evOutputDevice)
    /** TV output format (TV output)
        @li evTvOutputFormat_COMPOSITE
        @li evTvOutputFormat_COMPONENT_YUV
        @li evTvOutputFormat_COMPONENT_RGB
        @li evTvOutputFormat_OUTPUT_OFF
        @li evTvOutputFormat_COMPONENT_RGB_SCART
        @remark The default value is evTvOutputFormat_COMPOSITE. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evTvOutputFormat)
    /** TV standard (TV output)
        @li evTvStandard_NTSC
        @li evTvStandard_PAL
        @li evTvStandard_PAL60
        @li evTvStandard_PALM
        @remark The default value is evTvStandard_NTSC. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evTvStandard)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evBrightness)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evContrast)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evSaturation)
    /** Video input aspect ratio
        @li evInAspectRatio_4x3
        @li evInAspectRatio_16x9
        @remark The default value is evInAspectRatio_4x3. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evInAspectRatio)
    /** Video input standard ( based on frame rate and vertical width )
        @li evInStandard_NTSC
        @li evInStandard_PAL
        @remark The default value is evInStandard_NTSC. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evInStandard)
    /** Video output display option 
        @li evOutDisplayOption_Normal
        @li evOutDisplayOption_16x9to4x3_PanScan
        @li evOutDisplayOption_16x9to4x3_LetterBox
        @li evOutDisplayOption_4x3to16x9_HorzCenter
        @li evOutDisplayOption_4x3to16x9_VertCenter
        @remark The default value is evOutDisplayOption_Normal. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evOutDisplayOption)
    /** Source video window - {0,0, MpegWidth, MpegHeight}
        @remark Default Source window is 720x480
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evSourceWindow)
    /** Zoomed video window - it should be inside the SourceWindow
        @remark Default the Zoomed video window is equal with SourceWindow 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evZoomedWindow)
    /** Maximum  output display resolution
        @remark It depends on the evOutputDevice selected. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evMaxDisplayWindow)
    /** evDestinationWindow
        @remark For full screen get evMaxDisplayWindow and set evDestinationWindow
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evDestinationWindow)
    /** evValidWindow = Video valid window
        @remark The default is evMaxDisplayWindow
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evValidWindow)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evCustomHdtvParams)
    /** Video speed 
        @remark The default value is 0 for normal speed playback
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evSpeed)
    /** evCaptureParams uses evCaptureParams_type to specify: 
        wWidth        = picture width in pixels
        wHeight       = height of frame or field in lines
        wPictureType  = 0 for frame, 1 for field
        dwBufferSize  = size of the buffer to receive the YUV info corresponding to CaptureFormat already set
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evCaptureParams)
    /** evCaptureFormat uses evCaptureFormat_type to specify:
        YUV_FRAME = 0,      // frame, weaved for interlaced content
        YUV_TOP_FIELD,      // top field for interlaced content.
                            // odd lines for progressive content
        YUV_BOTTOM_FIELD,   // bottom field for interlaced content.
                            // even lines for progressive content
        BGR_24BITS_BMP,     // frame, eventually weaved
        PALETTE_INDEX_BMP   // frame, eventually weaved
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evCaptureFormat)
    /** evCaptureFrame has to provide a buffer of dwBufferSize bytes; dwBufferSize should be
    get from evCaptureParams, after setting the evCaptureFormat
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evCaptureFrame)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evUnsupported)
    /** AnalogCable Presence
        @li evAnalogCable_NotConnected
        @li evAnalogCable_Connected
        @remark The default value is evAnalogCable_Connected 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evAnalogCable)
    /** DigitalCable Presence
        @li evDigitalCable_NotConnected
        @li evDigitalCable_Connected
        @remark The default value is evDigitalCable_Connected 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evDigitalCable)
    /** ScartAspectRatio ( TV output )
        @li evScartAspectRatio_Auto
        @li evScartAspectRatio_4x3
        @li evScartAspectRatio_16x9
        @remark The default value is evScartAspectRatio_Auto 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evScartAspectRatio)
    /** Video frame counter gives the number of frames displayed since
        previous video stop.
        @remark The default value after stop is 0.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evFrameCounter)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evYUVWriteParams)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evDisplayFilter)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evUnsupported1)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evDigOvOnlyParams)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVOBUReverseParams)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVOBULastPack)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVOBUReverseSpeed)
    /** @li 1 for BROADCASTED_VIDEO -  the video is streamed and contains I blocks.
        @li 0 for DVD_VIDEO - the video contains complete I frames. 
        @remark The default value is DVD_VIDEO.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evBroadcastedVideo)
    /** @li 1 - displays progressive or interlaced like in the video stream
        @li 0 - displays only progressive if the stream switches very fast from interlaced to progressive
        @remark The default value is 0. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evForcedProgressiveSourceOff)
    /** @li 1 - displays progressive for any video stream
        @li 0 - displays progressive only for movies
        @remark The default value is 0. 
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evForcedProgressiveAlways)
    /** @li 1 - it drops frames when it converts Ntsc clip to PAL TV.
        @li 0 - it drops fields when it converts Ntsc clip to PAL TV.
        @remark The default value is 0.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evNtscPalFrameDrop)
    /** @li 1 - displays only BOB on progressive device output
        @li 0 - displays BOB or WEAVE on progressive device output, depending on stream
        @remark The default value is 0.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evForcedBobDisplayOnOutputDevice)
    /** 4 bits info from video stream
        bit 1,0 = APS= analogue protection system= pseudo sync pulse, inverted split color burst
        bit 3,2 = CGMS= copy generation management system= copyright, copy generation
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evMacrovisionFlags)
    /** 
        Information valid only in video decoding state.
        Index in table defined in Mpeg1/2 standard
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evHwFrameRateIndex)
    /** 
        Information valid only in video decoding state.
        Index in table defined in Mpeg1/2 standard
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evHwAspectRatioIndex)
    /** 
    Is effective during the video PAUSE and STOP status after DICOM_Update flag is set to 1.
    evStreamDefaultAtPause
    evTopFieldAtPause,
    evBottomFieldAtPause,
    evBothFieldsAtPause
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evFieldFrameAtPause)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVideoHwPlay)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVideoHwPause)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVideoHwStop)
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evVideoHwBlackFrame)
    /** evSkippedFramesCounter gives the number of frames skipped since
    previous video play.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evSkippedFramesCounter)
    /** evCGMSWSS property gives completely control to the user to program
    the CGMS data on line 20/283 in NTSC (IEC61880) or
    WSS data on line 22,285 in PAL(ITU-R BT.1119-2).
    CGMS stands for Copy generation Management System data, for NTSC. 
    WSS stands for WideScreeenSignalig data, for PAL.
    According to IEC 61880 there are 3 words of info (total 20 bits):
       WORD0 = 2 bits (aspect ratio = 00,01,10,11 = 4x3,16x9,letterbox,reserved)
       WORD1 = 4 bits (0000, 1111 = WORD2 contains valid info, no info)
       WORD2 = 14 bits (bit 7,8= copyright, bits 9,10 = APS; bit 11=analog source)

    For a simple implementation the mapping from standard to evCGMSWSS settings are:
           +-WORD0-+-WORD1-+-------WORD2------------+-----CRCC------+
    IEC_Bit: 1  2   3 4 5 6  7 8 9 10 11 12 13 14 15  16 17 18 19 20
    CGMSWSS: 0  1   2 3 4 5  6 7 8  9 10 11 12 13 14  15 16 17 18 19 ... 29 30 31,
    where bit29= SoftwareCRC generation and bit31/30= CGMS enabled on odd/even field.
    If bits 31,30,29 are 0 the hardware will generate the CRC and the info
    will be enabled and transmitted on both fields.

    HwLib code already programs some bits from CGMSWSS registers:
     - IEC_Bits 7,8,9,10 - reprogrammed according to evMacrovisionFlags.
    By default all the other bits are 0, the hardware will generate the CRC and
    the data will be enabled and transmitted on both fields.
    If bit 29 is 0 (hardware CRCC) the bits IEC_16..20 (CRCC) will be ignored.

    evCGMSWSS SetProperty can modify any bit, using ResetMask and SetMask.
    The logical operation is:
      CGMSWSS = (CGMSWSS & ~ResetMask) | SetMask.
    It is application responsability to protect or reprogram the bits IEC_Bits 7,8,9,10.

    GetProperty will return the value of CGMSWSS in SetMask.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evCGMSWSS)
    /** evCCEnable permits to enable disable ClosedCaption.
    A value of 0 disables, 1 enables ClosedCaption.
    By default the ClosedCaption is enabled
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evCCEnable)
    /** evPixelClockPolarity.
    0 is active low, 1 active hi.
    By default is active low.
    */
RM_DEFINE_FULL_PROPERTY(HWLIB, VIDEO_SET, evPixelClockPolarity)
    /** evDigitalVideoDataNBits
    It programs how many bits per video clock (VClk) are valid at the
    digital output of the EM8xxx.
    A value of 24 enables the 24 bit digital output, used for DVI output.
    By default the 24 bits are converted to RGB. Only for EM847x-revC and
    EM848x the 24 bits can be converted in YUV444 using evDigitalColorimetry property.
    A value of 8/16 enables YUV422 digital video data on 8 or 16 bits.

    evNBitsDigitalVideoData is used only for SET_TV, SET_HDTV modes, not in
    evOutputDevice_DigOvOnly mode.
    There are some hardware restrictions on EM847X-revA,B - see next table,
    in order to keep the analog output OK.

    Note:
    SD= standard definition = less or equal than 576P = supported only in 8bit by
    the analog output.
    HD= high definition = greater than 576P = supported only in 16bit by the
    analog output.

                   +-------------------------------+----------------------------+
                   |         SET_TV                |          SET_HDTV          |
    +--------------+-------------------------------+----------------------------+
    | Disp |evNBits| 847X-revAB |848X,847X-revC    | 847X-revAB |848X,847X-revC |
    +      |Digital+---------------+---------------+------------+---------------+
    | mode | Video | Anlg.  | Dig. | Anlg. | Dig.  | Anlg.| Dig.| Anlg. |  Dig. |
    +------+-------+---------------+-------+-------+------------+-------+-------+
    |      |   8   | OK 8   |  8   |       |   8   |      |  8  |       |   8   |
    |      +-------+---------------+       +-------+      |-----+       +-------+
    |  SD  |  16   |Disabled|  16  | OK  8 |  16   | OK 8 |  8  | OK  8 |  16   |
    |      +-------+---------------+       +-------+      |-----+       +-------+
    |      |  24   |Disabled|  24  |       |  24   |      |24rgb|       |  24   |
    |      |       |        | rgb  |       |rgb/yuv|      |2xclk|       |rgb/yuv|
    +------+-------+--------+------+-------+-------+------+-----+-------+-------+
    |      |   8   |  -     |  -   |  -    |   -   |      | 16  |       |  16   |
    |      +-------+---------------+-------+-------+      |-----+       +-------+
    |  HD  |  16   |  -     |  -   |  -    |   -   | OK 16| 16  | OK 16 |  16   |
    |      +-------+---------------+-------+-------+      |-----+       +-------+
    |      |  24   |  -     |  -   |  -    |   -   |      | 24  |       |  24   |
    |      |       |        |      |       |       |      | rgb |       |rgb/yuv|
    +------+-------+--------+------+-------+-------+------+-----+-------+-------+

    In evOutputDevice_DigOvOnly mode the evNBitsDigitalVideoData property is
    ignored. The "BitsPerClock" member in evDigOvOnlyParams_type structure will
    be used. In evOutputDevice_DigOvOnly mode it is the responsability of user
    to enable or disable the analog output. Eg. In this mode we can force the 
    SD 480P in 16bits, and the digital output will be OK but the analog output
    should be disabled.

    By default evNBitsDigitalVideoData (8 or 16) corresponds to eVmi_16bits (0 or 1).
   */