ash/system/holding_space/holding_space_progress_ring_animation.h

// Copyright 2021 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_SYSTEM_HOLDING_SPACE_HOLDING_SPACE_PROGRESS_RING_ANIMATION_H_
#define ASH_SYSTEM_HOLDING_SPACE_HOLDING_SPACE_PROGRESS_RING_ANIMATION_H_

#include <memory>

#include "ash/ash_export.h"
#include "ash/system/holding_space/holding_space_progress_indicator_animation.h"

namespace ash {

// An animation for a `HoldingSpaceProgressIndicator` to be painted in lieu of
// the determinate progress ring that would otherwise be painted.
class ASH_EXPORT HoldingSpaceProgressRingAnimation
    : public HoldingSpaceProgressIndicatorAnimation {
 public:
  enum class Type {
    kIndeterminate,  // See `HoldingSpaceProgressRingIndeterminateAnimation`.
    kPulse,          // See `HoldingSpaceProgressRingPulseAnimation`.
  };

  HoldingSpaceProgressRingAnimation(const HoldingSpaceProgressRingAnimation&) =
      delete;
  HoldingSpaceProgressRingAnimation& operator=(
      const HoldingSpaceProgressRingAnimation&) = delete;
  ~HoldingSpaceProgressRingAnimation() override;

  // Returns a created progress ring animation of the specified `type`.
  static std::unique_ptr<HoldingSpaceProgressRingAnimation> CreateOfType(
      Type type);

  // Returns the specific type of this animation.
  Type type() const { return type_; }

  // Returns animatable properties.
  float start_position() const { return start_position_; }
  float end_position() const { return end_position_; }
  float opacity() const { return opacity_; }

 protected:
  HoldingSpaceProgressRingAnimation(Type type,
                                    base::TimeDelta duration,
                                    bool is_cyclic);

  // Implementing classes should update any desired animatable properties as
  // appropriate for the specified animation `fraction`.
  virtual void UpdateAnimatableProperties(double fraction,
                                          float* start_position,
                                          float* end_position,
                                          float* opacity) = 0;

 private:
  // HoldingSpaceProgressIndicatorAnimation:
  void UpdateAnimatableProperties(double fraction) override;

  // The specific type of this animation.
  const Type type_;

  // Animatable properties.
  float start_position_ = 0.f;
  float end_position_ = 1.f;
  float opacity_ = 1.f;
};

}  // namespace ash

#endif  // ASH_SYSTEM_HOLDING_SPACE_HOLDING_SPACE_PROGRESS_RING_ANIMATION_H_