e71508e160
Add support for world transformations to wxDC too. Currently this is implemented in wxMSW only but could be easily provided in the ports that use wxGraphicsContext for wxDC implementation later. Closes #13092. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@67588 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
381 lines
13 KiB
C++
381 lines
13 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/msw/dc.h
|
|
// Purpose: wxDC class
|
|
// Author: Julian Smart
|
|
// Modified by:
|
|
// Created: 01/02/97
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) Julian Smart
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_MSW_DC_H_
|
|
#define _WX_MSW_DC_H_
|
|
|
|
#include "wx/defs.h"
|
|
#include "wx/dc.h"
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// macros
|
|
// ---------------------------------------------------------------------------
|
|
|
|
#if wxUSE_DC_CACHEING
|
|
/*
|
|
* Cached blitting, maintaining a cache
|
|
* of bitmaps required for transparent blitting
|
|
* instead of constant creation/deletion
|
|
*/
|
|
|
|
class wxDCCacheEntry: public wxObject
|
|
{
|
|
public:
|
|
wxDCCacheEntry(WXHBITMAP hBitmap, int w, int h, int depth);
|
|
wxDCCacheEntry(WXHDC hDC, int depth);
|
|
virtual ~wxDCCacheEntry();
|
|
|
|
WXHBITMAP m_bitmap;
|
|
WXHDC m_dc;
|
|
int m_width;
|
|
int m_height;
|
|
int m_depth;
|
|
};
|
|
#endif
|
|
|
|
// this is an ABC: use one of the derived classes to create a DC associated
|
|
// with a window, screen, printer and so on
|
|
class WXDLLIMPEXP_CORE wxMSWDCImpl: public wxDCImpl
|
|
{
|
|
public:
|
|
wxMSWDCImpl(wxDC *owner, WXHDC hDC);
|
|
virtual ~wxMSWDCImpl();
|
|
|
|
// implement base class pure virtuals
|
|
// ----------------------------------
|
|
|
|
virtual void Clear();
|
|
|
|
virtual bool StartDoc(const wxString& message);
|
|
virtual void EndDoc();
|
|
|
|
virtual void StartPage();
|
|
virtual void EndPage();
|
|
|
|
virtual void SetFont(const wxFont& font);
|
|
virtual void SetPen(const wxPen& pen);
|
|
virtual void SetBrush(const wxBrush& brush);
|
|
virtual void SetBackground(const wxBrush& brush);
|
|
virtual void SetBackgroundMode(int mode);
|
|
#if wxUSE_PALETTE
|
|
virtual void SetPalette(const wxPalette& palette);
|
|
#endif // wxUSE_PALETTE
|
|
|
|
virtual void DestroyClippingRegion();
|
|
|
|
virtual wxCoord GetCharHeight() const;
|
|
virtual wxCoord GetCharWidth() const;
|
|
|
|
virtual bool CanDrawBitmap() const;
|
|
virtual bool CanGetTextExtent() const;
|
|
virtual int GetDepth() const;
|
|
virtual wxSize GetPPI() const;
|
|
|
|
|
|
virtual void SetMapMode(wxMappingMode mode);
|
|
virtual void SetUserScale(double x, double y);
|
|
virtual void SetLogicalScale(double x, double y);
|
|
virtual void SetLogicalOrigin(wxCoord x, wxCoord y);
|
|
virtual void SetDeviceOrigin(wxCoord x, wxCoord y);
|
|
virtual void SetAxisOrientation(bool xLeftRight, bool yBottomUp);
|
|
|
|
#if wxUSE_DC_TRANSFORM_MATRIX
|
|
virtual bool CanUseTransformMatrix() const;
|
|
virtual bool SetTransformMatrix(const wxAffineMatrix2D& matrix);
|
|
virtual wxAffineMatrix2D GetTransformMatrix() const;
|
|
virtual void ResetTransformMatrix();
|
|
#endif // wxUSE_DC_TRANSFORM_MATRIX
|
|
|
|
virtual void SetLogicalFunction(wxRasterOperationMode function);
|
|
|
|
// implementation from now on
|
|
// --------------------------
|
|
|
|
virtual void SetRop(WXHDC cdc);
|
|
virtual void SelectOldObjects(WXHDC dc);
|
|
|
|
void SetWindow(wxWindow *win)
|
|
{
|
|
m_window = win;
|
|
|
|
#if wxUSE_PALETTE
|
|
// if we have palettes use the correct one for this window
|
|
InitializePalette();
|
|
#endif // wxUSE_PALETTE
|
|
}
|
|
|
|
WXHDC GetHDC() const { return m_hDC; }
|
|
void SetHDC(WXHDC dc, bool bOwnsDC = false)
|
|
{
|
|
m_hDC = dc;
|
|
m_bOwnsDC = bOwnsDC;
|
|
|
|
// we might have a pre existing clipping region, make sure that we
|
|
// return it if asked -- but avoid calling ::GetClipBox() right now as
|
|
// it could be unnecessary wasteful
|
|
m_clipping = true;
|
|
m_clipX1 =
|
|
m_clipX2 = 0;
|
|
}
|
|
|
|
const wxBitmap& GetSelectedBitmap() const { return m_selectedBitmap; }
|
|
wxBitmap& GetSelectedBitmap() { return m_selectedBitmap; }
|
|
|
|
// update the internal clip box variables
|
|
void UpdateClipBox();
|
|
|
|
#if wxUSE_DC_CACHEING
|
|
static wxDCCacheEntry* FindBitmapInCache(WXHDC hDC, int w, int h);
|
|
static wxDCCacheEntry* FindDCInCache(wxDCCacheEntry* notThis, WXHDC hDC);
|
|
|
|
static void AddToBitmapCache(wxDCCacheEntry* entry);
|
|
static void AddToDCCache(wxDCCacheEntry* entry);
|
|
static void ClearCache();
|
|
#endif
|
|
|
|
// RTL related functions
|
|
// ---------------------
|
|
|
|
// get or change the layout direction (LTR or RTL) for this dc,
|
|
// wxLayout_Default is returned if layout direction is not supported
|
|
virtual wxLayoutDirection GetLayoutDirection() const;
|
|
virtual void SetLayoutDirection(wxLayoutDirection dir);
|
|
|
|
protected:
|
|
void Init()
|
|
{
|
|
m_bOwnsDC = false;
|
|
m_hDC = NULL;
|
|
|
|
m_oldBitmap = NULL;
|
|
m_oldPen = NULL;
|
|
m_oldBrush = NULL;
|
|
m_oldFont = NULL;
|
|
|
|
#if wxUSE_PALETTE
|
|
m_oldPalette = NULL;
|
|
#endif // wxUSE_PALETTE
|
|
}
|
|
|
|
// create an uninitialized DC: this should be only used by the derived
|
|
// classes
|
|
wxMSWDCImpl( wxDC *owner ) : wxDCImpl( owner ) { Init(); }
|
|
|
|
void RealizeScaleAndOrigin();
|
|
|
|
public:
|
|
virtual void DoGetFontMetrics(int *height,
|
|
int *ascent,
|
|
int *descent,
|
|
int *internalLeading,
|
|
int *externalLeading,
|
|
int *averageWidth) const;
|
|
virtual void DoGetTextExtent(const wxString& string,
|
|
wxCoord *x, wxCoord *y,
|
|
wxCoord *descent = NULL,
|
|
wxCoord *externalLeading = NULL,
|
|
const wxFont *theFont = NULL) const;
|
|
virtual bool DoGetPartialTextExtents(const wxString& text, wxArrayInt& widths) const;
|
|
|
|
virtual bool DoFloodFill(wxCoord x, wxCoord y, const wxColour& col,
|
|
wxFloodFillStyle style = wxFLOOD_SURFACE);
|
|
|
|
virtual void DoGradientFillLinear(const wxRect& rect,
|
|
const wxColour& initialColour,
|
|
const wxColour& destColour,
|
|
wxDirection nDirection = wxEAST);
|
|
|
|
virtual bool DoGetPixel(wxCoord x, wxCoord y, wxColour *col) const;
|
|
|
|
virtual void DoDrawPoint(wxCoord x, wxCoord y);
|
|
virtual void DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
|
|
|
|
virtual void DoDrawArc(wxCoord x1, wxCoord y1,
|
|
wxCoord x2, wxCoord y2,
|
|
wxCoord xc, wxCoord yc);
|
|
virtual void DoDrawCheckMark(wxCoord x, wxCoord y,
|
|
wxCoord width, wxCoord height);
|
|
virtual void DoDrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h,
|
|
double sa, double ea);
|
|
|
|
virtual void DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
|
|
virtual void DoDrawRoundedRectangle(wxCoord x, wxCoord y,
|
|
wxCoord width, wxCoord height,
|
|
double radius);
|
|
virtual void DoDrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
|
|
|
|
#if wxUSE_SPLINES && !defined(__WXWINCE__)
|
|
virtual void DoDrawSpline(const wxPointList *points);
|
|
#endif
|
|
|
|
virtual void DoCrossHair(wxCoord x, wxCoord y);
|
|
|
|
virtual void DoDrawIcon(const wxIcon& icon, wxCoord x, wxCoord y);
|
|
virtual void DoDrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y,
|
|
bool useMask = false);
|
|
|
|
virtual void DoDrawText(const wxString& text, wxCoord x, wxCoord y);
|
|
virtual void DoDrawRotatedText(const wxString& text, wxCoord x, wxCoord y,
|
|
double angle);
|
|
|
|
virtual bool DoBlit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
|
|
wxDC *source, wxCoord xsrc, wxCoord ysrc,
|
|
wxRasterOperationMode rop = wxCOPY, bool useMask = false,
|
|
wxCoord xsrcMask = wxDefaultCoord, wxCoord ysrcMask = wxDefaultCoord);
|
|
|
|
virtual bool DoStretchBlit(wxCoord xdest, wxCoord ydest,
|
|
wxCoord dstWidth, wxCoord dstHeight,
|
|
wxDC *source,
|
|
wxCoord xsrc, wxCoord ysrc,
|
|
wxCoord srcWidth, wxCoord srcHeight,
|
|
wxRasterOperationMode rop = wxCOPY, bool useMask = false,
|
|
wxCoord xsrcMask = wxDefaultCoord, wxCoord ysrcMask = wxDefaultCoord);
|
|
|
|
virtual void DoSetClippingRegion(wxCoord x, wxCoord y,
|
|
wxCoord width, wxCoord height);
|
|
virtual void DoSetDeviceClippingRegion(const wxRegion& region);
|
|
virtual void DoGetClippingBox(wxCoord *x, wxCoord *y,
|
|
wxCoord *w, wxCoord *h) const;
|
|
|
|
virtual void DoGetSizeMM(int* width, int* height) const;
|
|
|
|
virtual void DoDrawLines(int n, wxPoint points[],
|
|
wxCoord xoffset, wxCoord yoffset);
|
|
virtual void DoDrawPolygon(int n, wxPoint points[],
|
|
wxCoord xoffset, wxCoord yoffset,
|
|
wxPolygonFillMode fillStyle = wxODDEVEN_RULE);
|
|
virtual void DoDrawPolyPolygon(int n, int count[], wxPoint points[],
|
|
wxCoord xoffset, wxCoord yoffset,
|
|
wxPolygonFillMode fillStyle = wxODDEVEN_RULE);
|
|
virtual wxBitmap DoGetAsBitmap(const wxRect *subrect) const
|
|
{
|
|
return subrect == NULL ? GetSelectedBitmap()
|
|
: GetSelectedBitmap().GetSubBitmap(*subrect);
|
|
}
|
|
|
|
|
|
#if wxUSE_PALETTE
|
|
// MSW specific, select a logical palette into the HDC
|
|
// (tell windows to translate pixel from other palettes to our custom one
|
|
// and vice versa)
|
|
// Realize tells it to also reset the system palette to this one.
|
|
void DoSelectPalette(bool realize = false);
|
|
|
|
// Find out what palette our parent window has, then select it into the dc
|
|
void InitializePalette();
|
|
#endif // wxUSE_PALETTE
|
|
|
|
protected:
|
|
// common part of DoDrawText() and DoDrawRotatedText()
|
|
void DrawAnyText(const wxString& text, wxCoord x, wxCoord y);
|
|
|
|
// common part of DoSetClippingRegion() and DoSetDeviceClippingRegion()
|
|
void SetClippingHrgn(WXHRGN hrgn);
|
|
|
|
// implementation of DoGetSize() for wxScreen/PrinterDC: this simply
|
|
// returns the size of the entire device this DC is associated with
|
|
//
|
|
// notice that we intentionally put it in a separate function instead of
|
|
// DoGetSize() itself because we want it to remain pure virtual both
|
|
// because each derived class should take care to define it as needed (this
|
|
// implementation is not at all always appropriate) and because we want
|
|
// wxDC to be an ABC to prevent it from being created directly
|
|
void GetDeviceSize(int *width, int *height) const;
|
|
|
|
|
|
// MSW-specific member variables
|
|
// -----------------------------
|
|
|
|
// the window associated with this DC (may be NULL)
|
|
wxWindow *m_canvas;
|
|
|
|
wxBitmap m_selectedBitmap;
|
|
|
|
// TRUE => DeleteDC() in dtor, FALSE => only ReleaseDC() it
|
|
bool m_bOwnsDC:1;
|
|
|
|
// our HDC
|
|
WXHDC m_hDC;
|
|
|
|
// Store all old GDI objects when do a SelectObject, so we can select them
|
|
// back in (this unselecting user's objects) so we can safely delete the
|
|
// DC.
|
|
WXHBITMAP m_oldBitmap;
|
|
WXHPEN m_oldPen;
|
|
WXHBRUSH m_oldBrush;
|
|
WXHFONT m_oldFont;
|
|
|
|
#if wxUSE_PALETTE
|
|
WXHPALETTE m_oldPalette;
|
|
#endif // wxUSE_PALETTE
|
|
|
|
#if wxUSE_DC_CACHEING
|
|
static wxObjectList sm_bitmapCache;
|
|
static wxObjectList sm_dcCache;
|
|
#endif
|
|
|
|
DECLARE_CLASS(wxMSWDCImpl)
|
|
wxDECLARE_NO_COPY_CLASS(wxMSWDCImpl);
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxDCTemp: a wxDC which doesn't free the given HDC (used by wxWidgets
|
|
// only/mainly)
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxDCTempImpl : public wxMSWDCImpl
|
|
{
|
|
public:
|
|
// construct a temporary DC with the specified HDC and size (it should be
|
|
// specified whenever we know it for this HDC)
|
|
wxDCTempImpl(wxDC *owner, WXHDC hdc, const wxSize& size )
|
|
: wxMSWDCImpl( owner, hdc ),
|
|
m_size(size)
|
|
{
|
|
}
|
|
|
|
virtual ~wxDCTempImpl()
|
|
{
|
|
// prevent base class dtor from freeing it
|
|
SetHDC((WXHDC)NULL);
|
|
}
|
|
|
|
virtual void DoGetSize(int *w, int *h) const
|
|
{
|
|
wxASSERT_MSG( m_size.IsFullySpecified(),
|
|
wxT("size of this DC hadn't been set and is unknown") );
|
|
|
|
if ( w )
|
|
*w = m_size.x;
|
|
if ( h )
|
|
*h = m_size.y;
|
|
}
|
|
|
|
private:
|
|
// size of this DC must be explicitly set by SetSize() as we have no way to
|
|
// find it ourselves
|
|
const wxSize m_size;
|
|
|
|
wxDECLARE_NO_COPY_CLASS(wxDCTempImpl);
|
|
};
|
|
|
|
class WXDLLIMPEXP_CORE wxDCTemp : public wxDC
|
|
{
|
|
public:
|
|
wxDCTemp(WXHDC hdc, const wxSize& size = wxDefaultSize)
|
|
: wxDC(new wxDCTempImpl(this, hdc, size))
|
|
{
|
|
}
|
|
};
|
|
|
|
#endif // _WX_MSW_DC_H_
|
|
|