Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 150 insertions, 0 deletions

diff --git a/kdvi/dviFile.h b/kdvi/dviFile.h
new file mode 100644
index 00000000..069ae6d9
--- /dev/null
+++ b/kdvi/dviFile.h
@@ -0,0 +1,150 @@
+// -*- C++ -*-
+//
+// Class: dviFile
+//
+// Class that represents a DVI file. Part of KDVI - A DVI previewing
+// plugin for kviewshell.
+//
+// (C) 2004--2005 Stefan Kebekus. Distributed under the GPL.
+//
+
+#ifndef _DVIFILE_H
+#define _DVIFILE_H
+
+#include "bigEndianByteReader.h"
+
+#include <qintdict.h>
+#include <qiodevice.h>
+#include <qmemarray.h>
+#include <qstring.h>
+
+class fontPool;
+class pageSize;
+class TeXFontDefinition;
+
+
+class dvifile : public bigEndianByteReader
+{
+ public:
+  /** Makes a deep copy of the old DVI file. */
+  dvifile(const dvifile *old, fontPool *fp );
+  dvifile(const QString& fname, class fontPool* pool);
+
+  ~dvifile();
+
+  fontPool     * font_pool;
+  QString        filename;
+  QString        generatorString;
+  Q_UINT16       total_pages;
+  QMemArray<Q_UINT32> page_offset;
+
+  /** Saves the DVI file. Returns true on success. */
+  bool           saveAs(const QString &filename);
+
+  // Returns a pointer to the DVI file's data, or 0 if no data has yet
+  // been allocated.
+  Q_UINT8      * dvi_Data() {return dviData.data();}
+
+  QIODevice::Offset size_of_file;
+  QString        errorMsg;
+
+  /** This field is set to zero when the DVI file is constructed, and
+      will be modified during the prescan phase (at this time the
+      prescan code still resides in the dviRenderer class) */
+  Q_UINT16       numberOfExternalPSFiles;
+  
+  /** This field is set to zero when the DVI file is constructed, and
+      will be modified during the prescan phase (at this time the
+      prescan code still resides in the dviRenderer class) */
+  Q_UINT16       numberOfExternalNONPSFiles;
+
+  Q_UINT32       beginning_of_postamble;
+  
+  /** This flag is set to "true" during the construction of the
+      dvifile, and is never changed afterwards by the dvifile
+      class. It is used in kdvi in conjuction with source-specials:
+      the first time a page with source specials is rendered, KDVI
+      shows an info dialog, and the flag is set to false. That way
+      KDVI ensures that the user is only informed once. */
+  bool           sourceSpecialMarker;
+  
+  QIntDict<TeXFontDefinition> tn_table;
+
+  /** Returns the number of centimeters per DVI unit in this DVI
+      file. */
+  double         getCmPerDVIunit() const {return cmPerDVIunit;}
+
+  /** Returns the magnification of the DVI file, as described in the
+      DVI Standard. */
+  Q_UINT32        getMagnification() const {return _magnification;}
+
+  /** This member is set to zero on construction and can be used by
+      other software to count error messages that were printed when
+      the DVI-file was processed. Suggested application: limit the
+      number of error messages to, say, 25. */
+  Q_UINT8        errorCounter;
+
+  /** Papersize information read from the dvi-File */
+  pageSize       *suggestedPageSize;
+  
+  /** Sets new DVI data; all old data is erased. EXPERIMENTAL, use
+      with care. */
+  void           setNewData(const QMemArray<Q_UINT8>& newData) {dviData = newData;}
+
+  /** Page numbers that appear in a DVI document need not be
+      ordered. Worse, page numbers need not be unique. This method
+      renumbers the pages. */
+  void           renumber();
+  
+  /** PDF to PS file conversion 
+
+  This utility method takes the name of a PDF-file, and attempts to
+  convert it to a PS file. The dvifile internally keeps a list of
+  converted files, to do two thigs:
+
+  - convert files only once.
+
+  - delete all converted files on destruction
+
+  @warning The internal buffer can lead to difficulties if filenames
+    of PDF-files are not unique: if the content of a PDF file is
+    changed and this method is called a second time with the same file
+    name, the method will then NOT convert the file, but simply return
+    the name from the buffer
+
+  @returns The name of the PS file, or QString::null on failure.
+  */
+  QString convertPDFtoPS(const QString &PDFFilename);
+
+ private:
+  /** process_preamble reads the information in the preamble and
+      stores it into global variables for later use. */
+  void           process_preamble();
+  void           find_postamble();
+  /** read_postamble reads the information in the postamble, storing
+      it into global variables. It also takes care of reading in all
+      of the pixel files for the fonts used in the job. */
+  void           read_postamble();
+  void           prepare_pages();
+
+
+  /** Offset in DVI file of last page, set in read_postamble(). */
+  Q_UINT32       last_page_offset;
+  Q_UINT32       _magnification;
+
+  double         cmPerDVIunit;
+
+  QMemArray<Q_UINT8>  dviData;
+
+
+  /** Map of filenames for converted PDF files
+
+  This map contains names of PDF files that were converted to
+  PostScript. The key is the name of the PDF file, the data the name
+  of the associated PS file, or QString::null, if the file could not
+  be converted. The PS files are deleted when the DVI-file is
+  destructed. */
+  QMap<QString, QString> convertedFiles;
+};
+
+#endif //ifndef _DVIFILE_H