From 43da7084e56d20c2cc02fc2b9d311456344f8140 Mon Sep 17 00:00:00 2001 From: Lucian Plesea Date: Sun, 30 Jun 2024 14:05:37 -0700 Subject: [PATCH] Add mrf-in-tar feature documentation --- doc/MUG.md | 19 +++- mrf_apps/vc/MUG/MUG.vcxproj | 135 ++++++++++++++++++++++++++++ mrf_apps/vc/MUG/MUG.vcxproj.filters | 22 +++++ mrf_apps/vc/vc.sln | 10 +++ 4 files changed, 184 insertions(+), 2 deletions(-) create mode 100644 mrf_apps/vc/MUG/MUG.vcxproj create mode 100644 mrf_apps/vc/MUG/MUG.vcxproj.filters diff --git a/doc/MUG.md b/doc/MUG.md index 186b792..9e63905 100644 --- a/doc/MUG.md +++ b/doc/MUG.md @@ -654,6 +654,20 @@ gdaladdo –r avg TenSlice.mrf:MRF:Z3 # Notes on using MRF +## MRF in TAR + +Many of the unique MRF applications rely on the separation of the MRF components in individual files. At times this can become +a nuisance. As a convenience, it is possible to pack all the MRF component files in a single tar file and use the resulting +tar as an MRF using GDAL. This feature is subject to the following requirements: + + - The MRF file names inside the tar do not include a path (basename only) + - The tar file includes all the MRF component files, with the metadata file (.mrf) being the first + - The tar uses a UStar (Unix Standard TAR) header format, not pax + - The file extension ends with .tar, with .mrf.tar being recommended + +As long as the conditions above are met, the GDAL MRF driver will recognise the file as an MRF file and will be able to read from it. +External overviews or external metadata (.mrf.aux.xml) will be used if included in the tar. + ## MRF as a Web Tile Cache One of the most common uses of MRF is to serve as a fast and easy to use tile cache for a web map tile server. Since far fewer files are used, adn MRF tile cache is much more efficient at using the disk than individual tiles would be, @@ -804,7 +818,8 @@ gdal_translate utility, these options are passed using the –oo Key=Value synta # APPENDIX F, Change Log -2024-06-21 Lucian Plesea +2024-06-21 * Add support for 64 bit integer data type, signed and unsigned, for NONE, DEFLATE, ZSTD, QB3 and TIF tile format * Add support for signed 8 bit integer - +2024-06-30 +* Add mrf-in-tar, acting as a single file MRF diff --git a/mrf_apps/vc/MUG/MUG.vcxproj b/mrf_apps/vc/MUG/MUG.vcxproj new file mode 100644 index 0000000..405b23b --- /dev/null +++ b/mrf_apps/vc/MUG/MUG.vcxproj @@ -0,0 +1,135 @@ + + + + + Debug + Win32 + + + Release + Win32 + + + Debug + x64 + + + Release + x64 + + + + 17.0 + Win32Proj + {c9069dd8-d633-4395-82d4-f459e1e20d8c} + MUG + 10.0 + + + + Application + true + v143 + Unicode + + + Application + false + v143 + true + Unicode + + + Application + true + v143 + Unicode + + + Application + false + v143 + true + Unicode + + + + + + + + + + + + + + + + + + + + + + Level3 + true + WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + + + Console + true + + + + + Level3 + true + true + true + WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + + + Console + true + true + true + + + + + Level3 + true + _DEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + + + Console + true + + + + + Level3 + true + true + true + NDEBUG;_CONSOLE;%(PreprocessorDefinitions) + true + + + Console + true + true + true + + + + + + + + + \ No newline at end of file diff --git a/mrf_apps/vc/MUG/MUG.vcxproj.filters b/mrf_apps/vc/MUG/MUG.vcxproj.filters new file mode 100644 index 0000000..89e2cfb --- /dev/null +++ b/mrf_apps/vc/MUG/MUG.vcxproj.filters @@ -0,0 +1,22 @@ + + + + + {4FC737F1-C7A5-4376-A066-2A32D752A2FF} + cpp;c;cc;cxx;c++;cppm;ixx;def;odl;idl;hpj;bat;asm;asmx + + + {93995380-89BD-4b04-88EB-625FBE52EBFB} + h;hh;hpp;hxx;h++;hm;inl;inc;ipp;xsd + + + {67DA6AB6-F800-4c08-8B7A-83BB121AAD01} + rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms + + + + + Resource Files + + + \ No newline at end of file diff --git a/mrf_apps/vc/vc.sln b/mrf_apps/vc/vc.sln index 2407251..740af0f 100644 --- a/mrf_apps/vc/vc.sln +++ b/mrf_apps/vc/vc.sln @@ -7,6 +7,8 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "packindex", "can\can.vcxpro EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "mrf_insert", "mrf_insert\mrf_insert.vcxproj", "{2A11EB20-EC76-4318-BF9D-BC4F7A75C38A}" EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "MUG", "MUG\MUG.vcxproj", "{C9069DD8-D633-4395-82D4-F459E1E20D8C}" +EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug|x64 = Debug|x64 @@ -31,6 +33,14 @@ Global {2A11EB20-EC76-4318-BF9D-BC4F7A75C38A}.Release|x64.Build.0 = Release|x64 {2A11EB20-EC76-4318-BF9D-BC4F7A75C38A}.Release|x86.ActiveCfg = Release|Win32 {2A11EB20-EC76-4318-BF9D-BC4F7A75C38A}.Release|x86.Build.0 = Release|Win32 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Debug|x64.ActiveCfg = Debug|x64 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Debug|x64.Build.0 = Debug|x64 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Debug|x86.ActiveCfg = Debug|Win32 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Debug|x86.Build.0 = Debug|Win32 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Release|x64.ActiveCfg = Release|x64 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Release|x64.Build.0 = Release|x64 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Release|x86.ActiveCfg = Release|Win32 + {C9069DD8-D633-4395-82D4-F459E1E20D8C}.Release|x86.Build.0 = Release|Win32 EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE