Source: draw/primitive.mjs

  1. import { DrawCommand } from "./drawcommand.mjs";
  2. import { SetColor, SetRotation } from "./state.mjs";
  3. import { Color } from "../color.mjs";
  5. /**
  6.  * Base class of all primitives.
  7.  * Handles position, rotation, color and stroke weight.
  8.  * Creates the command list for those properties.
  9.  */
  10. export class Primitive extends DrawCommand {
  11.     pos;
  12.     weight;
  13.     rotation;
  14.     fillCol;
  15.     strokeCol;
  16.     noFill;
  17.     noStroke;
  19.     constructor() {
  20.         super();
  21.         this.pos = { x: 0, y: 0 };
  22.         this.strokeCol = Color.Black;
  23.         this.fillCol = Color.Black;
  24.         this.weight = 1;
  25.         this.rotation = 0;
  26.         this.noFill = false;
  27.         this.noStroke = false;
  28.     }
  30.     /**
  31.      * Set the color of the primitive.
  32.      * @param {Color} fillColor - the color to use
  33.      * @param {Color} strokeColor - the stroke color to use, may be null then it uses the fill color.
  34.      * @returns {Primitive} - the primitive
  35.      */
  36.     color(fillColor, strokeColor) {
  37.         this.fillCol = fillColor;
  38.         this.strokeCol = strokeColor || fillColor;
  39.         return this;
  40.     }
  42.     /**
  43.      * Set the X coordinate of the primitive.
  44.      * @param {number} - the x coordinate
  45.      * @returns {Primitive} - the primitive
  46.      */
  47.     x(x) {
  48.         this.pos.x = x;
  49.         return this;
  50.     }
  52.     /**
  53.      * Set the Y coordinate of the primitive.
  54.      * @param {number} y - the y coordinate
  55.      * @returns {Primitive} - the primitive
  56.      */
  57.     y(y) {
  58.         this.pos.y = y;
  59.         return this;
  60.     }
  62.     /**
  63.      * Set the X and Y coordinates of the primitive.
  64.      * @param {number} x - the x coordinate
  65.      * @param {number} y - the y coordinate
  66.      * @returns {Primitive} - the primitive
  67.      */
  68.     xy(x, y) {
  69.         this.x(x);
  70.         this.y(y);
  71.         return this;
  72.     }
  74.     /**
  75.      * Specify the rotation of the primitive. It gets rotated
  76.      * around the point of the position.
  77.      * @param {number} rotation - the rotation in radians
  78.      * @returns {Primitive}
  79.      */
  80.     rotation(rotation) {
  81.         this.rotation = rotation;
  82.         return this;
  83.     }
  85.     /**
  86.      * Set the stroke weight (aka width) of the
  87.      * stroke lines.
  88.      * @param {number} weight - the stroke weight
  89.      * @returns {Primitive} - the primitive
  90.      */
  91.     strokeWeight(weight) {
  92.         this.weight = weight;
  93.         return this;
  94.     }
  96.     /**
  97.      * Specify if the primitive shape should be filled with the
  98.      * fill color.
  99.      * @param {boolean} fill should fill the shape
  100.      * @returns {Primitive}
  101.      */
  102.     dofill(fill = true) {
  103.         this.noFill = !fill;
  104.         return this;
  105.     }
  107.     /**
  108.      * Don't fill the shape.
  109.      * Shorthand for dofill(false)
  110.      * @returns {Primitive}
  111.      */
  112.     nofill() {
  113.         this.noFill = true;
  114.         return this;
  115.     }
  117.     /**
  118.      * Specify if the primitive shape should be stroked with the
  119.      * stroke color.
  120.      * @param {boolean} stroke should stroke the shape
  121.      * @returns {Primitive}
  122.      */
  123.     dostroke(stroke = true) {
  124.         this.noStroke = !stroke;
  125.         return this;
  126.     }
  128.     /**
  129.      * Don't stroke the shape.
  130.      * Shorthand for dostroke(false)
  131.      * @returns {Primitive}
  132.      */
  133.     nostroke() {
  134.         this.noStroke = true;
  135.         return this;
  136.     }
  138.     /**
  139.      * --- INTERNAL ---
  140.      * Generate the command list for the primitive
  141.      * @returns {Array}
  142.      */
  143.     genCmdList() {
  144.         let list = super.genCmdList();
  145.         if(!(this.noStroke && this.noFill)) {
  146.             list.push(new SetColor(this.fillCol, this.strokeCol));
  147.         }
  148.         list.push(new SetRotation(this.rotation, this.pos.x, this.pos.y));
  149.         return list;
  150.     }
  151. }