zoomablesurfaceview.h

Go to the documentation of this file.

//--- < ZOOMABLESURFACEVIEW.H > -| ViewGraph - A Flexible Graph view Framework |
//
// This class implements a viewport, handles zooming
// and scrolling. Redirects drawing calls to
// SurfaceDriver, shifting and magnifying the
// parameters.
//
// Use this class when magnification is 
// straightforward (objects are not 
// magnification-aware). Otherwise, see the
// ZoomableObjectView class.
//
// $Author: botik32 $
// $Revision: 1.7 $
// $Date: 2004/05/19 16:40:36 $
//-----------------------------------------------------------------------------/

#ifndef ZOOMABLESURFACEVIEW_H
#define ZOOMABLESURFACEVIEW_H

#include <cZUI/zoomableview.h>

class ZoomableSurfaceView : public ZoomableView{
protected:
        /// this value is used in determining how much the graphics
        /// should be scaled
        double object_magnification;
        /// View's absolute magnification
        double view_magnification;
        /// View's inverse of absolute magnification
        double thickness1;
        inline double scene2screenx( double p )
        {
                p -= posx; p *= view_magnification;
                p += screenx; return p;
        };
        inline double scene2screeny( double p )
        {
                p -= posy; p *= view_magnification;
                p += screeny; return p;
        };
        inline double screen2scenex( double p )
        {
                p -= screenx; p /= view_magnification;
                p += posx; return p;
        };
        inline double screen2sceney( double p )
        {
                p -= screeny; p /= view_magnification;
                p += posy; return p;
        };

public:
        void pen( unsigned char r, unsigned char g,
                unsigned char b, double thickness );
        void get_pen( unsigned char& r, unsigned char& g, 
                unsigned char& b, double& thickness );
        void clear_rect( double, double, double, double );
        void repaint_rect( double, double, double, double );
        void get_rect( double&, double&, double&, double& );
        void line( double x1, double y1, double x2, double y2 );
        void rectangle( double x1, double y1, double x2, double y2 );
        void dot( double x1, double y1 );
        void circle( double x1, double y1, double radius );
        void arc( double x1, double y1, double radius,
                double an1, double an2 );
        void bezier( double x1, double y1, double x2, double y2, 
                                 double x3, double y3 );
        virtual void fill_h_triangle( double x1, double y1, 
                                 double x2, double y2, double x3 );
        virtual void fill_v_triangle( double x1, double y1, 
                                 double x2, double y2, double y3 );
        virtual void fillrect( double x1, double y1, double x2, double y2,
                unsigned char fr, unsigned char fg, unsigned char fb );

        void textout( double x1, double y1, const char *text );
        void textrect( double x1, double y1,
                    double x2, double y2, const char *text );
        void setfontsize( double );

        /// use this function to tell the view that the object is initially
        /// visible at magnification m and thus should be resized accordingly.
        void set_object_magnification( double );        
        
        double zoom( double factor );
        double get_zoom( void );
        double get_thickness1( void );

        void center( double, double );
        void scroll( double, double );

        /// This function is used when deciding scenenode visibility
        /// (including for paint events)
        bool rectfits( double, double, double, double );

        void get_scenemousepos( double&, double& );
        ZoomableSurfaceView( SurfaceDriver *, int x, int y, 
                                                        int w, int h,
                unsigned char pbkgr, 
                unsigned char pbkgg,
                unsigned char pbkgb );

        // scale the image before placing
        void put_image( Image *, int destx, int desty,
                double imgzoom = 1. );

};


#endif

