- Main Page
- Classes
- Files

# Ap4Processor.h

Go to the documentation of this file.

    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_