Line data Source code
1 : /*
2 : * Copyright (c) 2002-2012, California Institute of Technology.
3 : * All rights reserved. Based on Government Sponsored Research under contracts
4 : * NAS7-1407 and/or NAS7-03001.
5 : *
6 : * Redistribution and use in source and binary forms, with or without
7 : * modification, are permitted provided that the following conditions are met:
8 : * 1. Redistributions of source code must retain the above copyright notice,
9 : * this list of conditions and the following disclaimer.
10 : * 2. Redistributions in binary form must reproduce the above copyright
11 : * notice, this list of conditions and the following disclaimer in the
12 : * documentation and/or other materials provided with the distribution.
13 : * 3. Neither the name of the California Institute of Technology (Caltech),
14 : * its operating division the Jet Propulsion Laboratory (JPL), the National
15 : * Aeronautics and Space Administration (NASA), nor the names of its
16 : * contributors may be used to endorse or promote products derived from this
17 : * software without specific prior written permission.
18 : *
19 : * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20 : * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 : * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 : * ARE DISCLAIMED. IN NO EVENT SHALL THE CALIFORNIA INSTITUTE OF TECHNOLOGY BE
23 : * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 : * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 : * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 : * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 : * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 : * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 : * POSSIBILITY OF SUCH DAMAGE.
30 : *
31 : * Copyright 2014-2021 Esri
32 : *
33 : * Licensed under the Apache License, Version 2.0 (the "License");
34 : * you may not use this file except in compliance with the License.
35 : * You may obtain a copy of the License at
36 : *
37 : * http://www.apache.org/licenses/LICENSE-2.0
38 : *
39 : * Unless required by applicable law or agreed to in writing, software
40 : * distributed under the License is distributed on an "AS IS" BASIS,
41 : * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
42 : * See the License for the specific language governing permissions and
43 : * limitations under the License.
44 : *
45 : * Functions used by the driver, should have prototypes in the header file
46 : *
47 : * Author: Lucian Plesea
48 : */
49 :
50 : #include "mrfdrivercore.h"
51 : #include "cpl_string.h"
52 :
53 : #if defined(LERC)
54 3796 : static bool IsLerc1(const char *s)
55 : {
56 : static const char L1sig[] = "CntZImage ";
57 3796 : return !strncmp(s, L1sig, sizeof(L1sig) - 1);
58 : }
59 :
60 3786 : static bool IsLerc2(const char *s)
61 : {
62 : static const char L2sig[] = "Lerc2 ";
63 3786 : return !strncmp(s, L2sig, sizeof(L2sig) - 1);
64 : }
65 : #endif
66 :
67 : /************************************************************************/
68 : /* MRFDriverIdentify() */
69 : /************************************************************************/
70 :
71 : /**
72 : *\brief Idenfity a MRF file, lightweight
73 : *
74 : * Lightweight test, otherwise Open gets called.
75 : *
76 : */
77 52480 : int MRFDriverIdentify(GDALOpenInfo *poOpenInfo)
78 :
79 : {
80 52480 : if (STARTS_WITH(poOpenInfo->pszFilename, "<MRF_META>"))
81 0 : return TRUE;
82 :
83 104942 : CPLString fn(poOpenInfo->pszFilename);
84 52478 : if (fn.find(":MRF:") != std::string::npos)
85 10 : return TRUE;
86 :
87 52453 : if (poOpenInfo->nHeaderBytes < 10)
88 48227 : return FALSE;
89 :
90 4226 : const char *pszHeader = reinterpret_cast<char *>(poOpenInfo->pabyHeader);
91 4226 : fn.assign(pszHeader, pszHeader + poOpenInfo->nHeaderBytes);
92 4225 : if (STARTS_WITH(fn, "<MRF_META>"))
93 429 : return TRUE;
94 :
95 : #if defined(LERC) // Could be single LERC tile
96 3796 : if (IsLerc1(fn) || IsLerc2(fn))
97 12 : return TRUE;
98 : #endif
99 :
100 : // accept a tar file if the first file has no folder look like an MRF
101 3525 : if (poOpenInfo->eAccess == GA_ReadOnly && fn.size() > 600 &&
102 2421 : (fn[262] == 0 || fn[262] == 32) && STARTS_WITH(fn + 257, "ustar") &&
103 7309 : strlen(CPLGetPath(fn)) == 0 && STARTS_WITH(fn + 512, "<MRF_META>"))
104 : {
105 2 : return TRUE;
106 : }
107 :
108 3782 : return FALSE;
109 : }
110 :
111 : /************************************************************************/
112 : /* MRFDriverSetCommonMetadata() */
113 : /************************************************************************/
114 :
115 1293 : void MRFDriverSetCommonMetadata(GDALDriver *poDriver)
116 : {
117 1293 : poDriver->SetDescription(DRIVER_NAME);
118 1293 : poDriver->SetMetadataItem(GDAL_DMD_LONGNAME, "Meta Raster Format");
119 1293 : poDriver->SetMetadataItem(GDAL_DMD_HELPTOPIC, "drivers/raster/marfa.html");
120 1293 : poDriver->SetMetadataItem(GDAL_DMD_EXTENSION, "mrf");
121 1293 : poDriver->SetMetadataItem(GDAL_DCAP_VIRTUALIO, "YES");
122 1293 : poDriver->SetMetadataItem(GDAL_DCAP_RASTER, "YES");
123 :
124 1293 : poDriver->SetMetadataItem(
125 : GDAL_DMD_OPENOPTIONLIST,
126 : "<OpenOptionList>"
127 : " <Option name='NOERRORS' type='boolean' description='Ignore "
128 : "decompression errors' default='FALSE'/>"
129 : " <Option name='ZSLICE' type='int' description='For a third "
130 : "dimension MRF, pick a slice' default='0'/>"
131 1293 : "</OpenOptionList>");
132 :
133 : // These will need to be revisited, do we support complex data types too?
134 1293 : poDriver->SetMetadataItem(
135 : GDAL_DMD_CREATIONDATATYPES,
136 1293 : "Byte Int8 Int16 UInt16 Int32 UInt32 Int64 UInt64 Float32 Float64");
137 :
138 1293 : poDriver->pfnIdentify = MRFDriverIdentify;
139 1293 : poDriver->SetMetadataItem(GDAL_DCAP_OPEN, "YES");
140 1293 : poDriver->SetMetadataItem(GDAL_DCAP_CREATE, "YES");
141 1293 : poDriver->SetMetadataItem(GDAL_DCAP_CREATECOPY, "YES");
142 1293 : }
143 :
144 : /************************************************************************/
145 : /* DeclareDeferredMRFPlugin() */
146 : /************************************************************************/
147 :
148 : #ifdef PLUGIN_FILENAME
149 : void DeclareDeferredMRFPlugin()
150 : {
151 : if (GDALGetDriverByName(DRIVER_NAME) != nullptr)
152 : {
153 : return;
154 : }
155 : auto poDriver = new GDALPluginDriverProxy(PLUGIN_FILENAME);
156 : #ifdef PLUGIN_INSTALLATION_MESSAGE
157 : poDriver->SetMetadataItem(GDAL_DMD_PLUGIN_INSTALLATION_MESSAGE,
158 : PLUGIN_INSTALLATION_MESSAGE);
159 : #endif
160 : MRFDriverSetCommonMetadata(poDriver);
161 : GetGDALDriverManager()->DeclareDeferredPluginDriver(poDriver);
162 : }
163 : #endif
|
