Home > LIB_3DModel > modify

LIB_3DModel.modify() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

修改 3D 模型

签名

function modify(
	modelUuid: string,
	libraryUuid: string,
	modelName?: string,
	classification?: ILIB_ClassificationIndex | Array<string> | null,
	description?: string | null,
): Promise<boolean>;

参数名

参数	类型	描述
modelUuid	string	3D 模型 UUID
libraryUuid	string	库 UUID，可以使用 LIB_LibrariesList 内的接口获取
modelName	string	（可选） 3D 模型名称
classification	ILIB_ClassificationIndex | Array<string> | null	（可选） 分类
description	string | null	（可选） 描述

返回值

Promise<boolean>

操作是否成功

备注

如希望清除某些属性，则将其的值设置为 null

示例

// 1. 获取个人库 UUID
const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();

// 2. 复制一个系统库模型到个人库作为修改对象
const results = await eda.lib_3DModel.search('0402', undefined, undefined, 1);
const source = results[0];
const copiedUuid = await eda.lib_3DModel.copy(
	source.uuid,
	source.libraryUuid,
	libraryUuid,
	undefined,
	`ToModify_${Date.now()}`
);

// 3. 修改名称和描述（classification 保持不变传 []）
const modifiedName = `Renamed_${Date.now()}`;
const modified = await eda.lib_3DModel.modify(
	copiedUuid,
	libraryUuid,
	modifiedName,
	[],
	'3D model example'
);

// 修改类保留现场

console.log('copiedUuid:', copiedUuid);
console.log('modified:', modified);
console.log('newName:', modifiedName);