Method setHeading

src/math/p5.Vector.js:2024–2040

* Rotates a 2D vector to a specific angle without changing its magnitude. * * By convention, the positive x-axis has an angle of 0. Angles increase in * the clockwise direction. * * If the vector was created with * createVector() , `setHeading()` uses

(a)

   * }
   */
  setHeading(a) {
    if (this.dimensions < 2 || (
      this._values instanceof Array && this._values.slice(2).some(v => v !== 0))
    ) {
      p5._friendlyError(
        'p5.Vector.setHeading() only supports 2D vectors (z === 0). ' +
        'For 3D or higher-dimensional vectors, use rotate() or another ' +
        'appropriate method instead.',
        'p5.Vector.setHeading'
      );
      return this;
    }
    const m = this.mag();
    this.x = m * Math.cos(a);
    this.y = m * Math.sin(a);
    return this;
  }

  /**
   * Rotates a 2D vector by an angle without changing its magnitude.