Module shape-utils

BBox Functions

connectBBox

connectBBox(bbox: SimpleBBox): WorldPoint[]

连接包围盒

Parameters
- bbox: SimpleBBox
  
  简单包围盒
Returns WorldPoint[]
返回由该包围盒形成的多段线条

getBoundingData

getBoundingData(targets: WorldPoint[] | BrowserPoint[] | CanvasPoint[]): { height: number; maxX: number; maxY: number; minX: number; minY: number; width: number }

获取点列表的边界数据

Parameters
- targets: WorldPoint[] | BrowserPoint[] | CanvasPoint[]
  
  点列表
Returns { height: number; maxX: number; maxY: number; minX: number; minY: number; width: number }
- height: number
- maxX: number
- maxY: number
- minX: number
- minY: number
- width: number

mergeBBox

mergeBBox(bboxs: SimpleBBox[]): SimpleBBox

合并包围盒

Parameters
- bboxs: SimpleBBox[]
  
  包围盒列表，长度不为 0
Returns SimpleBBox

multsLineAndBBoxIsIntersect

multsLineAndBBoxIsIntersect(line: WorldPoint[], bbox: SimpleBBox): boolean

判断多段线条是否与范围的包围盒重叠

Parameters
- line: WorldPoint[]
  
  多段线条
- bbox: SimpleBBox
Returns boolean

twoBBoxIsOverlap

twoBBoxIsOverlap(box1: SimpleBBox, box2: SimpleBBox): boolean

判断两个包围盒是否有重叠的部分

Parameters
- box1: SimpleBBox
  
  包围盒1
- box2: SimpleBBox
  
  包围盒2
Returns boolean
是否重叠

twoBBoxLineIsIntersect

twoBBoxLineIsIntersect(bbox1: SimpleBBox, bbox2: SimpleBBox): boolean

判断两个包围盒的边线是否相交

Parameters
- bbox1: SimpleBBox
  
  包围盒1
- bbox2: SimpleBBox
  
  包围盒2
Returns boolean

woldPointsAtLastInBBox

woldPointsAtLastInBBox(points: WorldPoint[], bbox: SimpleBBox): boolean

判断点列表中是否至少存在一个点在包围盒中

Parameters
- points: WorldPoint[]
  
  点列表，传空数组时返回 false
- bbox: SimpleBBox
  
  包围盒
Returns boolean

worldPointIsInBBox

worldPointIsInBBox(point: WorldPoint, bbox: SimpleBBox): boolean

判断目标点是否在包围盒中

Parameters
- point: WorldPoint
  
  目标点
- bbox: SimpleBBox
  
  包围盒
Returns boolean

Compute Functions

computeDirectionForTwoPoint

computeDirectionForTwoPoint(start: WorldPoint, end: WorldPoint): PointDirection | undefined

获取起止坐标的方向

Parameters
- start: WorldPoint
  
  开始坐标
- end: WorldPoint
  
  结束坐标
Returns PointDirection | undefined

computeMultsLineLength

computeMultsLineLength(line: WorldPoint[]): number

计算多段线段的长度

Parameters
- line: WorldPoint[]
  
  多段线点列表
Returns number

computePointToSegmentLineDistance

computePointToSegmentLineDistance(point: WorldPoint, line: [start: WorldPoint, end: WorldPoint]): number

计算点到线段的距离

knowledge
海伦公式 + 三角形面积公式

Parameters
- point: WorldPoint
  
  目标点坐标
- line: [start: WorldPoint, end: WorldPoint]
  
  线段坐标
Returns number

computeRotateForTwoPoint

computeRotateForTwoPoint(start: WorldPoint, end: WorldPoint): number

根据起止坐标获取顺时针下的旋转角度（以弧度表示），起始：y正向，保留小数点后3位

Parameters
- start: WorldPoint
  
  开始坐标
- end: WorldPoint
  
  结束坐标
Returns number

computeThreeOrderBezier

computeThreeOrderBezier(t: number, p1: WorldPoint, cp1: WorldPoint, cp2: WorldPoint, p2: WorldPoint): WorldPoint

计算三阶贝塞尔曲线的坐标

knowledge
三阶贝塞尔曲线计算公式

Parameters
- t: number
  
  贝塞尔曲线百分比
- p1: WorldPoint
  
  开始点
- cp1: WorldPoint
  
  控制点1
- cp2: WorldPoint
  
  控制点2
- p2: WorldPoint
  
  结束点
Returns WorldPoint

computeTwoPointDistance

computeTwoPointDistance(start: WorldPoint, end: WorldPoint): number

计算两点之间的距离

Parameters
- start: WorldPoint
- end: WorldPoint
Returns number

Connect Functions

connectPolygon

connectPolygon(points: WorldPoint[]): WorldPoint[]

连接多边形的起止点

Parameters
- points: WorldPoint[]
  
  多边形路径点
Returns WorldPoint[]

connectRectPoints

connectRectPoints(points: [WorldPoint, WorldPoint]): WorldPoint[]

连接矩形的点列表

Parameters
- points: [WorldPoint, WorldPoint]
  
  点列表
Returns WorldPoint[]

Convert Functions

converPointsToCenter

converPointsToCenter(points: WorldPoint[]): WorldPoint[]

将世界坐标点列表转换成以图形中心为原点的列表

Parameters
- points: WorldPoint[]
  
  点列表
Returns WorldPoint[]

convertTrianglePoints

convertTrianglePoints(start: WorldPoint, end: WorldPoint): [p1: WorldPoint, p2: WorldPoint, p3: WorldPoint]

格式化三角形路径

Parameters
- start: WorldPoint
  
  开始点
