Shape
Shape object. A shape object has following features:
- can be serialized (store and copy-paste)
- can have many children shapes
- can have multple scripts
- can have multiple constraints
- can have a manipulator
- has it’s own coordinate system (rotate)
Extends
Constructors
new Shape()
new Shape():
Shape
Returns
Overrides
Source
Properties
children
children:
Obj[]
Inherited from
Source
connectable
connectable:
boolean
Connectable flag
Source
constraints
constraints:
Constraint[]
Shape’s constraints
Source
containable
containable:
boolean
Containable flag
Source
containableFilter
containableFilter:
string
Containable filter
Source
description
description:
string
Description of the shape
Source
enable
enable:
boolean
Enable flag
Source
fillColor
fillColor:
string
Fill color
Source
fillStyle
fillStyle:
string
Fill style
Source
fontColor
fontColor:
string
Font color
Source
fontFamily
fontFamily:
string
Font family
Source
fontSize
fontSize:
number
Font size
Source
fontStyle
fontStyle:
string
Font style
Source
fontWeight
fontWeight:
number
Font weight
Source
height
height:
number
Shape’s height
Source
id
id:
string
Inherited from
Source
left
left:
number
Shape’s left position
Source
link
link:
string
Link
Source
movable
movable:
MovableEnum
Indicate how this shape can be moved
Source
name
name:
string
Name of the shape
Source
opacity
opacity:
number
Opacity
Source
parent
parent:
null|Obj
Inherited from
Source
properties
properties:
Property[]
Shape’s properties
Source
proto
proto:
boolean
The flag to indicate this shape is a prototype or not
Source
rotatable
rotatable:
boolean
Rotatable flag
Source
rotate
rotate:
number
Shape’s rotation angle (in degree)
Source
roughness
roughness:
number
Roughness
Source
scripts
scripts:
Script[]
Shape’s scripts
Source
sizable
sizable:
SizableEnum
Indicate how this shape can be resized
Source
strokeColor
strokeColor:
string
Stroke color
Source
strokePattern
strokePattern:
number[]
Stroke pattern
Source
strokeWidth
strokeWidth:
number
Stroke width
Source
tags
tags:
string[]
Tags
Source
top
top:
number
Shape’s top position
Source
type
type:
string
Inherited from
Source
visible
visible:
boolean
Visible flag
Source
width
width:
number
Shape’s width
Source
Accessors
bottom
getbottom():number
Returns
number
Source
right
getright():number
Returns
number
Source
Methods
assignStyles()
assignStyles(
canvas):void
Assign styles to memoization canvas.
Parameters
• canvas: MemoizationCanvas
Returns
void
Source
canContain()
canContain(
shape):boolean
Determine a given shape can be contained in this shape
Parameters
• shape: Shape
Returns
boolean
Source
containsPoint()
containsPoint(
canvas,point):boolean
Determines whether this shape contains a point in GCS
Parameters
• canvas: Canvas
• point: number[]
Returns
boolean
Source
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
Source
drawLink()
drawLink(
canvas,showDOM):void
Draw link
Parameters
• canvas: Canvas
• showDOM: boolean= false
Returns
void
Source
finalize()
finalize(
canvas):void
Finalize shape
Parameters
• canvas: Canvas
Returns
void
Source
find()
find(
pred):null|Obj
Find an shape in breath-first order
Parameters
• pred
Returns
null | Obj
Inherited from
Source
findAllByQuery()
findAllByQuery(
queryString):Shape[]
Find all shapes matched with the query string
Parameters
• queryString: string
Returns
Shape[]
Source
findByQuery()
findByQuery(
queryString):null|Shape
Find a shape first matched with the query string
Parameters
• queryString: any
Returns
null | Shape
Source
findDepthFirst()
findDepthFirst(
pred):null|Obj
Find an shape in depth-first order
Parameters
• pred
Returns
null | Obj
Inherited from
Source
findParent()
findParent(
pred):null|Obj
Find a shape along with the parent-chain
Parameters
• pred
Returns
null | Obj
Inherited from
Source
fromJSON()
fromJSON(
json):void
Import shape from JSON
Parameters
• json: any
Returns
void
Overrides
Source
getBoundingRect()
getBoundingRect(
includeAnchorPoints):number[][]
Return a bounding rect.
Parameters
• includeAnchorPoints: boolean= false
Returns
number[][]
Source
getCenter()
getCenter():
number[]
Returns the center point
Returns
number[]
Source
getChildrenBoundingRect()
getChildrenBoundingRect():
number[][]
Return a bounding box embracing children shapes
Returns
number[][]
Source
getEnclosure()
getEnclosure():
number[][]
Return a enclosure
Returns
number[][]
Source
getOutline()
getOutline():
number[][]
Return outline polygon.
Returns
number[][]
Source
getProperty()
getProperty(
name):any
Get a property object
Parameters
• name: string
Returns
any
Source
getPropertyValue()
getPropertyValue(
name):any
Get a property value
Parameters
• name: string
Returns
any
Source
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[][]
Source
getScript()
getScript(
id):undefined|string
Get a property object
Parameters
• id: string
Returns
undefined | string
Source
getSeed()
getSeed():
number
Returns
number
Source
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
Source
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[][]
Source
inGroup()
inGroup():
null|Obj
Return true if this shape is contained by a group (recursively)
Returns
null | Obj
Source
initialze()
initialze(
canvas):void
Initialize shape
Parameters
• canvas: Canvas
Returns
void
Source
isDescendant()
isDescendant(
obj):boolean
Test whether the given shape is a descendant
Parameters
• obj: Obj
Returns
boolean
Inherited from
Source
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[]
Source
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[]
Source
localTransform()
localTransform(
canvas,recursive):void
Transform local context to parent’s context
Parameters
• canvas: Canvas
• recursive: boolean= false
Returns
void
Source
match()
match(
query):boolean
Returns true if query matches this shape
Parameters
• query: object[]
Returns
boolean
Source
overlapRect()
overlapRect(
canvas,rect):boolean
Determines whether this shape overlaps a given rect
Parameters
• canvas: Canvas
• rect: number[][]
Returns
boolean
Source
parseQueryString()
parseQueryString(
queryString):any[]
Parse the query-string and returns a query object (JSON)
Query syntax:
e.g.) parseQuery(“@Box|NameText|@Text&#compartment”) —> [{_type: “Box”},{name: “NameText”},{_type: “Text”, tag:“compartment”}]
Parameters
• queryString: string
Returns
any[]
query object
Source
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
Source
renderDefault()
renderDefault(
canvas):void
Default render this shape
Parameters
• canvas: MemoizationCanvas
Returns
void
Source
renderOutline()
renderOutline(
canvas):void
Render this shape’s outline
Parameters
• canvas: MemoizationCanvas
Returns
void
Source
renderOutlineDefault()
renderOutlineDefault():
number[][]
Render default outline
Returns
number[][]
Source
resolveRefs()
resolveRefs(
idMap,nullIfNotFound):void
Resolve references
Parameters
• idMap: Record<string, Obj>
id to object map
• nullIfNotFound: boolean= false
assign null if not found
Returns
void
Inherited from
Source
toJSON()
toJSON(
recursive,keepRefs):any
Export shape to JSON
Parameters
• recursive: boolean= false
• keepRefs: boolean= false
Returns
any
Overrides
Source
traverse()
traverse(
fun,parent):void
Traverse all objects in breath-first order
Parameters
• fun
• parent: null | Obj= null
Returns
void
Inherited from
Source
traverseDepthFirst()
traverseDepthFirst(
fun,parent):void
Traverse all shapes in depth-first order
Parameters
• fun
• parent: null | Obj= null
Returns
void
Inherited from
Source
traverseDepthFirstSequence()
traverseDepthFirstSequence():
Obj[]
Returns an array of shapes in order of traverse sequence.
Returns
Obj[]
Inherited from
Obj.traverseDepthFirstSequence
Source
traverseSequence()
traverseSequence():
Obj[]
Returns an array of shapes in order of traverse sequence.
Returns
Obj[]
Inherited from
Source
update()
update(
canvas):void
Update shape
Parameters
• canvas: Canvas
Returns
void