MGLLineStyleLayer


@interface MGLLineStyleLayer : MGLVectorStyleLayer

An MGLLineStyleLayer is a style layer that renders one or more stroked polylines on the map.

Use a line style layer to configure the visual appearance of polyline or multipolyline features in vector tiles loaded by an MGLVectorSource object or MGLPolyline, MGLPolylineFeature, MGLMultiPolyline, or MGLMultiPolylineFeature instances in an MGLShapeSource object.

You can access an existing line style layer using the -[MGLStyle layerWithIdentifier:] method if you know its identifier; otherwise, find it using the MGLStyle.layers property. You can also create a new line style layer and add it to the style using a method such as -[MGLStyle addLayer:].

Example

let layer = MGLLineStyleLayer(identifier: "trails-path", source: trails)
layer.sourceLayerIdentifier = "trails"
layer.lineWidth = MGLStyleValue(interpolationMode: .exponential,
                                cameraStops: [14: MGLStyleValue(rawValue: 2),
                                              18: MGLStyleValue(rawValue: 20)],
                                options: [.interpolationBase: 1.5])
layer.lineColor = MGLStyleValue(rawValue: .brown)
layer.lineCap = MGLStyleValue(rawValue: NSValue(mglLineCap: .round))
layer.predicate = NSPredicate(format: "%K == %@", "trail-type", "mountain-biking")
mapView.style?.addLayer(layer)


                    
                    
                    -initWithIdentifier:source:

Returns a line style layer initialized with an identifier and source.

After initializing and configuring the style layer, add it to a map view’s style using the -[MGLStyle addLayer:] or -[MGLStyle insertLayer:belowLayer:] method.

Declaration

Objective-C

- (nonnull instancetype)initWithIdentifier:(nonnull NSString *)identifier
                                    source:(nonnull MGLSource *)source;

Swift

init(identifier: String, source: MGLSource)

Parameters

`identifier`	A string that uniquely identifies the source in the style to which it is added.
`source`	The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined.

Return Value

An initialized foreground style layer.

View Source on GitHub

Accessing the Layout Attributes

lineCap
The display of line endings.

The default value of this property is an MGLStyleValue object containing an NSValue object containing MGLLineCapButt. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *lineCap;
Swift

var lineCap: MGLStyleValue
View Source on GitHub
lineJoin
The display of lines when joining.

The default value of this property is an MGLStyleValue object containing an NSValue object containing MGLLineJoinMiter. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *lineJoin;
Swift

var lineJoin: MGLStyleValue
View Source on GitHub
lineMiterLimit
Used to automatically convert miter joins to bevel joins for sharp angles.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 2. Set this property to nil to reset it to the default value.

This property is only applied to the style if lineJoin is set to an MGLStyleValue object containing an NSValue object containing MGLLineJoinMiter. Otherwise, it is ignored.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineMiterLimit;
Swift

var lineMiterLimit: MGLStyleValue
View Source on GitHub
lineRoundLimit
Used to automatically convert round joins to miter joins for shallow angles.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 1.05. Set this property to nil to reset it to the default value.

This property is only applied to the style if lineJoin is set to an MGLStyleValue object containing an NSValue object containing MGLLineJoinRound. Otherwise, it is ignored.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineRoundLimit;
Swift

var lineRoundLimit: MGLStyleValue
View Source on GitHub

Accessing the Paint Attributes

lineBlur
Blur applied to the line, in points.

This property is measured in points.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 0. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
- MGLSourceStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
  
  MGLInterpolationModeIdentity
- MGLCompositeStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineBlur;
Swift

var lineBlur: MGLStyleValue
View Source on GitHub
lineBlurTransition
The transition affecting any changes to this layer’s lineBlur property.

This property corresponds to the line-blur-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineBlurTransition;
Swift

var lineBlurTransition: MGLTransition { get set }
View Source on GitHub
lineColor
The color with which the line will be drawn.

The default value of this property is an MGLStyleValue object containing NSColor.blackColor. Set this property to nil to reset it to the default value.

This property is only applied to the style if linePattern is set to nil. Otherwise, it is ignored.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
- MGLSourceStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
  
  MGLInterpolationModeIdentity
- MGLCompositeStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSColor *> *lineColor;
Swift

var lineColor: MGLStyleValue
View Source on GitHub
lineColorTransition
The transition affecting any changes to this layer’s lineColor property.

This property corresponds to the line-color-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineColorTransition;
Swift

var lineColorTransition: MGLTransition { get set }
View Source on GitHub
lineDashPattern
Specifies the lengths of the alternating dashes and gaps that form the dash pattern. The lengths are later scaled by the line width. To convert a dash length to points, multiply the length by the current line width.

This property is measured in line widths.

This property is only applied to the style if linePattern is set to nil. Otherwise, it is ignored.