- end: WorldPoint
  
  结束点
Returns [p1: WorldPoint, p2: WorldPoint, p3: WorldPoint]

getWorldPointsCenter

getWorldPointsCenter(points: WorldPoint[]): WorldPoint

获取点列表所构成的中心点坐标

Parameters
- points: WorldPoint[]
  
  世界坐标点列表
Returns WorldPoint

rotatePoints

rotatePoints(point: WorldPoint, center: WorldPoint, radian: number): WorldPoint
rotatePoints(points: WorldPoint[], center: WorldPoint, radian: number): WorldPoint[]

获取目标点以某个点为中心点，旋转指定角度后的坐标

Parameters
- point: WorldPoint
  
  目标点
- center: WorldPoint
  
  旋转中心点
- radian: number
  
  以弧度表示的角度
Returns WorldPoint
Parameters
- points: WorldPoint[]
- center: WorldPoint
- radian: number
Returns WorldPoint[]

Judge Functions

isEqualPoints

isEqualPoints(points: WorldPoint[]): boolean

判断点是否均为同一个点

Parameters
- points: WorldPoint[]
  
  点列表
Returns boolean

isNearbySegmentLine

isNearbySegmentLine(point: WorldPoint, line: [start: WorldPoint, end: WorldPoint], distance?: number): boolean

判断目标点是否靠近线段

Parameters
- point: WorldPoint
  
  目标点坐标
- line: [start: WorldPoint, end: WorldPoint]
  
  线段坐标
- distance: number = 1
  
  距离
Returns boolean

multsLineIsIntersect

multsLineIsIntersect(multistage1: WorldPoint[], multistage2: WorldPoint[]): boolean

判断两条多段线条是否相交

Parameters
- multistage1: WorldPoint[]
  
  多段线条1
- multistage2: WorldPoint[]
  
  多段线条2
Returns boolean

pointAtLintLeftOrRight

pointAtLintLeftOrRight(point: WorldPoint, line: [start: WorldPoint, end: WorldPoint]): 0 | 1 | -1

判断点在有向线段的左侧还是右侧

knowledge
向量叉乘

Parameters
- point: WorldPoint
  
  目标点坐标
- line: [start: WorldPoint, end: WorldPoint]
  
  线段坐标
Returns 0 | 1 | -1
-1：点在线段右侧，0：点在线段上，1：点在线段左侧

pointIsNearbyMultsLine

pointIsNearbyMultsLine(point: WorldPoint, line: WorldPoint[], distance?: number): boolean

判断目标点是否靠近线条

Parameters
- point: WorldPoint
  
  目标点坐标
- line: WorldPoint[]
  
  线条坐标
- distance: number = 1
  
  距离
Returns boolean

segmentAndMultsIsIntersect

segmentAndMultsIsIntersect(target: [start: WorldPoint, end: WorldPoint], multistage: WorldPoint[]): boolean

判断线段是否与一条多段的线段相交

Parameters
- target: [start: WorldPoint, end: WorldPoint]
  
  目标线段
- multistage: WorldPoint[]
  
  多段线段
Returns boolean

twoSegmentLineIsIntersect

twoSegmentLineIsIntersect(line1: [start: WorldPoint, end: WorldPoint], line2: [start: WorldPoint, end: WorldPoint]): boolean

判断两条线段是否相交

Parameters
- line1: [start: WorldPoint, end: WorldPoint]
  
  线条1
- line2: [start: WorldPoint, end: WorldPoint]
  
  线条2
Returns boolean

Other Functions

deviationPoints

deviationPoints<T>(points: T, diffX: number, diffY: number): T

获取点列表偏移后的点

Type parameters
- T: WorldPoint[] = WorldPoint[]
Parameters
- points: T
  
  点列表
- diffX: number
  
  x坐标偏移量
- diffY: number
  
  y坐标偏移量
Returns T

reverseShapeSeatZoomData

reverseShapeSeatZoomData(data: ShapeSeatZoomData): ShapeSeatZoomData

反向转换位置缩放数据

Parameters
- data: ShapeSeatZoomData
  
  位置缩放数据
Returns ShapeSeatZoomData

zoomSeatPoints

zoomSeatPoints<T>(points: T, data: ShapeSeatZoomData): T

获取位置缩放之后的点列表

Type parameters
- T: WorldPoint[] = WorldPoint[]
Parameters
- points: T
  
  点列表
- data: ShapeSeatZoomData
  
  位置缩放数据
Returns T

Progress Functions

getPolygonProgressPoint

getPolygonProgressPoint(line: WorldPoint[], progress: number, close?: boolean): WorldPoint[]

计算多边形动画进度

Parameters
- line: WorldPoint[]
  
  多边形点列表
- progress: number
  
  进度
- close: boolean = false
  
  是否闭合线段
Returns WorldPoint[]

getProgressPoint

getProgressPoint(start: WorldPoint, end: WorldPoint, progress: number): [start: WorldPoint, end: WorldPoint]

获取简单的起止点动画进度计算后的数值

Parameters
- start: WorldPoint
  
  开始点
- end: WorldPoint
  
  结束点
- progress: number
  
  进度
Returns [start: WorldPoint, end: WorldPoint]

getSimpleProgressPoint

getSimpleProgressPoint(start: CanvasPoint, end: CanvasPoint, progress: number): [start: CanvasPoint, end: CanvasPoint]

获取简单的起止点动画进度计算后的数值

Parameters
- start: CanvasPoint
  
  开始点
- end: CanvasPoint
  
  结束点
- progress: number
  
  进度
Returns [start: CanvasPoint, end: CanvasPoint]