MGLLight


@interface MGLLight : NSObject

An MGLLight object represents the light source for extruded geometries in MGLStyle.

  • Whether extruded geometries are lit relative to the map or viewport.

    The default value of this property is an MGLStyleValue object containing an NSValue object containing MGLLightAnchorViewport.

    You can set this property to an instance of:

    This property corresponds to the anchor light property in the Mapbox Style Specification.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic)
        MGLStyleValue<NSValue *> *_Nonnull anchor;

    Swift

    var anchor: MGLStyleValue<NSValue> { get set }
  • Position of the MGLLight source relative to lit (extruded) geometries, in a MGLSphericalPosition struct [radial coordinate, azimuthal angle, polar angle] where radial indicates the distance from the center of the base of an object to its light, azimuthal indicates the position of the light relative to 0° (0° when MGLLight.anchor is set to MGLLightAnchorViewport corresponds to the top of the viewport, or 0° when MGLLight.anchor is set to MGLLightAnchorMap corresponds to due north, and degrees proceed clockwise), and polar indicates the height of the light (from 0°, directly above, to 180°, directly below).

    The default value of this property is an MGLStyleValue object containing an MGLSphericalPosition struct set to 1.15 radial, 210 azimuthal and 30 polar.

    You can set this property to an instance of:

    This property corresponds to the position light property in the Mapbox Style Specification.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic)
        MGLStyleValue<NSValue *> *_Nonnull position;

    Swift

    var position: MGLStyleValue<NSValue> { get set }
  • The transition affecting any changes to this layer’s position property.

    This property corresponds to the position-transition property in the style JSON file format.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) MGLTransition positionTransition;

    Swift

    var positionTransition: MGLTransition { get set }
  • Color tint for lighting extruded geometries.

    The default value of this property is an MGLStyleValue object containing NSColor.whiteColor.

    You can set this property to an instance of:

    This property corresponds to the color light property in the Mapbox Style Specification.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic)
        MGLStyleValue<NSColor *> *_Nonnull color;

    Swift

    var color: MGLStyleValue<NSColor> { get set }
  • The transition affecting any changes to this layer’s color property.

    This property corresponds to the color-transition property in the style JSON file format.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) MGLTransition colorTransition;

    Swift

    var colorTransition: MGLTransition { get set }
  • Intensity of lighting (on a scale from 0 to 1). Higher numbers will present as more extreme contrast.

    The default value of this property is an MGLStyleValue object containing an NSNumber object containing the float 0.5.

    You can set this property to an instance of:

    This property corresponds to the intensity light property in the Mapbox Style Specification.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic)
        MGLStyleValue<NSNumber *> *_Nonnull intensity;

    Swift

    var intensity: MGLStyleValue<NSNumber> { get set }
  • The transition affecting any changes to this layer’s intensity property.

    This property corresponds to the intensity-transition property in the style JSON file format.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) MGLTransition intensityTransition;

    Swift

    var intensityTransition: MGLTransition { get set }