328 lines
14 KiB
C
328 lines
14 KiB
C
|
/****************************************************************************
|
||
|
|
* @doc INTERNAL TAPIH26X
|
||
|
|
*
|
||
|
|
* @module TAPIH26X.h | Header file for the supported compressed input formats.
|
||
|
|
***************************************************************************/
|
||
|
|
|
||
|
|
#ifndef _TAPIH26X_H_
|
||
|
|
#define _TAPIH26X_H_
|
||
|
|
|
||
|
|
//#define USE_OLD_FORMAT_DEFINITION 1
|
||
|
|
|
||
|
|
// RTP-packetized video subtypes
|
||
|
|
#define STATIC_MEDIASUBTYPE_R263_V1 0x33363252L, 0x0000, 0x0010, 0x80, 0x00, 0x00, 0xAA, 0x00, 0x38, 0x9B, 0x71
|
||
|
|
#define STATIC_MEDIASUBTYPE_R261 0x31363252L, 0x0000, 0x0010, 0x80, 0x00, 0x00, 0xAA, 0x00, 0x38, 0x9B, 0x71
|
||
|
|
|
||
|
|
// H.26x specific structures
|
||
|
|
/*****************************************************************************
|
||
|
|
* @doc INTERNAL TAPIH26XSTRUCTENUM
|
||
|
|
*
|
||
|
|
* @struct BITMAPINFOHEADER_H263 | The <t BITMAPINFOHEADER_H263> structure
|
||
|
|
* is used to specify the details of the H.263 video format.
|
||
|
|
*
|
||
|
|
* @field BITMAPINFOHEADER | bmi | Specifies a well-known GDI bitmap info
|
||
|
|
* header structure.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwMaxBitrate | Specifies the maximum bit rate in units of
|
||
|
|
* 100 bits/s at which the receiver can receive video. This value is valid
|
||
|
|
* between 1 and 192400.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwBppMaxKb | Specifies the maximum number of bits for one
|
||
|
|
* coded picture that the receiver can receive and decode correctly, and is
|
||
|
|
* measured in units of 1024 bits. This value is valid between 0 and 65535.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwHRD_B | Specifies the Hypothetical Reference Decoder
|
||
|
|
* parameter B as described in Annex B of H.263. This value is valid
|
||
|
|
* between 0 and 524287.
|
||
|
|
*
|
||
|
|
* @field DWORD | fUnrestrictedVector:1 | Specifies that the receiver can
|
||
|
|
* receive video data using the unrestricted motion vectors mode as defined
|
||
|
|
* in Annex D of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fArithmeticCoding:1| Specifies that the receiver can receive
|
||
|
|
* video data using the syntax based arithmetic coding mode as defined in
|
||
|
|
* Annex E of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fAdvancedPrediction:1 | Specifies that the receiver can
|
||
|
|
* receive video data using the advanced prediction mode as defined in Annex
|
||
|
|
* F of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fPBFrames:1 | Specifies that the receiver can receive video
|
||
|
|
* data using the PB-frames mode as defined in Annex G of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fErrorCompensation:1 | Specifies that the receiver can
|
||
|
|
* identify MBs received with transmission errors, treat them as not coded,
|
||
|
|
* and send appropriate videoNotDecodedMBs indications.
|
||
|
|
*
|
||
|
|
* @field DWORD | fAdvancedIntraCodingMode:1 | Specifies that the receiver can
|
||
|
|
* receive video data using the advanced INTRA coding mode as defined in
|
||
|
|
* Annex I of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fDeblockingFilterMode:1 | Specifies that the receiver can
|
||
|
|
* receive video data using the deblocking filter mode as defined in Annex J
|
||
|
|
* of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fImprovedPBFrameMode:1 | Specifies that the receiver can
|
||
|
|
* receive video data using the improved PB-frames mode as defined in Annex
|
||
|
|
* M of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fUnlimitedMotionVectors:1 | Specifies that the receiver can
|
||
|
|
* receive video data using the unrestricted motion vector range when
|
||
|
|
* unrestricted motion vector mode as defined in Annex D of H.263 is also
|
||
|
|
* indicated.
|
||
|
|
*
|
||
|
|
* @field DWORD | fFullPictureFreeze:1 | Specifies that the receiver can receive
|
||
|
|
* Full Picture Freeze commands as described in Annex L of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fPartialPictureFreezeAndRelease:1 | Specifies that the
|
||
|
|
* receiver can receive the Resizing Partial Picture Freeze and Release
|
||
|
|
* commands as described in Annex L of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fResizingPartPicFreezeAndRelease:1 | Specifies that the
|
||
|
|
* receiver can receive the Resizing Partial Picture Freeze and Release
|
||
|
|
* commands as described in Annex L of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fFullPictureSnapshot:1 | Specifies that the receiver can
|
||
|
|
* receive Full Picture snapshots of the video content as described in Annex L
|
||
|
|
* of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fPartialPictureSnapshot:1 | Specifies that the receiver can
|
||
|
|
* receive Partial Picture Snapshots of the video content as described in
|
||
|
|
* Annex L of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fVideoSegmentTagging:1 | Specifies that the receiver can
|
||
|
|
* receive Video Segment tagging for the video content as described in Annex L
|
||
|
|
* of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fProgressiveRefinement:1 | Specifies that the receiver can
|
||
|
|
* receive Progressive Refinement tagging as described in Annex L of H.263. In
|
||
|
|
* addition, when true, the encoder shall respond to the progressive refinement
|
||
|
|
* miscellaneous commands doOneProgression, doContinuousProgressions,
|
||
|
|
* doOneIndependentProgression, doContinuousIndependentProgressions,
|
||
|
|
* progressiveRefinementAbortOne, and progressiveRefinementAbortContinuous. In
|
||
|
|
* addition, the encoder shall insert the Progressive Refinement Segment Start
|
||
|
|
* Tags and the Progressive Refinement Segment End Tags as defined in the
|
||
|
|
* Supplemental Enhancement Information Specification (Annex L) of
|
||
|
|
* Recommendation H.263. Note, Progressive Refinement tagging can be sent by an
|
||
|
|
* encoder and received by a decoder even when not commanded in a miscellaneous
|
||
|
|
* command.
|
||
|
|
*
|
||
|
|
* @field DWORD | fDynamicPictureResizingByFour:1 | Specifies that the receiver
|
||
|
|
* supports the picture resizing-by-four (with clipping) submode of the
|
||
|
|
* implicit Reference Picture Resampling Mode (Annex P) of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fDynamicPictureResizingSixteenthPel:1 | Specifies that the
|
||
|
|
* receiver supports resizing a reference picture to any width and height using
|
||
|
|
* the implicit Reference Picture Resampling mode (Annex P) of H.263 (with
|
||
|
|
* clipping). If DynamicPictureResizingSixteenthPel is true then
|
||
|
|
* DynamicPictureResizingByFour shall be true.
|
||
|
|
*
|
||
|
|
* @field DWORD | fDynamicWarpingHalfPel:1 | Specifies that the receiver supports
|
||
|
|
* the arbitrary picture warping operation within the Reference Picture
|
||
|
|
* Resampling mode (Annex P) of H.263 (with any fill mode) using half-pixel
|
||
|
|
* accuracy warping.
|
||
|
|
*
|
||
|
|
* @field DWORD | fDynamicWarpingSixteenthPel:1 | Specifies that the receiver
|
||
|
|
* supports the arbitrary picture warping operation within the Reference Picture
|
||
|
|
* Resampling mode (Annex P) of H.263 (with any fill mode) using either
|
||
|
|
* half-pixel or sixteenth pixel accuracy warping.
|
||
|
|
*
|
||
|
|
* @field DWORD | fIndependentSegmentDecoding:1 | Specifies that the receiver
|
||
|
|
* supports the Independent Segment Decoding Mode (H.263 Annex R) of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fSlicesInOrder_NonRect:1 | Specifies that the receiver supports
|
||
|
|
* the submode of Slice Structured Mode (H.263 Annex K) where slices are
|
||
|
|
* transmitted in order and contain macroblocks in scanning order of the
|
||
|
|
* picture.
|
||
|
|
*
|
||
|
|
* @field DWORD | fSlicesInOrder_Rect:1 | Specifies that the receiver supports
|
||
|
|
* the submode of Slice Structured Mode (H.263 Annex K) where slices are
|
||
|
|
* transmitted in order and the slice occupies a rectangular region of the
|
||
|
|
* picture.
|
||
|
|
*
|
||
|
|
* @field DWORD | fSlicesNoOrder_NonRect:1 | Specifies that the receiver
|
||
|
|
* supports the submode of Slice Structured Mode (H.263 Annex K) where
|
||
|
|
* slices contain macroblocks in scanning order of the picture and need
|
||
|
|
* not be transmitted in order.
|
||
|
|
*
|
||
|
|
* @field DWORD | fSlicesNoOrder_Rect:1 | Specifies that the receiver
|
||
|
|
* supports the submode of Slice Structured Mode (H.263 Annex K) where
|
||
|
|
* slices occupy a rectangular region of the picture and need not be
|
||
|
|
* transmitted in order.
|
||
|
|
*
|
||
|
|
* @field DWORD | fAlternateInterVLCMode:1 | Specifies that the receiver
|
||
|
|
* can receive video data using the alternate inter VLC mode as defined
|
||
|
|
* in Annex S of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fModifiedQuantizationMode:1 | Specifies that the receiver
|
||
|
|
* can receive video data using the modified quantization mode as defined
|
||
|
|
* in Annex T of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fReducedResolutionUpdate:1 | Specifies that the receiver
|
||
|
|
* can receive video data using the reduced resolution update mode as
|
||
|
|
* defined in Annex Q of H.263.
|
||
|
|
*
|
||
|
|
* @field DWORD | fReserved:4 | Reserved. Shall be set to 0.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwReserved[4] | Reserved. Shall all be set to 0.
|
||
|
|
***************************************************************************/
|
||
|
|
|
||
|
|
#define MAX_BITRATE_H263 (192400)
|
||
|
|
|
||
|
|
typedef struct tagBITMAPINFOHEADER_H263
|
||
|
|
{
|
||
|
|
// Generic bitmap info header fields
|
||
|
|
BITMAPINFOHEADER bmi;
|
||
|
|
|
||
|
|
#ifndef USE_OLD_FORMAT_DEFINITION
|
||
|
|
// H.263 specific fields
|
||
|
|
DWORD dwMaxBitrate;
|
||
|
|
DWORD dwBppMaxKb;
|
||
|
|
DWORD dwHRD_B;
|
||
|
|
|
||
|
|
// Options
|
||
|
|
DWORD fUnrestrictedVector:1;
|
||
|
|
DWORD fArithmeticCoding:1;
|
||
|
|
DWORD fAdvancedPrediction:1;
|
||
|
|
DWORD fPBFrames:1;
|
||
|
|
DWORD fErrorCompensation:1;
|
||
|
|
DWORD fAdvancedIntraCodingMode:1;
|
||
|
|
DWORD fDeblockingFilterMode:1;
|
||
|
|
DWORD fImprovedPBFrameMode:1;
|
||
|
|
DWORD fUnlimitedMotionVectors:1;
|
||
|
|
DWORD fFullPictureFreeze:1;
|
||
|
|
DWORD fPartialPictureFreezeAndRelease:1;
|
||
|
|
DWORD fResizingPartPicFreezeAndRelease:1;
|
||
|
|
DWORD fFullPictureSnapshot:1;
|
||
|
|
DWORD fPartialPictureSnapshot:1;
|
||
|
|
DWORD fVideoSegmentTagging:1;
|
||
|
|
DWORD fProgressiveRefinement:1;
|
||
|
|
DWORD fDynamicPictureResizingByFour:1;
|
||
|
|
DWORD fDynamicPictureResizingSixteenthPel:1;
|
||
|
|
DWORD fDynamicWarpingHalfPel:1;
|
||
|
|
DWORD fDynamicWarpingSixteenthPel:1;
|
||
|
|
DWORD fIndependentSegmentDecoding:1;
|
||
|
|
DWORD fSlicesInOrder_NonRect:1;
|
||
|
|
DWORD fSlicesInOrder_Rect:1;
|
||
|
|
DWORD fSlicesNoOrder_NonRect:1;
|
||
|
|
DWORD fSlicesNoOrder_Rect:1;
|
||
|
|
DWORD fAlternateInterVLCMode:1;
|
||
|
|
DWORD fModifiedQuantizationMode:1;
|
||
|
|
DWORD fReducedResolutionUpdate:1;
|
||
|
|
DWORD fReserved:4;
|
||
|
|
|
||
|
|
// Reserved
|
||
|
|
DWORD dwReserved[4];
|
||
|
|
#endif
|
||
|
|
} BITMAPINFOHEADER_H263, *PBITMAPINFOHEADER_H263;
|
||
|
|
|
||
|
|
/*****************************************************************************
|
||
|
|
* @doc INTERNAL TAPIH26XSTRUCTENUM
|
||
|
|
*
|
||
|
|
* @struct VIDEOINFOHEADER_H263 | The <t VIDEOINFOHEADER_H263> structure
|
||
|
|
* is used to specify the details of the H.263 video format.
|
||
|
|
*
|
||
|
|
* @field RECT | rcSource | Specifies a <t RECT> structure that defines the
|
||
|
|
* source video window.
|
||
|
|
*
|
||
|
|
* @field RECT | rcTarget | Specifies a <t RECT> structure that defines the
|
||
|
|
* destination video window.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwBitRate | Specifies a <t DWORD> value that indicates
|
||
|
|
* the video stream's approximate data rate, in bits per second.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwBitErrorRate | Specifies a <t DWORD> value that
|
||
|
|
* indicates the video stream's data error rate, in bit errors per second.
|
||
|
|
*
|
||
|
|
* @field REFERENCE_TIME | AvgTimePerFrame | Specifies a <t REFERENCE_TIME>
|
||
|
|
* value that indicates the video frame's average display time, in
|
||
|
|
* 100-nanosecond units.
|
||
|
|
*
|
||
|
|
* @field BITMAPINFOHEADER_H263 | bmiHeader | Specifies a
|
||
|
|
* <t BITMAPINFOHEADER_H263> structure that contains detailed format
|
||
|
|
* information for the H.263 video data.
|
||
|
|
***************************************************************************/
|
||
|
|
typedef struct tagVIDEOINFOHEADER_H263
|
||
|
|
{
|
||
|
|
RECT rcSource; // The bit we really want to use
|
||
|
|
RECT rcTarget; // Where the video should go
|
||
|
|
DWORD dwBitRate; // Approximate bit data rate
|
||
|
|
DWORD dwBitErrorRate; // Bit error rate for this stream
|
||
|
|
REFERENCE_TIME AvgTimePerFrame; // Average time per frame (100ns units)
|
||
|
|
BITMAPINFOHEADER_H263 bmiHeader;
|
||
|
|
} VIDEOINFOHEADER_H263, *PVIDEOINFOHEADER_H263;
|
||
|
|
|
||
|
|
/*****************************************************************************
|
||
|
|
* @doc INTERNAL TAPIH26XSTRUCTENUM
|
||
|
|
*
|
||
|
|
* @struct BITMAPINFOHEADER_H261 | The <t BITMAPINFOHEADER_H261> structure
|
||
|
|
* is used to specify the details of the H.261 video format.
|
||
|
|
*
|
||
|
|
* @field BITMAPINFOHEADER | bmi | Specifies a well-known GDI bitmap info
|
||
|
|
* header structure.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwMaxBitrate | Specifies the maximum bit rate in units
|
||
|
|
* of 100 bits/s at which the receiver can receive video. This value is
|
||
|
|
* only valid between 1 and 19200.
|
||
|
|
*
|
||
|
|
* @field BOOL | fStillImageTransmission | Specifies that the receiver can
|
||
|
|
* receive still images as defined in Annex D of H.261.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwReserved[4] | Reserved. Shall all be set to 0.
|
||
|
|
***************************************************************************/
|
||
|
|
|
||
|
|
#define MAX_BITRATE_H261 (19200)
|
||
|
|
|
||
|
|
typedef struct tagBITMAPINFOHEADER_H261
|
||
|
|
{
|
||
|
|
// Generic bitmap info header fields
|
||
|
|
BITMAPINFOHEADER bmi;
|
||
|
|
|
||
|
|
#ifndef USE_OLD_FORMAT_DEFINITION
|
||
|
|
// H.261 specific fields
|
||
|
|
DWORD dwMaxBitrate;
|
||
|
|
BOOL fStillImageTransmission;
|
||
|
|
|
||
|
|
// Reserved
|
||
|
|
DWORD dwReserved[4];
|
||
|
|
#endif
|
||
|
|
} BITMAPINFOHEADER_H261, *PBITMAPINFOHEADER_H261;
|
||
|
|
|
||
|
|
/*****************************************************************************
|
||
|
|
* @doc INTERNAL TAPIH26XSTRUCTENUM
|
||
|
|
*
|
||
|
|
* @struct VIDEOINFOHEADER_H261 | The <t VIDEOINFOHEADER_H261> structure
|
||
|
|
* is used to specify the details of the H.261 video format.
|
||
|
|
*
|
||
|
|
* @field RECT | rcSource | Specifies a <t RECT> structure that defines the
|
||
|
|
* source video window.
|
||
|
|
*
|
||
|
|
* @field RECT | rcTarget | Specifies a <t RECT> structure that defines the
|
||
|
|
* destination video window.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwBitRate | Specifies a <t DWORD> value that indicates
|
||
|
|
* the video stream's approximate data rate, in bits per second.
|
||
|
|
*
|
||
|
|
* @field DWORD | dwBitErrorRate | Specifies a <t DWORD> value that
|
||
|
|
* indicates the video stream's data error rate, in bit errors per second.
|
||
|
|
*
|
||
|
|
* @field REFERENCE_TIME | AvgTimePerFrame | Specifies a <t REFERENCE_TIME>
|
||
|
|
* value that indicates the video frame's average display time, in
|
||
|
|
* 100-nanosecond units.
|
||
|
|
*
|
||
|
|
* @field BITMAPINFOHEADER_H261 | bmiHeader | Specifies a
|
||
|
|
* <t BITMAPINFOHEADER_H261> structure that contains detailed format
|
||
|
|
* information for the H.261 video data.
|
||
|
|
***************************************************************************/
|
||
|
|
typedef struct tagVIDEOINFOHEADER_H261
|
||
|
|
{
|
||
|
|
RECT rcSource; // The bit we really want to use
|
||
|
|
RECT rcTarget; // Where the video should go
|
||
|
|
DWORD dwBitRate; // Approximate bit data rate
|
||
|
|
DWORD dwBitErrorRate; // Bit error rate for this stream
|
||
|
|
REFERENCE_TIME AvgTimePerFrame; // Average time per frame (100ns units)
|
||
|
|
BITMAPINFOHEADER_H261 bmiHeader;
|
||
|
|
} VIDEOINFOHEADER_H261, *PVIDEOINFOHEADER_H261;
|
||
|
|
|
||
|
|
#endif // _TAPIH26X_H_
|