// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "Eclipse Public License v1.0"

// which accompanies this distribution, and is available

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// Constants and structs specific to H.263.  See the DevVideo specs for more details.

// 

//

#ifndef __DEVVIDEO_H263_H__

#define __DEVVIDEO_H263_H__

#include <e32base.h>

/**

Specifies the H263 picture type.

@publishedAll

@released

*/

enum TH263PictureType

    {

	/**INTRA picture*/

    EH263PictureTypeI   = 0x01,

	/**INTER picture*/

    EH263PictureTypeP   = 0x02,

	/**B picture according to H.263 Annex O*/

    EH263PictureTypeB   = 0x04,

	/**EI picture according to H.263 Annex O*/

    EH263PictureTypeEI  = 0x08,

	/**EP picture according to H.263 Annex O*/

    EH263PictureTypeEP  = 0x10

    };

/**

These enumerations can be used in codec capability indication and/or bitstream property indication.

When used as part of an encoder capability indication, a signalled value indicates the capability

of an encoder to produce such supplemental information to the bitstream and the additional meanings

as specified below. When used as part of a decoder capability indication, a signalled value 

indicates the capability of a decoder to react to such supplemental information in a way as 

specified below. If a decoder does not have such capability, it shall be able to parse and discard

the supplemental information. When used as part of a bitstream property indication, a non-signalled

value indicates the absence of such information in the bitstream and a signalled value indicates 

the possibility of having such information in the bitstream.

@publishedAll

@released

*/

