C

qul_add_resource

警告この CMake コマンドは 2.4 以降では非推奨です。代わりにImageFiles.filesを使ってください。

イメージリソースをターゲットに追加します。

概要

qul_add_resource(<target>
                 FILES file1 [file2...]
                 [PREFIX <path>]
                 [BASE <path>]
                 [OUTPUT_DIRECTORY <path>])

説明

リストアップされたファイルはリソースURIを介してQMLファイルからアクセスできるリソースとなります。現在のところ、画像リソースのみがサポートされています。

リソースは CMake ソースファイルのプロパティを持つことができます。これらのプロパティは、qul_add_resource を呼び出す前に設定する必要があります。プロパティの一覧はCMake Reference を参照してください。

内部的には、リソースの説明は収集され、JSONファイルとしてqulrccツール・リソース・コンパイラーに渡されます。qulrcc tool 、リソース名とシンボル名を対応付けるJSONファイルと同様に、リソース用のC++ファイルが生成されます。C++ファイルはターゲットにコンパイルされ、出力されたJSONファイルはqmltocppによってリソース名を検索し、生成されたコードにシンボル参照を出力するために使用されます。

注意: qul_add_resource は、qul_add_targetと同じディレクトリスコープで使用する必要があります。

オプション

FILES 引数は、現在のソース・ディレクトリからの相対パスで、スペースで区切られたファイル・パスのリストを取る。

OUTPUT_DIRECTORY オプションを設定することで、生成されるファイルの配置場所を制御できます。相対パスの場合、現在のビルド・ディレクトリーからの相対パスになります。

オプションのPREFIX パスは、ファイルが置かれるリソース URI にプレフィックスを追加します。例えば、PREFIX が "images" で、FILES の一つが "map/small.png" の場合、リソースファイルシステム内のパスは "qrc:/images/map/small.png" となります。デフォルトの接頭辞は"/"です。

オプションのBASE パスは、計算されたリソース URI のアンカーを決定します。例えば、BASE が "data "で、FILES の一つが "data/images/foo.png "の場合、パスリソースファイルシステムは "qrc:/images/foo.png "となります。デフォルトのベースは現在のソースディレクトリです。

CMakeソースファイルのプロパティ

メモ： これらのプロパティは、set_source_files_properties CMake 関数を使用して、個々のリソースに対して設定します。デフォルトですべてのリソースに適用される値を設定するには、PREFIX_DEFAULT_<property> を使用します。PREFIX は、QUL またはQUL_PLATFORM です。qul_add_resource を呼び出す前に、ソースファイルのプロパティを設定する必要があります。

例えば

# Store all images in compressed format by default, except for button.png
set(QUL_DEFAULT_RESOURCE_COMPRESSION ON)
set_source_files_properties(button.png PROPERTIES QUL_RESOURCE_COMPRESSION OFF)
qul_add_resource(...)

例

# Used in QML as "qrc:/button.png" and "qrc:/nav/arrow.png",
# or simply as "button.png" and "nav/arrow.png".
qul_add_resource(example_app FILES button.png nav/arrow.png)

set_source_files_properties(big/button.png PROPERTIES
    QUL_RESOURCE_COMPRESSION ON
    QUL_RESOURCE_OPTIMIZE_FOR_SCALE ON)

# The resource path becomes "qrc:/images/button.png"
qul_add_resource(example_app
    FILES big/button.png
    BASE big
    PREFIX images)

# Setting an image to be cached on demand with a custom memory allocator
set_source_files_properties(
    big/button.png PROPERTIES
    QUL_RESOURCE_CACHE_POLICY "OnDemand"
    QUL_RESOURCE_STORAGE_SECTION "CustomSegment"
    QUL_RESOURCE_RUNTIME_ALLOCATION_TYPE "128"
)

リソースの管理」および「QUL_RESOURCE_IMAGE_PIXEL_FORMAT」も参照してください。

CMakeリファレンス

詳細はこちらをご覧ください。