Home > PCB_Event > addRayTracerEngine3DViewCameraChangeEventListener

PCB_Event.addRayTracerEngine3DViewCameraChangeEventListener() method

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

新增光线追踪引擎 3D 预览相机变动（拖动 3D 模型）事件监听

签名

function addRayTracerEngine3DViewCameraChangeEventListener(
	id: string,
	callFn: (props: {
		position: { x: number; y: number; z: number };
		rotation: { x: number; y: number; z: number };
		focalLength: number;
	}) => void | Promise<void>,
	onlyOnce?: boolean,
): void;

参数名

参数	类型	描述
id	string	事件 ID，用以防止重复注册事件
callFn	(props: { position: { x: number; y: number; z: number }; rotation: { x: number; y: number; z: number }; focalLength: number }) => void | Promise<void>	事件触发时的回调函数
onlyOnce	boolean	（可选） 是否仅监听一次

返回值

void

备注

注意：本接口仅扩展有效，在独立脚本环境内调用将始终 throw Error

ADD since EDA v4

示例

const listenerId = '嘉立创示例_3d_camera';

// 1. 注册相机变动监听（回调在 3D 预览拖动时触发，本例不依赖实际触发）
eda.pcb_Event.addRayTracerEngine3DViewCameraChangeEventListener(
	listenerId,
	(props) => {
		console.log('cameraChange:', JSON.stringify(props));
	}
);

// 2. 回读确认注册成功
const registered = eda.pcb_Event.isEventListenerAlreadyExist(listenerId);
console.log('registered:', registered);

// 3. 清理监听
const removed = eda.pcb_Event.removeEventListener(listenerId);
console.log('removed:', removed);