Skip to content

Line

Line shape

Extends

Constructors

new Line()

new Line(): Line

Returns

Line

Overrides

Path.constructor

Source

shapes.ts:1742

Properties

children

children: Obj[]

Inherited from

Path.children

Source

core/obj.ts:14


connectable

connectable: boolean

Connectable flag

Inherited from

Path.connectable

Source

shapes.ts:198


constraints

constraints: Constraint[]

Shape’s constraints

Inherited from

Path.constraints

Source

shapes.ts:298


containable

containable: boolean

Containable flag

Inherited from

Path.containable

Source

shapes.ts:188


containableFilter

containableFilter: string

Containable filter

Inherited from

Path.containableFilter

Source

shapes.ts:193


description

description: string

Description of the shape

Inherited from

Path.description

Source

shapes.ts:148


enable

enable: boolean

Enable flag

Inherited from

Path.enable

Source

shapes.ts:163


fillColor

fillColor: string

Fill color

Inherited from

Path.fillColor

Source

shapes.ts:243


fillStyle

fillStyle: string

Fill style

Inherited from

Path.fillStyle

Source

shapes.ts:248


fontColor

fontColor: string

Font color

Inherited from

Path.fontColor

Source

shapes.ts:253


fontFamily

fontFamily: string

Font family

Inherited from

Path.fontFamily

Source

shapes.ts:258


fontSize

fontSize: number

Font size

Inherited from

Path.fontSize

Source

shapes.ts:263


fontStyle

fontStyle: string

Font style

Inherited from

Path.fontStyle

Source

shapes.ts:268


fontWeight

fontWeight: number

Font weight

Inherited from

Path.fontWeight

Source

shapes.ts:273


headEndType

headEndType: LineEndTypeEnum

Source

shapes.ts:1739


height

height: number

Shape’s height

Inherited from

Path.height

Source

shapes.ts:218


id

id: string

Inherited from

Path.id

Source

core/obj.ts:11


left

left: number

Shape’s left position

Inherited from

Path.left

Source

shapes.ts:203


lineType

lineType: LineTypeEnum

Source

shapes.ts:1738


link: string

Link

Inherited from

Path.link

Source

shapes.ts:288


movable

movable: MovableEnum

Indicate how this shape can be moved

Inherited from

Path.movable

Source

shapes.ts:173


name

name: string

Name of the shape

Inherited from

Path.name

Source

shapes.ts:143


opacity

opacity: number

Opacity

Inherited from

Path.opacity

Source

shapes.ts:278


parent

parent: null | Obj

Inherited from

Path.parent

Source

core/obj.ts:13


path

path: number[][]

Inherited from

Path.path

Source

shapes.ts:1473


pathEditable

pathEditable: boolean

Inherited from

Path.pathEditable

Source

shapes.ts:1472


properties

properties: Property[]

Shape’s properties

Inherited from

Path.properties

Source

shapes.ts:303


proto

proto: boolean

The flag to indicate this shape is a prototype or not

Inherited from

Path.proto

Source

shapes.ts:153


reference

reference: null | Shape

A reference to shape

Inherited from

Path.reference

Source

shapes.ts:293


rotatable

rotatable: boolean

Rotatable flag

Inherited from

Path.rotatable

Source

shapes.ts:183


rotate

rotate: number

Shape’s rotation angle (in degree)

Inherited from

Path.rotate

Source

shapes.ts:223


roughness

roughness: number

Roughness

Inherited from

Path.roughness

Source

shapes.ts:283


scripts

scripts: Script[]

Shape’s scripts

Inherited from

Path.scripts

Source

shapes.ts:308


sizable

sizable: SizableEnum

Indicate how this shape can be resized

Inherited from

Path.sizable

Source

shapes.ts:178


strokeColor

strokeColor: string

Stroke color

Inherited from

Path.strokeColor

Source

shapes.ts:228


strokePattern

strokePattern: number[]

Stroke pattern

Inherited from

Path.strokePattern

Source

shapes.ts:238


strokeWidth

strokeWidth: number

Stroke width

Inherited from

Path.strokeWidth

