2 * DC clipping functions
4 * Copyright 1993 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
26 #include "gdi_private.h"
27 #include "wine/debug.h"
29 WINE_DEFAULT_DEBUG_CHANNEL(clipping);
32 /***********************************************************************
35 * Return the total clip region (if any).
37 static inline HRGN get_clip_region( DC * dc )
39 if (dc->hMetaClipRgn) return dc->hMetaClipRgn;
40 if (dc->hMetaRgn) return dc->hMetaRgn;
45 /***********************************************************************
48 * Compute a clip rectangle from its logical coordinates.
50 static inline RECT get_clip_rect( DC * dc, int left, int top, int right, int bottom )
58 LPtoDP( dc->hSelf, (POINT *)&rect, 2 );
59 if (dc->layout & LAYOUT_RTL)
62 rect.left = rect.right + 1;
68 /***********************************************************************
69 * CLIPPING_UpdateGCRegion
71 * Update the GC clip region when the ClipRgn or VisRgn have changed.
73 void CLIPPING_UpdateGCRegion( DC * dc )
77 /* update the intersection of meta and clip regions */
78 if (dc->hMetaRgn && dc->hClipRgn)
80 if (!dc->hMetaClipRgn) dc->hMetaClipRgn = CreateRectRgn( 0, 0, 0, 0 );
81 CombineRgn( dc->hMetaClipRgn, dc->hClipRgn, dc->hMetaRgn, RGN_AND );
82 clip_rgn = dc->hMetaClipRgn;
84 else /* only one is set, no need for an intersection */
86 if (dc->hMetaClipRgn) DeleteObject( dc->hMetaClipRgn );
88 clip_rgn = dc->hMetaRgn ? dc->hMetaRgn : dc->hClipRgn;
91 if (dc->funcs->pSetDeviceClipping)
92 dc->funcs->pSetDeviceClipping( dc->physDev, dc->hVisRgn, clip_rgn );
95 /***********************************************************************
96 * create_default_clip_region
98 * Create a default clipping region when none already exists.
100 static inline void create_default_clip_region( DC * dc )
104 if (dc->header.type == OBJ_MEMDC)
108 GetObjectW( dc->hBitmap, sizeof(bitmap), &bitmap );
109 width = bitmap.bmWidth;
110 height = bitmap.bmHeight;
114 width = GetDeviceCaps( dc->hSelf, DESKTOPHORZRES );
115 height = GetDeviceCaps( dc->hSelf, DESKTOPVERTRES );
117 dc->hClipRgn = CreateRectRgn( 0, 0, width, height );
121 /***********************************************************************
122 * SelectClipRgn (GDI32.@)
124 INT WINAPI SelectClipRgn( HDC hdc, HRGN hrgn )
126 return ExtSelectClipRgn( hdc, hrgn, RGN_COPY );
130 /******************************************************************************
131 * ExtSelectClipRgn [GDI32.@]
133 INT WINAPI ExtSelectClipRgn( HDC hdc, HRGN hrgn, INT fnMode )
137 DC * dc = get_dc_ptr( hdc );
138 if (!dc) return ERROR;
140 TRACE("%p %p %d\n", hdc, hrgn, fnMode );
143 if (dc->funcs->pExtSelectClipRgn)
145 retval = dc->funcs->pExtSelectClipRgn( dc->physDev, hrgn, fnMode );
146 release_dc_ptr( dc );
152 if (fnMode == RGN_COPY)
154 if (dc->hClipRgn) DeleteObject( dc->hClipRgn );
159 FIXME("Unimplemented: hrgn NULL in mode: %d\n", fnMode);
160 release_dc_ptr( dc );
168 if (dc->layout & LAYOUT_RTL)
170 if (!(mirrored = CreateRectRgn( 0, 0, 0, 0 )))
172 release_dc_ptr( dc );
175 mirror_region( mirrored, hrgn, dc->vis_rect.right - dc->vis_rect.left );
180 create_default_clip_region( dc );
182 if(fnMode == RGN_COPY)
183 CombineRgn( dc->hClipRgn, hrgn, 0, fnMode );
185 CombineRgn( dc->hClipRgn, dc->hClipRgn, hrgn, fnMode);
187 if (mirrored) DeleteObject( mirrored );
190 CLIPPING_UpdateGCRegion( dc );
191 release_dc_ptr( dc );
193 return GetClipBox(hdc, &rect);
196 /***********************************************************************
197 * __wine_set_visible_region (GDI32.@)
199 void CDECL __wine_set_visible_region( HDC hdc, HRGN hrgn, const RECT *vis_rect )
203 if (!(dc = get_dc_ptr( hdc ))) return;
205 TRACE( "%p %p %s\n", hdc, hrgn, wine_dbgstr_rect(vis_rect) );
207 /* map region to DC coordinates */
208 OffsetRgn( hrgn, -vis_rect->left, -vis_rect->top );
210 DeleteObject( dc->hVisRgn );
212 dc->vis_rect = *vis_rect;
214 DC_UpdateXforms( dc );
215 CLIPPING_UpdateGCRegion( dc );
216 release_dc_ptr( dc );
220 /***********************************************************************
221 * OffsetClipRgn (GDI32.@)
223 INT WINAPI OffsetClipRgn( HDC hdc, INT x, INT y )
225 INT ret = SIMPLEREGION;
226 DC *dc = get_dc_ptr( hdc );
227 if (!dc) return ERROR;
229 TRACE("%p %d,%d\n", hdc, x, y );
232 if(dc->funcs->pOffsetClipRgn)
234 ret = dc->funcs->pOffsetClipRgn( dc->physDev, x, y );
235 /* FIXME: ret is just a success flag, we should return a proper value */
237 else if (dc->hClipRgn) {
238 x = MulDiv( x, dc->vportExtX, dc->wndExtX );
239 y = MulDiv( y, dc->vportExtY, dc->wndExtY );
240 if (dc->layout & LAYOUT_RTL) x = -x;
241 ret = OffsetRgn( dc->hClipRgn, x, y );
242 CLIPPING_UpdateGCRegion( dc );
244 release_dc_ptr( dc );
249 /***********************************************************************
250 * ExcludeClipRect (GDI32.@)
252 INT WINAPI ExcludeClipRect( HDC hdc, INT left, INT top,
253 INT right, INT bottom )
257 DC *dc = get_dc_ptr( hdc );
258 if (!dc) return ERROR;
260 TRACE("%p %dx%d,%dx%d\n", hdc, left, top, right, bottom );
263 if(dc->funcs->pExcludeClipRect)
265 ret = dc->funcs->pExcludeClipRect( dc->physDev, left, top, right, bottom );
266 /* FIXME: ret is just a success flag, we should return a proper value */
270 RECT rect = get_clip_rect( dc, left, top, right, bottom );
272 if (!(newRgn = CreateRectRgnIndirect( &rect ))) ret = ERROR;
276 create_default_clip_region( dc );
277 ret = CombineRgn( dc->hClipRgn, dc->hClipRgn, newRgn, RGN_DIFF );
278 DeleteObject( newRgn );
280 if (ret != ERROR) CLIPPING_UpdateGCRegion( dc );
282 release_dc_ptr( dc );
287 /***********************************************************************
288 * IntersectClipRect (GDI32.@)
290 INT WINAPI IntersectClipRect( HDC hdc, INT left, INT top, INT right, INT bottom )
293 DC *dc = get_dc_ptr( hdc );
294 if (!dc) return ERROR;
296 TRACE("%p %d,%d - %d,%d\n", hdc, left, top, right, bottom );
299 if(dc->funcs->pIntersectClipRect)
301 ret = dc->funcs->pIntersectClipRect( dc->physDev, left, top, right, bottom );
302 /* FIXME: ret is just a success flag, we should return a proper value */
306 RECT rect = get_clip_rect( dc, left, top, right, bottom );
310 dc->hClipRgn = CreateRectRgnIndirect( &rect );
317 if (!(newRgn = CreateRectRgnIndirect( &rect ))) ret = ERROR;
320 ret = CombineRgn( dc->hClipRgn, dc->hClipRgn, newRgn, RGN_AND );
321 DeleteObject( newRgn );
324 if (ret != ERROR) CLIPPING_UpdateGCRegion( dc );
326 release_dc_ptr( dc );
331 /***********************************************************************
332 * PtVisible (GDI32.@)
334 BOOL WINAPI PtVisible( HDC hdc, INT x, INT y )
339 DC *dc = get_dc_ptr( hdc );
341 TRACE("%p %d,%d\n", hdc, x, y );
342 if (!dc) return FALSE;
346 LPtoDP( hdc, &pt, 1 );
348 ret = PtInRegion( dc->hVisRgn, pt.x, pt.y );
349 if (ret && (clip = get_clip_region(dc))) ret = PtInRegion( clip, pt.x, pt.y );
350 release_dc_ptr( dc );
355 /***********************************************************************
356 * RectVisible (GDI32.@)
358 BOOL WINAPI RectVisible( HDC hdc, const RECT* rect )
363 DC *dc = get_dc_ptr( hdc );
364 if (!dc) return FALSE;
365 TRACE("%p %d,%dx%d,%d\n", hdc, rect->left, rect->top, rect->right, rect->bottom );
368 LPtoDP( hdc, (POINT *)&tmpRect, 2 );
371 if ((clip = get_clip_region(dc)))
373 HRGN hrgn = CreateRectRgn( 0, 0, 0, 0 );
374 CombineRgn( hrgn, dc->hVisRgn, clip, RGN_AND );
375 ret = RectInRegion( hrgn, &tmpRect );
376 DeleteObject( hrgn );
378 else ret = RectInRegion( dc->hVisRgn, &tmpRect );
379 release_dc_ptr( dc );
384 /***********************************************************************
385 * GetClipBox (GDI32.@)
387 INT WINAPI GetClipBox( HDC hdc, LPRECT rect )
391 DC *dc = get_dc_ptr( hdc );
392 if (!dc) return ERROR;
395 if ((clip = get_clip_region(dc)))
397 HRGN hrgn = CreateRectRgn( 0, 0, 0, 0 );
398 CombineRgn( hrgn, dc->hVisRgn, clip, RGN_AND );
399 ret = GetRgnBox( hrgn, rect );
400 DeleteObject( hrgn );
402 else ret = GetRgnBox( dc->hVisRgn, rect );
403 if (dc->layout & LAYOUT_RTL)
405 int tmp = rect->left;
406 rect->left = rect->right - 1;
407 rect->right = tmp - 1;
409 DPtoLP( hdc, (LPPOINT)rect, 2 );
410 release_dc_ptr( dc );
411 TRACE("%p => %d %s\n", hdc, ret, wine_dbgstr_rect( rect ));
416 /***********************************************************************
417 * GetClipRgn (GDI32.@)
419 INT WINAPI GetClipRgn( HDC hdc, HRGN hRgn )
423 if ((dc = get_dc_ptr( hdc )))
427 if( CombineRgn(hRgn, dc->hClipRgn, 0, RGN_COPY) != ERROR )
430 if (dc->layout & LAYOUT_RTL)
431 mirror_region( hRgn, hRgn, dc->vis_rect.right - dc->vis_rect.left );
435 release_dc_ptr( dc );
441 /***********************************************************************
442 * GetMetaRgn (GDI32.@)
444 INT WINAPI GetMetaRgn( HDC hdc, HRGN hRgn )
447 DC * dc = get_dc_ptr( hdc );
451 if (dc->hMetaRgn && CombineRgn( hRgn, dc->hMetaRgn, 0, RGN_COPY ) != ERROR)
454 if (dc->layout & LAYOUT_RTL)
455 mirror_region( hRgn, hRgn, dc->vis_rect.right - dc->vis_rect.left );
457 release_dc_ptr( dc );
463 /***********************************************************************
464 * GetRandomRgn [GDI32.@]
467 * This function is documented in MSDN online for the case of
468 * iCode == SYSRGN (4).
470 * For iCode == 1 it should return the clip region
471 * 2 " " " the meta region
472 * 3 " " " the intersection of the clip with
473 * the meta region (== 'Rao' region).
475 * See http://www.codeproject.com/gdi/cliprgnguide.asp
477 INT WINAPI GetRandomRgn(HDC hDC, HRGN hRgn, INT iCode)
480 DC *dc = get_dc_ptr( hDC );
493 rgn = dc->hMetaClipRgn;
494 if(!rgn) rgn = dc->hClipRgn;
495 if(!rgn) rgn = dc->hMetaRgn;
497 case SYSRGN: /* == 4 */
502 WARN("Unknown code %d\n", iCode);
503 release_dc_ptr( dc );
506 if (rgn) CombineRgn( hRgn, rgn, 0, RGN_COPY );
507 release_dc_ptr( dc );
509 /* On Windows NT/2000, the SYSRGN returned is in screen coordinates */
510 if (iCode == SYSRGN && !(GetVersion() & 0x80000000))
511 OffsetRgn( hRgn, dc->vis_rect.left, dc->vis_rect.top );
517 /***********************************************************************
518 * SetMetaRgn (GDI32.@)
520 INT WINAPI SetMetaRgn( HDC hdc )
524 DC *dc = get_dc_ptr( hdc );
526 if (!dc) return ERROR;
528 if (dc->hMetaClipRgn)
530 /* the intersection becomes the new meta region */
531 DeleteObject( dc->hMetaRgn );
532 DeleteObject( dc->hClipRgn );
533 dc->hMetaRgn = dc->hMetaClipRgn;
535 dc->hMetaClipRgn = 0;
537 else if (dc->hClipRgn)
539 dc->hMetaRgn = dc->hClipRgn;
542 /* else nothing to do */
544 /* Note: no need to call CLIPPING_UpdateGCRegion, the overall clip region hasn't changed */
546 ret = GetRgnBox( dc->hMetaRgn, &dummy );
547 release_dc_ptr( dc );