Class Diagram

constructor

• new Diagram(
      type_: DiagramType,
      args?: {
          children?: Diagram[];
          foreignobjdata?: Partial<ForeignObjectData>;
          imgdata?: Partial<ImageData>;
          multilinedata?: Partial<MultilineTextData>;
          path?: Path;
          tags?: string[];
          textdata?: Partial<TextData>;
      },
  ): Diagram

  Parameters

  • type_: DiagramType
  • args: {
        children?: Diagram[];
        foreignobjdata?: Partial<ForeignObjectData>;
        imgdata?: Partial<ImageData>;
        multilinedata?: Partial<MultilineTextData>;
        path?: Path;
        tags?: string[];
        textdata?: Partial<TextData>;
    } = {}

  Returns Diagram

children

foreignobjdata

imgdata

multilinedata

mutable

origin

path

style

tags

textdata

type

add_points

• add_points(points: Vector2[]): Diagram

  Add points to the diagram if the diagram is a polygon or curve, add points to the path if the diagram is a diagram, add points to the last polygon or curve child

  Parameters

  • points: Vector2[]

    points to add

  Returns Diagram

append_tags

• append_tags(tags: string | string[]): Diagram

  Append tags to the diagram

  Parameters

  • tags: string | string[]

  Returns Diagram

apply

• apply(func: (d: Diagram) => Diagram): Diagram

  Apply a function to the diagram

  Parameters

  • func: (d: Diagram) => Diagram

    function to apply func takes in a diagram and returns a diagram

  Returns Diagram

apply_recursive

• apply_recursive(func: (d: Diagram) => Diagram): Diagram

  Apply a function to the diagram and all of its children recursively

  Parameters

  • func: (d: Diagram) => Diagram

    function to apply func takes in a diagram and returns a diagram

  Returns Diagram

apply_to_tagged_recursive

• apply_to_tagged_recursive(
      tags: string | string[],
      func: (d: Diagram) => Diagram,
  ): Diagram

  Apply a function to the diagram and all of its children recursively The function is only applied to the diagrams that contain a specific tag

  Parameters

  • tags: string | string[]

    the tag to filter the diagrams
  • func: (d: Diagram) => Diagram

    function to apply func takes in a diagram and returns a diagram

  Returns Diagram

bounding_box

• bounding_box(): [Vector2, Vector2]

  Get the bounding box of the diagram

  Returns [Vector2, Vector2]

  [min, max] where min is the top left corner and max is the bottom right corner

clone_style_from

• clone_style_from(diagram: Diagram): Diagram

  Parameters

  • diagram: Diagram

  Returns Diagram

combine

• combine(...diagrams: Diagram[]): Diagram

  Combine another diagram with this diagram

  Parameters

  • ...diagrams: Diagram[]

    a diagram or a list of diagrams

  Returns Diagram

contain_all_tags

• contain_all_tags(tags: string[]): boolean

  Parameters

  • tags: string[]

  Returns boolean

contain_tag

• contain_tag(tag: string): boolean

  Check if the diagram contains a tag

  Parameters

  • tag: string

  Returns boolean

copy

• copy(): Diagram

  Copy the diagram

  Returns Diagram

copy_if_not_mutable

• copy_if_not_mutable(): Diagram

  Returns Diagram

debug

• debug(show_index?: boolean): Diagram

  Parameters

  • show_index: boolean = true

  Returns Diagram

debug_bbox

• debug_bbox(): Diagram

  Returns Diagram

fill

• fill(color: string): Diagram

  Parameters

  • color: string

  Returns Diagram

filter

• filter(filter: string): Diagram

  Parameters

  • filter: string

  Returns Diagram

flatten

• flatten(): Diagram

  Flatten the children structure of the diagram so that the diagram only has one level of children * implemented for performance reason

  Returns Diagram

fontfamily

• fontfamily(fontfamily: string): Diagram

  Parameters

  • fontfamily: string

  Returns Diagram

fontscale

• fontscale(fontscale: number | "auto"): Diagram

  Parameters

  • fontscale: number | "auto"

  Returns Diagram

fontsize

• fontsize(fontsize: number): Diagram

  Parameters

  • fontsize: number

  Returns Diagram

fontstyle

• fontstyle(fontstyle: string): Diagram

  Parameters

  • fontstyle: string

  Returns Diagram

fontweight

