QGeometry.h

//
//  QGeometry.h
//  QMapKit
//
//  Created by tabsong on 17/5/16.
//  Copyright © 2017年 tencent. All rights reserved.
//
 
#import <UIKit/UIKit.h>
#import <CoreLocation/CoreLocation.h>
 
#ifdef __cplusplus
extern "C" {
#endif
    
    typedef struct
    {
        CLLocationDegrees latitudeDelta;
        CLLocationDegrees longitudeDelta;
    } QCoordinateSpan;
    
    typedef struct
    {
        CLLocationCoordinate2D center;
        QCoordinateSpan span;
    } QCoordinateRegion;
    
    static inline QCoordinateSpan QCoordinateSpanMake(CLLocationDegrees latitudeDelta, CLLocationDegrees longitudeDelta)
    {
        return (QCoordinateSpan){latitudeDelta, longitudeDelta};
    }
    
    static inline QCoordinateRegion QCoordinateRegionMake(CLLocationCoordinate2D centerCoordinate, QCoordinateSpan span)
    {
        return (QCoordinateRegion){centerCoordinate, span};
    }
    
    typedef struct {
        CLLocationCoordinate2D northEast; 
        CLLocationCoordinate2D southWest; 
    } QCoordinateBounds;

    typedef struct
    {
        double x;
        double y;
    } QMapPoint;
    
    typedef struct
    {
        double width;
        double height;
    } QMapSize;
    
    typedef struct
    {
        QMapPoint origin;
        QMapSize size;
    } QMapRect;
    
    extern const QMapRect QMapRectNull;
    
    static inline QMapPoint QMapPointMake(double x, double y)
    {
        return (QMapPoint){x, y};
    }
    
    static inline QMapSize QMapSizeMake(double width, double height)
    {
        return (QMapSize){width, height};
    }
    
    static inline QMapRect QMapRectMake(double x, double y, double width, double height)
    {
        return (QMapRect){QMapPointMake(x, y), QMapSizeMake(width, height)};
    }
    
    static inline double QMapRectGetMinX(QMapRect rect)
    {
        return rect.origin.x;
    }
    
    static inline double QMapRectGetMinY(QMapRect rect)
    {
        return rect.origin.y;
    }
    
    static inline double QMapRectGetMidX(QMapRect rect)
    {
        return rect.origin.x + rect.size.width / 2.0;
    }
    
    static inline double QMapRectGetMidY(QMapRect rect)
    {
        return rect.origin.y + rect.size.height / 2.0;
    }
    
    static inline double QMapRectGetMaxX(QMapRect rect)
    {
        return rect.origin.x + rect.size.width;
    }
    
    static inline double QMapRectGetMaxY(QMapRect rect)
    {
        return rect.origin.y + rect.size.height;
    }
    
    static inline double QMapRectGetWidth(QMapRect rect)
    {
        return rect.size.width;
    }
    
    static inline double QMapRectGetHeight(QMapRect rect)
    {
        return rect.size.height;
    }
    
    static inline BOOL QMapPointEqualToPoint(QMapPoint point1, QMapPoint point2)
    {
        return point1.x == point2.x && point1.y == point2.y;
    }
    
    static inline BOOL QMapSizeEqualToSize(QMapSize size1, QMapSize size2)
    {
        return size1.width == size2.width && size1.height == size2.height;
    }
    
    static inline BOOL QMapRectEqualToRect(QMapRect rect1, QMapRect rect2)
    {
        return
        QMapPointEqualToPoint(rect1.origin, rect2.origin) &&
        QMapSizeEqualToSize(rect1.size, rect2.size);
    }
    
    static inline BOOL QMapRectIsNull(QMapRect rect)
    {
        return QMapPointEqualToPoint(rect.origin, QMapRectNull.origin);
    }
    
    static inline BOOL QMapRectIsEmpty(QMapRect rect)
    {
        return QMapRectIsNull(rect) || (rect.size.width == 0.0 && rect.size.height == 0.0);
    }
    
    extern BOOL QMapRectContainsPoint(QMapRect rect, QMapPoint point);
    
    extern QMapRect QMapRectUnionPoint(QMapRect rect, QMapPoint point);
    
    extern QMapRect QMapRectUnion(QMapRect rect1, QMapRect rect2);
    
    extern BOOL QMapRectIntersectsRect(QMapRect rect1, QMapRect rect2);
    
    extern BOOL QMapRectContainsRect(QMapRect rect1, QMapRect rect2);

    extern QMapRect QMapRectInset(QMapRect rect, double dx, double dy);
    
    static inline NSString *QStringFromMapPoint(QMapPoint point)
    {
        return [NSString stringWithFormat:@"{%.1f, %.1f}", point.x, point.y];
    }
    
    static inline NSString *QStringFromMapSize(QMapSize size)
    {
        return [NSString stringWithFormat:@"{%.1f, %.1f}", size.width, size.height];
    }
    
    static inline NSString *QStringFromMapRect(QMapRect rect)
    {
        return [NSString stringWithFormat:@"{%@, %@}", QStringFromMapPoint(rect.origin), QStringFromMapSize(rect.size)];
    }
    
    
    extern QMapPoint QMapPointForCoordinate(CLLocationCoordinate2D coordinate);
    
    extern CLLocationCoordinate2D QCoordinateForMapPoint(QMapPoint mapPoint);
    
    extern QCoordinateRegion QCoordinateRegionForMapRect(QMapRect rect);
    
    extern QMapRect QMapRectForCoordinateRegion(QCoordinateRegion region);

    extern QMapRect QMapRectForCoordinateBounds(QCoordinateBounds bounds);

    extern QCoordinateBounds QCoordinateBoundsForMapRect(QMapRect rect);
    
    extern CLLocationDistance QMetersPerMapPointAtLatitude(CLLocationDegrees latitude);
    
    extern double QMapPointsPerMeterAtLatitude(CLLocationDegrees latitude);
    
    static inline QCoordinateRegion QCoordinateRegionMakeWithDistance(CLLocationCoordinate2D centerCoordinate, CLLocationDistance latitudinalMeters, CLLocationDistance longitudinalMeters)
    {
        QMapSize spanSize = QMapSizeMake(QMapPointsPerMeterAtLatitude(centerCoordinate.latitude) * latitudinalMeters, QMapPointsPerMeterAtLatitude(centerCoordinate.latitude) * longitudinalMeters);
        
        QMapPoint center       = QMapPointForCoordinate(centerCoordinate);
        QMapPoint leftTop      = QMapPointMake(center.x - spanSize.width / 2.0, center.y - spanSize.height / 2.0);
        QMapPoint rightBottom  = QMapPointMake(center.x + spanSize.width / 2.0, center.y + spanSize.height / 2.0);
        
        CLLocationCoordinate2D leftTopCoordinate     = QCoordinateForMapPoint(leftTop);
        CLLocationCoordinate2D rightBottomCoordinate = QCoordinateForMapPoint(rightBottom);
        
        return QCoordinateRegionMake(centerCoordinate,
                                     QCoordinateSpanMake(fabs(leftTopCoordinate.latitude - rightBottomCoordinate.latitude),
                                                         fabs(leftTopCoordinate.longitude - rightBottomCoordinate.longitude)));
    }
    
    extern BOOL QPolygonContainsPoint(QMapPoint point, QMapPoint *polygon, NSUInteger count);
    
    extern BOOL QPolygonContainsCoordinate(CLLocationCoordinate2D coordinate, CLLocationCoordinate2D *polygon, NSUInteger count);

    extern BOOL QCircleContainsPoint(QMapPoint point, QMapPoint center, double radius);

    extern BOOL QCircleContainsCoordinate(CLLocationCoordinate2D point, CLLocationCoordinate2D center, double radius);

    extern BOOL QPolylineHitTestPoint(QMapPoint point, QMapPoint *polyline, NSUInteger count, double lineWidth);

    extern BOOL QPolylineHitTestCoordinate(CLLocationCoordinate2D coordinate, CLLocationCoordinate2D *polyline, NSUInteger count, double lineWidth);
    
    extern CLLocationDistance QMetersBetweenMapPoints(QMapPoint a, QMapPoint b);
    
    extern CLLocationDistance QMetersBetweenCoordinates(CLLocationCoordinate2D a, CLLocationCoordinate2D b);
    
    extern QMapRect QBoundingMapRectWithPoints(QMapPoint *points, NSUInteger count);
    
    extern QMapRect QBoundingMapRectWithPointsAndCenter(QMapPoint *points, NSUInteger count, QMapPoint centerPoint);
    
    extern QCoordinateRegion QBoundingCoordinateRegionWithCoordinates(CLLocationCoordinate2D *coordinates, NSUInteger count);
    
    extern QCoordinateRegion QBoundingCoordinateRegionWithCoordinatesAndCenter(CLLocationCoordinate2D *coordinates, NSUInteger count, CLLocationCoordinate2D centerCoordinate);
    
    extern QMapRect QWorldMapRect(void);

    extern double QAreaForPolygon(CLLocationCoordinate2D *coordinates, int count);
    
    @interface NSValue (NSValueQGeometryExtensions)

    + (NSValue *)valueWithQMapPoint:(QMapPoint)mapPoint;

    + (NSValue *)valueWithQMapSize:(QMapSize)mapSize;

    + (NSValue *)valueWithQMapRect:(QMapRect)mapRect;

    + (NSValue *)valueWithCoordinate:(CLLocationCoordinate2D)coordinate;

    - (QMapPoint)QMapPointValue;

    - (QMapSize)QMapSizeValue;

    - (QMapRect)QMapRectValue;

    - (CLLocationCoordinate2D)coordinateValue;
 
    @end
 
 
#ifdef __cplusplus
}
#endif