Previously, we declared MGLStyleLayer initializers in the MGLStyleLayer protocol as optional methods. This made it easy to opt in and out of initializers that did or or did not make sense for the subclass. However, this approach was dangerous since it was easy for an application developer to initialize an MGLStyleLayer subclass with an init method that was actually not implemented in that class causing an exception at runtime. This commit moves the init methods that each subclass supports to each subclass so xcode (and the compiler) help the developer avoid the previously possible runtime exception. In addition, a new init method is added that takes the source layer and passes that on to `mbgl::style:Layer` (but only on classes where this is possible in core). This allows an application developer to style a specific source layer (i.e. the contour lines of the mapbox terrain vector source). Finally, this refactors MGLStyleLayer classes to use an MGLSource instead of a string identifier for the source when initializing the style.
53 lines
1.8 KiB
Objective-C
53 lines
1.8 KiB
Objective-C
// This file is generated.
|
|
// Edit platform/darwin/scripts/generate-style-code.js, then run `make style-code-darwin`.
|
|
|
|
#import "MGLStyleAttributeValue.h"
|
|
#import "MGLBaseStyleLayer.h"
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
@interface MGLBackgroundStyleLayer : MGLBaseStyleLayer <MGLStyleLayer>
|
|
|
|
- (instancetype)initWithLayerIdentifier:(NSString *)layerIdentifier;
|
|
|
|
- (instancetype)initWithLayerIdentifier:(NSString *)layerIdentifier source:(MGLSource *)source;
|
|
|
|
|
|
#pragma mark - Accessing the Paint Attributes
|
|
|
|
#if TARGET_OS_IPHONE
|
|
/**
|
|
The color with which the background will be drawn.
|
|
|
|
The default value of this property is `UIColor.blackColor`. Set this property to `nil` to reset it to the default value.
|
|
|
|
This property is only applied to the style if `backgroundPattern` is set to `nil`. Otherwise, it is ignored.
|
|
*/
|
|
@property (nonatomic, null_resettable) id <MGLStyleAttributeValue> backgroundColor;
|
|
#else
|
|
/**
|
|
The color with which the background will be drawn.
|
|
|
|
The default value of this property is `NSColor.blackColor`. Set this property to `nil` to reset it to the default value.
|
|
|
|
This property is only applied to the style if `backgroundPattern` is set to `nil`. Otherwise, it is ignored.
|
|
*/
|
|
@property (nonatomic, null_resettable) id <MGLStyleAttributeValue> backgroundColor;
|
|
#endif
|
|
|
|
/**
|
|
Name of image in sprite to use for drawing an image background. For seamless patterns, image width and height must be a factor of two (2, 4, 8, ..., 512).
|
|
*/
|
|
@property (nonatomic, null_resettable) id <MGLStyleAttributeValue> backgroundPattern;
|
|
|
|
/**
|
|
The opacity at which the background will be drawn.
|
|
|
|
The default value of this property is an `NSNumber` object containing the float `1`. Set this property to `nil` to reset it to the default value.
|
|
*/
|
|
@property (nonatomic, null_resettable) id <MGLStyleAttributeValue> backgroundOpacity;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|