Source

shapes.ts:233


tags

tags: string[]

Tags

Inherited from

Path.tags

Source

shapes.ts:158


tailEndType

tailEndType: LineEndTypeEnum

Source

shapes.ts:1740


top

top: number

Shape’s top position

Inherited from

Path.top

Source

shapes.ts:208


type

type: string

Inherited from

Path.type

Source

core/obj.ts:12


visible

visible: boolean

Visible flag

Inherited from

Path.visible

Source

shapes.ts:168


width

width: number

Shape’s width

Inherited from

Path.width

Source

shapes.ts:213

Accessors

bottom

get bottom(): number

Returns

number

Source

shapes.ts:472


get right(): number

Returns

number

Source

shapes.ts:468

Methods

assignStyles()

assignStyles(canvas): void

Assign styles to memoization canvas.

Parameters

canvas: MemoizationCanvas

Returns

void

Inherited from

Path.assignStyles

Source

shapes.ts:550


canContain()

canContain(shape): boolean

Determine a given shape can be contained in this shape

Parameters

shape: Shape

Returns

boolean

Inherited from

Path.canContain

Source

shapes.ts:942


computeOpacity()

computeOpacity(): number

Returns

number

Inherited from

Path.computeOpacity

Source

shapes.ts:540


containsPoint()

containsPoint(canvas, point): boolean

Determines whether this shape contains a point in GCS

Parameters

canvas: Canvas

point: number[]

Returns

boolean

Inherited from

Path.containsPoint

Source

shapes.ts:1517


draw()

draw(canvas, showDOM): void

Draw this shape

Render vs Draw

  • Render: computing geometries how to draw the shape
  • Draw: actual drawing the computed geometries of the shape on the canvas

Parameters

canvas: Canvas

showDOM: boolean= false

Returns

void

Inherited from

Path.draw

Source

shapes.ts:685


drawLink(canvas, showDOM): void

Draw link

Parameters

canvas: Canvas

showDOM: boolean= false

Returns

void

Inherited from

Path.drawLink

Source

shapes.ts:699


finalize()

finalize(canvas): void

Finalize shape

Parameters

canvas: Canvas

Returns

void

Inherited from

Path.finalize

Source

shapes.ts:489


find()

find(pred): null | Obj

Find an shape in breath-first order

Parameters

pred

Returns

null | Obj

Inherited from

Path.find

Source

core/obj.ts:106


findAllByQuery()

findAllByQuery(queryString): Shape[]

Find all shapes matched with the query string

Parameters

queryString: string

Returns

Shape[]

Inherited from

Path.findAllByQuery

Source

shapes.ts:932


findByQuery()

findByQuery(queryString): null | Shape

Find a shape first matched with the query string

Parameters

queryString: any

Returns

null | Shape

Inherited from

Path.findByQuery

Source

shapes.ts:919


findDepthFirst()

findDepthFirst(pred): null | Obj

Find an shape in depth-first order

Parameters

pred

Returns

null | Obj

Inherited from

Path.findDepthFirst

Source

core/obj.ts:119


findParent()

findParent(pred): null | Obj

Find a shape along with the parent-chain

Parameters

pred

Returns

null | Obj

Inherited from

Path.findParent

Source

core/obj.ts:132


fromJSON()

fromJSON(json): void

Import shape from JSON

Parameters

json: any

Returns

void

Overrides

Path.fromJSON

Source

shapes.ts:1759


getBoundingRect()

getBoundingRect(includeAnchorPoints): number[][]

Return a bounding rect.

Parameters

includeAnchorPoints: boolean= false

Returns

number[][]

Inherited from

Path.getBoundingRect

Source

shapes.ts:746


getCenter()

getCenter(): number[]

Returns the center point

Returns

number[]

Inherited from

Path.getCenter

Source

shapes.ts:739


getChildrenBoundingRect()

getChildrenBoundingRect(): number[][]

Return a bounding box embracing children shapes

Returns

number[][]

Inherited from

Path.getChildrenBoundingRect

Source

shapes.ts:772


getEnclosure()

getEnclosure(): number[][]

