vtkXMLDataParser.h

Go to the documentation of this file.

/*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkXMLDataParser.h
 
  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
 
     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.
 
=========================================================================*/
#ifndef vtkXMLDataParser_h
#define vtkXMLDataParser_h
 
#include "vtkIOXMLParserModule.h" // For export macro
#include "vtkXMLParser.h"
#include "vtkXMLDataElement.h"//For inline definition.
 
class vtkInputStream;
class vtkDataCompressor;
 
class VTKIOXMLPARSER_EXPORT vtkXMLDataParser : public vtkXMLParser
{
public:
  vtkTypeMacro(vtkXMLDataParser,vtkXMLParser);
  void PrintSelf(ostream& os, vtkIndent indent);
  static vtkXMLDataParser* New();
 
  vtkXMLDataElement* GetRootElement();
 
  //BTX
  enum { BigEndian, LittleEndian };
 
 
  size_t ReadInlineData(vtkXMLDataElement* element, int isAscii,
                        void* buffer, vtkTypeUInt64 startWord,
                        size_t numWords, int wordType);
  size_t ReadInlineData(vtkXMLDataElement* element, int isAscii,
                        char* buffer, vtkTypeUInt64 startWord,
                        size_t numWords)
    { return this->ReadInlineData(element, isAscii, buffer, startWord,
                                  numWords, VTK_CHAR); }
 
 
  size_t ReadAppendedData(vtkTypeInt64 offset, void* buffer,
                          vtkTypeUInt64 startWord,
                          size_t numWords, int wordType);
  size_t ReadAppendedData(vtkTypeInt64 offset, char* buffer,
                          vtkTypeUInt64 startWord,
                          size_t numWords)
  { return this->ReadAppendedData(offset, buffer, startWord, numWords,
                                    VTK_CHAR); }
 
 
  size_t ReadAsciiData(void* buffer, vtkTypeUInt64 startWord,
                       size_t numWords, int wordType);
 
 
  size_t ReadBinaryData(void* buffer, vtkTypeUInt64 startWord,
                        size_t maxWords, int wordType);
  //ETX
 
 
  virtual void SetCompressor(vtkDataCompressor*);
  vtkGetObjectMacro(Compressor, vtkDataCompressor);
 
  size_t GetWordTypeSize(int wordType);
 
  virtual int Parse();
 
 
  vtkGetMacro(Abort, int);
  vtkSetMacro(Abort, int);
 
 
  vtkGetMacro(Progress, float);
  vtkSetMacro(Progress, float);
 
 
  vtkSetClampMacro(AttributesEncoding,int,VTK_ENCODING_NONE,VTK_ENCODING_UNKNOWN);
  vtkGetMacro(AttributesEncoding, int);
 
  virtual void CharacterDataHandler(const char* data, int length);
 
 
  vtkTypeInt64 GetAppendedDataPosition()
  {
    return this->AppendedDataPosition;
  }
 
protected:
  vtkXMLDataParser();
  ~vtkXMLDataParser();
 
  // This parser does not support parsing from a string.
  virtual int Parse(const char*);
  virtual int Parse(const char*, unsigned int);
 
  // Implement parsing methods.
  virtual void StartElement(const char* name, const char** atts);
  virtual void EndElement(const char*);
 
  int ParsingComplete();
  int CheckPrimaryAttributes();
  void FindAppendedDataPosition();
  int ParseBuffer(const char* buffer, unsigned int count);
 
  void AddElement(vtkXMLDataElement* element);
  void PushOpenElement(vtkXMLDataElement* element);
  vtkXMLDataElement* PopOpenElement();
  void FreeAllElements();
  void PerformByteSwap(void* data, size_t numWords, size_t wordSize);
 
  // Data reading methods.
  int ReadCompressionHeader();
  size_t FindBlockSize(vtkTypeUInt64 block);
  int ReadBlock(vtkTypeUInt64 block, unsigned char* buffer);
  unsigned char* ReadBlock(vtkTypeUInt64 block);
  size_t ReadUncompressedData(unsigned char* data,
                              vtkTypeUInt64 startWord,
                              size_t numWords,
                              size_t wordSize);
  size_t ReadCompressedData(unsigned char* data,
                            vtkTypeUInt64 startWord,
                            size_t numWords,
                            size_t wordSize);
 
  // Go to the start of the inline data
  void SeekInlineDataPosition(vtkXMLDataElement *element);
 
  // Ascii data reading methods.
  int ParseAsciiData(int wordType);
  void FreeAsciiBuffer();
 
  // Progress update methods.
  void UpdateProgress(float progress);
 
  // The root XML element.
  vtkXMLDataElement* RootElement;
 
  // The stack of elements currently being parsed.
  vtkXMLDataElement** OpenElements;
  unsigned int NumberOfOpenElements;
  unsigned int OpenElementsSize;
 
  // The position of the appended data section, if found.
  vtkTypeInt64 AppendedDataPosition;
 
  // How much of the string "<AppendedData" has been matched in input.
  int AppendedDataMatched;
 
  // The byte order of the binary input.
  int ByteOrder;
 
  // The word type of binary input headers.
  int HeaderType;
 
  // The input stream used to read data.  Set by ReadAppendedData and
  // ReadInlineData methods.
  vtkInputStream* DataStream;
 
  // The input stream used to read inline data.  May transparently
  // decode the data.
  vtkInputStream* InlineDataStream;
 
  // The stream to use for appended data.
  vtkInputStream* AppendedDataStream;
 
  // Decompression data.
  vtkDataCompressor* Compressor;
  size_t NumberOfBlocks;
  size_t BlockUncompressedSize;
  size_t PartialLastBlockUncompressedSize;
  size_t* BlockCompressedSizes;
  vtkTypeInt64* BlockStartOffsets;
 
  // Ascii data parsing.
  unsigned char* AsciiDataBuffer;
  size_t AsciiDataBufferLength;
  int AsciiDataWordType;
  vtkTypeInt64 AsciiDataPosition;
 
  // Progress during reading of data.
  float Progress;
 
  // Abort flag checked during reading of data.
  int Abort;
 
  int AttributesEncoding;
 
private:
  vtkXMLDataParser(const vtkXMLDataParser&);  // Not implemented.
  void operator=(const vtkXMLDataParser&);  // Not implemented.
};
 
//----------------------------------------------------------------------------
inline
void vtkXMLDataParser::CharacterDataHandler(const char* data, int length )
{
  const unsigned int eid=this->NumberOfOpenElements-1;
  this->OpenElements[eid]->AddCharacterData(data, length);
}
 
 
#endif