BRC32.EXE: Die Ressourcen-Shell

Aus RAD Studio
Wechseln zu: Navigation, Suche

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\19.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