1. /*

  2.  * @(#)OpenType.java	1.20 00/02/02

  3.  *

  4.  * Copyright 1997-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package java.awt.font;

  12. 

  13. /**

  14.  * The <code>OpenType</code> interface represents OpenType and 

  15.  * TrueType fonts.  This interface makes it possible to obtain 

  16.  * <i>sfnt</i> tables from the font.  A particular 

  17.  * <code>Font</code> object can implement this interface.

  18.  * <p>

  19.  * For more information on TrueType fonts, see the 

  20.  * Apple TrueType Reference Manual 

  21.  * ( <a href="http://fonts.apple.com/TTRefMan/index.html">http://fonts.apple.com/TTRefMan/index.html</a> ).

  22.  * @version 10 Feb 1997

  23.  */

  24. public interface OpenType {

  25.   

  26.   /* 51 tag types so far */

  27. 

  28.   /**

  29.    * Character to glyph mapping.  Table tag "cmap" in the Open

  30.    * Type Specification.

  31.    */  

  32.   public final static int       TAG_CMAP        = 0x636d6170;

  33. 

  34.   /**

  35.    * Font header.  Table tag "head" in the Open

  36.    * Type Specification.

  37.    */  

  38.   public final static int       TAG_HEAD        = 0x68656164;

  39. 

  40.   /**

  41.    * Naming table.  Table tag "name" in the Open

  42.    * Type Specification.

  43.    */  

  44.   public final static int       TAG_NAME        = 0x6e616d65;

  45. 

  46.   /**

  47.    * Glyph data.  Table tag "glyf" in the Open

  48.    * Type Specification.

  49.    */  

  50.   public final static int       TAG_GLYF        = 0x676c7966;

  51. 

  52.   /**

  53.    * Maximum profile.  Table tag "maxp" in the Open

  54.    * Type Specification.

  55.    */  

  56.   public final static int       TAG_MAXP        = 0x6d617870;

  57. 

  58.   /**

  59.    * CVT preprogram.  Table tag "prep" in the Open

  60.    * Type Specification.

  61.    */  

  62.   public final static int       TAG_PREP        = 0x70726570;

  63. 

  64.   /**

  65.    * Horizontal metrics.  Table tag "hmtx" in the Open

  66.    * Type Specification.

  67.    */  

  68.   public final static int       TAG_HMTX        = 0x686d7478;

  69. 

  70.   /**

  71.    * Kerning.  Table tag "kern" in the Open

  72.    * Type Specification.

  73.    */  

  74.   public final static int       TAG_KERN        = 0x6b65726e;

  75. 

  76.   /**

  77.    * Horizontal device metrics.  Table tag "hdmx" in the Open

  78.    * Type Specification.

  79.    */  

  80.   public final static int       TAG_HDMX        = 0x68646d78;

  81. 

  82.   /**

  83.    * Index to location.  Table tag "loca" in the Open

  84.    * Type Specification.

  85.    */  

  86.   public final static int       TAG_LOCA        = 0x6c6f6361;

  87. 

  88.   /**

  89.    * PostScript Information.  Table tag "post" in the Open

  90.    * Type Specification.

  91.    */ 

  92.   public final static int       TAG_POST        = 0x706f7374;

  93. 

  94.   /**

  95.    * OS/2 and Windows specific metrics.  Table tag "OS/2"

  96.    * in the Open Type Specification.

  97.    */  

  98.   public final static int       TAG_OS2 = 0x4f532f32;

  99. 

  100.   /**

  101.    * Control value table.  Table tag "cvt "

  102.    * in the Open Type Specification.

  103.    */  

  104.   public final static int       TAG_CVT = 0x63767420;

  105. 

  106.   /**

  107.    * Grid-fitting and scan conversion procedure.  Table tag 

  108.    * "gasp" in the Open Type Specification.

  109.    */  

  110.   public final static int       TAG_GASP        = 0x67617370;

  111. 

  112.   /**

  113.    * Vertical device metrics.  Table tag "VDMX" in the Open 

  114.    * Type Specification.

  115.    */  

  116.   public final static int       TAG_VDMX        = 0x56444d58;

  117. 

  118.   /**

  119.    * Vertical metrics.  Table tag "vmtx" in the Open

  120.    * Type Specification.

  121.    */  

  122.   public final static int       TAG_VMTX        = 0x766d7478;

  123. 

  124.   /**

  125.    * Vertical metrics header.  Table tag "vhea" in the Open

  126.    * Type Specification.

  127.    */  

  128.   public final static int       TAG_VHEA        = 0x76686561;

  129. 

  130.   /**

  131.    * Horizontal metrics header.  Table tag "hhea" in the Open

  132.    * Type Specification.

  133.    */  

  134.   public final static int       TAG_HHEA        = 0x68686561;

  135. 

  136.   /**

  137.    * Adobe Type 1 font data.  Table tag "typ1" in the Open

  138.    * Type Specification.

  139.    */  

  140.   public final static int       TAG_TYP1        = 0x74797031;

  141. 

  142.   /**

  143.    * Baseline table.  Table tag "bsln" in the Open

  144.    * Type Specification.

  145.    */  

  146.   public final static int       TAG_BSLN        = 0x62736c6e;

  147. 

  148.   /**

  149.    * Glyph substitution.  Table tag "GSUB" in the Open

  150.    * Type Specification.

  151.    */  

  152.   public final static int       TAG_GSUB        = 0x47535542;

  153. 

  154.   /**

  155.    * Digital signature.  Table tag "DSIG" in the Open

  156.    * Type Specification.

  157.    */  

  158.   public final static int       TAG_DSIG        = 0x44534947;

  159. 

  160.   /**

  161.    * Font program.   Table tag "fpgm" in the Open

  162.    * Type Specification.

  163.    */  

  164.   public final static int       TAG_FPGM        = 0x6670676d;

  165. 

  166.   /**

  167.    * Font variation.   Table tag "fvar" in the Open

  168.    * Type Specification.

  169.    */  

  170.   public final static int       TAG_FVAR        = 0x66766172;

  171. 

  172.   /**

  173.    * Glyph variation.  Table tag "gvar" in the Open

  174.    * Type Specification.

  175.    */  

  176.   public final static int       TAG_GVAR        = 0x67766172;

  177. 

  178.   /**

  179.    * Compact font format (Type1 font).  Table tag 

  180.    * "CFF " in the Open Type Specification.

  181.    */  

  182.   public final static int       TAG_CFF = 0x43464620;

  183. 

  184.   /**

  185.    * Multiple master supplementary data.  Table tag 

  186.    * "MMSD" in the Open Type Specification.

  187.    */  

  188.   public final static int       TAG_MMSD        = 0x4d4d5344;

  189. 

  190.   /**

  191.    * Multiple master font metrics.  Table tag

  192.    * "MMFX" in the Open Type Specification.

  193.    */  

  194.   public final static int       TAG_MMFX        = 0x4d4d4658;

  195. 

  196.   /**

  197.    * Baseline data.  Table tag "BASE" in the Open 

  198.    * Type Specification.

  199.    */  

  200.   public final static int       TAG_BASE        = 0x42415345;

  201. 

  202.   /**

  203.    * Glyph definition.  Table tag "GDEF" in the Open

  204.    * Type Specification.

  205.    */  

  206.   public final static int       TAG_GDEF        = 0x47444546;

  207. 

  208.   /**

  209.    * Glyph positioning.  Table tag "GPOS" in the Open

  210.    * Type Specification.

  211.    */  

  212.   public final static int       TAG_GPOS        = 0x47504f53;

  213. 

  214.   /**

  215.    * Justification.  Table tag "JSTF" in the Open

  216.    * Type Specification.

  217.    */  

  218.   public final static int       TAG_JSTF        = 0x4a535446;

  219. 

  220.   /**

  221.    * Embedded bitmap data.  Table tag "EBDT" in the Open

  222.    * Type Specification.

  223.    */  

  224.   public final static int       TAG_EBDT        = 0x45424454;

  225. 

  226.   /**

  227.    * Embedded bitmap location.  Table tag "EBLC" in the Open

  228.    * Type Specification.

  229.    */  

  230.   public final static int       TAG_EBLC        = 0x45424c43;

  231. 

  232.   /**

  233.    * Embedded bitmap scaling.  Table tag "EBSC" in the Open

  234.    * Type Specification.

  235.    */  

  236.   public final static int       TAG_EBSC        = 0x45425343;

  237. 

  238.   /**

  239.    * Linear threshold.  Table tag "LTSH" in the Open

  240.    * Type Specification.

  241.    */  

  242.   public final static int       TAG_LTSH        = 0x4c545348;

  243. 

  244.   /**

  245.    * PCL 5 data.  Table tag "PCLT" in the Open

  246.    * Type Specification.

  247.    */  

  248.   public final static int       TAG_PCLT        = 0x50434c54;

  249. 

  250.   /**

  251.    * Accent attachment.  Table tag "acnt" in the Open

  252.    * Type Specification.

  253.    */  

  254.   public final static int       TAG_ACNT        = 0x61636e74;

  255. 

  256.   /**

  257.    * Axis variaiton.  Table tag "avar" in the Open

  258.    * Type Specification.

  259.    */  

  260.   public final static int       TAG_AVAR        = 0x61766172;

  261. 

  262.   /**

  263.    * Bitmap data.  Table tag "bdat" in the Open

  264.    * Type Specification.

  265.    */  

  266.   public final static int       TAG_BDAT        = 0x62646174;

  267. 

  268.   /**

  269.    * Bitmap location.  Table tag "bloc" in the Open

  270.    * Type Specification.

  271.    */  

  272.   public final static int       TAG_BLOC        = 0x626c6f63;

  273. 

  274.    /**

  275.     * CVT variation.  Table tag "cvar" in the Open

  276.     * Type Specification.

  277.     */  

  278.   public final static int       TAG_CVAR        = 0x63766172;

  279. 

  280.   /**

  281.    * Feature name.  Table tag "feat" in the Open

  282.     * Type Specification.

  283.    */  

  284.   public final static int       TAG_FEAT        = 0x66656174;

  285. 

  286.   /**

  287.    * Font descriptors.  Table tag "fdsc" in the Open

  288.    * Type Specification.

  289.    */  

  290.   public final static int       TAG_FDSC        = 0x66647363;

  291.  

  292.   /**

  293.    * Font metrics.  Table tag "fmtx" in the Open

  294.    * Type Specification.

  295.    */  

  296.   public final static int       TAG_FMTX        = 0x666d7478;

  297. 

  298.   /**

  299.    * Justification.  Table tag "just" in the Open

  300.    * Type Specification.

  301.    */  

  302.   public final static int       TAG_JUST        = 0x6a757374;

  303. 

  304.   /**

  305.    * Ligature caret.   Table tag "lcar" in the Open

  306.    * Type Specification.

  307.    */  

  308.   public final static int       TAG_LCAR        = 0x6c636172;

  309. 

  310.   /**

  311.    * Glyph metamorphosis.  Table tag "mort" in the Open

  312.    * Type Specification.

  313.    */  

  314.   public final static int       TAG_MORT        = 0x6d6f7274;

  315. 

  316.   /**

  317.    * Optical bounds.  Table tag "opbd" in the Open

  318.    * Type Specification.

  319.    */  

  320.   public final static int       TAG_OPBD        = 0x6d6f7274;

  321. 

  322.   /**

  323.    * Glyph properties.  Table tag "prop" in the Open

  324.    * Type Specification.

  325.    */  

  326.   public final static int       TAG_PROP        = 0x70726f70;

  327. 

  328.   /**

  329.    * Tracking.  Table tag "trak" in the Open

  330.    * Type Specification.

  331.    */  

  332.   public final static int       TAG_TRAK        = 0x7472616b;

  333. 

  334.   /**

  335.    * Returns the version of the <code>OpenType</code> font.

  336.    * 1.0 is represented as 0x00010000.

  337.    * @return the version of the <code>OpenType</code> font.

  338.    */

  339.   public int getVersion();

  340. 

  341.   /**

  342.    * Returns the table as an array of bytes for a specified tag. 

  343.    * Tags for sfnt tables include items like <i>cmap</i>, 

  344.    * <i>name</i> and <i>head</i>.  The <code>byte</code> array 

  345.    * returned is a copy of the font data in memory.

  346.    * @param     sfntTag a four-character code as a 32-bit integer

  347.    * @return a <code>byte</code> array that is the table that 

  348.    * contains the font data corresponding to the specified

  349.    * tag.

  350.    */

  351.   public byte[] getFontTable(int sfntTag);

  352. 

  353.   /**

  354.    * Returns the table as an array of bytes for a specified tag. 

  355.    * Tags for sfnt tables include items like <i>cmap</i>, 

  356.    * <i>name</i> and <i>head</i>.  The byte array returned is a 

  357.    * copy of the font data in memory.

  358.    * @param     sfntTag a four-character code as a 

  359.    *		<code>String</code>

  360.    * @return a <code>byte</code> array that is the table that

  361.    * contains the font data corresponding to the specified

  362.    * tag.   

  363.    */

  364.   public byte[] getFontTable(String strSfntTag);

  365. 

  366.   /**

  367.    * Returns a subset of the table as an array of bytes 

  368.    * for a specified tag.  Tags for sfnt tables include 

  369.    * items like <i>cmap</i>, <i>name</i> and <i>head</i>. 

  370.    * The byte array returned is a copy of the font data in

  371.    * memory.

  372.    * @param     sfntTag a four-character code as a 32-bit integer

  373.    * @param     offset index of first byte to return from table

  374.    * @param     count number of bytes to return from table

  375.    * @return a subset of the table corresponding to 

  376.    *		<code>sfntTag</code> and containing the bytes

  377.    *		starting at <code>offset</code> byte and including

  378.    *		<code>count</code> bytes.

  379.    */

  380.   public byte[] getFontTable(int sfntTag, int offset, int count);

  381. 

  382.   /**

  383.    * Returns a subset of the table as an array of bytes 

  384.    * for a specified tag.  Tags for sfnt tables include items 

  385.    * like <i>cmap</i>, <i>name</i> and <i>head</i>. The 

  386.    * <code>byte</code> array returned is a copy of the font 

  387.    * data in memory.

  388.    * @param sfntTag a four-character code as a 

  389.    * <code>String</code>

  390.    * @param     offset index of first byte to return from table

  391.    * @param     count  number of bytes to return from table

  392.    * @return a subset of the table corresponding to

  393.    *            <code>strSfntTag</code> and containing the bytes

  394.    *            starting at <code>offset</code> byte and including

  395.    *            <code>count</code> bytes.

  396.    */

  397.   public byte[] getFontTable(String strSfntTag, int offset, int count);

  398. 

  399.   /**

  400.    * Returns the size of the table for a specified tag. Tags for sfnt

  401.    * tables include items like <i>cmap</i>, <i>name</i> and <i>head</i>.

  402.    * @param     sfntTag a four-character code as a 32-bit integer

  403.    * @return the size of the table corresponding to the specified

  404.    * tag.

  405.    */

  406.   public int getFontTableSize(int sfntTag);

  407. 

  408.   /**

  409.    * Returns the size of the table for a specified tag. Tags for sfnt

  410.    * tables include items like <i>cmap</i>, <i>name</i> and <i>head</i>.

  411.    * @param     strSfntTag a four-character code as a 

  412.    * <code>String</code>

  413.    * @return the size of the table corresponding to the specified tag.

  414.    */

  415.   public int getFontTableSize(String strSfntTag);

  416. 

  417. 

  418. }

  419.