Skip to content
ispyisail edited this page Sep 11, 2026 · 1 revision

Den Element-Editor benutzen

Elemente verknΓΌpfen dokumentiert die .elmt-Datei, die beim Erstellen eines Elements entsteht β€” Master/Slave/Klemme, Kontaktgruppen, Informationsschalter. Diese Seite dokumentiert die andere HΓ€lfte: ein Element im eingebauten Editor von QET tatsΓ€chlich zeichnen.

Quelle: sources/editor/ (~22.900 Zeilen) β€” qetelementeditor.cpp (das Fenster), elementscene.cpp (die ZeichenflΓ€che), graphicspart/ (eine Klasse je zeichenbarer Primitive), esevent/ (die interaktiven Platzierungswerkzeuge), ui/ (die Eigenschaftenfelder).


1. Ein Element beginnen

Neues Element ΓΆffnet einen dreistufigen Assistenten:

  1. Übergeordnete Kategorie β€” wo im Sammlungsbaum das Element leben wird.
  2. Dateiname β€” die Endung *.elmt wird automatisch ergΓ€nzt, wenn Sie sie weglassen.
  3. Name(n) β€” der Anzeigename des Elements, je einer pro Sprache; nur Ihre aktuelle OberflΓ€chensprache ist erforderlich, die ΓΌbrigen lassen sich spΓ€ter ergΓ€nzen.

Der Editor ΓΆffnet mit einer leeren ZeichenflΓ€che. Es gibt keinen eigenen Schritt β€žGrâße des Elements festlegen" β€” siehe Β§3.

Sie kΓΆnnen auch ein vorhandenes Element zum Bearbeiten ΓΆffnen, oder mit einer ΓΌber Datei β†’ DXF-Datei importieren eingelesenen DXF-Datei als Strichzeichnung in einem neuen Element beginnen β€” ein Weg, CAD-Geometrie nachzuzeichnen statt von Grund auf zu zeichnen.


2. Die Zeichenwerkzeuge

Eine SymbolleistenschaltflΓ€che je Primitivtyp:

Werkzeug Zeichnet
Linie eine gerade Strecke
Rechteck Ecke-zu-Ecke ziehen
Ellipse einen Begrenzungsrahmen ziehen
Vieleck jeden Eckpunkt anklicken; Doppelklick zum Abschließen, Rechtsklick, um den letzten Punkt rückgÀngig zu machen
Bogen einen Kreisbogen
Text eine feste Beschriftung, nach dem Platzieren auf einem Folio nicht mehr bearbeitbar
Dynamisches Textfeld ein Text, der sich je Instanz auf einem Folio bearbeiten lΓ€sst β€” hier setzen Elementinformationen und Formelvariablen an, siehe Variablen und Formeln
Klemme ein Anschlusspunkt

Klemmen platzieren

Eine Klemme braucht eine Ausrichtung β€” auf welcher Seite des KΓΆrpers sie heraustritt und damit, aus welcher Richtung ein Draht sie erreichen darf. WΓ€hrend des Platzierens drehen Sie sie mit der Leertaste durch die vier Himmelsrichtungen, bevor Sie mit einem Klick bestΓ€tigen.

Nach dem Setzen einer Klemme beginnt das Werkzeug sofort die nΓ€chste mit derselben Ausrichtung β€” praktisch fΓΌr eine Reihe gleich ausgerichteter Pins. Ein Rechtsklick beendet das Werkzeug.

Typ und Funktion der Klemme (generisch, Sicherung, Diode, Erde …) werden anschließend in ihren eigenen Eigenschaften eingestellt, nicht beim Platzieren β€” siehe Elemente verknΓΌpfen Β§4.


3. Breite, HΓΆhe und Ankerpunkt werden berechnet, nicht eingegeben

Es gibt keinen Dialog, in dem Sie Breite, HΓΆhe oder Ankerpunkt des Elements eintragen. Sie werden automatisch aus dem Gezeichneten abgeleitet und bei jedem Speichern neu berechnet:

  • Das Begrenzungsrechteck aller Primitive auf der ZeichenflΓ€che wird gemessen.
  • Breite und HΓΆhe werden aufgerundet auf das nΓ€chste Vielfache von 10 β€” mit einer Besonderheit: BetrΓ€gt der Rest mehr als 6, wird ein weiterer Zehner aufgerundet. Eine 42 px breite Zeichnung wird zu 50 (genau das Beispiel, das Elements XML fΓΌr die Rundung nennt β€” jetzt wissen Sie, woher die Zahl stammt).
  • Der Ankerpunkt wird in die Mitte dieses gerundeten Begrenzungsrechtecks gelegt.

Die Falle: Fernab vom Szenenursprung zeichnen verschiebt die Teile

Überlappt Ihre Zeichnung nicht den Ursprungspunkt (0,0) der Szene, zentriert QET beim Speichern jede Primitive neu, damit das der Fall ist β€” Teile bewegen sich tatsΓ€chlich auf der ZeichenflΓ€che, nicht nur in den gespeicherten Koordinaten. Zeichnen Sie bequem nahe am Fadenkreuz in der Mitte der ZeichenflΓ€che, und das ΓΌberrascht nie; zeichnen Sie weit an einer Seite, und ein Speichern kann sichtbar alles verschieben.


4. Speichern

Drei verwandte Aktionen, leicht zu verwechseln:

