Merge pull request OSGeo#11968 from ctoney/mem_creation_opt

MEM: set IMAGE_STRUCTURE metadata for INTERLEAVE=BAND and document the creation option

Author: rouault

autotest/gdrivers/mem.py

@@ -250,6 +250,10 @@ def test_mem_4():
             cs == expected_cs[i]
         ), "did not get expected checksum for band %d after fill" % (i + 1)
 
+    assert (
+        ds.GetMetadataItem("INTERLEAVE", "IMAGE_STRUCTURE") == "BAND"
+    ), "did not get expected INTERLEAVE value"
+
     ds = None
 
 

autotest/utilities/test_gdalalg_raster_info.py

@@ -113,6 +113,7 @@ def test_gdalalg_raster_info_mdd_all():
     j = json.loads(output_string)
     assert j["metadata"] == {
         "": {"AREA_OR_POINT": "Area"},
+        "IMAGE_STRUCTURE": {"INTERLEAVE": "BAND"},
         "MY_DOMAIN": {"foo": "bar"},
         "DERIVED_SUBDATASETS": {
             "DERIVED_SUBDATASET_1_NAME": "DERIVED_SUBDATASET:LOGAMPLITUDE:",

doc/source/drivers/raster/mem.rst

@@ -90,7 +90,14 @@ or
 Creation Options
 ----------------
 
-There are no supported creation options.
+|about-creation-options|
+This driver supports the following creation option:
+
+-  .. co:: INTERLEAVE
+      :choices: BAND, PIXEL
+      :default: BAND
+
+      Set the interleaving to use
 
 The MEM format is one of the few that supports the AddBand() method. The
 AddBand() method supports DATAPOINTER, PIXELOFFSET and LINEOFFSET

frmts/mem/memdataset.cpp

@@ -1404,6 +1404,8 @@ MEMDataset *MEMDataset::Create(const char * /* pszFilename */, int nXSize,
 
     if (bPixelInterleaved)
         poDS->SetMetadataItem("INTERLEAVE", "PIXEL", "IMAGE_STRUCTURE");
+    else
+        poDS->SetMetadataItem("INTERLEAVE", "BAND", "IMAGE_STRUCTURE");
 
     /* -------------------------------------------------------------------- */
     /*      Create band information objects.                                */