技术需求：创建可读取并显示图像的napari停靠部件

功能概述 #

• 支持加载.png、.jpg、.jpeg、.bmp等常见图像格式
• 所有加载图像使用固定色图渲染，且图层锁定无法删除/编辑，实现永久显示
• 可一键切换部件在napari查看器的左侧或右侧停靠区域

完整代码实现 #

import napari
from napari.utils.notifications import show_info
from qtpy.QtWidgets import QWidget, QVBoxLayout, QPushButton, QFileDialog
from PIL import Image
import numpy as np

class FixedColormapDockWidget(QWidget):
    def __init__(self, viewer: napari.Viewer, parent=None):
        super().__init__(parent)
        self.viewer = viewer
        self.fixed_cmap = 'viridis'  # 替换为你需要的固定色图，比如'gray' 'magma'
        self._init_ui()

    def _init_ui(self):
        layout = QVBoxLayout()

        # 加载图像按钮
        load_btn = QPushButton("加载图像")
        load_btn.clicked.connect(self._load_image_file)
        layout.addWidget(load_btn)

        # 切换停靠位置按钮
        toggle_btn = QPushButton("切换停靠区域")
        toggle_btn.clicked.connect(self._switch_dock_area)
        layout.addWidget(toggle_btn)

        self.setLayout(layout)

    def _load_image_file(self):
        # 弹出文件选择框，限定图像格式
        file_path, _ = QFileDialog.getOpenFileName(
            self,
            "选择图像",
            "",
            "图像文件 (*.png *.jpg *.jpeg *.bmp)"
        )
        if not file_path:
            return

        # 读取图像并转为napari兼容的数组
        try:
            img = Image.open(file_path)
            img_data = np.array(img)
            # 添加锁定图层，固定色图
            layer = self.viewer.add_image(
                img_data,
                colormap=self.fixed_cmap,
                name=file_path.split('/')[-1],
                editable=False,
                visible=True
            )
            layer.locked = True  # 锁定图层防止误删
            show_info(f"图像加载完成：{file_path.split('/')[-1]}")
        except Exception as e:
            show_info(f"加载失败：{str(e)}")

    def _switch_dock_area(self):
        # 获取当前停靠的dock容器
        current_dock = self.parent()
        if not current_dock:
            return

        # 切换左/右停靠区域
        target_area = 'right' if current_dock.dockArea() == napari._qt.qt_viewer.QtViewer.DockArea.Left else 'left'
        # 重新添加部件到目标区域
        self.viewer.window.add_dock_widget(self, area=target_area)
        # 关闭旧的dock容器
        current_dock.close()

# 测试运行
if __name__ == "__main__":
    viewer = napari.Viewer()
    # 初始停靠在左侧
    dock_widget = FixedColormapDockWidget(viewer)
    viewer.window.add_dock_widget(dock_widget, area='left')
    napari.run()

关键实现细节 #

• 固定色图：通过类属性self.fixed_cmap统一设置所有加载图像的色图，可直接修改为所需色图名称
• 永久显示：设置editable=False禁止图层编辑，layer.locked=True锁定图层，避免误操作删除或修改
• 停靠切换：通过判断当前停靠区域，调用add_dock_widget重新挂载部件到目标区域，同时关闭旧的dock容器

使用步骤 #

1. 运行代码启动napari，左侧会出现自定义停靠部件
2. 点击「加载图像」选择目标图像文件，图像会以固定色图显示且无法被删除
3. 点击「切换停靠区域」可将部件在左侧/右侧面板间切换

内容的提问来源于stack exchange，提问作者user36028