KDCircularProgress Documentation

To install KDCircularProgress using CocoaPods, add the following line to your Podfile:

pod 'KDCircularProgress'

Then, execute the install command in your terminal:

$ pod install

To install KDCircularProgress using Carthage, add the following line to your Cartfile:

github "kaandedeoglu/KDCircularProgress"

Then, run the update command:

carthage update

You can instantiate and configure KDCircularProgress programmatically. It is recommended to use square frames to avoid unexpected results.

Here is a complete setup example:

progress = KDCircularProgress(frame: CGRect(x: 0, y: 0, width: 300, height: 300))
progress.startAngle = -90
progress.progressThickness = 0.2
progress.trackThickness = 0.6
progress.clockwise = true
progress.gradientRotateSpeed = 2
progress.roundedCorners = false
progress.glowMode = .forward
progress.glowAmount = 0.9
progress.set(colors: UIColor.cyan ,UIColor.white, UIColor.magenta, UIColor.white, UIColor.orange)
progress.center = CGPoint(x: view.center.x, y: view.center.y + 25)
view.addSubview(progress)

You can initialize the component using the following methods:

• init(frame: CGRect): Standard initializer. Note: Use square frames only.
• init(frame: CGRect, colors: UIColor...): Convenience initializer that sets the gradient colors immediately.

Use the following methods to animate the progress view:

• animateFromAngle(fromAngle:toAngle:duration:relativeDuration:completion:): Animates from a specific starting angle to a target angle. relativeDuration determines if the duration is for the specific segment or for a full turn.
• animateToAngle(toAngle:duration:completion:): Animates from the current state to a target angle.
• pauseAnimation(): Pauses any active animation.
• isAnimating() -> Bool: Returns true if an animation is currently running.

You can update the gradient colors using either of these methods:

• set(colors: UIColor...): Variadic method to pass multiple colors.
• set(colors: [UIColor]): Method to pass an array of colors.

The glowMode property (of type KDCircularProgressGlowMode) controls how the glow effect scales with the progress angle:

• .forward: Glow increases proportionally to the angle (0 at 0°, full at 360°).
• .reverse: Glow increases inversely to the angle (full at 0°, 0 at 360°).
• .constant: The glow intensity remains constant.
• .noGlow: No glow effect is applied.