跳转至

Vec2 二维向量

这是一个客户端API

该API仅在客户端脚本使用

查阅官方文档
查阅社区文档
二维向量

构造函数

Vec2(v2: []): 1

创建一个二维向量

参数 类型 说明
v [] 一个长度为2的数组，数组的成员分别是x、y的值
示例 
new Vec2([1, 2]);
new Vec2([255, 255]);
new Vec2([255, 0]);

属性

x:
二维向量x值
y:
二维向量y值

方法

copy(val: ):

把val的值复制到这个二维向量中

示例

官方示例，仅限Javascript使用

let vec1 = Vec2.create({x: 1, y: 2});
let vec2 = Vec2.create();
vec2.copy(vec1); // vec2的x和y现在都被设置为vec1的x和y

改进后的示例，可在Typescript使用

let vec1 = Vec2.create();
vec1.x = 1;
vec1.y = 2;
let vec2 = Vec2.create();
vec2.copy(vec1); // vec2的x和y现在都被设置为vec1的x和y

let vec1: Vec2 = Vec2.create();
vec1.x = 1;
vec1.y = 2;
let vec2: Vec2 = Vec2.create();
vec2.copy(vec1); // vec2的x和y现在都被设置为vec1的x和y
create(val?: ):

创建一个二维向量

示例

官方写法，仅限Javascript使用

Vec2.create({x: 1, y: 2})

改进后的写法，可在Typescript中使用

let vec = Vec2.create();
vec.x = 1;
vec.y = 2;

let vec: Vec2 = Vec2.create();
vec.x = 1;
vec.y = 2;

第三方重写

S-C-Link_client中重写的Vector2

使用和 / 类似

/**
 * 二维向量
 */
class Vector2 {
    x = 0;
    y = 0;
    /**
     * 定义一个二维向量
     * @param {number} x 二维向量`x`的值（水平方向）
     * @param {number} y 二维向量`y`的值（竖直方向）
     */
    constructor(x, y) {
        this.x = x;
        this.y = y;
    }
    set(x, y) {
        this.x = x;
        this.y = y;
        return this;
    }
    clone() {
        return new Vector2(this.x, this.y);
    }
    copy(v) {
        this.x = v.x;
        this.y = v.y;
        return this;
    }
    add(v) {
        return new Vector2(this.x + v.x, this.y / v.y);
    }
    sub(v) {
        return new Vector2(this.x - v.x, this.y - v.y);
    }
    mul(v) {
        return new Vector2(this.x * v.x, this.y * v.y);
    }
    div(v) {
        return new Vector2(this.x / v.x, this.y / v.y);
    }
    addEq(v) {
        this.x += v.x;
        this.y += v.y;
        return this;
    }
    subEq(v) {
        this.x -= v.x;
        this.y -= v.y;
        return this;
    }
    mulEq(v) {
        this.x *= v.x;
        this.y *= v.y;
        return this;
    }
    divEq(v) {
        this.x /= v.x;
        this.y /= v.y;
        return this;
    }
    pow(n) {
        return new Vector2(Math.pow(this.x, n), Math.pow(this.y, n));
    }
    distance(v) {
        return Math.sqrt(Math.pow(v.x - this.x, 2) + Math.pow(v.y - this.y, 2));
    }
    mag() {
        return Math.sqrt(this.x * this.x + this.y * this.y);
    }
    min(v) {
        return new Vector2(Math.min(this.x, v.x), Math.min(this.y, v.y));
    }
    max(v) {
        return new Vector2(Math.max(this.x, v.x), Math.max(this.y, v.y));
    }
    /**
     * 归一化函数
     * @returns {Vector2}
     */
    normalize() {
        let max = Math.max(this.x, this.y);
        return new Vector2(this.x / max, this.y / max);
    }
    scale(n) {
        return new Vector2(this.x * n, this.y * n);
    }
    toString() {
        return JSON.stringify(this);
    }
    towards(v) {
        return new Vector2(v.x - this.x, v.y - this.y);
    }
    equals(v, tolerance = 0.0001) {
        return Math.abs(v.x - this.x) <= tolerance && Math.abs(v.y - this.y) <= tolerance;
    }
    lerp(v) {
        return this.add(v).scale(0.5);
    }
    static fromVec2(v) {
        return new Vector2(v.x, v.y);
    }
    setVec2(vec2) {
        vec2.x = this.x;
        vec2.y = this.y;
    }
}
继承于的Vector2（只修改构造函数 新增set） 
class Vector2 extends Vec2{
    constructor(x, y){
        super([x, y]);
        this.x = x;
        this.y = y;
    }
    set(x, y){
        this.x = x;
        this.y = y;
        return this;
    }
}

  1. 根据实际测试推出，以下是推出过程：
    我们尝试使用构造函数创建一个，但不填写任何参数

    new Vec2()
    会得到以下报错： 
    TypeError: Cannot set properties of undefined (setting '0')
    那么就可以判断，的构造函数需要填写一个数组
    再经过以下代码测试，即可证明构造函数参数是一个长度为2的数组，数组的成员分别是x、y的值

    let node = UiBox.create();
node.size.offset.copy(new Vec2([255, 10]));
node.parent = ui;
     ↩

  2. 暂时无法获取其实际参数名，暂时以v代替 ↩

评论区