Add auto_webmercator to COG

Cargo.toml

@@ -49,6 +49,8 @@ env_logger = "0.11"
 flate2 = "1"
 flume = "0.11"
 futures = "0.3"
+image = "0.25.6"
+imageproc = "0.25.0"
 indoc = "2"
 insta = "1"
 itertools = "0.14"

docs/src/SUMMARY.md

@@ -23,6 +23,7 @@
     - [PostgreSQL Connections](pg-connections.md)
       - [PostgreSQL Table Sources](sources-pg-tables.md)
       - [PostgreSQL Function Sources](sources-pg-functions.md)
+  - [Cloud-Optimized-GeoTIFF Sources](sources-cog-files.md)
     - [Composite Sources](sources-composite.md)
   - [Supporting Resources](sources-resources.md)
     - [Sprites](sources-sprites.md)

docs/src/sources-cog-files.md

@@ -17,44 +17,38 @@ Martin can also serve raster sources like local [COG(Cloud Optimized GeoTIFF)](h
 * Deflate
 * PackBits
 
-## Run Martin with CLI to serve cog files
+## Supported Projection
 
-```bash
-# Configured with a directory containing `*.tif` or `*.tiff` TIFF files.
-martin /with/tiff/dir1 /with/tiff/dir2
-# Configured with dedicated TIFF file
-martin /path/to/target1.tif /path/to/target2.tiff
-# Configured with a combination of directories and dedicated TIFF files.
-martin /with/tiff/files /path/to/target1.tif /path/to/target2.tiff
-```
+Currently we only support COGS with [EPSG:3857](https://epsg.io/3857) by enable the `auto-web` option.
 
-## Run Martin with configuration file
+It's beacause the [Tile Matrix Set](https://docs.ogc.org/is/17-083r2/17-083r2.html#72) inside each COG file is highly customized for its extent and tilesize. It's not aligned
+with any well knowed TIle Matrix Set.
 
-```yml
-keep_alive: 75
+To load COG file, there are two approaches generally:
 
-# The socket address to bind [default: 0.0.0.0:3000]
-listen_addresses: '0.0.0.0:3000'
+1. The client(`Maplibre`, `OpenLayers`,etc) load COG file with the specific customized [Tile Matrix Set](https://docs.ogc.org/is/17-083r2/17-083r2.html#72).
+  To not break the compatibility with the [TileJson spec](https://github.com/mapbox/tilejson-spec), the `/catalog` seems a good choice to add the customized TMS info (Other data sources could benefit from this if we want to support other projections either, [Join our discussion there](https://github.com/maplibre/martin/issues/343))
 
-# Number of web server workers
-worker_processes: 8
+2. Martin serve COG files with well known [Tile Matrix Set](https://docs.ogc.org/is/17-083r2/17-083r2.html#72) and do the clipping internally.
+   Currently, we support [WebMercatorQuad](https://docs.ogc.org/is/17-083r2/17-083r2.html#72) if `auto-web: true` is configured.
 
-# Amount of memory (in MB) to use for caching tiles [default: 512, 0 to disable]
-cache_size_mb: 8
-
-# Database configuration. This can also be a list of PG configs.
+## Configuration file
 
+```yml
 cog:
-  paths:
-    # scan this whole dir, matching all *.tif and *.tiff files
-    - /dir-path
-    # specific TIFF file will be published as a cog source
-    - /path/to/target1.tif
-    - /path/to/target2.tiff
+  # Default false
+  # If enabled:
+  #   Serve COG with WebMercatorQuad
+  # Note: Just work for COG files with EPSG:3857
+  auto_web: false
   sources:
-    # named source matching source name to a single file
-     cog-src1: /path/to/cog1.tif
-     cog-src2: /path/to/cog2.tif
+    cog-src2: tests/fixtures/cog/rgb_u8.tif
+    cog-src1: tests/fixtures/cog/rgba_u8.tif
+    # Test COG with auto_webmercator enabled
+    cog-auto-web:
+      path: tests/fixtures/cog/rgba_u8_nodata.tiff
+      # inline option. Would override the global dauto_web.
+      auto_web: true
 ```
 
 ## About COG

martin-core/Cargo.toml

@@ -13,7 +13,7 @@ homepage.workspace = true
 
 [features]
 default = ["fonts", "styles", "sprites", "mbtiles", "cog"]
-cog = ["dep:png", "dep:tiff"]
+cog = ["dep:tiff", "dep:png", "dep:image", "dep:imageproc"]
 fonts = [
     "dep:bit-set",
     "dep:pbf_font_tools",
@@ -36,6 +36,8 @@ async-trait.workspace = true
 bit-set = { workspace = true, optional = true }
 dashmap = { workspace = true, optional = true }
 futures = { workspace = true, optional = true }
+image = { workspace = true, optional = true }
+imageproc = { workspace = true, optional = true }
 itertools = { workspace = true, optional = true }
 log.workspace = true
 martin-tile-utils.workspace = true

martin-core/src/tiles/cog/errors.rs

@@ -83,6 +83,10 @@ pub enum CogError {
     )]
     GetFullResolutionFailed(PathBuf),
 
+    /// Failed to create image buffer
+    #[error("Failed to create image buffer for {0}: {1}")]
+    ImageBufferCreationFailed(PathBuf, String),
+
     /// IO error.
     #[error("IO error {0}: {1}")]
     IoError(std::io::Error, PathBuf),