start resource source-file
[target target-file-name]
[targetpath targetpath]
[header | headeronly]
[lang languages]
[uid uid-value-1 [uid-value-2] ]
end
A start resource section specifies how a resource file should be compiled.
source-file specifies the resource source (.rss) file. The file should be in the current sourcepath directory, or specified relatively to that directory.
The optional target target-file specifies the name of the compiled resource file. The file extension part of the name does not need to be specified, as this will be automatically supplied. By default, the target has the same name as the source file.
The optional targetpath targetpath allows you to specify the location of the compiled file on the z: drive (or the emulated Z: drive). By default, the target file is built into the same directory as the project's executable.
The optional header keyword causes a resource header (.rsg) file to be created in epoc32\include\ along with the resource (.rsc) file. The optional headeronly keyword causes only the resource header (.rsg) file to be created in epoc32\include\. The resource header defines identifiers for the index positions of the structures in the resource file.
The optional lang keyword specifies language codes for the resource. This overrides any language settings made for the mmp file using the lang keyword. A language code is two-digit code, and is used to complete the extension of the built resource file: e.g. if the language code is 01, then the extension is .r01. The default language code is sc. The resource file is compiled multiple times, once for each language specified.
The optional uid keyword specifies the values for the second, and optionally, the third UID of the resource file. See UID2 and UID3 statements and RResourceFile::UidType() for more information.
This example builds the resource foo.rss into z:\private\10001234\foo.rsc.
start resource foo.rss TARGETPATH private\10001234 end
This example builds the resource foo.rss into z:\private\10001234\bar.r01, and creates a header bar.rsg in epoc32\include.
START RESOURCE foo.rss TARGET bar TARGETPATH private\10001234 HEADER LANG 01 UID 0x10002345 0x10003456 END
This example builds only the resource header bar.rsg in epoc32\include.
START RESOURCE foo.rss HEADERONLY END