Aktion Ziel
Speichern dorthin, woher das Element geΓΆffnet wurde β€” ein Sammlungsort, wenn es aus dem Elementpanel geΓΆffnet wurde, ein einfacher Dateipfad, wenn es ΓΌber eine Datei geΓΆffnet wurde
Speichern unter fragt nach einem Sammlungsort (Kategorie + Name), der ΓΌbliche Weg, ein neues Element in Ihrer eigenen Sammlung zu speichern
Speichern unter (Datei) fragt nach einem gewâhnlichen Dateisystempfad, außerhalb jeder Sammlung

Alle drei fΓΌhren zuerst dieselbe PrΓΌfung aus (Β§5); scheitert sie, wird das Speichern verhindert und keine der drei schreibt etwas.


5. Was vor dem Speichern geprΓΌft wird

QET prΓΌft das Element und meldet Probleme entweder als Warnung (Speichern lΓ€uft weiter) oder als Fehler (Speichern wird verhindert):

Bedingung Schwere
Überhaupt keine Klemmen Warnung β€” außer bei Folioverweisen, Leiterdefinitionen oder Vorschaubildern, die berechtigterweise keine haben dΓΌrfen
Ein Folioverweis-Element hat etwas anderes als genau eine Klemme Fehler
Eine Leiterdefinition hat etwas anderes als genau eine Klemme Fehler

Ein Element ohne jede Klemme wird trotzdem gespeichert β€” Sie erhalten lediglich einen Hinweis, dass es mit nichts verbunden werden kann, was manchmal genau das GewΓΌnschte ist (ein Vorschaubild, ein Textblock, eine Schriftfeld-Verzierung).


6. Über die Grundlagen hinaus

  • SPS-Master-Tabellen. Den Typ eines Master-Elements auf SPS zu setzen, ersetzt die ΓΌblichen Kontaktbudget-Einstellungen durch eine interaktive E/A-Tabelle β€” siehe Elemente verknΓΌpfen Β§5. Kein Element der ausgelieferten Sammlung nutzt diese Funktion derzeit.
  • Der Linienstil (StΓ€rke, Farbe, Strichmuster) wird je Primitive im eigenen Eigenschaftenfeld eingestellt, nicht ΓΌber die Symbolleiste.
  • Raster und Einrasten funktionieren wie im Folio-Editor.

Siehe auch: Elemente verknΓΌpfen Β· Elements XML Β· DXF-Import und -Export Β· Variablen und Formeln

Getting Started

Home

🌐 Languages β€” English Β· FranΓ§ais Β· Deutsch

Downloads

Windows without admin rights β€” the portable archive, no installer

Quick Start Guide

User Manual

FAQ

Tips & Tricks

Guides

Conductors β€” wire properties, what feeds which export, cables, and hops where wires cross

Wires per terminal β€” limit the wires on a terminal, chain wiring instead of stars

Printing and exporting β€” paper, PDF, images, and what each path does differently

Linking elements β€” master, slave, terminal

PLC modules β€” I/O tables and linking a wire to a specific point

Using the element editor β€” drawing tools, saving, checks

Generic devices β€” a quick box symbol with terminals on any side, made by a wizard (pending)

Grid size and element size β€” why symbols aren't all the same scale, and scaling one without leaving the grid

Preferences reference β€” what each settings page does

Saving and loading settings β€” your whole setup in one file, to copy or keep

Keyboard-only control β€” mouseless QET, and what still needs a mouse

Mouse modifiers β€” what Shift, Ctrl and Alt change while you drag

3D mouse β€” SpaceMouse pan, zoom and buttons

Aligning items β€” snap symbols back to the grid, or line them up

Pictures on a sheet β€” labels, crop, transparency, what they cost in the file

Arcs and curved wires β€” the Arc tool, pulling an arc in or out, rounding a corner with a fillet, dashed arcs for lighting layouts

Grouping items β€” select, move and copy several items as one

Finding your place on a sheet β€” go to a cell like B13 or 4-B7, keep the headers in sight, show the cell limits, zoom and pan

Showing and hiding kinds of items β€” hide texts, wire numbers, shapes, pictures, tables or cross-references on every sheet

Drawing faster β€” place without dragging, the S shortcut bar, command search, gestures

Customising QElectroTech β€” keys, toolbar size and contents, the gesture ring (partly pending)

Managing collections β€” folders, writability, building your own shortlist

Templates β€” reusable multi-element blocks, placed by double-click or drag

Search & Replace β€” bulk property changes

Building a nomenclature query β€” the BOM/summary table builder

Linking wires across pages β€” sheet reports

Variables & formulas β€” %f, %{label}, sequences

Auto-numbering β€” schemes, sequences, freezing

Terminal strips β€” strips, levels, bridges

Title block templates β€” the .titleblock format

Importing EPLAN parts (.edz) β€” EPLAN Data Portal

DXF import & export β€” two unrelated features, one format; command-line export and layers

The project database β€” the in-memory SQLite cache

File formats
Elements XML
Project XML
Development

Building from Source

Contributing Code

Automating QET β€” CLI, XML formats, external tools

CLI Reference β€” command line usage

JavaScript Scripting β€” --run, geometry editing, undo

MCP server β€” let an AI assistant read, verify and edit projects

Connecting an AI assistant β€” setup for Claude, Copilot, Gemini, Codex, Cursor, LM Studio

Script buttons β€” stored scripts with an icon, by hand or by an assistant

Live mode β€” an assistant working in the open project while you watch

Macro recorder β€” record a task by hand, for an assistant to script

Development Roadmap

Vision β€” proposal, under discussion

Developer Tools

About

Features

History

Community

License

Contributing to this Wiki

Clone this wiki locally