Website updates

Author: ahocevar

dist/en/main/apidoc/module-ol_interaction_Modify-Modify.html

@@ -177,7 +177,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L249">line 249</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L255">line 255</a>
         </div>
 
     </div>
@@ -593,6 +593,35 @@ <h4 class="name">
         </tr>
 
 
+
+        <tr class="">
+            
+                <td class="name"><code>sharedVerticesEqual</code></td>
+            
+
+            
+            <td class="type">
+            
+                
+<span class="param-type">function</span>
+
+ | undefined
+                
+            
+            </td>
+
+            
+
+            <td  class="description last">
+                
+                <p>A function that takes two coordinates and returns whether they should be
+considered equal for vertex matching purposes. By default, all coordinate
+dimensions are compared. This is useful when features have mixed coordinate
+dimensions (e.g., XY and XYZ) but should still be treated as sharing vertices
+at the same 2D position.</p></td>
+        </tr>
+
+	
 	</tbody>
 </table>
 
@@ -793,7 +822,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2172">line 2172</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2194">line 2194</a>
         </div>
 
     </div>
@@ -884,7 +913,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L1980">line 1980</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2002">line 2002</a>
         </div>
 
     </div>
@@ -1614,7 +1643,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L699">line 699</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L713">line 713</a>
         </div>
 
     </div>
@@ -1982,7 +2011,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2205">line 2205</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2227">line 2227</a>
         </div>
 
     </div>
@@ -2452,7 +2481,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2011">line 2011</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L2033">line 2033</a>
         </div>
 
     </div>
@@ -2766,7 +2795,7 @@ <h4 class="name">
 
         <div class="tag-source">
             <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js">interaction/Modify.js</a>,
-            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L674">line 674</a>
+            <a href="https://github.com/openlayers/openlayers/blob/main/src/ol/interaction/Modify.js#L688">line 688</a>
         </div>
 
     </div>

dist/en/main/apidoc/module-ol_interaction_Modify.html

@@ -699,6 +699,33 @@ <h5 class="subsection-title">Properties:</h5>
         </tr>
 
 
+
+        <tr>
+            
+                <td class="name"><code>sharedVerticesEqual</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">function</span>
+
+ | undefined
+                
+            
+            </td>
+
+            <td class="description last">
+                <p>A function that takes two coordinates and returns whether they should be
+considered equal for vertex matching purposes. By default, all coordinate
+dimensions are compared. This is useful when features have mixed coordinate
+dimensions (e.g., XY and XYZ) but should still be treated as sharing vertices
+at the same 2D position.</p>
+                
+            </td>
+        </tr>
+
+	
 	</tbody>
 </table></dl>
 

dist/en/main/examples/common.js

@@ -156,6 +156,14 @@ export type Options = {
      * pointer coordinate when clicked within the `pixelTolerance`.
      */
     snapToPointer?: boolean | undefined;
+    /**
+     * A function that takes two coordinates and returns whether they should be
+     * considered equal for vertex matching purposes. By default, all coordinate
+     * dimensions are compared. This is useful when features have mixed coordinate
+     * dimensions (e.g., XY and XYZ) but should still be treated as sharing vertices
+     * at the same 2D position.
+     */
+    sharedVerticesEqual?: ((arg0: import("../coordinate.js").Coordinate, arg1: import("../coordinate.js").Coordinate) => boolean) | undefined;
 };
 /**
  * *
@@ -374,6 +382,11 @@ declare class Modify extends PointerInteraction {
      * @type {FilterFunction}
      */
     private filter_;
+    /**
+     * @private
+     * @type {function(import("../coordinate.js").Coordinate, import("../coordinate.js").Coordinate): boolean}
+     */
+    private coordinatesEqual_;
     featuresCollection_: Collection<Feature<import("../geom.js").Geometry, {
         [x: string]: any;
     }>> | undefined;

dist/en/main/examples/common.js.map