/// $Log: zoomablesurfaceview.h,v $
/// Revision 1.7  2004/05/19 16:40:36  botik32
/// Bugfixes and enhancements:
/// Added repaint_due() and brepaint_due to ScrollableView
/// Fixed repaint decisions in GraphWindow to work for multiple-window
/// scenes
/// Fixed ScrollableView to call surfacedriver->clear() in constructor
/// Changed mapchooser to use a smaller resolution world map
///
/// Revision 1.6  2004/05/03 21:02:01  botik32
/// Significant changes and many bugfixes.
/// ScrollableView now has a background color used to
/// tell SurfaceDriver to clear with.
/// SurfaceDriver's clear() requires a color now
/// Added SceneEvents for all node additions/removals
/// in GroupNode and Camera.
/// Added paint_selected and paint_selected_invalid
/// to ActiveLeaf
/// Modified ActiveLeaf's mouse_down and mouse_up
/// handler signatures to accept an Event* instead of
/// Camera*
/// - Many more bugfixes
///
/// Revision 1.5  2004/04/29 09:50:48  botik32
/// Fixed the zoomablesurfaceview's put_image to work
/// correctly with zooms.
/// Moved convert_image_to16() from SurfaceDriver to Image. It
/// is now called convert_to_565()
/// Fixed bug in rgb24.cpp including rgb24.h in the wrong location
/// Finished code zoom in ZoomableSurfaceView, not tested
///
/// Revision 1.4  2004/04/15 10:31:29  botik32
/// Interface change: added arc() function to surfacedriver.
///
/// Revision 1.3  2004/04/10 06:57:20  botik32
/// zoomablesurfaceview.h: Removed typo causing compiler
/// error on multiple include
///
/// Revision 1.2  2004/04/09 17:15:08  botik32
/// Changes in interface: added get_pen to scrollableview and
/// surfacedriver
///
/// Revision 1.1.1.1  2004/03/26 10:50:26  botik32
/// Initial release
///
/// Revision 1.1.1.1  2004/03/26 08:53:33  botik
/// initial import
///
///
/// Revision 1.17  2004/01/03 19:59:41  botik
/// added text support via aedGUI
///
/// Revision 1.16  2003/11/25 13:01:03  botik
/// Changed the flawed way scene node's requests were
/// handled in ZoomableSurfaceView. This fixes a bad bug
/// with HUD nodes moving all over the place.
/// Added CameraZoomedMessage and CameraScrolledMessage
/// Replaced the TranslateNodeMEssage with
/// CameraScrolledMessage in HUDGroupNode. This fixed
/// a HUD flicker bug.
/// Simplified repaint and clear handling in GraphWindow.
/// This fixed a few bugs in repainting.
/// Added rect bounds checking in ScrollableView's
/// clear_rect and repaint_rect. This fixed cameras to only
/// clear their rectangle even if the view holds a larger
/// area.
/// Changed ActiveLeaf to use default paint function if
/// the payload of CameraRepaintLeafMessage is empty. This
/// will allow repaints of moved nodes.
/// Changed LayerNode to allow CameraMovement events even
/// if the layer is inactive. This will update existing HUD
/// controls' position on inactive layers so they do not move
/// astray during scrolls.
/// This is an intermediate change; mouseover checks do not work.
///
/// Revision 1.15  2003/11/24 20:45:29  botik
/// Merged four features from surfacecamera into camera.
/// Modified ScrollableView to hold a width/height of
/// the viewport and to report it to whoever asks.
/// Added scenex, sceney fields to Event.
/// Added coordinate transform for all messages, done
/// at camera level. This should speed up drawability
/// and mouseover checks.
///
/// Repaint and mouse detection work now over arbitrary
/// magnification.
/// Borderlayer is broken and scrolling segfaults in
/// a weird way.
///
/// Revision 1.14  2003/11/24 16:12:10  botik
/// Halfway through major redesign of a view's geometric
/// parameters. This will influence zooming and repainting.
///
/// Revision 1.13  2003/11/20 00:32:41  botik
/// Changed the way repaint works by using a screen
/// rectangle as intermediate event.
/// Added get_screenrect to Camera
/// Added screen2scenerect to Camera
///
/// Revision 1.12  2003/11/18 17:47:20  botik
/// Added triangle fill function to surface driver
/// and views
///
/// Revision 1.11  2003/11/18 13:54:06  botik
/// Got the borderlayer to scroll well.
///
/// Revision 1.10  2003/11/17 18:39:37  botik
/// Added rectangle to surface driver.
/// Sdxpsdl line and rectangle bugfixes
///
/// Revision 1.9  2003/11/17 13:46:34  botik
/// Removed default cursor from scrollableview
/// Changed message handling behaviour for GroupNode
///     to recognize broadcast messages
/// Changed message handling behaviour for BaseSceneNode
///     to recognize broadcast messages
/// Added NodeTranslateMessage to message module
/// Added handling of NodeTranslateMessage for LeafNode
///
/// Revision 1.8  2003/11/15 16:45:18  botik
/// Added ActiveLeaf node allowing for much easier scene
/// node creation.
/// Added default_cursor to scrollableview.
/// Numerous bugfixes.
/// MouseIn/Out now changes cursor.
///
/// Revision 1.7  2003/11/13 18:50:18  botik
/// Fixed (almost) clear and update rect behaviour.
/// Added update_rect to framework and sdl wrapper.
/// Added mouse_in/mouse_out handling
/// Fixed message handling
/// Many small bugfixes
///
/// Revision 1.6  2003/11/13 12:50:51  botik
/// Refined the event handling architecture
/// Got the event handling to recognize and treat mouse
/// events accordingly
/// Important fixes to ./Makefile
///
/// Revision 1.5  2003/11/12 18:14:25  botik
/// Got the framework to check scene nodes for viewport fit
/// before painting.
///
/// Revision 1.4  2003/11/11 14:44:34  botik
/// Changed zoomablesurfaceview to zoom the commands
/// (which it was supposed to do in the first place),
/// Changed some function details in leafnode,
/// Added a new test in tests
///
/// Revision 1.3  2003/11/09 15:23:01  botik
/// Got GraphDisplay to compile and run.
///
/// Revision 1.2  2003/10/21 17:39:00  botik
/// Added preliminary scene support
///
/// Revision 1.1  2003/10/15 12:04:24  botik
/// Changed the name of the SurfaceView class
///
/// Revision 1.2  2003/10/13 16:41:35  botik
/// Added Log keyword to the end of the files
///

---