SYNOPSIS
DESCRIPTION
compiles resources from into win16 and win32 compatible
binary format.
The source-file is preprocessed with a builtin ANSI-C compatible pre-
processor before the resources are compiled. See below.
takes only one as argument. The resources are read from
standard input if no inputfile is given. If the output file is not
specified with , then will write the output to with
stripped, or to if no inputfile was given.
OPTIONS
=
Set debug level to . The value is a bitmask consisting of
1=verbose, 2=dump internals, 4=resource parser trace, 8=prepro-
cessor messages, 16=preprocessor scanner and 32=preprocessor
parser trace.
=
Win32 only; set output byte-ordering, where is one of
n[ative], l[ittle] or b[ig]. Only resources in source-form can
be reorderd. Native ordering depends on the system on which
was built. You can see the native ordering by typing .
, =
Define preprocessor identifier to (optionally) value .
See also below.
Preprocess only. The output is written to standard output if no
outputfile was selected. The output is compatible with what gcc
would generate.
,
Ignored for compatibility with .
,
Prints a summary message and exits.
, =
The name of the input file. If this option is not used, then
will use the first non-option argument as the input file name.
If there are no non-option arguments, then will read from
standard input.
, =
Add to include search directories. may contain multi-
ple directories, separated with ':'. It is allowed to specify
multiple times. Include files are searched in the order in with
the options were specified.
The search is compatible with gcc, in which '<>' quoted file-
names are searched exclusively via the set path, whereas the
'""' quoted filenames are first tried to be opened in the cur-
rent directory. Also resource statements with file references
are located in the same way.
, =
Sets the input format. Valid options are 'rc' or 'rc16'. Setting
the input to 'rc16' disables the recognition of win32 keywords.
, =
Set default language to . Default is the neutral language 0
(i.e. "LANGUAGE 0, 0").
Do not search the standard include path, look for include files
only in the directories explicitly specified with the option.
Ignored for compatibility with .
, , =
Write output to . Default is with stripped
or if input is read from standard input.
, =
Sets the output format. The supported formats are 'res' and
'res16'. If this option is not specified, format defaults to
'res'.
Enable pedantic warnings. Notably redefinition of #define state-
ments can be discovered with this option.
Ignored for compatibility with .
=
This option may be used to specify the preprocessor to use,
including any leading arguments. If not specified, uses its
builtin processor. To disable preprocessing, use
.
, =
Undefine preprocessor identifier . Please note that only
macros defined up to this point are undefined by this command.
However, these include the special macros defined automatically
by . See also below.
Ignored for compatibility with .
,
Turns on verbose mode (equivalent to -d 1).
Print version end exit.
PREPROCESSOR
The preprocessor is ANSI-C compatible with some of the extensions of
the gcc preprocessor.
The preprocessor recognizes these directives: #include, #define (both
simple and macro), #undef, #if, #ifdef, #ifndef, #elif, #else, #endif,
#error, #warning, #line, # (both null- and line-directive), #pragma
(ignored), #ident (ignored).
The preprocessor sets by default several defines:
RC_INVOKED set to 1
__WRC__ Major version of wrc
__WRC_MINOR__ Minor version of wrc
__WRC_PATCHLEVEL__ Patch level
Win32 compilation mode also sets __WIN32__ to 1 and __FLAT__ to 1.
Special macros __FILE__, __LINE__, __TIME__ and __DATE__ are also rec-
ognized and expand to their respective equivalent.
LANGUAGE SUPPORT
Language, version and characteristics can be bound to all resource
types that have inline data, such as RCDATA. This is an extension to
Microsoft's resource compiler, which lacks this support completely.
Only VERSIONINFO cannot have version and characteristics attached, but
languages are propagated properly if you declare it correctly before
the VERSIONINFO resource starts.
Example:
1 RCDATA DISCARDABLE
LANGUAGE 1, 0
VERSION 312
CHARACTERISTICS 876
{
1, 2, 3, 4, 5, "and whatever more data you want"
'00 01 02 03 04 05 06 07 08'
}
AUTHORS
was written by Bertho A. Stultiens and is a nearly complete rewrite
of the first wine resource compiler (1994) by Martin von Loewis. Addi-
tional resource-types were contributed Ulrich Czekalla and Albert den
Haan. Many cleanups by Dimitrie O. Paun in 2002-2003. Bugfixes have
been contributed by many Wine developers.
BUGS
- The preprocessor recognizes variable argument macros, but does not
expanded them correctly.
- Error reporting should be more precise, as currently the column and
line number reported are those of the next token.
- Default memory options should differ between win16 and win32.
There is no support for:
- RT_DLGINCLUDE, RT_VXD, RT_PLUGPLAY and RT_HTML (unknown format)
- PUSHBOX control is unsupported due to lack of original functionality.
Fonts are parsed and generated, but there is no support for the genera-
tion of the FONTDIR yet. The user must supply the FONTDIR resource in
the source to match the FONT resources.
AVAILABILITY
is part of the Wine distribution, which is available through
WineHQ, the Wine development headquarters, at
SEE ALSO
Wine 1.1.9 October 2005
