mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-10-06 03:04:13 +02:00
Jeff Patterson
20ee3383d3
Each folder now holds icons from one source: qet/ for QET's own SVGs, breeze/ for KDE Breeze (with breeze/added/), flags/, colors/, and themes/ for script output (with themes/generated/). The unused 128x128/terminalstrip.svg is removed. The generator, qrc files, qeticons.cpp and ico/copyright follow the new paths. ico/README.md lists each folder's source, script and license. Part of #1269.
38 lines
2.4 KiB
Markdown
38 lines
2.4 KiB
Markdown
# 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
|
|
|
|
1. Put the SVG in `qet/scalable/` and add it to `SVGS` in
|
|
`misc/make_icon_themes.py`. For a Breeze icon, add its name to
|
|
`BREEZE` there instead and run `misc/import_breeze_icons.py`.
|
|
2. Run `python3 misc/make_icon_themes.py`.
|
|
3. Load it with `QIcon::fromTheme("<name>")`.
|
|
4. Credit it in `copyright`.
|