Expose line cutout width (#6717)

This PR exposes `LineLayer.lineCutoutFadeWidth`.

Addresses: https://mapbox.atlassian.net/browse/MAPSAND-2309 and
https://mapbox.atlassian.net/browse/MAPSIOS-1960

cc @mapbox/maps-android
cc @mapbox/maps-ios
cc @mapbox/sdk-ci

GitOrigin-RevId: f5b179023b9c3baed0765b9ce38688aa396fa28e

Author: evil159

CHANGELOG.md

@@ -18,6 +18,7 @@ Mapbox welcomes participation and contributions from everyone.
   - **Road appearance**: Adjust road brightness, show/hide pedestrian roads and transit networks
   - **Administrative boundaries**: Toggle boundary visibility and customize colors
   - **3D objects**: Control visibility of buildings, landmarks, and trees with `show3dObjects`
+* Expose `LineLayer.lineCutoutFadeWidth` to control route line cutout fade width.
 
 ## Bug fixes 🐞
 * MapboxTracing was deprecated and moved to package com.mapbox.common. 

app/src/androidTest/java/com/mapbox/maps/testapp/annotation/generated/PolylineAnnotationManagerAndroidTest.kt

@@ -192,7 +192,8 @@ class DynamicViewAnnotationActivity : AppCompatActivity() {
           lineColor(Color.parseColor("#FF999999"))
           // make map elements around (30m) route line visible through obstructing 3D buildings and other aboveground features
           lineCutoutWidth(30.0)
-          lineCutoutOpacity(0.2)
+          lineCutoutOpacity(0.0)
+          lineCutoutFadeWidth(0.5)
           lineWidth(12.0)
           lineBorderWidth(2.0)
           lineBorderColor(Color.parseColor("#FF333333"))
@@ -202,7 +203,8 @@ class DynamicViewAnnotationActivity : AppCompatActivity() {
           lineColor(Color.parseColor("#FF57A9FB"))
           // make map elements around (30m) route line visible through obstructing 3D buildings and other aboveground features
           lineCutoutWidth(30.0)
-          lineCutoutOpacity(0.2)
+          lineCutoutOpacity(0.0)
+          lineCutoutFadeWidth(0.5)
           lineWidth(12.0)
           lineCap(LineCap.ROUND)
           lineBorderWidth(2.0)

app/src/main/java/com/mapbox/maps/testapp/examples/markersandcallouts/viewannotation/DynamicViewAnnotationActivity.kt

@@ -959,6 +959,7 @@ package com.mapbox.maps.extension.compose.annotation.generated {
     method public androidx.compose.ui.graphics.Color? getLineColor();
     method public String? getLineColorUseTheme();
     method public Double? getLineCrossSlope();
+    method public Double? getLineCutoutFadeWidth();
     method public Double? getLineCutoutOpacity();
     method public Double? getLineCutoutWidth();
     method public java.util.List<java.lang.Double>? getLineDasharray();
@@ -996,6 +997,7 @@ package com.mapbox.maps.extension.compose.annotation.generated {
     method public void setLineColor(androidx.compose.ui.graphics.Color?);
     method public void setLineColorUseTheme(String?);
     method public void setLineCrossSlope(Double?);
+    method public void setLineCutoutFadeWidth(Double?);
     method public void setLineCutoutOpacity(Double?);
     method public void setLineCutoutWidth(Double?);
     method public void setLineDasharray(java.util.List<java.lang.Double>?);
@@ -1033,6 +1035,7 @@ package com.mapbox.maps.extension.compose.annotation.generated {
     property public final androidx.compose.ui.graphics.Color? lineColor;
     property public final String? lineColorUseTheme;
     property public final Double? lineCrossSlope;
+    property public final Double? lineCutoutFadeWidth;
     property public final Double? lineCutoutOpacity;
     property public final Double? lineCutoutWidth;
     property public final java.util.List<java.lang.Double>? lineDasharray;
@@ -2850,6 +2853,8 @@ package com.mapbox.maps.extension.compose.style.layers.generated {
     method public com.mapbox.maps.extension.compose.style.Transition getLineColorTransition();
     method public com.mapbox.maps.extension.compose.style.StringValue getLineColorUseTheme();
     method public com.mapbox.maps.extension.compose.style.DoubleValue getLineCrossSlope();
+    method public com.mapbox.maps.extension.compose.style.DoubleValue getLineCutoutFadeWidth();
+    method public com.mapbox.maps.extension.compose.style.Transition getLineCutoutFadeWidthTransition();
     method public com.mapbox.maps.extension.compose.style.DoubleValue getLineCutoutOpacity();
     method public com.mapbox.maps.extension.compose.style.Transition getLineCutoutOpacityTransition();
     method public com.mapbox.maps.extension.compose.style.DoubleValue getLineCutoutWidth();
@@ -2906,6 +2911,8 @@ package com.mapbox.maps.extension.compose.style.layers.generated {
     method public void setLineColorTransition(com.mapbox.maps.extension.compose.style.Transition);
     method public void setLineColorUseTheme(com.mapbox.maps.extension.compose.style.StringValue);
     method public void setLineCrossSlope(com.mapbox.maps.extension.compose.style.DoubleValue);
+    method public void setLineCutoutFadeWidth(com.mapbox.maps.extension.compose.style.DoubleValue);
+    method public void setLineCutoutFadeWidthTransition(com.mapbox.maps.extension.compose.style.Transition);
     method public void setLineCutoutOpacity(com.mapbox.maps.extension.compose.style.DoubleValue);
     method public void setLineCutoutOpacityTransition(com.mapbox.maps.extension.compose.style.Transition);
     method public void setLineCutoutWidth(com.mapbox.maps.extension.compose.style.DoubleValue);
@@ -2962,6 +2969,8 @@ package com.mapbox.maps.extension.compose.style.layers.generated {
     property public final com.mapbox.maps.extension.compose.style.Transition lineColorTransition;
     property public final com.mapbox.maps.extension.compose.style.StringValue lineColorUseTheme;
     property public final com.mapbox.maps.extension.compose.style.DoubleValue lineCrossSlope;
+    property public final com.mapbox.maps.extension.compose.style.DoubleValue lineCutoutFadeWidth;
+    property public final com.mapbox.maps.extension.compose.style.Transition lineCutoutFadeWidthTransition;
     property public final com.mapbox.maps.extension.compose.style.DoubleValue lineCutoutOpacity;
     property public final com.mapbox.maps.extension.compose.style.Transition lineCutoutOpacityTransition;
     property public final com.mapbox.maps.extension.compose.style.DoubleValue lineCutoutWidth;

extension-compose/api/Release/metalava.txt

@@ -768,6 +768,7 @@ public final class com/mapbox/maps/extension/compose/annotation/generated/Polyli
 	public final fun getLineColor-QN2ZGVo ()Landroidx/compose/ui/graphics/Color;
 	public final fun getLineColorUseTheme ()Ljava/lang/String;
 	public final fun getLineCrossSlope ()Ljava/lang/Double;
+	public final fun getLineCutoutFadeWidth ()Ljava/lang/Double;
 	public final fun getLineCutoutOpacity ()Ljava/lang/Double;
 	public final fun getLineCutoutWidth ()Ljava/lang/Double;
 	public final fun getLineDasharray ()Ljava/util/List;
@@ -805,6 +806,7 @@ public final class com/mapbox/maps/extension/compose/annotation/generated/Polyli
 	public final fun setLineColor-Y2TPw74 (Landroidx/compose/ui/graphics/Color;)V
 	public final fun setLineColorUseTheme (Ljava/lang/String;)V
 	public final fun setLineCrossSlope (Ljava/lang/Double;)V
+	public final fun setLineCutoutFadeWidth (Ljava/lang/Double;)V
 	public final fun setLineCutoutOpacity (Ljava/lang/Double;)V
 	public final fun setLineCutoutWidth (Ljava/lang/Double;)V
 	public final fun setLineDasharray (Ljava/util/List;)V
@@ -2410,6 +2412,8 @@ public final class com/mapbox/maps/extension/compose/style/layers/generated/Line
 	public final fun getLineColorTransition ()Lcom/mapbox/maps/extension/compose/style/Transition;
 	public final fun getLineColorUseTheme ()Lcom/mapbox/maps/extension/compose/style/StringValue;
 	public final fun getLineCrossSlope ()Lcom/mapbox/maps/extension/compose/style/DoubleValue;
+	public final fun getLineCutoutFadeWidth ()Lcom/mapbox/maps/extension/compose/style/DoubleValue;
+	public final fun getLineCutoutFadeWidthTransition ()Lcom/mapbox/maps/extension/compose/style/Transition;
 	public final fun getLineCutoutOpacity ()Lcom/mapbox/maps/extension/compose/style/DoubleValue;
 	public final fun getLineCutoutOpacityTransition ()Lcom/mapbox/maps/extension/compose/style/Transition;
 	public final fun getLineCutoutWidth ()Lcom/mapbox/maps/extension/compose/style/DoubleValue;
@@ -2466,6 +2470,8 @@ public final class com/mapbox/maps/extension/compose/style/layers/generated/Line
 	public final fun setLineColorTransition (Lcom/mapbox/maps/extension/compose/style/Transition;)V
 	public final fun setLineColorUseTheme (Lcom/mapbox/maps/extension/compose/style/StringValue;)V
 	public final fun setLineCrossSlope (Lcom/mapbox/maps/extension/compose/style/DoubleValue;)V
+	public final fun setLineCutoutFadeWidth (Lcom/mapbox/maps/extension/compose/style/DoubleValue;)V
+	public final fun setLineCutoutFadeWidthTransition (Lcom/mapbox/maps/extension/compose/style/Transition;)V
 	public final fun setLineCutoutOpacity (Lcom/mapbox/maps/extension/compose/style/DoubleValue;)V
 	public final fun setLineCutoutOpacityTransition (Lcom/mapbox/maps/extension/compose/style/Transition;)V
 	public final fun setLineCutoutWidth (Lcom/mapbox/maps/extension/compose/style/DoubleValue;)V