[wxWidgets.git] / include / wx / os2 / dc.h

/////////////////////////////////////////////////////////////////////////////
// Name:        dc.h
// Purpose:     wxDC class
// Author:      David Webster
// Modified by:
// Created:     08/26/99
// RCS-ID:      $Id$
// Copyright:   (c) David Webster
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_DC_H_
#define _WX_DC_H_

#include "wx/defs.h"
//#include "wx/dc.h"

// ---------------------------------------------------------------------------
// macros
// ---------------------------------------------------------------------------

// Logical to device
// Absolute
#define XLOG2DEV(x) (x)
#define YLOG2DEV(y) (y)

// Relative
#define XLOG2DEVREL(x) (x)
#define YLOG2DEVREL(y) (y)

// Device to logical
// Absolute
#define XDEV2LOG(x) (x)

#define YDEV2LOG(y) (y)

// Relative
#define XDEV2LOGREL(x) (x)
#define YDEV2LOGREL(y) (y)

/*
 * Have the same macros as for XView but not for every operation:
 * just for calculating window/viewport extent (a better way of scaling).
 */

// Logical to device
// Absolute
#define MS_XLOG2DEV(x) LogicalToDevice(x)

#define MS_YLOG2DEV(y) LogicalToDevice(y)

// Relative
#define MS_XLOG2DEVREL(x) LogicalToDeviceXRel(x)
#define MS_YLOG2DEVREL(y) LogicalToDeviceYRel(y)

// Device to logical
// Absolute
#define MS_XDEV2LOG(x) DeviceToLogicalX(x)

#define MS_YDEV2LOG(y) DeviceToLogicalY(y)

// Relative
#define MS_XDEV2LOGREL(x) DeviceToLogicalXRel(x)
#define MS_YDEV2LOGREL(y) DeviceToLogicalYRel(y)

#define YSCALE(y) (yorigin - (y))

#define     wx_round(a)    (int)((a)+.5)

class WXDLLEXPORT wxDC : public wxDCBase
{
    DECLARE_DYNAMIC_CLASS(wxDC)

public:
    wxDC(void);
    ~wxDC();

    // implement base class pure virtuals
    // ----------------------------------

    virtual void Clear(void);

    virtual bool    StartDoc(const wxString& rsMessage);
    virtual void    EndDoc(void);

    virtual void    StartPage(void);
    virtual void    EndPage(void);

    virtual void    SetFont(const wxFont& rFont);
    virtual void    SetPen(const wxPen& rPen);
    virtual void    SetBrush(const wxBrush& rBrush);
    virtual void    SetBackground(const wxBrush& rBrush);
    virtual void    SetBackgroundMode(int nMode);
    virtual void    SetPalette(const wxPalette& rPalette);

    virtual void    DestroyClippingRegion(void);

    virtual wxCoord GetCharHeight(void) const;
    virtual wxCoord GetCharWidth(void) const;
    virtual void    DoGetTextExtent( const wxString& rsString
                                    ,wxCoord*        pX
                                    ,wxCoord*        pY
                                    ,wxCoord*        pDescent = NULL
                                    ,wxCoord*        pExternalLeading = NULL
                                    ,wxFont*         pTheFont = NULL
                                   ) const;
    virtual bool    CanDrawBitmap(void) const;
    virtual bool    CanGetTextExtent(void) const;
    virtual int     GetDepth(void) const;
    virtual wxSize  GetPPI(void) const;

    virtual void    SetMapMode(int nMode);
    virtual void    SetUserScale( double dX
                                 ,double dY
                                );
    virtual void    SetSystemScale( double dX
                                   ,double dY
                                  );
    virtual void    SetLogicalScale( double dX
                                    ,double dY
                                   );
    virtual void    SetLogicalOrigin( wxCoord vX
                                     ,wxCoord vY
                                    );
    virtual void    SetDeviceOrigin( wxCoord vX
                                    ,wxCoord vY
                                   );
    virtual void    SetAxisOrientation( bool bXLeftRight
                                       ,bool bYBottomUp
                                      );
    virtual void    SetLogicalFunction(int nFunction);

