20d9e1028c
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: Bart Louwers <bart@emeel.net>
76 lines
2.4 KiB
Objective-C
76 lines
2.4 KiB
Objective-C
#import "MLNFoundation.h"
|
|
#import "MLNMapView.h"
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
The aim of this class is to provide the functionality of changing the camera state and
|
|
converting between map view screen coordinates and geographical coordinates without
|
|
changing the actual map view camera state.
|
|
*/
|
|
MLN_EXPORT
|
|
@interface MLNMapProjection : NSObject
|
|
|
|
/**
|
|
Initializes and returns the new projection object with the current
|
|
camera state from the provided map view.
|
|
|
|
@param mapView The map view the camera state to use for the initialization.
|
|
@return An initialized map projection.
|
|
*/
|
|
- (instancetype)initWithMapView:(MLNMapView*)mapView;
|
|
|
|
/**
|
|
A camera representing the current projection state
|
|
*/
|
|
@property (readonly, copy) MLNMapCamera *camera;
|
|
|
|
/**
|
|
Change the projection state with camera and padding values.
|
|
|
|
@param camera The new camera to be used in the projection calculation.
|
|
@param insets The insets applied on top of the camera be used in the projection calculation.
|
|
|
|
@note `MLNMapView` instance frame must not be changed since this projection is initialized,
|
|
otherwise the calculation may be wrong.
|
|
*/
|
|
- (void)setCamera:(MLNMapCamera * _Nonnull)camera withEdgeInsets:(UIEdgeInsets)insets;
|
|
|
|
/**
|
|
Change the projection state to make the provided bounds visible with the specified inset.
|
|
|
|
@param bounds The bounds that the viewport should fit.
|
|
@param insets The insets applied on top of the viewport to be used in the projection calculation.
|
|
|
|
@note `MLNMapView` instance frame must not be changed since this projection is initialized,
|
|
otherwise the calculation may be wrong.
|
|
*/
|
|
- (void)setVisibleCoordinateBounds:(MLNCoordinateBounds)bounds edgePadding:(UIEdgeInsets)insets;
|
|
|
|
/**
|
|
Converts a point in the coordinate system of the map view the projection
|
|
was initialized with to the geographical coordinate.
|
|
|
|
@param point The point to convert.
|
|
@return The geographic coordinate at the given point.
|
|
*/
|
|
- (CLLocationCoordinate2D)convertPoint:(CGPoint)point;
|
|
|
|
/**
|
|
Converts a geographic coordinate to a point in the map view's the projection
|
|
was initialized with coordinate system.
|
|
|
|
@param coordinate The geographic coordinate to convert.
|
|
@return The point corresponding to the given geographic coordinate.
|
|
*/
|
|
- (CGPoint)convertCoordinate:(CLLocationCoordinate2D)coordinate;
|
|
|
|
/**
|
|
The distance in meters spanned by a single point for the current camera.
|
|
*/
|
|
@property (readonly) CLLocationDistance metersPerPoint;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|