fabns-nano · Gabrielnmds · Jun 23, 2025 · Jun 23, 2025 · Aug 5, 2025 · Aug 5, 2025
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -87,6 +87,8 @@ set(CPP_SOURCE_FILES
   src/StyleCollection.cpp
   src/UndoCommands.cpp
   src/locateNode.cpp
+  src/GroupGraphicsObject.cpp
+  src/NodeGroup.cpp
   resources/resources.qrc
 )
 
@@ -127,6 +129,8 @@ set(HPP_HEADER_FILES
   include/QtNodes/internal/DefaultVerticalNodeGeometry.hpp
   include/QtNodes/internal/NodeConnectionInteraction.hpp
   include/QtNodes/internal/UndoCommands.hpp
+  include/QtNodes/internal/NodeGroup.hpp
+  include/QtNodes/internal/GroupGraphicsObject.hpp
 )
 
 # If we want to give the option to build a static library,
@@ -165,6 +169,9 @@ target_compile_definitions(QtNodes
     QT_NO_KEYWORDS
 )
 
+if(MSVC)
+  string(REGEX REPLACE "/W[0-4]" "" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
+endif()
 
 target_compile_options(QtNodes
   PRIVATE

diff --git a/README.rst b/README.rst
@@ -1,7 +1,8 @@
 QtNodes
 #######
 
-https://github.com/paceholder/nodeeditor/actions/workflows/cmake_build.yml/badge.svg
+.. image:: https://github.com/paceholder/nodeeditor/actions/workflows/cmake_build.yml/badge.svg
+   :target: https://github.com/paceholder/nodeeditor/actions/workflows/cmake_build.yml
 
 Introduction
 ============
@@ -33,7 +34,7 @@ Warning
 Branches
 --------
 
-There are branchses ``v2`` and ``v3`` for versions ``2.x.x`` and ``3.x``
+There are branches ``v2`` and ``v3`` for versions ``2.x.x`` and ``3.x``
 respectively. The branch ``master`` contains the latest dev state.
 
 
@@ -73,7 +74,7 @@ Dependencies
 ------------
 
 * Qt >5.15
-* CMake 3.8
+* CMake 3.11
 * Catch2
 
 
@@ -117,7 +118,7 @@ For building a static lib use:
 
 ::
 
-    cmake .. -BUILD_SHARED_LIBS=off
+    cmake .. -DBUILD_SHARED_LIBS=off
 
 Linux
 -----
@@ -192,9 +193,9 @@ For detailed testing documentation, see the `Testing Guide <https://qtnodes.read
 Help Needed
 ===========
 
-#. Python wrappring using PySide.
+#. Python wrapping using PySide.
 #. QML frontend.
-#. Wirting a ClangFormat config.
+#. Writing a ClangFormat config.
 
 Any suggestions are welcome!
 
@@ -219,7 +220,7 @@ Contribution
    #. Describe your issue in details
    #. Provide some use cases.
 
-#. I maintain this probject in my free time, when I am not busy with my work or
+#. I maintain this project in my free time, when I am not busy with my work or
    my family. **If I do not react or do not answer for too long, please ping
    me**.
 
@@ -287,7 +288,7 @@ every automotive developer. Thanks to modularity it is easy to implement new,
 custom features.
 
 
-.. image:: docs/_static/showcase_CANdevStudio.png
+.. image:: assets/showcase-candevstudio.png
 
 
 Chigraph
@@ -296,7 +297,7 @@ Chigraph
 `Chigraph <https://github.com/chigraph/chigraph>`_ is a visual programming
 language for beginners that is unique in that it is an intuitive flow graph:
 
-.. image:: docs/_static/chigraph.png
+.. image:: assets/chigraph.png
 
 
 It features easy bindings to C/C++, package management, and a cool interface.
@@ -309,4 +310,4 @@ Spkgen particle editor
 particles engine that uses a node-based interface to create particles effects for
 games
 
-.. image:: docs/_static/spkgen.png
+.. image:: assets/spkgen.png
diff --git a/docs/_static/chigraph.png → assets/chigraph.png b/docs/_static/chigraph.png → assets/chigraph.png
diff --git a/docs/_static/showcase_CANdevStudio.png → assets/showcase-candevstudio.png b/docs/_static/showcase_CANdevStudio.png → assets/showcase-candevstudio.png
diff --git a/docs/_static/spkgen.png → assets/spkgen.png b/docs/_static/spkgen.png → assets/spkgen.png
diff --git a/docs/_static/vid1.png → assets/vid1.png b/docs/_static/vid1.png → assets/vid1.png
diff --git a/docs/Makefile b/docs/Makefile
@@ -5,7 +5,7 @@
 # from the environment for the first two.
 SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = source
+SOURCEDIR     = .
 BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".

diff --git a/docs/_static/diagrams/architecture-diagram.png b/docs/_static/diagrams/architecture-diagram.png
diff --git a/docs/_static/diagrams/architecture-diagram.puml b/docs/_static/diagrams/architecture-diagram.puml
@@ -0,0 +1,53 @@
+@startuml architecture-diagram
+!theme plain
+skinparam backgroundColor #2B2B2B
+skinparam defaultFontColor #E0E0E0
+skinparam classBorderColor #606060
+skinparam classBackgroundColor #3C3F41
+skinparam arrowColor #A0A0A0
+skinparam noteBorderColor #606060
+skinparam noteBackgroundColor #4A4D4F
+
+skinparam rectangle {
+    BackgroundColor #3C3F41
+    BorderColor #606060
+    FontColor #E0E0E0
+}
+
+rectangle "Your Application" as app #4A5568 {
+    rectangle "Your Data\n(nodes, connections,\npositions, values)" as data #718096
+}
+
+rectangle "QtNodes Library" as lib #2D3748 {
+    rectangle "AbstractGraphModel\n(or DataFlowGraphModel)" as model #4A5568
+    rectangle "BasicGraphicsScene\n(or DataFlowGraphicsScene)" as scene #4A5568
+    rectangle "GraphicsView" as view #4A5568
+}
+
+rectangle "User Interface" as ui #1A202C {
+    rectangle "Window with\ninteractive nodes" as window #2D3748
+}
+
+data -right-> model : "implements"
+model -right-> scene : "visualizes"
+scene -right-> view : "displays in"
+view -right-> window : "renders to"
+
+note bottom of model
+  You subclass this
+  to store your graph data
+end note
+
+note bottom of scene
+  Automatically creates
+  graphics objects from
+  model data
+end note
+
+note bottom of view
+  Handles zoom, pan,
+  selection, and
+  user interactions
+end note
+
+@enduml
diff --git a/docs/_static/diagrams/dataflow-diagram.png b/docs/_static/diagrams/dataflow-diagram.png
diff --git a/docs/_static/diagrams/dataflow-diagram.puml b/docs/_static/diagrams/dataflow-diagram.puml
@@ -0,0 +1,48 @@
+@startuml dataflow-diagram
+!theme plain
+skinparam backgroundColor #2B2B2B
+skinparam defaultFontColor #E0E0E0
+skinparam componentBorderColor #606060
+skinparam componentBackgroundColor #3C3F41
+skinparam arrowColor #4299E1
+skinparam noteBorderColor #606060
+skinparam noteBackgroundColor #4A4D4F
+
+skinparam rectangle {
+    BackgroundColor #3C3F41
+    BorderColor #606060
+    FontColor #E0E0E0
+    RoundCorner 15
+}
+
+rectangle "Source Node\n(NumberSourceDataModel)" as source #48BB78 {
+}
+
+rectangle "Operator Node\n(AdditionModel)" as operator #4299E1 {
+}
+
+rectangle "Display Node\n(NumberDisplayDataModel)" as display #ED8936 {
+}
+
+source -right-> operator : "outData()"
+operator -right-> display : "outData()"
+
+note bottom of source
+  **Emits data**
+  Creates values
+  (e.g., number input)
+end note
+
+note bottom of operator
+  **Processes data**
+  Receives via setInData()
+  Outputs via outData()
+end note
+
+note bottom of display
+  **Consumes data**
+  Receives and shows
+  the final result
+end note
+
+@enduml
diff --git a/docs/_static/diagrams/dataflow-signals.png b/docs/_static/diagrams/dataflow-signals.png
diff --git a/docs/_static/diagrams/dataflow-signals.puml b/docs/_static/diagrams/dataflow-signals.puml
@@ -0,0 +1,51 @@
+@startuml dataflow-signals
+!theme plain
+skinparam backgroundColor #2B2B2B
+skinparam defaultFontColor #E0E0E0
+skinparam sequenceArrowColor #4299E1
+skinparam sequenceLifeLineBorderColor #606060
+skinparam sequenceParticipantBorderColor #606060
+skinparam sequenceParticipantBackgroundColor #3C3F41
+skinparam sequenceBoxBorderColor #606060
+skinparam sequenceBoxBackgroundColor #2D3748
+
+participant "Source\nDelegate" as src #48BB78
+participant "DataFlow\nGraphModel" as model #4A5568
+participant "Operator\nDelegate" as op #4299E1
+participant "Display\nDelegate" as disp #ED8936
+
+src -> src : User changes\nvalue in widget
+activate src
+src -> src : emit dataUpdated(portIndex)
+src -> model : [signal] dataUpdated
+deactivate src
+activate model
+
+model -> model : Lookup connections\nfrom this port
+model -> op : setInData(data, portIndex)
+deactivate model
+activate op
+
+op -> op : Process input
+op -> op : Calculate result
+op -> op : emit dataUpdated(0)
+op -> model : [signal] dataUpdated
+deactivate op
+activate model
+
+model -> model : Lookup connections\nfrom operator output
+model -> disp : setInData(data, portIndex)
+deactivate model
+activate disp
+
+disp -> disp : Update display\nwidget
+deactivate disp
+
+note over model
+  DataFlowGraphModel
+  routes data between
+  connected delegates
+  automatically
+end note
+
+@enduml
diff --git a/docs/_static/screenshots/calc-start.png b/docs/_static/screenshots/calc-start.png
diff --git a/docs/_static/calculator.png → docs/_static/screenshots/calculator.png b/docs/_static/calculator.png → docs/_static/screenshots/calculator.png
diff --git a/docs/_static/screenshots/connection-colors.png b/docs/_static/screenshots/connection-colors.png
diff --git a/docs/_static/screenshots/custom-painter.png b/docs/_static/screenshots/custom-painter.png
diff --git a/docs/_static/screenshots/dynamic-ports.png b/docs/_static/screenshots/dynamic-ports.png
diff --git a/docs/_static/screenshots/embedded-widget.png b/docs/_static/screenshots/embedded-widget.png
diff --git a/docs/_static/flow.png → docs/_static/screenshots/flow.png b/docs/_static/flow.png → docs/_static/screenshots/flow.png
diff --git a/docs/_static/screenshots/locked-node.png b/docs/_static/screenshots/locked-node.png
diff --git a/docs/_static/screenshots/node-anatomy.png b/docs/_static/screenshots/node-anatomy.png
diff --git a/docs/_static/screenshots/processing-status.png b/docs/_static/screenshots/processing-status.png
diff --git a/docs/_static/screenshots/quickstart-connect.png b/docs/_static/screenshots/quickstart-connect.png
diff --git a/docs/_static/screenshots/quickstart-create.png b/docs/_static/screenshots/quickstart-create.png
diff --git a/docs/_static/screenshots/quickstart-result.png b/docs/_static/screenshots/quickstart-result.png
diff --git a/docs/_static/screenshots/quickstart-select.png b/docs/_static/screenshots/quickstart-select.png
diff --git a/docs/_static/screenshots/resizable.png b/docs/_static/screenshots/resizable.png
diff --git a/docs/_static/style_example.png → docs/_static/screenshots/style-example.png b/docs/_static/style_example.png → docs/_static/screenshots/style-example.png
diff --git a/docs/_static/screenshots/text.png b/docs/_static/screenshots/text.png
diff --git a/docs/_static/screenshots/validation.png b/docs/_static/screenshots/validation.png
diff --git a/docs/_static/screenshots/vertical-layout.png b/docs/_static/screenshots/vertical-layout.png