    // implementation from now on
    // --------------------------

    virtual void    SetRop(WXHDC hCdc);
    virtual void    SelectOldObjects(WXHDC hDc);

    wxWindow*       GetWindow(void) const { return m_pCanvas; }
    void            SetWindow(wxWindow* pWin) { m_pCanvas = pWin; }

    WXHDC           GetHDC(void) const { return m_hDC; }
    void            SetHDC( WXHDC hDc
                           ,bool  bOwnsDC = FALSE
                          )
    {
        m_hDC = hDc;
        m_bOwnsDC = bOwnsDC;
    }

    HPS             GetHPS(void) const { return m_hPS; }
    void            SetHPS(HPS hPS)
    {
        HDC                         hDC = ::GpiQueryDevice(hPS);
        m_hPS = hPS;
    }
    const wxBitmap& GetSelectedBitmap(void) const { return m_vSelectedBitmap; }
    wxBitmap&       GetSelectedBitmap(void) { return m_vSelectedBitmap; }

protected:
    virtual void DoFloodFill( wxCoord         vX
                             ,wxCoord         vY
                             ,const wxColour& rCol
                             ,int             nStyle = wxFLOOD_SURFACE
                            );

    virtual bool DoGetPixel( wxCoord   vX
                            ,wxCoord   vY
                            ,wxColour* pCol
                           ) const;

    virtual void DoDrawPoint( wxCoord vX
                             ,wxCoord vY
                            );
    virtual void DoDrawLine( wxCoord vX1
                            ,wxCoord vY1
                            ,wxCoord vX2
                            ,wxCoord vY2
                           );

    virtual void DoDrawArc( wxCoord vX1
                           ,wxCoord vY1
                           ,wxCoord vX2
                           ,wxCoord vY2
                           ,wxCoord vXc
                           ,wxCoord vYc
                          );
    virtual void DoDrawCheckMark( wxCoord vX
                                 ,wxCoord vY
                                 ,wxCoord vWidth
                                 ,wxCoord vHeight
                                );
    virtual void DoDrawEllipticArc( wxCoord vX
                                   ,wxCoord vY
                                   ,wxCoord vW
                                   ,wxCoord vH
                                   ,double  dSa
                                   ,double  dEa
                                  );

    virtual void DoDrawRectangle( wxCoord vX
                                 ,wxCoord vY
                                 ,wxCoord vWidth
                                 ,wxCoord vHeight
                                );
    virtual void DoDrawRoundedRectangle( wxCoord vX
                                        ,wxCoord vY
                                        ,wxCoord vWidth
                                        ,wxCoord vHeight
                                        ,double  dRadius
                                       );
    virtual void DoDrawEllipse( wxCoord vX
                               ,wxCoord vY
                               ,wxCoord vWidth
                               ,wxCoord vHeight
                              );

    virtual void DoCrossHair( wxCoord vX
                             ,wxCoord vY
                            );

    virtual void DoDrawIcon( const wxIcon& rIcon
                            ,wxCoord       vX
                            ,wxCoord       vY
                           );
    virtual void DoDrawBitmap( const wxBitmap& rBmp
                              ,wxCoord         vX
                              ,wxCoord         vY
                              ,bool            bUseMask = FALSE
                             );

    virtual void DoDrawText( const wxString& rsText
                            ,wxCoord         vX
                            ,wxCoord         vY
                           );
    virtual void DoDrawRotatedText( const wxString& rsText
                                   ,wxCoord         vX
                                   ,wxCoord         vY
                                   ,double          dAngle
                                  );

    virtual bool DoBlit( wxCoord vXdest
                        ,wxCoord vYdest
                        ,wxCoord vWidth
                        ,wxCoord vHeight
                        ,wxDC*   pSource
                        ,wxCoord vXsrc
                        ,wxCoord vYsrc
                        ,int     nRop = wxCOPY
                        ,bool    bUseMask = FALSE
                       );