enum TH263SupplementalInformation

    {

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 1

	*/

    EH263SEIDoNothing			 					= 0x00000001,

	/**

	encoder capability:	no meaning

	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

	bitstream property:	existence of FTYPE equal to 2

	*/

    EH263SEIFullPictureFreeze            			= 0x00000002,

	/**

	encoder capability:	no meaning

	decoder capability:	capability to freeze displayed picture partially (subclause L.5 of H.263)

	bitstream property:	existence of FTYPE equal to 3

	*/

    EH263SEIPartialPictureFreeze         			= 0x00000004,

	/**

	encoder capability:	no meaning

	decoder capability:	capability to freeze and resize displayed picture partially (H.263 L.6)

	bitstream property:	existence of FTYPE equal to 4

	*/

    EH263SEIResizingPartialPictureFreeze 			= 0x00000008,

	/**

	encoder capability:	no meaning

	decoder capability:	capability to release partially frozen picture (subclause L.7 of H.263)

	bitstream property:	existence of FTYPE equal to 5

	*/

    EH263SEIPartialPictureFreezeRelease  			= 0x00000010,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 6

	*/

    EH263SEIFullPictureSnapshotTag       			= 0x00000020,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 7

	*/

    EH263SEIPartialPictureSnapshotTag    			= 0x00000040,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 8

	*/

    EH263SEIVideoTimeSegmentStartTag     			= 0x00000080,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 9

	*/

    EH263SEIVideoTimeSegmentEndTag       			= 0x00000100,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 10

	*/

    EH263SEIProgressiveRefinementStartTag   		= 0x00000200,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 11

	*/

    EH263SEIProgressiveRefinementEndTag     		= 0x00000400,

	/**

	encoder capability:	no meaning

	decoder capability:	operation according to sublause L.14 of H.263

	bitstream property:	existence of FTYPE equal to 12

	*/

    EH263SEIChromaKeying                 			= 0x00000800,

	/**

	encoder capability:	use of the fixed-point IDCT algorithm specified in Annex W of H.263

	decoder capability:	use of the fixed-point IDCT algorithm specified in Annex W of H.263

	bitstream property:	existence of FTYPE equal to 13

	*/

    EH263SEIFixedPointIDCT               			= 0x00001000,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 0

	*/

    EH263SEIArbitraryBinaryData          			= 0x00002000,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 1

	*/

    EH263SEIArbitraryText                   		= 0x00004000,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 2

	*/

    EH263SEICopyrightText                   		= 0x00008000,

	/**

	encoder capability:	no meaning

	decoder capability:	capability of display caption text as specified in subclause W.6.3.5 of H.263

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 3

	*/

    EH263SEICaptionText                     		= 0x00010000,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 4

	*/

    EH263SEIVideoDescriptionText            		= 0x00020000,

	/**

	encoder capability:	no meaning

	decoder capability:	no meaning

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 5

	*/

    EH263SEIUniformResourceIdentifierText   		= 0x00040000,

	/**

	encoder capability:	capability to repeat the current picture header (subclause W.6.3.7 of H.263)

	decoder capability:	capability to recover a corrupted picture header with a repeated one

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 6

	*/

    EH263SEICurrentPictureHeaderRepetition  		= 0x00080000,

	/**

	encoder capability:	capability to repeat the previous picture header (subclause W.6.3.8 of H.263)

	decoder capability:	capability to recover a corrupted or lost picture header with a repeated one

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 7

	*/

    EH263SEIPreviousPictureHeaderRepetition 		= 0x00100000,

	/**

	encoder capability:	capability to repeat the next picture header (W.6.3.9 of H.263)

	decoder capability:	capability to recover a corrupted or lost picture header with a repeated one

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 8

	*/

    EH263SEINextPictureHeaderRepetitionReliableTR  	= 0x00200000,

	/**

	encoder capability:	capability to repeat the next picture header (W.6.3.10 of H.263)

	decoder capability:	capability to recover a corrupted or lost picture header with a repeated one

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 9

	*/

    EH263SEINextPictureHeaderRepetitionUnreliableTR	= 0x00400000,

	/**

	encoder capability:	capability to encode top fields of interlaced pictures 

	decoder capability:	capability to decode and display top fields of interlaced pictures (W.6.3.11of H.263)

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 10

	*/

    EH263SEITopInterlacedFieldIndication		   	= 0x00800000,

	/**

	encoder capability:	capability to encode bottom fields of interlaced pictures 

	decoder capability:	capability to decode and display bottom fields of interlaced pictures (W.6.3.11of H.263)

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 10

	*/

    EH263SEIBottomInterlacedFieldIndication       	= 0x01000000,

	/**

	encoder capability:	capability to transmit picture numbers (subclause W.6.3.12 of H.263)

	decoder capability:	capability to indicate reference picture losses from missing picture numbers

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 12

	*/

    EH263SEIPictureNumber                   		= 0x02000000,

	/**

	encoder capability:	capability to generate spare reference picture information (W.6.3.13 of H.263)

	decoder capability:	capability to use a spare reference picture in absence of real reference picture

	bitstream property:	existence of FTYPE equal to 14 and MTYPE equal to 13

	*/

    EH263SEISpareReferencePictures          		= 0x04000000

    };

/**

H.263 picture header.

@publishedAll

@released

*/

