mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-10-10 22:24:13 +02:00
ispyisail
a3594c6633
Edit > Add > Generic device (also on the Add toolbar, and found by the
command search as diagrameditor.add_generic_device) opens a three-page
wizard for devices used too rarely to draw a symbol for, such as a VSD
or a power supply:
1. Layout: terminals per side (0 for none), a gap every N terminals,
divider marks on gaps, groups lined up across opposite sides, pitch
and extra size.
2. Terminals: a table per side and the same list as one line, where
In{4} is In1..In4, Q{z4} is Q0..Q3, X{3-6} is X3..X6 and an empty
entry is a gap; number pins 1..n counter-clockwise; paste rows of
side, name, function from a spreadsheet or a CSV file.
3. Information: name, label, manufacturer, reference, description.
A preview beside every page shows the box as it will be placed. Finish,
available from the first page, writes an ordinary symbol to the folder
"Generic devices" of the project's collection and puts it on the cursor.
The box sizes itself to its terminals and their names; every terminal
lands on the grid and gets a uuid. No new XML: any QElectroTech reads it.
The layout is pure (sources/genericdevice/genericdevice.cpp) and tested
by tst_genericdevice. ElementPictureFactory gains pictureFromDefinition()
to draw the preview with the same code as a placed element.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Icons
QElectroTech loads most icons by name from an icon theme, for example
QIcon::fromTheme("document-save"). An icon theme is a folder of icons
sorted by size, with an index.theme file that lists the sizes. QET
has two themes, qet for light windows and qet-dark for dark ones.
misc/make_icon_themes.py builds both from the source folders below.
| Folder | Contents | Source | Built by a script | License |
|---|---|---|---|---|
qet/traced/ |
QET's icons as SVG, at 16 and 22 px, with smooth versions for larger sizes | Traced from QET's former PNG icons, or drawn by contributors | No | GPL-2.0-or-later |
qet/scalable/ |
QET's SVG icons drawn on a 24 px canvas; 16/ holds 16 px versions |
Drawn by contributors | No | GPL-2.0-or-later |
qet/pages/ |
Settings page icons | Drawn by contributors | No | GPL-2.0-or-later |
breeze/ |
KDE Breeze icons, in folders by pixel size | KDE Breeze | misc/import_breeze_icons.py |
LGPL-3.0-or-later |
breeze/added/ |
16 px versions of Breeze icons that Breeze lacks or draws in another style | Drawn by contributors in the Breeze style | No | LGPL-3.0-or-later |
flags/ |
Language flags | Damien Sorel's flag pack | No | Public domain |
colors/ |
Color swatches for the element editor | Contributed in 2020 | No | GPL-2.0-or-later |
themes/ |
The qet and qet-dark themes; generated/ holds intermediate files |
Built from the folders above | misc/make_icon_themes.py |
Same as the source file |
breeze-icons/ |
App and file-type icons in the Breeze style | Nuri | No | CC-BY-ND-3.0 |
256x256/ |
QET logo for windows, the tray and the About menu; app icon | Nuri | No | CC-BY-ND-3.0 |
mac_icon/, windows_icon/ |
App and file-type icons for macOS and Windows | Nuri | No | CC-BY-ND-3.0 |
splash.png |
Splash screen | Nuri | No | CC-BY-ND-3.0 |
icon-themes.qrc lists the theme files for the Qt resource system and
is written by misc/make_icon_themes.py. Do not edit it by hand.
copyright is the Debian copyright file for the whole project. It
holds the full license and credit for each icon.
Adding an icon
- Put the SVG in
qet/scalable/and add it toSVGSinmisc/make_icon_themes.py. For a Breeze icon, add its name toBREEZEthere instead and runmisc/import_breeze_icons.py. - Run
python3 misc/make_icon_themes.py. - Load it with
QIcon::fromTheme("<name>"). - Credit it in
copyright.