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

 // -*- Mode: C++; c-basic-offset: 2; indent-tabs-mode: nil; c-brace-offset: 0; -*-
 /*
  * SPDX-FileCopyrightText: 1994 Paul Vojta. All rights reserved.
  *
  * SPDX-License-Identifier: BSD-2-Clause
  *
  * NOTE:
  *        xdvi is based on prior work as noted in the modification history, below.
  */
 
 /*
  * DVI previewer for X.
  *
  * Eric Cooper, CMU, September 1985.
  *
  * Code derived from dvi-imagen.c.
  *
  * Modification history:
  * 1/1986        Modified for X.10        --Bob Scheifler, MIT LCS.
  * 7/1988        Modified for X.11        --Mark Eichin, MIT
  * 12/1988        Added 'R' option, toolkit, magnifying glass
  *                                        --Paul Vojta, UC Berkeley.
  * 2/1989        Added tpic support       --Jeffrey Lee, U of Toronto
  * 4/1989        Modified for System V    --Donald Richardson, Clarkson Univ.
  * 3/1990        Added VMS support        --Scott Allendorf, U of Iowa
  * 7/1990        Added reflection mode    --Michael Pak, Hebrew U of Jerusalem
  * 1/1992        Added greyscale code     --Till Brychcy, Techn. Univ. Muenchen
  *                                          and Lee Hetherington, MIT
  * 4/1994        Added DPS support, bounding box
  *                                        --Ricardo Telichevesky
  *                                          and Luis Miguel Silveira, MIT RLE.
  */
 
 #include <config.h>
 
 #include "debug_dvi.h"
 #include "dvi.h"
 #include "dviFile.h"
 #include "fontpool.h"
 #include "pageSize.h"
 
 #include <KLocalizedString>
 
 #include <QLoggingCategory>
 #include <QProcess>
 #include <QStandardPaths>
 #include <QSysInfo>
 #include <QTemporaryFile>
 
 #include <cstdlib>
 
 dvifile::dvifile(const dvifile *old, fontPool *fp)
 {
     errorMsg.clear();
     errorCounter = 0;
     page_offset.clear();
     suggestedPageSize = nullptr;
     numberOfExternalPSFiles = 0;
     numberOfExternalNONPSFiles = 0;
     sourceSpecialMarker = old->sourceSpecialMarker;
     have_complainedAboutMissingPDF2PS = false;
 
     dviData = old->dviData;
 
     filename = old->filename;
     size_of_file = old->size_of_file;
     end_pointer = dvi_Data() + size_of_file;
     if (dvi_Data() == nullptr) {
         qCCritical(OkularDviDebug) << "Not enough memory to copy the DVI-file.";
         return;
     }
 
     font_pool = fp;
     filename = old->filename;
     generatorString = old->generatorString;
     total_pages = old->total_pages;
 
     tn_table.clear();
     process_preamble();
     find_postamble();
     read_postamble();
     prepare_pages();
 }
 
 void dvifile::process_preamble()
 {
     command_pointer = dvi_Data();
 
     quint8 magic_number = readUINT8();
     if (magic_number != PRE) {
         errorMsg = i18n("The DVI file does not start with the preamble.");
         return;
     }
     magic_number = readUINT8();
     if (magic_number != 2) {
         errorMsg = i18n(
             "The DVI file contains the wrong version of DVI output for this program. "
             "Hint: If you use the typesetting system Omega, you have to use a special "
             "program, such as oxdvi.");
         return;
     }
 
     /** numerator, denominator and the magnification value that describe
         how many centimeters there are in one TeX unit, as explained in
         section A.3 of the DVI driver standard, Level 0, published by
         the TUG DVI driver standards committee. */
     quint32 numerator = readUINT32();
     quint32 denominator = readUINT32();
     _magnification = readUINT32();
 
     cmPerDVIunit = (double(numerator) / double(denominator)) * (double(_magnification) / 1000.0) * (1.0 / 1e5);
 
     // Read the generatorString (such as "TeX output ..." from the
     // DVI-File). The variable "magic_number" holds the length of the
     // string.
     char job_id[300];
     magic_number = readUINT8();
     strncpy(job_id, (char *)command_pointer, magic_number);
     job_id[magic_number] = '\0';
     generatorString = QString::fromLocal8Bit(job_id);
 }
 
 /** find_postamble locates the beginning of the postamble and leaves
     the file ready to start reading at that location. */
 
 void dvifile::find_postamble()
 {
     // Move backwards through the TRAILER bytes
     command_pointer = dvi_Data() + size_of_file - 1;
     while ((*command_pointer == TRAILER) && (command_pointer > dvi_Data())) {
         command_pointer--;
     }
     if (command_pointer == dvi_Data()) {
         errorMsg = i18n("The DVI file is badly corrupted. Okular was not able to find the postamble.");
         return;
     }
 
     // And this is finally the pointer to the beginning of the postamble
     command_pointer -= 4;
     beginning_of_postamble = readUINT32();
     command_pointer = dvi_Data() + beginning_of_postamble;
 }
 
 void dvifile::read_postamble()
 {
     quint8 magic_byte = readUINT8();
     if (magic_byte != POST) {
         errorMsg = i18n("The postamble does not begin with the POST command.");
         return;
     }
     last_page_offset = readUINT32();
 
     // Skip the numerator, denominator and magnification, the largest
     // box height and width and the maximal depth of the stack. These
     // are not used at the moment.
     command_pointer += 4 + 4 + 4 + 4 + 4 + 2;
 
     // The number of pages is more interesting for us.
     total_pages = readUINT16();
 
     // As a next step, read the font definitions.
     quint8 cmnd = readUINT8();
     while (cmnd >= FNTDEF1 && cmnd <= FNTDEF4) {
         quint32 TeXnumber = readUINT(cmnd - FNTDEF1 + 1);
         quint32 checksum = readUINT32(); // Checksum of the font, as found by TeX in the TFM file
 
         // Read scale and design factor, and the name of the font. All
         // these are explained in section A.4 of the DVI driver standard,
         // Level 0, published by the TUG DVI driver standards committee
         quint32 scale = readUINT32();
         quint32 design = readUINT32();
         quint16 len = readUINT8() + readUINT8(); // Length of the font name, including the directory name
         QByteArray fontname((char *)command_pointer, len);
         command_pointer += len;
 
 #ifdef DEBUG_FONTS
         qCDebug(OkularDviDebug) << "Postamble: define font \"" << fontname << "\" scale=" << scale << " design=" << design;
 #endif
 
         // According to section A.4 of the DVI driver standard, this font
         // shall be enlarged by the following factor before it is used.
         double enlargement_factor = (double(scale) * double(_magnification)) / (double(design) * 1000.0);
 
         if (font_pool != nullptr) {
             TeXFontDefinition *fontp = font_pool->appendx(QString::fromLocal8Bit(fontname), checksum, scale, enlargement_factor);
 
             // Insert font in dictionary and make sure the dictionary is big
             // enough.
             if (tn_table.capacity() - 2 <= tn_table.count()) {
                 // Not quite optimal. The size of the dictionary should be a
                 // prime for optimal performance. I don't care.
                 tn_table.reserve(tn_table.capacity() * 2);
             }
             tn_table.insert(TeXnumber, fontp);
         }
 
         // Read the next command
         cmnd = readUINT8();
     }
 
     if (cmnd != POSTPOST) {
         errorMsg = i18n("The postamble contained a command other than FNTDEF.");
         return;
     }
 
     // Now we remove all those fonts from the memory which are no longer
     // in use.
     if (font_pool != nullptr) {
         font_pool->release_fonts();
     }
 }
 
 void dvifile::prepare_pages()
 {
 #ifdef DEBUG_DVIFILE
     qCDebug(OkularDviDebug) << "prepare_pages";
 #endif
     if (total_pages == 0) {
         return;
     }
 
     page_offset.resize(total_pages + 1);
     if (page_offset.size() < (total_pages + 1)) {
         qCCritical(OkularDviDebug) << "No memory for page list!";
         return;
     }
     for (int i = 0; i <= total_pages; i++) {
         page_offset[i] = 0;
     }
 
     page_offset[int(total_pages)] = beginning_of_postamble;
     int j = total_pages - 1;
     page_offset[j] = last_page_offset;
 
     // Follow back pointers through pages in the DVI file, storing the
     // offsets in the page_offset table.
     while (j > 0) {
         command_pointer = dvi_Data() + page_offset[j--];
         if (readUINT8() != BOP) {
             errorMsg = i18n("The page %1 does not start with the BOP command.", j + 1);
             return;
         }
         command_pointer += 10 * 4;
         page_offset[j] = readUINT32();
         if ((dvi_Data() + page_offset[j] < dvi_Data()) || (dvi_Data() + page_offset[j] > dvi_Data() + size_of_file)) {
             break;
         }
     }
 }
 
 dvifile::dvifile(const QString &fname, fontPool *pool)
 {
 #ifdef DEBUG_DVIFILE
     qCDebug(OkularDviDebug) << "init_dvi_file: " << fname;
 #endif
 
     errorMsg.clear();
     errorCounter = 0;
     page_offset.clear();
     suggestedPageSize = nullptr;
     numberOfExternalPSFiles = 0;
     numberOfExternalNONPSFiles = 0;
     font_pool = pool;
     sourceSpecialMarker = true;
     have_complainedAboutMissingPDF2PS = false;
 
     QFile file(fname);
     filename = file.fileName();
     file.open(QIODevice::ReadOnly);
     size_of_file = file.size();
     dviData.resize(size_of_file);
     // Sets the end pointer for the bigEndianByteReader so that the
     // whole memory buffer is readable
     end_pointer = dvi_Data() + size_of_file;
     if (dvi_Data() == nullptr) {
         qCCritical(OkularDviDebug) << "Not enough memory to load the DVI-file.";
         return;
     }
     file.read((char *)dvi_Data(), size_of_file);
     file.close();
     if (file.error() != QFile::NoError) {
         qCCritical(OkularDviDebug) << "Could not load the DVI-file.";
         return;
     }
 
     tn_table.clear();
 
     total_pages = 0;
     process_preamble();
     find_postamble();
     read_postamble();
     prepare_pages();
 
     return;
 }
 
 dvifile::~dvifile()
 {
 #ifdef DEBUG_DVIFILE
     qCDebug(OkularDviDebug) << "destroy dvi-file";
 #endif
 
     // Delete converted PDF files
     QMapIterator<QString, QString> i(convertedFiles);
     while (i.hasNext()) {
         i.next();
         QFile::remove(i.value());
     }
 
     if (suggestedPageSize != nullptr) {
         delete suggestedPageSize;
     }
     if (font_pool != nullptr) {
         font_pool->mark_fonts_as_unused();
     }
 }
 
 void dvifile::renumber()
 {
     dviData.detach();
 
     // Write the page number to the file, taking good care of byte
     // orderings.
     bool bigEndian = (QSysInfo::ByteOrder == QSysInfo::BigEndian);
 
     for (int i = 1; i <= total_pages; i++) {
         quint8 *ptr = dviData.data() + page_offset[i - 1] + 1;
         quint8 *num = (quint8 *)&i;
         for (quint8 j = 0; j < 4; j++) {
             if (bigEndian) {
                 *(ptr++) = num[0];
                 *(ptr++) = num[1];
                 *(ptr++) = num[2];
                 *(ptr++) = num[3];
             } else {
                 *(ptr++) = num[3];
                 *(ptr++) = num[2];
                 *(ptr++) = num[1];
                 *(ptr++) = num[0];
             }
         }
     }
 }
 
 void dvifile::pdf2psNotFound(const QString &PDFFilename, QString *converrorms)
 {
     // Indicates that conversion failed, won't try again.
     convertedFiles[PDFFilename].clear();
     if (converrorms != nullptr && !have_complainedAboutMissingPDF2PS) {
         *converrorms = i18n(
             "<qt><p>The external program <strong>pdf2ps</strong> could not be started. As a result, "
             "the PDF-file %1 could not be converted to PostScript. Some graphic elements in your "
             "document will therefore not be displayed.</p>"
             "<p><b>Possible reason:</b> The program <strong>pdf2ps</strong> may not be installed "
             "on your system, or cannot be found in the current search path.</p>"
             "<p><b>What you can do:</b> The program <strong>pdf2ps</strong> is normally "
             "contained in distributions of the ghostscript PostScript interpreter system. If "
             "ghostscript is not installed on your system, you could install it now. "
             "If you are sure that ghostscript is installed, try to use <strong>pdf2ps</strong> "
             "from the command line to check if it really works.</p><p><em>PATH:</em> %2</p></qt>",
             PDFFilename,
             QString::fromLocal8Bit(qgetenv("PATH")));
         have_complainedAboutMissingPDF2PS = true;
     }
 }
 
 QString dvifile::convertPDFtoPS(const QString &PDFFilename, QString *converrorms)
 {
     // Check if the PDFFile is known
     QMap<QString, QString>::Iterator it = convertedFiles.find(PDFFilename);
     if (it != convertedFiles.end()) {
         // PDF-File is known. Good.
         return it.value();
     }
 
     // Make sure pdf2ps is in PATH and not just in the CWD
     static const QString fullPath = QStandardPaths::findExecutable(QStringLiteral("pdf2ps"));
     if (!fullPath.isEmpty()) {
         pdf2psNotFound(PDFFilename, converrorms);
         return QString();
     }
 
     // Get the name of a temporary file.
     // Must open the QTemporaryFile to access the name.
     QTemporaryFile tmpfile;
     tmpfile.open();
     const QString convertedFileName = tmpfile.fileName();
     tmpfile.close();
 
     // Use pdf2ps to do the conversion
     QProcess pdf2ps;
     pdf2ps.setProcessChannelMode(QProcess::MergedChannels);
     pdf2ps.start(fullPath, QStringList() << PDFFilename << convertedFileName, QIODevice::ReadOnly | QIODevice::Text);
 
     if (!pdf2ps.waitForStarted()) {
         pdf2psNotFound(PDFFilename, converrorms);
         return QString();
     }
 
     // We wait here while the external program runs concurrently.
     pdf2ps.waitForFinished(-1);
 
     if (!QFile::exists(convertedFileName) || pdf2ps.exitCode() != 0) {
         // Indicates that conversion failed, won't try again.
         convertedFiles[PDFFilename].clear();
         if (converrorms != nullptr) {
             const QString output = QString::fromLocal8Bit(pdf2ps.readAll());
 
             *converrorms = i18n(
                 "<qt><p>The PDF-file %1 could not be converted to PostScript. Some graphic elements in your "
                 "document will therefore not be displayed.</p>"
                 "<p><b>Possible reason:</b> The file %1 might be broken, or might not be a PDF-file at all. "
                 "This is the output of the <strong>pdf2ps</strong> program that Okular used:</p>"
                 "<p><strong>%2</strong></p></qt>",
                 PDFFilename,
                 output);
         }
         return QString();
     }
     // Save name of converted file to buffer, so PDF file won't be
     // converted again, and files can be deleted when *this is
     // deconstructed.
     convertedFiles[PDFFilename] = convertedFileName;
 
     tmpfile.setAutoRemove(false);
     return convertedFileName;
 }
 
 bool dvifile::saveAs(const QString &filename)
 {
     if (dvi_Data() == nullptr) {
         return false;
     }
 
     QFile out(filename);
     if (out.open(QIODevice::WriteOnly) == false) {
         return false;
     }
     if (out.write((char *)(dvi_Data()), size_of_file) == -1) {
         return false;
     }
     out.close();
     return true;
 }