class TH263PictureHeader

    {

public:

	/**

	Indicates the temporal reference. iTemporalReference is equal to the value of TR or the value

	of (ETR << 8) + TR if ETR is present in the picture header.

	*/

    TUint iTemporalReference;

	/**

	iLongTermPicture equal to ETrue indicates that the picture has been marked as a long-term

	picture according to the memory management control operation (MMCO) commands as specified 

	in Annex U of H.263. Otherwise the picture is not a long-term picture.

	*/

    TBool iLongTermPicture;

	/**

	iSplitScreen is equal to the value of bit 3 of PTYPE.

	*/

    TBool iSplitScreen;

	/**

	iDocumentCamera is equal to the value of bit 4 of PTYPE.

	*/

    TBool iDocumentCamera;

	/**

	iFreezePictureRelease is equal to the value of bit 5 of PTYPE.

	*/

    TBool iFreezePictureRelease;

	/**

	Indicates the picture coding type. iPictureType is set according to the picture header as one 

	of the values defined in TH263PictureType.

	*/

    TH263PictureType iPictureType;

	/**

	Indicates the initial value of the quantization parameter. iPQuant is equal to the value of 

	the PQUANT syntax element.

	*/

    TUint iPQuant;

	/**

	Indicates the presence of the extended PTYPE field in the picture layer. The extended PTYPE 

	field is specified in ITU-T Recommendation H.263 version 2 and later. iPlusPType is equal to 1 

	if bits 6 - 8 of PTYPE are equal to '111'. Otherwise, iPlusPType is equal to 0.

	*/

    TBool iPlusPType;

	/**

	Indicates the presence of the full extended PTYPE field in the picture layer. If iPlusPType is 

	EFalse, the value of of iUpdateFullExtendedPType is not valid. Otherwise, 

	iUpdateFullExtendedPType is equal to the value of the UFEP syntax element.

	*/

    TBool iUpdateFullExtendedPType;

	/**

	Pixel aspect ratio numerator and denominator respectively. The pixel aspect ratio is defined as

	iAspectRatioNum/iAspectRatioDenom, where the values are positive integers and relatively prime.

	If iPlusPType is equal to 0, or iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and 

	bits 1 - 3 of the OPPTYPE syntax element are not equal to '110', iAspectRatioNum shall be equal

	to 12 and iAspectRatioDenom shall be equal to 11 (as specified in subclause 4.1 of ITU-T 

	Recommendation H.263). If iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and bits

	1 - 3 of the OPPTYPE syntax element are equal to '110', the values of iAspectRatioNum and 

	iAspectRatioDenom are set as specified in subclauses 5.1.5 and 5.1.6 of ITU-T Recommendation

	H.263. Otherwise (iPlusPType is ETrue and iUpdateFullExtendedPType is EFalse), the values of

	iAspectRatioNum and iAspectRatioDenom are not valid.

	*/

    TUint iAspectRatioNum;

	/**

	Pixel aspect ratio numerator and denominator respectively. The pixel aspect ratio is defined as

	iAspectRatioNum/iAspectRatioDenom, where the values are positive integers and relatively prime.

	If iPlusPType is equal to 0, or iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and 

	bits 1 - 3 of the OPPTYPE syntax element are not equal to '110', iAspectRatioNum shall be equal

	to 12 and iAspectRatioDenom shall be equal to 11 (as specified in subclause 4.1 of ITU-T 

	Recommendation H.263). If iPlusPType is ETrue and iUpdateFullExtendedPType is ETrue and bits

	1 - 3 of the OPPTYPE syntax element are equal to '110', the values of iAspectRatioNum and 

	iAspectRatioDenom are set as specified in subclauses 5.1.5 and 5.1.6 of ITU-T Recommendation

	H.263. Otherwise (iPlusPType is ETrue and iUpdateFullExtendedPType is EFalse), the values of

	iAspectRatioNum and iAspectRatioDenom are not valid.

	*/

    TUint iAspectRatioDenom;

	/**

	Picture clock frequency numerator and denominator respectively. The picture clock frequency 

	for temporal reference is defined as iPictureClockFrequencyRate / iPictureClockFrequencyScale

	in floating point arithmetic and where the values are positive integers and relatively prime. 

	If iPlusPType is equal to 0, or iPlusPType is equal to 1 and iUpdateFullExtendedPType is equal 

	to 1 and bit 4 of the OPPTYPE syntax element is equal to 0, iPictureClockFrequencyRate shall be 

	equal to 30000 and iPictureClockFrequencyScale shall be equal to 1001 (as specified in subclause

	4.1 of ITU-T Recommendation H.263). If iPlusPType is equal to 1 and iUpdateFullExtendedPType is

	equal to 1 and bit 4 of the OPPTYPE syntax element is equal to 1, the values of 

	iPictureClockFrequencyRate and iPictureClockFrequencyScale are set as specified in subclause

	5.1.7 of ITU-T Recommendation H.263. Otherwise (iPlusPType is equal to 1 and 

	iUpdateFullExtendedPType is equal to 0), the values of iPictureClockFrequencyRate and

	iPictureClockFrequencyScale are not valid.

	*/

    TUint iPictureClockFrequencyRate;

	/**

	Picture clock frequency numerator and denominator respectively. The picture clock frequency 

	for temporal reference is defined as iPictureClockFrequencyRate / iPictureClockFrequencyScale

	in floating point arithmetic and where the values are positive integers and relatively prime. 

	If iPlusPType is equal to 0, or iPlusPType is equal to 1 and iUpdateFullExtendedPType is equal 

	to 1 and bit 4 of the OPPTYPE syntax element is equal to 0, iPictureClockFrequencyRate shall be 

	equal to 30000 and iPictureClockFrequencyScale shall be equal to 1001 (as specified in subclause

	4.1 of ITU-T Recommendation H.263). If iPlusPType is equal to 1 and iUpdateFullExtendedPType is

	equal to 1 and bit 4 of the OPPTYPE syntax element is equal to 1, the values of 

	iPictureClockFrequencyRate and iPictureClockFrequencyScale are set as specified in subclause

	5.1.7 of ITU-T Recommendation H.263. Otherwise (iPlusPType is equal to 1 and 

	iUpdateFullExtendedPType is equal to 0), the values of iPictureClockFrequencyRate and

	iPictureClockFrequencyScale are not valid.

	*/

    TUint iPictureClockFrequencyScale;

    };

