summaryrefslogtreecommitdiffstats
path: root/chalk/ui/kobirdeyepanel.h
diff options
context:
space:
mode:
Diffstat (limited to 'chalk/ui/kobirdeyepanel.h')
-rw-r--r--chalk/ui/kobirdeyepanel.h263
1 files changed, 263 insertions, 0 deletions
diff --git a/chalk/ui/kobirdeyepanel.h b/chalk/ui/kobirdeyepanel.h
new file mode 100644
index 00000000..24770b18
--- /dev/null
+++ b/chalk/ui/kobirdeyepanel.h
@@ -0,0 +1,263 @@
+/*
+ * This file is part of the KDE project
+ *
+ * Copyright (c) 2005 Boudewijn Rempt <boud@valdyas.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.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ */
+
+#ifndef KO_BIRD_EYE_PANEL
+#define KO_BIRD_EYE_PANEL
+
+#include <tqrect.h>
+#include <tqwidget.h>
+
+#include <KoPoint.h>
+#include <KoRect.h>
+
+class TQPixmap;
+class KAction;
+class KoDocument;
+class WdgBirdEye;
+
+
+class KoCanvasAdapter {
+
+public:
+
+ KoCanvasAdapter();
+ virtual ~KoCanvasAdapter();
+
+ /**
+ * Returns the area of the document that is visible, in pixels
+ */
+ virtual KoRect visibleArea() = 0;
+
+ /**
+ * Returns the total area of the document in pixels. Use KoPageLayout and KoZoomhandler
+ * to take care of zoom, points and whatnot when computing this.
+ */
+ virtual TQRect size() = 0;
+
+ /**
+ * Return the current canvas zoom factor.
+ */
+ virtual double zoomFactor() = 0;
+
+ /**
+ * Show pt in the center of the view
+ */
+ virtual void setViewCenterPoint(double x, double y) = 0;
+};
+
+/**
+ * The zoom listener interface defines methods that the bird eye
+ * panel will call whenever the zoomlevel is changed through one
+ * of the panel actions.
+ */
+class KoZoomAdapter {
+
+public:
+
+ KoZoomAdapter();
+ virtual ~KoZoomAdapter();
+
+ /**
+ * Zoom to the specified factor around the point x and y
+ */
+ virtual void zoomTo(double x, double y, double factor ) = 0;
+
+ /**
+ * Zoom one step in.
+ */
+ virtual void zoomIn() = 0;
+
+ /**
+ * Zoom one step out.
+ */
+ virtual void zoomOut() = 0;
+
+ /**
+ * Get the minimum zoom factor that this listener supports.
+ */
+ virtual double getMinZoom() = 0;
+
+ /**
+ * Get the maximum zoom factor that this listener supports.
+ */
+ virtual double getMaxZoom() = 0;
+
+};
+
+
+class KoThumbnailAdapter
+{
+ public:
+
+ KoThumbnailAdapter();
+ ~KoThumbnailAdapter();
+
+ /**
+ * Returns the size of the document in pixels.
+ * If the document is a KoDocument that uses a KoPageLayout, the same
+ * formula as in the generatePreview() method should be used to go from points
+ * to pixels.
+ *
+ * @returns the size in pixels.
+ */
+ virtual TQSize pixelSize() = 0;
+
+ /**
+ * Returns the specified rectangle of the thumbnail as a TQImage. thumbnailSize
+ * gives the dimensions of the whole document thumbnail, and r specifies a rectangle
+ * within that.
+ *
+ * @param r the rectangle in the thumbnail to be rendered
+ * @param thumbnailSize the size in pixels of the full thumbnail
+ */
+ virtual TQImage image(TQRect r, TQSize thumbnailSize) = 0;
+};
+
+/**
+ * A complex widget that provides an overview of a document
+ * with a red panning rectangle to and a zoom slider and a toolbar
+ * with a couple of useful functions.
+ */
+class KoBirdEyePanel : public TQWidget {
+
+ Q_OBJECT
+ TQ_OBJECT
+
+public:
+
+ /**
+ * Create a new bird eye panel.
+ *
+ * @param zoomListener the object that listens to the zoom instructions we give
+ * @param thumbnailProvider the class that creates the small image at the right
+ * zoomlevel
+ * @param canvas the place the document is painted.
+ * @param tqparent the tqparent widget
+ * @param name the TQObject name of this bird eye widget
+ * @param f the widget flags (@see TQWidget)
+ */
+ KoBirdEyePanel( KoZoomAdapter * zoomListener,
+ KoThumbnailAdapter * thumbnailProvider,
+ KoCanvasAdapter * canvas,
+ TQWidget * tqparent,
+ const char * name = 0,
+ WFlags f = 0 );
+
+ virtual ~KoBirdEyePanel();
+
+ bool eventFilter(TQObject*, TQEvent*);
+
+public slots:
+
+ void setZoomListener( KoZoomAdapter * zoomListener) { m_zoomListener = zoomListener; }
+
+ /**
+ * Set a new thumbnail provider. This will first delete the existing provider.
+ **/
+ void setThumbnailProvider( KoThumbnailAdapter * thumbnailProvider );
+
+ /**
+ * Connect to this slot to inform the bird's eye view of changes in
+ * the view transformation, i.e. zoom level or scroll changes.
+ */
+ void slotViewTransformationChanged();
+
+ void cursorPosChanged(TQ_INT32 xpos, TQ_INT32 ypos);
+
+ void zoomMinus();
+ void zoomPlus();
+
+ /**
+ * Connect to this slot if a (rectangular) area of your document is changed.
+ *
+ * @param r The rect that has been changed: this is unzoomed.
+ */
+ void slotUpdate(const TQRect & r);
+
+protected slots:
+
+ void updateVisibleArea();
+ void zoomValueChanged(int zoom);
+ void zoom100();
+ void sliderChanged(int);
+
+protected:
+ void setZoom(int zoom);
+
+ void handleMouseMove(TQPoint);
+ void handleMouseMoveAction(TQPoint);
+ void handleMousePress(TQPoint);
+ void fitThumbnailToView();
+ void renderView();
+ void resizeViewEvent(TQSize size);
+ void paintViewEvent(TQPaintEvent *e);
+ void makeThumbnailRectVisible(const TQRect& r);
+
+ enum enumDragHandle {
+ DragHandleNone,
+ DragHandleLeft,
+ DragHandleCentre,
+ DragHandleRight,
+ DragHandleTop,
+ DragHandleBottom
+ };
+
+ /*
+ * Returns the drag handle type at point p in thumbnail coordinates.
+ */
+ enumDragHandle dragHandleAt(TQPoint p);
+
+ /**
+ * Returns the rectangle in the thumbnail covered by the given document rectangle.
+ */
+ TQRect documentToThumbnail(const KoRect& docRect);
+
+ /**
+ * Returns the rectangle in the document covered by the given thumbnail rectangle.
+ */
+ KoRect thumbnailToDocument(const TQRect& thumbnailRect);
+
+ /**
+ * Converts a point in the view to a point in the thumbnail.
+ */
+ TQPoint viewToThumbnail(const TQPoint& viewPoint);
+
+private:
+
+ WdgBirdEye * m_page;
+
+ KoZoomAdapter * m_zoomListener;
+ KoThumbnailAdapter * m_thumbnailProvider;
+ KoCanvasAdapter * m_canvas;
+
+ KAction* m_zoomIn;
+ KAction* m_zoomOut;
+ TQPixmap m_viewBuffer;
+ TQPixmap m_thumbnail;
+
+ TQSize m_documentSize;
+ TQRect m_visibleAreaInThumbnail;
+ bool m_dragging;
+ enumDragHandle m_dragHandle;
+ TQPoint m_lastDragPos;
+
+};
+
+#endif