// Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
//
// You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
// copy, modify, and distribute this software in source code or binary form for use
// in connection with the web services and APIs provided by Facebook.
//
// As with any software that integrates with the Facebook platform, your use of
// this software is subject to the Facebook Developer Principles and Policies
// [http://developers.facebook.com/policy/]. This copyright notice shall be
// included in all copies or substantial portions of the software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
// FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
// COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
// IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
// CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

#import "TargetConditionals.h"

#if !TARGET_OS_TV

#import <UIKit/UIKit.h>

@class FBSDKProfile;

NS_ASSUME_NONNULL_BEGIN

/**
 FBSDKProfilePictureMode enum
  Defines the aspect ratio mode for the source image of the profile picture.
 */
typedef NS_ENUM(NSUInteger, FBSDKProfilePictureMode)
{
  /**
    A square cropped version of the image will be included in the view.
   */
  FBSDKProfilePictureModeSquare,
  /**
    The original picture's aspect ratio will be used for the source image in the view.
   */
  FBSDKProfilePictureModeNormal,
} NS_SWIFT_NAME(Profile.PictureMode);

/**
  A view to display a profile picture.
 */
NS_SWIFT_NAME(FBProfilePictureView)
@interface FBSDKProfilePictureView : UIView

/**
 Create a new instance of `FBSDKProfilePictureView`.

 - Parameter frame: Frame rectangle for the view.
 - Parameter profile: Optional profile to display a picture for.
 */
- (instancetype)initWithFrame:(CGRect)frame
                      profile:(FBSDKProfile * _Nullable)profile;

/**
 Create a new instance of `FBSDKProfilePictureView`.

 - Parameter profile: Optional profile to display a picture for.
 */
- (instancetype)initWithProfile:(FBSDKProfile * _Nullable)profile;

/**
  The mode for the receiver to determine the aspect ratio of the source image.
 */
@property (nonatomic, assign) FBSDKProfilePictureMode pictureMode;

/**
  The profile ID to show the picture for.
 */
@property (nonatomic, copy) NSString *profileID;

/**
  Explicitly marks the receiver as needing to update the image.

 This method is called whenever any properties that affect the source image are modified, but this can also
 be used to trigger a manual update of the image if it needs to be re-downloaded.
 */
- (void)setNeedsImageUpdate;

@end

NS_ASSUME_NONNULL_END

#endif
