Skip to content

Line

Line shape

Extends

Constructors

new Line()

new Line(): Line

Returns

Line

Overrides

Path.constructor

Source

shapes.ts:2271

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:213


constraints

constraints: Constraint[]

Shape’s constraints

Inherited from

Path.constraints

Source

shapes.ts:328


containable

containable: boolean

Containable flag

Inherited from

Path.containable

Source

shapes.ts:203


containableFilter

containableFilter: string

Containable filter

Inherited from

Path.containableFilter

Source

shapes.ts:208


description

description: string

Description of the shape

Inherited from

Path.description

Source

shapes.ts:163


enable

enable: boolean

Enable flag

Inherited from

Path.enable

Source

shapes.ts:178


fillColor

fillColor: string

Fill color

Inherited from

Path.fillColor

Source

shapes.ts:258


fillStyle

fillStyle: string

Fill style

Inherited from

Path.fillStyle

Source

shapes.ts:263


fontColor

fontColor: string

Font color

Inherited from

Path.fontColor

Source

shapes.ts:268


fontFamily

fontFamily: string

Font family

Inherited from

Path.fontFamily

Source

shapes.ts:273


fontSize

fontSize: number

Font size

Inherited from

Path.fontSize

Source

shapes.ts:278


fontStyle

fontStyle: string

Font style

Inherited from

Path.fontStyle

Source

shapes.ts:283


fontWeight

fontWeight: number

Font weight

Inherited from

Path.fontWeight

Source

shapes.ts:288


headEndType

headEndType: LineEndTypeEnum

Source

shapes.ts:2268


height

height: number

Shape’s height

Inherited from

Path.height

Source

shapes.ts:233


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:218


lineType

lineType: LineTypeEnum

Source

shapes.ts:2267


link: string

Link

Inherited from

Path.link

Source

shapes.ts:318


movable

movable: MovableEnum

Indicate how this shape can be moved

Inherited from

Path.movable

Source

shapes.ts:188


name

name: string

Name of the shape

Inherited from

Path.name

Source

shapes.ts:158


opacity

opacity: number

Opacity

Inherited from

Path.opacity

Source

shapes.ts:293


parent

parent: null | Obj

Inherited from

Path.parent

Source

core/obj.ts:13


path

path: number[][]

Inherited from

Path.path

Source

shapes.ts:1825


pathEditable

pathEditable: boolean

Inherited from

Path.pathEditable

Source

shapes.ts:1824


properties

properties: Property[]

Shape’s properties

Inherited from

Path.properties

Source

shapes.ts:333


proto

proto: boolean

The flag to indicate this shape is a prototype or not

Inherited from

Path.proto

Source

shapes.ts:168


reference

reference: null | Shape

A reference to shape

Inherited from

Path.reference

Source

shapes.ts:323


rotatable

rotatable: boolean

Rotatable flag

Inherited from

Path.rotatable

Source

shapes.ts:198


rotate

rotate: number

Shape’s rotation angle (in degree)

Inherited from

Path.rotate

Source

shapes.ts:238


roughness

roughness: number

Roughness

Inherited from

Path.roughness

Source

shapes.ts:298


scripts

scripts: Script[]

Shape’s scripts

Inherited from

Path.scripts

Source

shapes.ts:338


shadow

shadow: boolean

Shadow

Inherited from

Path.shadow

Source

shapes.ts:303


shadowColor

shadowColor: string

Shadow color

Inherited from

Path.shadowColor

Source

shapes.ts:308


shadowOffset

shadowOffset: number[]

Shadow offset

Inherited from

Path.shadowOffset

Source

shapes.ts:313


sizable

sizable: SizableEnum

Indicate how this shape can be resized

Inherited from

Path.sizable

Source

shapes.ts:193


strokeColor

strokeColor: string

Stroke color

Inherited from

Path.strokeColor

Source

shapes.ts:243


strokePattern

strokePattern: number[]

Stroke pattern

Inherited from

Path.strokePattern

Source

shapes.ts:253


strokeWidth

strokeWidth: number

Stroke width

Inherited from

Path.strokeWidth

Source

shapes.ts:248


tags

tags: string[]

Tags

Inherited from

Path.tags

Source

shapes.ts:173


tailEndType

tailEndType: LineEndTypeEnum

Source

shapes.ts:2269


top

top: number

Shape’s top position

Inherited from

Path.top

Source

shapes.ts:223


type

type: string

Inherited from

Path.type

Source

core/obj.ts:12


visible

visible: boolean

Visible flag

Inherited from

Path.visible

Source

shapes.ts:183


width

width: number

Shape’s width

Inherited from

Path.width

Source

shapes.ts:228

Accessors

bottom

get bottom(): number

Returns

number

Source

shapes.ts:527


get right(): number

Returns

number

Source

shapes.ts:523

Methods

assignStyles()

assignStyles(canvas): void

Assign styles to memoization canvas.

Parameters

canvas: MemoizationCanvas

Returns

void

Inherited from

Path.assignStyles

Source

shapes.ts:617


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:1066


computeOpacity()

computeOpacity(): number

Returns

number

Inherited from

Path.computeOpacity

Source

shapes.ts:607


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:1869


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:760


drawLink(canvas, showDOM): void

Draw link

Parameters

canvas: Canvas

showDOM: boolean= false

Returns

void

Inherited from

Path.drawLink

Source

shapes.ts:774


finalize()

finalize(canvas): void

Finalize shape

Parameters

canvas: Canvas

Returns

void

Inherited from

Path.finalize

Source

shapes.ts:547


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:1056


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:1043


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:2288


getBoundingRect()

getBoundingRect(includeAnchorPoints): number[][]

Return a bounding rect.

Parameters

includeAnchorPoints: boolean= false

Returns

number[][]

Inherited from

Path.getBoundingRect

Source

shapes.ts:821


getCenter()

getCenter(): number[]

Returns the center point

Returns

number[]

Inherited from

Path.getCenter

Source

shapes.ts:814


getChildrenBoundingRect()

getChildrenBoundingRect(): number[][]

Return a bounding box embracing children shapes

Returns

number[][]

Inherited from

Path.getChildrenBoundingRect

Source

shapes.ts:879


getEnclosure()

getEnclosure(): number[][]

Return a enclosure

Returns

number[][]

Inherited from

Path.getEnclosure

Source

shapes.ts:913


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:1860


getOutline()

getOutline(): number[][]

Return outline polygon.

Returns

number[][]

Inherited from

Path.getOutline

Source

shapes.ts:749


getPage()

getPage(): null | Page

Return the page that contains this shape

Returns

null | Page

Inherited from

Path.getPage

Source

shapes.ts:519


getProperty()

getProperty(name): any

Get a property object

Parameters

name: string

Returns

any

Inherited from

Path.getProperty

Source

shapes.ts:1078


getPropertyValue()

getPropertyValue(name): any

Get a property value

Parameters

name: string

Returns

any

Inherited from

Path.getPropertyValue

Source

shapes.ts:1088


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:892


getScript()

getScript(id): undefined | string

Get a property object

Parameters

id: string

Returns

undefined | string

Inherited from

Path.getScript

Source

shapes.ts:1096


getSeed()

getSeed(): number

Return the seed number

Returns

number

Inherited from

Path.getSeed

Source

shapes.ts:534


getShapeAt()

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

Pick a shape at specific position (x, y)

Parameters

canvas: Canvas

point: number[]

exceptions: Shape[]= []

allowDisabledAndInvisible: boolean= false

Returns

null | Shape

Inherited from

Path.getShapeAt

Source

shapes.ts:567


getViewport()

getViewport(canvas): number[][]

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

Parameters

canvas: Canvas

Returns

number[][]

Inherited from

Path.getViewport

Source

shapes.ts:869


initialze()

initialze(canvas): void

Initialize shape

Parameters

canvas: Canvas

Returns

void

Inherited from

Path.initialze

Source

shapes.ts:542


isClosed()

isClosed(): boolean

Return is the path is closed

Returns

boolean

Inherited from

Path.isClosed

Source

shapes.ts:1851


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:653


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:673


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:637


match()

match(query): boolean

Returns true if query matches this shape

Parameters

query: object[]

Returns

boolean

Inherited from

Path.match

Source

shapes.ts:1018


overlapClippingArea()

overlapClippingArea(canvas, rect): boolean

Determines whether the given rect overlaps this shape’s clipping area. If the shape don’t have clipping area, return true. If the shape has clipping area, return true if the rect overlaps the clipping area. (e.g. Frame)

Parameters

canvas: Canvas

rect: number[][]

Returns

boolean

Inherited from

Path.overlapClippingArea

Source

shapes.ts:949


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:1892


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:993


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:696


renderDefault()

renderDefault(canvas): void

Draw this shape

Parameters

canvas: MemoizationCanvas

Returns

void

Overrides

Path.renderDefault

Source

shapes.ts:2298


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:2344


renderOutline()

renderOutline(canvas): void

Render this shape’s outline

Parameters

canvas: MemoizationCanvas

Returns

void

Inherited from

Path.renderOutline

Source

shapes.ts:721


renderOutlineDefault()

renderOutlineDefault(canvas): number[][]

Return default outline

Parameters

canvas: MemoizationCanvas

Returns

number[][]

Overrides

Path.renderOutlineDefault

Source

shapes.ts:2525


renderShadow()

renderShadow(canvas): void

Render shadow

Parameters

canvas: MemoizationCanvas

Returns

void

Overrides

Path.renderShadow

Source

shapes.ts:2552


renderViewport()

renderViewport(canvas): void

Return this shape’s viewport

Parameters

canvas: MemoizationCanvas

Returns

void

Inherited from

Path.renderViewport

Source

shapes.ts:831


renderViewportDefault()

renderViewportDefault(canvas): number[][]

Render default viewport

Parameters

canvas: MemoizationCanvas

Returns

number[][]

Overrides

Path.renderViewportDefault

Source

shapes.ts:2538


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:505


toJSON()

toJSON(recursive, keepRefs): any

Export shape to JSON

Parameters

recursive: boolean= false

keepRefs: boolean= false

Returns

any

Overrides

Path.toJSON

Source

shapes.ts:2280


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:557


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:596