English
Home > SCH_SourcePin > getGeometry
SCH_SourcePin.getGeometry() method
This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
获取器件的引脚几何信息
cli - 一次调用拿到全部引脚的连接点、所在边、方向与本体包围盒,可直接据此生成引出线
Signature
typescript
function getGeometry(
options: ISCH_SourcePinGetGeometryOptions,
): Promise<TSCH_SourceResult<Array<ISCH_SourcePinGeometryItem>>>;1
2
3
2
3
Parameters
Parameter | Type | Description |
|---|---|---|
options | 引脚几何查询选项 |
Returns
Promise<TSCH_SourceResult<Array<ISCH_SourcePinGeometryItem>>>
引脚几何信息列表,失败时通过 error.code 返回错误码
Remarks
返回该器件**全部引脚**的几何信息,顺序与符号模板中的引脚定义顺序一致
与 SCH_SourcePrimitiveComponent.get() 返回的 pins 相比,本接口额外给出调用方最需要自行推导的几项内容:
- side:引脚从本体哪一侧引出,直接决定引出线朝向 - length:引脚长度,用于计算本体边缘与连接点的间距 - direction:引脚电气方向 - bodyBBox:引脚所属部件的本体包围盒,已包含该器件的旋转与镜像
按 side 生成引出线可避免相邻引脚走线几何重叠而被源数据层合并为同一网络, 相关风险见 SCH_SourcePrimitiveWire.add()
器件不存在时返回 PRIMITIVE_NOT_FOUND; 目标图元存在但不是器件时返回 PRIMITIVE_TYPE_MISMATCH; 器件未绑定符号或符号缺少本体包围盒时返回空列表 ADD since EDA v4.1.91