File indexing completed on 2024-05-12 04:33:56

 // -*- Mode: C++; c-basic-offset: 2; indent-tabs-mode: nil; c-brace-offset: 0; -*-
 //
 // Class: dviFile
 //
 // Class that represents a DVI file. Part of KDVI - A DVI previewing
 // plugin for kviewshell.
 //
 // SPDX-FileCopyrightText: 2004-2005 Stefan Kebekus
 // SPDX-License-Identifier: GPL-2.0-or-later
 
 #ifndef _DVIFILE_H
 #define _DVIFILE_H
 
 #include "bigEndianByteReader.h"
 
 #include <QHash>
 #include <QMap>
 #include <QString>
 #include <QVector>
 
 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();
 
     dvifile(const dvifile &) = delete;
     dvifile &operator=(const dvifile &) = delete;
 
     fontPool *font_pool;
     QString filename;
     QString generatorString;
     quint16 total_pages;
     QVector<quint32> 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.
     quint8 *dvi_Data()
     {
         return dviData.data();
     }
 
     qint64 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) */
     quint16 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) */
     quint16 numberOfExternalNONPSFiles;
 
     quint32 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 conjunction 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;
 
     QHash<int, 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. */
     quint32 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. */
     quint8 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 QVector<quint8> &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 things:
 
     - 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() on failure.
     */
     QString convertPDFtoPS(const QString &PDFFilename, QString *converrorms = nullptr);
 
 private:
     void pdf2psNotFound(const QString &PDFFilename, QString *converrorms);
 
     /** 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(). */
     quint32 last_page_offset;
     quint32 _magnification;
 
     double cmPerDVIunit;
 
     QVector<quint8> 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(), if the file could not
     be converted. The PS files are deleted when the DVI-file is
     destructed. */
     QMap<QString, QString> convertedFiles;
 
     /** Flag, used so that KDVI complains only once about a missing
         "PDF2PS" utility. Set to "false" in the constructor. */
     bool have_complainedAboutMissingPDF2PS;
 };
 
 #endif // ifndef _DVIFILE_H