Class CanvasRegion

constructor

• new CanvasRegion(
      source: CanvasSource,
      regionCompute: (parent: CanvasSource) => Geometry.RectPositioned,
  ): CanvasRegion

  Creates, using coordinate in canvas coordinates

  Parameters

  • source: CanvasSource
  • regionCompute: (parent: CanvasSource) => Geometry.RectPositioned

  Returns CanvasRegion

source

center

• get center(): Geometry.Point

  Returns Geometry.Point

context

• get context(): CanvasRenderingContext2D

  Returns CanvasRenderingContext2D

dimensionMin

• get dimensionMin(): number

  Returns number

height

• get height(): number

  Returns number

region

• get region(): Geometry.RectPositioned

  Returns Geometry.RectPositioned

• set region(value: Geometry.RectPositioned): void

  Parameters

  • value: Geometry.RectPositioned

  Returns void

width

• get width(): number

  Returns number

x

• get x(): number

  Returns number

y

• get y(): number

  Returns number

absToRegionPoint

• absToRegionPoint(
      pt: Geometry.Point,
      source: "screen",
      clamped: boolean,
  ): { x: number; y: number }

  Parameters

  • pt: Geometry.Point
  • source: "screen"
  • clamped: boolean

  Returns { x: number; y: number }

applyRegionOffset

• applyRegionOffset(p: Geometry.Point): { x: number; y: number }

  Returns a copy of p offset by the region's x & y

  Parameters

  • p: Geometry.Point

  Returns { x: number; y: number }

clear

• clear(): void

  Returns void

drawBounds

• drawBounds(strokeStyle: string, lineWidth?: number): void

  Parameters

  • strokeStyle: string
  • lineWidth: number = 1

  Returns void

drawCircles

• drawCircles(
      relativeCircles: Geometry.Circles.CirclePositioned[],
      fillStyle: string,
      strokeStyle?: string,
      lineWidth?: number,
  ): void

  Parameters

  • relativeCircles: Geometry.Circles.CirclePositioned[]
  • fillStyle: string
  • strokeStyle: string = ...
  • lineWidth: number = 1

  Returns void

drawConnectedPoints

• drawConnectedPoints(
      points: Geometry.Point[],
      strokeStyle: string,
      lineWidth?: number,
  ): void

  Draws connected points in absolute coordinates, however with 0,0 being the top-left of the region.

  Thus, this will apply the region offset before drawing.

  Parameters

  • points: Geometry.Point[]

    Points to draw
  • strokeStyle: string

    Stroke style
  • lineWidth: number = 1

    Line width

  Returns void

drawConnectedPointsRelative

• drawConnectedPointsRelative(
      relativePoints: Geometry.Point[],
      strokeStyle: string,
      lineWidth?: number,
  ): void

  Draws a line from a series of points. Assumes region-relative, % coordinates (ie 0..1 scale)

  Parameters

  • relativePoints: Geometry.Point[]

    Points to connect, in region-relative coordinates
  • strokeStyle: string

    Stroke style
  • lineWidth: number = 1

    Line with

  Returns void

fill

• fill(fillStyle?: string): void

  Parameters

  • fillStyle: string = ...

  Returns void

fillText

• fillText(
      text: string,
      point: Geometry.Point,
      fillStyle?: string,
      font: string,
      baseline?: CanvasTextBaseline,
      align?: CanvasTextAlign,
  ): void

  Fills text at a region-relative position

  Parameters

  • text: string
  • point: Geometry.Point

    Region relative, meaning 0,0 is top-left of region
  • fillStyle: string = ...
  • font: string
  • baseline: CanvasTextBaseline = ...
  • align: CanvasTextAlign = ...

  Returns void

fillTextRelative

• fillTextRelative(
      text: string,
      relPos: Geometry.Point,
      fillStyle?: string,
      font: string,
      baseline?: CanvasTextBaseline,
      align?: CanvasTextAlign,
  ): void

  Fills text at a relative position

  Parameters

  • text: string
  • relPos: Geometry.Point

    Relative, meaning 0.5,0.5 is the middle of the region
  • fillStyle: string = ...
  • font: string
  • baseline: CanvasTextBaseline = ...
  • align: CanvasTextAlign = ...

  Returns void

recomputeRegion

• recomputeRegion(): void

  Calls the original regionCompute function passed in to the constructor to recompute the absolute region

  Returns void

toAbsRegion

• toAbsRegion(
      regionRel: Geometry.Point,
      scaleBy?: "both",
  ): { x: number; y: number }

  Converts a region-relative point (0..1) to an absolute point, which uses region-relative coordinates.

  Eg if the region had an x,y of 100,100, toAbsRegion({x:0,y:0}) will return 0,0.

  Parameters

  • regionRel: Geometry.Point
  • scaleBy: "both" = ...

  Returns { x: number; y: number }

toRelPoint

• toRelPoint(
      pt: Geometry.Point,
      source?: "source" | "screen",
      kind?: "independent",
      clamped?: boolean,
  ): { x: number; y: number }

  Converts a point to a region-relative one.

  Parameters

  • pt: Geometry.Point
  • source: "source" | "screen" = ...
  • kind: "independent" = ...
  • clamped: boolean = true

  Returns { x: number; y: number }