This attribute corresponds to the line-dasharray layout property in the Mapbox Style Specification.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSArray<NSNumber *> *> *lineDashPattern;
Swift

var lineDashPattern: MGLStyleValue
View Source on GitHub
lineDashPatternTransition
The transition affecting any changes to this layer’s lineDashPattern property.

This property corresponds to the line-dasharray-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineDashPatternTransition;
Swift

var lineDashPatternTransition: MGLTransition { get set }
View Source on GitHub
lineGapWidth
Draws a line casing outside of a line’s actual path. Value indicates the width of the inner gap.

This property is measured in points.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 0. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
- MGLSourceStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
  
  MGLInterpolationModeIdentity
- MGLCompositeStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineGapWidth;
Swift

var lineGapWidth: MGLStyleValue
View Source on GitHub
lineGapWidthTransition
The transition affecting any changes to this layer’s lineGapWidth property.

This property corresponds to the line-gap-width-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineGapWidthTransition;
Swift

var lineGapWidthTransition: MGLTransition { get set }
View Source on GitHub
lineOffset
The line’s offset. For linear features, a positive value offsets the line to the right, relative to the direction of the line, and a negative value to the left. For polygon features, a positive value results in an inset, and a negative value results in an outset.

This property is measured in points.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 0. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
- MGLSourceStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
  
  MGLInterpolationModeIdentity
- MGLCompositeStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineOffset;
Swift

var lineOffset: MGLStyleValue
View Source on GitHub
lineOffsetTransition
The transition affecting any changes to this layer’s lineOffset property.

This property corresponds to the line-offset-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineOffsetTransition;
Swift

var lineOffsetTransition: MGLTransition { get set }
View Source on GitHub
lineOpacity
The opacity at which the line will be drawn.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 1. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
- MGLSourceStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
  
  MGLInterpolationModeIdentity
- MGLCompositeStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
  
  MGLInterpolationModeCategorical
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineOpacity;
Swift

var lineOpacity: MGLStyleValue
View Source on GitHub
lineOpacityTransition
The transition affecting any changes to this layer’s lineOpacity property.

This property corresponds to the line-opacity-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineOpacityTransition;
Swift

var lineOpacityTransition: MGLTransition { get set }
View Source on GitHub
linePattern
Name of image in style images to use for drawing image lines. For seamless patterns, image width must be a factor of two (2, 4, 8, …, 512).

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSString *> *linePattern;
Swift

var linePattern: MGLStyleValue
View Source on GitHub
linePatternTransition
The transition affecting any changes to this layer’s linePattern property.

This property corresponds to the line-pattern-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition linePatternTransition;
Swift

var linePatternTransition: MGLTransition { get set }
View Source on GitHub
lineTranslation
The geometry’s offset.

This property is measured in points.

The default value of this property is an MGLStyleValue object containing an NSValue object containing a CGVector struct set to 0 points rightward and 0 points upward. Set this property to nil to reset it to the default value.

This attribute corresponds to the line-translate layout property in the Mapbox Style Specification.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *lineTranslation;
Swift

var lineTranslation: MGLStyleValue
View Source on GitHub
lineTranslationTransition
The transition affecting any changes to this layer’s lineTranslation property.

This property corresponds to the line-translate-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineTranslationTransition;
Swift

var lineTranslationTransition: MGLTransition { get set }
View Source on GitHub
lineTranslationAnchor
Controls the translation reference point.

The default value of this property is an MGLStyleValue object containing an NSValue object containing MGLLineTranslationAnchorMap. Set this property to nil to reset it to the default value.

This property is only applied to the style if lineTranslation is non-nil. Otherwise, it is ignored.

This attribute corresponds to the line-translate-anchor layout property in the Mapbox Style Specification.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSValue *> *lineTranslationAnchor;
Swift

var lineTranslationAnchor: MGLStyleValue
View Source on GitHub
lineWidth
Stroke thickness.

This property is measured in points.

The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 1. Set this property to nil to reset it to the default value.

You can set this property to an instance of:
- MGLConstantStyleValue
- MGLCameraStyleFunction with an interpolation mode of:
  
  MGLInterpolationModeExponential
  
  MGLInterpolationModeInterval
Declaration
Objective-C

@property (assign, readwrite, nonatomic, null_resettable) MGLStyleValue<NSNumber *> *lineWidth;
Swift

var lineWidth: MGLStyleValue
View Source on GitHub
lineWidthTransition
The transition affecting any changes to this layer’s lineWidth property.

This property corresponds to the line-width-transition property in the style JSON file format.
Declaration
Objective-C

@property (assign, readwrite, nonatomic) MGLTransition lineWidthTransition;
Swift

var lineWidthTransition: MGLTransition { get set }
View Source on GitHub