00001 /***************************************************************** 00002 | 00003 | AP4 - File Processor 00004 | 00005 | Copyright 2003 Gilles Boccon-Gibod & Julien Boeuf 00006 | 00007 | 00008 | This file is part of Bento4/AP4 (MP4 Atom Processing Library). 00009 | 00010 | Unless you have obtained Bento4 under a difference license, 00011 | this version of Bento4 is Bento4|GPL. 00012 | Bento4|GPL is free software; you can redistribute it and/or modify 00013 | it under the terms of the GNU General Public License as published by 00014 | the Free Software Foundation; either version 2, or (at your option) 00015 | any later version. 00016 | 00017 | Bento4|GPL is distributed in the hope that it will be useful, 00018 | but WITHOUT ANY WARRANTY; without even the implied warranty of 00019 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00020 | GNU General Public License for more details. 00021 | 00022 | You should have received a copy of the GNU General Public License 00023 | along with Bento4|GPL; see the file COPYING. If not, write to the 00024 | Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 00025 | 02111-1307, USA. 00026 | 00027 ****************************************************************/ 00028 00029 #ifndef _AP4_PROCESSOR_H_ 00030 #define _AP4_PROCESSOR_H_ 00031 00032 /*---------------------------------------------------------------------- 00033 | includes 00034 +---------------------------------------------------------------------*/ 00035 #include "Ap4Types.h" 00036 #include "Ap4AtomFactory.h" 00037 #include "Ap4File.h" 00038 #include "Ap4Track.h" 00039 00040 /*---------------------------------------------------------------------- 00041 | class references 00042 +---------------------------------------------------------------------*/ 00043 class AP4_ContainerAtom; 00044 class AP4_Sample; 00045 class AP4_ByteStream; 00046 class AP4_DataBuffer; 00047 class AP4_TrakAtom; 00048 00049 /*---------------------------------------------------------------------- 00050 | AP4_Processor 00051 +---------------------------------------------------------------------*/ 00052 class AP4_Processor { 00053 public: 00059 class ProgressListener { 00060 public: 00061 virtual ~ProgressListener() {} 00062 00073 virtual AP4_Result OnProgress(unsigned int step, 00074 unsigned int total) = 0; 00075 }; 00076 00082 class TrackHandler { 00083 public: 00087 virtual ~TrackHandler() {} 00088 00094 virtual AP4_Size GetProcessedSampleSize(AP4_Sample& sample); 00095 00100 virtual AP4_Result ProcessTrack() { return AP4_SUCCESS; } 00101 00108 virtual AP4_Result ProcessSample(AP4_DataBuffer& data_in, 00109 AP4_DataBuffer& data_out) = 0; 00110 }; 00111 00115 virtual ~AP4_Processor() {} 00116 00126 AP4_Result Process(AP4_ByteStream& input, 00127 AP4_ByteStream& output, 00128 ProgressListener* listener = NULL, 00129 AP4_AtomFactory& atom_factory = 00130 AP4_DefaultAtomFactory::Instance); 00131 00141 virtual AP4_Result Initialize(AP4_AtomParent& top_level, 00142 AP4_ByteStream& stream, 00143 ProgressListener* listener = NULL); 00144 00149 virtual AP4_Result Finalize(AP4_AtomParent& top_level, 00150 ProgressListener* listener = NULL); 00151 00160 virtual TrackHandler* CreateTrackHandler(AP4_TrakAtom* trak); 00161 }; 00162 00163 #endif // _AP4_PROCESSOR_H_