BRCC32.EXE: Der Ressourcen-Compiler

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Befehlszeilenhilfsprogramme - Index

BRCC32 ist die Befehlszeilenversion des Ressourcen-Compilers. Er verarbeitet eine Ressourcen-Skriptdatei (.RC) und erzeugt daraus eine Ressourcendatei mit Objektcode (.RES).

RAD Studio ermöglicht die Auswahl eines Ressourcen-Compilers. Sie können einen der beiden folgenden Compiler auswählen:

  • BRCC32
  • RC.EXE (der Ressourcen-Compiler von Windows SDK)

Sie wählen den Compiler im Dialogfeld Projekt > Optionen > Ressourcen-Compiler aus.

Wenn Sie den Ressourcen-Compiler von Windows SDK auswählen, wird der Zwischen-Compiler CGRC.EXE aufgerufen, aber CGRC ruft seinerseits RC.EXE auf.

In der Befehlszeile können Sie aber einen der drei Ressourcen-Compiler verwenden:

  • BRCC32.EXE
  • CGRC.EXE
  • RC.EXE


Befehlszeilensyntax

BRCC32 [<options>] <filename>.RC

Befehlszeilenelemente

Element Beschreibung

<Optionen>

Befehlszeilenoptionen. Optional.

<Dateiname>.RC

Definiert eine Ressourcen-Skriptdatei (.RC), die compiliert werden soll. Diese Datei muss angegeben werden.


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

brcc32

Oder fügen Sie das Hilfe-Flag hinzu:

brcc32 -h

Befehlszeilenoptionen

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


Befehlszeilenoptionen für BRCC32

Option Beschreibung

-h or ?

Zeigt die Hilfemeldung an.

@<Resp-Datei>

Übernimmt Anweisungen aus der angegebenen Befehlsdatei.

-c<Codeseite>

Verwendet die angegebene Codeseite Codeseite zur Ressourcenübersetzung. Wenn -c nicht angegeben ist, wird die ANSI-Codeseite benutzt.

-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 für die Ausgaberessourcendatei (.RES). (Standardmäßig erstellt BRCC32 die Ausgabedatei (.RES) mit demselben Namen wie die Eingabedatei (.RC)).

-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

-l<Sprache>

Legt die Standardsprache fest.

-m

Gibt an, dass die Codeseite, die mit der Option -c vorgegeben wurde, DBCS-Zeichen (Double-Byte Character Set) enthält.

-r

Diese Option wird ignoriert. Sie dient nur der Kompatibilität zu anderen Ressourcen-Compilern.

-v

Gibt während des Compilierens Statusmeldungen (Verbose) aus.

-x

Löscht den aktuellen Include-Pfad.

-16

Erzeugt mit 16-Bit-Windows kompatible Ressourcendateien (.RES).

-32

Erzeugt mit 32-Bit-Windows kompatible .RES- und .EXE-Dateien.
Dies ist die Vorgabeoption.


BRCC32 führt die Vordefinition der gängigsten ressourcenspezifischen Windows-Konstanten, wie WS_VISIBLE und BS_PUSHBUTTON, aus. Außerdem werden zwei spezielle Compiler-Symbole definiert: RC_INVOKED und WORKSHOP_INVOKED. Diese Symbole können im Quelltext in Verbindung mit bedingten Präprozessor-Direktiven verwendet werden, um die Compilierung zu steuern.

Beispielsweise kann die Compilierung mit dem folgenden Konstrukt erheblich beschleunigt werden:

#ifndef WORKSHOP_INVOKED
#include "windows.h" 
#endif 

Abwärtskompatibilität

Die folgende Syntax und die folgenden Optionen werden aus Gründen der Abwärtskompatibilität unterstützt:

Option Beschreibung

-31

Erzeugt mit Windows 3.1 kompatible Ressourcendateien (.RES).

-w32

Erzeugt mit Win32 kompatible Ressourcendateien (.RES).


Siehe auch