Geometry Reference


                    
                    
                    DingiCoordinateBounds

A rectangular area as measured on a two-dimensional map projection.

Declaration

Objective-C

struct DingiCoordinateBounds {}

Swift

struct DingiCoordinateBounds


                    
                    
                    DingiCoordinateBoundsEqualToCoordinateBounds

Returns YES if the two coordinate bounds are equal to each other.

Declaration

Objective-C

static inline BOOL
DingiCoordinateBoundsEqualToCoordinateBounds(DingiCoordinateBounds bounds1,
                                             DingiCoordinateBounds bounds2)

Swift

func DingiCoordinateBoundsEqualToCoordinateBounds(_ bounds1: DingiCoordinateBounds, _ bounds2: DingiCoordinateBounds) -> Bool


                    
                    
                    DingiCoordinateBoundsGetCoordinateSpan

Returns the area spanned by the coordinate bounds.

Declaration

Objective-C

static inline DingiCoordinateSpan
DingiCoordinateBoundsGetCoordinateSpan(DingiCoordinateBounds bounds)

Swift

func DingiCoordinateBoundsGetCoordinateSpan(_ bounds: DingiCoordinateBounds) -> DingiCoordinateSpan


                    
                    
                    DingiCoordinateBoundsIntersectsCoordinateBounds

Returns YES if the two coordinate bounds intersect.

Declaration

Objective-C

static inline BOOL
DingiCoordinateBoundsIntersectsCoordinateBounds(DingiCoordinateBounds bounds1,
                                                DingiCoordinateBounds bounds2)

Swift

func DingiCoordinateBoundsIntersectsCoordinateBounds(_ bounds1: DingiCoordinateBounds, _ bounds2: DingiCoordinateBounds) -> Bool


                    
                    
                    DingiCoordinateBoundsIsEmpty

Returns YES if the coordinate bounds covers no area.

Note

A bounds may be empty but have a non-zero coordinate span (e.g., when its northeast point lies due north of its southwest point).

Declaration

Objective-C

static inline BOOL DingiCoordinateBoundsIsEmpty(DingiCoordinateBounds bounds)

Swift

func DingiCoordinateBoundsIsEmpty(_ bounds: DingiCoordinateBounds) -> Bool


                    
                    
                    DingiCoordinateBoundsMake

Creates a new DingiCoordinateBounds structure from the given southwest and northeast coordinates.

Declaration

Objective-C

static inline DingiCoordinateBounds
DingiCoordinateBoundsMake(CLLocationCoordinate2D sw, CLLocationCoordinate2D ne)

Swift

func DingiCoordinateBoundsMake(_ sw: CLLocationCoordinate2D, _ ne: CLLocationCoordinate2D) -> DingiCoordinateBounds


                    
                    
                    DingiCoordinateBoundsOffset

Returns a coordinate bounds with southwest and northeast coordinates that are offset from those of the source bounds.

Declaration

Objective-C

static inline DingiCoordinateBounds
DingiCoordinateBoundsOffset(DingiCoordinateBounds bounds,
                            DingiCoordinateSpan offset)

Swift

func DingiCoordinateBoundsOffset(_ bounds: DingiCoordinateBounds, _ offset: DingiCoordinateSpan) -> DingiCoordinateBounds


                    
                    
                    DingiCoordinateInCoordinateBounds

Returns YES if the coordinate is within the coordinate bounds.

Declaration

Objective-C

static inline BOOL
DingiCoordinateInCoordinateBounds(CLLocationCoordinate2D coordinate,
                                  DingiCoordinateBounds bounds)

Swift

func DingiCoordinateInCoordinateBounds(_ coordinate: CLLocationCoordinate2D, _ bounds: DingiCoordinateBounds) -> Bool


                    
                    
                    DingiCoordinateQuad

A quadrilateral area as measured on a two-dimensional map projection. DingiCoordinateQuad differs from DingiCoordinateBounds in that it allows representation of non-axis aligned bounds and non-rectangular quadrilaterals. The coordinates are described in counter clockwise order from top left.

Declaration

Objective-C

struct DingiCoordinateQuad {}

Swift

struct DingiCoordinateQuad


                    
                    
                    DingiCoordinateQuadMake

