Rect 类型

继承于 ValueType

模块: cc 父模块: cc

通过位置和宽高定义的 2D 矩形。

索引

属性（properties）

• x Number
• y Number
• width Number
• height Number
• xMin Number 矩形 x 轴上的最小值，等价于 rect.x。
• yMin Number 矩形 y 轴上的最小值。
• xMax Number 矩形 x 轴上的最大值。
• yMax Number 矩形 y 轴上的最大值。
• center Vec2 矩形的中心点。
• origin Vec2 矩形的 x 和 y 坐标。
• size Size 矩形的大小。

方法

• constructor Rect类的构造函数。
• fromMinMax 根据指定 2 个坐标创建出一个矩形区域。
• clone 克隆一个新的 Rect。
• equals 是否等于指定的矩形。
• lerp 线性插值
• intersects 当前矩形与指定矩形是否相交。
• intersection 返回 2 个矩形重叠的部分。
• contains 当前矩形是否包含指定坐标点。
• containsRect 当前矩形是否包含指定矩形。
• union 返回一个包含当前矩形和指定矩形的最小矩形。
• transformMat4 使用 mat4 对矩形进行矩阵转换。
• toString 转换为方便阅读的字符串
• set 从其它对象把所有属性复制到当前对象。

Details

属性（properties）

x

y

width

height

xMin

矩形 x 轴上的最小值，等价于 rect.x。

yMin

矩形 y 轴上的最小值。

xMax

矩形 x 轴上的最大值。

yMax

矩形 y 轴上的最大值。

center

矩形的中心点。

origin

矩形的 x 和 y 坐标。

size

矩形的大小。

方法

constructor

Rect类的构造函数。可以通过 cc.rect 简便方法进行创建。

参数列表

• x Number
• y Number
• w Number
• h Number

fromMinMax

根据指定 2 个坐标创建出一个矩形区域。

参数列表

• v1 Vec2
• v2 Vec2

示例

cc.Rect.fromMinMax(cc.v2(10, 10), cc.v2(20, 20)); // Rect {x: 10, y: 10, width: 10, height: 10};

clone

克隆一个新的 Rect。

示例

var a = new cc.Rect(0, 0, 10, 10);
a.clone();// Rect {x: 0, y: 0, width: 10, height: 10}

equals

是否等于指定的矩形。

参数列表

• other Rect

示例

var a = new cc.Rect(0, 0, 10, 10);
var b = new cc.Rect(0, 0, 10, 10);
a.equals(b);// true;

lerp

线性插值

参数列表

• to Rect
• ratio Number the interpolation coefficient.
• out Rect optional, the receiving vector.

示例

var a = new cc.Rect(0, 0, 10, 10);
var b = new cc.Rect(50, 50, 100, 100);
update (dt) {
   // method 1;
   var c = a.lerp(b, dt * 0.1);
   // method 2;
   a.lerp(b, dt * 0.1, c);
}

intersects

当前矩形与指定矩形是否相交。

参数列表

• rect Rect

示例

var a = new cc.Rect(0, 0, 10, 10);
var b = new cc.Rect(0, 0, 20, 20);
a.intersects(b);// true

intersection

返回 2 个矩形重叠的部分。

参数列表

• out Rect Stores the result
• rectB Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
var intersection = new cc.Rect();
a.intersection(intersection, b); // intersection {x: 0, y: 10, width: 10, height: 10};

contains

当前矩形是否包含指定坐标点。 Returns true if the point inside this rectangle.

参数列表

• point Vec2

示例

var a = new cc.Rect(0, 0, 10, 10);
var b = new cc.Vec2(0, 5);
a.contains(b);// true

containsRect

当前矩形是否包含指定矩形。

参数列表

• rect Rect

示例

var a = new cc.Rect(0, 0, 20, 20);
var b = new cc.Rect(0, 0, 10, 10);
a.containsRect(b);// true

union

返回一个包含当前矩形和指定矩形的最小矩形。

参数列表

• out Rect Stores the result
• rectB Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
var union = new cc.Rect();
a.union(union, b); // union {x: 0, y: 10, width: 20, height: 20};

transformMat4

使用 mat4 对矩形进行矩阵转换。

参数列表

• out Rect The output rect
• mat Mat4 The matrix4

toString

转换为方便阅读的字符串

示例

var a = new cc.Rect(0, 0, 10, 10);
a.toString();// "(0.00, 0.00, 10.00, 10.00)";

set

从其它对象把所有属性复制到当前对象。

参数列表

• source ValueType the source to copy