    virtual void DoSetClippingRegionAsRegion(const wxRegion& rRegion);
    virtual void DoSetClippingRegion( wxCoord vX
                                     ,wxCoord vY
                                     ,wxCoord vWidth
                                     ,wxCoord vHeight
                                    );
    virtual void DoGetClippingRegion( wxCoord* pX
                                     ,wxCoord* pY
                                     ,wxCoord* pWidth
                                     ,wxCoord* pHeight)
    {
        GetClippingBox( pX
                       ,pY
                       ,pWidth
                       ,pHeight
                      );
    }

    virtual void DoGetSize( int* pWidth
                           ,int* pHeight
                          ) const;
    virtual void DoGetSizeMM( int* pWidth
                             ,int* pHeight
                            ) const;

    virtual void DoDrawLines( int     n
                             ,wxPoint vaPoints[]
                             ,wxCoord vXoffset
                             ,wxCoord yYoffset
                            );
    virtual void DoDrawPolygon( int     n
                               ,wxPoint vaPoints[]
                               ,wxCoord vXoffset
                               ,wxCoord vYoffset
                               ,int     nFillStyle = wxODDEVEN_RULE
                              );

#if wxUSE_SPLINES
    virtual void DoDrawSpline(wxList* pPoints);
#endif // wxUSE_SPLINES

    //
    // common part of DoDrawText() and DoDrawRotatedText()
    //
    void DrawAnyText( const wxString& rsText
                     ,wxCoord         vX
                     ,wxCoord         vY
                    );

    // OS2-specific member variables ?? do we even need this under OS/2?
    int                             m_nWindowExtX;
    int                             m_nWindowExtY;

    //
    // the window associated with this DC (may be NULL)
    //
    wxWindow*                       m_pCanvas;
    wxBitmap                        m_vSelectedBitmap;

public:
    // PM specific stuff
    HPS                             m_hPS;
    HPS                             m_hOldPS;   // old hPS, if any
    bool                            m_bIsPaintTime;// True at Paint Time

    RECTL                           m_vRclPaint; // Bounding rectangle at Paint time etc.
    //
    // TRUE => DeleteDC() in dtor, FALSE => only ReleaseDC() it
    //
    bool                            m_bOwnsDC:1;

    //
    // our HDC and its usage count: we only free it when the usage count drops
    // to 0
    //
    WXHDC                           m_hDC;
    int                             m_nDCCount;

    //
    // 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_hOldBitmap;
    WXHPEN                          m_hOldPen;
    WXHBRUSH                        m_hOldBrush;
    WXHFONT                         m_hOldFont;
    WXHPALETTE                      m_hOldPalette;
};
#endif
    // _WX_DC_H_
Commit	Line	Data
0e320a79 DW	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: dc.h
	3	// Purpose: wxDC class
f0a56ab0	4	// Author: David Webster
0e320a79	5	// Modified by:
f0a56ab0	6	// Created: 08/26/99
0e320a79	7	// RCS-ID: $Id$
f0a56ab0 DW	8	// Copyright: (c) David Webster
f0a56ab0 DW	9	// Licence: wxWindows licence
0e320a79 DW	10	/////////////////////////////////////////////////////////////////////////////
	11
	12	#ifndef _WX_DC_H_
	13	#define _WX_DC_H_
	14
