BRC32.EXE, le Shell de ressources

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilitaires de ligne de commande - Index

BRC32.EXE est le shell du compilateur de ressources en ligne de commande. Il invoque BRCC32 (compilateur de ressources) et RLINK32 (lieur de ressources), selon la syntaxe de la ligne de commande.

Syntaxe de la ligne de commande

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


Eléments de la ligne de commande

Elément Description

<options>

Options de la ligne de commande. Elles sont facultatives.

<filename>.RC

Définit un fichier script de ressources (.RC) à compiler. Ce fichier doit être spécifié.

<filename>.EXE

Définit le nom du fichier exécutable .EXE de sortie. Facultatif.


Pour afficher l'aide de la ligne de commande, entrez :

brc32

ou ajoutez l'indicateur d'aide :

brc32 -h

Options de la ligne de commande

BRC32.EXE prend en charge les options de ligne de commande listées dans le tableau suivant :

               Options de la ligne de commande BRC32
Option Description

-h ou /h

Affiche le message d'aide.

-d<name>[=string]

Définit le symbole de préprocesseur name, que vous pouvez tester avec la
directive de préprocesseur C++ #IFDEF name.

-fo<filename>

Définit le nom <filename> du fichier de ressources .RES de sortie. Par défaut, BRC32 crée le fichier .RES de sortie avec le même nom que le fichier .RC d'entrée.

-fe<filename>

Définit le nom <filename> du fichier exécutable .EXE de sortie.

-i<path>

Ajoute un ou plusieurs répertoires (path, séparés par des points-virgules) au chemin de recherche d'inclusion. Par exemple :

-i"C:\Program Files (x86)\Embarcadero\Studio\21.0\lib\debug";C:\MyUnits
-k

Désactive le préchargement contigu des segments et des ressources dans le fichier .EXE. Les segments sont conservés dans l'ordre dans lequel ils apparaissent dans le fichier .DEF. Cette option s'applique seulement aux ressources 16 bits et elle est désactivée quand l'option -r est effective.

-r

Compile seulement les ressources et crée un fichier .RES. Ne lie pas les ressources compilées au fichier exécutable .EXE.

-v

Affiche des messages de progression (mode "bavard").

-x

Indique au compilateur d'ignorer la variable d'environnement INCLUDE lors de la recherche de fichiers de ressources ou d'inclusion.

-32

Construit des fichiers .RES and .EXE compatibles Windows 32 bits.
C'est l'option par défaut.

-16

Construit des fichiers .RES compatibles Windows 16 bits

-V<n.m>

Construit le fichier .EXE avec la version Windows fournie (4.0 est la valeur par défaut). Les options de version sont listées dans le tableau suivant :


Options de version (utilisées avec l'option -V<n.m>)

Valeur n.m Bits Aspect résultant
3.1

16

Donne un arrière-plan blanc sans aspect 3-D pour Windows 3.1x, Windows 32s ou WinNT 3.1.

4.0

16

Donne un aspect 3-D grisé pour Windows 95 et WinNT 3.51.

3.1

32

Donne un arrière-plan blanc sans aspect 3-D pour Windows 32s ou WinNT 3.1.

4.0

32

Donne un aspect 3-D grisé pour Windows 95 et WinNT 3.51.


Options pour la compatibilité descendante

Option Description
-t

Ignorée.

-31

Construit des fichiers .RES compatibles Windows 3.1.

-w32

Construit des fichiers .RES et .EXE compatibles Win32.


Exemples de shell de ressources

L'instruction suivante compile le fichier .RC, crée un fichier .RES et ajoute le fichier .RES au fichier exécutable :

brc32 <filename>.RC <filename>.EXE

BRC32 recherche automatiquement un fichier .EXE de même nom que le fichier .RC. Vous devez spécifier le fichier .EXE seulement si son nom est différent de celui du fichier .RC.

L'instruction suivante crée un fichier .RES, mais pas un fichier .EXE. Si vous nommez un fichier .EXE dans la ligne de commande, BRC32 l'ignore :

brc32 -r <filename>.EXE

L'instruction suivante ajoute un fichier .RES existant à un fichier exécutable. Le nom du fichier .EXE est obligatoire seulement s'il est différent du nom du fichier .RES :

brc32 <filename>.RES <filename>.EXE

Cet exemple utilise BRC32 pour construire un fichier .RES compatible Windows 3.1 16 bits :

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

Voir aussi