Add Button to FEM Toolbar Tutorial: Difference between revisions

From FreeCAD Documentation
(Created page with "<languages/> <translate> <!--T:1--> {{TutorialInfo |Topic= Add FEM Equation |Level= |Time= |Author=JohnWang |FCVersion=0.19 |Files= }} <!--T:2--> In this...")
 
mNo edit summary
 
(54 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:1-->
<!--T:1-->
{{TutorialInfo
{{TutorialInfo
|Topic= Add FEM Equation
|Topic=FEM
|Level=
|Level=Advanced
|Time=
|Time=60 min
|Author=[[User:JohnWang|JohnWang]]
|Author=[[User:JohnWang|JohnWang]]
|FCVersion=0.19
|FCVersion=0.19
Line 11: Line 12:
}}
}}


<!--T:2-->
== Introduction == <!--T:2-->
In this tutorial we are going to add the '''Flow''' equation to FreeCAD and implement support for elmer solver. Please make sure you have read and understood [[Extend_FEM_Module| Extend FEM Module]] before reading this tutorial.


<!--T:3-->
<!--T:3-->
The FEM workbench has toolbars and menus. This tutorial shows how to add a test button to a toolbar. It also shows how to add a menu item to a menu.
The task can be split into five parts:

* '''New equation type'''. This step must only be done if the equation doesn't exist in FreeCAD yet (as opposed to a equation that is already in FreeCAD but not supported by the target solver).
<!--T:4-->
The task can be split into four parts:
* '''Create a new icon file'''.
* '''Register the new icon file'''. Modification needed to {{incode|src/Mod/Fem/Gui/Resources/Fem.qrc}}
* '''Create a new command class'''. Modification needed to {{incode|src/Mod/Fem/femcommands/commands.py}}
* '''Add new command to workbench'''. Modification needed to {{incode|src/Mod/Fem/Gui/Workbench.cpp}}

== Create a new icon file == <!--T:5-->

<!--T:6-->
For the button, we need an icon file. You can use any of your favorite tools to create it, but it must be in the SVG format. Here we will use the {{FileName|FEM_testButton.svg}} file as an example.

<!--T:7-->
It must be placed in: {{incode|src/Mod/Fem/Gui/Resources/icons/}}.

== Register the new icon file == <!--T:8-->

<!--T:9-->
The new SVG icon file has to be registered for the GUI button by inserting it in {{incode|src/Mod/Fem/Gui/Resources/Fem.qrc}}:

</translate>
{{code|code=
<file>icons/FEM_testButton.svg</file>
}}
<translate>

== Create a new command class == <!--T:10-->

<!--T:11-->
A new command class has to be added to the {{incode|src/Mod/Fem/femcommands/commands.py}} module.

<!--T:12-->
Just copy/paste an existing command, then adjust the icon, menu text and tool-tip in {{incode|__init__(self)}}:

</translate>
{{code|code=
class _testButton(CommandManager):
"The FEM_testButton command definition"

def __init__(self):
super(_testButton, self).__init__()
self.menuetext = "test Button"
self.tooltip = "This is a test button"
self.is_active = "always"
#self.do_activated = "add_obj_on_gui_selobj_noset_edit"
}}
<translate>

<!--T:13-->
Don't forget to register the command at the bottom of the module file with the {{incode|addCommand(...)}} method:

</translate>
{{code|code=
FreeCADGui.addCommand(
"FEM_testButton",
_testButton()
)
}}
<translate>

<!--T:14-->
'''Note''': Please see this [https://forum.freecadweb.org/viewtopic.php?f=18&t=46693&start=10#p402004 discussion thread] in the forum if icons are involved.

== Add new command to workbench == <!--T:15-->

<!--T:16-->
We will add the new command to both the '''solve''' toolbar and the '''solve''' menu.

<!--T:17-->
Search for the following code snippet in {{incode|/Gui/Workbench.cpp}} and add the new command:

</translate>
{{code|code=
Gui::ToolBarItem* solve = new Gui::ToolBarItem(root);
solve->setCommand("Solve");
*solve << "FEM_SolverCalculixCxxtools"
<< "FEM_SolverCalculiX"
<< "FEM_SolverElmer"
+ << "FEM_testButton"
<< "Separator"
}}
<translate>

<!--T:18-->
To add the command to the '''solve''' menu of the FEM workbench, search for the following code snippet in {{incode|Workbench.cpp}}:

</translate>
{{code|code=
Gui::MenuItem* solve = new Gui::MenuItem;
root->insertItem(item, solve);
solve->setCommand("&Solve");
*solve << "FEM_SolverCalculixCxxtools"
<< "FEM_SolverCalculiX"
<< "FEM_SolverElmer"
<< "FEM_SolverZ88"
+ << "FEM_testButton"
<< "Separator"
}}
<translate>

<!--T:19-->
'''Result''': You should have just successfully added a test button to a FEM workbench toolbar and menu. Now, you can [[Compiling|compile FreeCAD]] and test your new button.

== Related == <!--T:20-->


== New Equation Type== <!--T:4-->
<!--T:21-->
* [[Extend_FEM_Module|Extend FEM Module]]
* [[Onboarding_FEM_Devs|Onboarding FEM Devs]]


In this step we are going to modify the following files:


</translate>
</translate>
[[Category:FEM{{#translation:}}]]
[[Category:Developer Documentation{{#translation:}}]]

Latest revision as of 18:02, 12 January 2024

Other languages:
Tutorial
Topic
FEM
Level
Advanced
Time to complete
60 min
Authors
JohnWang
FreeCAD version
0.19
Example files
See also
None

Introduction

The FEM workbench has toolbars and menus. This tutorial shows how to add a test button to a toolbar. It also shows how to add a menu item to a menu.

The task can be split into four parts:

  • Create a new icon file.
  • Register the new icon file. Modification needed to src/Mod/Fem/Gui/Resources/Fem.qrc
  • Create a new command class. Modification needed to src/Mod/Fem/femcommands/commands.py
  • Add new command to workbench. Modification needed to src/Mod/Fem/Gui/Workbench.cpp

Create a new icon file

For the button, we need an icon file. You can use any of your favorite tools to create it, but it must be in the SVG format. Here we will use the FEM_testButton.svg file as an example.

It must be placed in: src/Mod/Fem/Gui/Resources/icons/.

Register the new icon file

The new SVG icon file has to be registered for the GUI button by inserting it in src/Mod/Fem/Gui/Resources/Fem.qrc:

<file>icons/FEM_testButton.svg</file>

Create a new command class

A new command class has to be added to the src/Mod/Fem/femcommands/commands.py module.

Just copy/paste an existing command, then adjust the icon, menu text and tool-tip in __init__(self):

class _testButton(CommandManager):
    "The FEM_testButton command definition"

    def __init__(self):
        super(_testButton, self).__init__()
        self.menuetext = "test Button"
        self.tooltip = "This is a test button"
        self.is_active = "always"
        #self.do_activated = "add_obj_on_gui_selobj_noset_edit"

Don't forget to register the command at the bottom of the module file with the addCommand(...) method:

FreeCADGui.addCommand(
    "FEM_testButton",
    _testButton()
)

Note: Please see this discussion thread in the forum if icons are involved.

Add new command to workbench

We will add the new command to both the solve toolbar and the solve menu.

Search for the following code snippet in /Gui/Workbench.cpp and add the new command:

Gui::ToolBarItem* solve = new Gui::ToolBarItem(root);
     solve->setCommand("Solve");
     *solve << "FEM_SolverCalculixCxxtools"
            << "FEM_SolverCalculiX"
            << "FEM_SolverElmer"
+           << "FEM_testButton"
            << "Separator"

To add the command to the solve menu of the FEM workbench, search for the following code snippet in Workbench.cpp:

Gui::MenuItem* solve = new Gui::MenuItem;
    root->insertItem(item, solve);
    solve->setCommand("&Solve");
    *solve << "FEM_SolverCalculixCxxtools"
           << "FEM_SolverCalculiX"
           << "FEM_SolverElmer"
           << "FEM_SolverZ88"
+          << "FEM_testButton"
           << "Separator"

Result: You should have just successfully added a test button to a FEM workbench toolbar and menu. Now, you can compile FreeCAD and test your new button.

Related