半開矩形領域

矩形領域を指定する場合、 xdwlib では半開矩形領域 (half-open rectangular) を用います。

半開矩形領域とは、横 (x) 座標範囲および縦 (y) 座標範囲がそれぞれ半開区間 [left, right), [top, bottom) となっているような矩形領域を指します。 このとき、

• left は指定矩形領域内の左端

• top は指定矩形領域内の上端

• right は指定矩形領域外の左端 (指定矩形領域内の右端の右隣)

• bottom は指定矩形領域外の上端 (指定矩形領域内の下端の下隣)

です [1] 。

[1]

DocuWorks で扱う座標は (1/100 ミリメートル単位の) 離散値からなるため、「隣」が定義できます。

半開矩形領域 r = Rect(left, top, right, bottom) の大きさ (横幅および高さ) を求める関数 size は、次のように書けます。

def size(r):
    width = r.right - r.left
    height = r.bottom - r.top
    return Point(width, height)

横幅は right - left, 縦幅 (高さ) は bottom - top で求められます。 また、ある座標 p = Point(x, y) が 半開矩形領域 r = Rect(left, top, right, bottom) に含まれるか否かを判定する関数 inside は、次のように書けます。

def inside(p, r):
    return r.left <= p.x < r.right and r.top <= p.y < r.bottom

矩形領域を指定するメソッドでオプション引数 half_open が用意されている場合は、それに False を指定することで、 半開矩形領域でなく閉鎖矩形領域 (横・縦座標範囲がいずれも閉鎖区間であるもの) を与えることもできます。