fb46a9a6	15	#include "wx/defs.h"
d7e1a322	16	//#include "wx/dc.h"
0e320a79	17
fb46a9a6 DW	18	// ---------------------------------------------------------------------------
	19	// macros
	20	// ---------------------------------------------------------------------------
	21
	22	// Logical to device
	23	// Absolute
	24	#define XLOG2DEV(x) (x)
	25	#define YLOG2DEV(y) (y)
	26
	27	// Relative
	28	#define XLOG2DEVREL(x) (x)
	29	#define YLOG2DEVREL(y) (y)
	30
	31	// Device to logical
	32	// Absolute
	33	#define XDEV2LOG(x) (x)
	34
	35	#define YDEV2LOG(y) (y)
	36
	37	// Relative
	38	#define XDEV2LOGREL(x) (x)
	39	#define YDEV2LOGREL(y) (y)
	40
	41	/*
	42	* Have the same macros as for XView but not for every operation:
	43	* just for calculating window/viewport extent (a better way of scaling).
	44	*/
	45
	46	// Logical to device
	47	// Absolute
	48	#define MS_XLOG2DEV(x) LogicalToDevice(x)
	49
	50	#define MS_YLOG2DEV(y) LogicalToDevice(y)
	51
	52	// Relative
	53	#define MS_XLOG2DEVREL(x) LogicalToDeviceXRel(x)
	54	#define MS_YLOG2DEVREL(y) LogicalToDeviceYRel(y)
	55
	56	// Device to logical
	57	// Absolute
	58	#define MS_XDEV2LOG(x) DeviceToLogicalX(x)
	59
	60	#define MS_YDEV2LOG(y) DeviceToLogicalY(y)
0e320a79	61
fb46a9a6 DW	62	// Relative
	63	#define MS_XDEV2LOGREL(x) DeviceToLogicalXRel(x)
	64	#define MS_YDEV2LOGREL(y) DeviceToLogicalYRel(y)
