Squashed merge of PR #5441

commit a929769
Merge: e61cdb4 25a096d
Author: Paul Baksic <30337881+bakpaul@users.noreply.github.com>
Date:   Wed Apr 8 14:48:29 2026 +0200

    Merge branch 'master' into 2025_sprintsed_BaseVisualStyle

commit e61cdb4
Merge: 16ac85d fb6ac6c
Author: Paul Baksic <30337881+bakpaul@users.noreply.github.com>
Date:   Tue Jan 6 11:40:42 2026 +0100

    Merge branch 'master' into 2025_sprintsed_BaseVisualStyle

commit 16ac85d
Author: lbinria <77280433+lbinria@users.noreply.github.com>
Date:   Mon May 12 15:19:25 2025 +0200

    [Framework] Apply template method design pattern to BaseVisualStyle

Author: bakpaul

Sofa/Component/Visual/src/sofa/component/visual/VisualStyle.cpp

@@ -70,13 +70,14 @@ void VisualStyle::bwdInit()
     applyBackupFlags(sofa::core::visual::VisualParams::defaultInstance());
 }
 
-void VisualStyle::updateVisualFlags(VisualParams* vparams)
+  
+void VisualStyle::doUpdateVisualFlags(VisualParams* vparams)
 {
     backupFlags = vparams->displayFlags();
     vparams->displayFlags() = sofa::core::visual::merge_displayFlags(backupFlags, d_displayFlags.getValue());
 }
 
-void VisualStyle::applyBackupFlags(VisualParams* vparams)
+void VisualStyle::doApplyBackupFlags(VisualParams* vparams)
 {
     vparams->displayFlags() = backupFlags;
 }

Sofa/Component/Visual/src/sofa/component/visual/VisualStyle.h

@@ -66,10 +66,10 @@ class SOFA_COMPONENT_VISUAL_API VisualStyle : public sofa::core::visual::BaseVis
 protected:
     VisualStyle();
 public:
+    void doUpdateVisualFlags(VisualParams* ) override;
+    void doApplyBackupFlags(VisualParams* ) override;
     void init() override;
     void bwdInit() override;
-    void updateVisualFlags(VisualParams* ) override;
-    void applyBackupFlags(VisualParams* ) override;
 
     bool insertInNode(sofa::core::objectmodel::BaseNode* node) override;
     bool removeInNode(sofa::core::objectmodel::BaseNode* node) override;

Sofa/framework/Core/src/sofa/core/visual/BaseVisualStyle.h

@@ -41,9 +41,35 @@ class SOFA_CORE_API BaseVisualStyle : public sofa::core::objectmodel::BaseCompon
     BaseVisualStyle() { }
     ~BaseVisualStyle() override { }
 
+    virtual void doUpdateVisualFlags(VisualParams* ) { };
+    virtual void doApplyBackupFlags(VisualParams* ) { };
+
 public:
-    virtual void updateVisualFlags(VisualParams* ) { };
-    virtual void applyBackupFlags(VisualParams* ) { };
+    /**
+     * !!! WARNING since v25.12 !!! 
+     * 
+     * The template method pattern has been applied to this part of the API. 
+     * This method calls the newly introduced method "doUpdateVisualFlags" internally,
+     * which is the method to override from now on.
+     * 
+     **/  
+    virtual void updateVisualFlags(VisualParams* vparams) final { 
+        //TODO (SPRINT SED 2025): Component state mechamism
+        return this->doUpdateVisualFlags(vparams); 
+    };
+
+    /**
+     * !!! WARNING since v25.12 !!! 
+     * 
+     * The template method pattern has been applied to this part of the API. 
+     * This method calls the newly introduced method "doApplyBackupFlags" internally,
+     * which is the method to override from now on.
+     * 
+     **/  
+    virtual void applyBackupFlags(VisualParams* vparams) final { 
+        //TODO (SPRINT SED 2025): Component state mechamism
+        return this->doApplyBackupFlags(vparams); 
+    };
 
 };