BRCC32.EXE, le compilateur de ressources

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilitaires de ligne de commande - Index

BRCC32 est la version en ligne de commande du compilateur de ressources. Il accepte un fichier script de ressources (.RC) en entrée et produit un fichier objet ressource (.RES) en sortie.

RAD Studio fournit un choix en ce qui concerne les compilateurs de ressources. Vous pouvez choisir :

  • BRCC32
  • RC.EXE (le compilateur de ressources Windows SDK)

Vous réalisez ce choix sur la boîte de dialogue Projet > Options > Compilateur de ressources.

Quand vous sélectionnez le compilateur de ressources Windows SDK en tant que votre compilateur de ressources, un compilateur intermédiaire nommé CGRC.EXE est invoqué, mais CGRC invoque à son tour RC.EXE.

Vous pouvez toutefois utiliser sur la ligne de commande l'un des trois compilateurs de ressources suivants :

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


Syntaxe de la ligne de commande

BRCC32 [<options>] <filename>.RC

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é.


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

brcc32

Ou ajoutez l'indicateur d'aide :

brcc32 -h

Options de la ligne de commande

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


Options de la ligne de commande BRCC32

Option Description

-h or ?

Affiche le message d'aide.

@<response file>

Prend les instructions dans le fichier de commande spécifié.

-c<code page>

Utilise la page de code codepage spécifiée pour la traduction des ressources. Si -c n'est pas utilisé, la page de code ANSI par défaut est utilisée.

-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 du fichier de ressources .RES de sortie. Par défaut, BRCC32 crée le fichier .RES de sortie avec le même nom que le fichier .RC d'entrée.

-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\23.0\lib\debug";C:\MyUnits

-l<language>

Spécifie le langage par défaut.

-m

Indique que la page de code spécifiée avec le commutateur -c contient des caractères du jeu de caractères à deux octets (DBCS).

-r

Ce commutateur est ignoré. Il n'est inclus que pour compatibilité avec d'autres compilateurs de ressources.

-v

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

-x

Supprime le chemin d'inclusion en cours.

-16

Construit des fichiers .RES compatibles Windows 16 bits

-32

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


BRCC32 prédéfinit des constantes Windows liées aux ressources communes, telles que WS_VISIBLE et BS_PUSHBUTTON. En outre, deux symboles spéciaux liés au compilateur sont définis : RC_INVOKED et WORKSHOP_INVOKED. Ces symboles peuvent être utilisés dans le texte source avec les instructions conditionnelles du préprocesseur pour contrôler la compilation.

Par exemple, la construction suivante peut accélérer de manière significative la compilation :

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

Compatibilité descendante

La syntaxe et les options suivantes sont prises en charge à des fins de compatibilité descendante :

Option Description

-31

Construit des fichiers .RES compatibles Windows 3.1.

-w32

Construit des fichiers .RES compatibles Win32.


Voir aussi