This repository has been archived by the owner on Aug 8, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[ios] Add MGLCompassButton and MGLOrnamentVisibility
- Loading branch information
1 parent
de71ff5
commit 5b48822
Showing
16 changed files
with
367 additions
and
100 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| #import <UIKit/UIKit.h> | ||
|
|
||
| #import "MGLTypes.h" | ||
|
|
||
| NS_ASSUME_NONNULL_BEGIN | ||
|
|
||
| /** | ||
| A specialized view that displays the current compass heading for its associated map. | ||
| */ | ||
| MGL_EXPORT | ||
| @interface MGLCompassButton : UIImageView | ||
|
|
||
| /** | ||
| The visibility of the compass button. | ||
| You can configure a compass button to be visible all the time or only when the compass heading changes. | ||
| */ | ||
| @property (nonatomic, assign) MGLOrnamentVisibility compassVisibility; | ||
|
|
||
| @end | ||
|
|
||
| NS_ASSUME_NONNULL_END |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,128 @@ | ||
| #import "MGLCompassButton_Private.h" | ||
| #import "MGLCompassDirectionFormatter.h" | ||
|
|
||
| #import <Mapbox/MGLGeometry.h> | ||
|
|
||
| #import "MGLMapView_Private.h" | ||
| #import "UIImage+MGLAdditions.h" | ||
| #import "NSBundle+MGLAdditions.h" | ||
|
|
||
| #include <mbgl/math/wrap.hpp> | ||
|
|
||
| @interface MGLCompassButton () | ||
|
|
||
| @property (nonatomic, weak) MGLMapView *mapView; | ||
| @property (nonatomic) MGLCompassDirectionFormatter *accessibilityCompassFormatter; | ||
|
|
||
| @end | ||
|
|
||
| @implementation MGLCompassButton | ||
|
|
||
| + (instancetype)compassButtonWithMapView:(MGLMapView *)mapView { | ||
| return [[MGLCompassButton alloc] initWithMapView:mapView]; | ||
| } | ||
|
|
||
| - (instancetype)initWithMapView:(MGLMapView *)mapView { | ||
| if (self = [super init]) { | ||
| self.mapView = mapView; | ||
| [self commonInit]; | ||
| } | ||
| return self; | ||
| } | ||
|
|
||
| - (void)commonInit { | ||
| self.image = self.compassImage; | ||
|
|
||
| self.compassVisibility = MGLOrnamentVisibilityAdaptive; | ||
|
|
||
| self.alpha = 0; | ||
| self.userInteractionEnabled = YES; | ||
| self.translatesAutoresizingMaskIntoConstraints = NO; | ||
|
|
||
| UITapGestureRecognizer *tapGesture = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(handleTapGesture:)]; | ||
| [self addGestureRecognizer:tapGesture]; | ||
|
|
||
| self.accessibilityTraits = UIAccessibilityTraitButton; | ||
| self.accessibilityLabel = NSLocalizedStringWithDefaultValue(@"COMPASS_A11Y_LABEL", nil, nil, @"Compass", @"Accessibility label"); | ||
| self.accessibilityHint = NSLocalizedStringWithDefaultValue(@"COMPASS_A11Y_HINT", nil, nil, @"Rotates the map to face due north", @"Accessibility hint"); | ||
|
|
||
| self.accessibilityCompassFormatter = [[MGLCompassDirectionFormatter alloc] init]; | ||
| self.accessibilityCompassFormatter.unitStyle = NSFormattingUnitStyleLong; | ||
|
|
||
| [self sizeToFit]; | ||
| } | ||
|
|
||
| - (void)setCompassVisibility:(MGLOrnamentVisibility)compassVisibility { | ||
| if (_compassVisibility == compassVisibility) { return; } | ||
| _compassVisibility = compassVisibility; | ||
|
|
||
| [self updateCompassAnimated:NO]; | ||
| } | ||
|
|
||
| - (UIImage *)compassImage { | ||
| UIImage *scaleImage = [UIImage mgl_resourceImageNamed:@"Compass"]; | ||
| UIGraphicsBeginImageContextWithOptions(scaleImage.size, NO, UIScreen.mainScreen.scale); | ||
| [scaleImage drawInRect:{CGPointZero, scaleImage.size}]; | ||
|
|
||
| NSAttributedString *north = [[NSAttributedString alloc] initWithString:NSLocalizedStringWithDefaultValue(@"COMPASS_NORTH", nil, nil, @"N", @"Compass abbreviation for north") attributes:@{ | ||
| NSFontAttributeName: [UIFont systemFontOfSize:11 weight:UIFontWeightUltraLight], | ||
| NSForegroundColorAttributeName: [UIColor whiteColor], | ||
| }]; | ||
| CGRect stringRect = CGRectMake((scaleImage.size.width - north.size.width) / 2, | ||
| scaleImage.size.height * 0.435, | ||
| north.size.width, north.size.height); | ||
| [north drawInRect:stringRect]; | ||
|
|
||
| UIImage *image = UIGraphicsGetImageFromCurrentImageContext(); | ||
| UIGraphicsEndImageContext(); | ||
| return image; | ||
| } | ||
|
|
||
| - (void)handleTapGesture:(__unused UITapGestureRecognizer *)sender { | ||
| [self.mapView resetNorth]; | ||
| } | ||
|
|
||
| - (void)updateCompass { | ||
| [self updateCompassAnimated:YES]; | ||
| } | ||
|
|
||
| - (void)updateCompassAnimated:(BOOL)animated { | ||
| CLLocationDirection direction = self.mapView.direction; | ||
| CLLocationDirection plateDirection = mbgl::util::wrap(-direction, 0., 360.); | ||
| self.transform = CGAffineTransformMakeRotation(MGLRadiansFromDegrees(plateDirection)); | ||
|
|
||
| self.isAccessibilityElement = direction > 0; | ||
| self.accessibilityValue = [self.accessibilityCompassFormatter stringFromDirection:direction]; | ||
|
|
||
| switch (self.compassVisibility) { | ||
| case MGLOrnamentVisibilityAdaptive: | ||
| if (direction > 0 && self.alpha < 1) { | ||
| [self showCompass:animated]; | ||
| } else if (direction == 0 && self.alpha > 0) { | ||
| [self hideCompass:animated]; | ||
| } | ||
| break; | ||
| case MGLOrnamentVisibilityVisible: | ||
| [self showCompass:animated]; | ||
| break; | ||
| case MGLOrnamentVisibilityHidden: | ||
| [self hideCompass:animated]; | ||
| break; | ||
| } | ||
| } | ||
|
|
||
| - (void)showCompass:(BOOL)animated { | ||
| animated ? [self animateToAlpha:1] : [self setAlpha:1]; | ||
| } | ||
|
|
||
| - (void)hideCompass:(BOOL)animated { | ||
| animated ? [self animateToAlpha:0] : [self setAlpha:0]; | ||
| } | ||
|
|
||
| - (void)animateToAlpha:(CGFloat)alpha { | ||
| [UIView animateWithDuration:MGLAnimationDuration delay:0 options:UIViewAnimationOptionBeginFromCurrentState animations:^{ | ||
| self.alpha = alpha; | ||
| } completion:nil]; | ||
| } | ||
|
|
||
| @end |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,19 @@ | ||
| #import <UIKit/UIKit.h> | ||
|
|
||
| #import <Mapbox/MGLCompassButton.h> | ||
|
|
||
| @class MGLMapView; | ||
|
|
||
| NS_ASSUME_NONNULL_BEGIN | ||
|
|
||
| @interface MGLCompassButton (Private) | ||
|
|
||
| + (instancetype)compassButtonWithMapView:(MGLMapView *)mapView; | ||
|
|
||
| @property (nonatomic, weak) MGLMapView *mapView; | ||
|
|
||
| - (void)updateCompass; | ||
|
|
||
| @end | ||
|
|
||
| NS_ASSUME_NONNULL_END |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.