• fontweight(
      fontweight: number | "bold" | "normal" | "bolder" | "lighter",
  ): Diagram

  Parameters

  • fontweight: number | "bold" | "normal" | "bolder" | "lighter"

  Returns Diagram

get_anchor

• get_anchor(anchor: Anchor): Vector2

  Get the position of the anchor of the diagram

  Parameters

  • anchor: Anchor

    anchor to get, anchors can be 'top-left', 'top-center', 'top-right' 'center-left', 'center-center', 'center-right' 'bottom-left', 'bottom-center', 'bottom-right'

  Returns Vector2

  the position of the anchor

get_tagged_elements

• get_tagged_elements(tags: string | string[]): Diagram[]

  Get all the diagrams that contain a specific tag

  Parameters

  • tags: string | string[]

    the tag to filter the diagrams

  Returns Diagram[]

  a list of diagrams

hflip

• hflip(a?: number): Diagram

  Horizontal flip Reflect the diagram over a vertical line x = a

  Parameters

  • Optionala: number

    x value of the line if left undefined, flip over the origin

  Returns Diagram

immut

• immut(): Diagram

  Create a copy of the diagram that is immutable

  Returns Diagram

is_empty

• is_empty(): boolean

  Returns boolean

move_origin

• move_origin(pos: Vector2 | Anchor): Diagram

  Move the origin of the diagram to a position or anchor

  Parameters

  • pos: Vector2 | Anchor

    position to move the origin to (Vector2), or anchor to move the origin to. anchors can be 'top-left', 'top-center', 'top-right' 'center-left', 'center-center', 'center-right' 'bottom-left', 'bottom-center', 'bottom-right'

    • for texts, use move_origin_text()

  Returns Diagram

move_origin_text

• move_origin_text(anchor: Anchor): Diagram

  Move the origin of text diagram to a position

  Parameters

  • anchor: Anchor

    anchor to move the origin to. anchors can be 'top-left', 'top-center', 'top-right' 'center-left', 'center-center', 'center-right' 'bottom-left', 'bottom-center', 'bottom-right'

  Returns Diagram

mut

• mut(): Diagram

  Turn the diagram into a mutable diagram

  Returns Diagram

mut_parent_only

• mut_parent_only(): Diagram

  Returns Diagram

opacity

• opacity(opacity: number): Diagram

  Parameters

  • opacity: number

  Returns Diagram

parametric_point

• parametric_point(t: number, segment_index?: number): Vector2

  Get the point on the path at t Path can be described parametrically in the form of (x(t), y(t)) Path starts at t=0 and ends at t=1

  Parameters

  • t: number

    parameter
  • Optionalsegment_index: number

    (only works for polygon and curves) If segment_index (n) is defined, get the point at the nth segment If segment_index (n) is defined, t can be outside of [0, 1] and will return the extrapolated point

  Returns Vector2

  the position of the point

path_length

• path_length(): number

  Returns number

position

• position(v?: Vector2): Diagram

  move the diagram to a position

  Parameters

  • v: Vector2 = ...

    position to move to (if left undefined, move to the origin)

  Returns Diagram

reflect

• reflect(p1?: Vector2, p2?: Vector2): Diagram

  Reflect the diagram if given 0 arguments, reflect over the origin if given 1 argument, reflect over a point p1 if given 2 arguments, reflect over a line defined by two points p1 and p2

  Parameters

  • Optionalp1: Vector2

    point
  • Optionalp2: Vector2

    point

  Returns Diagram

reflect_over_line

• reflect_over_line(p1: Vector2, p2: Vector2): Diagram

  Reflect the diagram over a line defined by two points

  Parameters

  • p1: Vector2

    point on the line
  • p2: Vector2

    point on the line

  Returns Diagram

reflect_over_point

• reflect_over_point(p: Vector2): Diagram

  Reflect the diagram over a point

  Parameters

  • p: Vector2

    point to reflect over

  Returns Diagram

remove_tags

• remove_tags(tags: string | string[]): Diagram

  Remove tags from the diagram

  Parameters

  • tags: string | string[]

  Returns Diagram

reset_tags

• reset_tags(): Diagram

  Reset all tags of the diagram

  Returns Diagram

reverse_path

• reverse_path(): Diagram

  Reverse the order of the points in the path

  Returns Diagram

rotate

