sl@0: // Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Constants and structs specific to H.263.  See the DevVideo specs for more details.
sl@0: // 
sl@0: //
sl@0: 
sl@0: #ifndef __DEVVIDEO_H263_H__
sl@0: #define __DEVVIDEO_H263_H__
sl@0: 
sl@0: #include <e32base.h>
sl@0: 
sl@0: 
sl@0: /**
sl@0: Specifies the H263 picture type.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: enum TH263PictureType
sl@0:     {
sl@0: 	/**INTRA picture*/
sl@0:     EH263PictureTypeI   = 0x01,
sl@0: 	/**INTER picture*/
sl@0:     EH263PictureTypeP   = 0x02,
sl@0: 	/**B picture according to H.263 Annex O*/
sl@0:     EH263PictureTypeB   = 0x04,
sl@0: 	/**EI picture according to H.263 Annex O*/
sl@0:     EH263PictureTypeEI  = 0x08,
sl@0: 	/**EP picture according to H.263 Annex O*/
sl@0:     EH263PictureTypeEP  = 0x10
sl@0:     };
sl@0: 
sl@0: /**
sl@0: These enumerations can be used in codec capability indication and/or bitstream property indication.
sl@0: When used as part of an encoder capability indication, a signalled value indicates the capability
sl@0: of an encoder to produce such supplemental information to the bitstream and the additional meanings
sl@0: as specified below. When used as part of a decoder capability indication, a signalled value 
sl@0: indicates the capability of a decoder to react to such supplemental information in a way as 
sl@0: specified below. If a decoder does not have such capability, it shall be able to parse and discard
sl@0: the supplemental information. When used as part of a bitstream property indication, a non-signalled
sl@0: value indicates the absence of such information in the bitstream and a signalled value indicates 
sl@0: the possibility of having such information in the bitstream.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: enum TH263SupplementalInformation
sl@0:     {
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 1
sl@0: 	*/
sl@0:     EH263SEIDoNothing			 					= 0x00000001,
sl@0: 
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	capability to freeze displayed picture according to subclause L.4 of H.263capability to release frozen displayed picture as a response to bit 5 of PTYPE
sl@0: 	bitstream property:	existence of FTYPE equal to 2
sl@0: 	*/
sl@0:     EH263SEIFullPictureFreeze            			= 0x00000002,
sl@0: 
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	capability to freeze displayed picture partially (subclause L.5 of H.263)
sl@0: 	bitstream property:	existence of FTYPE equal to 3
sl@0: 	*/
sl@0:     EH263SEIPartialPictureFreeze         			= 0x00000004,
sl@0: 
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	capability to freeze and resize displayed picture partially (H.263 L.6)
sl@0: 	bitstream property:	existence of FTYPE equal to 4
sl@0: 	*/
sl@0:     EH263SEIResizingPartialPictureFreeze 			= 0x00000008,
sl@0: 
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	capability to release partially frozen picture (subclause L.7 of H.263)
sl@0: 	bitstream property:	existence of FTYPE equal to 5
sl@0: 	*/
sl@0:     EH263SEIPartialPictureFreezeRelease  			= 0x00000010,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 6
sl@0: 	*/
sl@0:     EH263SEIFullPictureSnapshotTag       			= 0x00000020,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 7
sl@0: 	*/
sl@0:     EH263SEIPartialPictureSnapshotTag    			= 0x00000040,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 8
sl@0: 	*/
sl@0:     EH263SEIVideoTimeSegmentStartTag     			= 0x00000080,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 9
sl@0: 	*/
sl@0:     EH263SEIVideoTimeSegmentEndTag       			= 0x00000100,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 10
sl@0: 	*/
sl@0:     EH263SEIProgressiveRefinementStartTag   		= 0x00000200,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 11
sl@0: 	*/
sl@0:     EH263SEIProgressiveRefinementEndTag     		= 0x00000400,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	operation according to sublause L.14 of H.263
sl@0: 	bitstream property:	existence of FTYPE equal to 12
sl@0: 	*/
sl@0:     EH263SEIChromaKeying                 			= 0x00000800,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	use of the fixed-point IDCT algorithm specified in Annex W of H.263
sl@0: 	decoder capability:	use of the fixed-point IDCT algorithm specified in Annex W of H.263
sl@0: 	bitstream property:	existence of FTYPE equal to 13
sl@0: 	*/
sl@0:     EH263SEIFixedPointIDCT               			= 0x00001000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 0
sl@0: 	*/
sl@0:     EH263SEIArbitraryBinaryData          			= 0x00002000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 1
sl@0: 	*/
sl@0:     EH263SEIArbitraryText                   		= 0x00004000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 2
sl@0: 	*/
sl@0:     EH263SEICopyrightText                   		= 0x00008000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	capability of display caption text as specified in subclause W.6.3.5 of H.263
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 3
sl@0: 	*/
sl@0:     EH263SEICaptionText                     		= 0x00010000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 4
sl@0: 	*/
sl@0:     EH263SEIVideoDescriptionText            		= 0x00020000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	no meaning
sl@0: 	decoder capability:	no meaning
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 5
sl@0: 	*/
sl@0:     EH263SEIUniformResourceIdentifierText   		= 0x00040000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to repeat the current picture header (subclause W.6.3.7 of H.263)
sl@0: 	decoder capability:	capability to recover a corrupted picture header with a repeated one
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 6
sl@0: 	*/
sl@0:     EH263SEICurrentPictureHeaderRepetition  		= 0x00080000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to repeat the previous picture header (subclause W.6.3.8 of H.263)
sl@0: 	decoder capability:	capability to recover a corrupted or lost picture header with a repeated one
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 7
sl@0: 	*/
sl@0:     EH263SEIPreviousPictureHeaderRepetition 		= 0x00100000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to repeat the next picture header (W.6.3.9 of H.263)
sl@0: 	decoder capability:	capability to recover a corrupted or lost picture header with a repeated one
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 8
sl@0: 	*/
sl@0:     EH263SEINextPictureHeaderRepetitionReliableTR  	= 0x00200000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to repeat the next picture header (W.6.3.10 of H.263)
sl@0: 	decoder capability:	capability to recover a corrupted or lost picture header with a repeated one
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 9
sl@0: 	*/
sl@0:     EH263SEINextPictureHeaderRepetitionUnreliableTR	= 0x00400000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to encode top fields of interlaced pictures 
sl@0: 	decoder capability:	capability to decode and display top fields of interlaced pictures (W.6.3.11of H.263)
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 10
sl@0: 	*/
sl@0:     EH263SEITopInterlacedFieldIndication		   	= 0x00800000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to encode bottom fields of interlaced pictures 
sl@0: 	decoder capability:	capability to decode and display bottom fields of interlaced pictures (W.6.3.11of H.263)
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 10
sl@0: 	*/
sl@0:     EH263SEIBottomInterlacedFieldIndication       	= 0x01000000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to transmit picture numbers (subclause W.6.3.12 of H.263)
sl@0: 	decoder capability:	capability to indicate reference picture losses from missing picture numbers
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 12
sl@0: 	*/
sl@0:     EH263SEIPictureNumber                   		= 0x02000000,
sl@0: 	
sl@0: 	/**
sl@0: 	encoder capability:	capability to generate spare reference picture information (W.6.3.13 of H.263)
sl@0: 	decoder capability:	capability to use a spare reference picture in absence of real reference picture
sl@0: 	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 13
sl@0: 	*/
sl@0:     EH263SEISpareReferencePictures          		= 0x04000000
sl@0:     };
sl@0: 
sl@0: 
sl@0: /**
sl@0: H.263 picture header.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: class TH263PictureHeader
sl@0:     {
sl@0: public:
sl@0: 	/**
sl@0: 	Indicates the temporal reference. iTemporalReference is equal to the value of TR or the value
sl@0: 	of (ETR << 8) + TR if ETR is present in the picture header.
sl@0: 	*/
sl@0:     TUint iTemporalReference;
sl@0: 
sl@0: 	/**
sl@0: 	iLongTermPicture equal to ETrue indicates that the picture has been marked as a long-term
sl@0: 	picture according to the memory management control operation (MMCO) commands as specified 
sl@0: 	in Annex U of H.263. Otherwise the picture is not a long-term picture.
sl@0: 	*/
sl@0:     TBool iLongTermPicture;
sl@0: 
sl@0: 	/**
sl@0: 	iSplitScreen is equal to the value of bit 3 of PTYPE.
sl@0: 	*/
sl@0:     TBool iSplitScreen;
sl@0: 
sl@0: 	/**
sl@0: 	iDocumentCamera is equal to the value of bit 4 of PTYPE.
sl@0: 	*/
sl@0:     TBool iDocumentCamera;
sl@0: 
sl@0: 	/**
sl@0: 	iFreezePictureRelease is equal to the value of bit 5 of PTYPE.
sl@0: 	*/
sl@0:     TBool iFreezePictureRelease;
sl@0: 
sl@0: 	/**
sl@0: 	Indicates the picture coding type. iPictureType is set according to the picture header as one 
sl@0: 	of the values defined in TH263PictureType.
sl@0: 	*/
sl@0:     TH263PictureType iPictureType;
sl@0: 
sl@0: 	/**
sl@0: 	Indicates the initial value of the quantization parameter. iPQuant is equal to the value of 
sl@0: 	the PQUANT syntax element.
sl@0: 	*/
sl@0:     TUint iPQuant;
sl@0: 
sl@0: 	/**
sl@0: 	Indicates the presence of the extended PTYPE field in the picture layer. The extended PTYPE 
sl@0: 	field is specified in ITU-T Recommendation H.263 version 2 and later. iPlusPType is equal to 1 
sl@0: 	if bits 6 - 8 of PTYPE are equal to '111'. Otherwise, iPlusPType is equal to 0.
sl@0: 	*/
sl@0:     TBool iPlusPType;
sl@0: 
sl@0: 	/**
sl@0: 	Indicates the presence of the full extended PTYPE field in the picture layer. If iPlusPType is 
sl@0: 	EFalse, the value of of iUpdateFullExtendedPType is not valid. Otherwise, 
sl@0: 	iUpdateFullExtendedPType is equal to the value of the UFEP syntax element.
sl@0: 	*/
sl@0:     TBool iUpdateFullExtendedPType;
sl@0: 
sl@0: 	/**
sl@0: 	Pixel aspect ratio numerator and denominator respectively. The pixel aspect ratio is defined as
sl@0: 	iAspectRatioNum/iAspectRatioDenom, where the values are positive integers and relatively prime.
sl@0: 	If iPlusPType is equal to 0, or iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and 
sl@0: 	bits 1 - 3 of the OPPTYPE syntax element are not equal to '110', iAspectRatioNum shall be equal
sl@0: 	to 12 and iAspectRatioDenom shall be equal to 11 (as specified in subclause 4.1 of ITU-T 
sl@0: 	Recommendation H.263). If iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and bits
sl@0: 	1 - 3 of the OPPTYPE syntax element are equal to '110', the values of iAspectRatioNum and 
sl@0: 	iAspectRatioDenom are set as specified in subclauses 5.1.5 and 5.1.6 of ITU-T Recommendation
sl@0: 	H.263. Otherwise (iPlusPType is ETrue and iUpdateFullExtendedPType is EFalse), the values of
sl@0: 	iAspectRatioNum and iAspectRatioDenom are not valid.
sl@0: 	*/
sl@0:     TUint iAspectRatioNum;
sl@0: 
sl@0: 	/**
sl@0: 	Pixel aspect ratio numerator and denominator respectively. The pixel aspect ratio is defined as
sl@0: 	iAspectRatioNum/iAspectRatioDenom, where the values are positive integers and relatively prime.
sl@0: 	If iPlusPType is equal to 0, or iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and 
sl@0: 	bits 1 - 3 of the OPPTYPE syntax element are not equal to '110', iAspectRatioNum shall be equal
sl@0: 	to 12 and iAspectRatioDenom shall be equal to 11 (as specified in subclause 4.1 of ITU-T 
sl@0: 	Recommendation H.263). If iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and bits
sl@0: 	1 - 3 of the OPPTYPE syntax element are equal to '110', the values of iAspectRatioNum and 
sl@0: 	iAspectRatioDenom are set as specified in subclauses 5.1.5 and 5.1.6 of ITU-T Recommendation
sl@0: 	H.263. Otherwise (iPlusPType is ETrue and iUpdateFullExtendedPType is EFalse), the values of
sl@0: 	iAspectRatioNum and iAspectRatioDenom are not valid.
sl@0: 	*/
sl@0:     TUint iAspectRatioDenom;
sl@0: 
sl@0: 	/**
sl@0: 	Picture clock frequency numerator and denominator respectively. The picture clock frequency 
sl@0: 	for temporal reference is defined as iPictureClockFrequencyRate / iPictureClockFrequencyScale
sl@0: 	in floating point arithmetic and where the values are positive integers and relatively prime. 
sl@0: 	If iPlusPType is equal to 0, or iPlusPType is equal to 1 and iUpdateFullExtendedPType is equal 
sl@0: 	to 1 and bit 4 of the OPPTYPE syntax element is equal to 0, iPictureClockFrequencyRate shall be 
sl@0: 	equal to 30000 and iPictureClockFrequencyScale shall be equal to 1001 (as specified in subclause
sl@0: 	4.1 of ITU-T Recommendation H.263). If iPlusPType is equal to 1 and iUpdateFullExtendedPType is
sl@0: 	equal to 1 and bit 4 of the OPPTYPE syntax element is equal to 1, the values of 
sl@0: 	iPictureClockFrequencyRate and iPictureClockFrequencyScale are set as specified in subclause
sl@0: 	5.1.7 of ITU-T Recommendation H.263. Otherwise (iPlusPType is equal to 1 and 
sl@0: 	iUpdateFullExtendedPType is equal to 0), the values of iPictureClockFrequencyRate and
sl@0: 	iPictureClockFrequencyScale are not valid.
sl@0: 	*/
sl@0:     TUint iPictureClockFrequencyRate;
sl@0: 
sl@0: 	/**
sl@0: 	Picture clock frequency numerator and denominator respectively. The picture clock frequency 
sl@0: 	for temporal reference is defined as iPictureClockFrequencyRate / iPictureClockFrequencyScale
sl@0: 	in floating point arithmetic and where the values are positive integers and relatively prime. 
sl@0: 	If iPlusPType is equal to 0, or iPlusPType is equal to 1 and iUpdateFullExtendedPType is equal 
sl@0: 	to 1 and bit 4 of the OPPTYPE syntax element is equal to 0, iPictureClockFrequencyRate shall be 
sl@0: 	equal to 30000 and iPictureClockFrequencyScale shall be equal to 1001 (as specified in subclause
sl@0: 	4.1 of ITU-T Recommendation H.263). If iPlusPType is equal to 1 and iUpdateFullExtendedPType is
sl@0: 	equal to 1 and bit 4 of the OPPTYPE syntax element is equal to 1, the values of 
sl@0: 	iPictureClockFrequencyRate and iPictureClockFrequencyScale are set as specified in subclause
sl@0: 	5.1.7 of ITU-T Recommendation H.263. Otherwise (iPlusPType is equal to 1 and 
sl@0: 	iUpdateFullExtendedPType is equal to 0), the values of iPictureClockFrequencyRate and
sl@0: 	iPictureClockFrequencyScale are not valid.
sl@0: 	*/
sl@0:     TUint iPictureClockFrequencyScale;
sl@0:     };
sl@0: 
sl@0: /**
sl@0: This class is used to signal decoder or encoder capabilities or bitstream properties.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: class TH263VideoCapability
sl@0:     {
sl@0: public:
sl@0: 	/**
sl@0: 	When part of a codec capability indication, iProfileLevel[ProfileNumber] indicates the 
sl@0: 	maximum processing level that a decoder or an encoder supports for a particular profile 
sl@0: 	indicated by ProfileNumber. A negative value indicates that the profile is not supported.
sl@0: 	When part of a stream property indication, iProfileLevel[ProfileNumber] indicates the maximum
sl@0: 	processing level that is present in the stream for a particular profile indicated by 
sl@0: 	ProfileNumber. A negative value indicates that the stream does not contain data coded according 
sl@0: 	to the indicated profile.
sl@0: 	*/
sl@0:     TInt iProfileLevel[9];
sl@0: 
sl@0: 	/**
sl@0: 	When equal to ETrue, indicating that it is allowed to use PLUSPTYPE (specified in the 1998 
sl@0: 	version of H.263) to indicate custom picture sizes or clock frequencies. When equal to EFalse,
sl@0: 	PLUSPTYPE shall not be used.
sl@0: 	*/
sl@0:     TBool iPLUSPTYPEAllowed;
sl@0: 
sl@0: 	/**
sl@0: 	iSupplementalInformationCap indicates the supported supplemental enhancement functions. The
sl@0: 	value is a binary OR of values from TH263SupplementalInformation.
sl@0: 	*/
sl@0:     TUint32 iSupplementalInformationCap;
sl@0:     };
sl@0: 
sl@0: 
sl@0: /**
sl@0: This class is used to set the encoder operation mode.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: class TH263VideoMode
sl@0:     {
sl@0: public:
sl@0: 	/**
sl@0: 	Specifies the picture types allowed in the bitstream. The value is a binary OR of values from
sl@0: 	TH263PictureType. Signaled picture types that are not included in the prevailing coding profile
sl@0: 	are ignored.
sl@0: 	*/
sl@0:     TUint32 iAllowedPictureTypes;
sl@0: 
sl@0: 	/**
sl@0: 	iForceRoundingTypeToZero equal to EFalse specifies that the value of the RTYPE bit (bit 6 of 
sl@0: 	MPPTYPE) is not constrained. It is recommended to change the value of the RTYPE bit for each 
sl@0: 	reference picture in error-free communication (subclause 5.1.4.3 of ITU-T H.263 Recommendation).
sl@0: 	iForceRoundingTypeToZero equal to ETrue specifies that the value of the RTYPE bit shall be equal 
sl@0: 	to 0 or that the RTYPE field shall not be present in the picture layer. It is recommended to set 
sl@0: 	iForceRoundingTypeToZero equal to ETrue (and consequently RTYPE equal to 0) in error-prone 
sl@0: 	communication as recommended in section 4.2.6 of H.263 Appendix III [R6] and [R7].
sl@0: 	*/
sl@0:     TBool iForceRoundingTypeToZero;
sl@0: 
sl@0: 	/**
sl@0: 	Specifies the frequency of picture header repetition as specified in this paragraph. If 
sl@0: 	iPictureHeaderRepetition is equal to 0, picture headers are not repeated. Otherwise, a picture 
sl@0: 	header is repeated, if the value of the GFID syntax element is not equal to the value of the 
sl@0: 	GFID syntax element of the previous picture in bitstream order. If EDuRtpPayload data unit 
sl@0: 	encapsulation is in use, a picture header is repeated the number of times indicated by the value 
sl@0: 	of iPictureHeaderRepetition in those RTP payloads of the picture where the P bit according to 
sl@0: 	RFC 2429 [R8] is set equal to 1 and which do not contain the original picture header. If 
sl@0: 	EDuElementaryStream data unit encapsulation is in use, the picture header is repeated once in 
sl@0: 	the supplemental enhancement information of the next picture as specified in subclause W.6.3.8
sl@0: 	of ITU-T Recommendation H.263 and section 4.2.6 of H.263 Appendix III [R6].
sl@0: 	*/
sl@0:     TUint iPictureHeaderRepetition;
sl@0: 
sl@0: 	/**
sl@0: 	Specifies the interval of non-empty GOB headers in units of GOBs. The value of 
sl@0: 	iGOBHeaderInterval is valid if no slice structured coding mode (Annex K or Annex V) is in use. 
sl@0: 	If iGOBHeaderInterval is equal to 0 and an unlimited segment size is specified with the 
sl@0: 	SetSegmentTargetSize method, the encoder should not generate GOB headers. If iGOBHeaderInterval 
sl@0: 	is greater than 0 and an unlimited segment size is specified with the SetSegmentTargetSize 
sl@0: 	method, the encoder should generate a non-empty GOB header for every iGOBHeaderInterval-th GOB.
sl@0: 	If SetSegmentTargetSize is used to set a limited segment size, the encoder should generate 
sl@0: 	segments (i.e., insert non-empty GOB headers) so that the length of the segment is no larger
sl@0: 	than the target size in bytes and no larger than the GOB header frequency specified with the 
sl@0: 	value of iGOBHeaderInterval.
sl@0: 	*/
sl@0:     TUint iGOBHeaderInterval;
sl@0:     };
sl@0: 
sl@0: /**
sl@0: H.263 HRD parameters.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: class TH263HrdParams
sl@0:     {
sl@0: public:
sl@0: 	/**
sl@0: 	When iAnnexXConstraints is equal to EFalse, iBPPmaxKb, iB, and iRmax indicate the values of HRD 
sl@0: 	parameters. When iAnnexXConstraints is equal to ETrue, the values of iBPPmaxKb, iB, and iRmax in 
sl@0: 	this class are ignored but rather their values are specified in Annex X of ITU-T Recommendation
sl@0: 	H.263. 
sl@0: 	*/
sl@0:     TBool iAnnexXConstraints;
sl@0: 
sl@0: 	/**
sl@0: 	Signals the BPPmaxKb parameter of H.263. As specified in ITU-T Recommendation H.263. The number 
sl@0: 	of bits created by coding any single picture shall not exceed a maximum value specified by the 
sl@0: 	parameter BPPmaxKb that is measured in units of 1024 bits. The minimum value of BPPmaxKb is 
sl@0: 	specified in Table 1 of ITU-T Recommendation H.263.
sl@0: 	*/
sl@0:     TUint iBPPmaxKb;
sl@0: 
sl@0: 	/**
sl@0: 	Signals the B parameter of H.263 Annex B. As specified in Annex B of ITU-T Recommendation H.263. 
sl@0: 	The value of B shall be equal to or greater than 4 * Rmax / PCF, where PCF is the picture clock 
sl@0: 	frequency specified in subclause 5.1.7 of ITU-T Recommendation H.263. The HRD receiving buffer 
sl@0: 	size is equal to (B + BPPmaxKb * 1024 bits).
sl@0: 	*/
sl@0:     TUint iB;
sl@0: 
sl@0: 	/**
sl@0: 	Signals the maximum video bit rate in bits per second, i.e., the Rmax parameter of H.263 Annex B. 
sl@0: 	*/
sl@0:     TUint iRmax;
sl@0:     };
sl@0: 
sl@0: /**
sl@0: H.263 redundant picture header.
sl@0: Points to a buffer to contain the redundant picture header in the orignal bitstream order. The
sl@0: buffer may be used by the MSL client in playback to pass the decapsulated redundant picture header 
sl@0: from an RTP payload formatted according to RFC 2429, or used by the MSL client in recording to pass
sl@0: the picture header to the RTP encapsulator.
sl@0: @publishedAll
sl@0: @released
sl@0: */
sl@0: typedef TPtr8* TH263RedundantPictureHeader;
sl@0: 
sl@0: #endif