# 草图模块

# 模块名称： Sketch

# 创建草图

接口名称： createSketch
输入参数：

参数名称 参数含义 类型 必须 参数值说明
sketchName 草图的特征名 整型 是
planeId 绘制草图的平面ID 整型 是 默认前视基准面

返回值： NULL

//示例程序
 Sketch.createSketch('sketchName', 8);
1
2

# 编辑草图

接口名称： editSketch
输入参数：

参数名称 参数含义 类型 必须 参数值说明
sketchName 草图的特征名 整型 是

返回值： NULL

//示例程序
 Sketch.editSketch('sketchName');
1
2

# 退出草图

接口名称： exitSketch
输入参数： 空
返回值： NULL

//示例程序
 Sketch.exitSketch();
1
2

# 退出编辑草图

接口名称： exitEditSketch
输入参数：

参数名称 参数含义 类型 必须 参数值说明
sketchName 草图的特征名 整型 是

返回值： NULL

//示例程序
 Sketch.exitEditSketch('sketchName');
1
2

# 直线

  • 创建直线

接口名称： createLine
输入参数：

参数名称 参数含义 类型 必须 参数值说明
StartPnt 线的起点 点Point 是
EndPnt 线的终点 点Point 是
DimensionType 尺寸约束类型 整型 否 0 无尺寸约束 默认
1 添加长度约束

返回值： NULL

//示例程序
 Sketch.createLine(startPnt, endPnt);
1
2
  • 创建参考直线

接口名称： createReferenceLine
输入参数：

参数名称 参数含义 类型 必须 参数值说明
StartPnt 线的起点 点Point 是
EndPnt 线的终点 点Point 是

返回值： NULL

//示例程序
 Sketch.createReferenceLine(startPnt, endPnt);
1
2

# 矩形

  • 拐角矩形: 根据两个边角点，创建矩形

接口名称： createRectangle
输入参数：

参数名称 参数含义 类型 必须 参数值说明
startPnt 矩形的起点 点Point 是
endPnt 矩形的终点 点Point 是
dimensionType 尺寸类型 整型 否 0 无 默认
1 水平线长度约束
2 竖直线距离约束
3 水平+竖直线约束

返回值： NULL

//示例程序
 Sketch.createRectangle(startPnt, endPnt, dimensionType);
1
2
  • 中心点矩形: 根据中心点，创建矩形

接口名称： createRectangleByCenter
输入参数：

参数名称 参数含义 类型 必须 参数值说明
centerPnt 矩形的中心点 点Point 是
endPnt 矩形的终点 点Point 是
dimensionType 尺寸类型 整型 否 0 无 默认
1 水平线长度约束
2 竖直线距离约束
3 水平+竖直线约束

返回值： NULL

//示例程序
 Sketch.createRectangleByCenter(centerPnt, endPnt, dimensionType);
1
2

# 圆

  • 两点圆: 根据圆心和圆上一点绘制圆

接口名称： createCircle
输入参数:

参数名称 参数含义 类型 必须 参数值说明
centerPnt 圆的中心点 点Point 是
circlePnt 圆上一点 点Point 是
dimensionType 圆尺寸约束 整型 否 0 无尺寸约束 默认
1 半径约束

返回值： NULL

//示例程序
 Sketch.createCircle(centerPnt, circlePnt, dimensionType);
1
2
  • 三点圆: 根据圆上三点创建圆

接口名称： createCircleByThreePoint
输入参数:

参数名称 参数含义 类型 必须 参数值说明
circlePnt1 圆上某点1 点Point 是
circlePnt 2 圆上某点2 点Point 是
circlePnt3 圆上某点3 点Point 是
dimensionType 圆弧尺寸约束 整型 否 0 无尺寸约束 默认
1 半径约束

返回值： NULL

//示例程序
 Sketch.createCircleByThreePoint(circlePnt1,circlePnt2,circlePnt3);
1
2

# 圆弧

  • 中心圆弧: 根据圆心、圆弧起点、圆弧终点绘制圆弧

接口名称： createArcByCenter
输入参数：

参数名称 参数含义 类型 必须 参数值说明
centerPnt 圆心点坐标 点 Point 是
startPnt 圆弧起点点坐标 点 Point 是
endPnt 圆弧终点点坐标 点 Point 是
dimensionType 圆弧尺寸约束 整型 否 0 无尺寸约束 默认
1 半径约束

返回值： NULL

//示例程序
 Sketch.createArcByCenter(centerPnt, startPnt, endPnt, dimensionType);
1
2
  • 三点圆弧: 根据圆弧起点、圆弧终点、圆弧上一点绘制圆弧

接口名称： createArcByThreePoint
输入参数：

参数名称 参数含义 类型 必须 参数值说明
startPnt 圆弧起点点坐标 点 Point 是
endPnt 圆弧终点点坐标 点 Point 是
thirdPnt 圆弧上一点坐标 点 Point 是
DimensionType 圆弧尺寸约束 整型 否 0 无尺寸约束 默认
1 半径约束

