# AUTORCC

Should the target be processed with auto-rcc (for Qt projects).

`AUTORCC` is a boolean specifying whether CMake will handle the Qt `rcc` code generator automatically, i.e. without having to use the `QT4_ADD_RESOURCES()` or `QT5_ADD_RESOURCES()` macro. Currently Qt4 and Qt5 are supported.

When this property is `ON`, CMake will handle `.qrc` files added as target sources at build time and invoke `rcc` accordingly. This property is initialized by the value of the `CMAKE_AUTORCC` variable if it is set when a target is created.

By default `AUTORCC` is processed by a `custom command`. If the `.qrc` file is `GENERATED`, a `custom target` is used instead.

When there are multiple `.qrc` files with the same name, CMake will generate unspecified unique output file names for `rcc`. Therefore, if `Q_INIT_RESOURCE()` or `Q_CLEANUP_RESOURCE()` need to be used, the `.qrc` file name must be unique.

## Modifiers

`AUTORCC_EXECUTABLE`: The `rcc` executable will be detected automatically, but can be forced to a certain binary by setting this target property.

`AUTORCC_OPTIONS`: Additional command line options for `rcc` can be set via this target property. The corresponding `AUTORCC_OPTIONS` source file property can be used to specify options to be applied only to a specific `.qrc` file.

`SKIP_AUTORCC`: `.qrc` files can be excluded from `AUTORCC` processing by setting this source file property.

`SKIP_AUTOGEN`: Source files can be excluded from `AUTOMOC`, `AUTOUIC` and `AUTORCC` processing by setting this source file property.

`AUTOGEN_SOURCE_GROUP`: This global property can be used to group files generated by `AUTOMOC` or `AUTORCC` together in an IDE, e.g. in MSVS.

`AUTOGEN_TARGETS_FOLDER`: This global property can be used to group `AUTOMOC`, `AUTOUIC` and `AUTORCC` targets together in an IDE, e.g. in MSVS.

`CMAKE_GLOBAL_AUTORCC_TARGET`: A global `autorcc` target that depends on all `AUTORCC` targets in the project will be generated when this variable is `ON`.

See the `cmake-qt(7)` manual for more information on using CMake with Qt.