]>
Commit | Line | Data |
---|---|---|
4f72fe4f | 1 | /////////////////////////////////////////////////////////////////////////////// |
17b1d76b | 2 | // Name: wx/os2/gdiimage.h |
4f72fe4f DW |
3 | // Purpose: wxGDIImage class: base class for wxBitmap, wxIcon, wxCursor |
4 | // under OS/2 | |
5 | // Author: David Webster (adapted from msw version by Vadim Zeitlin) | |
6 | // Modified by: | |
7 | // Created: 20.11.99 | |
8 | // RCS-ID: $Id$ | |
9 | // Copyright: (c) 1999 David Webster | |
65571936 | 10 | // Licence: wxWindows licence |
4f72fe4f DW |
11 | /////////////////////////////////////////////////////////////////////////////// |
12 | ||
13 | // NB: this is a private header, it is not intended to be directly included by | |
14 | // user code (but may be included from other, public, wxWin headers | |
15 | ||
16 | #ifndef _WX_OS2_GDIIMAGE_H_ | |
17 | #define _WX_OS2_GDIIMAGE_H_ | |
18 | ||
4f72fe4f DW |
19 | #include "wx/gdiobj.h" // base class |
20 | #include "wx/gdicmn.h" // wxBITMAP_TYPE_INVALID | |
21 | #include "wx/list.h" | |
22 | ||
b5dbe15d VS |
23 | class WXDLLIMPEXP_FWD_CORE wxGDIImageRefData; |
24 | class WXDLLIMPEXP_FWD_CORE wxGDIImageHandler; | |
25 | class WXDLLIMPEXP_FWD_CORE wxGDIImage; | |
4f72fe4f | 26 | |
258f5b3e DW |
27 | WX_DECLARE_EXPORTED_LIST(wxGDIImageHandler, wxGDIImageHandlerList); |
28 | ||
4f72fe4f DW |
29 | // ---------------------------------------------------------------------------- |
30 | // wxGDIImageRefData: common data fields for all derived classes | |
31 | // ---------------------------------------------------------------------------- | |
32 | ||
53a2db12 | 33 | class WXDLLIMPEXP_CORE wxGDIImageRefData : public wxGDIRefData |
4f72fe4f DW |
34 | { |
35 | public: | |
36 | wxGDIImageRefData() | |
37 | { | |
38 | m_nWidth = m_nHeight = m_nDepth = 0; | |
39 | ||
40 | m_hHandle = 0; | |
4f72fe4f DW |
41 | } |
42 | ||
43 | // accessors | |
8f884a0d | 44 | virtual bool IsOk() const |
9add53a4 DW |
45 | { |
46 | if (m_hHandle == 0) | |
17b1d76b WS |
47 | return false; |
48 | return true; | |
9add53a4 | 49 | } |
4f72fe4f DW |
50 | |
51 | void SetSize( int nW | |
52 | ,int nH | |
53 | ) | |
54 | { m_nWidth = nW; m_nHeight = nH; } | |
55 | ||
56 | // free the ressources we allocated | |
9add53a4 | 57 | virtual void Free() { }; |
4f72fe4f DW |
58 | |
59 | // for compatibility, the member fields are public | |
60 | ||
61 | // the size of the image | |
62 | int m_nWidth; | |
63 | int m_nHeight; | |
64 | ||
65 | // the depth of the image | |
66 | int m_nDepth; | |
67 | ||
68 | // the handle to it | |
69 | union | |
70 | { | |
71 | WXHANDLE m_hHandle; // for untyped access | |
72 | WXHBITMAP m_hBitmap; | |
73 | WXHICON m_hIcon; | |
74 | WXHCURSOR m_hCursor; | |
75 | }; | |
76 | ||
4b3f61d1 | 77 | unsigned int m_uId; |
4f72fe4f DW |
78 | }; |
79 | ||
80 | // ---------------------------------------------------------------------------- | |
81 | // wxGDIImageHandler: a class which knows how to load/save wxGDIImages. | |
82 | // ---------------------------------------------------------------------------- | |
83 | ||
53a2db12 | 84 | class WXDLLIMPEXP_CORE wxGDIImageHandler : public wxObject |
4f72fe4f DW |
85 | { |
86 | public: | |
87 | // ctor | |
88 | wxGDIImageHandler() { m_lType = wxBITMAP_TYPE_INVALID; } | |
89 | wxGDIImageHandler( const wxString& rName | |
90 | ,const wxString& rExt | |
6b5c2d52 | 91 | ,wxBitmapType lType |
4f72fe4f DW |
92 | ) |
93 | : m_sName(rName) | |
94 | , m_sExtension(rExt) | |
95 | { | |
96 | m_lType = lType; | |
97 | } | |
98 | ||
99 | // accessors | |
100 | void SetName(const wxString& rName) { m_sName = rName; } | |
101 | void SetExtension(const wxString& rExt) { m_sExtension = rExt; } | |
6b5c2d52 | 102 | void SetType(wxBitmapType lType) { m_lType = lType; } |
4f72fe4f DW |
103 | |
104 | wxString GetName() const { return m_sName; } | |
105 | wxString GetExtension() const { return m_sExtension; } | |
6b5c2d52 | 106 | wxBitmapType GetType() const { return m_lType; } |
4f72fe4f DW |
107 | |
108 | // real handler operations: to implement in derived classes | |
109 | virtual bool Create( wxGDIImage* pImage | |
ebd0940b | 110 | ,const void* pData |
6b5c2d52 | 111 | ,wxBitmapType lFlags |
4f72fe4f DW |
112 | ,int nWidth |
113 | ,int nHeight | |
114 | ,int nDepth = 1 | |
115 | ) = 0; | |
116 | virtual bool Load( wxGDIImage* pImage | |
117 | ,const wxString& rName | |
97507cce | 118 | ,HPS hPs |
6b5c2d52 | 119 | ,wxBitmapType lFlags |
4f72fe4f DW |
120 | ,int nDesiredWidth |
121 | ,int nDesiredHeight | |
122 | ) = 0; | |
b6f4144e DW |
123 | virtual bool Load( wxGDIImage* pImage |
124 | ,int nId | |
6b5c2d52 | 125 | ,wxBitmapType lFlags |
b6f4144e DW |
126 | ,int nDesiredWidth |
127 | ,int nDesiredHeight | |
128 | ) = 0; | |
6b5c2d52 SN |
129 | virtual bool Save( const wxGDIImage* pImage |
130 | ,const wxString& rName | |
131 | ,wxBitmapType lType | |
132 | ) const = 0; | |
4f72fe4f DW |
133 | |
134 | protected: | |
135 | wxString m_sName; | |
136 | wxString m_sExtension; | |
6b5c2d52 | 137 | wxBitmapType m_lType; |
b6f4144e | 138 | }; // end of wxGDIImageHandler |
4f72fe4f DW |
139 | |
140 | // ---------------------------------------------------------------------------- | |
141 | // wxGDIImage: this class supports GDI image handlers which may be registered | |
142 | // dynamically and will be used for loading/saving the images in the specified | |
143 | // format. It also falls back to wxImage if no appropriate image is found. | |
144 | // ---------------------------------------------------------------------------- | |
145 | ||
53a2db12 | 146 | class WXDLLIMPEXP_CORE wxGDIImage : public wxGDIObject |
4f72fe4f DW |
147 | { |
148 | public: | |
149 | // handlers list interface | |
258f5b3e | 150 | static wxGDIImageHandlerList& GetHandlers() { return ms_handlers; } |
4f72fe4f DW |
151 | |
152 | static void AddHandler(wxGDIImageHandler* hHandler); | |
153 | static void InsertHandler(wxGDIImageHandler* hHandler); | |
154 | static bool RemoveHandler(const wxString& rName); | |
155 | ||
156 | static wxGDIImageHandler* FindHandler(const wxString& rName); | |
6b5c2d52 SN |
157 | static wxGDIImageHandler* FindHandler(const wxString& rExtension, wxBitmapType lType); |
158 | static wxGDIImageHandler* FindHandler(wxBitmapType lType); | |
4f72fe4f DW |
159 | |
160 | static void InitStandardHandlers(); | |
161 | static void CleanUpHandlers(); | |
162 | ||
163 | // access to the ref data casted to the right type | |
164 | wxGDIImageRefData *GetGDIImageData() const | |
165 | { return (wxGDIImageRefData *)m_refData; } | |
166 | ||
167 | // create data if we don't have it yet | |
168 | void EnsureHasData() { if ( IsNull() ) m_refData = CreateData(); } | |
169 | ||
170 | // accessors | |
171 | WXHANDLE GetHandle() const | |
9add53a4 DW |
172 | { |
173 | wxGDIImageRefData* pData; | |
174 | ||
175 | pData = GetGDIImageData(); | |
176 | if (!pData) | |
177 | return 0; | |
178 | else | |
179 | return pData->m_hHandle; | |
180 | } | |
4f72fe4f | 181 | void SetHandle(WXHANDLE hHandle) |
9add53a4 DW |
182 | { |
183 | wxGDIImageRefData* pData; | |
184 | ||
185 | EnsureHasData(); | |
186 | pData = GetGDIImageData(); | |
187 | pData->m_hHandle = hHandle; | |
188 | } | |
4f72fe4f | 189 | |
4f72fe4f DW |
190 | int GetWidth() const { return IsNull() ? 0 : GetGDIImageData()->m_nWidth; } |
191 | int GetHeight() const { return IsNull() ? 0 : GetGDIImageData()->m_nHeight; } | |
192 | int GetDepth() const { return IsNull() ? 0 : GetGDIImageData()->m_nDepth; } | |
193 | ||
194 | void SetWidth(int nW) { EnsureHasData(); GetGDIImageData()->m_nWidth = nW; } | |
195 | void SetHeight(int nH) { EnsureHasData(); GetGDIImageData()->m_nHeight = nH; } | |
196 | void SetDepth(int nD) { EnsureHasData(); GetGDIImageData()->m_nDepth = nD; } | |
197 | ||
198 | void SetSize( int nW | |
199 | ,int nH | |
200 | ) | |
201 | { | |
202 | EnsureHasData(); | |
203 | GetGDIImageData()->SetSize(nW, nH); | |
204 | } | |
205 | void SetSize(const wxSize& rSize) { SetSize(rSize.x, rSize.y); } | |
206 | ||
4b3f61d1 | 207 | unsigned int GetId(void) const |
8bb6da4a DW |
208 | { |
209 | wxGDIImageRefData* pData; | |
210 | ||
211 | pData = GetGDIImageData(); | |
212 | if (!pData) | |
213 | return 0; | |
214 | else | |
215 | return pData->m_uId; | |
216 | } // end of WxWinGdi_CGDIImage::GetId | |
4b3f61d1 | 217 | void SetId(unsigned int uId) |
8bb6da4a DW |
218 | { |
219 | wxGDIImageRefData* pData; | |
220 | ||
221 | EnsureHasData(); | |
222 | pData = GetGDIImageData(); | |
223 | pData->m_uId = uId; | |
224 | } | |
4f72fe4f | 225 | // forward some of base class virtuals to wxGDIImageRefData |
17b1d76b WS |
226 | bool FreeResource(bool bForce = false); |
227 | virtual WXHANDLE GetResourceHandle() const; | |
4f72fe4f DW |
228 | |
229 | protected: | |
230 | // create the data for the derived class here | |
231 | virtual wxGDIImageRefData* CreateData() const = 0; | |
8f884a0d | 232 | virtual wxGDIRefData *CreateGDIRefData() const { return CreateData(); } |
4f72fe4f | 233 | |
4b3f61d1 SN |
234 | // we can't [efficiently] clone objects of this class |
235 | virtual wxGDIRefData * | |
236 | CloneGDIRefData(const wxGDIRefData *WXUNUSED(data)) const | |
237 | { | |
238 | wxFAIL_MSG( _T("must be implemented if used") ); | |
239 | ||
240 | return NULL; | |
241 | } | |
242 | ||
258f5b3e | 243 | static wxGDIImageHandlerList ms_handlers; |
4f72fe4f DW |
244 | }; |
245 | ||
246 | #endif // _WX_MSW_GDIIMAGE_H_ |