/*
* Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code 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 General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.awt.font;
/**
* The <code>OpenType</code> interface represents OpenType and
* TrueType fonts. This interface makes it possible to obtain
* <i>sfnt</i> tables from the font. A particular
* <code>Font</code> object can implement this interface.
* <p>
* For more information on TrueType fonts, see the
* Apple TrueType Reference Manual
* ( <a href="http://fonts.apple.com/TTRefMan/index.html">http://fonts.apple.com/TTRefMan/index.html</a> ).
*/
public interface OpenType {
/* 51 tag types so far */
/**
* Character to glyph mapping. Table tag "cmap" in the Open
* Type Specification.
*/
public final static int TAG_CMAP = 0x636d6170;
/**
* Font header. Table tag "head" in the Open
* Type Specification.
*/
public final static int TAG_HEAD = 0x68656164;
/**
* Naming table. Table tag "name" in the Open
* Type Specification.
*/
public final static int TAG_NAME = 0x6e616d65;
/**
* Glyph data. Table tag "glyf" in the Open
* Type Specification.
*/
public final static int TAG_GLYF = 0x676c7966;
/**
* Maximum profile. Table tag "maxp" in the Open
* Type Specification.
*/
public final static int TAG_MAXP = 0x6d617870;
/**
* CVT preprogram. Table tag "prep" in the Open
* Type Specification.
*/
public final static int TAG_PREP = 0x70726570;
/**
* Horizontal metrics. Table tag "hmtx" in the Open
* Type Specification.
*/
public final static int TAG_HMTX = 0x686d7478;
/**
* Kerning. Table tag "kern" in the Open
* Type Specification.
*/
public final static int TAG_KERN = 0x6b65726e;
/**
* Horizontal device metrics. Table tag "hdmx" in the Open
* Type Specification.
*/
public final static int TAG_HDMX = 0x68646d78;
/**
* Index to location. Table tag "loca" in the Open
* Type Specification.
*/
public final static int TAG_LOCA = 0x6c6f6361;
/**
* PostScript Information. Table tag "post" in the Open
* Type Specification.
*/
public final static int TAG_POST = 0x706f7374;
/**
* OS/2 and Windows specific metrics. Table tag "OS/2"
* in the Open Type Specification.
*/
public final static int TAG_OS2 = 0x4f532f32;
/**
* Control value table. Table tag "cvt "
* in the Open Type Specification.
*/
public final static int TAG_CVT = 0x63767420;
/**
* Grid-fitting and scan conversion procedure. Table tag
* "gasp" in the Open Type Specification.
*/
public final static int TAG_GASP = 0x67617370;
/**
* Vertical device metrics. Table tag "VDMX" in the Open
* Type Specification.
*/
public final static int TAG_VDMX = 0x56444d58;
/**
* Vertical metrics. Table tag "vmtx" in the Open
* Type Specification.
*/
public final static int TAG_VMTX = 0x766d7478;
/**
* Vertical metrics header. Table tag "vhea" in the Open
* Type Specification.
*/
public final static int TAG_VHEA = 0x76686561;
/**
* Horizontal metrics header. Table tag "hhea" in the Open
* Type Specification.
*/
public final static int TAG_HHEA = 0x68686561;
/**
* Adobe Type 1 font data. Table tag "typ1" in the Open
* Type Specification.
*/
public final static int TAG_TYP1 = 0x74797031;
/**
* Baseline table. Table tag "bsln" in the Open
* Type Specification.
*/
public final static int TAG_BSLN = 0x62736c6e;
/**
* Glyph substitution. Table tag "GSUB" in the Open
* Type Specification.
*/
public final static int TAG_GSUB = 0x47535542;
/**
* Digital signature. Table tag "DSIG" in the Open
* Type Specification.
*/
public final static int TAG_DSIG = 0x44534947;
/**
* Font program. Table tag "fpgm" in the Open
* Type Specification.
*/
public final static int TAG_FPGM = 0x6670676d;
/**
* Font variation. Table tag "fvar" in the Open
* Type Specification.
*/
public final static int TAG_FVAR = 0x66766172;
/**
* Glyph variation. Table tag "gvar" in the Open
* Type Specification.
*/
public final static int TAG_GVAR = 0x67766172;
/**
* Compact font format (Type1 font). Table tag
* "CFF " in the Open Type Specification.
*/
public final static int TAG_CFF = 0x43464620;
/**
* Multiple master supplementary data. Table tag
* "MMSD" in the Open Type Specification.
*/
public final static int TAG_MMSD = 0x4d4d5344;
/**
* Multiple master font metrics. Table tag
* "MMFX" in the Open Type Specification.
*/
public final static int TAG_MMFX = 0x4d4d4658;
/**
* Baseline data. Table tag "BASE" in the Open
* Type Specification.
*/
public final static int TAG_BASE = 0x42415345;
/**
* Glyph definition. Table tag "GDEF" in the Open
* Type Specification.
*/
public final static int TAG_GDEF = 0x47444546;
/**
* Glyph positioning. Table tag "GPOS" in the Open
* Type Specification.
*/
public final static int TAG_GPOS = 0x47504f53;
/**
* Justification. Table tag "JSTF" in the Open
* Type Specification.
*/
public final static int TAG_JSTF = 0x4a535446;
/**
* Embedded bitmap data. Table tag "EBDT" in the Open
* Type Specification.
*/
public final static int TAG_EBDT = 0x45424454;
/**
* Embedded bitmap location. Table tag "EBLC" in the Open
* Type Specification.
*/
public final static int TAG_EBLC = 0x45424c43;
/**
* Embedded bitmap scaling. Table tag "EBSC" in the Open
* Type Specification.
*/
public final static int TAG_EBSC = 0x45425343;
/**
* Linear threshold. Table tag "LTSH" in the Open
* Type Specification.
*/
public final static int TAG_LTSH = 0x4c545348;
/**
* PCL 5 data. Table tag "PCLT" in the Open
* Type Specification.
*/
public final static int TAG_PCLT = 0x50434c54;
/**
* Accent attachment. Table tag "acnt" in the Open
* Type Specification.
*/
public final static int TAG_ACNT = 0x61636e74;
/**
* Axis variaiton. Table tag "avar" in the Open
* Type Specification.
*/
public final static int TAG_AVAR = 0x61766172;
/**
* Bitmap data. Table tag "bdat" in the Open
* Type Specification.
*/
public final static int TAG_BDAT = 0x62646174;
/**
* Bitmap location. Table tag "bloc" in the Open
* Type Specification.
*/
public final static int TAG_BLOC = 0x626c6f63;
/**
* CVT variation. Table tag "cvar" in the Open
* Type Specification.
*/
public final static int TAG_CVAR = 0x63766172;
/**
* Feature name. Table tag "feat" in the Open
* Type Specification.
*/
public final static int TAG_FEAT = 0x66656174;
/**
* Font descriptors. Table tag "fdsc" in the Open
* Type Specification.
*/
public final static int TAG_FDSC = 0x66647363;
/**
* Font metrics. Table tag "fmtx" in the Open
* Type Specification.
*/
public final static int TAG_FMTX = 0x666d7478;
/**
* Justification. Table tag "just" in the Open
* Type Specification.
*/
public final static int TAG_JUST = 0x6a757374;
/**
* Ligature caret. Table tag "lcar" in the Open
* Type Specification.
*/
public final static int TAG_LCAR = 0x6c636172;
/**
* Glyph metamorphosis. Table tag "mort" in the Open
* Type Specification.
*/
public final static int TAG_MORT = 0x6d6f7274;
/**
* Optical bounds. Table tag "opbd" in the Open
* Type Specification.
*/
public final static int TAG_OPBD = 0x6d6f7274;
/**
* Glyph properties. Table tag "prop" in the Open
* Type Specification.
*/
public final static int TAG_PROP = 0x70726f70;
/**
* Tracking. Table tag "trak" in the Open
* Type Specification.
*/
public final static int TAG_TRAK = 0x7472616b;
/**
* Returns the version of the <code>OpenType</code> font.
* 1.0 is represented as 0x00010000.
* @return the version of the <code>OpenType</code> font.
*/
public int getVersion();
/**
* Returns the table as an array of bytes for a specified tag.
* Tags for sfnt tables include items like <i>cmap</i>,
* <i>name</i> and <i>head</i>. The <code>byte</code> array
* returned is a copy of the font data in memory.
* @param sfntTag a four-character code as a 32-bit integer
* @return a <code>byte</code> array that is the table that
* contains the font data corresponding to the specified
* tag.
*/
public byte[] getFontTable(int sfntTag);
/**
* Returns the table as an array of bytes for a specified tag.
* Tags for sfnt tables include items like <i>cmap</i>,
* <i>name</i> and <i>head</i>. The byte array returned is a
* copy of the font data in memory.
* @param strSfntTag a four-character code as a
* <code>String</code>
* @return a <code>byte</code> array that is the table that
* contains the font data corresponding to the specified
* tag.
*/
public byte[] getFontTable(String strSfntTag);
/**
* Returns a subset of the table as an array of bytes
* for a specified tag. Tags for sfnt tables include
* items like <i>cmap</i>, <i>name</i> and <i>head</i>.
* The byte array returned is a copy of the font data in
* memory.
* @param sfntTag a four-character code as a 32-bit integer
* @param offset index of first byte to return from table
* @param count number of bytes to return from table
* @return a subset of the table corresponding to
* <code>sfntTag</code> and containing the bytes
* starting at <code>offset</code> byte and including
* <code>count</code> bytes.
*/
public byte[] getFontTable(int sfntTag, int offset, int count);
/**
* Returns a subset of the table as an array of bytes
* for a specified tag. Tags for sfnt tables include items
* like <i>cmap</i>, <i>name</i> and <i>head</i>. The
* <code>byte</code> array returned is a copy of the font
* data in memory.
* @param strSfntTag a four-character code as a
* <code>String</code>
* @param offset index of first byte to return from table
* @param count number of bytes to return from table
* @return a subset of the table corresponding to
* <code>strSfntTag</code> and containing the bytes
* starting at <code>offset</code> byte and including
* <code>count</code> bytes.
*/
public byte[] getFontTable(String strSfntTag, int offset, int count);
/**
* Returns the size of the table for a specified tag. Tags for sfnt
* tables include items like <i>cmap</i>, <i>name</i> and <i>head</i>.
* @param sfntTag a four-character code as a 32-bit integer
* @return the size of the table corresponding to the specified
* tag.
*/
public int getFontTableSize(int sfntTag);
/**
* Returns the size of the table for a specified tag. Tags for sfnt
* tables include items like <i>cmap</i>, <i>name</i> and <i>head</i>.
* @param strSfntTag a four-character code as a
* <code>String</code>
* @return the size of the table corresponding to the specified tag.
*/
public int getFontTableSize(String strSfntTag);
}