PyQtNode Editor 第三篇创建节点（节点的定义）

原创

于 2025-06-28 21:08:45 发布 · 839 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#pyqt #node #python

在这里插入图片描述在 PyQtNode Editor 的开发之旅中，经过前两篇博客对基础环境搭建和核心类结构的探索，我们已经迈出了坚实的步伐。今天，我们将聚焦于node_scene文件，深入解析其中的代码逻辑。这段代码构建了Scene类，它如同整个节点编辑器的 “管理中枢”，承担着组织和协调节点、边等关键元素的重要职责，是推动编辑器功能运转的核心力量。
首先创建一个node_scene.py文件
导入必要的模块

from node_graphics_scene import QDMGraphicsScene

这里从自定义模块 node_graphics_scene 中导入 QDMGraphicsScene 类。QDMGraphicsScene 类通常用于处理图形场景的可视化相关操作，比如绘制背景、管理场景中的图形元素显示等。通过导入这个类，Scene 类可以利用它来实现节点和边在界面上的展示，将逻辑数据与可视化效果进行关联。
定义 Scene 类

class Scene:

Scene 类用于管理节点编辑器中的节点和边的逻辑数据，以及与图形场景进行交互。它是整个节点编辑系统中数据管理和协调的核心部分，后续关于节点和边的创建、删除、存储等操作都会围绕这个类展开。
类的初始化方法

    def __init__(self):
        self.nodes = []
        self.edges = []

        self.scene_width = 64000
        self.scene_height = 64000

        self.initUI()

self.nodes = [] 和 self.edges = []：分别创建了两个空列表，用于存储节点和边的对象。在后续的操作中，当创建新的节点或边时，就会将它们添加到对应的列表中，方便进行统一管理和遍历操作。
self.scene_width = 64000 和 self.scene_height = 64000：设置了图形场景的宽度和高度。这两个属性定义了整个节点编辑区域的大小范围，确定了节点和边可以放置的空间。
self.initUI()：调用自定义的 initUI 方法，用于初始化与图形场景相关的设置，将逻辑上的 Scene 类与可视化的图形场景进行关联和配置。
初始化用户界面方法

    def initUI(self):
        self.grScene = QDMGraphicsScene(self)
        self.grScene.setGrScene(self.scene_width, self.scene_height)

self.grScene = QDMGraphicsScene(self)：创建了一个 QDMGraphicsScene 类的实例 grScene，并将当前的 Scene 类实例（self）作为参数传递进去。这样做是为了在 QDMGraphicsScene 类中能够获取到与当前逻辑场景相关的信息，实现逻辑与可视化的交互。例如，QDMGraphicsScene 类可能需要根据 Scene 类中的数据来决定如何绘制节点和边。
self.grScene.setGrScene(self.scene_width, self.scene_height)：调用 QDMGraphicsScene 实例的 setGrScene 方法，将之前设置的场景宽度和高度传递进去。这个方法可能会根据传入的尺寸对图形场景进行初始化配置，比如设置场景的边界范围，以便正确显示节点和边。
节点和边的添加方法

    def addNode(self, node):
        self.nodes.append(node)

    def addEdge(self, edge):
        self.edges.append(edge)

addNode 方法：接收一个 node 参数，将传入的节点对象添加到 self.nodes 列表中。当在节点编辑器中创建新的节点时，就会调用这个方法将新节点纳入到场景的管理中，方便后续对节点进行查找、操作和存储等处理。
addEdge 方法：与 addNode 方法类似，接收一个 edge 参数，将传入的边对象添加到 self.edges 列表中。在节点之间建立连接关系时，新创建的边就会通过这个方法添加到场景中，实现对边的统一管理。
节点和边的删除方法

    def removeNode(self, node):
        self.nodes.remove(node)

    def removeEdge(self, edge):
        self.edges.remove(edge)

removeNode 方法：接收一个 node 参数，从 self.nodes 列表中移除指定的节点对象。当需要在节点编辑器中删除某个节点时，调用这个方法可以将该节点从场景的管理中移除，同时后续可能还会触发一些与该节点相关的清理操作，比如删除与该节点连接的边等。
removeEdge 方法：接收一个 edge 参数，从 self.edges 列表中移除指定的边对象。在断开节点之间的连接时，就会使用这个方法将对应的边从场景中删除，确保场景中的数据与实际的节点连接状态一致。
完整的node_scene文件：

# 从自定义模块node_graphics_scene中导入QDMGraphicsScene类。
# QDMGraphicsScene类通常用于处理图形场景的可视化相关操作，
# 例如绘制场景背景、管理场景中图形元素的显示等，为后续将逻辑数据可视化做准备
from node_graphics_scene import QDMGraphicsScene


