Add vector image layer

Author: Stefan Kuethe

examples/standalone/layers/image_vector_layer.py

@@ -0,0 +1,20 @@
+# See https://openlayers.org/en/latest/examples/image-vector-layer.html
+
+import openlayers as ol
+# from openlayers.models.layers import VectorImageLayer
+
+data = "https://openlayers.org/data/vector/ecoregions.json"
+
+style = ol.FlatStyle(
+    fill_color=['string', ['get', 'COLOR'], '#eee']
+)
+
+layer = ol.VectorImageLayer(
+    background="#1a2b39",
+    image_ratio=2,
+    source=ol.VectorSource(url=data),
+    style=style
+)
+
+m = ol.Map(layers=[layer])
+m.save()

examples/standalone/layers/vector_image_layer.py

@@ -10,6 +10,7 @@
     WebGLVectorLayer,
     VectorTileLayer,
     WebGLVectorTileLayer,
+    VectorImageLayer,
 )
 
 __all__ = [
@@ -20,4 +21,5 @@
     "BasemapLayer",
     "VectorTileLayer",
     "WebGLVectorTileLayer",
+    "VectorImageLayer"
 ]

src/openlayers/layers.py

@@ -57,6 +57,18 @@ def validate_style(cls, v):
         return v
     """
 
+class VectorImageLayer(VectorLayer):
+    """A layer for rendering vector sources
+    
+    This layer type provides great performance during panning and zooming,
+    but point symbols and texts are always rotated with the view and pixels are scaled during zoom animations.
+    
+    Note:
+        See also [VectorImageLayer](https://openlayers.org/en/latest/apidoc/module-ol_layer_VectorImage-VectorImageLayer.html)
+    """
+    image_ratio: int | None = Field(None, serialization_alias="imageRatio")
+
+
 class WebGLVectorLayer(VectorLayer):
     """A layer for rendering vector sources using WebGL"""
     ...
@@ -79,4 +91,5 @@ class WebGLTileLayer(Layer):
     WebGLTileLayer,
     VectorTileLayer,
     WebGLVectorTileLayer,
+    VectorImageLayer
 ]