mirror of
https://invent.kde.org/graphics/okular
synced 2024-09-20 00:11:19 +00:00
255 lines
9.5 KiB
C++
255 lines
9.5 KiB
C++
/***************************************************************************
|
|
* Copyright (C) 2005 by Enrico Ros <eros.kde@email.it> *
|
|
* *
|
|
* 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_ANNOTATIONS_H_
|
|
#define _OKULAR_ANNOTATIONS_H_
|
|
|
|
#include <QtCore/QString>
|
|
#include <QtCore/QDateTime>
|
|
#include <QtCore/QLinkedList>
|
|
#include <QtGui/QFont>
|
|
#include <QtXml/QDomDocument>
|
|
#include <QtXml/QDomElement>
|
|
|
|
#include "page.h"
|
|
|
|
namespace Okular {
|
|
|
|
class Annotation;
|
|
|
|
/**
|
|
* @short Helper class for (recoursive) annotation retrieval/storage.
|
|
*
|
|
*/
|
|
class AnnotationUtils
|
|
{
|
|
public:
|
|
// restore an annotation (with revisions if needed) from a dom
|
|
// element. returns a pointer to the complete annotation or 0 if
|
|
// element is invalid.
|
|
static Annotation * createAnnotation( const QDomElement & annElement );
|
|
|
|
// save the 'ann' annotations as a child of parentElement taking
|
|
// care of saving all revisions if 'ann' has any.
|
|
static void storeAnnotation( const Annotation * ann,
|
|
QDomElement & annElement, QDomDocument & document );
|
|
|
|
// return an element called 'name' from the direct children of
|
|
// parentNode or a null element if not found
|
|
static QDomElement findChildElement( const QDomNode & parentNode,
|
|
const QString & name );
|
|
|
|
// return the translated string with the type of the annotation
|
|
// specified
|
|
static QString captionForAnnotation( Annotation * ann );
|
|
|
|
//static inline QRect annotationGeometry( const Annotation * ann,
|
|
// int pageWidth, int pageHeight, int scaledWidth, int scaledHeight ) const;
|
|
};
|
|
|
|
|
|
/**
|
|
* @short Annotation struct holds properties shared by all annotations.
|
|
*
|
|
* An Annotation is an object (text note, highlight, sound, popup window, ..)
|
|
* contained by a Page in the document.
|
|
*
|
|
* For current state in relations to pdf embedded annotations:
|
|
* @see generator_pdf/README.Annotations
|
|
*/
|
|
struct OKULAR_EXPORT Annotation
|
|
{
|
|
// enum definitions
|
|
// WARNING!!! Get that in sync with poppler enums!
|
|
enum SubType { AText = 1, ALine = 2, AGeom = 3, AHighlight = 4, AStamp = 5,
|
|
AInk = 6, A_BASE = 0 };
|
|
enum Flag { Hidden = 1, FixedSize = 2, FixedRotation = 4, DenyPrint = 8,
|
|
DenyWrite = 16, DenyDelete = 32, ToggleHidingOnMouse = 64, External = 128 };
|
|
enum LineStyle { Solid = 1, Dashed = 2, Beveled = 4, Inset = 8, Underline = 16 };
|
|
enum LineEffect { NoEffect = 1, Cloudy = 2};
|
|
enum RevScope { Reply = 1, Group = 2, Delete = 4 };
|
|
enum RevType { None = 1, Marked = 2, Unmarked = 4, Accepted = 8, Rejected = 16, Cancelled = 32, Completed = 64 };
|
|
|
|
/** properties: contents related */
|
|
QString author; // ''
|
|
QString contents; // ''
|
|
QString uniqueName; // 'okular-#NUMBER#'
|
|
QDateTime modifyDate; // before or equal to currentDateTime()
|
|
QDateTime creationDate; // before or equal to modifyDate
|
|
|
|
/** properties: look/interaction related */
|
|
int flags; // 0
|
|
NormalizedRect boundary; // valid or isNull()
|
|
struct Style
|
|
{
|
|
// appearance properties
|
|
QColor color; // black
|
|
double opacity; // 1.0
|
|
// pen properties
|
|
double width; // 1.0
|
|
LineStyle style; // LineStyle::Solid
|
|
double xCorners; // 0.0
|
|
double yCorners; // 0.0
|
|
int marks; // 3
|
|
int spaces; // 0
|
|
// pen effects
|
|
LineEffect effect; // LineEffect::NoEffect
|
|
double effectIntensity; // 1.0
|
|
// default initializer
|
|
Style();
|
|
} style;
|
|
|
|
/** properties: popup window */
|
|
struct Window
|
|
{
|
|
// window state (Hidden, FixedRotation, Deny* flags allowed)
|
|
int flags; // -1 (never initialized) -> 0 (if inited and shown)
|
|
// geometric properties
|
|
NormalizedPoint topLeft; // no default, inited to boundary.topLeft
|
|
int width; // no default, fixed width inited to 200
|
|
int height; // no default, fixed height inited to 150
|
|
// window contens/override properties
|
|
QString title; // '' text in the titlebar (overrides author)
|
|
QString summary; // '' short description (displayed if not empty)
|
|
QString text; // '' text for the window (overrides annot->contents)
|
|
// default initializer
|
|
Window();
|
|
} window;
|
|
|
|
/** properties: versioning */
|
|
struct Revision
|
|
{
|
|
// child revision
|
|
Annotation * annotation; // not null
|
|
// scope and type of revision
|
|
RevScope scope; // Reply
|
|
RevType type; // None
|
|
// default initializer
|
|
Revision();
|
|
};
|
|
QLinkedList< Revision > revisions; // empty by default
|
|
|
|
// methods: query annotation's type for runtime type identification
|
|
virtual SubType subType() const { return A_BASE; }
|
|
//QRect geometry( int scaledWidth, int scaledHeight, Page * page );
|
|
|
|
// methods: storage/retrieval from xml nodes
|
|
Annotation( const QDomNode & node );
|
|
virtual void store( QDomNode & parentNode, QDomDocument & document ) const;
|
|
|
|
// methods: default constructor / virtual destructor
|
|
Annotation();
|
|
virtual ~Annotation();
|
|
};
|
|
|
|
|
|
// a helper used to shorten the code presented below
|
|
#define AN_COMMONDECL( className, rttiType )\
|
|
className();\
|
|
className( const class QDomNode & node );\
|
|
void store( QDomNode & parentNode, QDomDocument & document ) const;\
|
|
SubType subType() const { return rttiType; }
|
|
|
|
struct OKULAR_EXPORT TextAnnotation : public Annotation
|
|
{
|
|
// common stuff for Annotation derived classes
|
|
AN_COMMONDECL( TextAnnotation, AText );
|
|
|
|
// local enums
|
|
enum TextType { Linked, InPlace };
|
|
enum InplaceIntent { Unknown, Callout, TypeWriter };
|
|
|
|
// data fields
|
|
TextType textType; // Linked
|
|
QString textIcon; // 'Comment'
|
|
QFont textFont; // app def font
|
|
int inplaceAlign; // 0:left, 1:center, 2:right
|
|
QString inplaceText; // '' overrides contents
|
|
NormalizedPoint inplaceCallout[3]; //
|
|
InplaceIntent inplaceIntent; // Unknown
|
|
};
|
|
|
|
struct OKULAR_EXPORT LineAnnotation : public Annotation
|
|
{
|
|
// common stuff for Annotation derived classes
|
|
AN_COMMONDECL( LineAnnotation, ALine )
|
|
|
|
// local enums
|
|
enum TermStyle { Square, Circle, Diamond, OpenArrow, ClosedArrow, None,
|
|
Butt, ROpenArrow, RClosedArrow, Slash };
|
|
enum LineIntent { Unknown, Arrow, Dimension, PolygonCloud };
|
|
|
|
// data fields (note uses border for rendering style)
|
|
QLinkedList<NormalizedPoint> linePoints;
|
|
TermStyle lineStartStyle; // None
|
|
TermStyle lineEndStyle; // None
|
|
bool lineClosed; // false (if true draw close shape)
|
|
QColor lineInnerColor; //
|
|
double lineLeadingFwdPt; // 0.0
|
|
double lineLeadingBackPt; // 0.0
|
|
bool lineShowCaption; // false
|
|
LineIntent lineIntent; // Unknown
|
|
};
|
|
|
|
struct OKULAR_EXPORT GeomAnnotation : public Annotation
|
|
{
|
|
// common stuff for Annotation derived classes
|
|
AN_COMMONDECL( GeomAnnotation, AGeom )
|
|
|
|
// common enums
|
|
enum GeomType { InscribedSquare, InscribedCircle };
|
|
|
|
// data fields (note uses border for rendering style)
|
|
GeomType geomType; // InscribedSquare
|
|
QColor geomInnerColor; //
|
|
int geomWidthPt; // 18
|
|
};
|
|
|
|
struct OKULAR_EXPORT HighlightAnnotation : public Annotation
|
|
{
|
|
// common stuff for Annotation derived classes
|
|
AN_COMMONDECL( HighlightAnnotation, AHighlight )
|
|
|
|
// local enums
|
|
enum HighlightType { Highlight, Squiggly, Underline, StrikeOut };
|
|
|
|
// data fields
|
|
HighlightType highlightType; // Highlight
|
|
struct Quad
|
|
{
|
|
NormalizedPoint points[4]; // 8 valid coords
|
|
bool capStart; // false (vtx 1-4) [K]
|
|
bool capEnd; // false (vtx 2-3) [K]
|
|
double feather; // 0.1 (in range 0..1) [K]
|
|
};
|
|
QList< Quad > highlightQuads; // not empty
|
|
};
|
|
|
|
struct OKULAR_EXPORT StampAnnotation : public Annotation
|
|
{
|
|
// common stuff for Annotation derived classes
|
|
AN_COMMONDECL( StampAnnotation, AStamp )
|
|
|
|
// data fields
|
|
QString stampIconName; // 'Draft'
|
|
};
|
|
|
|
struct OKULAR_EXPORT InkAnnotation : public Annotation
|
|
{
|
|
// common stuff for Annotation derived classes
|
|
AN_COMMONDECL( InkAnnotation, AInk )
|
|
|
|
// data fields
|
|
QList< QLinkedList<NormalizedPoint> > inkPaths;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|