返回值： NULL

//示例程序
 Sketch.createArcByThreePoint(startPnt, endPnt, thirdPnt, dimensionType);
1
2

# 槽

  • 直口槽: 根据槽的起点、终点和半径点绘制直口槽

接口名称： createStraightSlot
输入参数：

参数名称 参数含义 类型 必须 参数值说明
startPnt 槽的起点坐标 点 Point 是
endPnt 槽的终点点坐标 点 Point 是
radiusPnt 槽的半径点坐标 点 Point 是

返回值： NULL

//示例程序
 Sketch.createStraightSlot(startPnt, endPnt, radiusPnt);
1
2
  • 中心点直口槽: 根据槽的中点、终点和半径点绘制直口槽

接口名称： createCenterStraightSlot
输入参数：

参数名称 参数含义 类型 必须 参数值说明
centerPnt 槽的中点坐标 点 Point 是
endPnt 槽的终点点坐标 点 Point 是
radiusPnt 槽的半径点坐标 点 Point 是

返回值： NULL

//示例程序
 Sketch.createCenterStraightSlot(centerPnt, endPnt, radiusPnt);
1
2
  • 三点圆弧槽: 根据槽中圆弧起点、终点、圆弧上一点和半径点绘制圆弧槽

接口名称： createThreeArcSlot
输入参数：

参数名称 参数含义 类型 必须 参数值说明
startPnt 圆弧槽的起点坐标 点 Point 是
endPnt 圆弧槽的终点坐标 点 Point 是
thirdPnt 圆弧槽圆弧上点的坐标 点 Point 是
radiusPnt 槽的半径点坐标 点 Point 是

返回值： NULL

//示例程序
 Sketch.createThreeArcSlot(startPnt, endPnt, thirdPnt , radiusPnt);
1
2
  • 中心点圆弧槽: 根据槽中圆弧的中心点、起点、终点和半径点绘制直口槽

接口名称： createCenterArcSlot
输入参数：

参数名称 参数含义 类型 必须 参数值说明
centerPnt 圆弧槽的中心点坐标 点 Point 是
startPnt 圆弧槽的起点坐标 点 Point 是
endPnt 圆弧槽的终点坐标 点 Point 是
radiusPnt 槽的半径点坐标 点 Point 是

返回值： NULL

//示例程序
 Sketch.createCenterArcSlot(centerPnt, startPnt, endPnt, radiusPnt);
1
2

# 正多边形

接口名称： createRegularPolygon
输入参数：

参数名称 参数含义 类型 必须 参数值说明
centerPnt 辅助圆心点坐标 点Point 是
startPnt 辅助圆起点点坐标 点Point 是
edgeNum 正多边形边数 整型 是
mode 模式 浮点型 否 0 内接 默认
1 外切

返回值： NULL

//示例程序
 Sketch.CreateRegularPolygon(centerPnt, startPnt, edgeNum, edgeNum);
1
2

# 平面点

接口名称： createPoint
输入参数：

参数名称 参数含义 类型 必须 参数值说明
x 平面点的x坐标 浮点型 是
y 平面点的y坐标 浮点型 是

返回值： NULL

//示例程序
 Sketch.createPoint(x, y);
1
2

# 样条曲线

接口名称： createInptCurve
输入参数：

参数名称 参数含义 类型 必须 参数值说明
pickPnt 拾取点对象 Point List 是 由Point组成的list

返回值： NULL

//示例程序
 Sketch.createInptCurve(pickPnts);
1
2

# 倒角

  • 距离/距离倒角

接口名称： createChamferCurve
输入参数：

参数名称 参数含义 类型 必须 参数值说明
curveId1 倒角第一条边的ID 整型 是
curveId2 倒角第二条边的ID 整型 是
distance1 倒角第一条边的距离 浮点型 是
distance2 倒角第二条边的距离 浮点型 是

返回值： NULL

//示例程序
 Sketch.createChamferCurve(curveId1, curveId2, distance1, distance2);
1
2
  • 距离/角度倒角

接口名称： createChamferCurveByAngle
输入参数：

参数名称 参数含义 类型 必须 参数值说明
curveId1 倒角第一条边的ID 整型 是
curveId2 倒角第二条边的ID 整型 是
distance1 倒角距离 浮点型 是
angle 倒角角度 浮点型 是

返回值： NULL

//示例程序
 Sketch.createChamferCurveByAngle(curveId1, curveId2, distance1, angle);
1
2

# 圆角

接口名称： createFilletCurve
输入参数:

参数名称 参数含义 类型 必须 参数值说明
curveId1 圆角边1的ID 整型 是
curveId2 圆角边2的ID 整型 是
radius 圆角半径 浮点型 是

返回值： NULL

//示例程序
 Sketch.createFilletCurve(curveId1, curveId2, radius);
1
2

# 剪裁

接口名称： createAutoTrimCurve
输入参数：

