fabric/dist/src/shapes/Image.min.mjs.map

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

{"version":3,"file":"Image.min.mjs","names":[],"sources":["../../../src/shapes/Image.ts"],"sourcesContent":["import { getFabricDocument, getEnv } from '../env';\nimport type { BaseFilter } from '../filters/BaseFilter';\nimport { getFilterBackend } from '../filters/FilterBackend';\nimport { SHARED_ATTRIBUTES } from '../parser/attributes';\nimport { parseAttributes } from '../parser/parseAttributes';\nimport type {\n  TClassProperties,\n  TCrossOrigin,\n  TSize,\n  Abortable,\n  TOptions,\n} from '../typedefs';\nimport { uid } from '../util/internals/uid';\nimport { createCanvasElementFor } from '../util/misc/dom';\nimport { findScaleToCover, findScaleToFit } from '../util/misc/findScaleTo';\nimport type { LoadImageOptions } from '../util/misc/objectEnlive';\nimport {\n  enlivenObjectEnlivables,\n  enlivenObjects,\n  loadImage,\n} from '../util/misc/objectEnlive';\nimport { parsePreserveAspectRatioAttribute } from '../util/misc/svgParsing';\nimport { classRegistry } from '../ClassRegistry';\nimport { FabricObject, cacheProperties } from './Object/FabricObject';\nimport type { FabricObjectProps, SerializedObjectProps } from './Object/types';\nimport type { ObjectEvents } from '../EventTypeDefs';\nimport { WebGLFilterBackend } from '../filters/WebGLFilterBackend';\nimport { FILL, NONE } from '../constants';\nimport { getDocumentFromElement } from '../util/dom_misc';\nimport type { CSSRules } from '../parser/typedefs';\nimport type { Resize, ResizeSerializedProps } from '../filters/Resize';\nimport type { TCachedFabricObject } from './Object/Object';\nimport { log } from '../util/internals/console';\nimport { escapeXml } from '../util/lang_string';\n\n// @todo Would be nice to have filtering code not imported directly.\n\nexport type ImageSource =\n  | HTMLImageElement\n  | HTMLVideoElement\n  | HTMLCanvasElement;\n\nexport type ParsedPAROffsets = {\n  width: number;\n  height: number;\n  scaleX: number;\n  scaleY: number;\n  offsetLeft: number;\n  offsetTop: number;\n  cropX: number;\n  cropY: number;\n};\n\ninterface UniqueImageProps {\n  srcFromAttribute: boolean;\n  minimumScaleTrigger: number;\n  cropX: number;\n  cropY: number;\n  imageSmoothing: boolean;\n  filters: BaseFilter<string>[];\n  resizeFilter?: Resize;\n}\n\nexport const imageDefaultValues: Partial<TClassProperties<FabricImage>> = {\n  strokeWidth: 0,\n  srcFromAttribute: false,\n  minimumScaleTrigger: 0.5,\n  cropX: 0,\n  cropY: 0,\n  imageSmoothing: true,\n};\n\nexport interface SerializedImageProps extends SerializedObjectProps {\n  src: string;\n  crossOrigin: TCrossOrigin;\n  filters: any[];\n  resizeFilter?: ResizeSerializedProps;\n  cropX: number;\n  cropY: number;\n}\n\nexport interface ImageProps extends FabricObjectProps, UniqueImageProps {}\n\nconst IMAGE_PROPS = ['cropX', 'cropY'] as const;\n\n/**\n * @see {@link http://fabric5.fabricjs.com/fabric-intro-part-1#images}\n */\nexport class FabricImage<\n  Props extends TOptions<ImageProps> = Partial<ImageProps>,\n  SProps extends SerializedImageProps = SerializedImageProps,\n  EventSpec extends ObjectEvents = ObjectEvents,\n>\n  extends FabricObject<Props, SProps, EventSpec>\n  implements ImageProps\n{\n  /**\n   * When calling {@link FabricImage.getSrc}, return value from element src with `element.getAttribute('src')`.\n   * This allows for relative urls as image src.\n   * @since 2.7.0\n   * @type Boolean\n   * @default false\n   */\n  declare srcFromAttribute: boolean;\n\n  /**\n   * private\n   * contains last value of scaleX to detect\n   * if the Image got resized after the last Render\n   * @type Number\n   */\n  protected _lastScaleX = 1;\n\n  /**\n   * private\n   * contains last value of scaleY to detect\n   * if the Image got resized after the last Render\n   * @type Number\n   */\n  protected _lastScaleY = 1;\n\n  /**\n   * private\n   * contains last value of scaling applied by the apply filter chain\n   * @type Number\n   */\n  protected _filterScalingX = 1;\n\n  /**\n   * private\n   * contains last value of scaling applied by the apply filter chain\n   * @type Number\n   */\n  protected _filterScalingY = 1;\n\n  /**\n   * minimum scale factor under which any resizeFilter is triggered to resize the image\n   * 0 will disable the automatic resize. 1 will trigger automatically always.\n   * number bigger than 1 are not implemented yet.\n   * @type Number\n   */\n  declare minimumScaleTrigger: number;\n\n  /**\n   * key used to retrieve the texture representing this image\n   * @since 2.0.0\n   * @type String\n   */\n  declare cacheKey: string;\n\n  /**\n   * Image crop in pixels from original image size.\n   * @since 2.0.0\n   * @type Number\n   */\n  declare cropX: number;\n\n  /**\n   * Image crop in pixels from original image size.\n   * @since 2.0.0\n   * @type Number\n   */\n  declare cropY: number;\n\n  /**\n   * Indicates whether this canvas will use image smoothing when painting this image.\n   * Also influence if the cacheCanvas for this image uses imageSmoothing\n   * @since 4.0.0-beta.11\n   * @type Boolean\n   */\n  declare imageSmoothing: boolean;\n\n  declare preserveAspectRatio: string;\n\n  declare protected src: string;\n\n  declare filters: BaseFilter<string>[];\n  declare resizeFilter: Resize;\n\n  declare _element: ImageSource;\n  declare _filteredEl?: HTMLCanvasElement;\n  declare _originalElement: ImageSource;\n\n  static type = 'Image';\n\n  static cacheProperties = [...cacheProperties, ...IMAGE_PROPS];\n\n  static ownDefaults = imageDefaultValues;\n\n  static getDefaults(): Record<string, any> {\n    return {\n      ...super.getDefaults(),\n      ...FabricImage.ownDefaults,\n    };\n  }\n  /**\n   * Constructor\n   * Image can be initialized with any canvas drawable or a string.\n   * The string should be a url and will be loaded as an image.\n   * Canvas and Image element work out of the box, while videos require extra code to work.\n   * Please check video element events for seeking.\n   * @param {ImageSource | string} element Image element\n   * @param {Object} [options] Options object\n   */\n  constructor(elementId: string, options?: Props);\n  constructor(element: ImageSource, options?: Props);\n  constructor(arg0: ImageSource | string, options?: Props) {\n    super();\n    this.filters = [];\n    Object.assign(this, FabricImage.ownDefaults);\n    this.setOptions(options);\n    this.cacheKey = `texture${uid()}`;\n    this.setElement(\n      typeof arg0 === 'string'\n        ? ((\n            (this.canvas && getDocumentFromElement(this.canvas.getElement())) ||\n            getFabricDocument()\n          ).getElementById(arg0) as ImageSource)\n        : arg0,\n      options,\n    );\n  }\n\n  /**\n   * Returns image element which this instance if based on\n   */\n  getElement() {\n    return this._element;\n  }\n\n  /**\n   * Sets image element for this instance to a specified one.\n   * If filters defined they are applied to new image.\n   * You might need to call `canvas.renderAll` and `object.setCoords` after replacing, to render new image and update controls area.\n   * @param {HTMLImageElement} element\n   * @param {Partial<TSize>} [size] Options object\n   */\n  setElement(element: ImageSource, size: Partial<TSize> = {}) {\n    this.removeTexture(this.cacheKey);\n    this.removeTexture(`${this.cacheKey}_filtered`);\n    this._element = element;\n    this._originalElement = element;\n    this._setWidthHeight(size);\n    if (this.filters.length !== 0) {\n      this.applyFilters();\n    }\n    // resizeFilters work on the already filtered copy.\n    // we need to apply resizeFilters AFTER normal filters.\n    // applyResizeFilters is run more often than normal filters\n    // and is triggered by user interactions rather than dev code\n    if (this.resizeFilter) {\n      this.applyResizeFilters();\n    }\n  }\n\n  /**\n   * Delete a single texture if in webgl mode\n   */\n  removeTexture(key: string) {\n    const backend = getFilterBackend(false);\n    if (backend instanceof WebGLFilterBackend) {\n      backend.evictCachesForKey(key);\n    }\n  }\n\n  /**\n   * Delete textures, reference to elements and eventually JSDOM cleanup\n   */\n  dispose() {\n    super.dispose();\n    this.removeTexture(this.cacheKey);\n    this.removeTexture(`${this.cacheKey}_filtered`);\n    this._cacheContext = null;\n    (\n      ['_originalElement', '_element', '_filteredEl', '_cacheCanvas'] as const\n    ).forEach((elementKey) => {\n      const el = this[elementKey];\n      el && getEnv().dispose(el);\n      // @ts-expect-error disposing\n      this[elementKey] = undefined;\n    });\n  }\n\n  /**\n   * Get the crossOrigin value (of the corresponding image element)\n   */\n  getCrossOrigin(): string | null {\n    return (\n      this._originalElement &&\n      ((this._originalElement as any).crossOrigin || null)\n    );\n  }\n\n  /**\n   * Returns original size of an image\n   */\n  getOriginalSize() {\n    const element = this.getElement() as any;\n    if (!element) {\n      return {\n        width: 0,\n        height: 0,\n      };\n    }\n    return {\n      width: element.naturalWidth || element.width,\n      height: element.naturalHeight || element.height,\n    };\n  }\n\n  /**\n   * @private\n   * @param {CanvasRenderingContext2D} ctx Context to render on\n   */\n  _stroke(ctx: CanvasRenderingContext2D) {\n    if (!this.stroke || this.strokeWidth === 0) {\n      return;\n    }\n    const w = this.width / 2,\n      h = this.height / 2;\n    ctx.beginPath();\n    ctx.moveTo(-w, -h);\n    ctx.lineTo(w, -h);\n    ctx.lineTo(w, h);\n    ctx.lineTo(-w, h);\n    ctx.lineTo(-w, -h);\n    ctx.closePath();\n  }\n\n  /**\n   * Returns object representation of an instance\n   * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output\n   * @return {Object} Object representation of an instance\n   */\n  toObject<\n    T extends Omit<Props & TClassProperties<this>, keyof SProps>,\n    K extends keyof T = never,\n  >(propertiesToInclude: K[] = []): Pick<T, K> & SProps {\n    const filters: Record<string, any>[] = [];\n    this.filters.forEach((filterObj) => {\n      filterObj && filters.push(filterObj.toObject());\n    });\n    return {\n      ...super.toObject([...IMAGE_PROPS, ...propertiesToInclude]),\n      src: this.getSrc(),\n      crossOrigin: this.getCrossOrigin(),\n      filters,\n      ...(this.resizeFilter\n        ? { resizeFilter: this.resizeFilter.toObject() }\n        : {}),\n    };\n  }\n\n  /**\n   * Returns true if an image has crop applied, inspecting values of cropX,cropY,width,height.\n   * @return {Boolean}\n   */\n  hasCrop() {\n    return (\n      !!this.cropX ||\n      !!this.cropY ||\n      this.width < this._element.width ||\n      this.height < this._element.height\n    );\n  }\n\n  /**\n   * Returns svg representation of an instance\n   * @return {string[]} an array of strings with the specific svg representation\n   * of the instance\n   */\n  _toSVG() {\n    const imageMarkup: string[] = [],\n      element = this._element,\n      x = -this.width / 2,\n      y = -this.height / 2;\n    let svgString: string[] = [],\n      strokeSvg: string[] = [],\n      clipPath = '',\n      imageRendering = '';\n    if (!element) {\n      return [];\n    }\n    if (this.hasCrop()) {\n      const clipPathId = uid();\n      svgString.push(\n        '<clipPath id=\"imageCrop_' + clipPathId + '\">\\n',\n        '\\t<rect x=\"' +\n          x +\n          '\" y=\"' +\n          y +\n          '\" width=\"' +\n          escapeXml(this.width) +\n          '\" height=\"' +\n          escapeXml(this.height) +\n          '\" />\\n',\n        '</clipPath>\\n',\n      );\n      clipPath = ' clip-path=\"url(#imageCrop_' + clipPathId + ')\" ';\n    }\n    if (!this.imageSmoothing) {\n      imageRendering = ' image-rendering=\"optimizeSpeed\"';\n    }\n    imageMarkup.push(\n      '\\t<image ',\n      'COMMON_PARTS',\n      `xlink:href=\"${escapeXml(this.getSrc(true))}\" x=\"${x - this.cropX}\" y=\"${\n        y - this.cropY\n        // we're essentially moving origin of transformation from top/left corner to the center of the shape\n        // by wrapping it in container <g> element with actual transformation, then offsetting object to the top/left\n        // so that object's center aligns with container's left/top\n      }\" width=\"${\n        element.width || (element as HTMLImageElement).naturalWidth\n      }\" height=\"${\n        element.height || (element as HTMLImageElement).naturalHeight\n      }\"${imageRendering}${clipPath}></image>\\n`,\n    );\n\n    if (this.stroke || this.strokeDashArray) {\n      const origFill = this.fill;\n      this.fill = null;\n      strokeSvg = [\n        `\\t<rect x=\"${x}\" y=\"${y}\" width=\"${escapeXml(this.width)}\" height=\"${escapeXml(\n          this.height,\n        )}\" style=\"${this.getSvgStyles()}\" />\\n`,\n      ];\n      this.fill = origFill;\n    }\n    if (this.paintFirst !== FILL) {\n      svgString = svgString.concat(strokeSvg, imageMarkup);\n    } else {\n      svgString = svgString.concat(imageMarkup, strokeSvg);\n    }\n    return svgString;\n  }\n\n  /**\n   * Returns source of an image\n   * @param {Boolean} filtered indicates if the src is needed for svg\n   * @return {String} Source of an image\n   */\n  getSrc(filtered?: boolean): string {\n    const element = filtered ? this._element : this._originalElement;\n    if (element) {\n      if ((element as HTMLCanvasElement).toDataURL) {\n        return (element as HTMLCanvasElement).toDataURL();\n      }\n\n      if (this.srcFromAttribute) {\n        return element.getAttribute('src') || '';\n      } else {\n        return (element as HTMLImageElement).src;\n      }\n    } else {\n      return this.src || '';\n    }\n  }\n\n  /**\n   * Alias for getSrc\n   * @param filtered\n   * @deprecated\n   */\n  getSvgSrc(filtered?: boolean) {\n    return this.getSrc(filtered);\n  }\n\n  /**\n   * Loads and sets source of an image\\\n   * **IMPORTANT**: It is recommended to abort loading tasks before calling this method to prevent race conditions and unnecessary networking\n   * @param {String} src Source string (URL)\n   * @param {LoadImageOptions} [options] Options object\n   */\n  setSrc(\n    src: string,\n    { crossOrigin, signal }: LoadImageOptions = {},\n  ): Promise<void> {\n    return loadImage(src, { crossOrigin, signal }).then((img) => {\n      typeof crossOrigin !== 'undefined' && this.set({ crossOrigin });\n      this.setElement(img);\n    });\n  }\n\n  /**\n   * Returns string representation of an instance\n   * @return {String} String representation of an instance\n   */\n  toString() {\n    return `#<Image: { src: \"${this.getSrc()}\" }>`;\n  }\n\n  applyResizeFilters() {\n    const filter = this.resizeFilter,\n      minimumScale = this.minimumScaleTrigger,\n      objectScale = this.getTotalObjectScaling(),\n      scaleX = objectScale.x,\n      scaleY = objectScale.y,\n      elementToFilter = this._filteredEl || this._originalElement;\n    if (this.group) {\n      this.set('dirty', true);\n    }\n    if (!filter || (scaleX > minimumScale && scaleY > minimumScale)) {\n      this._element = elementToFilter;\n      this._filterScalingX = 1;\n      this._filterScalingY = 1;\n      this._lastScaleX = scaleX;\n      this._lastScaleY = scaleY;\n      return;\n    }\n    const canvasEl = createCanvasElementFor(elementToFilter),\n      { width, height } = elementToFilter;\n    this._element = canvasEl;\n    this._lastScaleX = filter.scaleX = scaleX;\n    this._lastScaleY = filter.scaleY = scaleY;\n    getFilterBackend().applyFilters(\n      [filter],\n      elementToFilter,\n      width,\n      height,\n      this._element,\n    );\n    this._filterScalingX = canvasEl.width / this._originalElement.width;\n    this._filterScalingY = canvasEl.height / this._originalElement.height;\n  }\n\n  /**\n   * Applies filters assigned to this image (from \"filters\" array) or from filter param\n   * @param {Array} filters to be applied\n   * @param {Boolean} forResizing specify if the filter operation is a resize operation\n   */\n  applyFilters(filters: BaseFilter<string>[] = this.filters || []) {\n    filters = filters.filter((filter) => filter && !filter.isNeutralState());\n    this.set('dirty', true);\n\n    // needs to clear out or WEBGL will not resize correctly\n    this.removeTexture(`${this.cacheKey}_filtered`);\n\n    if (filters.length === 0) {\n      this._element = this._originalElement;\n      // this is unsafe and needs to be rethinkend\n      this._filteredEl = undefined;\n      this._filterScalingX = 1;\n      this._filterScalingY = 1;\n      return;\n    }\n\n    const imgElement = this._originalElement,\n      sourceWidth =\n        (imgElement as HTMLImageElement).naturalWidth || imgElement.width,\n      sourceHeight =\n        (imgElement as HTMLImageElement).naturalHeight || imgElement.height;\n\n    if (this._element === this._originalElement) {\n      // if the _element a reference to _originalElement\n      // we need to create a new element to host the filtered pixels\n      const canvasEl = createCanvasElementFor({\n        width: sourceWidth,\n        height: sourceHeight,\n      });\n      this._element = canvasEl;\n      this._filteredEl = canvasEl;\n    } else if (this._filteredEl) {\n      // if the _element is it own element,\n      // and we also have a _filteredEl, then we clean up _filteredEl\n      // and we assign it to _element.\n      // in this way we invalidate the eventual old resize filtered element\n      this._element = this._filteredEl;\n      this._filteredEl\n        .getContext('2d')!\n        .clearRect(0, 0, sourceWidth, sourceHeight);\n      // we also need to resize again at next renderAll, so remove saved _lastScaleX/Y\n      this._lastScaleX = 1;\n      this._lastScaleY = 1;\n    }\n    getFilterBackend().applyFilters(\n      filters,\n      this._originalElement,\n      sourceWidth,\n      sourceHeight,\n      this._element as HTMLCanvasElement,\n      this.cacheKey,\n    );\n    if (\n      this._originalElement.width !== this._element.width ||\n      this._originalElement.height !== this._element.height\n    ) {\n      this._filterScalingX = this._element.width / this._originalElement.width;\n      this._filterScalingY =\n        this._element.height / this._originalElement.height;\n    }\n  }\n\n  /**\n   * @private\n   * @param {CanvasRenderingContext2D} ctx Context to render on\n   */\n  _render(ctx: CanvasRenderingContext2D) {\n    ctx.imageSmoothingEnabled = this.imageSmoothing;\n    if (this.isMoving !== true && this.resizeFilter && this._needsResize()) {\n      this.applyResizeFilters();\n    }\n    this._stroke(ctx);\n    this._renderPaintInOrder(ctx);\n  }\n\n  /**\n   * Paint the cached copy of the object on the target context.\n   * it will set the imageSmoothing for the draw operation\n   * @param {CanvasRenderingContext2D} ctx Context to render on\n   */\n  drawCacheOnCanvas(\n    this: TCachedFabricObject<FabricImage>,\n    ctx: CanvasRenderingContext2D,\n  ) {\n    ctx.imageSmoothingEnabled = this.imageSmoothing;\n    super.drawCacheOnCanvas(ctx);\n  }\n\n  /**\n   * Decide if the FabricImage should cache or not. Create its own cache level\n   * needsItsOwnCache should be used when the object drawing method requires\n   * a cache step.\n   * Generally you do not cache objects in groups because the group outside is cached.\n   * This is the special Image version where we would like to avoid caching where possible.\n   * Essentially images do not benefit from caching. They may require caching, and in that\n   * case we do it. Also caching an image usually ends in a loss of details.\n   * A full performance audit should be done.\n   * @return {Boolean}\n   */\n  shouldCache() {\n    return this.needsItsOwnCache();\n  }\n\n  _renderFill(ctx: CanvasRenderingContext2D) {\n    const elementToDraw = this._element;\n    if (!elementToDraw) {\n      return;\n    }\n    const scaleX = this._filterScalingX,\n      scaleY = this._filterScalingY,\n      w = this.width,\n      h = this.height,\n      // crop values cannot be lesser than 0.\n      cropX = Math.max(this.cropX, 0),\n      cropY = Math.max(this.cropY, 0),\n      elWidth =\n        (elementToDraw as HTMLImageElement).naturalWidth || elementToDraw.width,\n      elHeight =\n        (elementToDraw as HTMLImageElement).naturalHeight ||\n        elementToDraw.height,\n      sX = cropX * scaleX,\n      sY = cropY * scaleY,\n      // the width height cannot exceed element width/height, starting from the crop offset.\n      sW = Math.min(w * scaleX, elWidth - sX),\n      sH = Math.min(h * scaleY, elHeight - sY),\n      x = -w / 2,\n      y = -h / 2,\n      maxDestW = Math.min(w, elWidth / scaleX - cropX),\n      maxDestH = Math.min(h, elHeight / scaleY - cropY);\n\n    elementToDraw &&\n      ctx.drawImage(elementToDraw, sX, sY, sW, sH, x, y, maxDestW, maxDestH);\n  }\n\n  /**\n   * needed to check if image needs resize\n   * @private\n   */\n  _needsResize() {\n    const scale = this.getTotalObjectScaling();\n    return scale.x !== this._lastScaleX || scale.y !== this._lastScaleY;\n  }\n\n  /**\n   * @private\n   * @deprecated unused\n   */\n  _resetWidthHeight() {\n    this.set(this.getOriginalSize());\n  }\n\n  /**\n   * @private\n   * Set the width and the height of the image object, using the element or the\n   * options.\n   */\n  _setWidthHeight({ width, height }: Partial<TSize> = {}) {\n    const size = this.getOriginalSize();\n    this.width = width || size.width;\n    this.height = height || size.height;\n  }\n\n  /**\n   * Calculate offset for center and scale factor for the image in order to respect\n   * the preserveAspectRatio attribute\n   * @private\n   */\n  parsePreserveAspectRatioAttribute(): ParsedPAROffsets {\n    const pAR = parsePreserveAspectRatioAttribute(\n        this.preserveAspectRatio || '',\n      ),\n      pWidth = this.width,\n      pHeight = this.height,\n      parsedAttributes = { width: pWidth, height: pHeight };\n    let rWidth = this._element.width,\n      rHeight = this._element.height,\n      scaleX = 1,\n      scaleY = 1,\n      offsetLeft = 0,\n      offsetTop = 0,\n      cropX = 0,\n      cropY = 0,\n      offset;\n\n    if (pAR && (pAR.alignX !== NONE || pAR.alignY !== NONE)) {\n      if (pAR.meetOrSlice === 'meet') {\n        scaleX = scaleY = findScaleToFit(this._element, parsedAttributes);\n        offset = (pWidth - rWidth * scaleX) / 2;\n        if (pAR.alignX === 'Min') {\n          offsetLeft = -offset;\n        }\n        if (pAR.alignX === 'Max') {\n          offsetLeft = offset;\n        }\n        offset = (pHeight - rHeight * scaleY) / 2;\n        if (pAR.alignY === 'Min') {\n          offsetTop = -offset;\n        }\n        if (pAR.alignY === 'Max') {\n          offsetTop = offset;\n        }\n      }\n      if (pAR.meetOrSlice === 'slice') {\n        scaleX = scaleY = findScaleToCover(this._element, parsedAttributes);\n        offset = rWidth - pWidth / scaleX;\n        if (pAR.alignX === 'Mid') {\n          cropX = offset / 2;\n        }\n        if (pAR.alignX === 'Max') {\n          cropX = offset;\n        }\n        offset = rHeight - pHeight / scaleY;\n        if (pAR.alignY === 'Mid') {\n          cropY = offset / 2;\n        }\n        if (pAR.alignY === 'Max') {\n          cropY = offset;\n        }\n        rWidth = pWidth / scaleX;\n        rHeight = pHeight / scaleY;\n      }\n    } else {\n      scaleX = pWidth / rWidth;\n      scaleY = pHeight / rHeight;\n    }\n    return {\n      width: rWidth,\n      height: rHeight,\n      scaleX,\n      scaleY,\n      offsetLeft,\n      offsetTop,\n      cropX,\n      cropY,\n    };\n  }\n\n  /**\n   * List of attribute names to account for when parsing SVG element (used by {@link FabricImage.fromElement})\n   * @see {@link http://www.w3.org/TR/SVG/struct.html#ImageElement}\n   */\n  static ATTRIBUTE_NAMES = [\n    ...SHARED_ATTRIBUTES,\n    'x',\n    'y',\n    'width',\n    'height',\n    'preserveAspectRatio',\n    'xlink:href',\n    'href',\n    'crossOrigin',\n    'image-rendering',\n  ];\n\n  /**\n   * Creates an instance of FabricImage from its object representation\n   * @param {Object} object Object to create an instance from\n   * @param {object} [options] Options object\n   * @param {AbortSignal} [options.signal] handle aborting, see https://developer.mozilla.org/en-US/docs/Web/API/AbortController/signal\n   * @returns {Promise<FabricImage>}\n   */\n  static fromObject<T extends TOptions<SerializedImageProps>>(\n    { filters: f, resizeFilter: rf, src, crossOrigin, type, ...object }: T,\n    options?: Abortable,\n  ) {\n    return Promise.all([\n      loadImage(src!, { ...options, crossOrigin }),\n      f && enlivenObjects<BaseFilter<string>>(f, options),\n      // redundant - handled by enlivenObjectEnlivables, but nicely explicit\n      rf ? enlivenObjects<Resize>([rf], options) : [],\n      enlivenObjectEnlivables(object, options),\n    ]).then(([el, filters = [], [resizeFilter], hydratedProps = {}]) => {\n      return new this(el, {\n        ...object,\n        // TODO: passing src creates a difference between image creation and restoring from JSON\n        src,\n        filters,\n        resizeFilter,\n        ...hydratedProps,\n      });\n    });\n  }\n\n  /**\n   * Creates an instance of Image from an URL string\n   * @param {String} url URL to create an image from\n   * @param {LoadImageOptions} [options] Options object\n   * @returns {Promise<FabricImage>}\n   */\n  static fromURL<T extends TOptions<ImageProps>>(\n    url: string,\n    { crossOrigin = null, signal }: LoadImageOptions = {},\n    imageOptions?: T,\n  ): Promise<FabricImage> {\n    return loadImage(url, { crossOrigin, signal }).then(\n      (img) => new this(img, imageOptions),\n    );\n  }\n\n  /**\n   * Returns {@link FabricImage} instance from an SVG element\n   * @param {HTMLElement} element Element to parse\n   * @param {Object} [options] Options object\n   * @param {AbortSignal} [options.signal] handle aborting, see https://developer.mozilla.org/en-US/docs/Web/API/AbortController/signal\n   * @param {Function} callback Callback to execute when Image object is created\n   */\n  static async fromElement(\n    element: HTMLElement,\n    options: Abortable = {},\n    cssRules?: CSSRules,\n  ) {\n    const parsedAttributes = parseAttributes(\n      element,\n      this.ATTRIBUTE_NAMES,\n      cssRules,\n    );\n    return this.fromURL(\n      parsedAttributes['xlink:href'] || parsedAttributes['href'],\n      options,\n      parsedAttributes,\n    ).catch((err) => {\n      log('log', 'Unable to parse Image', err);\n      return null;\n    });\n  }\n}\n\nclassRegistry.setClass(FabricImage);\nclassRegistry.setSVGClass(FabricImage);\n"],"mappings":"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"}