/*
 * 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
 */

#ifndef __MP4_DESCRIPTOR_INCLUDED__
#define __MP4_DESCRIPTOR_INCLUDED__

class MP4Descriptor {
public:
	MP4Descriptor(u_int8_t tag = 0);

	virtual ~MP4Descriptor();

	u_int8_t GetTag() {
		return m_tag;
	}
	void SetTag(u_int8_t tag) {
		m_tag = tag;
	}

	void SetParentAtom(MP4Atom* pParentAtom) {
		m_pParentAtom = pParentAtom;
		for (u_int32_t i = 0; i < m_pProperties.Size(); i++) {
			m_pProperties[i]->SetParentAtom(pParentAtom);
		}
	}

	void AddProperty(MP4Property* pProperty);

	virtual void Generate();
	virtual void Read(MP4File* pFile);
	virtual void Write(MP4File* pFile);

	MP4Property* GetProperty(u_int32_t index) {
		return m_pProperties[index];
	}

	// use with extreme caution
	void SetProperty(u_int32_t index, MP4Property* pProperty) {
		m_pProperties[index] = pProperty;
	}

	bool FindProperty(const char* name, 
	  MP4Property** ppProperty, u_int32_t* pIndex = NULL) {
		return FindContainedProperty(name, ppProperty, pIndex);
	}

	void WriteToMemory(MP4File* pFile,
		 u_int8_t** ppBytes, u_int64_t* pNumBytes);

protected:
	void SetReadMutate(u_int32_t propIndex) {
		m_readMutatePoint = propIndex;
	}

	void ReadHeader(MP4File* pFile);
	void ReadProperties(MP4File* pFile,
		u_int32_t startIndex = 0, u_int32_t count = 0xFFFFFFFF);

	virtual void Mutate() {
		// default is a no-op
	};

	bool FindContainedProperty(const char* name,
		MP4Property** ppProperty, u_int32_t* pIndex);

	u_int8_t GetDepth();

protected:
	MP4Atom*			m_pParentAtom;
	u_int8_t			m_tag;
	u_int64_t			m_start;
	u_int32_t			m_size;
	MP4PropertyArray	m_pProperties;
	u_int32_t			m_readMutatePoint;
};

#endif /* __MP4_DESCRIPTOR_INCLUDED__ */