简体中文
Home > SCH_SourcePrimitiveComponent > add
SCH_SourcePrimitiveComponent.add() method
放置器件
cli - 本接口直接操作工程源数据,无需前端已打开对应图页;放置前先用 LIB_Symbol.getGeometry 取外形与引脚相对位置
签名
typescript
function add(
options: ISCH_SourcePrimitiveComponentAddOptions,
): Promise<TSCH_SourceResult<ISCH_SourcePrimitiveComponentAddResult>>;1
2
3
2
3
参数名
参数 | 类型 | 描述 |
|---|---|---|
options | 器件放置选项 |
返回值
Promise<TSCH_SourceResult<ISCH_SourcePrimitiveComponentAddResult>>
器件图元 ID 与位号,失败时通过 error.code 返回错误码
备注
器件属性(位号、值、名称)的位置与姿态由内部按器件姿态自动计算,调用方无法指定;不触发渲染
**放置前先取几何**:x / y 是器件锚点,不等于外形中心,也不含引脚长度与引线。 建议先用 LIB_Symbol.getGeometry()(传器件搜索结果的 symbol.uuid / symbol.libraryUuid,多子部件再传 subPartName) 读取外形包围盒、引脚连接点相对坐标与所在边,再计算锚点与引出线方向; 放置后可调用 SCH_SourcePin.getGeometry() 复核引脚绝对坐标与本体包围盒。
**写入异步生效**:本接口返回 ok 仅表示已写入 Source 数据;网表 / DRC / 区域查询等接口异步刷新, 通常需等待约 1 秒才能读到本次改动;写后立即验证请使用 Source 的 get / getGeometry, 或等待约 1 秒后重试;不要把紧随其后的旧快照当成写入失败
ADD since EDA v4.1.83