1 /* 2 * Copyright (C) 2011-2013 Intel Corporation 3 * 4 * Permission is hereby granted, free of charge, to any person obtaining a 5 * copy of this software and associated documentation files (the "Software"), 6 * to deal in the Software without restriction, including without limitation 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 8 * and/or sell copies of the Software, and to permit persons to whom the 9 * Software is furnished to do so, subject to the following conditions: 10 * 11 * The above copyright notice and this permission notice (including the next 12 * paragraph) shall be included in all copies or substantial portions of the 13 * Software. 14 * 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 * SOFTWARE. 22 */ 23 24 #ifndef DRM_RECT_H 25 #define DRM_RECT_H 26 27 #include <linux/types.h> 28 29 /** 30 * DOC: rect utils 31 * 32 * Utility functions to help manage rectangular areas for 33 * clipping, scaling, etc. calculations. 34 */ 35 36 /** 37 * struct drm_rect - two dimensional rectangle 38 * @x1: horizontal starting coordinate (inclusive) 39 * @x2: horizontal ending coordinate (exclusive) 40 * @y1: vertical starting coordinate (inclusive) 41 * @y2: vertical ending coordinate (exclusive) 42 */ 43 struct drm_rect { 44 int x1, y1, x2, y2; 45 }; 46 47 /** 48 * DRM_RECT_FMT - printf string for &struct drm_rect 49 */ 50 #define DRM_RECT_FMT "%dx%d%+d%+d" 51 /** 52 * DRM_RECT_ARG - printf arguments for &struct drm_rect 53 * @r: rectangle struct 54 */ 55 #define DRM_RECT_ARG(r) drm_rect_width(r), drm_rect_height(r), (r)->x1, (r)->y1 56 57 /** 58 * DRM_RECT_FP_FMT - printf string for &struct drm_rect in 16.16 fixed point 59 */ 60 #define DRM_RECT_FP_FMT "%d.%06ux%d.%06u%+d.%06u%+d.%06u" 61 /** 62 * DRM_RECT_FP_ARG - printf arguments for &struct drm_rect in 16.16 fixed point 63 * @r: rectangle struct 64 * 65 * This is useful for e.g. printing plane source rectangles, which are in 16.16 66 * fixed point. 67 */ 68 #define DRM_RECT_FP_ARG(r) \ 69 drm_rect_width(r) >> 16, ((drm_rect_width(r) & 0xffff) * 15625) >> 10, \ 70 drm_rect_height(r) >> 16, ((drm_rect_height(r) & 0xffff) * 15625) >> 10, \ 71 (r)->x1 >> 16, (((r)->x1 & 0xffff) * 15625) >> 10, \ 72 (r)->y1 >> 16, (((r)->y1 & 0xffff) * 15625) >> 10 73 74 /** 75 * drm_rect_init - initialize the rectangle from x/y/w/h 76 * @r: rectangle 77 * @x: x coordinate 78 * @y: y coordinate 79 * @width: width 80 * @height: height 81 */ 82 static inline void drm_rect_init(struct drm_rect *r, int x, int y, 83 int width, int height) 84 { 85 r->x1 = x; 86 r->y1 = y; 87 r->x2 = x + width; 88 r->y2 = y + height; 89 } 90 91 /** 92 * drm_rect_adjust_size - adjust the size of the rectangle 93 * @r: rectangle to be adjusted 94 * @dw: horizontal adjustment 95 * @dh: vertical adjustment 96 * 97 * Change the size of rectangle @r by @dw in the horizontal direction, 98 * and by @dh in the vertical direction, while keeping the center 99 * of @r stationary. 100 * 101 * Positive @dw and @dh increase the size, negative values decrease it. 102 */ 103 static inline void drm_rect_adjust_size(struct drm_rect *r, int dw, int dh) 104 { 105 r->x1 -= dw >> 1; 106 r->y1 -= dh >> 1; 107 r->x2 += (dw + 1) >> 1; 108 r->y2 += (dh + 1) >> 1; 109 } 110 111 /** 112 * drm_rect_translate - translate the rectangle 113 * @r: rectangle to be tranlated 114 * @dx: horizontal translation 115 * @dy: vertical translation 116 * 117 * Move rectangle @r by @dx in the horizontal direction, 118 * and by @dy in the vertical direction. 119 */ 120 static inline void drm_rect_translate(struct drm_rect *r, int dx, int dy) 121 { 122 r->x1 += dx; 123 r->y1 += dy; 124 r->x2 += dx; 125 r->y2 += dy; 126 } 127 128 /** 129 * drm_rect_translate_to - translate the rectangle to an absolute position 130 * @r: rectangle to be tranlated 131 * @x: horizontal position 132 * @y: vertical position 133 * 134 * Move rectangle @r to @x in the horizontal direction, 135 * and to @y in the vertical direction. 136 */ 137 static inline void drm_rect_translate_to(struct drm_rect *r, int x, int y) 138 { 139 drm_rect_translate(r, x - r->x1, y - r->y1); 140 } 141 142 /** 143 * drm_rect_downscale - downscale a rectangle 144 * @r: rectangle to be downscaled 145 * @horz: horizontal downscale factor 146 * @vert: vertical downscale factor 147 * 148 * Divide the coordinates of rectangle @r by @horz and @vert. 149 */ 150 static inline void drm_rect_downscale(struct drm_rect *r, int horz, int vert) 151 { 152 r->x1 /= horz; 153 r->y1 /= vert; 154 r->x2 /= horz; 155 r->y2 /= vert; 156 } 157 158 /** 159 * drm_rect_width - determine the rectangle width 160 * @r: rectangle whose width is returned 161 * 162 * RETURNS: 163 * The width of the rectangle. 164 */ 165 static inline int drm_rect_width(const struct drm_rect *r) 166 { 167 return r->x2 - r->x1; 168 } 169 170 /** 171 * drm_rect_height - determine the rectangle height 172 * @r: rectangle whose height is returned 173 * 174 * RETURNS: 175 * The height of the rectangle. 176 */ 177 static inline int drm_rect_height(const struct drm_rect *r) 178 { 179 return r->y2 - r->y1; 180 } 181 182 /** 183 * drm_rect_visible - determine if the rectangle is visible 184 * @r: rectangle whose visibility is returned 185 * 186 * RETURNS: 187 * %true if the rectangle is visible, %false otherwise. 188 */ 189 static inline bool drm_rect_visible(const struct drm_rect *r) 190 { 191 return drm_rect_width(r) > 0 && drm_rect_height(r) > 0; 192 } 193 194 /** 195 * drm_rect_equals - determine if two rectangles are equal 196 * @r1: first rectangle 197 * @r2: second rectangle 198 * 199 * RETURNS: 200 * %true if the rectangles are equal, %false otherwise. 201 */ 202 static inline bool drm_rect_equals(const struct drm_rect *r1, 203 const struct drm_rect *r2) 204 { 205 return r1->x1 == r2->x1 && r1->x2 == r2->x2 && 206 r1->y1 == r2->y1 && r1->y2 == r2->y2; 207 } 208 209 bool drm_rect_intersect(struct drm_rect *r, const struct drm_rect *clip); 210 bool drm_rect_clip_scaled(struct drm_rect *src, struct drm_rect *dst, 211 const struct drm_rect *clip); 212 int drm_rect_calc_hscale(const struct drm_rect *src, 213 const struct drm_rect *dst, 214 int min_hscale, int max_hscale); 215 int drm_rect_calc_vscale(const struct drm_rect *src, 216 const struct drm_rect *dst, 217 int min_vscale, int max_vscale); 218 void drm_rect_debug_print(const char *prefix, 219 const struct drm_rect *r, bool fixed_point); 220 void drm_rect_rotate(struct drm_rect *r, 221 int width, int height, 222 unsigned int rotation); 223 void drm_rect_rotate_inv(struct drm_rect *r, 224 int width, int height, 225 unsigned int rotation); 226 227 #endif 228