参数名称 参数含义 类型 必须 参数值说明
trimCurveId 剪裁线ID 整型 是
trimCurvePnt 剪裁线上的点 点 Point 是 端点除外

返回值： NULL

//示例程序
 Sketch.createAutoTrimCurve(trimCurveId,trimCurvePnt);
1
2

# 延伸曲线

接口名称： createExtendCurve
输入参数:

参数名称 参数含义 类型 必须 参数值说明
firstCurveId 延伸线的ID 整型 是
secondCurveId 截至线的ID 整型 是

返回值： NULL

//示例程序
 Sketch.createExtendCurve(firstCurveId, secondCurveId);
1
2

# 偏移

接口名称： createOffsetCurve
输入参数:

参数名称 参数含义 类型 必须 参数值说明
offsetOnPlane 是否在平面上偏移 整型 是 1 平面
offsetCurveIds 偏移线ID 整型List 是
offsetType 偏移类型 整型 是 0 按距离偏移
offsetDistance 偏移距离 浮点型 是

返回值： NULL

//示例程序
 Sketch.createOffsetCurve(offsetOnPlane, curveIds, offsetType, offsetDistance);
1
2

# 设置参考线

接口名称： setReference
输入参数:

参数名称 参数含义 类型 必须 参数值说明
curveIds 曲线Id数组 整型 List 是
reference 是否为参考线 整型 否 0 非参考线
1 参考线 默认

返回值： NULL

//示例程序
 Sketch.setReference(curveIds, reference);
1
2

# 镜像

接口名称： createMirror
输入参数:

参数名称 参数含义 类型 必须 参数值说明
elementIds 镜像元素Id数组 整型 List 是
mirrorAxisId 镜像轴Id 整型 是
copy 是否复制 整型 否 0 删除镜像元素
1 复制生成 默认

返回值： NULL

//示例程序
 Sketch.createMirror(elementIds, mirrorAxisId, copy);
1
2

# 复制

接口名称： copyElements
输入参数:

参数名称 参数含义 类型 必须 参数值说明
elementIds 镜像元素Id数组 整型 List 是
startPnt 相对起始点 点 Point 是
endPnt 相对终点 点 Point 是

返回值： NULL

//示例程序
 Sketch.copyElements(elementIds, startPnt,  endPnt);
1
2

# 删除草图元素、草图约束

接口名称： deleteElements
输入参数:

参数名称 参数含义 类型 必须 参数值说明
elementIds 删除元素、约束的Id数组 整型 List 是

返回值： NULL

//示例程序
 Sketch.deleteElements(elementIds);
1
2

# 创建草图尺寸约束

接口名称： createDimension
输入参数:

参数名称 参数含义 类型 必须 参数值说明
firstSnapId 第一个元素的Id 整型 是
firstPickPnt 第一个元素上的一点 点 Point 是
firstSnapType 第一个元素的上点的类型 整型 是 1: 点
2: 起点
3: 终点
4: 中点
7: 曲线点 (默认)
secondSnapId 第二个元素的Id 整型 否
secondPickPnt 第二个元素上的一点 点 Point 否
secondSnapType 第二个元素的上点的类型 整型 否 1: 点
2: 起点
3: 终点
4: 中点
7: 曲线点 (默认)
direction 约束方向 整型 否 约束方向 0: 水平, 1：竖直, 3：自动（默认）
dimPosition 约束添加的位置 点 Point 否 默认位置
dimVal 约束值 变量 Variable 否 约束值(需要>0, 0为添加当前实际值为约束)
changeDimVal 是否修改约束值 点 Point 否 0：不修改（默认）, 1：修改
radiusOrDiameter 圆的尺寸类型 点 Point 否 0：直径（默认）, 1：半径

返回值： 尺寸约束的Id（整数）

//示例程序
var dId = Sketch.createDimension({
  firstSnapId: 12,
  firstPickPnt: new Point(10,0.0),
  firstSnapType: 7,
  secondSnapId: 13,
  secondPickPnt: new Point(-10,0.0),
  secondSnapType: 7,
  direction: 3,
  dimPosition: new Point(-50,20,0.0),
  radiusOrDiameter: 0,
});
1
2
3
4
5
6
7
8
9
10
11
12

# 修改尺寸约束的值

接口名称： editDimensionValue
输入参数:

参数名称 参数含义 类型 必须 参数值说明
dimensionId 对应尺寸约束Id 整型 是
value 尺寸约束值 变量 Variable 是

返回值： NULL

//示例程序
Sketch.editDimensionValue(dimensionId，new Variable(100));
1
2

# 移动尺寸约束位置

接口名称： modifyDimensionPosition
输入参数:

参数名称 参数含义 类型 必须 参数值说明
dimensionId 对应尺寸约束Id 整型 是
newPosition 新的约束位置 点 Point 是

返回值： NULL

//示例程序
Sketch.modifyDimensionPosition(dimensionId，new Point(1,1,1));
1
2