src/descriptors.cpp - platform/external/mp4v2 - Git at Google

 /*
  * The contents of this file are subject to the Mozilla Public
  * License Version 1.1 (the "License"); you may not use this file
  * except in compliance with the License. You may obtain a copy of
  * the License at http://www.mozilla.org/MPL/
  *
  * Software distributed under the License is distributed on an "AS
  * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  * implied. See the License for the specific language governing
  * rights and limitations under the License.
  *
  * The Original Code is MPEG4IP.
  *
  * The Initial Developer of the Original Code is Cisco Systems Inc.
  * Portions created by Cisco Systems Inc. are
  * Copyright (C) Cisco Systems Inc. 2001.  All Rights Reserved.
  *
  * Contributor(s):
  *      Dave Mackie     dmackie@cisco.com
  */

 #include "src/impl.h"

 namespace mp4v2 {
 namespace impl {

 ///////////////////////////////////////////////////////////////////////////////

 MP4BaseDescriptor::MP4BaseDescriptor (uint8_t tag) : MP4Descriptor(tag)
 {
     switch (tag) {
     case MP4ESIDIncDescrTag:
         AddProperty( /* 0 */
             new MP4Integer32Property("id"));
         break;
     case MP4ESIDRefDescrTag:
         AddProperty( /* 0 */
             new MP4Integer16Property("refIndex"));
         break;
     case MP4IPIPtrDescrTag:
         AddProperty( /* 0 */
             new MP4Integer16Property("IPIESId"));
         break;
     case MP4SupplContentIdDescrTag:
         AddProperty( /* 0 */
             new MP4BytesProperty("languageCode", 3));
         AddProperty( /* 1 */
             new MP4StringProperty("title", Counted));
         AddProperty( /* 2 */
             new MP4StringProperty("value", Counted));
         break;
     case MP4IPMPPtrDescrTag:
         AddProperty( /* 0 */
             new MP4Integer8Property("IPMPDescriptorId"));
         break;
     case MP4ExtProfileLevelDescrTag:
         AddProperty( /* 0 */
             new MP4Integer8Property("profileLevelIndicationIndex"));
         AddProperty( /* 1 */
             new MP4Integer8Property("ODProfileLevelIndication"));
         AddProperty( /* 2 */
             new MP4Integer8Property("sceneProfileLevelIndication"));
         AddProperty( /* 3 */
             new MP4Integer8Property("audioProfileLevelIndication"));
         AddProperty( /* 4 */
             new MP4Integer8Property("visualProfileLevelIndication"));
         AddProperty( /* 5 */
             new MP4Integer8Property("graphicsProfileLevelIndication"));
         AddProperty( /* 6 */
             new MP4Integer8Property("MPEGJProfileLevelIndication"));
         break;
     default:
         MP4Printf("error in base descriptor - tag %u", tag);
         break;

     }
 }

 MP4BytesDescriptor::MP4BytesDescriptor (uint8_t tag) : MP4Descriptor(tag)
 {
     m_size_offset = 0;
     m_bytes_index = 0;
     if (tag >= MP4ExtDescrTagsStart && tag <= MP4ExtDescrTagsEnd) {
         AddProperty( /* 0 */
             new MP4BytesProperty("data"));
     } else {
         switch (tag) {
         case MP4DecSpecificDescrTag:
             AddProperty( /* 0 */
                 new MP4BytesProperty("info"));
             // no change to m_size
             break;
         case MP4IPMPDescrTag:
             AddProperty( /* 0 */
                 new MP4Integer8Property("IPMPDescriptorId"));
             AddProperty( /* 1 */
                 new MP4Integer16Property("IPMPSType"));
             AddProperty( /* 2 */
                 new MP4BytesProperty("IPMPData"));
             /* note: if IPMPSType == 0, IPMPData is an URL */
             m_size_offset = 3;
             m_bytes_index = 2;
             break;
         case MP4RegistrationDescrTag:
             AddProperty( /* 0 */
                 new MP4Integer32Property("formatIdentifier"));
             AddProperty( /* 1 */
                 new MP4BytesProperty("additionalIdentificationInfo"));
             m_size_offset = 4;
             m_bytes_index = 1;
             break;
         default:
             MP4Printf("error in bytes descriptor - tag %u", tag);
             break;
         }
     }
 }

 void MP4BytesDescriptor::Read(MP4File *pFile)
 {
     ReadHeader(pFile);

     /* byte properties need to know how long they are before reading */
     ((MP4BytesProperty*)m_pProperties[m_bytes_index])->SetValueSize(m_size - m_size_offset);

     ReadProperties(pFile);
 }
 MP4IODescriptor::MP4IODescriptor()
         : MP4Descriptor(MP4FileIODescrTag)
 {
     /* N.B. other member functions depend on the property indicies */
     AddProperty( /* 0 */
         new MP4BitfieldProperty("objectDescriptorId", 10));
     AddProperty( /* 1 */
         new MP4BitfieldProperty("URLFlag", 1));
     AddProperty( /* 2 */
         new MP4BitfieldProperty("includeInlineProfileLevelFlag", 1));
     AddProperty( /* 3 */
         new MP4BitfieldProperty("reserved", 4));
     AddProperty( /* 4 */
         new MP4StringProperty("URL", Counted));
     AddProperty( /* 5 */
         new MP4Integer8Property("ODProfileLevelId"));
     AddProperty( /* 6 */
         new MP4Integer8Property("sceneProfileLevelId"));
     AddProperty( /* 7 */
         new MP4Integer8Property("audioProfileLevelId"));
     AddProperty( /* 8 */
         new MP4Integer8Property("visualProfileLevelId"));
     AddProperty( /* 9 */
         new MP4Integer8Property("graphicsProfileLevelId"));
     AddProperty( /* 10 */
         new MP4DescriptorProperty("esIds",
                                   MP4ESIDIncDescrTag, 0, Required, Many));
     AddProperty( /* 11 */
         new MP4DescriptorProperty("ociDescr",
                                   MP4OCIDescrTagsStart, MP4OCIDescrTagsEnd, Optional, Many));
     AddProperty( /* 12 */
         new MP4DescriptorProperty("ipmpDescrPtr",
                                   MP4IPMPPtrDescrTag, 0, Optional, Many));
     AddProperty( /* 13 */
         new MP4DescriptorProperty("extDescr",
                                   MP4ExtDescrTagsStart, MP4ExtDescrTagsEnd, Optional, Many));

     SetReadMutate(2);
 }

 void MP4IODescriptor::Generate()
 {
     ((MP4BitfieldProperty*)m_pProperties[0])->SetValue(1);
     ((MP4BitfieldProperty*)m_pProperties[3])->SetValue(0xF);
     for (uint32_t i = 5; i <= 9; i++) {
         ((MP4Integer8Property*)m_pProperties[i])->SetValue(0xFF);
     }
 }

 void MP4IODescriptor::Mutate()
 {
     bool urlFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();

     m_pProperties[4]->SetImplicit(!urlFlag);
     for (uint32_t i = 5; i <= 12; i++) {
         m_pProperties[i]->SetImplicit(urlFlag);
     }
 }

 MP4ODescriptor::MP4ODescriptor()
         : MP4Descriptor(MP4FileODescrTag)
 {
     /* N.B. other member functions depend on the property indicies */
     AddProperty( /* 0 */
         new MP4BitfieldProperty("objectDescriptorId", 10));
     AddProperty( /* 1 */
         new MP4BitfieldProperty("URLFlag", 1));
     AddProperty( /* 2 */
         new MP4BitfieldProperty("reserved", 5));
     AddProperty( /* 3 */
         new MP4StringProperty("URL", Counted));
     AddProperty( /* 4 */
         new MP4DescriptorProperty("esIds",
                                   MP4ESIDRefDescrTag, 0, Required, Many));
     AddProperty( /* 5 */
         new MP4DescriptorProperty("ociDescr",
                                   MP4OCIDescrTagsStart, MP4OCIDescrTagsEnd, Optional, Many));
     AddProperty( /* 6 */
         new MP4DescriptorProperty("ipmpDescrPtr",
                                   MP4IPMPPtrDescrTag, 0, Optional, Many));
     AddProperty( /* 7 */
         new MP4DescriptorProperty("extDescr",
                                   MP4ExtDescrTagsStart, MP4ExtDescrTagsEnd, Optional, Many));

     SetReadMutate(2);
 }

 void MP4ODescriptor::Generate()
 {
     ((MP4BitfieldProperty*)m_pProperties[2])->SetValue(0x1F);
 }

 void MP4ODescriptor::Mutate()
 {
     bool urlFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();

     m_pProperties[3]->SetImplicit(!urlFlag);
     for (uint32_t i = 4; i <= 6; i++) {
         m_pProperties[i]->SetImplicit(urlFlag);
     }
 }

 MP4ESDescriptor::MP4ESDescriptor()
         : MP4Descriptor(MP4ESDescrTag)
 {
     /* N.B. other class functions depend on the property indicies */
     AddProperty( /* 0 */
         new MP4Integer16Property("ESID"));
     AddProperty( /* 1 */
         new MP4BitfieldProperty("streamDependenceFlag", 1));
     AddProperty( /* 2 */
         new MP4BitfieldProperty("URLFlag", 1));
     AddProperty( /* 3 */
         new MP4BitfieldProperty("OCRstreamFlag", 1));
     AddProperty( /* 4 */
         new MP4BitfieldProperty("streamPriority", 5));
     AddProperty( /* 5 */
         new MP4Integer16Property("dependsOnESID"));
     AddProperty( /* 6 */
         new MP4StringProperty("URL", Counted));
     AddProperty( /* 7 */
         new MP4Integer16Property("OCRESID"));
     AddProperty( /* 8 */
         new MP4DescriptorProperty("decConfigDescr",
                                   MP4DecConfigDescrTag, 0, Required, OnlyOne));
     AddProperty( /* 9 */
         new MP4DescriptorProperty("slConfigDescr",
                                   MP4SLConfigDescrTag, 0, Required, OnlyOne));
     AddProperty( /* 10 */
         new MP4DescriptorProperty("ipiPtr",
                                   MP4IPIPtrDescrTag, 0, Optional, OnlyOne));
     AddProperty( /* 11 */
         new MP4DescriptorProperty("ipIds",
                                   MP4ContentIdDescrTag, MP4SupplContentIdDescrTag, Optional, Many));
     AddProperty( /* 12 */
         new MP4DescriptorProperty("ipmpDescrPtr",
                                   MP4IPMPPtrDescrTag, 0, Optional, Many));
     AddProperty( /* 13 */
         new MP4DescriptorProperty("langDescr",
                                   MP4LanguageDescrTag, 0, Optional, Many));
     AddProperty( /* 14 */
         new MP4DescriptorProperty("qosDescr",
                                   MP4QosDescrTag, 0, Optional, OnlyOne));
     AddProperty( /* 15 */
         new MP4DescriptorProperty("regDescr",
                                   MP4RegistrationDescrTag, 0, Optional, OnlyOne));
     AddProperty( /* 16 */
         new MP4DescriptorProperty("extDescr",
                                   MP4ExtDescrTagsStart, MP4ExtDescrTagsEnd, Optional, Many));

     SetReadMutate(5);
 }

 void MP4ESDescriptor::Mutate()
 {
     bool streamDependFlag =
         ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();
     m_pProperties[5]->SetImplicit(!streamDependFlag);

     bool urlFlag =
         ((MP4BitfieldProperty*)m_pProperties[2])->GetValue();
     m_pProperties[6]->SetImplicit(!urlFlag);

     bool ocrFlag =
         ((MP4BitfieldProperty*)m_pProperties[3])->GetValue();
     m_pProperties[7]->SetImplicit(!ocrFlag);
 }

 MP4DecConfigDescriptor::MP4DecConfigDescriptor()
         : MP4Descriptor(MP4DecConfigDescrTag)
 {
     AddProperty( /* 0 */
         new MP4Integer8Property("objectTypeId"));
     AddProperty( /* 1 */
         new MP4BitfieldProperty("streamType", 6));
     AddProperty( /* 2 */
         new MP4BitfieldProperty("upStream", 1));
     AddProperty( /* 3 */
         new MP4BitfieldProperty("reserved", 1));
     AddProperty( /* 4 */
         new MP4BitfieldProperty("bufferSizeDB", 24));
     AddProperty( /* 5 */
         new MP4Integer32Property("maxBitrate"));
     AddProperty( /* 6 */
         new MP4Integer32Property("avgBitrate"));
     AddProperty( /* 7 */
         new MP4DescriptorProperty("decSpecificInfo",
                                   MP4DecSpecificDescrTag, 0, Optional, OnlyOne));
     AddProperty( /* 8 */
         new MP4DescriptorProperty("profileLevelIndicationIndexDescr",
                                   MP4ExtProfileLevelDescrTag, 0, Optional, Many));
 }

 void MP4DecConfigDescriptor::Generate()
 {
     ((MP4BitfieldProperty*)m_pProperties[3])->SetValue(1);
 }

 MP4SLConfigDescriptor::MP4SLConfigDescriptor()
         : MP4Descriptor(MP4SLConfigDescrTag)
 {
     AddProperty( /* 0 */
         new MP4Integer8Property("predefined"));
     AddProperty( /* 1 */
         new MP4BitfieldProperty("useAccessUnitStartFlag", 1));
     AddProperty( /* 2 */
         new MP4BitfieldProperty("useAccessUnitEndFlag", 1));
     AddProperty( /* 3 */
         new MP4BitfieldProperty("useRandomAccessPointFlag", 1));
     AddProperty( /* 4 */
         new MP4BitfieldProperty("hasRandomAccessUnitsOnlyFlag", 1));
     AddProperty( /* 5 */
         new MP4BitfieldProperty("usePaddingFlag", 1));
     AddProperty( /* 6 */
         new MP4BitfieldProperty("useTimeStampsFlag", 1));
     AddProperty( /* 7 */
         new MP4BitfieldProperty("useIdleFlag", 1));
     AddProperty( /* 8 */
         new MP4BitfieldProperty("durationFlag", 1));
     AddProperty( /* 9 */
         new MP4Integer32Property("timeStampResolution"));
     AddProperty( /* 10 */
         new MP4Integer32Property("OCRResolution"));
     AddProperty( /* 11 */
         new MP4Integer8Property("timeStampLength"));
     AddProperty( /* 12 */
         new MP4Integer8Property("OCRLength"));
     AddProperty( /* 13 */
         new MP4Integer8Property("AULength"));
     AddProperty( /* 14 */
         new MP4Integer8Property("instantBitrateLength"));
     AddProperty( /* 15 */
         new MP4BitfieldProperty("degradationPriortyLength", 4));
     AddProperty( /* 16 */
         new MP4BitfieldProperty("AUSeqNumLength", 5));
     AddProperty( /* 17 */
         new MP4BitfieldProperty("packetSeqNumLength", 5));
     AddProperty( /* 18 */
         new MP4BitfieldProperty("reserved", 2));

     // if durationFlag
     AddProperty( /* 19 */
         new MP4Integer32Property("timeScale"));
     AddProperty( /* 20 */
         new MP4Integer16Property("accessUnitDuration"));
     AddProperty( /* 21 */
         new MP4Integer16Property("compositionUnitDuration"));

     // if !useTimeStampsFlag
     AddProperty( /* 22 */
         new MP4BitfieldProperty("startDecodingTimeStamp", 64));
     AddProperty( /* 23 */
         new MP4BitfieldProperty("startCompositionTimeStamp", 64));
 }

 void MP4SLConfigDescriptor::Generate()
 {
     // by default all tracks in an mp4 file
     // use predefined SLConfig descriptor == 2
     ((MP4Integer8Property*)m_pProperties[0])->SetValue(2);

     // which implies UseTimestampsFlag = 1
     ((MP4BitfieldProperty*)m_pProperties[6])->SetValue(1);

     // reserved = 3
     ((MP4BitfieldProperty*)m_pProperties[18])->SetValue(3);
 }

 void MP4SLConfigDescriptor::Read(MP4File* pFile)
 {
     ReadHeader(pFile);

     // read the first property, 'predefined'
     ReadProperties(pFile, 0, 1);

     // if predefined == 0
     if (((MP4Integer8Property*)m_pProperties[0])->GetValue() == 0) {

         /* read the next 18 properties */
         ReadProperties(pFile, 1, 18);
     }

     // now mutate
     Mutate();

     // and read the remaining properties
     ReadProperties(pFile, 19);
 }

 void MP4SLConfigDescriptor::Mutate()
 {
     uint32_t i;
     uint8_t predefined =
         ((MP4Integer8Property*)m_pProperties[0])->GetValue();

     if (predefined) {
         // properties 1-18 are implicit
         for (i = 1; i < m_pProperties.Size(); i++) {
             m_pProperties[i]->SetImplicit(true);
         }

         if (predefined == 1) {
             // UseTimestampsFlag = 0
             ((MP4BitfieldProperty*)m_pProperties[6])->SetValue(0);

             // TimestampResolution = 1000
             ((MP4Integer32Property*)m_pProperties[9])->SetValue(1000);

             // TimeStampLength = 32
             ((MP4Integer8Property*)m_pProperties[11])->SetValue(32);

         } else if (predefined == 2) {
             // UseTimestampsFlag = 1
             ((MP4BitfieldProperty*)m_pProperties[6])->SetValue(1);
         }
     } else {
 #if 1
         for (i = 1; i <= 18; i++) {
             m_pProperties[i]->SetImplicit(false);
         }
         ((MP4BitfieldProperty*)m_pProperties[18])->SetValue(3);
 #endif
     }

     bool durationFlag =
         ((MP4BitfieldProperty*)m_pProperties[8])->GetValue();

     for (i = 19; i <= 21; i++) {
         m_pProperties[i]->SetImplicit(!durationFlag);
     }

     bool useTimeStampsFlag =
         ((MP4BitfieldProperty*)m_pProperties[6])->GetValue();

     for (i = 22; i <= 23; i++) {
         m_pProperties[i]->SetImplicit(useTimeStampsFlag);

         uint8_t timeStampLength = min((uint8_t)64,
                                       ((MP4Integer8Property*)m_pProperties[11])->GetValue());

         ((MP4BitfieldProperty*)m_pProperties[i])->SetNumBits(timeStampLength);

         // handle a nonsensical situation gracefully
         if (timeStampLength == 0) {
             m_pProperties[i]->SetImplicit(true);
         }
     }
 }

 MP4ContentIdDescriptor::MP4ContentIdDescriptor()
         : MP4Descriptor(MP4ContentIdDescrTag)
 {
     AddProperty( /* 0 */
         new MP4BitfieldProperty("compatibility", 2));
     AddProperty( /* 1 */
         new MP4BitfieldProperty("contentTypeFlag", 1));
     AddProperty( /* 2 */
         new MP4BitfieldProperty("contentIdFlag", 1));
     AddProperty( /* 3 */
         new MP4BitfieldProperty("protectedContent", 1));
     AddProperty( /* 4 */
         new MP4BitfieldProperty("reserved", 3));
     AddProperty( /* 5 */
         new MP4Integer8Property("contentType"));
     AddProperty( /* 6 */
         new MP4Integer8Property("contentIdType"));
     AddProperty( /* 7 */
         new MP4BytesProperty("contentId"));
 }

 void MP4ContentIdDescriptor::Read(MP4File* pFile)
 {
     ReadHeader(pFile);

     /* read the first property, 'compatiblity' */
     ReadProperties(pFile, 0, 1);

     /* if compatiblity != 0 */
     if (((MP4Integer8Property*)m_pProperties[0])->GetValue() != 0) {
         /* we don't understand it */
         VERBOSE_READ(pFile->GetVerbosity(),
                      printf("incompatible content id descriptor\n"));
         return;
     }

     /* read the next four properties */
     ReadProperties(pFile, 1, 4);

     /* which allows us to reconfigure ourselves */
     Mutate();

     bool contentTypeFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();

     bool contentIdFlag = ((MP4BitfieldProperty*)m_pProperties[2])->GetValue();

     if (contentIdFlag) {

         uint32_t cIdOffset = 2;

         if (contentTypeFlag) {

             cIdOffset++;

         }

         ((MP4BytesProperty*)m_pProperties[7])->SetValueSize(m_size - cIdOffset);

     }


     /* read the remaining properties */
     ReadProperties(pFile, 5);
 }

 void MP4ContentIdDescriptor::Mutate()
 {
     bool contentTypeFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();
     m_pProperties[5]->SetImplicit(!contentTypeFlag);

     bool contentIdFlag = ((MP4BitfieldProperty*)m_pProperties[2])->GetValue();
     m_pProperties[6]->SetImplicit(!contentIdFlag);
     m_pProperties[7]->SetImplicit(!contentIdFlag);

 }

 MP4Descriptor* MP4DescriptorProperty::CreateDescriptor(uint8_t tag)
 {
     MP4Descriptor* pDescriptor = NULL;

     switch (tag) {
     case MP4ESDescrTag:
         pDescriptor = new MP4ESDescriptor();
         break;
     case MP4DecConfigDescrTag:
         pDescriptor = new MP4DecConfigDescriptor();
         break;
     case MP4DecSpecificDescrTag:
     case MP4IPMPDescrTag:
     case MP4RegistrationDescrTag:
         pDescriptor = new MP4BytesDescriptor(tag);
         break;
     case MP4SLConfigDescrTag:
         pDescriptor = new MP4SLConfigDescriptor();
         break;
     case MP4ContentIdDescrTag:
         pDescriptor = new MP4ContentIdDescriptor();
         break;
     case MP4ESIDIncDescrTag:
     case MP4ESIDRefDescrTag:
     case MP4IPIPtrDescrTag:
     case MP4SupplContentIdDescrTag:
     case MP4IPMPPtrDescrTag:
     case MP4ExtProfileLevelDescrTag:
         pDescriptor = new MP4BaseDescriptor(tag);
         break;
     case MP4QosDescrTag:
         pDescriptor = new MP4QosDescriptorBase(MP4QosDescrTag);
         break;
     case MP4IODescrTag:
     case MP4FileIODescrTag:
         pDescriptor = new MP4IODescriptor();
         pDescriptor->SetTag(tag);
         break;
     case MP4ODescrTag:
     case MP4FileODescrTag:
         pDescriptor = new MP4ODescriptor();
         pDescriptor->SetTag(tag);
         break;
     }

     if (pDescriptor == NULL) {
         if (tag >= MP4OCIDescrTagsStart && tag <= MP4OCIDescrTagsEnd) {
             pDescriptor = CreateOCIDescriptor(tag);
         }

         if (tag >= MP4ExtDescrTagsStart && tag <= MP4ExtDescrTagsEnd) {
             pDescriptor = new MP4BytesDescriptor(tag);
         }
     }

     return pDescriptor;
 }

 ///////////////////////////////////////////////////////////////////////////////

 }
 } // namespace mp4v2::impl
	/*
	* The contents of this file are subject to the Mozilla Public
	* License Version 1.1 (the "License"); you may not use this file
	* except in compliance with the License. You may obtain a copy of
	* the License at http://www.mozilla.org/MPL/
	*
	* Software distributed under the License is distributed on an "AS
	* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
	* implied. See the License for the specific language governing
	* rights and limitations under the License.
	*
	* The Original Code is MPEG4IP.
	*
	* The Initial Developer of the Original Code is Cisco Systems Inc.
	* Portions created by Cisco Systems Inc. are
	* Copyright (C) Cisco Systems Inc. 2001. All Rights Reserved.
	*
	* Contributor(s):
	* Dave Mackie dmackie@cisco.com
	*/

	#include "src/impl.h"

	namespace mp4v2 {
	namespace impl {

	///////////////////////////////////////////////////////////////////////////////

	MP4BaseDescriptor::MP4BaseDescriptor (uint8_t tag) : MP4Descriptor(tag)
	{
	switch (tag) {
	case MP4ESIDIncDescrTag:
	AddProperty( /* 0 */
	new MP4Integer32Property("id"));
	break;
	case MP4ESIDRefDescrTag:
	AddProperty( /* 0 */
	new MP4Integer16Property("refIndex"));
	break;
	case MP4IPIPtrDescrTag:
	AddProperty( /* 0 */
	new MP4Integer16Property("IPIESId"));
	break;
	case MP4SupplContentIdDescrTag:
	AddProperty( /* 0 */
	new MP4BytesProperty("languageCode", 3));
	AddProperty( /* 1 */
	new MP4StringProperty("title", Counted));
	AddProperty( /* 2 */
	new MP4StringProperty("value", Counted));
	break;
	case MP4IPMPPtrDescrTag:
	AddProperty( /* 0 */
	new MP4Integer8Property("IPMPDescriptorId"));
	break;
	case MP4ExtProfileLevelDescrTag:
	AddProperty( /* 0 */
	new MP4Integer8Property("profileLevelIndicationIndex"));
	AddProperty( /* 1 */
	new MP4Integer8Property("ODProfileLevelIndication"));
	AddProperty( /* 2 */
	new MP4Integer8Property("sceneProfileLevelIndication"));
	AddProperty( /* 3 */
	new MP4Integer8Property("audioProfileLevelIndication"));
	AddProperty( /* 4 */
	new MP4Integer8Property("visualProfileLevelIndication"));
	AddProperty( /* 5 */
	new MP4Integer8Property("graphicsProfileLevelIndication"));
	AddProperty( /* 6 */
	new MP4Integer8Property("MPEGJProfileLevelIndication"));
	break;
	default:
	MP4Printf("error in base descriptor - tag %u", tag);
	break;

	}
	}

	MP4BytesDescriptor::MP4BytesDescriptor (uint8_t tag) : MP4Descriptor(tag)
	{
	m_size_offset = 0;
	m_bytes_index = 0;
	if (tag >= MP4ExtDescrTagsStart && tag <= MP4ExtDescrTagsEnd) {
	AddProperty( /* 0 */
	new MP4BytesProperty("data"));
	} else {
	switch (tag) {
	case MP4DecSpecificDescrTag:
	AddProperty( /* 0 */
	new MP4BytesProperty("info"));
	// no change to m_size
	break;
	case MP4IPMPDescrTag:
	AddProperty( /* 0 */
	new MP4Integer8Property("IPMPDescriptorId"));
	AddProperty( /* 1 */
	new MP4Integer16Property("IPMPSType"));
	AddProperty( /* 2 */
	new MP4BytesProperty("IPMPData"));
	/* note: if IPMPSType == 0, IPMPData is an URL */
	m_size_offset = 3;
	m_bytes_index = 2;
	break;
	case MP4RegistrationDescrTag:
	AddProperty( /* 0 */
	new MP4Integer32Property("formatIdentifier"));
	AddProperty( /* 1 */
	new MP4BytesProperty("additionalIdentificationInfo"));
	m_size_offset = 4;
	m_bytes_index = 1;
	break;
	default:
	MP4Printf("error in bytes descriptor - tag %u", tag);
	break;
	}
	}
	}

	void MP4BytesDescriptor::Read(MP4File *pFile)
	{
	ReadHeader(pFile);

	/* byte properties need to know how long they are before reading */
	((MP4BytesProperty*)m_pProperties[m_bytes_index])->SetValueSize(m_size - m_size_offset);

	ReadProperties(pFile);
	}
	MP4IODescriptor::MP4IODescriptor()
	: MP4Descriptor(MP4FileIODescrTag)
	{
	/* N.B. other member functions depend on the property indicies */
	AddProperty( /* 0 */
	new MP4BitfieldProperty("objectDescriptorId", 10));
	AddProperty( /* 1 */
	new MP4BitfieldProperty("URLFlag", 1));
	AddProperty( /* 2 */
	new MP4BitfieldProperty("includeInlineProfileLevelFlag", 1));
	AddProperty( /* 3 */
	new MP4BitfieldProperty("reserved", 4));
	AddProperty( /* 4 */
	new MP4StringProperty("URL", Counted));
	AddProperty( /* 5 */
	new MP4Integer8Property("ODProfileLevelId"));
	AddProperty( /* 6 */
	new MP4Integer8Property("sceneProfileLevelId"));
	AddProperty( /* 7 */
	new MP4Integer8Property("audioProfileLevelId"));
	AddProperty( /* 8 */
	new MP4Integer8Property("visualProfileLevelId"));
	AddProperty( /* 9 */
	new MP4Integer8Property("graphicsProfileLevelId"));
	AddProperty( /* 10 */
	new MP4DescriptorProperty("esIds",
	MP4ESIDIncDescrTag, 0, Required, Many));
	AddProperty( /* 11 */
	new MP4DescriptorProperty("ociDescr",
	MP4OCIDescrTagsStart, MP4OCIDescrTagsEnd, Optional, Many));
	AddProperty( /* 12 */
	new MP4DescriptorProperty("ipmpDescrPtr",
	MP4IPMPPtrDescrTag, 0, Optional, Many));
	AddProperty( /* 13 */
	new MP4DescriptorProperty("extDescr",
	MP4ExtDescrTagsStart, MP4ExtDescrTagsEnd, Optional, Many));

	SetReadMutate(2);
	}

	void MP4IODescriptor::Generate()
	{
	((MP4BitfieldProperty*)m_pProperties[0])->SetValue(1);
	((MP4BitfieldProperty*)m_pProperties[3])->SetValue(0xF);
	for (uint32_t i = 5; i <= 9; i++) {
	((MP4Integer8Property*)m_pProperties[i])->SetValue(0xFF);
	}
	}

	void MP4IODescriptor::Mutate()
	{
	bool urlFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();

	m_pProperties[4]->SetImplicit(!urlFlag);
	for (uint32_t i = 5; i <= 12; i++) {
	m_pProperties[i]->SetImplicit(urlFlag);
	}
	}

	MP4ODescriptor::MP4ODescriptor()
	: MP4Descriptor(MP4FileODescrTag)
	{
	/* N.B. other member functions depend on the property indicies */
	AddProperty( /* 0 */
	new MP4BitfieldProperty("objectDescriptorId", 10));
	AddProperty( /* 1 */
	new MP4BitfieldProperty("URLFlag", 1));
	AddProperty( /* 2 */
	new MP4BitfieldProperty("reserved", 5));
	AddProperty( /* 3 */
	new MP4StringProperty("URL", Counted));
	AddProperty( /* 4 */
	new MP4DescriptorProperty("esIds",
	MP4ESIDRefDescrTag, 0, Required, Many));
	AddProperty( /* 5 */
	new MP4DescriptorProperty("ociDescr",
	MP4OCIDescrTagsStart, MP4OCIDescrTagsEnd, Optional, Many));
	AddProperty( /* 6 */
	new MP4DescriptorProperty("ipmpDescrPtr",
	MP4IPMPPtrDescrTag, 0, Optional, Many));
	AddProperty( /* 7 */
	new MP4DescriptorProperty("extDescr",
	MP4ExtDescrTagsStart, MP4ExtDescrTagsEnd, Optional, Many));

	SetReadMutate(2);
	}

	void MP4ODescriptor::Generate()
	{
	((MP4BitfieldProperty*)m_pProperties[2])->SetValue(0x1F);
	}

	void MP4ODescriptor::Mutate()
	{
	bool urlFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();

	m_pProperties[3]->SetImplicit(!urlFlag);
	for (uint32_t i = 4; i <= 6; i++) {
	m_pProperties[i]->SetImplicit(urlFlag);
	}
	}

	MP4ESDescriptor::MP4ESDescriptor()
	: MP4Descriptor(MP4ESDescrTag)
	{
	/* N.B. other class functions depend on the property indicies */
	AddProperty( /* 0 */
	new MP4Integer16Property("ESID"));
	AddProperty( /* 1 */
	new MP4BitfieldProperty("streamDependenceFlag", 1));
	AddProperty( /* 2 */
	new MP4BitfieldProperty("URLFlag", 1));
	AddProperty( /* 3 */
	new MP4BitfieldProperty("OCRstreamFlag", 1));
	AddProperty( /* 4 */
	new MP4BitfieldProperty("streamPriority", 5));
	AddProperty( /* 5 */
	new MP4Integer16Property("dependsOnESID"));
	AddProperty( /* 6 */
	new MP4StringProperty("URL", Counted));
	AddProperty( /* 7 */
	new MP4Integer16Property("OCRESID"));
	AddProperty( /* 8 */
	new MP4DescriptorProperty("decConfigDescr",
	MP4DecConfigDescrTag, 0, Required, OnlyOne));
	AddProperty( /* 9 */
	new MP4DescriptorProperty("slConfigDescr",
	MP4SLConfigDescrTag, 0, Required, OnlyOne));
	AddProperty( /* 10 */
	new MP4DescriptorProperty("ipiPtr",
	MP4IPIPtrDescrTag, 0, Optional, OnlyOne));
	AddProperty( /* 11 */
	new MP4DescriptorProperty("ipIds",
	MP4ContentIdDescrTag, MP4SupplContentIdDescrTag, Optional, Many));
	AddProperty( /* 12 */
	new MP4DescriptorProperty("ipmpDescrPtr",
	MP4IPMPPtrDescrTag, 0, Optional, Many));
	AddProperty( /* 13 */
	new MP4DescriptorProperty("langDescr",
	MP4LanguageDescrTag, 0, Optional, Many));
	AddProperty( /* 14 */
	new MP4DescriptorProperty("qosDescr",
	MP4QosDescrTag, 0, Optional, OnlyOne));
	AddProperty( /* 15 */
	new MP4DescriptorProperty("regDescr",
	MP4RegistrationDescrTag, 0, Optional, OnlyOne));
	AddProperty( /* 16 */
	new MP4DescriptorProperty("extDescr",
	MP4ExtDescrTagsStart, MP4ExtDescrTagsEnd, Optional, Many));

	SetReadMutate(5);
	}

	void MP4ESDescriptor::Mutate()
	{
	bool streamDependFlag =
	((MP4BitfieldProperty*)m_pProperties[1])->GetValue();
	m_pProperties[5]->SetImplicit(!streamDependFlag);

	bool urlFlag =
	((MP4BitfieldProperty*)m_pProperties[2])->GetValue();
	m_pProperties[6]->SetImplicit(!urlFlag);

	bool ocrFlag =
	((MP4BitfieldProperty*)m_pProperties[3])->GetValue();
	m_pProperties[7]->SetImplicit(!ocrFlag);
	}

	MP4DecConfigDescriptor::MP4DecConfigDescriptor()
	: MP4Descriptor(MP4DecConfigDescrTag)
	{
	AddProperty( /* 0 */
	new MP4Integer8Property("objectTypeId"));
	AddProperty( /* 1 */
	new MP4BitfieldProperty("streamType", 6));
	AddProperty( /* 2 */
	new MP4BitfieldProperty("upStream", 1));
	AddProperty( /* 3 */
	new MP4BitfieldProperty("reserved", 1));
	AddProperty( /* 4 */
	new MP4BitfieldProperty("bufferSizeDB", 24));
	AddProperty( /* 5 */
	new MP4Integer32Property("maxBitrate"));
	AddProperty( /* 6 */
	new MP4Integer32Property("avgBitrate"));
	AddProperty( /* 7 */
	new MP4DescriptorProperty("decSpecificInfo",
	MP4DecSpecificDescrTag, 0, Optional, OnlyOne));
	AddProperty( /* 8 */
	new MP4DescriptorProperty("profileLevelIndicationIndexDescr",
	MP4ExtProfileLevelDescrTag, 0, Optional, Many));
	}

	void MP4DecConfigDescriptor::Generate()
	{
	((MP4BitfieldProperty*)m_pProperties[3])->SetValue(1);
	}

	MP4SLConfigDescriptor::MP4SLConfigDescriptor()
	: MP4Descriptor(MP4SLConfigDescrTag)
	{
	AddProperty( /* 0 */
	new MP4Integer8Property("predefined"));
	AddProperty( /* 1 */
	new MP4BitfieldProperty("useAccessUnitStartFlag", 1));
	AddProperty( /* 2 */
	new MP4BitfieldProperty("useAccessUnitEndFlag", 1));
	AddProperty( /* 3 */
	new MP4BitfieldProperty("useRandomAccessPointFlag", 1));
	AddProperty( /* 4 */
	new MP4BitfieldProperty("hasRandomAccessUnitsOnlyFlag", 1));
	AddProperty( /* 5 */
	new MP4BitfieldProperty("usePaddingFlag", 1));
	AddProperty( /* 6 */
	new MP4BitfieldProperty("useTimeStampsFlag", 1));
	AddProperty( /* 7 */
	new MP4BitfieldProperty("useIdleFlag", 1));
	AddProperty( /* 8 */
	new MP4BitfieldProperty("durationFlag", 1));
	AddProperty( /* 9 */
	new MP4Integer32Property("timeStampResolution"));
	AddProperty( /* 10 */
	new MP4Integer32Property("OCRResolution"));
	AddProperty( /* 11 */
	new MP4Integer8Property("timeStampLength"));
	AddProperty( /* 12 */
	new MP4Integer8Property("OCRLength"));
	AddProperty( /* 13 */
	new MP4Integer8Property("AULength"));
	AddProperty( /* 14 */
	new MP4Integer8Property("instantBitrateLength"));
	AddProperty( /* 15 */
	new MP4BitfieldProperty("degradationPriortyLength", 4));
	AddProperty( /* 16 */
	new MP4BitfieldProperty("AUSeqNumLength", 5));
	AddProperty( /* 17 */
	new MP4BitfieldProperty("packetSeqNumLength", 5));
	AddProperty( /* 18 */
	new MP4BitfieldProperty("reserved", 2));

	// if durationFlag
	AddProperty( /* 19 */
	new MP4Integer32Property("timeScale"));
	AddProperty( /* 20 */
	new MP4Integer16Property("accessUnitDuration"));
	AddProperty( /* 21 */
	new MP4Integer16Property("compositionUnitDuration"));

	// if !useTimeStampsFlag
	AddProperty( /* 22 */
	new MP4BitfieldProperty("startDecodingTimeStamp", 64));
	AddProperty( /* 23 */
	new MP4BitfieldProperty("startCompositionTimeStamp", 64));
	}

	void MP4SLConfigDescriptor::Generate()
	{
	// by default all tracks in an mp4 file
	// use predefined SLConfig descriptor == 2
	((MP4Integer8Property*)m_pProperties[0])->SetValue(2);

	// which implies UseTimestampsFlag = 1
	((MP4BitfieldProperty*)m_pProperties[6])->SetValue(1);

	// reserved = 3
	((MP4BitfieldProperty*)m_pProperties[18])->SetValue(3);
	}

	void MP4SLConfigDescriptor::Read(MP4File* pFile)
	{
	ReadHeader(pFile);

	// read the first property, 'predefined'
	ReadProperties(pFile, 0, 1);

	// if predefined == 0
	if (((MP4Integer8Property*)m_pProperties[0])->GetValue() == 0) {

	/* read the next 18 properties */
	ReadProperties(pFile, 1, 18);
	}

	// now mutate
	Mutate();

	// and read the remaining properties
	ReadProperties(pFile, 19);
	}

	void MP4SLConfigDescriptor::Mutate()
	{
	uint32_t i;
	uint8_t predefined =
	((MP4Integer8Property*)m_pProperties[0])->GetValue();

	if (predefined) {
	// properties 1-18 are implicit
	for (i = 1; i < m_pProperties.Size(); i++) {
	m_pProperties[i]->SetImplicit(true);
	}

	if (predefined == 1) {
	// UseTimestampsFlag = 0
	((MP4BitfieldProperty*)m_pProperties[6])->SetValue(0);

	// TimestampResolution = 1000
	((MP4Integer32Property*)m_pProperties[9])->SetValue(1000);

	// TimeStampLength = 32
	((MP4Integer8Property*)m_pProperties[11])->SetValue(32);

	} else if (predefined == 2) {
	// UseTimestampsFlag = 1
	((MP4BitfieldProperty*)m_pProperties[6])->SetValue(1);
	}
	} else {
	#if 1
	for (i = 1; i <= 18; i++) {
	m_pProperties[i]->SetImplicit(false);
	}
	((MP4BitfieldProperty*)m_pProperties[18])->SetValue(3);
	#endif
	}

	bool durationFlag =
	((MP4BitfieldProperty*)m_pProperties[8])->GetValue();

	for (i = 19; i <= 21; i++) {
	m_pProperties[i]->SetImplicit(!durationFlag);
	}

	bool useTimeStampsFlag =
	((MP4BitfieldProperty*)m_pProperties[6])->GetValue();

	for (i = 22; i <= 23; i++) {
	m_pProperties[i]->SetImplicit(useTimeStampsFlag);

	uint8_t timeStampLength = min((uint8_t)64,
	((MP4Integer8Property*)m_pProperties[11])->GetValue());

	((MP4BitfieldProperty*)m_pProperties[i])->SetNumBits(timeStampLength);

	// handle a nonsensical situation gracefully
	if (timeStampLength == 0) {
	m_pProperties[i]->SetImplicit(true);
	}
	}
	}

	MP4ContentIdDescriptor::MP4ContentIdDescriptor()
	: MP4Descriptor(MP4ContentIdDescrTag)
	{
	AddProperty( /* 0 */
	new MP4BitfieldProperty("compatibility", 2));
	AddProperty( /* 1 */
	new MP4BitfieldProperty("contentTypeFlag", 1));
	AddProperty( /* 2 */
	new MP4BitfieldProperty("contentIdFlag", 1));
	AddProperty( /* 3 */
	new MP4BitfieldProperty("protectedContent", 1));
	AddProperty( /* 4 */
	new MP4BitfieldProperty("reserved", 3));
	AddProperty( /* 5 */
	new MP4Integer8Property("contentType"));
	AddProperty( /* 6 */
	new MP4Integer8Property("contentIdType"));
	AddProperty( /* 7 */
	new MP4BytesProperty("contentId"));
	}

	void MP4ContentIdDescriptor::Read(MP4File* pFile)
	{
	ReadHeader(pFile);

	/* read the first property, 'compatiblity' */
	ReadProperties(pFile, 0, 1);

	/* if compatiblity != 0 */
	if (((MP4Integer8Property*)m_pProperties[0])->GetValue() != 0) {
	/* we don't understand it */
	VERBOSE_READ(pFile->GetVerbosity(),
	printf("incompatible content id descriptor\n"));
	return;
	}

	/* read the next four properties */
	ReadProperties(pFile, 1, 4);

	/* which allows us to reconfigure ourselves */
	Mutate();

	bool contentTypeFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();

	bool contentIdFlag = ((MP4BitfieldProperty*)m_pProperties[2])->GetValue();

	if (contentIdFlag) {

	uint32_t cIdOffset = 2;

	if (contentTypeFlag) {

	cIdOffset++;

	}

	((MP4BytesProperty*)m_pProperties[7])->SetValueSize(m_size - cIdOffset);

	}



	/* read the remaining properties */
	ReadProperties(pFile, 5);
	}

	void MP4ContentIdDescriptor::Mutate()
	{
	bool contentTypeFlag = ((MP4BitfieldProperty*)m_pProperties[1])->GetValue();
	m_pProperties[5]->SetImplicit(!contentTypeFlag);

	bool contentIdFlag = ((MP4BitfieldProperty*)m_pProperties[2])->GetValue();
	m_pProperties[6]->SetImplicit(!contentIdFlag);
	m_pProperties[7]->SetImplicit(!contentIdFlag);

	}

	MP4Descriptor* MP4DescriptorProperty::CreateDescriptor(uint8_t tag)
	{
	MP4Descriptor* pDescriptor = NULL;

	switch (tag) {
	case MP4ESDescrTag:
	pDescriptor = new MP4ESDescriptor();
	break;
	case MP4DecConfigDescrTag:
	pDescriptor = new MP4DecConfigDescriptor();
	break;
	case MP4DecSpecificDescrTag:
	case MP4IPMPDescrTag:
	case MP4RegistrationDescrTag:
	pDescriptor = new MP4BytesDescriptor(tag);
	break;
	case MP4SLConfigDescrTag:
	pDescriptor = new MP4SLConfigDescriptor();
	break;
	case MP4ContentIdDescrTag:
	pDescriptor = new MP4ContentIdDescriptor();
	break;
	case MP4ESIDIncDescrTag:
	case MP4ESIDRefDescrTag:
	case MP4IPIPtrDescrTag:
	case MP4SupplContentIdDescrTag:
	case MP4IPMPPtrDescrTag:
	case MP4ExtProfileLevelDescrTag:
	pDescriptor = new MP4BaseDescriptor(tag);
	break;
	case MP4QosDescrTag:
	pDescriptor = new MP4QosDescriptorBase(MP4QosDescrTag);
	break;
	case MP4IODescrTag:
	case MP4FileIODescrTag:
	pDescriptor = new MP4IODescriptor();
	pDescriptor->SetTag(tag);
	break;
	case MP4ODescrTag:
	case MP4FileODescrTag:
	pDescriptor = new MP4ODescriptor();
	pDescriptor->SetTag(tag);
	break;
	}

	if (pDescriptor == NULL) {
	if (tag >= MP4OCIDescrTagsStart && tag <= MP4OCIDescrTagsEnd) {
	pDescriptor = CreateOCIDescriptor(tag);
	}

	if (tag >= MP4ExtDescrTagsStart && tag <= MP4ExtDescrTagsEnd) {
	pDescriptor = new MP4BytesDescriptor(tag);
	}
	}

	return pDescriptor;
	}

	///////////////////////////////////////////////////////////////////////////////

	}
	} // namespace mp4v2::impl