简体中文
Home > SCH_SourcePin > getGeometry
SCH_SourcePin.getGeometry() method
此 API 当前处于 BETA 预览状态,希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改,请不要将它用于任何正式环境。
获取器件的引脚几何信息
cli - 一次调用拿到全部引脚的连接点、所在边、方向与本体包围盒,可直接据此生成引出线
签名
typescript
function getGeometry(
options: ISCH_SourcePinGetGeometryOptions,
): Promise<TSCH_SourceResult<Array<ISCH_SourcePinGeometryItem>>>;1
2
3
2
3
参数名
参数 | 类型 | 描述 |
|---|---|---|
options | 引脚几何查询选项 |
返回值
Promise<TSCH_SourceResult<Array<ISCH_SourcePinGeometryItem>>>
引脚几何信息列表,失败时通过 error.code 返回错误码
备注
返回该器件**全部引脚**的几何信息,顺序与符号模板中的引脚定义顺序一致
与 SCH_SourcePrimitiveComponent.get() 返回的 pins 相比,本接口额外给出调用方最需要自行推导的几项内容:
- side:引脚从本体哪一侧引出,直接决定引出线朝向 - length:引脚长度,用于计算本体边缘与连接点的间距 - direction:引脚电气方向 - bodyBBox:引脚所属部件的本体包围盒,已包含该器件的旋转与镜像
按 side 生成引出线可避免相邻引脚走线几何重叠而被源数据层合并为同一网络, 相关风险见 SCH_SourcePrimitiveWire.add()
器件不存在时返回 PRIMITIVE_NOT_FOUND; 目标图元存在但不是器件时返回 PRIMITIVE_TYPE_MISMATCH; 器件未绑定符号或符号缺少本体包围盒时返回空列表
ADD since EDA v4.1.91