13512f976SVille Syrjälä /* 23512f976SVille Syrjälä * Copyright (C) 2011-2013 Intel Corporation 33512f976SVille Syrjälä * 43512f976SVille Syrjälä * Permission is hereby granted, free of charge, to any person obtaining a 53512f976SVille Syrjälä * copy of this software and associated documentation files (the "Software"), 63512f976SVille Syrjälä * to deal in the Software without restriction, including without limitation 73512f976SVille Syrjälä * the rights to use, copy, modify, merge, publish, distribute, sublicense, 83512f976SVille Syrjälä * and/or sell copies of the Software, and to permit persons to whom the 93512f976SVille Syrjälä * Software is furnished to do so, subject to the following conditions: 103512f976SVille Syrjälä * 113512f976SVille Syrjälä * The above copyright notice and this permission notice (including the next 123512f976SVille Syrjälä * paragraph) shall be included in all copies or substantial portions of the 133512f976SVille Syrjälä * Software. 143512f976SVille Syrjälä * 153512f976SVille Syrjälä * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 163512f976SVille Syrjälä * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 173512f976SVille Syrjälä * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 183512f976SVille Syrjälä * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 193512f976SVille Syrjälä * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 203512f976SVille Syrjälä * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 213512f976SVille Syrjälä * SOFTWARE. 223512f976SVille Syrjälä */ 233512f976SVille Syrjälä 243512f976SVille Syrjälä #ifndef DRM_RECT_H 253512f976SVille Syrjälä #define DRM_RECT_H 263512f976SVille Syrjälä 273512f976SVille Syrjälä /** 2803973536SVille Syrjälä * DOC: rect utils 2903973536SVille Syrjälä * 3003973536SVille Syrjälä * Utility functions to help manage rectangular areas for 3103973536SVille Syrjälä * clipping, scaling, etc. calculations. 3203973536SVille Syrjälä */ 3303973536SVille Syrjälä 3403973536SVille Syrjälä /** 3503973536SVille Syrjälä * struct drm_rect - two dimensional rectangle 363512f976SVille Syrjälä * @x1: horizontal starting coordinate (inclusive) 373512f976SVille Syrjälä * @x2: horizontal ending coordinate (exclusive) 383512f976SVille Syrjälä * @y1: vertical starting coordinate (inclusive) 393512f976SVille Syrjälä * @y2: vertical ending coordinate (exclusive) 403512f976SVille Syrjälä */ 413512f976SVille Syrjälä struct drm_rect { 423512f976SVille Syrjälä int x1, y1, x2, y2; 433512f976SVille Syrjälä }; 443512f976SVille Syrjälä 453512f976SVille Syrjälä /** 4699cdb35eSDaniel Vetter * DRM_RECT_FMT - printf string for &struct drm_rect 4799cdb35eSDaniel Vetter */ 4899cdb35eSDaniel Vetter #define DRM_RECT_FMT "%dx%d%+d%+d" 4999cdb35eSDaniel Vetter /** 5099cdb35eSDaniel Vetter * DRM_RECT_ARG - printf arguments for &struct drm_rect 5199cdb35eSDaniel Vetter * @r: rectangle struct 5299cdb35eSDaniel Vetter */ 5399cdb35eSDaniel Vetter #define DRM_RECT_ARG(r) drm_rect_width(r), drm_rect_height(r), (r)->x1, (r)->y1 5499cdb35eSDaniel Vetter 5599cdb35eSDaniel Vetter /** 5699cdb35eSDaniel Vetter * DRM_RECT_FP_FMT - printf string for &struct drm_rect in 16.16 fixed point 5799cdb35eSDaniel Vetter */ 5899cdb35eSDaniel Vetter #define DRM_RECT_FP_FMT "%d.%06ux%d.%06u%+d.%06u%+d.%06u" 5999cdb35eSDaniel Vetter /** 6099cdb35eSDaniel Vetter * DRM_RECT_FP_ARG - printf arguments for &struct drm_rect in 16.16 fixed point 6199cdb35eSDaniel Vetter * @r: rectangle struct 6299cdb35eSDaniel Vetter * 6399cdb35eSDaniel Vetter * This is useful for e.g. printing plane source rectangles, which are in 16.16 6499cdb35eSDaniel Vetter * fixed point. 6599cdb35eSDaniel Vetter */ 6699cdb35eSDaniel Vetter #define DRM_RECT_FP_ARG(r) \ 6799cdb35eSDaniel Vetter drm_rect_width(r) >> 16, ((drm_rect_width(r) & 0xffff) * 15625) >> 10, \ 6899cdb35eSDaniel Vetter drm_rect_height(r) >> 16, ((drm_rect_height(r) & 0xffff) * 15625) >> 10, \ 6999cdb35eSDaniel Vetter (r)->x1 >> 16, (((r)->x1 & 0xffff) * 15625) >> 10, \ 7099cdb35eSDaniel Vetter (r)->y1 >> 16, (((r)->y1 & 0xffff) * 15625) >> 10 7199cdb35eSDaniel Vetter 7299cdb35eSDaniel Vetter /** 733512f976SVille Syrjälä * drm_rect_adjust_size - adjust the size of the rectangle 743512f976SVille Syrjälä * @r: rectangle to be adjusted 753512f976SVille Syrjälä * @dw: horizontal adjustment 763512f976SVille Syrjälä * @dh: vertical adjustment 773512f976SVille Syrjälä * 783512f976SVille Syrjälä * Change the size of rectangle @r by @dw in the horizontal direction, 793512f976SVille Syrjälä * and by @dh in the vertical direction, while keeping the center 803512f976SVille Syrjälä * of @r stationary. 813512f976SVille Syrjälä * 823512f976SVille Syrjälä * Positive @dw and @dh increase the size, negative values decrease it. 833512f976SVille Syrjälä */ 843512f976SVille Syrjälä static inline void drm_rect_adjust_size(struct drm_rect *r, int dw, int dh) 853512f976SVille Syrjälä { 863512f976SVille Syrjälä r->x1 -= dw >> 1; 873512f976SVille Syrjälä r->y1 -= dh >> 1; 883512f976SVille Syrjälä r->x2 += (dw + 1) >> 1; 893512f976SVille Syrjälä r->y2 += (dh + 1) >> 1; 903512f976SVille Syrjälä } 913512f976SVille Syrjälä 923512f976SVille Syrjälä /** 933512f976SVille Syrjälä * drm_rect_translate - translate the rectangle 943512f976SVille Syrjälä * @r: rectangle to be tranlated 953512f976SVille Syrjälä * @dx: horizontal translation 963512f976SVille Syrjälä * @dy: vertical translation 973512f976SVille Syrjälä * 983512f976SVille Syrjälä * Move rectangle @r by @dx in the horizontal direction, 993512f976SVille Syrjälä * and by @dy in the vertical direction. 1003512f976SVille Syrjälä */ 1013512f976SVille Syrjälä static inline void drm_rect_translate(struct drm_rect *r, int dx, int dy) 1023512f976SVille Syrjälä { 1033512f976SVille Syrjälä r->x1 += dx; 1043512f976SVille Syrjälä r->y1 += dy; 1053512f976SVille Syrjälä r->x2 += dx; 1063512f976SVille Syrjälä r->y2 += dy; 1073512f976SVille Syrjälä } 1083512f976SVille Syrjälä 1093512f976SVille Syrjälä /** 1103512f976SVille Syrjälä * drm_rect_downscale - downscale a rectangle 1113512f976SVille Syrjälä * @r: rectangle to be downscaled 1123512f976SVille Syrjälä * @horz: horizontal downscale factor 1133512f976SVille Syrjälä * @vert: vertical downscale factor 1143512f976SVille Syrjälä * 1153512f976SVille Syrjälä * Divide the coordinates of rectangle @r by @horz and @vert. 1163512f976SVille Syrjälä */ 1173512f976SVille Syrjälä static inline void drm_rect_downscale(struct drm_rect *r, int horz, int vert) 1183512f976SVille Syrjälä { 1193512f976SVille Syrjälä r->x1 /= horz; 1203512f976SVille Syrjälä r->y1 /= vert; 1213512f976SVille Syrjälä r->x2 /= horz; 1223512f976SVille Syrjälä r->y2 /= vert; 1233512f976SVille Syrjälä } 1243512f976SVille Syrjälä 1253512f976SVille Syrjälä /** 1263512f976SVille Syrjälä * drm_rect_width - determine the rectangle width 1273512f976SVille Syrjälä * @r: rectangle whose width is returned 1283512f976SVille Syrjälä * 1293512f976SVille Syrjälä * RETURNS: 1303512f976SVille Syrjälä * The width of the rectangle. 1313512f976SVille Syrjälä */ 1323512f976SVille Syrjälä static inline int drm_rect_width(const struct drm_rect *r) 1333512f976SVille Syrjälä { 1343512f976SVille Syrjälä return r->x2 - r->x1; 1353512f976SVille Syrjälä } 1363512f976SVille Syrjälä 1373512f976SVille Syrjälä /** 1383512f976SVille Syrjälä * drm_rect_height - determine the rectangle height 1393512f976SVille Syrjälä * @r: rectangle whose height is returned 1403512f976SVille Syrjälä * 1413512f976SVille Syrjälä * RETURNS: 1423512f976SVille Syrjälä * The height of the rectangle. 1433512f976SVille Syrjälä */ 1443512f976SVille Syrjälä static inline int drm_rect_height(const struct drm_rect *r) 1453512f976SVille Syrjälä { 1463512f976SVille Syrjälä return r->y2 - r->y1; 1473512f976SVille Syrjälä } 1483512f976SVille Syrjälä 1493512f976SVille Syrjälä /** 1503512f976SVille Syrjälä * drm_rect_visible - determine if the the rectangle is visible 1513512f976SVille Syrjälä * @r: rectangle whose visibility is returned 1523512f976SVille Syrjälä * 1533512f976SVille Syrjälä * RETURNS: 1543512f976SVille Syrjälä * %true if the rectangle is visible, %false otherwise. 1553512f976SVille Syrjälä */ 1563512f976SVille Syrjälä static inline bool drm_rect_visible(const struct drm_rect *r) 1573512f976SVille Syrjälä { 1583512f976SVille Syrjälä return drm_rect_width(r) > 0 && drm_rect_height(r) > 0; 1593512f976SVille Syrjälä } 1603512f976SVille Syrjälä 1610894c96bSVille Syrjälä /** 1620894c96bSVille Syrjälä * drm_rect_equals - determine if two rectangles are equal 1630894c96bSVille Syrjälä * @r1: first rectangle 1640894c96bSVille Syrjälä * @r2: second rectangle 1650894c96bSVille Syrjälä * 1660894c96bSVille Syrjälä * RETURNS: 1670894c96bSVille Syrjälä * %true if the rectangles are equal, %false otherwise. 1680894c96bSVille Syrjälä */ 1690894c96bSVille Syrjälä static inline bool drm_rect_equals(const struct drm_rect *r1, 1700894c96bSVille Syrjälä const struct drm_rect *r2) 1710894c96bSVille Syrjälä { 1720894c96bSVille Syrjälä return r1->x1 == r2->x1 && r1->x2 == r2->x2 && 1730894c96bSVille Syrjälä r1->y1 == r2->y1 && r1->y2 == r2->y2; 1740894c96bSVille Syrjälä } 1750894c96bSVille Syrjälä 1763512f976SVille Syrjälä bool drm_rect_intersect(struct drm_rect *r, const struct drm_rect *clip); 1773512f976SVille Syrjälä bool drm_rect_clip_scaled(struct drm_rect *src, struct drm_rect *dst, 1783512f976SVille Syrjälä const struct drm_rect *clip, 1793512f976SVille Syrjälä int hscale, int vscale); 1804954c428SVille Syrjälä int drm_rect_calc_hscale(const struct drm_rect *src, 1814954c428SVille Syrjälä const struct drm_rect *dst, 1824954c428SVille Syrjälä int min_hscale, int max_hscale); 1834954c428SVille Syrjälä int drm_rect_calc_vscale(const struct drm_rect *src, 1844954c428SVille Syrjälä const struct drm_rect *dst, 1854954c428SVille Syrjälä int min_vscale, int max_vscale); 1864954c428SVille Syrjälä int drm_rect_calc_hscale_relaxed(struct drm_rect *src, 1874954c428SVille Syrjälä struct drm_rect *dst, 1884954c428SVille Syrjälä int min_hscale, int max_hscale); 1894954c428SVille Syrjälä int drm_rect_calc_vscale_relaxed(struct drm_rect *src, 1904954c428SVille Syrjälä struct drm_rect *dst, 1914954c428SVille Syrjälä int min_vscale, int max_vscale); 192c70f577aSVille Syrjälä void drm_rect_debug_print(const char *prefix, 193c70f577aSVille Syrjälä const struct drm_rect *r, bool fixed_point); 19407074006SVille Syrjälä void drm_rect_rotate(struct drm_rect *r, 19507074006SVille Syrjälä int width, int height, 19607074006SVille Syrjälä unsigned int rotation); 19707074006SVille Syrjälä void drm_rect_rotate_inv(struct drm_rect *r, 19807074006SVille Syrjälä int width, int height, 19907074006SVille Syrjälä unsigned int rotation); 2003512f976SVille Syrjälä 2013512f976SVille Syrjälä #endif 202