{"id":3614,"date":"2025-10-03T22:40:36","date_gmt":"2025-10-03T20:40:36","guid":{"rendered":"https:\/\/davidka.net\/?p=3614"},"modified":"2025-10-24T12:40:44","modified_gmt":"2025-10-24T09:40:44","slug":"lektion-5-speichern-und-laden-von-einstellungen","status":"publish","type":"post","link":"http:\/\/de.davidka.net\/de\/lektion-5-speichern-und-laden-von-einstellungen\/","title":{"rendered":"Lektion 5. Speichern und Laden von Einstellungen"},"content":{"rendered":"\n

Lernziel:<\/strong> Das \u201eBox Builder\u201c-Addon soll sich die zuletzt eingegebenen Abmessungen merken und beim n\u00e4chsten Start wiederherstellen.<\/p>\n\n\n\n

\n\n\n\n

Teil 1. Wie speichert FreeCAD Einstellungen?<\/strong>
FreeCAD bietet einen integrierten Mechanismus zum Speichern von Benutzerparametern \u2013 \u00fcber den Parameter Manager<\/strong>.<\/p>\n\n\n\n

Dieser arbeitet mit einer hierarchischen Parameterdatenbank, \u00e4hnlich der Windows-Registry.<\/p>\n\n\n\n

Wichtige Methoden:<\/p>\n\n\n\n

# Abrufen einer Parametergruppe\nparams = FreeCAD.ParamGet("User parameter:BaseApp\/Preferences\/MyAddon")\n\n# Wert speichern\nparams.SetFloat("LastLength", 30.0)\nparams.SetString("LastName", "MyBox")\n\n# Wert laden (mit Standardwert)\nlength = params.GetFloat("LastLength", 10.0)  # 10.0, falls der Parameter nicht existiert\nname = params.GetString("LastName", "DefaultBox")<\/code><\/pre>\n\n\n\n
Der Pfad "User parameter:BaseApp\/Preferences\/..."<\/code> ist der Standardort f\u00fcr Benutzereinstellungen<\/strong>.<\/p>\n\n\n\n
\n\n\n\n
Teil 2. Aktualisiertes Addon: \u201eBox Builder mit Speicherfunktion\u201c<\/strong>
Wir erweitern das bisherige Addon um das Speichern und Laden der letzten Werte.<\/p>\n\n\n\n
Datei box_builder_workbench.py<\/code> (aktualisierte Version):<\/strong><\/p>\n\n\n\n
# box_builder_workbench.py\nimport FreeCAD, FreeCADGui\nfrom PySide import QtGui, QtCore\n\n# === PFAD ZU DEN EINSTELLUNGEN ===\nPARAM_PATH = "User parameter:BaseApp\/Preferences\/BoxBuilderAddon"\n\ndef get_saved_settings():\n    """L\u00e4dt gespeicherte Einstellungen oder gibt Standardwerte zur\u00fcck"""\n    params = FreeCAD.ParamGet(PARAM_PATH)\n    return {\n        "length": params.GetFloat("LastLength", 30.0),\n        "width": params.GetFloat("LastWidth", 20.0),\n        "height": params.GetFloat("LastHeight", 10.0),\n        "name": params.GetString("LastName", "CustomBox")\n    }\n\ndef save_settings(length, width, height, name):\n    """Speichert aktuelle Einstellungen"""\n    params = FreeCAD.ParamGet(PARAM_PATH)\n    params.SetFloat("LastLength", length)\n    params.SetFloat("LastWidth", width)\n    params.SetFloat("LastHeight", height)\n    params.SetString("LastName", name)\n\n# === BOX-ERSTELLUNGSFUNKTION ===\ndef create_box(length, width, height, name="CustomBox"):\n    doc = FreeCAD.ActiveDocument\n    if not doc:\n        doc = FreeCAD.newDocument("BoxBuilder")\n\n    # Eindeutiger Name\n    base_name = name\n    index = 1\n    obj_name = base_name\n    while obj_name in [obj.Name for obj in doc.Objects]:\n        obj_name = f"{base_name}_{index}"\n        index += 1\n\n    box = doc.addObject("Part::Box", obj_name)\n    box.Length = length\n    box.Width = width\n    box.Height = height\n    doc.recompute()\n    return box\n\n# === DIALOGFENSTER ===\nclass BoxBuilderDialog(QtGui.QDialog):\n    def __init__(self):\n        super(BoxBuilderDialog, self).__init__()\n        self.setWindowTitle("Box Builder")\n        self.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)\n        self.resize(300, 180)\n\n        # Gespeicherte Einstellungen laden\n        settings = get_saved_settings()\n\n        # Eingabefelder\n        self.length_input = QtGui.QLineEdit(str(settings["length"]))\n        self.width_input = QtGui.QLineEdit(str(settings["width"]))\n        self.height_input = QtGui.QLineEdit(str(settings["height"]))\n        self.name_input = QtGui.QLineEdit(settings["name"])\n\n        # Schaltfl\u00e4chen\n        self.create_button = QtGui.QPushButton("Box erstellen")\n        self.cancel_button = QtGui.QPushButton("Abbrechen")\n\n        # Verbindungen\n        self.create_button.clicked.connect(self.on_create)\n        self.cancel_button.clicked.connect(self.reject)\n\n        # Layout\n        layout = QtGui.QFormLayout()\n        layout.addRow("Name:", self.name_input)\n        layout.addRow("L\u00e4nge (mm):", self.length_input)\n        layout.addRow("Breite (mm):", self.width_input)\n        layout.addRow("H\u00f6he (mm):", self.height_input)\n\n        button_layout = QtGui.QHBoxLayout()\n        button_layout.addWidget(self.create_button)\n        button_layout.addWidget(self.cancel_button)\n\n        main_layout = QtGui.QVBoxLayout()\n        main_layout.addLayout(layout)\n        main_layout.addLayout(button_layout)\n        self.setLayout(main_layout)\n\n    def on_create(self):\n        try:\n            name = self.name_input.text().strip()\n            if not name:\n                name = "CustomBox"\n            length = float(self.length_input.text())\n            width = float(self.width_input.text())\n            height = float(self.height_input.text())\n\n            if length <= 0 or width <= 0 or height <= 0:\n                raise ValueError("Alle Abmessungen m\u00fcssen positiv sein")\n\n            # Objekt erstellen\n            create_box(length, width, height, name)\n\n            # Einstellungen speichern\n            save_settings(length, width, height, name)\n            self.accept()\n\n        except ValueError as e:\n            QtGui.QMessageBox.warning(self, "Eingabefehler", f"Ung\u00fcltige Eingabe:\\n{str(e)}")\n\n# === BEFEHL UND ARBEITSUMGEBUNG (unver\u00e4ndert) ===\nclass BoxBuilderCommand:\n    def GetResources(self):\n        return {\n            "MenuText": "Box Builder",\n            "ToolTip": "Erstelle eine Box mit benutzerdefinierten Abmessungen"\n        }\n\n    def Activated(self):\n        dialog = BoxBuilderDialog()\n        dialog.exec_()\n\n    def IsActive(self):\n        return True\n\nclass BoxBuilderWorkbench(FreeCADGui.Workbench):\n    MenuText = "Box Builder"\n    ToolTip = "Erstelle benutzerdefinierte Boxen mit grafischer Oberfl\u00e4che"\n\n    def Initialize(self):\n        self.list = ["BoxBuilderCommand"]\n        self.appendToolbar("Box-Werkzeuge", self.list)\n        self.appendMenu("Box Builder", self.list)\n\n    def GetClassName(self):\n        return "Gui::PythonWorkbench"\n\nFreeCADGui.addCommand("BoxBuilderCommand", BoxBuilderCommand())<\/code><\/pre>\n\n\n\n
\n\n\n\n
Was hat sich ge\u00e4ndert?<\/strong><\/p>\n\n\n\n
    \n
  1. Funktionen hinzugef\u00fcgt:<\/strong><\/li>\n<\/ol>\n\n\n\n
      \n
    • get_saved_settings()<\/code> \u2013 l\u00e4dt die letzten Werte<\/li>\n\n\n\n
    • save_settings()<\/code> \u2013 speichert die aktuellen Werte<\/li>\n<\/ul>\n\n\n\n
        \n
      1. Pfad zu den Parametern:<\/strong>
        \u2192 Alle Einstellungen werden in einer separaten Gruppe gespeichert, ohne andere Addons zu beeintr\u00e4chtigen.<\/li>\n\n\n\n
      2. Namensfeld zur Benutzeroberfl\u00e4che hinzugef\u00fcgt.<\/strong><\/li>\n\n\n\n
      3. Beim Start des Fensters<\/strong> werden die Felder mit gespeicherten Werten ausgef\u00fcllt.<\/li>\n\n\n\n
      4. Nach der Erstellung<\/strong> werden die aktuellen Werte automatisch gespeichert.<\/li>\n<\/ol>\n\n\n\n
        \n\n\n\n
        Funktionspr\u00fcfung<\/strong><\/p>\n\n\n\n
          \n
        1. FreeCAD starten<\/li>\n\n\n\n
        2. Box Builder \u00f6ffnen<\/li>\n\n\n\n
        3. Beispielwerte eingeben:<\/li>\n<\/ol>\n\n\n\n
            \n
          • Name: MyTestBox<\/code><\/li>\n\n\n\n
          • L\u00e4nge: 50<\/code><\/li>\n\n\n\n
          • Breite: 30<\/code><\/li>\n\n\n\n
          • H\u00f6he: 20<\/code><\/li>\n<\/ul>\n\n\n\n
              \n
            1. Auf \u201eBox erstellen\u201c klicken<\/li>\n\n\n\n
            2. FreeCAD schlie\u00dfen<\/li>\n\n\n\n
            3. Erneut starten<\/li>\n\n\n\n
            4. Box Builder \u00f6ffnen<\/li>\n<\/ol>\n\n\n\n
              \u2192 Die Felder sollten mit denselben Werten ausgef\u00fcllt sein!<\/p>\n\n\n\n
              \n\n\n\n
              Wo werden diese Einstellungen gespeichert?<\/strong><\/p>\n\n\n\n
                \n
              • Windows:<\/strong> In der Registry (HKEY_CURRENT_USER\\SOFTWARE\\FreeCAD\\...<\/code>)<\/li>\n\n\n\n
              • Linux\/macOS:<\/strong> In der Datei user.cfg<\/code> im FreeCAD-Ordner<\/li>\n<\/ul>\n\n\n\n
                Aber du musst das nicht wissen \u2013 FreeCAD verwaltet den Speicherort selbstst\u00e4ndig.<\/p>\n\n\n\n
                \n\n\n\n
                Praktische Aufgabe<\/strong><\/p>\n\n\n\n
                  \n
                1. F\u00fcge ein Kontrollk\u00e4stchen \u201eAm Ursprung zentrieren\u201c<\/strong> hinzu und speichere dessen Zustand zwischen den Sitzungen.<\/li>\n\n\n\n
                2. Stelle sicher, dass beim ersten Start des Addons sinnvolle Standardwerte verwendet werden (bereits implementiert).<\/li>\n\n\n\n
                3. F\u00fcge eine Schaltfl\u00e4che \u201eAuf Standard zur\u00fccksetzen\u201c<\/strong> hinzu, die die Felder auf Standardwerte setzt und gespeicherte Einstellungen l\u00f6scht.<\/li>\n<\/ol>\n\n\n\n
                  Hinweis zum Zur\u00fccksetzen:<\/strong><\/p>\n\n\n\n
                  def reset_settings():\n    params = FreeCAD.ParamGet(PARAM_PATH)\n    params.RemGroup("BoxBuilderAddon")  # L\u00f6scht die gesamte Gruppe<\/code><\/pre>\n\n\n\n
                  \n\n\n\n
                  Tipps<\/strong><\/p>\n\n\n\n
                    \n
                  • Gib immer einen Standardwert<\/strong> in GetFloat()<\/code>, GetString()<\/code> usw. an.<\/li>\n\n\n\n
                  • Speichere nicht zu viel<\/strong> \u2013 nur das, was der Benutzer wirklich braucht.<\/li>\n\n\n\n
                  • Verwende einen eindeutigen Pfad<\/strong> (BoxBuilderAddon<\/code>), um Konflikte mit anderen Addons zu vermeiden.<\/li>\n<\/ul>\n\n\n\n
                    \n\n\n\n
                    Was kommt als N\u00e4chstes?<\/strong>
                    In Lektion 6<\/strong> werden wir:<\/p>\n\n\n\n
                      \n
                    • Symbole zu Schaltfl\u00e4chen und der Arbeitsumgebung hinzuf\u00fcgen<\/li>\n\n\n\n
                    • Lernen, wie man SVG und PNG in der Benutzeroberfl\u00e4che verwendet<\/li>\n\n\n\n
                    • Das Addon optisch ansprechend gestalten<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
                      Lernziel: Das \u201eBox Builder\u201c-Addon soll sich die zuletzt eingegebenen Abmessungen merken und beim n\u00e4chsten Start wiederherstellen.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[],"tags":[],"class_list":["post-3614","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3614","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/comments?post=3614"}],"version-history":[{"count":0,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3614\/revisions"}],"wp:attachment":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/media?parent=3614"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/categories?post=3614"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/tags?post=3614"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}