BRC32.EXE, le Shell de ressources
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.
Sommaire
Syntaxe de la ligne de commande
brc32 [<options>] <filename>.RC [<filename>.EXE]
Eléments de la ligne de commande
Elément | Description |
---|---|
|
Options de la ligne de commande. Elles sont facultatives. |
|
Définit un fichier script de ressources (.RC) à compiler. Ce fichier doit être spécifié. |
|
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 |
---|---|
|
Affiche le message d'aide. |
-d<name>[=string] |
Définit le symbole de préprocesseur |
-fo<filename> |
Définit le nom |
-fe<filename> |
Définit le nom |
-i<path> |
Ajoute un ou plusieurs répertoires ( -i"C:\Program Files (x86)\Embarcadero\Studio\18.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 |
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. |
-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