• rotate(angle: number, pivot?: undefined | Vector2): Diagram

  Rotate the diagram by an angle around a pivot

  Parameters

  • angle: number

    angle to rotate
  • pivot: undefined | Vector2 = undefined

    pivot point, if left undefined, rotate around the origin

  Returns Diagram

scale

• scale(scale: number | Vector2, origin?: Vector2): Diagram

  Scale the diagram by a scale around a origin

  Parameters

  • scale: number | Vector2

    scale to scale (x, y)
  • Optionalorigin: Vector2

    origin point, if left undefined, scale around the origin

  Returns Diagram

scaletext

• scaletext(scale: number): Diagram

  Scale texts contained in the diagram by a scale

  Parameters

  • scale: number

    scaling factor

  Returns Diagram

skewX

• skewX(angle: number, base?: Vector2): Diagram

  Skew the diagram in the x direction by an angle around a base

  Parameters

  • angle: number

    angle to skew
  • Optionalbase: Vector2

    base point, if left undefined, skew around the origin

  Returns Diagram

skewY

• skewY(angle: number, base?: Vector2): Diagram

  Skew the diagram in the y direction by an angle around a base

  Parameters

  • angle: number

    angle to skew
  • Optionalbase: Vector2

    base point, if left undefined, skew around the origin

  Returns Diagram

stroke

• stroke(color: string): Diagram

  Parameters

  • color: string

  Returns Diagram

strokedasharray

• strokedasharray(dasharray: number[]): Diagram

  Parameters

  • dasharray: number[]

  Returns Diagram

strokelinecap

• strokelinecap(linecap: "butt" | "round" | "square"): Diagram

  Parameters

  • linecap: "butt" | "round" | "square"

  Returns Diagram

strokelinejoin

• strokelinejoin(
      linejoin: "round" | "arcs" | "bevel" | "miter" | "miter-clip",
  ): Diagram

  Parameters

  • linejoin: "round" | "arcs" | "bevel" | "miter" | "miter-clip"

  Returns Diagram

strokewidth

• strokewidth(width: number): Diagram

  Parameters

  • width: number

  Returns Diagram

text_totext

• text_totext(): Diagram

  Returns Diagram

text_tovar

• text_tovar(): Diagram

  Returns Diagram

textanchor

• textanchor(textanchor: "start" | "middle" | "end"): Diagram

  Parameters

  • textanchor: "start" | "middle" | "end"

  Returns Diagram

textangle

• textangle(angle: number): Diagram

  Parameters

  • angle: number

  Returns Diagram

textdy

• textdy(dy: string): Diagram

  Parameters

  • dy: string

  Returns Diagram

textfill

• textfill(color: string): Diagram

  Parameters

  • color: string

  Returns Diagram

textstroke

• textstroke(color: string): Diagram

  Parameters

  • color: string

  Returns Diagram

textstrokewidth

• textstrokewidth(width: number): Diagram

  Parameters

  • width: number

  Returns Diagram

to_curve

• to_curve(): Diagram

  Convert the diagram to a curve If the diagram is a polygon, convert it to a curve If the diagram is a Diagram, convert all of the children to curves

  Returns Diagram

to_polygon

• to_polygon(): Diagram

  Convert the diagram to a polygon If the diagram is a curve, convert it to a polygon If the diagram is a Diagram, convert all of the children to polygons

  Returns Diagram

transform

• transform(transform_function: (p: Vector2) => Vector2): Diagram

  Transform the diagram by a function

  Parameters

  • transform_function: (p: Vector2) => Vector2

    function to transform the diagram

  Returns Diagram

translate

• translate(v: Vector2): Diagram

  Translate the diagram by a vector

  Parameters

  • v: Vector2

    vector to translate

  Returns Diagram

vectoreffect

• vectoreffect(
      vectoreffect:
          | "none"
          | "non-scaling-stroke"
          | "non-scaling-size"
          | "non-rotation"
          | "fixed-position",
  ): Diagram

  Parameters

  • vectoreffect:
        | "none"
        | "non-scaling-stroke"
        | "non-scaling-size"
        | "non-rotation"
        | "fixed-position"

  Returns Diagram

vflip

• vflip(a?: number): Diagram

  Vertical flip Reflect the diagram over a horizontal line y = a

  Parameters

  • Optionala: number

    y value of the line if left undefined, flip over the origin

  Returns Diagram