9b6dbb0974
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@751 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
377 lines
13 KiB
C++
377 lines
13 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: dc.h
|
|
// Purpose: wxDC class
|
|
// Author: Julian Smart
|
|
// Modified by:
|
|
// Created: 17/09/98
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) Julian Smart
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_DC_H_
|
|
#define _WX_DC_H_
|
|
|
|
#ifdef __GNUG__
|
|
#pragma interface "dc.h"
|
|
#endif
|
|
|
|
#include "wx/pen.h"
|
|
#include "wx/brush.h"
|
|
#include "wx/icon.h"
|
|
#include "wx/font.h"
|
|
#include "wx/gdicmn.h"
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// constants
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#ifndef MM_TEXT
|
|
#define MM_TEXT 0
|
|
#define MM_ISOTROPIC 1
|
|
#define MM_ANISOTROPIC 2
|
|
#define MM_LOMETRIC 3
|
|
#define MM_HIMETRIC 4
|
|
#define MM_TWIPS 5
|
|
#define MM_POINTS 6
|
|
#define MM_METRIC 7
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// global variables
|
|
//-----------------------------------------------------------------------------
|
|
|
|
extern int wxPageNumber;
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// wxDC
|
|
//-----------------------------------------------------------------------------
|
|
|
|
class WXDLLEXPORT wxDC: public wxObject
|
|
{
|
|
DECLARE_ABSTRACT_CLASS(wxDC)
|
|
|
|
public:
|
|
|
|
wxDC(void);
|
|
~wxDC(void);
|
|
|
|
void BeginDrawing(void) {};
|
|
void EndDrawing(void) {};
|
|
|
|
virtual bool Ok(void) const { return m_ok; };
|
|
|
|
virtual void FloodFill( long x1, long y1, wxColour* col, int style=wxFLOOD_SURFACE ) = 0;
|
|
inline void FloodFill(const wxPoint& pt, const wxColour& col, int style=wxFLOOD_SURFACE)
|
|
{
|
|
FloodFill(pt.x, pt.y, (wxColour*) & col, style);
|
|
}
|
|
|
|
virtual bool GetPixel( long x1, long y1, wxColour *col ) const = 0;
|
|
inline bool GetPixel(const wxPoint& pt, wxColour *col) const
|
|
{
|
|
return GetPixel(pt.x, pt.y, col);
|
|
}
|
|
|
|
virtual void DrawLine( long x1, long y1, long x2, long y2 ) = 0;
|
|
inline void DrawLine(const wxPoint& pt1, const wxPoint& pt2)
|
|
{
|
|
DrawLine(pt1.x, pt1.y, pt2.x, pt2.y);
|
|
}
|
|
|
|
virtual void CrossHair( long x, long y ) = 0;
|
|
inline void CrossHair(const wxPoint& pt)
|
|
{
|
|
CrossHair(pt.x, pt.y);
|
|
}
|
|
|
|
virtual void DrawArc( long x1, long y1, long x2, long y2, long xc, long yc ) = 0;
|
|
inline void DrawArc(const wxPoint& pt1, const wxPoint& pt2, const wxPoint& centre)
|
|
{
|
|
DrawArc(pt1.x, pt1.y, pt2.x, pt2.y, centre.x, centre.y);
|
|
}
|
|
|
|
virtual void DrawEllipticArc( long x, long y, long width, long height, double sa, double ea ) = 0;
|
|
virtual void DrawEllipticArc (const wxPoint& pt, const wxSize& sz, double sa, double ea)
|
|
{
|
|
DrawEllipticArc(pt.x, pt.y, sz.x, sz.y, sa, ea);
|
|
}
|
|
|
|
virtual void DrawPoint( long x, long y ) = 0;
|
|
virtual void DrawPoint( wxPoint& point );
|
|
|
|
virtual void DrawLines( int n, wxPoint points[], long xoffset = 0, long yoffset = 0 ) = 0;
|
|
virtual void DrawLines( wxList *points, long xoffset = 0, long yoffset = 0 );
|
|
virtual void DrawPolygon( int n, wxPoint points[], long xoffset = 0, long yoffset = 0,
|
|
int fillStyle=wxODDEVEN_RULE ) = 0;
|
|
virtual void DrawPolygon( wxList *lines, long xoffset = 0, long yoffset = 0,
|
|
int fillStyle=wxODDEVEN_RULE );
|
|
|
|
virtual void DrawRectangle( long x, long y, long width, long height ) = 0;
|
|
inline void DrawRectangle(const wxPoint& pt, const wxSize& sz)
|
|
{
|
|
DrawRectangle(pt.x, pt.y, sz.x, sz.y);
|
|
}
|
|
inline void DrawRectangle(const wxRect& rect)
|
|
{
|
|
DrawRectangle(rect.x, rect.y, rect.width, rect.height);
|
|
}
|
|
virtual void DrawRoundedRectangle( long x, long y, long width, long height, double radius = 20.0 ) = 0;
|
|
inline void DrawRoundedRectangle(const wxPoint& pt, const wxSize& sz, double radius = 20.0)
|
|
{
|
|
DrawRoundedRectangle(pt.x, pt.y, sz.x, sz.y, radius);
|
|
}
|
|
inline void DrawRoundedRectangle(const wxRect& rect, double radius = 20.0)
|
|
{
|
|
DrawRoundedRectangle(rect.x, rect.y, rect.width, rect.height, radius);
|
|
}
|
|
|
|
virtual void DrawEllipse( long x, long y, long width, long height ) = 0;
|
|
inline void DrawEllipse(const wxPoint& pt, const wxSize& sz)
|
|
{
|
|
DrawEllipse(pt.x, pt.y, sz.x, sz.y);
|
|
}
|
|
inline void DrawEllipse(const wxRect& rect)
|
|
{
|
|
DrawEllipse(rect.x, rect.y, rect.width, rect.height);
|
|
}
|
|
|
|
virtual void DrawSpline( long x1, long y1, long x2, long y2, long x3, long y3 );
|
|
virtual void DrawSpline( wxList *points );
|
|
virtual void DrawSpline( int n, wxPoint points[] );
|
|
|
|
virtual bool CanDrawBitmap(void) const = 0;
|
|
|
|
virtual void DrawIcon( const wxIcon &icon, long x, long y, bool useMask=FALSE );
|
|
inline void DrawIcon(const wxIcon& icon, const wxPoint& pt)
|
|
{
|
|
DrawIcon(icon, pt.x, pt.y);
|
|
}
|
|
|
|
// TODO DrawBitmap is not always the same as DrawIcon, especially if bitmaps and
|
|
// icons are implemented differently.
|
|
void DrawBitmap( const wxBitmap &bmp, long x, long y, bool useMask=FALSE )
|
|
{ DrawIcon( *((wxIcon*)(&bmp)), x, y, useMask ); }
|
|
|
|
virtual bool Blit( long xdest, long ydest, long width, long height,
|
|
wxDC *source, long xsrc, long ysrc, int logical_func = wxCOPY, bool useMask=FALSE ) = 0;
|
|
inline bool Blit(const wxPoint& destPt, const wxSize& sz,
|
|
wxDC *source, const wxPoint& srcPt, int rop = wxCOPY, bool useMask = FALSE)
|
|
{
|
|
return Blit(destPt.x, destPt.y, sz.x, sz.y, source, srcPt.x, srcPt.y, rop, useMask);
|
|
}
|
|
|
|
virtual void DrawText( const wxString &text, long x, long y, bool use16 = FALSE ) = 0;
|
|
inline void DrawText(const wxString& text, const wxPoint& pt, bool use16bit = FALSE)
|
|
{
|
|
DrawText(text, pt.x, pt.y, use16bit);
|
|
}
|
|
|
|
virtual bool CanGetTextExtent(void) const = 0;
|
|
virtual void GetTextExtent( const wxString &string, long *width, long *height,
|
|
long *descent = NULL, long *externalLeading = NULL,
|
|
wxFont *theFont = NULL, bool use16 = FALSE ) = 0;
|
|
virtual long GetCharWidth(void) = 0;
|
|
virtual long GetCharHeight(void) = 0;
|
|
|
|
virtual void Clear(void) = 0;
|
|
|
|
virtual void SetFont( const wxFont &font ) = 0;
|
|
virtual wxFont *GetFont(void) const { return (wxFont*) &m_font; };
|
|
|
|
virtual void SetPen( const wxPen &pen ) = 0;
|
|
virtual wxPen *GetPen(void) const { return (wxPen*) &m_pen; };
|
|
|
|
virtual void SetBrush( const wxBrush &brush ) = 0;
|
|
virtual wxBrush *GetBrush(void) const { return (wxBrush*) &m_brush; };
|
|
|
|
virtual void SetBackground( const wxBrush &brush ) = 0;
|
|
virtual wxBrush *GetBackground(void) const { return (wxBrush*) &m_backgroundBrush; };
|
|
|
|
virtual void SetLogicalFunction( int function ) = 0;
|
|
virtual int GetLogicalFunction(void) const { return m_logicalFunction; };
|
|
|
|
virtual void SetTextForeground( const wxColour &col );
|
|
virtual void SetTextBackground( const wxColour &col );
|
|
virtual wxColour& GetTextBackground(void) const { return (wxColour&)m_textBackgroundColour; };
|
|
virtual wxColour& GetTextForeground(void) const { return (wxColour&)m_textForegroundColour; };
|
|
|
|
virtual void SetBackgroundMode( int mode ) = 0;
|
|
virtual int GetBackgroundMode(void) const { return m_backgroundMode; };
|
|
|
|
virtual void SetPalette( const wxPalette& palette ) = 0;
|
|
void SetColourMap( const wxPalette& palette ) { SetPalette(palette); };
|
|
|
|
// the first two must be overridden and called
|
|
virtual void SetClippingRegion( long x, long y, long width, long height );
|
|
virtual void DestroyClippingRegion(void);
|
|
virtual void GetClippingBox( long *x, long *y, long *width, long *height ) const;
|
|
|
|
virtual inline long MinX(void) const { return m_minX; }
|
|
virtual inline long MaxX(void) const { return m_maxX; }
|
|
virtual inline long MinY(void) const { return m_minY; }
|
|
virtual inline long MaxY(void) const { return m_maxY; }
|
|
|
|
virtual void GetSize( int* width, int* height ) const;
|
|
inline wxSize GetSize(void) const { int w, h; GetSize(&w, &h); return wxSize(w, h); }
|
|
virtual void GetSizeMM( long* width, long* height ) const;
|
|
|
|
virtual bool StartDoc( const wxString& WXUNUSED(message) ) { return TRUE; };
|
|
virtual void EndDoc(void) {};
|
|
virtual void StartPage(void) {};
|
|
virtual void EndPage(void) {};
|
|
|
|
virtual void SetMapMode( int mode );
|
|
virtual int GetMapMode(void) const { return m_mappingMode; };
|
|
|
|
virtual void SetUserScale( double x, double y );
|
|
virtual void GetUserScale( double *x, double *y );
|
|
virtual void SetLogicalScale( double x, double y );
|
|
virtual void GetLogicalScale( double *x, double *y );
|
|
|
|
virtual void SetLogicalOrigin( long x, long y );
|
|
virtual void GetLogicalOrigin( long *x, long *y );
|
|
virtual void SetDeviceOrigin( long x, long y );
|
|
virtual void GetDeviceOrigin( long *x, long *y );
|
|
virtual void SetInternalDeviceOrigin( long x, long y );
|
|
virtual void GetInternalDeviceOrigin( long *x, long *y );
|
|
|
|
virtual void SetAxisOrientation( bool xLeftRight, bool yBottomUp );
|
|
|
|
virtual void SetOptimization( bool WXUNUSED(optimize) ) {};
|
|
virtual bool GetOptimization(void) { return m_optimize; };
|
|
|
|
virtual long DeviceToLogicalX(long x) const;
|
|
virtual long DeviceToLogicalY(long y) const;
|
|
virtual long DeviceToLogicalXRel(long x) const;
|
|
virtual long DeviceToLogicalYRel(long y) const;
|
|
virtual long LogicalToDeviceX(long x) const;
|
|
virtual long LogicalToDeviceY(long y) const;
|
|
virtual long LogicalToDeviceXRel(long x) const;
|
|
virtual long LogicalToDeviceYRel(long y) const;
|
|
|
|
public:
|
|
|
|
void CalcBoundingBox( long x, long y );
|
|
void ComputeScaleAndOrigin(void);
|
|
|
|
long XDEV2LOG(long x) const
|
|
{
|
|
long new_x = x - m_deviceOriginX;
|
|
if (new_x > 0)
|
|
return (long)((double)(new_x) / m_scaleX + 0.5) * m_signX + m_logicalOriginX;
|
|
else
|
|
return (long)((double)(new_x) / m_scaleX - 0.5) * m_signX + m_logicalOriginX;
|
|
}
|
|
long XDEV2LOGREL(long x) const
|
|
{
|
|
if (x > 0)
|
|
return (long)((double)(x) / m_scaleX + 0.5);
|
|
else
|
|
return (long)((double)(x) / m_scaleX - 0.5);
|
|
}
|
|
long YDEV2LOG(long y) const
|
|
{
|
|
long new_y = y - m_deviceOriginY;
|
|
if (new_y > 0)
|
|
return (long)((double)(new_y) / m_scaleY + 0.5) * m_signY + m_logicalOriginY;
|
|
else
|
|
return (long)((double)(new_y) / m_scaleY - 0.5) * m_signY + m_logicalOriginY;
|
|
}
|
|
long YDEV2LOGREL(long y) const
|
|
{
|
|
if (y > 0)
|
|
return (long)((double)(y) / m_scaleY + 0.5);
|
|
else
|
|
return (long)((double)(y) / m_scaleY - 0.5);
|
|
}
|
|
long XLOG2DEV(long x) const
|
|
{
|
|
long new_x = x - m_logicalOriginX;
|
|
if (new_x > 0)
|
|
return (long)((double)(new_x) * m_scaleX + 0.5) * m_signX + m_deviceOriginX;
|
|
else
|
|
return (long)((double)(new_x) * m_scaleX - 0.5) * m_signX + m_deviceOriginX;
|
|
}
|
|
long XLOG2DEVREL(long x) const
|
|
{
|
|
if (x > 0)
|
|
return (long)((double)(x) * m_scaleX + 0.5);
|
|
else
|
|
return (long)((double)(x) * m_scaleX - 0.5);
|
|
}
|
|
long YLOG2DEV(long y) const
|
|
{
|
|
long new_y = y - m_logicalOriginY;
|
|
if (new_y > 0)
|
|
return (long)((double)(new_y) * m_scaleY + 0.5) * m_signY + m_deviceOriginY;
|
|
else
|
|
return (long)((double)(new_y) * m_scaleY - 0.5) * m_signY + m_deviceOriginY;
|
|
}
|
|
long YLOG2DEVREL(long y) const
|
|
{
|
|
if (y > 0)
|
|
return (long)((double)(y) * m_scaleY + 0.5);
|
|
else
|
|
return (long)((double)(y) * m_scaleY - 0.5);
|
|
}
|
|
|
|
virtual void DrawOpenSpline( wxList *points ) = 0;
|
|
|
|
public:
|
|
|
|
bool m_ok;
|
|
bool m_colour;
|
|
|
|
// not sure, what these mean
|
|
bool m_clipping; // Is clipping on right now ?
|
|
bool m_isInteractive; // Is GetPixel possible ?
|
|
bool m_autoSetting; // wxMSW only ?
|
|
bool m_dontDelete; // wxMSW only ?
|
|
bool m_optimize; // wxMSW only ?
|
|
wxString m_filename; // Not sure where this belongs.
|
|
|
|
wxPen m_pen;
|
|
wxBrush m_brush;
|
|
wxBrush m_backgroundBrush;
|
|
wxColour m_textForegroundColour;
|
|
wxColour m_textBackgroundColour;
|
|
wxFont m_font;
|
|
|
|
int m_logicalFunction;
|
|
int m_backgroundMode;
|
|
int m_textAlignment; // gone in wxWin 2.0 ?
|
|
|
|
int m_mappingMode;
|
|
|
|
// not sure what for, but what is a mm on a screen you don't know the size of?
|
|
double m_mm_to_pix_x,m_mm_to_pix_y;
|
|
|
|
long m_internalDeviceOriginX,m_internalDeviceOriginY; // If un-scrolled is non-zero or
|
|
// d.o. changes with scrolling.
|
|
// Set using SetInternalDeviceOrigin().
|
|
|
|
long m_externalDeviceOriginX,m_externalDeviceOriginY; // To be set by external classes
|
|
// such as wxScrolledWindow
|
|
// using SetDeviceOrigin()
|
|
|
|
long m_deviceOriginX,m_deviceOriginY; // Sum of the two above.
|
|
|
|
long m_logicalOriginX,m_logicalOriginY; // User defined.
|
|
|
|
double m_scaleX,m_scaleY;
|
|
double m_logicalScaleX,m_logicalScaleY;
|
|
double m_userScaleX,m_userScaleY;
|
|
long m_signX,m_signY;
|
|
|
|
bool m_needComputeScaleX,m_needComputeScaleY; // not yet used
|
|
|
|
float m_scaleFactor; // wxPSDC wants to have this. Will disappear.
|
|
|
|
long m_clipX1,m_clipY1,m_clipX2,m_clipY2;
|
|
long m_minX,m_maxX,m_minY,m_maxY;
|
|
};
|
|
|
|
#endif
|
|
// _WX_DC_H_
|