1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
#ifndef PDFDOCUMENTREFERENCE_H
#define PDFDOCUMENTREFERENCE_H
#include <QString>
#include <QSharedPointer>
#include "pdfcacheoption.h"
#include "poppler-qt.h"
#include <mutex>
// forward-declare
struct PDFPageReference;
/** Holds a reference to a PDF document.
*
* What exactly this means depends on the cache option:
* If the cache option is hold in memory, this class wild have a
* complete in-memory copy of the PDF file.
*
* If the cache option is reread from disk, the reference is
* just the file name.
*
*/
class PDFDocumentReference
{
private:
const QString filename_;
QByteArray fileContents_;
const PDFCacheOption cacheOption_;
// protects access to the poppler document
mutable std::mutex mutex_;
typedef std::lock_guard<std::mutex> Lock;
mutable QSharedPointer<const Poppler::Document> popplerDocument_;
public:
/** Create the document reference.
*
* If the cache option is keep in memory, this will read the entire file into memory.
*/
PDFDocumentReference( const QString& filename, const PDFCacheOption& cacheOption);
/** Returns a Poppler::Page reference to the requested page number
* NOTE: Until poppler supports multi-threading, this will
* create a new Poppler::Document for each request.
*/
PDFPageReference page(unsigned pageNumber) const;
/** Create a Poppler::Document from this reference.
* If you did not cache the file to memory, this step will try to
* read the file.
*/
QSharedPointer<const Poppler::Document> popplerDocument() const;
/** get filename */
const QString& filename() const;
/** get cache setting */
const PDFCacheOption& cacheOption() const;
/** Update the document reference.
* This only works if rhs has the same filename and cache options,
* effectively only updating the file contents buffer.
*/
PDFDocumentReference& operator = (const PDFDocumentReference& rhs);
/** Compares the references. Exact behaviour depends on the cache option:
* If we are memory-caching, this compares the ByteArrays (i.e. checks for
* identical files).
*
* If we are not caching, it just checks for the same filename.
*/
friend bool operator == (const PDFDocumentReference& lhs, const PDFDocumentReference& rhs);
};
#endif // PDFDOCUMENTREFERENCE_H
|