Return a enclosure

Returns

number[][]

Inherited from

Path.getEnclosure

Source

shapes.ts:806


getEndSegment()

getEndSegment(isHead): number[][]

Return a segment of an end

Parameters

isHead: boolean

Returns

number[][]

segment line to end

Inherited from

Path.getEndSegment

Source

shapes.ts:1508


getOutline()

getOutline(): number[][]

Return outline polygon.

Returns

number[][]

Inherited from

Path.getOutline

Source

shapes.ts:674


getProperty()

getProperty(name): any

Get a property object

Parameters

name: string

Returns

any

Inherited from

Path.getProperty

Source

shapes.ts:954


getPropertyValue()

getPropertyValue(name): any

Get a property value

Parameters

name: string

Returns

any

Inherited from

Path.getPropertyValue

Source

shapes.ts:964


getRectInDCS()

getRectInDCS(canvas, includeAnchorPoints): number[][]

Return a bounding box in DOM coord.

[Note] If you want to place DOM elements over the canvas, use this method. and don’t forget to apply transform scale to the DOM element.

Parameters

canvas: Canvas

includeAnchorPoints: boolean= false

Returns

number[][]

Inherited from

Path.getRectInDCS

Source

shapes.ts:785


getScript()

getScript(id): undefined | string

Get a property object

Parameters

id: string

Returns

undefined | string

Inherited from

Path.getScript

Source

shapes.ts:972


getSeed()

getSeed(): number

Returns

number

Inherited from

Path.getSeed

Source

shapes.ts:476


getShapeAt()

getShapeAt(canvas, point, exceptions): null | Shape

Pick a shape at specific position (x, y)

Parameters

canvas: Canvas

point: number[]

exceptions: Shape[]= []

Returns

null | Shape

Inherited from

Path.getShapeAt

Source

shapes.ts:509


getViewRect()

getViewRect(canvas): number[][]

Return a view rect in GCS. View rect is a rect that includes actually drawn area which includes stroke width, arrowheads, etc. So view rect is mostly larger than bounding rect.

Parameters

canvas: Canvas

Returns

number[][]

Overrides

Path.getViewRect

Source

shapes.ts:2011


initialze()

initialze(canvas): void

Initialize shape

Parameters

canvas: Canvas

Returns

void

Inherited from

Path.initialze

Source

shapes.ts:484


isClosed()

isClosed(): boolean

Return is the path is closed

Returns

boolean

Inherited from

Path.isClosed

Source

shapes.ts:1499


isDescendant()

isDescendant(obj): boolean

Test whether the given shape is a descendant

Parameters

obj: Obj

Returns

boolean

Inherited from

Path.isDescendant

Source

core/obj.ts:142


localCoordTransform()

localCoordTransform(canvas, point, recursive): number[]

Transform local coord to parent’s coord (LCS —> parent’s LCS) if recursive=true, transform to GCS (Global coord-system).

Parameters

canvas: Canvas

point: number[]

recursive: boolean= false

Returns

number[]

Inherited from

Path.localCoordTransform

Source

shapes.ts:586


localCoordTransformRev()

localCoordTransformRev(canvas, point, recursive): number[]

Transform parent’s coord to local coord (parent’s LCS —> LCS) if recursive=true, transform GCS (Global coord-system) —> LCS.

Parameters

canvas: Canvas

point: number[]

recursive: boolean= false

Returns

number[]

Inherited from

Path.localCoordTransformRev

Source

shapes.ts:606


localTransform()

localTransform(canvas, recursive): void

Transform local context to parent’s context

Parameters

canvas: Canvas

recursive: boolean= false

Returns

void

Inherited from

Path.localTransform

Source

shapes.ts:570


match()

match(query): boolean

Returns true if query matches this shape

Parameters

query: object[]

Returns

boolean

Inherited from

Path.match

Source

shapes.ts:894


overlapRect()

overlapRect(canvas, rect): boolean

Determines whether this shape overlaps a given rect

Parameters

canvas: Canvas

rect: number[][]

Returns

boolean

Inherited from

Path.overlapRect

Source

shapes.ts:1540