/**

This class is used to signal decoder or encoder capabilities or bitstream properties.

@publishedAll

@released

*/

class TH263VideoCapability

    {

public:

	/**

	When part of a codec capability indication, iProfileLevel[ProfileNumber] indicates the 

	maximum processing level that a decoder or an encoder supports for a particular profile 

	indicated by ProfileNumber. A negative value indicates that the profile is not supported.

	When part of a stream property indication, iProfileLevel[ProfileNumber] indicates the maximum

	processing level that is present in the stream for a particular profile indicated by 

	ProfileNumber. A negative value indicates that the stream does not contain data coded according 

	to the indicated profile.

	*/

    TInt iProfileLevel[9];

	/**

	When equal to ETrue, indicating that it is allowed to use PLUSPTYPE (specified in the 1998 

	version of H.263) to indicate custom picture sizes or clock frequencies. When equal to EFalse,

	PLUSPTYPE shall not be used.

	*/

    TBool iPLUSPTYPEAllowed;

	/**

	iSupplementalInformationCap indicates the supported supplemental enhancement functions. The

	value is a binary OR of values from TH263SupplementalInformation.

	*/

    TUint32 iSupplementalInformationCap;

    };

/**

This class is used to set the encoder operation mode.

@publishedAll

@released

*/

class TH263VideoMode

    {

public:

	/**

	Specifies the picture types allowed in the bitstream. The value is a binary OR of values from

	TH263PictureType. Signaled picture types that are not included in the prevailing coding profile

	are ignored.

	*/

    TUint32 iAllowedPictureTypes;

	/**

	iForceRoundingTypeToZero equal to EFalse specifies that the value of the RTYPE bit (bit 6 of 

	MPPTYPE) is not constrained. It is recommended to change the value of the RTYPE bit for each 

	reference picture in error-free communication (subclause 5.1.4.3 of ITU-T H.263 Recommendation).

	iForceRoundingTypeToZero equal to ETrue specifies that the value of the RTYPE bit shall be equal 

	to 0 or that the RTYPE field shall not be present in the picture layer. It is recommended to set 

	iForceRoundingTypeToZero equal to ETrue (and consequently RTYPE equal to 0) in error-prone 

	communication as recommended in section 4.2.6 of H.263 Appendix III [R6] and [R7].

	*/

    TBool iForceRoundingTypeToZero;

	/**

	Specifies the frequency of picture header repetition as specified in this paragraph. If 

	iPictureHeaderRepetition is equal to 0, picture headers are not repeated. Otherwise, a picture 

	header is repeated, if the value of the GFID syntax element is not equal to the value of the 

	GFID syntax element of the previous picture in bitstream order. If EDuRtpPayload data unit 

	encapsulation is in use, a picture header is repeated the number of times indicated by the value 

	of iPictureHeaderRepetition in those RTP payloads of the picture where the P bit according to 

	RFC 2429 [R8] is set equal to 1 and which do not contain the original picture header. If 

	EDuElementaryStream data unit encapsulation is in use, the picture header is repeated once in 

	the supplemental enhancement information of the next picture as specified in subclause W.6.3.8

	of ITU-T Recommendation H.263 and section 4.2.6 of H.263 Appendix III [R6].

	*/

    TUint iPictureHeaderRepetition;

	/**

	Specifies the interval of non-empty GOB headers in units of GOBs. The value of 

	iGOBHeaderInterval is valid if no slice structured coding mode (Annex K or Annex V) is in use. 

	If iGOBHeaderInterval is equal to 0 and an unlimited segment size is specified with the 

	SetSegmentTargetSize method, the encoder should not generate GOB headers. If iGOBHeaderInterval 

	is greater than 0 and an unlimited segment size is specified with the SetSegmentTargetSize 

	method, the encoder should generate a non-empty GOB header for every iGOBHeaderInterval-th GOB.

	If SetSegmentTargetSize is used to set a limited segment size, the encoder should generate 

	segments (i.e., insert non-empty GOB headers) so that the length of the segment is no larger

	than the target size in bytes and no larger than the GOB header frequency specified with the 

	value of iGOBHeaderInterval.

	*/

    TUint iGOBHeaderInterval;

    };