Creates a new DingiCoordinateQuad structure from the given top left, bottom left, bottom right, and top right coordinates.

Declaration

Objective-C

static inline DingiCoordinateQuad DingiCoordinateQuadMake(
    CLLocationCoordinate2D topLeft, CLLocationCoordinate2D bottomLeft,
    CLLocationCoordinate2D bottomRight, CLLocationCoordinate2D topRight)

Swift

func DingiCoordinateQuadMake(_ topLeft: CLLocationCoordinate2D, _ bottomLeft: CLLocationCoordinate2D, _ bottomRight: CLLocationCoordinate2D, _ topRight: CLLocationCoordinate2D) -> DingiCoordinateQuad


                    
                    
                    DingiCoordinateQuadFromCoordinateBounds

Creates a new DingiCoordinateQuad structure from the given DingiCoordinateBounds. The returned quad uses the bounds’ northeast coordinate as the top right, and the southwest coordinate at the bottom left.

Declaration

Objective-C

static inline DingiCoordinateQuad
DingiCoordinateQuadFromCoordinateBounds(DingiCoordinateBounds bounds)

Swift

func DingiCoordinateQuadFromCoordinateBounds(_ bounds: DingiCoordinateBounds) -> DingiCoordinateQuad


                    
                    
                    DingiCoordinateSpan

Defines the area spanned by an DingiCoordinateBounds.

Declaration

Objective-C

struct DingiCoordinateSpan {}

Swift

struct DingiCoordinateSpan


                    
                    
                    DingiCoordinateSpanEqualToCoordinateSpan

Returns YES if the two coordinate spans represent the same latitudinal change and the same longitudinal change.

Declaration

Objective-C

static inline BOOL
DingiCoordinateSpanEqualToCoordinateSpan(DingiCoordinateSpan span1,
                                         DingiCoordinateSpan span2)

Swift

func DingiCoordinateSpanEqualToCoordinateSpan(_ span1: DingiCoordinateSpan, _ span2: DingiCoordinateSpan) -> Bool


                    
                    
                    DingiCoordinateSpanMake

Creates a new DingiCoordinateSpan from the given latitudinal and longitudinal deltas.

Declaration

Objective-C

static inline DingiCoordinateSpan
DingiCoordinateSpanMake(CLLocationDegrees latitudeDelta,
                        CLLocationDegrees longitudeDelta)

Swift

func DingiCoordinateSpanMake(_ latitudeDelta: CLLocationDegrees, _ longitudeDelta: CLLocationDegrees) -> DingiCoordinateSpan


                    
                    
                    DingiCoordinateSpanZero

An area of zero width and zero height.

Declaration

Objective-C

extern const DingiCoordinateSpan DingiCoordinateSpanZero

Swift

let DingiCoordinateSpanZero: DingiCoordinateSpan


                    
                    
                    DingiDegreesFromRadians

Returns degrees, converted from radians.

Declaration

Objective-C

static inline CLLocationDegrees DingiDegreesFromRadians(CGFloat radians)

Swift

func DingiDegreesFromRadians(_ radians: CGFloat) -> CLLocationDegrees


                    
                    
                    DingiRadiansFromDegrees

Returns radians, converted from degrees.

Declaration

Objective-C

static inline CGFloat DingiRadiansFromDegrees(CLLocationDegrees degrees)

Swift

func DingiRadiansFromDegrees(_ degrees: CLLocationDegrees) -> CGFloat


                    
                    
                    DingiStringFromCoordinateBounds

Returns a formatted string for the given coordinate bounds.

Declaration

Objective-C

static inline NSString *_Nonnull DingiStringFromCoordinateBounds(
    DingiCoordinateBounds bounds)

Swift

func DingiStringFromCoordinateBounds(_ bounds: DingiCoordinateBounds) -> String


                    
                    
                    DingiStringFromCoordinateQuad

Returns a formatted string for the given coordinate quad.

Declaration

Objective-C

static inline NSString *_Nonnull DingiStringFromCoordinateQuad(
    DingiCoordinateQuad quad)

Swift

func DingiStringFromCoordinateQuad(_ quad: DingiCoordinateQuad) -> String