//
//  UIDynamicBehavior.h
//  UIKit
//
//  Copyright (c) 2012-2015 Apple Inc. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <UIKit/UIGeometry.h>

NS_ASSUME_NONNULL_BEGIN

@class UIDynamicAnimator;     //  
@class UIBezierPath;

// 碰撞界限的枚舉類型
typedef NS_ENUM(NSUInteger, UIDynamicItemCollisionBoundsType) {
    UIDynamicItemCollisionBoundsTypeRectangle,   // 矩形
    UIDynamicItemCollisionBoundsTypeEllipse,     // 橢圓 radii will be determined from the items bounds width, height
    UIDynamicItemCollisionBoundsTypePath         // 路徑
} NS_ENUM_AVAILABLE_IOS(9_0);


//  UIDynamicItem 協(xié)議， 所有的 UI 控件都遵守了這個協(xié)議
@protocol UIDynamicItem <NSObject>

@property (nonatomic, readwrite) CGPoint center;
@property (nonatomic, readonly) CGRect bounds;
@property (nonatomic, readwrite) CGAffineTransform transform;



// 可選的
@optional
/**
 The collision type represents how the dynamics system will evaluate collisions with 
 respect to the dynamic item. defaults to UIDynamicItemCollisionBoundsTypeRectangle
 */
@property (nonatomic, readonly) UIDynamicItemCollisionBoundsType collisionBoundsType NS_AVAILABLE_IOS(9_0);

/**
 The path must represent a convex polygon with counter clockwise winding and no self intersection. 
 The point (0,0) in the path corresponds to the dynamic item's center.
 */
@property (nonatomic, readonly) UIBezierPath *collisionBoundingPath NS_AVAILABLE_IOS(9_0);

@end



// item group
NS_CLASS_AVAILABLE_IOS(9_0) @interface UIDynamicItemGroup : NSObject <UIDynamicItem>

// 通過 item 數(shù)組進行實例化
- (instancetype)initWithItems:(NSArray<id <UIDynamicItem>> *)items;

// 獲取 item 數(shù)組
@property (nonatomic, readonly, copy) NSArray<id <UIDynamicItem>> *items;

@end




// 行為類
NS_CLASS_AVAILABLE_IOS(7_0) @interface UIDynamicBehavior : NSObject

// ****** 下面這些方法只能在 自定義的  UIDynamicBehavior 中使用  UI 中定義的 Behavior 是不能使用的 ******
// 添加子行為 到這個行為對象（ 這種方式主要是進行行為自定義）
/*
  behavior 對象如果已經(jīng)添加到了夫 behavior 中，或者 behavior 為 nil 儡蔓。
  那么這個方法的調(diào)用就被忽略
  這個方法只能在 自定義的 UIDynamicBehavior 子類中調(diào)用
*/
- (void)addChildBehavior:(UIDynamicBehavior *)behavior;
// 移除子行為 （只能在自定義的類中使用）
- (void)removeChildBehavior:(UIDynamicBehavior *)behavior;

// 獲取所有的子行為
// 這個方法只能在 自定義的 UIDynamicBehavior 子類中調(diào)用
@property (nonatomic, readonly, copy) NSArray<__kindof UIDynamicBehavior *> *childBehaviors;

// When running, the dynamic animator calls the action block on every animation step.
// 運行時,動態(tài)動畫器調(diào)用動作塊在每個動畫的步驟。
@property (nullable, nonatomic,copy) void (^action)(void);


// behavior 被添加或者被移除的時候會調(diào)用這個方法
// 這個方法是用來重載的 用來響應 behavior  tree 在 animator 中的改變
- (void)willMoveToAnimator:(nullable UIDynamicAnimator *)dynamicAnimator; // nil when being removed from an animator

// 獲取動畫管理者
@property (nullable, nonatomic, readonly) UIDynamicAnimator *dynamicAnimator;

@end

NS_ASSUME_NONNULL_END