summaryrefslogtreecommitdiffstats
path: root/kdvi/dviRenderer.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit47d455dd55be855e4cc691c32f687f723d9247ee (patch)
tree52e236aaa2576bdb3840ebede26619692fed6d7d /kdvi/dviRenderer.h
downloadtdegraphics-47d455dd55be855e4cc691c32f687f723d9247ee.tar.gz
tdegraphics-47d455dd55be855e4cc691c32f687f723d9247ee.zip
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
Diffstat (limited to 'kdvi/dviRenderer.h')
-rw-r--r--kdvi/dviRenderer.h300
1 files changed, 300 insertions, 0 deletions
diff --git a/kdvi/dviRenderer.h b/kdvi/dviRenderer.h
new file mode 100644
index 00000000..98f0f4bd
--- /dev/null
+++ b/kdvi/dviRenderer.h
@@ -0,0 +1,300 @@
+// -*- C++ -*-
+//
+// Class: dviRenderer
+//
+// Class for rendering TeX DVI files.
+// Part of KDVI- A previewer for TeX DVI files.
+//
+// (C) 2001-2005 Stefan Kebekus. Distributed under the GPL.
+
+#ifndef _dvirenderer_h_
+#define _dvirenderer_h_
+
+#include "bigEndianByteReader.h"
+#include "documentRenderer.h"
+#include "fontpool.h"
+
+#include <kurl.h>
+#include <qintdict.h>
+#include <qpointarray.h>
+#include <qtimer.h>
+#include <qvaluestack.h>
+#include <qvaluevector.h>
+
+class Anchor;
+class DocumentWidget;
+class dviRenderer;
+class fontProgressDialog;
+class ghostscript_interface;
+class infoDialog;
+class KAction;
+class KDVIMultiPage;
+class KPrinter;
+class KProcess;
+class KProgressDialog;
+class KShellProcess;
+class PreBookmark;
+class TeXFontDefinition;
+
+extern const int MFResolutions[];
+
+class DVI_SourceFileAnchor {
+ public:
+ DVI_SourceFileAnchor() {}
+ DVI_SourceFileAnchor(const QString& name, Q_UINT32 ln, Q_UINT32 pg, const Length& _distance_from_top)
+ : fileName(name), line(ln), page(pg),
+ distance_from_top(_distance_from_top) {}
+
+ QString fileName;
+ Q_UINT32 line;
+ Q_UINT32 page;
+ Length distance_from_top;
+};
+
+/** Compound of registers, as defined in section 2.6.2 of the DVI
+ driver standard, Level 0, published by the TUG DVI driver
+ standards committee. */
+
+struct framedata {
+ long dvi_h;
+ long dvi_v;
+ long w;
+ long x;
+ long y;
+ long z;
+ int pxl_v;
+};
+
+
+/* this information is saved when using virtual fonts */
+
+typedef void (dviRenderer::*set_char_proc)(unsigned int, unsigned int);
+typedef void (dviRenderer::*parseSpecials)(char *, Q_UINT8 *);
+
+struct drawinf {
+ struct framedata data;
+ TeXFontDefinition *fontp;
+ set_char_proc set_char_p;
+
+ QIntDict<TeXFontDefinition> *fonttable;
+ TeXFontDefinition *_virtual;
+};
+
+
+
+class dviRenderer : public DocumentRenderer, bigEndianByteReader
+{
+ Q_OBJECT
+
+public:
+ dviRenderer(QWidget *parent);
+ ~dviRenderer();
+
+ virtual bool setFile(const QString &fname, const KURL &base);
+
+ class dvifile *dviFile;
+
+ void setPrefs(bool flag_showPS, const QString &editorCommand, bool useFontHints );
+
+ virtual bool supportsTextSearch() const {return true;}
+
+ bool showPS() { return _postscript; }
+ int curr_page() { return current_page+1; }
+ virtual bool isValidFile(const QString& fileName) const;
+
+
+ /** This method will try to parse the reference part of the DVI
+ file's URL, (either a number, which is supposed to be a page
+ number, or src:<line><filename>) and see if a corresponding
+ section of the DVI file can be found. If so, it returns an
+ anchor to that section. If not, it returns an invalid anchor. */
+ virtual Anchor parseReference(const QString &reference);
+
+ // These should not be public... only for the moment
+ void read_postamble();
+ void draw_part(double current_dimconv, bool is_vfmacro);
+ void set_vf_char(unsigned int cmd, unsigned int ch);
+ void set_char(unsigned int cmd, unsigned int ch);
+ void set_empty_char(unsigned int cmd, unsigned int ch);
+ void set_no_char(unsigned int cmd, unsigned int ch);
+ void applicationDoSpecial(char * cp);
+
+ void special(long nbytes);
+ void printErrorMsgForSpecials(const QString& msg);
+ void color_special(const QString& cp);
+ void html_href_special(const QString& cp);
+ void html_anchor_end();
+ void draw_page();
+
+public slots:
+ void exportPS(const QString& fname = QString::null, const QString& options = QString::null, KPrinter* printer = 0);
+ void exportPDF();
+
+ void showInfo();
+ void handleSRCLink(const QString &linkText, QMouseEvent *e, DocumentWidget *widget);
+
+ void embedPostScript();
+ void abortExternalProgramm();
+
+ /** simply emits "setStatusBarText( QString::null )". This is used
+ in dviRenderer::mouseMoveEvent(), see the explanation there. */
+ void clearStatusBar();
+
+ virtual void drawPage(double res, RenderedDocumentPage *page);
+ virtual void getText(RenderedDocumentPage* page);
+
+ /** Slots used in conjunction with external programs */
+ void dvips_output_receiver(KProcess *, char *buffer, int buflen);
+ void dvips_terminated(KProcess *);
+ void editorCommand_terminated(KProcess *);
+
+signals:
+ /** Passed through to the top-level kpart. */
+ // void setStatusBarText( const QString& );
+
+private slots:
+ /** This method shows a dialog that tells the user that source
+ information is present, and gives the opportunity to open the
+ manual and learn more about forward and inverse search */
+ void showThatSourceInformationIsPresent();
+
+private:
+ /** URL to the DVI file
+
+ This field is initialized by the setFile() method. See the
+ explanation there. */
+ KURL baseURL;
+
+
+ /** This method parses a color specification of type "gray 0.5", "rgb
+ 0.5 0.7 1.0", "hsb ...", "cmyk .." or "PineGreen". See the source
+ code for details. */
+ QColor parseColorSpecification(const QString& colorSpec);
+
+ /** This map contains the colors which are known by name. This field
+ is initialized in the method parseColorSpecification() as soon as
+ it is needed. */
+ QMap<QString, QColor> namedColors;
+
+ /* This method locates special PDF characters in a string and
+ replaces them by UTF8. See Section 3.2.3 of the PDF reference
+ guide for information */
+ QString PDFencodingToQString(const QString& pdfstring);
+
+ void setResolution(double resolution_in_DPI);
+
+ fontPool font_pool;
+ infoDialog *info;
+
+ double resolutionInDPI;
+
+ // @@@ explanation
+ void prescan(parseSpecials specialParser);
+ void prescan_embedPS(char *cp, Q_UINT8 *);
+ void prescan_removePageSizeInfo(char *cp, Q_UINT8 *);
+ void prescan_parseSpecials(char *cp, Q_UINT8 *);
+ void prescan_ParsePapersizeSpecial(const QString& cp);
+ void prescan_ParseBackgroundSpecial(const QString& cp);
+ void prescan_ParseHTMLAnchorSpecial(const QString& cp);
+ void prescan_ParsePSHeaderSpecial(const QString& cp);
+ void prescan_ParsePSBangSpecial(const QString& cp);
+ void prescan_ParsePSQuoteSpecial(const QString& cp);
+ void prescan_ParsePSSpecial(const QString& cp);
+ void prescan_ParsePSFileSpecial(const QString& cp);
+ void prescan_ParseSourceSpecial(const QString& cp);
+ void prescan_setChar(unsigned int ch);
+
+ /* */
+ QValueVector<PreBookmark> prebookmarks;
+
+
+
+ /** Utility fields used by the embedPostScript method*/
+ KProgressDialog *embedPS_progress;
+ Q_UINT16 embedPS_numOfProgressedFiles;
+
+ /** Shrink factor. Units are not quite clear */
+ double shrinkfactor;
+
+ QString errorMsg;
+
+ /** Methods which handle certain special commands. */
+ void epsf_special(const QString& cp);
+ void source_special(const QString& cp);
+
+ /** TPIC specials */
+ void TPIC_setPen_special(const QString& cp);
+ void TPIC_addPath_special(const QString& cp);
+ void TPIC_flushPath_special();
+
+ /** This timer is used to delay clearing of the statusbar. Clearing
+ the statusbar is delayed to avoid awful flickering when the
+ mouse moves over a block of text that contains source
+ hyperlinks. The signal timeout() is connected to the method
+ clearStatusBar() of *this. */
+ QTimer clearStatusBarTimer;
+
+ // List of source-hyperlinks on all pages. This vector is generated
+ // when the DVI-file is first loaded, i.e. when draw_part is called
+ // with PostScriptOutPutString != NULL
+ QValueVector<DVI_SourceFileAnchor> sourceHyperLinkAnchors;
+
+ // If not NULL, the text currently drawn represents a source
+ // hyperlink to the (relative) URL given in the string;
+ QString *source_href;
+
+ // If not NULL, the text currently drawn represents a hyperlink to
+ // the (relative) URL given in the string;
+ QString *HTML_href;
+
+ QString editorCommand;
+
+ /** Stack for register compounds, used for the DVI-commands PUSH/POP
+ as explained in section 2.5 and 2.6.2 of the DVI driver standard,
+ Level 0, published by the TUG DVI driver standards committee. */
+ QValueStack<struct framedata> stack;
+
+ /** A stack where color are stored, according to the documentation of
+ DVIPS */
+ QValueStack<QColor> colorStack;
+
+ /** The global color is to be used when the color stack is empty */
+ QColor globalColor;
+
+ /** If PostScriptOutPutFile is non-zero, then no rendering takes
+ place. Instead, the PostScript code which is generated by the
+ \special-commands is written to the PostScriptString */
+ QString *PostScriptOutPutString;
+
+ ghostscript_interface *PS_interface;
+
+ /** true, if gs should be used, otherwise, only bounding boxes are
+ drawn. */
+ bool _postscript;
+
+ /** This flag is used when rendering a dvi-page. It is set to "true"
+ when any dvi-command other than "set" or "put" series of commands
+ is encountered. This is considered to mark the end of a word. */
+ bool line_boundary_encountered;
+ bool word_boundary_encountered;
+
+ unsigned int current_page;
+
+ /** Used to run and to show the progress of dvips and friends. */
+ fontProgressDialog *progress;
+ KShellProcess *proc;
+ KPrinter *export_printer;
+ QString export_fileName;
+ QString export_tmpFileName;
+ QString export_errorString;
+
+ /** Data required for handling TPIC specials */
+ float penWidth_in_mInch;
+ QPointArray TPIC_path;
+ Q_UINT16 number_of_elements_in_path;
+
+ struct drawinf currinf;
+ RenderedDocumentPage* currentlyDrawnPage;
+};
+
+#endif