fabric/dist/src/brushes/BaseBrush.min.mjs.map

Object model for HTML5 canvas, and SVG-to-canvas parser. Backed by jsdom and node-canvas.

{"version":3,"file":"BaseBrush.min.mjs","names":[],"sources":["../../../src/brushes/BaseBrush.ts"],"sourcesContent":["import { Color } from '../color/Color';\nimport type { Point } from '../Point';\nimport type { Shadow } from '../Shadow';\nimport type { Canvas } from '../canvas/Canvas';\nimport type { TBrushEventData } from './typedefs';\n\n/**\n * @see {@link http://fabric5.fabricjs.com/freedrawing|Freedrawing demo}\n */\nexport abstract class BaseBrush {\n  /**\n   * Color of a brush\n   * @type String\n   */\n  color = 'rgb(0, 0, 0)';\n\n  /**\n   * Width of a brush, has to be a Number, no string literals\n   * @type Number\n   */\n  width = 1;\n\n  /**\n   * Shadow object representing shadow of this shape.\n   * <b>Backwards incompatibility note:</b> This property replaces \"shadowColor\" (String), \"shadowOffsetX\" (Number),\n   * \"shadowOffsetY\" (Number) and \"shadowBlur\" (Number) since v1.2.12\n   * @type Shadow\n   */\n  shadow: Shadow | null = null;\n\n  /**\n   * Line endings style of a brush (one of \"butt\", \"round\", \"square\")\n   * @type String\n   */\n  strokeLineCap: CanvasLineCap = 'round';\n\n  /**\n   * Corner style of a brush (one of \"bevel\", \"round\", \"miter\")\n   * @type String\n   */\n  strokeLineJoin: CanvasLineJoin = 'round';\n\n  /**\n   * Maximum miter length (used for strokeLineJoin = \"miter\") of a brush's\n   * @type Number\n   */\n  strokeMiterLimit = 10;\n\n  /**\n   * Stroke Dash Array.\n   * @type Array\n   */\n  strokeDashArray: number[] | null = null;\n\n  /**\n   * When `true`, the free drawing is limited to the whiteboard size. Default to false.\n   * @type Boolean\n   * @default false\n   */\n\n  limitedToCanvasSize = false;\n\n  /**\n   * @todo add type\n   */\n  declare canvas: Canvas;\n\n  constructor(canvas: Canvas) {\n    this.canvas = canvas;\n  }\n\n  abstract _render(): void;\n  abstract onMouseDown(pointer: Point, ev: TBrushEventData): void;\n  abstract onMouseMove(pointer: Point, ev: TBrushEventData): void;\n  /**\n   * @returns true if brush should continue blocking interaction\n   */\n  abstract onMouseUp(ev: TBrushEventData): boolean | void;\n\n  /**\n   * Sets brush styles\n   * @private\n   * @param {CanvasRenderingContext2D} ctx\n   */\n  _setBrushStyles(ctx: CanvasRenderingContext2D) {\n    ctx.strokeStyle = this.color;\n    ctx.lineWidth = this.width;\n    ctx.lineCap = this.strokeLineCap;\n    ctx.miterLimit = this.strokeMiterLimit;\n    ctx.lineJoin = this.strokeLineJoin;\n    ctx.setLineDash(this.strokeDashArray || []);\n  }\n\n  /**\n   * Sets the transformation on given context\n   * @param {CanvasRenderingContext2D} ctx context to render on\n   * @private\n   */\n  protected _saveAndTransform(ctx: CanvasRenderingContext2D) {\n    const v = this.canvas.viewportTransform;\n    ctx.save();\n    ctx.transform(v[0], v[1], v[2], v[3], v[4], v[5]);\n  }\n\n  protected needsFullRender() {\n    const color = new Color(this.color);\n    return color.getAlpha() < 1 || !!this.shadow;\n  }\n\n  /**\n   * Sets brush shadow styles\n   * @private\n   */\n  protected _setShadow() {\n    if (!this.shadow || !this.canvas) {\n      return;\n    }\n\n    const canvas = this.canvas,\n      shadow = this.shadow,\n      ctx = canvas.contextTop,\n      zoom = canvas.getZoom() * canvas.getRetinaScaling();\n\n    ctx.shadowColor = shadow.color;\n    ctx.shadowBlur = shadow.blur * zoom;\n    ctx.shadowOffsetX = shadow.offsetX * zoom;\n    ctx.shadowOffsetY = shadow.offsetY * zoom;\n  }\n\n  /**\n   * Removes brush shadow styles\n   * @private\n   */\n  protected _resetShadow() {\n    const ctx = this.canvas.contextTop;\n\n    ctx.shadowColor = '';\n    ctx.shadowBlur = ctx.shadowOffsetX = ctx.shadowOffsetY = 0;\n  }\n\n  /**\n   * Check is pointer is outside canvas boundaries\n   * @param {Object} pointer\n   * @private\n   */\n  protected _isOutSideCanvas(pointer: Point) {\n    return (\n      pointer.x < 0 ||\n      pointer.x > this.canvas.getWidth() ||\n      pointer.y < 0 ||\n      pointer.y > this.canvas.getHeight()\n    );\n  }\n}\n"],"mappings":"6JASA,IAAsB,EAAtB,KAAA,CA0DE,YAAY,EAAA,CAAA,EAAA,KArDZ,QAAQ,eAAA,CAAA,EAAA,KAMR,QAAQ,EAAA,CAAA,EAAA,KAQR,SAAwB,KAAA,CAAA,EAAA,KAMxB,gBAA+B,QAAA,CAAA,EAAA,KAM/B,iBAAiC,QAAA,CAAA,EAAA,KAMjC,mBAAmB,GAAA,CAAA,EAAA,KAMnB,kBAAmC,KAAA,CAAA,EAAA,KAQnC,sBAAA,CAAsB,EAAA,CAQpB,KAAK,OAAS,EAgBhB,gBAAgB,EAAA,CACd,EAAI,YAAc,KAAK,MACvB,EAAI,UAAY,KAAK,MACrB,EAAI,QAAU,KAAK,cACnB,EAAI,WAAa,KAAK,iBACtB,EAAI,SAAW,KAAK,eACpB,EAAI,YAAY,KAAK,iBAAmB,EAAA,CAAA,CAQ1C,kBAA4B,EAAA,CAC1B,IAAM,EAAI,KAAK,OAAO,kBACtB,EAAI,MAAA,CACJ,EAAI,UAAU,EAAE,GAAI,EAAE,GAAI,EAAE,GAAI,EAAE,GAAI,EAAE,GAAI,EAAE,GAAA,CAGhD,iBAAA,CAEE,OADc,IAAI,EAAM,KAAK,MAAA,CAChB,UAAA,CAAa,GAAA,CAAA,CAAO,KAAK,OAOxC,YAAA,CACE,GAAA,CAAK,KAAK,QAAA,CAAW,KAAK,OACxB,OAGF,IAAM,EAAS,KAAK,OAClB,EAAS,KAAK,OACd,EAAM,EAAO,WACb,EAAO,EAAO,SAAA,CAAY,EAAO,kBAAA,CAEnC,EAAI,YAAc,EAAO,MACzB,EAAI,WAAa,EAAO,KAAO,EAC/B,EAAI,cAAgB,EAAO,QAAU,EACrC,EAAI,cAAgB,EAAO,QAAU,EAOvC,cAAA,CACE,IAAM,EAAM,KAAK,OAAO,WAExB,EAAI,YAAc,GAClB,EAAI,WAAa,EAAI,cAAgB,EAAI,cAAgB,EAQ3D,iBAA2B,EAAA,CACzB,OACE,EAAQ,EAAI,GACZ,EAAQ,EAAI,KAAK,OAAO,UAAA,EACxB,EAAQ,EAAI,GACZ,EAAQ,EAAI,KAAK,OAAO,WAAA,GAAA,OAAA,KAAA"}