/**

H.263 HRD parameters.

@publishedAll

@released

*/

class TH263HrdParams

    {

public:

	/**

	When iAnnexXConstraints is equal to EFalse, iBPPmaxKb, iB, and iRmax indicate the values of HRD 

	parameters. When iAnnexXConstraints is equal to ETrue, the values of iBPPmaxKb, iB, and iRmax in 

	this class are ignored but rather their values are specified in Annex X of ITU-T Recommendation

	H.263. 

	*/

    TBool iAnnexXConstraints;

	/**

	Signals the BPPmaxKb parameter of H.263. As specified in ITU-T Recommendation H.263. The number 

	of bits created by coding any single picture shall not exceed a maximum value specified by the 

	parameter BPPmaxKb that is measured in units of 1024 bits. The minimum value of BPPmaxKb is 

	specified in Table 1 of ITU-T Recommendation H.263.

	*/

    TUint iBPPmaxKb;

	/**

	Signals the B parameter of H.263 Annex B. As specified in Annex B of ITU-T Recommendation H.263. 

	The value of B shall be equal to or greater than 4 * Rmax / PCF, where PCF is the picture clock 

	frequency specified in subclause 5.1.7 of ITU-T Recommendation H.263. The HRD receiving buffer 

	size is equal to (B + BPPmaxKb * 1024 bits).

	*/

    TUint iB;

	/**

	Signals the maximum video bit rate in bits per second, i.e., the Rmax parameter of H.263 Annex B. 

	*/

    TUint iRmax;

    };

/**

H.263 redundant picture header.

Points to a buffer to contain the redundant picture header in the orignal bitstream order. The

buffer may be used by the MSL client in playback to pass the decapsulated redundant picture header 

from an RTP payload formatted according to RFC 2429, or used by the MSL client in recording to pass

the picture header to the RTP encapsulator.

@publishedAll

@released

*/

typedef TPtr8* TH263RedundantPictureHeader;

#endif