Function fguiGizmoProvider

packages/fairygui-editor/src/FGUIEditorModule.ts:151–207

* Gizmo provider for FGUIComponent * FGUIComponent 的 Gizmo 提供者 * * Generates rect gizmos for all visible FGUI nodes. * Uses the same coordinate conversion as FGUIRenderDataProvider. * 为所有可见的 FGUI 节点生成矩形 gizmos。 * 使用与 FGUIRenderDataProvider 相同的坐标转换。

(
    component: FGUIComponent,
    entity: Entity,
    isSelected: boolean
)

 * 使用与 FGUIRenderDataProvider 相同的坐标转换。
 */
function fguiGizmoProvider(
    component: FGUIComponent,
    entity: Entity,
    isSelected: boolean
): IGizmoRenderData[] {
    const gizmos: IGizmoRenderData[] = [];

    // Get the root GObject
    const root = component.root;
    if (!root) return gizmos;

    // Get Stage design size for coordinate conversion
    // Use the same values as FGUIRenderDataProvider
    // 获取 Stage 设计尺寸用于坐标转换，与 FGUIRenderDataProvider 使用相同的值
    const stage = Stage.inst;
    const halfWidth = stage.designWidth / 2;
    const halfHeight = stage.designHeight / 2;

    // Root gizmo - root is at (0, 0) in FGUI coords
    // In engine coords: center is at (-halfWidth + width/2, halfHeight - height/2)
    // 根 Gizmo - 根节点在 FGUI 坐标 (0, 0)
    // 在引擎坐标中：中心在 (-halfWidth + width/2, halfHeight - height/2)
    const rootCenterX = -halfWidth + root.width / 2;
    const rootCenterY = halfHeight - root.height / 2;

    const rootGizmo: IRectGizmoData = {
        type: 'rect',
        x: rootCenterX,
        y: rootCenterY,
        width: root.width,
        height: root.height,
        rotation: 0,
        originX: 0.5,
        originY: 0.5,
        color: isSelected ? FGUIGizmoColors.root : { ...FGUIGizmoColors.root, a: 0.4 },
        showHandles: isSelected
    };
    gizmos.push(rootGizmo);

    // Collect child gizmos only when selected (performance optimization)
    if (isSelected && component.component) {
        const comp = component.component;

        // Get currently selected virtual node for this entity
        // 获取此实体当前选中的虚拟节点
        const selectedInfo = VirtualNodeRegistry.getSelectedVirtualNode();
        const selectedVirtualNodeId = (selectedInfo && selectedInfo.entityId === entity.id)
            ? selectedInfo.virtualNodeId
            : null;

        // First add gizmo for the component itself
        // 首先为组件本身添加 gizmo
        collectFGUIGizmos(comp, halfWidth, halfHeight, gizmos, entity.id, selectedVirtualNodeId, '');
    }

    return gizmos;
}