Resource Compiler (rcc)
Das Tool „ rcc “ dient dazu, Ressourcen während des Build-Prozesses in eine Qt-Anwendung einzubetten. Es generiert dazu eine C++-Quelldatei, die die in einer Qt-Ressourcendatei (.qrc) angegebenen Daten enthält.
Verwendung:
rcc [options] <inputs>RCC akzeptiert die folgenden Befehlszeilenoptionen:
| Option | Argument | Beschreibung |
|---|---|---|
-o | file | Schreibt die Ausgabe an file statt an stdout. |
-g, --generator | <cpp|python|python2> | Generator auswählen. |
-name | name | Erstellt eine externe Initialisierungsfunktion mit „ name “. |
-threshold | level | Legt einen Schwellenwert level (in Prozent) fest, der bei der Entscheidung über die Komprimierung einer Datei herangezogen wird. Wenn die Reduzierung der Dateigröße größer ist als der Schwellenwert level, wird die Datei komprimiert; andernfalls werden stattdessen die unkomprimierten Daten gespeichert. Der Standardschwellenwert beträgt 70 %, was bedeutet, dass komprimierte Dateien, deren Größe 30 % oder weniger der ursprünglichen Größe beträgt, als komprimierte Daten gespeichert werden. |
-compress-algo | algorithm | Der Algorithmus, mit dem Dateien komprimiert werden sollen. Unterstützte Algorithmen sind zstd, zlib und none, was jeweils bedeutet, dass der Inhalt mithilfe der Zstandard-Bibliothek, der zlib- Bibliothek bzw. ohne Komprimierung komprimiert wird. Der Standardwert ist zstd, wenn diese Bibliothek zur Kompilierungszeit gefunden wurde, andernfalls zlib. |
-compress | level | Komprimiert Eingabedateien mit dem angegebenen Kompressions level, der algorithmusabhängig ist. Wenn der Algorithmus „ zstd “ ist, sind die gültigen Stufen 1 bis 19, wobei die Sonderwerte 0 und -1 die Standardkompressionen von „ libzstd “ bzw. „ rcc “ bedeuten. Wenn der Algorithmus „ zlib “ ist, ist die Stufe eine ganze Zahl im Bereich von 1 bis 9. Bei beiden Algorithmen führt Stufe 1 die geringste Komprimierung durch, ist aber am schnellsten. Die Stufen 9 oder 19 führen die stärkste Komprimierung durch, sind aber am langsamsten. Um die Komprimierung zu deaktivieren, verwenden Sie „ -no-compress “. Der Standardwert für „ level “ ist -1. |
-root | path | Stellen Sie dem Zugriffspfad auf die Ressource das Präfix „ path “ voran. Standardmäßig wird kein Präfix verwendet. |
-no-compress | Deaktivieren Sie die Komprimierung. | |
--no-zstd | Deaktivieren Sie die Verwendung der „ zstd “-Komprimierung. | |
--pass | <number> | Nummer für große Ressourcen übergeben |
-binary | Eine Binärdatei zur Verwendung als dynamische Ressource ausgeben. | |
-version | Zeigen Sie Versionsinformationen an. | |
-help | Verwendungsinformationen anzeigen. | |
-t, --temp <file> | Verwenden Sie eine temporäre <Datei> für große Ressourcen. | |
--namespace | Deaktiviert Namespace-Makros. | |
--verbose | Ausführlichen Modus aktivieren. | |
--list | Nur Einträge der .qrc-Datei auflisten, keinen Code generieren. | |
--list-mapping | Gibt nur eine Zuordnung von Ressourcenpfaden zu Dateisystempfaden aus, die in der .qrc-Datei definiert sind; generiert keinen Code. | |
-d, --depfile | <file> | Schreiben Sie eine Depfile-Datei mit den .qrc-Abhängigkeiten in <Datei>. |
-project | Eine Ressourcendatei ausgeben, die alle Dateien aus dem aktuellen Verzeichnis enthält. | |
--format-version | <number> | Die Version des RCC-Formats, die geschrieben werden soll. |
Weitere Informationen zum Einbetten von Ressourcen in Qt-Anwendungen finden Sie unter „Das Qt-Ressourcensystem “.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