0e320a79	65
fb46a9a6	66	#define YSCALE(y) (yorigin - (y))
0e320a79	67
fb46a9a6	68	#define wx_round(a) (int)((a)+.5)
0e320a79	69
fb46a9a6	70	class WXDLLEXPORT wxDC : public wxDCBase
54da4255	71	{
fb46a9a6	72	DECLARE_DYNAMIC_CLASS(wxDC)
54da4255	73
fb46a9a6	74	public:
d7e1a322	75	wxDC(void);
fb46a9a6 DW	76	~wxDC();
	77
	78	// implement base class pure virtuals
	79	// ----------------------------------
	80
f6bcfd97 BP	81	virtual void Clear(void);
	82
	83	virtual bool StartDoc(const wxString& rsMessage);
	84	virtual void EndDoc(void);
	85
	86	virtual void StartPage(void);
	87	virtual void EndPage(void);
	88
	89	virtual void SetFont(const wxFont& rFont);
	90	virtual void SetPen(const wxPen& rPen);
	91	virtual void SetBrush(const wxBrush& rBrush);
	92	virtual void SetBackground(const wxBrush& rBrush);
	93	virtual void SetBackgroundMode(int nMode);
	94	virtual void SetPalette(const wxPalette& rPalette);
	95
	96	virtual void DestroyClippingRegion(void);
	97
	98	virtual wxCoord GetCharHeight(void) const;
	99	virtual wxCoord GetCharWidth(void) const;
	100	virtual void DoGetTextExtent( const wxString& rsString
	101	,wxCoord* pX
	102	,wxCoord* pY
	103	,wxCoord* pDescent = NULL
	104	,wxCoord* pExternalLeading = NULL
	105	,wxFont* pTheFont = NULL
	106	) const;
	107	virtual bool CanDrawBitmap(void) const;
	108	virtual bool CanGetTextExtent(void) const;
	109	virtual int GetDepth(void) const;
	110	virtual wxSize GetPPI(void) const;
	111
	112	virtual void SetMapMode(int nMode);
	113	virtual void SetUserScale( double dX
	114	,double dY
	115	);
	116	virtual void SetSystemScale( double dX
	117	,double dY
	118	);
	119	virtual void SetLogicalScale( double dX
	120	,double dY
	121	);
	122	virtual void SetLogicalOrigin( wxCoord vX
	123	,wxCoord vY
	124	);
	125	virtual void SetDeviceOrigin( wxCoord vX
	126	,wxCoord vY
	127	);
	128	virtual void SetAxisOrientation( bool bXLeftRight
	129	,bool bYBottomUp
	130	);
	131	virtual void SetLogicalFunction(int nFunction);
1408104d	132
fb46a9a6 DW	133	// implementation from now on
fb46a9a6 DW	134	// --------------------------
54da4255	135
f6bcfd97 BP	136	virtual void SetRop(WXHDC hCdc);
f6bcfd97 BP	137	virtual void SelectOldObjects(WXHDC hDc);
ce44c50e	138
f6bcfd97 BP	139	wxWindow* GetWindow(void) const { return m_pCanvas; }
f6bcfd97 BP	140	void SetWindow(wxWindow* pWin) { m_pCanvas = pWin; }
ce44c50e	141
f6bcfd97 BP	142	WXHDC GetHDC(void) const { return m_hDC; }
	143	void SetHDC( WXHDC hDc
	144	,bool bOwnsDC = FALSE
	145	)
ce44c50e	146	{
f6bcfd97	147	m_hDC = hDc;
ce44c50e DW	148	m_bOwnsDC = bOwnsDC;
	149	}
	150
d8fcb5e8 DW	151	HPS GetHPS(void) const { return m_hPS; }
	152	void SetHPS(HPS hPS)
	153	{
	154	HDC hDC = ::GpiQueryDevice(hPS);
	155	m_hPS = hPS;
	156	}
f6bcfd97 BP	157	const wxBitmap& GetSelectedBitmap(void) const { return m_vSelectedBitmap; }
	158	wxBitmap& GetSelectedBitmap(void) { return m_vSelectedBitmap; }
	159
1408104d	160	protected:
f6bcfd97 BP	161	virtual void DoFloodFill( wxCoord vX
	162	,wxCoord vY
	163	,const wxColour& rCol
	164	,int nStyle = wxFLOOD_SURFACE
	165	);
	166
	167	virtual bool DoGetPixel( wxCoord vX
	168	,wxCoord vY
	169	,wxColour* pCol
	170	) const;
	171
	172	virtual void DoDrawPoint( wxCoord vX
	173	,wxCoord vY
	174	);
	175	virtual void DoDrawLine( wxCoord vX1
	176	,wxCoord vY1
	177	,wxCoord vX2
	178	,wxCoord vY2
	179	);
	180
	181	virtual void DoDrawArc( wxCoord vX1
	182	,wxCoord vY1
	183	,wxCoord vX2
	184	,wxCoord vY2
	185	,wxCoord vXc
	186	,wxCoord vYc
	187	);
	188	virtual void DoDrawCheckMark( wxCoord vX
	189	,wxCoord vY
	190	,wxCoord vWidth
	191	,wxCoord vHeight
	192	);
	193	virtual void DoDrawEllipticArc( wxCoord vX
	194	,wxCoord vY
	195	,wxCoord vW
	196	,wxCoord vH
	197	,double dSa
	198	,double dEa
	199	);
	200
	201	virtual void DoDrawRectangle( wxCoord vX
	202	,wxCoord vY
	203	,wxCoord vWidth
	204	,wxCoord vHeight
	205	);
	206	virtual void DoDrawRoundedRectangle( wxCoord vX
	207	,wxCoord vY
	208	,wxCoord vWidth
	209	,wxCoord vHeight
	210	,double dRadius
	211	);
	212	virtual void DoDrawEllipse( wxCoord vX
	213	,wxCoord vY
	214	,wxCoord vWidth
	215	,wxCoord vHeight
	216	);
	217
	218	virtual void DoCrossHair( wxCoord vX
	219	,wxCoord vY
	220	);
	221
	222	virtual void DoDrawIcon( const wxIcon& rIcon
	223	,wxCoord vX
	224	,wxCoord vY
225	);
226	virtual void DoDrawBitmap( const wxBitmap& rBmp
227	,wxCoord vX
228	,wxCoord vY
229	,bool bUseMask = FALSE
230	);
231
232	virtual void DoDrawText( const wxString& rsText
233	,wxCoord vX
234	,wxCoord vY
235	);
236	virtual void DoDrawRotatedText( const wxString& rsText
237	,wxCoord vX
238	,wxCoord vY
239	,double dAngle
240	);
241
242	virtual bool DoBlit( wxCoord vXdest
243	,wxCoord vYdest
244	,wxCoord vWidth
245	,wxCoord vHeight
246	,wxDC* pSource
247	,wxCoord vXsrc
248	,wxCoord vYsrc
249	,int nRop = wxCOPY
250	,bool bUseMask = FALSE
251	);
252
253	virtual void DoSetClippingRegionAsRegion(const wxRegion& rRegion);
254	virtual void DoSetClippingRegion( wxCoord vX
255	,wxCoord vY
256	,wxCoord vWidth
257	,wxCoord vHeight
258	);
259	virtual void DoGetClippingRegion( wxCoord* pX
260	,wxCoord* pY
261	,wxCoord* pWidth
262	,wxCoord* pHeight)
fb46a9a6	263	{
f6bcfd97 BP	264	GetClippingBox( pX
	265	,pY
	266	,pWidth
	267	,pHeight
	268	);
fb46a9a6	269	}
1408104d	270
f6bcfd97 BP	271	virtual void DoGetSize( int* pWidth
	272	,int* pHeight
	273	) const;
	274	virtual void DoGetSizeMM( int* pWidth
	275	,int* pHeight
	276	) const;
	277
	278	virtual void DoDrawLines( int n
	279	,wxPoint vaPoints[]
	280	,wxCoord vXoffset
	281	,wxCoord yYoffset
	282	);
	283	virtual void DoDrawPolygon( int n
	284	,wxPoint vaPoints[]
	285	,wxCoord vXoffset
	286	,wxCoord vYoffset
	287	,int nFillStyle = wxODDEVEN_RULE
	288	);
fb46a9a6 DW	289
fb46a9a6 DW	290	#if wxUSE_SPLINES
f6bcfd97	291	virtual void DoDrawSpline(wxList* pPoints);
fb46a9a6 DW	292	#endif // wxUSE_SPLINES
fb46a9a6 DW	293
f6bcfd97 BP	294	//
	295	// common part of DoDrawText() and DoDrawRotatedText()
	296	//
	297	void DrawAnyText( const wxString& rsText
	298	,wxCoord vX
	299	,wxCoord vY
	300	);
fb46a9a6	301
f6bcfd97 BP	302	// OS2-specific member variables ?? do we even need this under OS/2?
	303	int m_nWindowExtX;
	304	int m_nWindowExtY;
1408104d	305
f6bcfd97 BP	306	//
	307	// the window associated with this DC (may be NULL)
	308	//
	309	wxWindow* m_pCanvas;
	310	wxBitmap m_vSelectedBitmap;
1408104d	311
d7e1a322 DW	312	public:
	313	// PM specific stuff
	314	HPS m_hPS;
	315	HPS m_hOldPS; // old hPS, if any
	316	bool m_bIsPaintTime;// True at Paint Time
	317
	318	RECTL m_vRclPaint; // Bounding rectangle at Paint time etc.
f6bcfd97	319	//
fb46a9a6	320	// TRUE => DeleteDC() in dtor, FALSE => only ReleaseDC() it
f6bcfd97 BP	321	//
f6bcfd97 BP	322	bool m_bOwnsDC:1;
fb46a9a6	323
f6bcfd97	324	//
1408104d DW	325	// our HDC and its usage count: we only free it when the usage count drops
1408104d DW	326	// to 0
f6bcfd97 BP	327	//
	328	WXHDC m_hDC;
	329	int m_nDCCount;
1408104d	330
f6bcfd97	331	//
1408104d DW	332	// Store all old GDI objects when do a SelectObject, so we can select them
	333	// back in (this unselecting user's objects) so we can safely delete the
	334	// DC.
f6bcfd97 BP	335	//
	336	WXHBITMAP m_hOldBitmap;
	337	WXHPEN m_hOldPen;
	338	WXHBRUSH m_hOldBrush;
	339	WXHFONT m_hOldFont;
	340	WXHPALETTE m_hOldPalette;
0e320a79	341	};
0e320a79 DW	342	#endif
0e320a79 DW	343	// _WX_DC_H_