2007-01-13 23:15:28 +00:00
|
|
|
/***************************************************************************
|
|
|
|
* Copyright (C) 2007 by Tobias Koenig <tokoe@kde.org> *
|
|
|
|
* *
|
|
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
|
|
* it under the terms of the GNU General Public License as published by *
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
|
|
* (at your option) any later version. *
|
|
|
|
***************************************************************************/
|
|
|
|
|
|
|
|
#ifndef _OKULAR_TEXTDOCUMENTGENERATOR_H_
|
|
|
|
#define _OKULAR_TEXTDOCUMENTGENERATOR_H_
|
|
|
|
|
|
|
|
#include <okular/core/okular_export.h>
|
|
|
|
|
|
|
|
#include <okular/core/document.h>
|
|
|
|
#include <okular/core/generator.h>
|
|
|
|
|
|
|
|
class QTextBlock;
|
|
|
|
class QTextDocument;
|
|
|
|
|
|
|
|
namespace Okular {
|
|
|
|
|
2007-12-08 14:45:32 +00:00
|
|
|
class TextDocumentConverterPrivate;
|
2007-01-13 23:15:28 +00:00
|
|
|
class TextDocumentGenerator;
|
2007-09-14 13:31:55 +00:00
|
|
|
class TextDocumentGeneratorPrivate;
|
2007-01-13 23:15:28 +00:00
|
|
|
|
|
|
|
class OKULAR_EXPORT TextDocumentConverter : public QObject
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
|
2008-02-14 23:19:24 +00:00
|
|
|
friend class TextDocumentGenerator;
|
|
|
|
friend class TextDocumentGeneratorPrivate;
|
|
|
|
|
2007-01-13 23:15:28 +00:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Creates a new generic converter.
|
|
|
|
*/
|
|
|
|
TextDocumentConverter();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destroys the generic converter.
|
|
|
|
*/
|
|
|
|
~TextDocumentConverter();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the generated QTextDocument object.
|
|
|
|
*/
|
|
|
|
virtual QTextDocument *convert( const QString &fileName ) = 0;
|
|
|
|
|
|
|
|
Q_SIGNALS:
|
|
|
|
/**
|
|
|
|
* Adds a new link object which is located between cursorBegin and
|
|
|
|
* cursorEnd to the generator.
|
|
|
|
*/
|
2007-04-20 12:49:17 +00:00
|
|
|
void addAction( Action *link, int cursorBegin, int cursorEnd );
|
2007-01-13 23:15:28 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds a new annotation object which is located between cursorBegin and
|
|
|
|
* cursorEnd to the generator.
|
|
|
|
*/
|
|
|
|
void addAnnotation( Annotation *annotation, int cursorBegin, int cursorEnd );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds a new title at the given level which is located as position to the generator.
|
|
|
|
*/
|
|
|
|
void addTitle( int level, const QString &title, const QTextBlock &position );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds a set of meta data to the generator.
|
|
|
|
*/
|
|
|
|
void addMetaData( const QString &key, const QString &value, const QString &title );
|
|
|
|
|
2008-02-08 14:13:55 +00:00
|
|
|
/**
|
|
|
|
* Adds a set of meta data to the generator.
|
2008-02-14 23:23:14 +00:00
|
|
|
*
|
|
|
|
* @since 0.7 (KDE 4.1)
|
2008-02-08 14:13:55 +00:00
|
|
|
*/
|
|
|
|
void addMetaData( DocumentInfo::Key key, const QString &value );
|
|
|
|
|
2007-01-29 08:17:45 +00:00
|
|
|
/**
|
|
|
|
* This signal should be emitted whenever an error occurred in the converter.
|
|
|
|
*
|
|
|
|
* @param message The message which should be shown to the user.
|
|
|
|
* @param duration The time that the message should be shown to the user.
|
|
|
|
*/
|
|
|
|
void error( const QString &message, int duration );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This signal should be emitted whenever the user should be warned.
|
|
|
|
*
|
|
|
|
* @param message The message which should be shown to the user.
|
|
|
|
* @param duration The time that the message should be shown to the user.
|
|
|
|
*/
|
|
|
|
void warning( const QString &message, int duration );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This signal should be emitted whenever the user should be noticed.
|
|
|
|
*
|
|
|
|
* @param message The message which should be shown to the user.
|
|
|
|
* @param duration The time that the message should be shown to the user.
|
|
|
|
*/
|
|
|
|
void notice( const QString &message, int duration );
|
|
|
|
|
2007-01-13 23:15:28 +00:00
|
|
|
protected:
|
|
|
|
/**
|
|
|
|
* This method can be used to calculate the viewport for a given text block.
|
|
|
|
*
|
2007-09-14 14:19:52 +00:00
|
|
|
* @note This method should be called at the end of the convertion, because it
|
2007-01-13 23:15:28 +00:00
|
|
|
* triggers QTextDocument to do the layout calculation.
|
|
|
|
*/
|
2007-01-19 16:33:58 +00:00
|
|
|
DocumentViewport calculateViewport( QTextDocument *document, const QTextBlock &block );
|
2007-01-13 23:15:28 +00:00
|
|
|
|
2008-02-14 23:19:24 +00:00
|
|
|
/**
|
|
|
|
* Returns the generator that owns this converter.
|
|
|
|
*
|
|
|
|
* @note May be null if the converter was not created for a generator.
|
2008-02-14 23:23:14 +00:00
|
|
|
*
|
|
|
|
* @since 0.7 (KDE 4.1)
|
2008-02-14 23:19:24 +00:00
|
|
|
*/
|
|
|
|
TextDocumentGenerator* generator() const;
|
|
|
|
|
2007-01-13 23:15:28 +00:00
|
|
|
private:
|
2007-12-08 14:45:32 +00:00
|
|
|
TextDocumentConverterPrivate *d_ptr;
|
|
|
|
Q_DECLARE_PRIVATE( TextDocumentConverter )
|
|
|
|
Q_DISABLE_COPY( TextDocumentConverter )
|
2007-01-13 23:15:28 +00:00
|
|
|
};
|
|
|
|
|
2007-09-14 14:19:52 +00:00
|
|
|
/**
|
|
|
|
* @brief QTextDocument-based Generator
|
|
|
|
*
|
|
|
|
* This generator provides a document in the form of a QTextDocument object,
|
|
|
|
* parsed using a specialized TextDocumentConverter.
|
|
|
|
*/
|
2007-01-13 23:15:28 +00:00
|
|
|
class OKULAR_EXPORT TextDocumentGenerator : public Generator
|
|
|
|
{
|
2007-09-01 22:48:28 +00:00
|
|
|
/// @cond PRIVATE
|
2007-01-13 23:15:28 +00:00
|
|
|
friend class TextDocumentConverter;
|
2007-09-01 22:48:28 +00:00
|
|
|
/// @endcond
|
2007-01-13 23:15:28 +00:00
|
|
|
|
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
public:
|
2007-09-14 14:19:52 +00:00
|
|
|
/**
|
|
|
|
* Creates a new generator that uses the specified @p converter.
|
|
|
|
*
|
|
|
|
* @note the generator will take ownership of the converter, so you
|
|
|
|
* don't have to delete it yourself
|
|
|
|
*/
|
2007-12-02 20:57:24 +00:00
|
|
|
TextDocumentGenerator( TextDocumentConverter *converter, QObject *parent, const QVariantList &args );
|
2007-01-13 23:15:28 +00:00
|
|
|
virtual ~TextDocumentGenerator();
|
|
|
|
|
|
|
|
// [INHERITED] load a document and fill up the pagesVector
|
|
|
|
bool loadDocument( const QString & fileName, QVector<Okular::Page*> & pagesVector );
|
|
|
|
|
2007-01-31 18:31:19 +00:00
|
|
|
// [INHERITED] perform actions on document / pages
|
|
|
|
bool canGeneratePixmap() const;
|
|
|
|
void generatePixmap( Okular::PixmapRequest * request );
|
|
|
|
|
2007-10-15 23:01:27 +00:00
|
|
|
// [INHERITED] print document using already configured QPrinter
|
|
|
|
bool print( QPrinter& printer );
|
2007-01-13 23:15:28 +00:00
|
|
|
|
|
|
|
// [INHERITED] text exporting
|
|
|
|
Okular::ExportFormat::List exportFormats() const;
|
|
|
|
bool exportTo( const QString &fileName, const Okular::ExportFormat &format );
|
|
|
|
|
|
|
|
const Okular::DocumentInfo* generateDocumentInfo();
|
|
|
|
const Okular::DocumentSynopsis* generateDocumentSynopsis();
|
|
|
|
|
2007-01-24 15:06:45 +00:00
|
|
|
protected:
|
2007-10-08 16:46:51 +00:00
|
|
|
bool doCloseDocument();
|
2007-01-31 18:31:19 +00:00
|
|
|
Okular::TextPage* textPage( Okular::Page *page );
|
2007-01-24 15:06:45 +00:00
|
|
|
|
2007-01-13 23:15:28 +00:00
|
|
|
private:
|
2007-09-14 13:31:55 +00:00
|
|
|
Q_DECLARE_PRIVATE( TextDocumentGenerator )
|
|
|
|
Q_DISABLE_COPY( TextDocumentGenerator )
|
2007-01-13 23:15:28 +00:00
|
|
|
|
2007-09-14 13:31:55 +00:00
|
|
|
Q_PRIVATE_SLOT( d_func(), void addAction( Action*, int, int ) )
|
|
|
|
Q_PRIVATE_SLOT( d_func(), void addAnnotation( Annotation*, int, int ) )
|
|
|
|
Q_PRIVATE_SLOT( d_func(), void addTitle( int, const QString&, const QTextBlock& ) )
|
|
|
|
Q_PRIVATE_SLOT( d_func(), void addMetaData( const QString&, const QString&, const QString& ) )
|
2008-02-08 14:13:55 +00:00
|
|
|
Q_PRIVATE_SLOT( d_func(), void addMetaData( DocumentInfo::Key, const QString& ) )
|
2007-01-13 23:15:28 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif
|