BRC32.EXE: Die Ressourcen-Shell

Nach oben zu Befehlszeilenhilfsprogramme - Index

BRC32.EXE ist die Shell des Befehlszeilen-Ressourcen-Compilers. BRC32.EXE ruft, abhängig von der Befehlszeilensyntax, den Ressourcen-Compiler (BRCC32) und den Ressourcen-Linker (RLINK32) auf.

Befehlszeilensyntax

brc32 [<options>] <filename>.RC [<filename>.EXE]

Befehlszeilenelemente

Element	Beschreibung
<Optionen>	Befehlszeilenoptionen. Optional.
<Dateiname>.RC	Definiert eine Ressourcen-Skriptdatei (.RC), die compiliert werden soll. Diese Datei muss angegeben werden.
<Dateiname>.EXE	Definiert den Namen für die ausführbare Ausgabedatei (.EXE). Optional.

Um die Hilfe für die Befehlszeile anzuzeigen, geben Sie Folgendes ein:

brc32

Oder fügen Sie das Hilfe-Flag hinzu:

brc32 -h

Befehlszeilenoptionen

BRC32.EXE unterstützt die in der folgenden Tabelle aufgeführten Befehlszeilenoptionen:

Befehlszeilenoptionen für BRC32

Option	Beschreibung
-h oder /h	Zeigt die Hilfemeldung an.
-d<Name>[=String]	Definiert das Präprozessorsymbol Name, das Sie mit der C++-Präprozessordirektive #IFDEF Name testen können.
-fo<Dateiname>	Definiert den Namen <Dateiname> für die Ausgaberessourcendatei (.RES). (Standardmäßig erstellt BRC32 die Ausgabedatei (.RES) mit demselben Namen wie die Eingabedatei (.RC)).
-fe<Dateiname>	Definiert den Namen <Dateiname> für die ausführbare Ausgabedatei (.EXE).
-i<Pfad>	Fügt ein oder mehrere Verzeichnisse (Pfad getrennt durch Semikolon) zum Suchpfad für Include-Dateien hinzu. Zum Beispiel: -i"C:\Program Files (x86)\Embarcadero\Studio\23.0\lib\debug";C:\MyUnits
-k	Deaktiviert das Voraus-Laden aufeinanderfolgender Segmente oder Ressourcen in der EXE-Datei. Segmente werden in der Reihenfolge bearbeitet, in der sie in der DEF-Datei vorkommen. (Diese Option gilt nur für 16-Bit-Ressourcen und wird von der Option -r deaktiviert.)
-r	Compiliert nur Ressourcen und erstellt eine .RES-Datei. Bindet die compilierten Ressourcen nicht an die ausführbare .EXE-Datei.
-v	Gibt während des Compilierens Statusmeldungen (Verbose) aus.
-x	Weist den Compiler an, während der Compilierung die Umgebungsvariable INCLUDE zu ignorieren, wenn nach Include- oder Ressourcendateien gesucht wird.
-32	Erzeugt mit 32-Bit-Windows kompatible .RES- und .EXE-Dateien. Dies ist die Vorgabeoption.
-16	Erzeugt mit 16-Bit-Windows kompatible Ressourcendateien (.RES).
-V<n.m>	Erzeugt die .EXE-Datei mit der angegebenen Windows-Version (4.0 ist die Vorgabe). Die Versionsoptionen sind in der folgenden Tabelle aufgeführt:

Versionsoptionen (für die Option -V<n.m>)

n.m-Wert	Bit	Ergebnis
3.1	16	Weißer Hintergrund, keine 3D-Darstellung für Windows 3.1x, Windows 32 oder WinNT 3.1.
4.0	16	Graue 3D-Darstellung für Windows 95 und WinNT 3.51.
3.1	32	Weißer Hintergrund ohne 3D-Darstellung für Windows 32 oder WinNT 3.1.
4.0	32	Graue 3D-Darstellung für Windows 95 und WinNT 3.51.

Optionen für die Abwärtskompatibilität

Option	Beschreibung
-t	Wird ignoriert.
-31	Erzeugt mit Windows 3.1 kompatible Ressourcendateien (.RES).
-w32	Erzeugt mit Win32 kompatible .RES- und .EXE-Dateien.

Ressourcen-Shell (Beispiele)

Mit der folgenden Anweisung wird die .RC-Datei compiliert, eine .RES-Datei erzeugt und die .RES-Datei der ausführbaren Datei hinzugefügt:

brc32 <filename>.RC <filename>.EXE

BRC32 sucht automatisch eine .EXE-Datei mit demselben Namen wie die .RC-Datei. Die .EXE-Datei muss nur dann explizit bezeichnet werden, wenn ihr Name von dem der .RC-Datei abweichen soll.

Im folgenden Beispiel wird lediglich eine .RES-Datei erzeugt, keine .EXE-Datei. Wenn Sie eine .EXE-Datei in der Befehlszeile angeben, wird dies von BRC32 ignoriert:

brc32 -r <filename>.EXE

Im folgenden Beispiel wird eine vorhandene .RES-Datei zu einer ausführbaren Datei hinzugefügt. Für die .EXE-Datei muss nur dann ein Name angegeben werden, wenn er von dem der .RES-Datei abweichen soll:

brc32 <filename>.RES <filename>.EXE

In diesem Beispiel wird eine .RES-Datei für 16-Bit-Windows 3.1 erzeugt:

brc32 -16 -V3.1 -fo<filename>.RES <filename>.RC

Siehe auch

• RLINK32.DLL: Der Ressourcen-Linker (C++)
• BRCC32.EXE: Der Ressourcen-Compiler