Showing the changes to java/pkg/java/awt/font/OpenType.java (1 of 18352 files). Show all
Unified · Split
| @@ -0,0 +1,432 @@ | ||
| 1 | +/* | |
| 2 | + * Copyright (c) 1997, 2008, Oracle and/or its affiliates. All rights reserved. | |
| 3 | + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
| 4 | + * | |
| 5 | + * This code is free software; you can redistribute it and/or modify it | |
| 6 | + * under the terms of the GNU General Public License version 2 only, as | |
| 7 | + * published by the Free Software Foundation. Oracle designates this | |
| 8 | + * particular file as subject to the "Classpath" exception as provided | |
| 9 | + * by Oracle in the LICENSE file that accompanied this code. | |
| 10 | + * | |
| 11 | + * This code is distributed in the hope that it will be useful, but WITHOUT | |
| 12 | + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 13 | + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 14 | + * version 2 for more details (a copy is included in the LICENSE file that | |
| 15 | + * accompanied this code). | |
| 16 | + * | |
| 17 | + * You should have received a copy of the GNU General Public License version | |
| 18 | + * 2 along with this work; if not, write to the Free Software Foundation, | |
| 19 | + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. | |
| 20 | + * | |
| 21 | + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA | |
| 22 | + * or visit www.oracle.com if you need additional information or have any | |
| 23 | + * questions. | |
| 24 | + */ | |
| 25 | + | |
| 26 | +package java.awt.font; | |
| 27 | + | |
| 28 | +/** | |
| 29 | + * The <code>OpenType</code> interface represents OpenType and | |
| 30 | + * TrueType fonts. This interface makes it possible to obtain | |
| 31 | + * <i>sfnt</i> tables from the font. A particular | |
| 32 | + * <code>Font</code> object can implement this interface. | |
| 33 | + * <p> | |
| 34 | + * For more information on TrueType and OpenType fonts, see the | |
| 35 | + * OpenType specification. | |
| 36 | + * ( <a href=http://www.microsoft.com/typography/otspec/">http://www.microsoft.com/typography/otspec/l</a> ). | |
| 37 | + */ | |
| 38 | +public interface OpenType { | |
| 39 | + | |
| 40 | + /* 51 tag types so far */ | |
| 41 | + | |
| 42 | + /** | |
| 43 | + * Character to glyph mapping. Table tag "cmap" in the Open | |
| 44 | + * Type Specification. | |
| 45 | + */ | |
| 46 | + public final static int TAG_CMAP = 0x636d6170; | |
| 47 | + | |
| 48 | + /** | |
| 49 | + * Font header. Table tag "head" in the Open | |
| 50 | + * Type Specification. | |
| 51 | + */ | |
| 52 | + public final static int TAG_HEAD = 0x68656164; | |
| 53 | + | |
| 54 | + /** | |
| 55 | + * Naming table. Table tag "name" in the Open | |
| 56 | + * Type Specification. | |
| 57 | + */ | |
| 58 | + public final static int TAG_NAME = 0x6e616d65; | |
| 59 | + | |
| 60 | + /** | |
| 61 | + * Glyph data. Table tag "glyf" in the Open | |
| 62 | + * Type Specification. | |
| 63 | + */ | |
| 64 | + public final static int TAG_GLYF = 0x676c7966; | |
| 65 | + | |
| 66 | + /** | |
| 67 | + * Maximum profile. Table tag "maxp" in the Open | |
| 68 | + * Type Specification. | |
| 69 | + */ | |
| 70 | + public final static int TAG_MAXP = 0x6d617870; | |
| 71 | + | |
| 72 | + /** | |
| 73 | + * CVT preprogram. Table tag "prep" in the Open | |
| 74 | + * Type Specification. | |
| 75 | + */ | |
| 76 | + public final static int TAG_PREP = 0x70726570; | |
| 77 | + | |
| 78 | + /** | |
| 79 | + * Horizontal metrics. Table tag "hmtx" in the Open | |
| 80 | + * Type Specification. | |
| 81 | + */ | |
| 82 | + public final static int TAG_HMTX = 0x686d7478; | |
| 83 | + | |
| 84 | + /** | |
| 85 | + * Kerning. Table tag "kern" in the Open | |
| 86 | + * Type Specification. | |
| 87 | + */ | |
| 88 | + public final static int TAG_KERN = 0x6b65726e; | |
| 89 | + | |
| 90 | + /** | |
| 91 | + * Horizontal device metrics. Table tag "hdmx" in the Open | |
| 92 | + * Type Specification. | |
| 93 | + */ | |
| 94 | + public final static int TAG_HDMX = 0x68646d78; | |
| 95 | + | |
| 96 | + /** | |
| 97 | + * Index to location. Table tag "loca" in the Open | |
| 98 | + * Type Specification. | |
| 99 | + */ | |
| 100 | + public final static int TAG_LOCA = 0x6c6f6361; | |
| 101 | + | |
| 102 | + /** | |
| 103 | + * PostScript Information. Table tag "post" in the Open | |
| 104 | + * Type Specification. | |
| 105 | + */ | |
| 106 | + public final static int TAG_POST = 0x706f7374; | |
| 107 | + | |
| 108 | + /** | |
| 109 | + * OS/2 and Windows specific metrics. Table tag "OS/2" | |
| 110 | + * in the Open Type Specification. | |
| 111 | + */ | |
| 112 | + public final static int TAG_OS2 = 0x4f532f32; | |
| 113 | + | |
| 114 | + /** | |
| 115 | + * Control value table. Table tag "cvt " | |
| 116 | + * in the Open Type Specification. | |
| 117 | + */ | |
| 118 | + public final static int TAG_CVT = 0x63767420; | |
| 119 | + | |
| 120 | + /** | |
| 121 | + * Grid-fitting and scan conversion procedure. Table tag | |
| 122 | + * "gasp" in the Open Type Specification. | |
| 123 | + */ | |
| 124 | + public final static int TAG_GASP = 0x67617370; | |
| 125 | + | |
| 126 | + /** | |
| 127 | + * Vertical device metrics. Table tag "VDMX" in the Open | |
| 128 | + * Type Specification. | |
| 129 | + */ | |
| 130 | + public final static int TAG_VDMX = 0x56444d58; | |
| 131 | + | |
| 132 | + /** | |
| 133 | + * Vertical metrics. Table tag "vmtx" in the Open | |
| 134 | + * Type Specification. | |
| 135 | + */ | |
| 136 | + public final static int TAG_VMTX = 0x766d7478; | |
| 137 | + | |
| 138 | + /** | |
| 139 | + * Vertical metrics header. Table tag "vhea" in the Open | |
| 140 | + * Type Specification. | |
| 141 | + */ | |
| 142 | + public final static int TAG_VHEA = 0x76686561; | |
| 143 | + | |
| 144 | + /** | |
| 145 | + * Horizontal metrics header. Table tag "hhea" in the Open | |
| 146 | + * Type Specification. | |
| 147 | + */ | |
| 148 | + public final static int TAG_HHEA = 0x68686561; | |
| 149 | + | |
| 150 | + /** | |
| 151 | + * Adobe Type 1 font data. Table tag "typ1" in the Open | |
| 152 | + * Type Specification. | |
| 153 | + */ | |
| 154 | + public final static int TAG_TYP1 = 0x74797031; | |
| 155 | + | |
| 156 | + /** | |
| 157 | + * Baseline table. Table tag "bsln" in the Open | |
| 158 | + * Type Specification. | |
| 159 | + */ | |
| 160 | + public final static int TAG_BSLN = 0x62736c6e; | |
| 161 | + | |
| 162 | + /** | |
| 163 | + * Glyph substitution. Table tag "GSUB" in the Open | |
| 164 | + * Type Specification. | |
| 165 | + */ | |
| 166 | + public final static int TAG_GSUB = 0x47535542; | |
| 167 | + | |
| 168 | + /** | |
| 169 | + * Digital signature. Table tag "DSIG" in the Open | |
| 170 | + * Type Specification. | |
| 171 | + */ | |
| 172 | + public final static int TAG_DSIG = 0x44534947; | |
| 173 | + | |
| 174 | + /** | |
| 175 | + * Font program. Table tag "fpgm" in the Open | |
| 176 | + * Type Specification. | |
| 177 | + */ | |
| 178 | + public final static int TAG_FPGM = 0x6670676d; | |
| 179 | + | |
| 180 | + /** | |
| 181 | + * Font variation. Table tag "fvar" in the Open | |
| 182 | + * Type Specification. | |
| 183 | + */ | |
| 184 | + public final static int TAG_FVAR = 0x66766172; | |
| 185 | + | |
| 186 | + /** | |
| 187 | + * Glyph variation. Table tag "gvar" in the Open | |
| 188 | + * Type Specification. | |
| 189 | + */ | |
| 190 | + public final static int TAG_GVAR = 0x67766172; | |
| 191 | + | |
| 192 | + /** | |
| 193 | + * Compact font format (Type1 font). Table tag | |
| 194 | + * "CFF " in the Open Type Specification. | |
| 195 | + */ | |
| 196 | + public final static int TAG_CFF = 0x43464620; | |
| 197 | + | |
| 198 | + /** | |
| 199 | + * Multiple master supplementary data. Table tag | |
| 200 | + * "MMSD" in the Open Type Specification. | |
| 201 | + */ | |
| 202 | + public final static int TAG_MMSD = 0x4d4d5344; | |
| 203 | + | |
| 204 | + /** | |
| 205 | + * Multiple master font metrics. Table tag | |
| 206 | + * "MMFX" in the Open Type Specification. | |
| 207 | + */ | |
| 208 | + public final static int TAG_MMFX = 0x4d4d4658; | |
| 209 | + | |
| 210 | + /** | |
| 211 | + * Baseline data. Table tag "BASE" in the Open | |
| 212 | + * Type Specification. | |
| 213 | + */ | |
| 214 | + public final static int TAG_BASE = 0x42415345; | |
| 215 | + | |
| 216 | + /** | |
| 217 | + * Glyph definition. Table tag "GDEF" in the Open | |
| 218 | + * Type Specification. | |
| 219 | + */ | |
| 220 | + public final static int TAG_GDEF = 0x47444546; | |
| 221 | + | |
| 222 | + /** | |
| 223 | + * Glyph positioning. Table tag "GPOS" in the Open | |
| 224 | + * Type Specification. | |
| 225 | + */ | |
| 226 | + public final static int TAG_GPOS = 0x47504f53; | |
| 227 | + | |
| 228 | + /** | |
| 229 | + * Justification. Table tag "JSTF" in the Open | |
| 230 | + * Type Specification. | |
| 231 | + */ | |
| 232 | + public final static int TAG_JSTF = 0x4a535446; | |
| 233 | + | |
| 234 | + /** | |
| 235 | + * Embedded bitmap data. Table tag "EBDT" in the Open | |
| 236 | + * Type Specification. | |
| 237 | + */ | |
| 238 | + public final static int TAG_EBDT = 0x45424454; | |
| 239 | + | |
| 240 | + /** | |
| 241 | + * Embedded bitmap location. Table tag "EBLC" in the Open | |
| 242 | + * Type Specification. | |
| 243 | + */ | |
| 244 | + public final static int TAG_EBLC = 0x45424c43; | |
| 245 | + | |
| 246 | + /** | |
| 247 | + * Embedded bitmap scaling. Table tag "EBSC" in the Open | |
| 248 | + * Type Specification. | |
| 249 | + */ | |
| 250 | + public final static int TAG_EBSC = 0x45425343; | |
| 251 | + | |
| 252 | + /** | |
| 253 | + * Linear threshold. Table tag "LTSH" in the Open | |
| 254 | + * Type Specification. | |
| 255 | + */ | |
| 256 | + public final static int TAG_LTSH = 0x4c545348; | |
| 257 | + | |
| 258 | + /** | |
| 259 | + * PCL 5 data. Table tag "PCLT" in the Open | |
| 260 | + * Type Specification. | |
| 261 | + */ | |
| 262 | + public final static int TAG_PCLT = 0x50434c54; | |
| 263 | + | |
| 264 | + /** | |
| 265 | + * Accent attachment. Table tag "acnt" in the Open | |
| 266 | + * Type Specification. | |
| 267 | + */ | |
| 268 | + public final static int TAG_ACNT = 0x61636e74; | |
| 269 | + | |
| 270 | + /** | |
| 271 | + * Axis variaiton. Table tag "avar" in the Open | |
| 272 | + * Type Specification. | |
| 273 | + */ | |
| 274 | + public final static int TAG_AVAR = 0x61766172; | |
| 275 | + | |
| 276 | + /** | |
| 277 | + * Bitmap data. Table tag "bdat" in the Open | |
| 278 | + * Type Specification. | |
| 279 | + */ | |
| 280 | + public final static int TAG_BDAT = 0x62646174; | |
| 281 | + | |
| 282 | + /** | |
| 283 | + * Bitmap location. Table tag "bloc" in the Open | |
| 284 | + * Type Specification. | |
| 285 | + */ | |
| 286 | + public final static int TAG_BLOC = 0x626c6f63; | |
| 287 | + | |
| 288 | + /** | |
| 289 | + * CVT variation. Table tag "cvar" in the Open | |
| 290 | + * Type Specification. | |
| 291 | + */ | |
| 292 | + public final static int TAG_CVAR = 0x63766172; | |
| 293 | + | |
| 294 | + /** | |
| 295 | + * Feature name. Table tag "feat" in the Open | |
| 296 | + * Type Specification. | |
| 297 | + */ | |
| 298 | + public final static int TAG_FEAT = 0x66656174; | |
| 299 | + | |
| 300 | + /** | |
| 301 | + * Font descriptors. Table tag "fdsc" in the Open | |
| 302 | + * Type Specification. | |
| 303 | + */ | |
| 304 | + public final static int TAG_FDSC = 0x66647363; | |
| 305 | + | |
| 306 | + /** | |
| 307 | + * Font metrics. Table tag "fmtx" in the Open | |
| 308 | + * Type Specification. | |
| 309 | + */ | |
| 310 | + public final static int TAG_FMTX = 0x666d7478; | |
| 311 | + | |
| 312 | + /** | |
| 313 | + * Justification. Table tag "just" in the Open | |
| 314 | + * Type Specification. | |
| 315 | + */ | |
| 316 | + public final static int TAG_JUST = 0x6a757374; | |
| 317 | + | |
| 318 | + /** | |
| 319 | + * Ligature caret. Table tag "lcar" in the Open | |
| 320 | + * Type Specification. | |
| 321 | + */ | |
| 322 | + public final static int TAG_LCAR = 0x6c636172; | |
| 323 | + | |
| 324 | + /** | |
| 325 | + * Glyph metamorphosis. Table tag "mort" in the Open | |
| 326 | + * Type Specification. | |
| 327 | + */ | |
| 328 | + public final static int TAG_MORT = 0x6d6f7274; | |
| 329 | + | |
| 330 | + /** | |
| 331 | + * Optical bounds. Table tag "opbd" in the Open | |
| 332 | + * Type Specification. | |
| 333 | + */ | |
| 334 | + public final static int TAG_OPBD = 0x6d6f7274; | |
| 335 | + | |
| 336 | + /** | |
| 337 | + * Glyph properties. Table tag "prop" in the Open | |
| 338 | + * Type Specification. | |
| 339 | + */ | |
| 340 | + public final static int TAG_PROP = 0x70726f70; | |
| 341 | + | |
| 342 | + /** | |
| 343 | + * Tracking. Table tag "trak" in the Open | |
| 344 | + * Type Specification. | |
| 345 | + */ | |
| 346 | + public final static int TAG_TRAK = 0x7472616b; | |
| 347 | + | |
| 348 | + /** | |
| 349 | + * Returns the version of the <code>OpenType</code> font. | |
| 350 | + * 1.0 is represented as 0x00010000. | |
| 351 | + * @return the version of the <code>OpenType</code> font. | |
| 352 | + */ | |
| 353 | + public int getVersion(); | |
| 354 | + | |
| 355 | + /** | |
| 356 | + * Returns the table as an array of bytes for a specified tag. | |
| 357 | + * Tags for sfnt tables include items like <i>cmap</i>, | |
| 358 | + * <i>name</i> and <i>head</i>. The <code>byte</code> array | |
| 359 | + * returned is a copy of the font data in memory. | |
| 360 | + * @param sfntTag a four-character code as a 32-bit integer | |
| 361 | + * @return a <code>byte</code> array that is the table that | |
| 362 | + * contains the font data corresponding to the specified | |
| 363 | + * tag. | |
| 364 | + */ | |
| 365 | + public byte[] getFontTable(int sfntTag); | |
| 366 | + | |
| 367 | + /** | |
| 368 | + * Returns the table as an array of bytes for a specified tag. | |
| 369 | + * Tags for sfnt tables include items like <i>cmap</i>, | |
| 370 | + * <i>name</i> and <i>head</i>. The byte array returned is a | |
| 371 | + * copy of the font data in memory. | |
| 372 | + * @param strSfntTag a four-character code as a | |
| 373 | + * <code>String</code> | |
| 374 | + * @return a <code>byte</code> array that is the table that | |
| 375 | + * contains the font data corresponding to the specified | |
| 376 | + * tag. | |
| 377 | + */ | |
| 378 | + public byte[] getFontTable(String strSfntTag); | |
| 379 | + | |
| 380 | + /** | |
| 381 | + * Returns a subset of the table as an array of bytes | |
| 382 | + * for a specified tag. Tags for sfnt tables include | |
| 383 | + * items like <i>cmap</i>, <i>name</i> and <i>head</i>. | |
| 384 | + * The byte array returned is a copy of the font data in | |
| 385 | + * memory. | |
| 386 | + * @param sfntTag a four-character code as a 32-bit integer | |
| 387 | + * @param offset index of first byte to return from table | |
| 388 | + * @param count number of bytes to return from table | |
| 389 | + * @return a subset of the table corresponding to | |
| 390 | + * <code>sfntTag</code> and containing the bytes | |
| 391 | + * starting at <code>offset</code> byte and including | |
| 392 | + * <code>count</code> bytes. | |
| 393 | + */ | |
| 394 | + public byte[] getFontTable(int sfntTag, int offset, int count); | |
| 395 | + | |
| 396 | + /** | |
| 397 | + * Returns a subset of the table as an array of bytes | |
| 398 | + * for a specified tag. Tags for sfnt tables include items | |
| 399 | + * like <i>cmap</i>, <i>name</i> and <i>head</i>. The | |
| 400 | + * <code>byte</code> array returned is a copy of the font | |
| 401 | + * data in memory. | |
| 402 | + * @param strSfntTag a four-character code as a | |
| 403 | + * <code>String</code> | |
| 404 | + * @param offset index of first byte to return from table | |
| 405 | + * @param count number of bytes to return from table | |
| 406 | + * @return a subset of the table corresponding to | |
| 407 | + * <code>strSfntTag</code> and containing the bytes | |
| 408 | + * starting at <code>offset</code> byte and including | |
| 409 | + * <code>count</code> bytes. | |
| 410 | + */ | |
| 411 | + public byte[] getFontTable(String strSfntTag, int offset, int count); | |
| 412 | + | |
| 413 | + /** | |
| 414 | + * Returns the size of the table for a specified tag. Tags for sfnt | |
| 415 | + * tables include items like <i>cmap</i>, <i>name</i> and <i>head</i>. | |
| 416 | + * @param sfntTag a four-character code as a 32-bit integer | |
| 417 | + * @return the size of the table corresponding to the specified | |
| 418 | + * tag. | |
| 419 | + */ | |
| 420 | + public int getFontTableSize(int sfntTag); | |
| 421 | + | |
| 422 | + /** | |
| 423 | + * Returns the size of the table for a specified tag. Tags for sfnt | |
| 424 | + * tables include items like <i>cmap</i>, <i>name</i> and <i>head</i>. | |
| 425 | + * @param strSfntTag a four-character code as a | |
| 426 | + * <code>String</code> | |
| 427 | + * @return the size of the table corresponding to the specified tag. | |
| 428 | + */ | |
| 429 | + public int getFontTableSize(String strSfntTag); | |
| 430 | + | |
| 431 | + | |
| 432 | +} | |