cfmaterial_fade_animation.h¶

Material Design 3 Fade Animation. More...

Namespaces¶

Name
cf
cf::ui
cf::ui::components
cf::ui::components::material

Classes¶

	Name
class	cf::ui::components::material::CFMaterialFadeAnimation Material Design 3 Fade Animation.

Detailed Description¶

Material Design 3 Fade Animation.

Author: Charliechen114514 (chengh1922@mails.jlu.edu.cn)

Version: 0.1

Date: 2026-02-28

Implements a fade animation that follows Material Design 3 motion specifications. Animates the opacity of a widget from a start value to an end value using the specified timing and easing curve.

This animation integrates with the MaterialMotionScheme to obtain duration and easing values based on the motion token (e.g., "md.motion.shortEnter").

Source code¶

#pragma once

#include "base/weak_ptr/weak_ptr.h"
#include "base/weak_ptr/weak_ptr_factory.h"
#include "components/timing_animation.h"
#include "core/motion_spec.h"
#include "export.h"
#include <QGraphicsOpacityEffect>
#include <QWidget>

namespace cf::ui::components::material {

class CF_UI_EXPORT CFMaterialFadeAnimation : public ICFTimingAnimation {
    Q_OBJECT

  public:
    explicit CFMaterialFadeAnimation(cf::ui::core::IMotionSpec* spec, QObject* parent = nullptr);

    ~CFMaterialFadeAnimation() override;

    // Non-copyable, non-movable
    CFMaterialFadeAnimation(const CFMaterialFadeAnimation&) = delete;
    CFMaterialFadeAnimation& operator=(const CFMaterialFadeAnimation&) = delete;
    CFMaterialFadeAnimation(CFMaterialFadeAnimation&&) = delete;
    CFMaterialFadeAnimation& operator=(CFMaterialFadeAnimation&&) = delete;

    // =========================================================================
    // ICFAbstractAnimation Interface
    // =========================================================================

    void start(Direction dir = Direction::Forward) override;

    void pause() override;

    void stop() override;

    void reverse() override;

    bool tick(int dt) override;

    // =========================================================================
    // ICFTimingAnimation Interface
    // =========================================================================

    float currentValue() const override { return currentOpacity_; }

    // =========================================================================
    // Fade-Specific Methods
    // =========================================================================

    void setTargetWidget(QWidget* widget);

    QWidget* targetWidget() const { return targetWidget_; }

    cf::WeakPtr<ICFAbstractAnimation> GetWeakPtr() override { return weak_factory_.GetWeakPtr(); }

  private:
    float currentOpacity_ = 1.0f;

    QWidget* targetWidget_ = nullptr;

    QGraphicsOpacityEffect* opacityEffect_ = nullptr;

    bool ownsOpacityEffect_ = false;

    int durationMs_ = 200;

    int delayMs_ = 0;

    int elapsedTime_ = 0;

    void applyOpacity(float opacity);

    void ensureOpacityEffect();

    float calculateEasedProgress(float linearProgress) const;

    cf::WeakPtrFactory<ICFAbstractAnimation> weak_factory_{this};
};

} // namespace cf::ui::components::material

Updated on 2026-03-09 at 10:14:01 +0000