# 定义Scene类，该类用于管理节点编辑器中的节点和边的逻辑数据，
# 以及与图形场景进行交互，是整个节点编辑系统数据管理和协调的核心部分
class Scene:
    # 类的初始化方法，在创建Scene类的实例时自动调用，用于初始化对象的属性
    def __init__(self):
        # 创建一个空列表，用于存储节点对象。后续创建的节点都将添加到这个列表中，
        # 方便对节点进行统一管理，如遍历、查找、操作等
        self.nodes = []
        # 创建一个空列表，用于存储边对象。与节点列表类似，
        # 所有创建的边都会存放在这里，便于管理边的相关操作
        self.edges = []

        # 设置图形场景的宽度为64000，这个值定义了节点编辑区域在水平方向上的大小范围
        self.scene_width = 64000
        # 设置图形场景的高度为64000，确定了节点编辑区域在垂直方向上的大小范围
        self.scene_height = 64000

        # 调用initUI方法，用于初始化与图形场景相关的设置，
        # 建立逻辑场景与可视化图形场景之间的联系
        self.initUI()

    # 初始化用户界面的方法，主要负责创建图形场景实例并进行相关配置
    def initUI(self):
        # 创建QDMGraphicsScene类的实例grScene，并将当前Scene类的实例self作为参数传入。
        # 这样做可以使QDMGraphicsScene类获取到与当前逻辑场景相关的信息，
        # 实现逻辑场景与可视化图形场景之间的交互
        self.grScene = QDMGraphicsScene(self)
        # 调用grScene的setGrScene方法，将之前设置的场景宽度和高度传入。
        # 该方法会根据传入的尺寸对图形场景进行初始化配置，
        # 比如设置场景的边界范围，以确保节点和边能在正确的区域内显示
        self.grScene.setGrScene(self.scene_width, self.scene_height)

    # 向场景中添加节点的方法，接收一个node参数，代表要添加的节点对象
    def addNode(self, node):
        # 将传入的节点对象添加到self.nodes列表中，
        # 从而将新节点纳入到Scene类的管理体系中
        self.nodes.append(node)

    # 向场景中添加边的方法，接收一个edge参数，即要添加的边对象
    def addEdge(self, edge):
        # 将传入的边对象添加到self.edges列表中，
        # 实现对新创建边的统一管理
        self.edges.append(edge)

    # 从场景中移除节点的方法，接收一个node参数，指定要移除的节点对象
    def removeNode(self, node):
        # 从self.nodes列表中移除指定的节点对象，
        # 在实际应用中，删除节点可能还会引发与该节点相关的其他清理操作，
        # 以保证数据的一致性和准确性
        self.nodes.remove(node)

    # 从场景中移除边的方法，接收一个edge参数，用于指定要移除的边对象
    def removeEdge(self, edge):
        # 从self.edges列表中移除指定的边对象，
        # 确保场景中节点之间的连接关系与实际操作保持一致
        self.edges.remove(edge)

在node_graphics_scene.py文件中：
初始化原来函数：

class QDMGraphicsScene(QGraphicsScene):
    def __init__(self, parent=None):
        super().__init__(parent)

更改为：

class QDMGraphicsScene(QGraphicsScene):
    def __init__(self, scene, parent=None):
        super().__init__(parent)

        self.scene = scene

并且增加一个函数：

 def setGrScene(self, width, height):
        self.setSceneRect(-width // 2, -height // 2, width, height)

并且删除原来代码中：

self.scene_width, self.scene_height = 64000, 64000
self.setSceneRect(-self.scene_width//2, -self.scene_height//2, self.scene_width, self.scene_height)

在窗口的node_editor_wnd.py文件中：
首先调用

from node_scene import Scene

将原来的代码中的:

self.grScene = QDMGraphicsScene()

更改为：

    self.scene = Scene()
    self.grScene = self.scene.grScene

通过以上的步骤：实现了Scene函数的分离。

节点类

创建一个node_graphics_node.py

# 从PyQt5的QtWidgets模块导入所有的类和函数，该模块包含各种用于创建用户界面的组件，如按钮、布局、视图等
from PyQt5.QtWidgets import *
# 从PyQt5的QtCore模块导入所有的类和函数，此模块提供了核心功能，包括信号与槽机制、事件循环、定时器等
from PyQt5.QtCore import *
# 从PyQt5的QtGui模块导入所有的类

最低0.47元/天解锁文章