Dirac - A Video Codec

Created by the British Broadcasting Corporation.


parseunit_byteio.h
Go to the documentation of this file.
1 /* ***** BEGIN LICENSE BLOCK *****
2 *
3 * $Id: parseunit_byteio.h,v 1.11 2008/05/02 05:57:19 asuraparaju Exp $ $Name: Dirac_1_0_2 $
4 *
5 * Version: MPL 1.1/GPL 2.0/LGPL 2.1
6 *
7 * The contents of this file are subject to the Mozilla Public License
8 * Version 1.1 (the "License"); you may not use this file except in compliance
9 * with the License. You may obtain a copy of the License at
10 * http://www.mozilla.org/MPL/
11 *
12 * Software distributed under the License is distributed on an "AS IS" basis,
13 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
14 * the specific language governing rights and limitations under the License.
15 *
16 * The Original Code is BBC Research and Development code.
17 *
18 * The Initial Developer of the Original Code is the British Broadcasting
19 * Corporation.
20 * Portions created by the Initial Developer are Copyright (C) 2004.
21 * All Rights Reserved.
22 *
23 * Contributor(s): Andrew Kennedy (Original Author)
24 * Anuradha Suraparaju
25 *
26 * Alternatively, the contents of this file may be used under the terms of
27 * the GNU General Public License Version 2 (the "GPL"), or the GNU Lesser
28 * Public License Version 2.1 (the "LGPL"), in which case the provisions of
29 * the GPL or the LGPL are applicable instead of those above. If you wish to
30 * allow use of your version of this file only under the terms of the either
31 * the GPL or LGPL and not to allow others to use your version of this file
32 * under the MPL, indicate your decision by deleting the provisions above
33 * and replace them with the notice and other provisions required by the GPL
34 * or LGPL. If you do not delete the provisions above, a recipient may use
35 * your version of this file under the terms of any one of the MPL, the GPL
36 * or the LGPL.
37 * ***** END LICENSE BLOCK ***** */
38 
42 #ifndef parseunit_byteio_h
43 #define parseunit_byteio_h
44 
45 //SYSTEM INLUDES
46 #include <map> // Byte-map
47 #include <string> // stores values
48 
49 //LOCAL INCLUDES
50 #include "byteio.h" // Parent class
51 
52 
53 namespace dirac
54 {
55 
56  /* Types of parse-unit */
57  typedef enum {
66  } ParseUnitType;
67 
72  class ParseUnitByteIO : public ByteIO
73  {
74  public:
75 
80 
85  ParseUnitByteIO(const ByteIO& byte_io);
86 
91  ParseUnitByteIO(const ParseUnitByteIO& parseunit_byteio);
92 
97 
102  virtual void CollateByteStats(DiracByteStats& dirac_byte_stats);
103 
108  bool Input(); // decoding
109 
113  bool IsValid();
114 
119  bool CanSkip();
120 
124  virtual const std::string GetBytes(); // encoding
125 
130  void SetAdjacentParseUnits(ParseUnitByteIO *p_prev_parseunit); // encoding
131 
132  /*
133  * Gets number of bytes input/output within unit
134  */
135  virtual int GetSize() const;
136 
140  int GetNextParseOffset() const;
141 
145  int GetPreviousParseOffset() const;
146 
150  virtual ParseUnitType GetType() const;
151 
155  bool IsSeqHeader() const
156  { return m_parse_code==0x00; }
157 
161  bool IsEndOfSequence() const
162  { return m_parse_code==0x10; }
163 
167  bool IsAuxiliaryData() const
168  { return (m_parse_code&0xF8)==0x20; }
169 
173  bool IsPaddingData() const
174  { return m_parse_code==0x30; }
175 
179  bool IsPicture() const
180  { return ((m_parse_code&0x08)==0x08); }
181 
185  bool IsLowDelay() const
186  { return ((m_parse_code&0x88)==0x88); }
187 
191  bool IsCoreSyntax() const
192  { return ((m_parse_code&0x88)==0x08); }
193 
197  bool IsUsingAC() const
198  { return ((m_parse_code&0x48)==0x08); }
199 
200  protected:
201 
206  virtual int CalcNextUnitOffset();
207 
212  virtual unsigned char CalcParseCode() const { return 0;} // encoding
213 
218  bool SyncToUnitStart(); // decoding
219 
223  unsigned char GetParseCode() const { return m_parse_code;}
224 
225  private:
226 
231 
236 
240  unsigned char m_parse_code;
241 
242  };
243 
244 
245 } // namespace dirac
246 
247 #endif
Definition: parseunit_byteio.h:58
Definition: parseunit_byteio.h:61
bool IsEndOfSequence() const
Returns true is parse unit is an End of Sequence unit.
Definition: parseunit_byteio.h:161
Definition: parseunit_byteio.h:63
Definition: parseunit_byteio.h:60
void SetAdjacentParseUnits(ParseUnitByteIO *p_prev_parseunit)
Set next/previous parse-unit values.
ParseUnitType
Definition: parseunit_byteio.h:57
bool Input()
Reads from byte-stream to find parse data.
virtual int CalcNextUnitOffset()
Calculates number of bytes to start of next unit.
Definition: parseunit_byteio.h:62
bool IsAuxiliaryData() const
Returns true is parse unit is Auxiliary Data.
Definition: parseunit_byteio.h:167
virtual const std::string GetBytes()
Gets string containing coded bytes.
unsigned char m_parse_code
Parse-type-identifier.
Definition: parseunit_byteio.h:240
int GetPreviousParseOffset() const
Gets number of bytes to start of previous parse-unit.
bool IsPaddingData() const
Returns true is parse unit is Padding data.
Definition: parseunit_byteio.h:173
~ParseUnitByteIO()
Destructor.
Definition: parseunit_byteio.h:59
int m_next_parse_offset
Number of bytes to previous parse-unit.
Definition: parseunit_byteio.h:235
Definition: parseunit_byteio.h:64
bool IsLowDelay() const
Returns true is parse unit is Low Delay Sybtax unit.
Definition: parseunit_byteio.h:185
bool IsSeqHeader() const
Returns true is parse unit is a Sequence Header.
Definition: parseunit_byteio.h:155
virtual void CollateByteStats(DiracByteStats &dirac_byte_stats)
Gathers byte stats on the parse-unit data.
bool CanSkip()
Can Skip past the entire parse-unit.
Class DiracByteStats - for collecting statistics on aspects of the Dirac byte-stream.
Definition: dirac_byte_stats.h:70
bool IsCoreSyntax() const
Returns true is parse unit is Core syntax unit.
Definition: parseunit_byteio.h:191
virtual int GetSize() const
Gets size (in bytes)
int GetNextParseOffset() const
Gets expected number of bytes to start of next parse-unit.
int m_previous_parse_offset
Number of bytes to next parse-unit.
Definition: parseunit_byteio.h:230
unsigned char GetParseCode() const
Get parse code.
Definition: parseunit_byteio.h:223
bool IsUsingAC() const
Returns true is parse unit uses Arithmetic coding.
Definition: parseunit_byteio.h:197
virtual unsigned char CalcParseCode() const
Pure virtual method for calculating parse-code.
Definition: parseunit_byteio.h:212
bool IsPicture() const
Returns true is parse unit is Picture data.
Definition: parseunit_byteio.h:179
Class ByteIO - top-level class for reading/writing bytes to a stream.
Definition: byteio.h:72
virtual ParseUnitType GetType() const
Gets parse-unit type.
Definition: parseunit_byteio.h:65
Represents a collection of data in a Dirac bytestream that can be parsed as a self-contained unit...
Definition: parseunit_byteio.h:72
bool IsValid()
Accesses validity of a unit by comparing it with an adjacent unit.
bool SyncToUnitStart()
Locates start of parse-unit.
ParseUnitByteIO()
Constructor.

© 2004 British Broadcasting Corporation. Dirac code licensed under the Mozilla Public License (MPL) Version 1.1.
HTML documentation generated by Dimitri van Heesch's excellent Doxygen tool.