org.oscim.tiling.source.mapfile.header.MapFileHeader Maven / Gradle / Ivy

Go to download
/*
 * Copyright 2010, 2011, 2012 mapsforge.org
 *
 * This file is part of the OpenScienceMap project (http://www.opensciencemap.org).
 *
 * This program is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free Software
 * Foundation, either version 3 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
 * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License along with
 * this program. If not, see .
 */
package org.oscim.tiling.source.mapfile.header;

import org.oscim.tiling.TileSource.OpenResult;
import org.oscim.tiling.source.mapfile.ReadBuffer;

import java.io.IOException;

/**
 * Reads and validates the header data from a binary map file.
 */
public class MapFileHeader {
    /**
     * Maximum valid base zoom level of a sub-file.
     */
    private static final int BASE_ZOOM_LEVEL_MAX = 20;

    /**
     * Minimum size of the file header in bytes.
     */
    private static final int HEADER_SIZE_MIN = 70;

    /**
     * Length of the debug signature at the beginning of the index.
     */
    private static final byte SIGNATURE_LENGTH_INDEX = 16;

    /**
     * A single whitespace character.
     */
    private static final char SPACE = ' ';

    private MapFileInfo mapFileInfo;
    private SubFileParameter[] subFileParameters;
    private byte zoomLevelMaximum;
    private byte zoomLevelMinimum;

    /**
     * @return a MapFileInfo containing the header data.
     */
    public MapFileInfo getMapFileInfo() {
        return this.mapFileInfo;
    }

    /**
     * @param zoomLevel the originally requested zoom level.
     * @return the closest possible zoom level which is covered by a sub-file.
     */
    public byte getQueryZoomLevel(byte zoomLevel) {
        if (zoomLevel > this.zoomLevelMaximum) {
            return this.zoomLevelMaximum;
        } else if (zoomLevel < this.zoomLevelMinimum) {
            return this.zoomLevelMinimum;
        }
        return zoomLevel;
    }

    /**
     * @param queryZoomLevel the zoom level for which the sub-file parameters are needed.
     * @return the sub-file parameters for the given zoom level.
     */
    public SubFileParameter getSubFileParameter(int queryZoomLevel) {
        return this.subFileParameters[queryZoomLevel];
    }

