/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.tom_roush.fontbox.ttf;
import java.io.Closeable;
import java.io.EOFException;
import java.io.IOException;
import java.io.InputStream;
import java.util.Calendar;
import java.util.GregorianCalendar;
import java.util.TimeZone;
/**
* An interface into a data stream.
*
* @author Ben Litchfield
*/
abstract class TTFDataStream implements Closeable
{
TTFDataStream()
{
}
/**
* Read a 16.16 fixed value, where the first 16 bits are the decimal and the last 16 bits are the fraction.
*
* @return A 32 bit value.
* @throws IOException If there is an error reading the data.
*/
public float read32Fixed() throws IOException
{
float retval = 0;
retval = readSignedShort();
retval += (readUnsignedShort() / 65536.0);
return retval;
}
/**
* Read a fixed length ascii string.
*
* @param length The length of the string to read.
* @return A string of the desired length.
* @throws IOException If there is an error reading the data.
*/
public String readString(int length) throws IOException
{
return readString(length, "ISO-8859-1");
}
/**
* Read a fixed length ascii string.
*
* @param length The length of the string to read in bytes.
* @param charset The expected character set of the string.
* @return A string of the desired length.
* @throws IOException If there is an error reading the data.
*/
public String readString(int length, String charset) throws IOException
{
byte[] buffer = read(length);
return new String(buffer, charset);
}
/**
* Read an unsigned byte.
*
* @return An unsigned byte.
* @throws IOException If there is an error reading the data.
*/
public abstract int read() throws IOException;
/**
* Read an unsigned byte.
*
* @return An unsigned byte.
* @throws IOException If there is an error reading the data.
*/
public abstract long readLong() throws IOException;
/**
* Read a signed byte.
*
* @return A signed byte.
* @throws IOException If there is an error reading the data.
*/
public int readSignedByte() throws IOException
{
int signedByte = read();
return signedByte < 127 ? signedByte : signedByte - 256;
}
/**
* Read a unsigned byte. Similar to {@link #read()}, but throws an exception if EOF is unexpectedly reached.
*
* @return A unsigned byte.
* @throws IOException If there is an error reading the data.
*/
public int readUnsignedByte() throws IOException
{
int unsignedByte = read();
if (unsignedByte == -1)
{
throw new EOFException("premature EOF");
}
return unsignedByte;
}
/**
* Read an unsigned integer.
*
* @return An unsiged integer.
* @throws IOException If there is an error reading the data.
*/
public long readUnsignedInt() throws IOException
{
long byte1 = read();
long byte2 = read();
long byte3 = read();
long byte4 = read();
if (byte4 < 0)
{
throw new EOFException();
}
return (byte1 << 24) + (byte2 << 16) + (byte3 << 8) + (byte4 << 0);
}
/**
* Read an unsigned short.
*
* @return An unsigned short.
* @throws IOException If there is an error reading the data.
*/
public abstract int readUnsignedShort() throws IOException;
/**
* Read an unsigned byte array.
*
* @param length the length of the array to be read
* @return An unsigned byte array.
* @throws IOException If there is an error reading the data.
*/
public int[] readUnsignedByteArray(int length) throws IOException
{
int[] array = new int[length];
for (int i = 0; i < length; i++)
{
array[i] = read();
}
return array;
}
/**
* Read an unsigned short array.
*
* @param length The length of the array to read.
* @return An unsigned short array.
* @throws IOException If there is an error reading the data.
*/
public int[] readUnsignedShortArray(int length) throws IOException
{
int[] array = new int[length];
for (int i = 0; i < length; i++)
{
array[i] = readUnsignedShort();
}
return array;
}
/**
* Read an signed short.
*
* @return An signed short.
* @throws IOException If there is an error reading the data.
*/
public abstract short readSignedShort() throws IOException;
/**
* Read an eight byte international date.
*
* @return An signed short.
* @throws IOException If there is an error reading the data.
*/
public Calendar readInternationalDate() throws IOException
{
long secondsSince1904 = readLong();
Calendar cal = GregorianCalendar.getInstance(TimeZone.getTimeZone("UTC"));
cal.set(1904, 0, 1, 0, 0, 0);
cal.set(Calendar.MILLISECOND, 0);
long millisFor1904 = cal.getTimeInMillis();
millisFor1904 += (secondsSince1904 * 1000);
cal.setTimeInMillis(millisFor1904);
return cal;
}
/**
* Reads a tag, an arrau of four uint8s used to identify a script, language system, feature,
* or baseline.
*/
public String readTag() throws IOException
{
return new String(read(4), "US-ASCII");
}
/**
* Close the underlying resources.
*
* @throws IOException If there is an error closing the resources.
*/
@Override
public abstract void close() throws IOException;
/**
* Seek into the datasource.
*
* @param pos The position to seek to.
* @throws IOException If there is an error seeking to that position.
*/
public abstract void seek(long pos) throws IOException;
/**
* Read a specific number of bytes from the stream.
*
* @param numberOfBytes The number of bytes to read.
* @return The byte buffer.
* @throws IOException If there is an error while reading.
*/
public byte[] read(int numberOfBytes) throws IOException
{
byte[] data = new byte[numberOfBytes];
int amountRead = 0;
int totalAmountRead = 0;
// read at most numberOfBytes bytes from the stream.
while (totalAmountRead < numberOfBytes
&& (amountRead = read(data, totalAmountRead, numberOfBytes - totalAmountRead)) != -1)
{
totalAmountRead += amountRead;
}
if (totalAmountRead == numberOfBytes)
{
return data;
}
else
{
throw new IOException("Unexpected end of TTF stream reached");
}
}
/**
* @see java.io.InputStream#read(byte[], int, int )
*
* @param b The buffer to write to.
* @param off The offset into the buffer.
* @param len The length into the buffer.
*
* @return The number of bytes read, or -1 at the end of the stream
*
* @throws IOException If there is an error reading from the stream.
*/
public abstract int read(byte[] b, int off, int len) throws IOException;
/**
* Get the current position in the stream.
*
* @return The current position in the stream.
* @throws IOException If an error occurs while reading the stream.
*/
public abstract long getCurrentPosition() throws IOException;
/**
* This will get the original data file that was used for this stream.
*
* @return The data that was read from.
* @throws IOException If there is an issue reading the data.
*/
public abstract InputStream getOriginalData() throws IOException;
}