English
Home > LIB_Symbol > getGeometry
LIB_Symbol.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(
symbolUuid: string,
libraryUuid: string,
subPartName?: string,
): Promise<ILIB_SymbolGeometry | undefined>;1
2
3
4
5
2
3
4
5
Parameters
Parameter | Type | Description |
|---|---|---|
symbolUuid | string | 符号 UUID |
libraryUuid | string | 库地址,必传; |
subPartName | string | (Optional) 子部件名称,省略时取第一个部件 |
Returns
Promise<ILIB_SymbolGeometry | undefined>
符号几何信息,获取失败返回 undefined
Remarks
返回符号的包围盒、全部引脚的连接点坐标与所在边,以及位号 / 值等文本的默认锚点, 供外部布局器在写入原理图前完成定位、避让与压线检查
与 LIB_Symbol.getDocumentSource() 的区别:本接口直接给出结构化几何,调用方无需解析符号源码
libraryUuid 必传,传 'project' 表示当前打开工程的工程库
多子部件符号需通过 subPartName 指定部件,省略时取第一个部件
收藏库与扩展库暂不支持;获取失败(库条目不存在、工程未打开、库不可用)时返回 undefined,不抛异常 ADD since EDA v4.1.91