    /**
     * Reads and validates the header block from the map file.
     *
     * @param readBuffer the ReadBuffer for the file data.
     * @param fileSize   the size of the map file in bytes.
     * @return a FileOpenResult containing an error message in case of a
     * failure.
     * @throws IOException if an error occurs while reading the file.
     */
    public OpenResult readHeader(ReadBuffer readBuffer, long fileSize) throws IOException {
        OpenResult openResult = RequiredFields.readMagicByte(readBuffer);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readRemainingHeader(readBuffer);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        MapFileInfoBuilder mapFileInfoBuilder = new MapFileInfoBuilder();

        openResult = RequiredFields.readFileVersion(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readFileSize(readBuffer, fileSize, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readMapDate(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readBoundingBox(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readTilePixelSize(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readProjectionName(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = OptionalFields.readOptionalFields(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readPoiTags(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = RequiredFields.readWayTags(readBuffer, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        openResult = readSubFileParameters(readBuffer, fileSize, mapFileInfoBuilder);
        if (!openResult.isSuccess()) {
            return openResult;
        }

        this.mapFileInfo = mapFileInfoBuilder.build();

        return OpenResult.SUCCESS;
    }

    private OpenResult readSubFileParameters(ReadBuffer readBuffer, long fileSize,
                                             MapFileInfoBuilder mapFileInfoBuilder) {
        // get and check the number of sub-files (1 byte)
        byte numberOfSubFiles = readBuffer.readByte();
        if (numberOfSubFiles < 1) {
            return new OpenResult("invalid number of sub-files: " + numberOfSubFiles);
        }
        mapFileInfoBuilder.numberOfSubFiles = numberOfSubFiles;

        SubFileParameter[] tempSubFileParameters = new SubFileParameter[numberOfSubFiles];
        this.zoomLevelMinimum = Byte.MAX_VALUE;
        this.zoomLevelMaximum = Byte.MIN_VALUE;

        // get and check the information for each sub-file
        for (byte currentSubFile = 0; currentSubFile < numberOfSubFiles; ++currentSubFile) {
            SubFileParameterBuilder subFileParameterBuilder = new SubFileParameterBuilder();

            // get and check the base zoom level (1 byte)
            byte baseZoomLevel = readBuffer.readByte();
            if (baseZoomLevel < 0 || baseZoomLevel > BASE_ZOOM_LEVEL_MAX) {
                return new OpenResult("invalid base zooom level: " + baseZoomLevel);
            }
            subFileParameterBuilder.baseZoomLevel = baseZoomLevel;

            // get and check the minimum zoom level (1 byte)
            byte zoomLevelMin = readBuffer.readByte();
            if (zoomLevelMin < 0 || zoomLevelMin > 22) {
                return new OpenResult("invalid minimum zoom level: " + zoomLevelMin);
            }
            subFileParameterBuilder.zoomLevelMin = zoomLevelMin;

            // get and check the maximum zoom level (1 byte)
            byte zoomLevelMax = readBuffer.readByte();
            if (zoomLevelMax < 0 || zoomLevelMax > 22) {
                return new OpenResult("invalid maximum zoom level: " + zoomLevelMax);
            }
            subFileParameterBuilder.zoomLevelMax = zoomLevelMax;

            // check for valid zoom level range
            if (zoomLevelMin > zoomLevelMax) {
                return new OpenResult("invalid zoom level range: " + zoomLevelMin + SPACE
                        + zoomLevelMax);
            }

            // get and check the start address of the sub-file (8 bytes)
            long startAddress = readBuffer.readLong();
            if (startAddress < HEADER_SIZE_MIN || startAddress >= fileSize) {
                return new OpenResult("invalid start address: " + startAddress);
            }
            subFileParameterBuilder.startAddress = startAddress;

            long indexStartAddress = startAddress;
            if (mapFileInfoBuilder.optionalFields.isDebugFile) {
                // the sub-file has an index signature before the index
                indexStartAddress += SIGNATURE_LENGTH_INDEX;
            }
            subFileParameterBuilder.indexStartAddress = indexStartAddress;

            // get and check the size of the sub-file (8 bytes)
            long subFileSize = readBuffer.readLong();
            if (subFileSize < 1) {
                return new OpenResult("invalid sub-file size: " + subFileSize);
            }
            subFileParameterBuilder.subFileSize = subFileSize;

            subFileParameterBuilder.boundingBox = mapFileInfoBuilder.boundingBox;

            // add the current sub-file to the list of sub-files
            tempSubFileParameters[currentSubFile] = subFileParameterBuilder.build();

            updateZoomLevelInformation(tempSubFileParameters[currentSubFile]);
        }

        mapFileInfoBuilder.zoomLevel = new int[numberOfSubFiles];

        // create and fill the lookup table for the sub-files
        this.subFileParameters = new SubFileParameter[this.zoomLevelMaximum + 1];
        for (int currentMapFile = 0; currentMapFile < numberOfSubFiles; ++currentMapFile) {
            SubFileParameter subFileParameter = tempSubFileParameters[currentMapFile];

            mapFileInfoBuilder.zoomLevel[currentMapFile] = subFileParameter.baseZoomLevel;

            for (byte zoomLevel = subFileParameter.zoomLevelMin; zoomLevel <= subFileParameter.zoomLevelMax; ++zoomLevel) {
                this.subFileParameters[zoomLevel] = subFileParameter;
            }
        }
        return OpenResult.SUCCESS;
    }

    private void updateZoomLevelInformation(SubFileParameter subFileParameter) {
        // update the global minimum and maximum zoom level information
        if (this.zoomLevelMinimum > subFileParameter.zoomLevelMin) {
            this.zoomLevelMinimum = subFileParameter.zoomLevelMin;
        }
        if (this.zoomLevelMaximum < subFileParameter.zoomLevelMax) {
            this.zoomLevelMaximum = subFileParameter.zoomLevelMax;
        }
    }
}