ios/chrome/browser/ui/uikit_ui_util.h

   1 // Copyright 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef IOS_CHROME_BROWSER_UI_UIKIT_UI_UTIL_H_
   6 #define IOS_CHROME_BROWSER_UI_UIKIT_UI_UTIL_H_
   7
   8 #include <CoreGraphics/CoreGraphics.h>
   9 #import <Foundation/Foundation.h>
  10 #import <UIKit/UIKit.h>
  11
  12 #import "ios/chrome/browser/ui/ui_util.h"
  13
  14 // UI Util containing functions that require UIKit.
  15
  16 enum { FONT_HELVETICA, FONT_HELVETICA_NEUE, FONT_HELVETICA_NEUE_LIGHT };
  17
  18 // Utility function to set the |element|'s accessibility label to the localized
  19 // message corresponding to |idsAccessibilityLabel| and its accessibility
  20 // identifier to |englishUiAutomationName|.
  21 // Call SetA11yLabelAndUiAutomationName() if |element| is accessible and its
  22 // a11y label should be localized.
  23 // By convention |englishUiAutomationName| must be equal to the English
  24 // localized string corresponding to |idsAccessibilityLabel|.
  25 // |englishUiAutomationName| is the name used in JavaScript UI Automation test
  26 // scripts to identify the |element|.
  27 void SetA11yLabelAndUiAutomationName(UIView* element,
  28                                      int idsAccessibilityLabel,
  29                                      NSString* englishUiAutomationName);
  30
  31 // Sets the given |button|'s width to exactly fit its image and text.  Does not
  32 // modify the button's height.
  33 void GetSizeButtonWidthToFit(UIButton* button);
  34
  35 // Translates the given |view|'s frame.  Sets a new frame instead of applying a
  36 // transform to the existing frame.
  37 void TranslateFrame(UIView* view, UIOffset offset);
  38
  39 // Returns a UIFont. |fontFace| is one of the defined enumerated values
  40 // to avoid spelling mistakes.
  41 UIFont* GetUIFont(int fontFace, bool isBold, CGFloat fontSize);
  42
  43 // Adds a border shadow around |view|.
  44 void AddBorderShadow(UIView* view, CGFloat offset, UIColor* color);
  45
  46 // Adds a rounded-rectangle border shadow around a view.
  47 void AddRoundedBorderShadow(UIView* view, CGFloat radius, UIColor* color);
  48
  49 // Captures and returns an autoreleased rendering of the |view|.
  50 // The |view| is assumed to be opaque and the returned image does
  51 // not have an alpha channel. The scale parameter is used as a scale factor
  52 // for the rendering context. Using 0.0 as scale will result in the device's
  53 // main screen scale to be used.
  54 UIImage* CaptureView(UIView* view, CGFloat scale);
  55
  56 // Converts input image and returns a grey scaled version.
  57 UIImage* GreyImage(UIImage* image);
  58
  59 // Returns the color that should be used for the background of all Settings
  60 // pages.
  61 UIColor* GetSettingsBackgroundColor();
  62
  63 // Returns the color used as the main color for primary action buttons.
  64 UIColor* GetPrimaryActionButtonColor();
  65
  66 // Returns an UIColor with |rgb| and |alpha|. The caller should pass the RGB
  67 // value in hexadecimal as this is the typical way they are provided by UX.
  68 // For example a call to |UIColorFromRGB(0xFF7D40, 1.0)| returns an orange
  69 // UIColor object.
  70 inline UIColor* UIColorFromRGB(int rgb, CGFloat alpha = 1.0) {
  71   return [UIColor colorWithRed:((CGFloat)((rgb & 0xFF0000) >> 16)) / 255.0
  72                          green:((CGFloat)((rgb & 0x00FF00) >> 8)) / 255.0
  73                           blue:((CGFloat)(rgb & 0x0000FF)) / 255.0
  74                          alpha:alpha];
  75 }
  76
  77 // Returns an image resized to |targetSize|. It first calculate the projection
  78 // by calling CalculateProjection() and then create a new image of the desired
  79 // size and project the correct subset of the originla image onto it.
  80 //
  81 // Image interpolation level for resizing is set to kCGInterpolationDefault.
  82 //
  83 // The resize always preserves the scale of the original image.
  84 UIImage* ResizeImage(UIImage* image,
  85                      CGSize targetSize,
  86                      ProjectionMode projectionMode);
  87
  88 // Returns a slightly blurred image darkened enough to provide contrast for
  89 // white text to be readable.
  90 UIImage* DarkenImage(UIImage* image);
  91
  92 // Applies various effects to an image. This method can apply a blur over a
  93 // |radius|, superimpose a |tintColor| (an alpha of 0.6 on the color is a good
  94 // approximation to look like iOS tint colors) or saturate the image colors by
  95 // applying a |saturationDeltaFactor| (negative to desaturate, positive to
  96 // saturate). The optional |maskImage| is used to limit the effect of the blur
  97 // and/or saturation to a portion of the image.
  98 UIImage* BlurImage(UIImage* image,
  99                    CGFloat blurRadius,
 100                    UIColor* tintColor,
 101                    CGFloat saturationDeltaFactor,
 102                    UIImage* maskImage);
 103
 104 // Returns a cropped image using |cropRect| on |image|.
 105 UIImage* CropImage(UIImage* image, const CGRect& cropRect);
 106
 107 // Returns the interface orientation of the app.
 108 UIInterfaceOrientation GetInterfaceOrientation();
 109
 110 // Returns the height of the keyboard in the current orientation.
 111 CGFloat CurrentKeyboardHeight(NSValue* keyboardFrameValue);
 112
 113 // Create 1x1px image from |color|.
 114 UIImage* ImageWithColor(UIColor* color);
 115
 116 // Returns a circular image of width |width| based on |image| scaled up or
 117 // down. If the source image is not square, the image is first cropped.
 118 UIImage* CircularImageFromImage(UIImage* image, CGFloat width);
 119
 120 // Returns the linear interpolated color from |firstColor| to |secondColor| by
 121 // the given |fraction|. Requires that both colors are in RGB or monochrome
 122 // color space. |fraction| is a decimal value between 0.0 and 1.0.
 123 UIColor* InterpolateFromColorToColor(UIColor* firstColor,
 124                                      UIColor* secondColor,
 125                                      CGFloat fraction);
 126
 127 // Applies all |constraints| to all views in |subviewsDictionary| in the
 128 // superview |parentView|.
 129 void ApplyVisualConstraints(NSArray* constraints,
 130                             NSDictionary* subviewsDictionary,
 131                             UIView* parentView);
 132
 133 // Applies all |constraints| with |options| to all views in |subviewsDictionary|
 134 // in the superview |parentView|.
 135 void ApplyVisualConstraintsWithOptions(NSArray* constraints,
 136                                        NSDictionary* subviewsDictionary,
 137                                        NSLayoutFormatOptions options,
 138                                        UIView* parentView);
 139
 140 // Applies all |constraints| with |metrics| to all views in |subviewsDictionary|
 141 // in the superview |parentView|
 142 void ApplyVisualConstraintsWithMetrics(NSArray* constraints,
 143                                        NSDictionary* subviewsDictionary,
 144                                        NSDictionary* metrics,
 145                                        UIView* parentView);
 146
 147 // Applies all |constraints| with |metrics| and |options| to all views in
 148 // |subviewsDictionary| in the superview |parentView|
 149 void ApplyVisualConstraintsWithMetricsAndOptions(
 150     NSArray* constraints,
 151     NSDictionary* subviewsDictionary,
 152     NSDictionary* metrics,
 153     NSLayoutFormatOptions options,
 154     UIView* parentView);
 155
 156 // Adds a constraint that |subview| is center aligned horizontally in
 157 // |parentView|.
 158 // |subview| must be a subview of |parentView|.
 159 void AddSameCenterXConstraint(UIView* parentView, UIView* subview);
 160
 161 // Adds a constraint that |subview1| and |subview2| are center aligned
 162 // horizontally on |parentView|.
 163 // |subview1| and |subview2| must be subview of |parentView|.
 164 void AddSameCenterXConstraint(UIView *parentView, UIView *subview1,
 165                               UIView *subview2);
 166
 167 // Adds a constraint that |subview| is center aligned vertically in
 168 // |parentView|.
 169 // |subview| must be a subview of |parentView|.
 170 void AddSameCenterYConstraint(UIView* parentView, UIView* subview);
 171
 172 // Adds a constraint that |subview1| and |subview2| are center aligned
 173 // vertically on |parentView|.
 174 // |subview1| and |subview2| must be subview of |parentView|.
 175 void AddSameCenterYConstraint(UIView* parentView,
 176                               UIView* subview1,
 177                               UIView* subview2);
 178
 179 // Whether the main application window's rootViewController has a compact
 180 // horizontal size class.
 181 bool IsCompact();
 182
 183 // Whether the main application window's rootViewController has a compact
 184 // iPad horizontal size class.
 185 bool IsCompactTablet();
 186
 187 #endif  // IOS_CHROME_BROWSER_UI_UIKIT_UI_UTIL_H_