parseQueryString()

parseQueryString(queryString): any[]

Parse the query-string and returns a query object (JSON)

Query syntax: = [”|” ]* = [”&” ]* = | = e.g.) OuterBox, NameText, … = ”@” e.g.) @Box, @Text, @Line, … = ”#” e.g.) #label, #compartment, …

e.g.) parseQuery(“@Box|NameText|@Text&#compartment”) —> [{_type: “Box”},{name: “NameText”},{_type: “Text”, tag:“compartment”}]

Parameters

queryString: string

Returns

any[]

query object

Inherited from

Path.parseQueryString

Source

shapes.ts:869


render()

render(canvas): void

Render this shape

Render vs Draw

  • Render: computing geometries how to draw the shape
  • Draw: actual drawing the computed geometries of the shape on the canvas

Parameters

canvas: MemoizationCanvas

Returns

void

Inherited from

Path.render

Source

shapes.ts:629


renderDefault()

renderDefault(canvas): void

Draw this shape

Parameters

canvas: MemoizationCanvas

Returns

void

Overrides

Path.renderDefault

Source

shapes.ts:1769


renderLineEnd()

renderLineEnd(canvas, edgeEndType, isHead): number[]

Draw line end types. All line-ends are drawn based on the point grid as below:

0 1 2 3 4 5 6 7 8 9 10

0 • • • • • • • • • • • 1 • • • • • • • • • • • 2 • • • • • • • • • • • 3 HEAD •-•-•-•-•-•-•-•-•-•-•---------- TAIL 4 • • • • • • • • • • • 5 • • • • • • • • • • • 6 • • • • • • • • • • •

Parameters

canvas: MemoizationCanvas

edgeEndType: string

isHead: boolean

Returns

number[]

an end point the path should be drawn to

Source

shapes.ts:1814


renderOutline()

renderOutline(canvas): void

Render this shape’s outline

Parameters

canvas: MemoizationCanvas

Returns

void

Inherited from

Path.renderOutline

Source

shapes.ts:652


renderOutlineDefault()

renderOutlineDefault(): number[][]

Return default outline

Returns

number[][]

Overrides

Path.renderOutlineDefault

Source

shapes.ts:1995


resolveRefs()

resolveRefs(idMap, nullIfNotFound): void

Resolve references

Parameters

idMap: Record<string, Shape>

id to object map

nullIfNotFound: boolean= false

assign null if not found

Returns

void

Inherited from

Path.resolveRefs

Source

shapes.ts:457


toJSON()

toJSON(recursive, keepRefs): any

Export shape to JSON

Parameters

recursive: boolean= false

keepRefs: boolean= false

Returns

any

Overrides

Path.toJSON

Source

shapes.ts:1751


traverse()

traverse(fun, parent): void

Traverse all objects in breath-first order

Parameters

fun

parent: null | Obj= null

Returns

void

Inherited from

Path.traverse

Source

core/obj.ts:60


traverseDepthFirst()

traverseDepthFirst(fun, parent): void

Traverse all shapes in depth-first order

Parameters

fun

parent: null | Obj= null

Returns

void

Inherited from

Path.traverseDepthFirst

Source

core/obj.ts:74


traverseDepthFirstSequence()

traverseDepthFirstSequence(): Obj[]

Returns an array of shapes in order of traverse sequence.

Returns

Obj[]

Inherited from

Path.traverseDepthFirstSequence

Source

core/obj.ts:97


traverseSequence()

traverseSequence(): Obj[]

Returns an array of shapes in order of traverse sequence.

Returns

Obj[]

Inherited from

Path.traverseSequence

Source

core/obj.ts:88


update()

update(canvas): void

Update shape

Parameters

canvas: Canvas

Returns

void

Inherited from

Path.update

Source

shapes.ts:499


visit()

visit(fun, parent): void

Visit all shapes in breath-first order. The difference from traverse() is that each shape determine visit into children or not. (e.g. Group and Frame doens’t visit into children)

Parameters

fun

parent: null | Shape= null

Returns

void

Inherited from

Path.visit

Source

shapes.ts:529