// This software is released into the Public Domain.  See copying.txt for details.
package org.openstreetmap.osmosis.pbf2.v0_6.impl;

import java.util.Date;

import org.openstreetmap.osmosis.osmbinary.Osmformat.PrimitiveBlock;
import org.openstreetmap.osmosis.osmbinary.Osmformat.StringTable;



/**
 * Manages decoding of the lower level PBF data structures.
 * 
 * @author Brett Henderson
 * 
 */
public class PbfFieldDecoder {
	private static final double COORDINATE_SCALING_FACTOR = 0.000000001;

	private String[] strings;
	private int coordGranularity;
	private long coordLatitudeOffset;
	private long coordLongitudeOffset;
	private int dateGranularity;


	/**
	 * Creates a new instance.
	 * 
	 * @param primitiveBlock
	 *            The primitive block containing the fields to be decoded.
	 */
	public PbfFieldDecoder(PrimitiveBlock primitiveBlock) {
		this.coordGranularity = primitiveBlock.getGranularity();
		this.coordLatitudeOffset = primitiveBlock.getLatOffset();
		this.coordLongitudeOffset = primitiveBlock.getLonOffset();
		this.dateGranularity = primitiveBlock.getDateGranularity();

		StringTable stringTable = primitiveBlock.getStringtable();
		strings = new String[stringTable.getSCount()];
		for (int i = 0; i < strings.length; i++) {
			strings[i] = stringTable.getS(i).toStringUtf8();
		}
	}


	/**
	 * Decodes a raw latitude value into degrees.
	 * 
	 * @param rawLatitude
	 *            The PBF encoded value.
	 * @return The latitude in degrees.
	 */
	public double decodeLatitude(long rawLatitude) {
		return COORDINATE_SCALING_FACTOR * (coordLatitudeOffset + (coordGranularity * rawLatitude));
	}


	/**
	 * Decodes a raw longitude value into degrees.
	 * 
	 * @param rawLongitude
	 *            The PBF encoded value.
	 * @return The longitude in degrees.
	 */
	public double decodeLongitude(long rawLongitude) {
		return COORDINATE_SCALING_FACTOR * (coordLongitudeOffset + (coordGranularity * rawLongitude));
	}


	/**
	 * Decodes a raw timestamp value into a Date.
	 * 
	 * @param rawTimestamp
	 *            The PBF encoded timestamp.
	 * @return The timestamp as a Date.
	 */
	public Date decodeTimestamp(long rawTimestamp) {
		return new Date(dateGranularity * rawTimestamp);
	}


	/**
	 * Decodes a raw string into a String.
	 * 
	 * @param rawString
	 *            The PBF encoding string.
	 * @return The string as a String.
	 */
	public String decodeString(int rawString) {
		return strings[rawString];
	}
}