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 /* return the DC device rectangle if not empty */
33 static inline BOOL get_dc_device_rect( DC *dc, RECT *rect )
35 *rect = dc->device_rect;
36 offset_rect( rect, -dc->vis_rect.left, -dc->vis_rect.top );
37 return !is_rect_empty( rect );
40 /***********************************************************************
43 * Compute a clip rectangle from its logical coordinates.
45 static inline RECT get_clip_rect( DC * dc, int left, int top, int right, int bottom )
53 LPtoDP( dc->hSelf, (POINT *)&rect, 2 );
54 if (dc->layout & LAYOUT_RTL)
57 rect.left = rect.right + 1;
63 /***********************************************************************
66 * Clip a rectangle to the whole DC surface.
68 BOOL clip_device_rect( DC *dc, RECT *dst, const RECT *src )
72 if (get_dc_device_rect( dc, &clip )) return intersect_rect( dst, src, &clip );
77 /***********************************************************************
80 * Clip a rectangle to the DC visible rect.
82 BOOL clip_visrect( DC *dc, RECT *dst, const RECT *src )
86 if (!clip_device_rect( dc, dst, src )) return FALSE;
87 if (GetRgnBox( get_dc_region(dc), &clip )) return intersect_rect( dst, dst, &clip );
91 /***********************************************************************
94 * Update the DC and device clip regions when the ClipRgn or VisRgn have changed.
96 void update_dc_clipping( DC * dc )
98 PHYSDEV physdev = GET_DC_PHYSDEV( dc, pSetDeviceClipping );
102 if (dc->hVisRgn) regions[count++] = dc->hVisRgn;
103 if (dc->hClipRgn) regions[count++] = dc->hClipRgn;
104 if (dc->hMetaRgn) regions[count++] = dc->hMetaRgn;
108 if (!dc->region) dc->region = CreateRectRgn( 0, 0, 0, 0 );
109 CombineRgn( dc->region, regions[0], regions[1], RGN_AND );
110 if (count > 2) CombineRgn( dc->region, dc->region, regions[2], RGN_AND );
112 else /* only one region, we don't need the total region */
114 if (dc->region) DeleteObject( dc->region );
117 physdev->funcs->pSetDeviceClipping( physdev, get_dc_region( dc ));
120 /***********************************************************************
121 * create_default_clip_region
123 * Create a default clipping region when none already exists.
125 static inline void create_default_clip_region( DC * dc )
129 if (!get_dc_device_rect( dc, &rect ))
133 rect.right = GetDeviceCaps( dc->hSelf, DESKTOPHORZRES );
134 rect.bottom = GetDeviceCaps( dc->hSelf, DESKTOPVERTRES );
136 dc->hClipRgn = CreateRectRgnIndirect( &rect );
140 /***********************************************************************
141 * null driver fallback implementations
144 INT nulldrv_ExtSelectClipRgn( PHYSDEV dev, HRGN rgn, INT mode )
146 DC *dc = get_nulldrv_dc( dev );
151 if (mode != RGN_COPY)
153 FIXME("Unimplemented: hrgn NULL in mode: %d\n", mode);
156 if (dc->hClipRgn) DeleteObject( dc->hClipRgn );
164 if (dc->layout & LAYOUT_RTL)
166 if (!(mirrored = CreateRectRgn( 0, 0, 0, 0 ))) return ERROR;
167 mirror_region( mirrored, rgn, dc->vis_rect.right - dc->vis_rect.left );
172 create_default_clip_region( dc );
174 if (mode == RGN_COPY)
175 ret = CombineRgn( dc->hClipRgn, rgn, 0, mode );
177 ret = CombineRgn( dc->hClipRgn, dc->hClipRgn, rgn, mode);
179 if (mirrored) DeleteObject( mirrored );
181 update_dc_clipping( dc );
185 INT nulldrv_ExcludeClipRect( PHYSDEV dev, INT left, INT top, INT right, INT bottom )
187 DC *dc = get_nulldrv_dc( dev );
188 RECT rect = get_clip_rect( dc, left, top, right, bottom );
192 if (!(rgn = CreateRectRgnIndirect( &rect ))) return ERROR;
193 if (!dc->hClipRgn) create_default_clip_region( dc );
194 ret = CombineRgn( dc->hClipRgn, dc->hClipRgn, rgn, RGN_DIFF );
196 if (ret != ERROR) update_dc_clipping( dc );
200 INT nulldrv_IntersectClipRect( PHYSDEV dev, INT left, INT top, INT right, INT bottom )
202 DC *dc = get_nulldrv_dc( dev );
203 RECT rect = get_clip_rect( dc, left, top, right, bottom );
209 dc->hClipRgn = CreateRectRgnIndirect( &rect );
214 if (!(rgn = CreateRectRgnIndirect( &rect ))) return ERROR;
215 ret = CombineRgn( dc->hClipRgn, dc->hClipRgn, rgn, RGN_AND );
218 if (ret != ERROR) update_dc_clipping( dc );
222 INT nulldrv_OffsetClipRgn( PHYSDEV dev, INT x, INT y )
224 DC *dc = get_nulldrv_dc( dev );
225 INT ret = NULLREGION;
229 x = MulDiv( x, dc->vportExtX, dc->wndExtX );
230 y = MulDiv( y, dc->vportExtY, dc->wndExtY );
231 if (dc->layout & LAYOUT_RTL) x = -x;
232 ret = OffsetRgn( dc->hClipRgn, x, y );
233 update_dc_clipping( dc );
239 /***********************************************************************
240 * SelectClipRgn (GDI32.@)
242 INT WINAPI SelectClipRgn( HDC hdc, HRGN hrgn )
244 return ExtSelectClipRgn( hdc, hrgn, RGN_COPY );
248 /******************************************************************************
249 * ExtSelectClipRgn [GDI32.@]
251 INT WINAPI ExtSelectClipRgn( HDC hdc, HRGN hrgn, INT fnMode )
254 DC * dc = get_dc_ptr( hdc );
256 TRACE("%p %p %d\n", hdc, hrgn, fnMode );
260 PHYSDEV physdev = GET_DC_PHYSDEV( dc, pExtSelectClipRgn );
262 retval = physdev->funcs->pExtSelectClipRgn( physdev, hrgn, fnMode );
263 release_dc_ptr( dc );
268 /***********************************************************************
269 * __wine_set_visible_region (GDI32.@)
271 void CDECL __wine_set_visible_region( HDC hdc, HRGN hrgn, const RECT *vis_rect, const RECT *device_rect,
272 struct window_surface *surface )
276 if (!(dc = get_dc_ptr( hdc ))) return;
278 TRACE( "%p %p %s %s %p\n", hdc, hrgn,
279 wine_dbgstr_rect(vis_rect), wine_dbgstr_rect(device_rect), surface );
281 /* map region to DC coordinates */
282 OffsetRgn( hrgn, -vis_rect->left, -vis_rect->top );
284 if (dc->hVisRgn) DeleteObject( dc->hVisRgn );
286 dc->vis_rect = *vis_rect;
287 dc->device_rect = *device_rect;
289 dibdrv_set_window_surface( dc, surface );
290 DC_UpdateXforms( dc );
291 update_dc_clipping( dc );
292 release_dc_ptr( dc );
296 /***********************************************************************
297 * OffsetClipRgn (GDI32.@)
299 INT WINAPI OffsetClipRgn( HDC hdc, INT x, INT y )
302 DC *dc = get_dc_ptr( hdc );
304 TRACE("%p %d,%d\n", hdc, x, y );
308 PHYSDEV physdev = GET_DC_PHYSDEV( dc, pOffsetClipRgn );
310 ret = physdev->funcs->pOffsetClipRgn( physdev, x, y );
311 release_dc_ptr( dc );
317 /***********************************************************************
318 * ExcludeClipRect (GDI32.@)
320 INT WINAPI ExcludeClipRect( HDC hdc, INT left, INT top,
321 INT right, INT bottom )
324 DC *dc = get_dc_ptr( hdc );
326 TRACE("%p %d,%d-%d,%d\n", hdc, left, top, right, bottom );
330 PHYSDEV physdev = GET_DC_PHYSDEV( dc, pExcludeClipRect );
332 ret = physdev->funcs->pExcludeClipRect( physdev, left, top, right, bottom );
333 release_dc_ptr( dc );
339 /***********************************************************************
340 * IntersectClipRect (GDI32.@)
342 INT WINAPI IntersectClipRect( HDC hdc, INT left, INT top, INT right, INT bottom )
345 DC *dc = get_dc_ptr( hdc );
347 TRACE("%p %d,%d - %d,%d\n", hdc, left, top, right, bottom );
351 PHYSDEV physdev = GET_DC_PHYSDEV( dc, pIntersectClipRect );
353 ret = physdev->funcs->pIntersectClipRect( physdev, left, top, right, bottom );
354 release_dc_ptr( dc );
360 /***********************************************************************
361 * PtVisible (GDI32.@)
363 BOOL WINAPI PtVisible( HDC hdc, INT x, INT y )
368 DC *dc = get_dc_ptr( hdc );
370 TRACE("%p %d,%d\n", hdc, x, y );
371 if (!dc) return FALSE;
375 LPtoDP( hdc, &pt, 1 );
377 ret = (!get_dc_device_rect( dc, &visrect ) ||
378 (pt.x >= visrect.left && pt.x < visrect.right &&
379 pt.y >= visrect.top && pt.y < visrect.bottom));
380 if (ret && get_dc_region( dc )) ret = PtInRegion( get_dc_region( dc ), pt.x, pt.y );
381 release_dc_ptr( dc );
386 /***********************************************************************
387 * RectVisible (GDI32.@)
389 BOOL WINAPI RectVisible( HDC hdc, const RECT* rect )
391 RECT tmpRect, visrect;
393 DC *dc = get_dc_ptr( hdc );
394 if (!dc) return FALSE;
395 TRACE("%p %s\n", hdc, wine_dbgstr_rect( rect ));
398 LPtoDP( hdc, (POINT *)&tmpRect, 2 );
401 ret = (!get_dc_device_rect( dc, &visrect ) || intersect_rect( &visrect, &visrect, &tmpRect ));
402 if (ret && get_dc_region( dc )) ret = RectInRegion( get_dc_region( dc ), &tmpRect );
403 release_dc_ptr( dc );
408 /***********************************************************************
409 * GetClipBox (GDI32.@)
411 INT WINAPI GetClipBox( HDC hdc, LPRECT rect )
415 DC *dc = get_dc_ptr( hdc );
416 if (!dc) return ERROR;
419 if (get_dc_region( dc ))
421 ret = GetRgnBox( get_dc_region( dc ), rect );
425 ret = is_rect_empty( &dc->vis_rect ) ? ERROR : SIMPLEREGION;
426 *rect = dc->vis_rect;
429 if (get_dc_device_rect( dc, &visrect ) && !intersect_rect( rect, rect, &visrect )) ret = NULLREGION;
431 if (dc->layout & LAYOUT_RTL)
433 int tmp = rect->left;
434 rect->left = rect->right - 1;
435 rect->right = tmp - 1;
437 DPtoLP( hdc, (LPPOINT)rect, 2 );
438 release_dc_ptr( dc );
439 TRACE("%p => %d %s\n", hdc, ret, wine_dbgstr_rect( rect ));
444 /***********************************************************************
445 * GetClipRgn (GDI32.@)
447 INT WINAPI GetClipRgn( HDC hdc, HRGN hRgn )
451 if ((dc = get_dc_ptr( hdc )))
455 if( CombineRgn(hRgn, dc->hClipRgn, 0, RGN_COPY) != ERROR )
458 if (dc->layout & LAYOUT_RTL)
459 mirror_region( hRgn, hRgn, dc->vis_rect.right - dc->vis_rect.left );
463 release_dc_ptr( dc );
469 /***********************************************************************
470 * GetMetaRgn (GDI32.@)
472 INT WINAPI GetMetaRgn( HDC hdc, HRGN hRgn )
475 DC * dc = get_dc_ptr( hdc );
479 if (dc->hMetaRgn && CombineRgn( hRgn, dc->hMetaRgn, 0, RGN_COPY ) != ERROR)
482 if (dc->layout & LAYOUT_RTL)
483 mirror_region( hRgn, hRgn, dc->vis_rect.right - dc->vis_rect.left );
485 release_dc_ptr( dc );
491 /***********************************************************************
492 * GetRandomRgn [GDI32.@]
495 * This function is documented in MSDN online for the case of
496 * iCode == SYSRGN (4).
498 * For iCode == 1 it should return the clip region
499 * 2 " " " the meta region
500 * 3 " " " the intersection of the clip with
501 * the meta region (== 'Rao' region).
503 * See http://www.codeproject.com/gdi/cliprgnguide.asp
505 INT WINAPI GetRandomRgn(HDC hDC, HRGN hRgn, INT iCode)
508 DC *dc = get_dc_ptr( hDC );
515 if (dc->hClipRgn) CombineRgn( hRgn, dc->hClipRgn, 0, RGN_COPY );
519 if (dc->hMetaRgn) CombineRgn( hRgn, dc->hMetaRgn, 0, RGN_COPY );
523 if (dc->hClipRgn && dc->hMetaRgn) CombineRgn( hRgn, dc->hClipRgn, dc->hMetaRgn, RGN_AND );
524 else if (dc->hClipRgn) CombineRgn( hRgn, dc->hClipRgn, 0, RGN_COPY );
525 else if (dc->hMetaRgn) CombineRgn( hRgn, dc->hMetaRgn, 0, RGN_COPY );
528 case SYSRGN: /* == 4 */
532 CombineRgn( hRgn, dc->hVisRgn, 0, RGN_COPY );
533 /* On Windows NT/2000, the SYSRGN returned is in screen coordinates */
534 if (!(GetVersion() & 0x80000000)) OffsetRgn( hRgn, dc->vis_rect.left, dc->vis_rect.top );
536 else if (!is_rect_empty( &dc->device_rect ))
537 SetRectRgn( hRgn, dc->device_rect.left, dc->device_rect.top,
538 dc->device_rect.right, dc->device_rect.bottom );
543 WARN("Unknown code %d\n", iCode);
547 release_dc_ptr( dc );
552 /***********************************************************************
553 * SetMetaRgn (GDI32.@)
555 INT WINAPI SetMetaRgn( HDC hdc )
559 DC *dc = get_dc_ptr( hdc );
561 if (!dc) return ERROR;
567 /* the intersection becomes the new meta region */
568 CombineRgn( dc->hMetaRgn, dc->hMetaRgn, dc->hClipRgn, RGN_AND );
569 DeleteObject( dc->hClipRgn );
574 dc->hMetaRgn = dc->hClipRgn;
578 /* else nothing to do */
580 /* Note: no need to call update_dc_clipping, the overall clip region hasn't changed */
582 ret = GetRgnBox( dc->hMetaRgn, &dummy );
583 release_dc_ptr( dc );