このページでは

ColorOverlay QML Type

オーバーレイ色を適用して、ソース項目の色を変更します。詳細...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

プロパティ

詳細な説明

この効果は、グレースケール画像の上に色付きガラスを重ねたときに生じる現象に似ています。オーバーレイの色はARGB形式で指定されます。

ソースエフェクト適用後

色鮮やかな蝶のイラスト

色を重ねた蝶

例

以下の例は、このエフェクトを適用する方法を示しています。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ColorOverlay {
        anchors.fill: bug
        source: bug
        color: "#80800000"
    }
}

プロパティのドキュメント

cached : bool

このプロパティを使用すると、エフェクトの出力ピクセルをキャッシュして、レンダリング性能を向上させることができます。

ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクトの出力を保存するために追加のメモリバッファが必要となるため、メモリ消費量が増加します。

ソースやエフェクトのプロパティがアニメーション化される場合は、キャッシュを無効にすることをお勧めします。

デフォルトでは、このプロパティは「false 」に設定されています。

color : color

このプロパティは、ソースの色付けに使用される色値を定義します。

デフォルトでは、このプロパティは"transparent" に設定されています。

異なる色値を用いた出力例

赤い模様が入った蝶

緑色のオーバーレイが施された蝶

青色のオーバーレイが施された蝶

color: #80ff0000 color: #8000ff00 color: #800000ff

source : variant

このプロパティは、エフェクトのソースピクセルを提供するソースアイテムを定義します。

注: エフェクトの親をソースとして設定するなど、エフェクトが自分自身をソースに含める設定は サポートされていません。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.