617de029fa
Co-authored-by: “Malcolm <“mtoon@atlasprogramming.com”> Co-authored-by: Bart Louwers <bart.louwers@gmail.com>
113 lines
3.4 KiB
Objective-C
113 lines
3.4 KiB
Objective-C
#import <Foundation/Foundation.h>
|
||
#import <Metal/Metal.h>
|
||
#if TARGET_OS_IPHONE
|
||
#import <UIKit/UIKit.h>
|
||
#else
|
||
#import <AppKit/AppKit.h>
|
||
#endif
|
||
|
||
#import "MLNFoundation.h"
|
||
#import "MLNGeometry.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
typedef enum {
|
||
MLNPluginLayerPropertyTypeUnknown,
|
||
MLNPluginLayerPropertyTypeSingleFloat,
|
||
MLNPluginLayerPropertyTypeColor
|
||
} MLNPluginLayerPropertyType;
|
||
|
||
MLN_EXPORT
|
||
@interface MLNPluginLayerProperty : NSObject
|
||
|
||
+ (MLNPluginLayerProperty *)propertyWithName:(NSString *)propertyName
|
||
propertyType:(MLNPluginLayerPropertyType)propertyType
|
||
defaultValue:(id)defaultValue;
|
||
|
||
// The name of the property
|
||
@property (copy) NSString *propertyName;
|
||
|
||
// The type of property
|
||
@property MLNPluginLayerPropertyType propertyType;
|
||
|
||
// Single float default value
|
||
@property float singleFloatDefaultValue;
|
||
|
||
// Color default value
|
||
#if TARGET_OS_IPHONE
|
||
@property (copy) UIColor *colorDefaultValue;
|
||
#else
|
||
@property NSColor *colorDefaultValue;
|
||
#endif
|
||
|
||
@end
|
||
|
||
typedef enum {
|
||
MLNPluginLayerTileKindGeometry,
|
||
MLNPluginLayerTileKindRaster,
|
||
MLNPluginLayerTileKindRasterDEM,
|
||
MLNPluginLayerTileKindNotRequired
|
||
} MLNPluginLayerTileKind;
|
||
|
||
MLN_EXPORT
|
||
@interface MLNPluginLayerCapabilities : NSObject
|
||
|
||
@property (copy) NSString *layerID;
|
||
@property BOOL requiresPass3D;
|
||
|
||
//! This is a list of layer properties that this layer supports.
|
||
@property (copy) NSArray<MLNPluginLayerProperty *> *layerProperties;
|
||
|
||
@end
|
||
|
||
@class MLNMapView;
|
||
|
||
// Copied initially from MLNStyleLayerDrawingContext. Decided to copy instead of use since we
|
||
// might add additional properties here
|
||
/// A structure containing context needed to draw a frame in an ``MLNCustomStyleLayer``.
|
||
typedef struct MLNPluginLayerDrawingContext {
|
||
/// The size of the drawable area, in points.
|
||
CGSize size;
|
||
/// The center coordinate of the map view.
|
||
CLLocationCoordinate2D centerCoordinate;
|
||
/// The current zoom level of the map view.
|
||
double zoomLevel;
|
||
/// The heading (direction) in degrees clockwise from true north.
|
||
CLLocationDirection direction;
|
||
/// The current pitch of the map view in degrees, measured from the map plane.
|
||
CGFloat pitch;
|
||
/// The vertical field of view, in degrees, for the map’s perspective.
|
||
CGFloat fieldOfView;
|
||
/// A 4×4 matrix representing the map view’s current projection state.
|
||
MLNMatrix4 projectionMatrix;
|
||
/// A 4×4 matrix representing the map view’s current near clip projection state.
|
||
MLNMatrix4 nearClippedProjMatrix;
|
||
|
||
} MLNPluginLayerDrawingContext;
|
||
|
||
MLN_EXPORT
|
||
@interface MLNPluginLayer : NSObject
|
||
|
||
/// Returns the layer capabilities of the plugin layer.
|
||
/// This must be overridden by the plug-in layer and return a set of capabilities
|
||
+ (MLNPluginLayerCapabilities *)layerCapabilities;
|
||
|
||
// These are public methods that can be overridden by the plugin layer
|
||
/// Called when the layer is rendered
|
||
- (void)onRenderLayer:(MLNMapView *)mapView
|
||
renderEncoder:(id<MTLRenderCommandEncoder>)renderEncoder;
|
||
|
||
/// Called when the layer is updated in the render loop. This would update animations/etc
|
||
- (void)onUpdateLayer:(MLNPluginLayerDrawingContext)drawingContext;
|
||
|
||
/// Called when the layer properties are updated. Can be on initial load from the JSON or when
|
||
/// dynamic properties are updated
|
||
- (void)onUpdateLayerProperties:(NSDictionary *)layerProperties;
|
||
|
||
/// Added to a map view
|
||
- (void)didMoveToMapView:(MLNMapView *)mapView;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|