@@ -162,6 +162,12 @@ const ModifyEventType = {
  * overlay.
  * @property {boolean} [snapToPointer=!hitDetection] The vertex, point or segment being modified snaps to the
  * pointer coordinate when clicked within the `pixelTolerance`.
+ * @property {function(import("../coordinate.js").Coordinate, import("../coordinate.js").Coordinate): boolean} [sharedVerticesEqual]
+ * A function that takes two coordinates and returns whether they should be
+ * considered equal for vertex matching purposes. By default, all coordinate
+ * dimensions are compared. This is useful when features have mixed coordinate
+ * dimensions (e.g., XY and XYZ) but should still be treated as sharing vertices
+ * at the same 2D position.
  */
 
 function getCoordinatesArray(coordinates, geometryType, depth) {
@@ -468,6 +474,14 @@ class Modify extends PointerInteraction {
      */
     this.filter_ = options.filter ? options.filter : () => true;
 
+    /**
+     * @private
+     * @type {function(import("../coordinate.js").Coordinate, import("../coordinate.js").Coordinate): boolean}
+     */
+    this.coordinatesEqual_ = options.sharedVerticesEqual
+      ? options.sharedVerticesEqual
+      : coordinatesEqual;
+
     if (!(options.features || options.source)) {
       throw new Error(
         'The modify interaction requires features collection or a source',
@@ -1109,7 +1123,7 @@ class Modify extends PointerInteraction {
           projection,
         );
         if (
-          coordinatesEqual(closestVertex, vertex) &&
+          this.coordinatesEqual_(closestVertex, vertex) &&
           !componentSegments[uid][0]
         ) {
           this.dragSegments_.push([segmentDataMatch, 0]);
@@ -1118,13 +1132,19 @@ class Modify extends PointerInteraction {
         continue;
       }
 
-      if (coordinatesEqual(segment[0], vertex) && !componentSegments[uid][0]) {
+      if (
+        this.coordinatesEqual_(segment[0], vertex) &&
+        !componentSegments[uid][0]
+      ) {
         this.dragSegments_.push([segmentDataMatch, 0]);
         componentSegments[uid][0] = segmentDataMatch;
         continue;
       }
 
-      if (coordinatesEqual(segment[1], vertex) && !componentSegments[uid][1]) {
+      if (
+        this.coordinatesEqual_(segment[1], vertex) &&
+        !componentSegments[uid][1]
+      ) {
         if (
           componentSegments[uid][0] &&
           componentSegments[uid][0].index === 0
@@ -1456,9 +1476,11 @@ class Modify extends PointerInteraction {
     const geometry = segmentData.geometry;
     const index = dragSegment[1];
 
-    while (vertex.length < geometry.getStride()) {
-      vertex.push(segment[index][vertex.length]);
+    const stride = geometry.getStride();
+    for (let i = 2; i < stride; ++i) {
+      vertex[i] = segment[index][i];
     }
+    vertex.length = stride;
     switch (geometry.getType()) {
       case 'Point':
         coordinates = vertex;
@@ -1848,10 +1870,10 @@ class Modify extends PointerInteraction {
           for (let i = 1, ii = nodes.length; i < ii; ++i) {
             const segment = nodes[i].segment;
             if (
-              (coordinatesEqual(closestSegment[0], segment[0]) &&
-                coordinatesEqual(closestSegment[1], segment[1])) ||
-              (coordinatesEqual(closestSegment[0], segment[1]) &&
-                coordinatesEqual(closestSegment[1], segment[0]))
+              (this.coordinatesEqual_(closestSegment[0], segment[0]) &&
+                this.coordinatesEqual_(closestSegment[1], segment[1])) ||
+              (this.coordinatesEqual_(closestSegment[0], segment[1]) &&
+                this.coordinatesEqual_(closestSegment[1], segment[0]))
             ) {
               const geometryUid = getUid(nodes[i].geometry);
               if (!(geometryUid in geometries)) {
@@ -1996,8 +2018,8 @@ class Modify extends PointerInteraction {
     const segments = this.rBush_.getInExtent(boundingExtent([coordinate]));
     return segments.some(
       ({segment}) =>
-        coordinatesEqual(segment[0], coordinate) ||
-        coordinatesEqual(segment[1], coordinate),
+        this.coordinatesEqual_(segment[0], coordinate) ||
+        this.coordinatesEqual_(segment[1], coordinate),
     );
   }
 
@@ -2189,8 +2211,8 @@ class Modify extends PointerInteraction {
     return segments.some(
       ({segment}) =>
         !(
-          coordinatesEqual(segment[0], coordinate) ||
-          coordinatesEqual(segment[1], coordinate)
+          this.coordinatesEqual_(segment[0], coordinate) ||
+          this.coordinatesEqual_(segment[1], coordinate)
         ),
     );
   }