author | ohair |
Wed, 06 Apr 2011 22:06:11 -0700 | |
changeset 9035 | 1255eb81cc2f |
parent 8520 | a9e798f494cb |
child 11270 | d7b0b63bd082 |
permissions | -rw-r--r-- |
2 | 1 |
/* |
9035
1255eb81cc2f
7033660: Update copyright year to 2011 on any files changed in 2011
ohair
parents:
8520
diff
changeset
|
2 |
* Copyright (c) 1995, 2011, Oracle and/or its affiliates. All rights reserved. |
2 | 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 |
|
5506 | 7 |
* published by the Free Software Foundation. Oracle designates this |
2 | 8 |
* particular file as subject to the "Classpath" exception as provided |
5506 | 9 |
* by Oracle in the LICENSE file that accompanied this code. |
2 | 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 |
* |
|
5506 | 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. |
|
2 | 24 |
*/ |
25 |
||
26 |
package java.awt; |
|
27 |
||
28 |
import java.awt.font.FontRenderContext; |
|
29 |
import java.awt.font.GlyphVector; |
|
30 |
import java.awt.font.LineMetrics; |
|
31 |
import java.awt.font.TextAttribute; |
|
32 |
import java.awt.font.TextLayout; |
|
33 |
import java.awt.geom.AffineTransform; |
|
34 |
import java.awt.geom.Point2D; |
|
35 |
import java.awt.geom.Rectangle2D; |
|
36 |
import java.awt.peer.FontPeer; |
|
37 |
import java.io.*; |
|
38 |
import java.lang.ref.SoftReference; |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
39 |
import java.security.AccessController; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
40 |
import java.security.PrivilegedExceptionAction; |
2 | 41 |
import java.text.AttributedCharacterIterator.Attribute; |
42 |
import java.text.CharacterIterator; |
|
43 |
import java.text.StringCharacterIterator; |
|
44 |
import java.util.Hashtable; |
|
45 |
import java.util.Locale; |
|
46 |
import java.util.Map; |
|
47 |
import sun.font.StandardGlyphVector; |
|
48 |
||
49 |
import sun.font.AttributeMap; |
|
50 |
import sun.font.AttributeValues; |
|
51 |
import sun.font.CompositeFont; |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
52 |
import sun.font.CreatedFontTracker; |
2 | 53 |
import sun.font.Font2D; |
54 |
import sun.font.Font2DHandle; |
|
3928 | 55 |
import sun.font.FontAccess; |
2 | 56 |
import sun.font.FontManager; |
3928 | 57 |
import sun.font.FontManagerFactory; |
58 |
import sun.font.FontUtilities; |
|
2 | 59 |
import sun.font.GlyphLayout; |
60 |
import sun.font.FontLineMetrics; |
|
61 |
import sun.font.CoreMetrics; |
|
62 |
||
63 |
import static sun.font.EAttribute.*; |
|
64 |
||
65 |
/** |
|
66 |
* The <code>Font</code> class represents fonts, which are used to |
|
67 |
* render text in a visible way. |
|
68 |
* A font provides the information needed to map sequences of |
|
69 |
* <em>characters</em> to sequences of <em>glyphs</em> |
|
70 |
* and to render sequences of glyphs on <code>Graphics</code> and |
|
71 |
* <code>Component</code> objects. |
|
72 |
* |
|
73 |
* <h4>Characters and Glyphs</h4> |
|
74 |
* |
|
75 |
* A <em>character</em> is a symbol that represents an item such as a letter, |
|
76 |
* a digit, or punctuation in an abstract way. For example, <code>'g'</code>, |
|
77 |
* <font size=-1>LATIN SMALL LETTER G</font>, is a character. |
|
78 |
* <p> |
|
79 |
* A <em>glyph</em> is a shape used to render a character or a sequence of |
|
80 |
* characters. In simple writing systems, such as Latin, typically one glyph |
|
81 |
* represents one character. In general, however, characters and glyphs do not |
|
82 |
* have one-to-one correspondence. For example, the character 'á' |
|
83 |
* <font size=-1>LATIN SMALL LETTER A WITH ACUTE</font>, can be represented by |
|
84 |
* two glyphs: one for 'a' and one for '´'. On the other hand, the |
|
85 |
* two-character string "fi" can be represented by a single glyph, an |
|
86 |
* "fi" ligature. In complex writing systems, such as Arabic or the South |
|
87 |
* and South-East Asian writing systems, the relationship between characters |
|
88 |
* and glyphs can be more complicated and involve context-dependent selection |
|
89 |
* of glyphs as well as glyph reordering. |
|
90 |
* |
|
91 |
* A font encapsulates the collection of glyphs needed to render a selected set |
|
92 |
* of characters as well as the tables needed to map sequences of characters to |
|
93 |
* corresponding sequences of glyphs. |
|
94 |
* |
|
95 |
* <h4>Physical and Logical Fonts</h4> |
|
96 |
* |
|
97 |
* The Java Platform distinguishes between two kinds of fonts: |
|
98 |
* <em>physical</em> fonts and <em>logical</em> fonts. |
|
99 |
* <p> |
|
100 |
* <em>Physical</em> fonts are the actual font libraries containing glyph data |
|
101 |
* and tables to map from character sequences to glyph sequences, using a font |
|
102 |
* technology such as TrueType or PostScript Type 1. |
|
103 |
* All implementations of the Java Platform must support TrueType fonts; |
|
104 |
* support for other font technologies is implementation dependent. |
|
105 |
* Physical fonts may use names such as Helvetica, Palatino, HonMincho, or |
|
106 |
* any number of other font names. |
|
107 |
* Typically, each physical font supports only a limited set of writing |
|
108 |
* systems, for example, only Latin characters or only Japanese and Basic |
|
109 |
* Latin. |
|
110 |
* The set of available physical fonts varies between configurations. |
|
111 |
* Applications that require specific fonts can bundle them and instantiate |
|
112 |
* them using the {@link #createFont createFont} method. |
|
113 |
* <p> |
|
114 |
* <em>Logical</em> fonts are the five font families defined by the Java |
|
115 |
* platform which must be supported by any Java runtime environment: |
|
116 |
* Serif, SansSerif, Monospaced, Dialog, and DialogInput. |
|
117 |
* These logical fonts are not actual font libraries. Instead, the logical |
|
118 |
* font names are mapped to physical fonts by the Java runtime environment. |
|
119 |
* The mapping is implementation and usually locale dependent, so the look |
|
120 |
* and the metrics provided by them vary. |
|
121 |
* Typically, each logical font name maps to several physical fonts in order to |
|
122 |
* cover a large range of characters. |
|
123 |
* <p> |
|
124 |
* Peered AWT components, such as {@link Label Label} and |
|
125 |
* {@link TextField TextField}, can only use logical fonts. |
|
126 |
* <p> |
|
127 |
* For a discussion of the relative advantages and disadvantages of using |
|
128 |
* physical or logical fonts, see the |
|
129 |
* <a href="http://java.sun.com/j2se/corejava/intl/reference/faqs/index.html#desktop-rendering">Internationalization FAQ</a> |
|
130 |
* document. |
|
131 |
* |
|
132 |
* <h4>Font Faces and Names</h4> |
|
133 |
* |
|
134 |
* A <code>Font</code> |
|
135 |
* can have many faces, such as heavy, medium, oblique, gothic and |
|
136 |
* regular. All of these faces have similar typographic design. |
|
137 |
* <p> |
|
138 |
* There are three different names that you can get from a |
|
139 |
* <code>Font</code> object. The <em>logical font name</em> is simply the |
|
140 |
* name that was used to construct the font. |
|
141 |
* The <em>font face name</em>, or just <em>font name</em> for |
|
142 |
* short, is the name of a particular font face, like Helvetica Bold. The |
|
143 |
* <em>family name</em> is the name of the font family that determines the |
|
144 |
* typographic design across several faces, like Helvetica. |
|
145 |
* <p> |
|
146 |
* The <code>Font</code> class represents an instance of a font face from |
|
147 |
* a collection of font faces that are present in the system resources |
|
148 |
* of the host system. As examples, Arial Bold and Courier Bold Italic |
|
149 |
* are font faces. There can be several <code>Font</code> objects |
|
150 |
* associated with a font face, each differing in size, style, transform |
|
151 |
* and font features. |
|
152 |
* <p> |
|
153 |
* The {@link GraphicsEnvironment#getAllFonts() getAllFonts} method |
|
154 |
* of the <code>GraphicsEnvironment</code> class returns an |
|
155 |
* array of all font faces available in the system. These font faces are |
|
156 |
* returned as <code>Font</code> objects with a size of 1, identity |
|
157 |
* transform and default font features. These |
|
158 |
* base fonts can then be used to derive new <code>Font</code> objects |
|
159 |
* with varying sizes, styles, transforms and font features via the |
|
160 |
* <code>deriveFont</code> methods in this class. |
|
161 |
* |
|
162 |
* <h4>Font and TextAttribute</h4> |
|
163 |
* |
|
164 |
* <p><code>Font</code> supports most |
|
165 |
* <code>TextAttribute</code>s. This makes some operations, such as |
|
166 |
* rendering underlined text, convenient since it is not |
|
167 |
* necessary to explicitly construct a <code>TextLayout</code> object. |
|
168 |
* Attributes can be set on a Font by constructing or deriving it |
|
169 |
* using a <code>Map</code> of <code>TextAttribute</code> values. |
|
170 |
* |
|
171 |
* <p>The values of some <code>TextAttributes</code> are not |
|
172 |
* serializable, and therefore attempting to serialize an instance of |
|
173 |
* <code>Font</code> that has such values will not serialize them. |
|
174 |
* This means a Font deserialized from such a stream will not compare |
|
175 |
* equal to the original Font that contained the non-serializable |
|
176 |
* attributes. This should very rarely pose a problem |
|
177 |
* since these attributes are typically used only in special |
|
178 |
* circumstances and are unlikely to be serialized. |
|
179 |
* |
|
180 |
* <ul> |
|
181 |
* <li><code>FOREGROUND</code> and <code>BACKGROUND</code> use |
|
182 |
* <code>Paint</code> values. The subclass <code>Color</code> is |
|
183 |
* serializable, while <code>GradientPaint</code> and |
|
184 |
* <code>TexturePaint</code> are not.</li> |
|
185 |
* <li><code>CHAR_REPLACEMENT</code> uses |
|
186 |
* <code>GraphicAttribute</code> values. The subclasses |
|
187 |
* <code>ShapeGraphicAttribute</code> and |
|
188 |
* <code>ImageGraphicAttribute</code> are not serializable.</li> |
|
189 |
* <li><code>INPUT_METHOD_HIGHLIGHT</code> uses |
|
190 |
* <code>InputMethodHighlight</code> values, which are |
|
191 |
* not serializable. See {@link java.awt.im.InputMethodHighlight}.</li> |
|
192 |
* </ul> |
|
193 |
* |
|
194 |
* Clients who create custom subclasses of <code>Paint</code> and |
|
195 |
* <code>GraphicAttribute</code> can make them serializable and |
|
196 |
* avoid this problem. Clients who use input method highlights can |
|
197 |
* convert these to the platform-specific attributes for that |
|
198 |
* highlight on the current platform and set them on the Font as |
|
199 |
* a workaround.</p> |
|
200 |
* |
|
201 |
* <p>The <code>Map</code>-based constructor and |
|
202 |
* <code>deriveFont</code> APIs ignore the FONT attribute, and it is |
|
203 |
* not retained by the Font; the static {@link #getFont} method should |
|
204 |
* be used if the FONT attribute might be present. See {@link |
|
205 |
* java.awt.font.TextAttribute#FONT} for more information.</p> |
|
206 |
* |
|
207 |
* <p>Several attributes will cause additional rendering overhead |
|
208 |
* and potentially invoke layout. If a <code>Font</code> has such |
|
209 |
* attributes, the <code>{@link #hasLayoutAttributes()}</code> method |
|
210 |
* will return true.</p> |
|
211 |
* |
|
212 |
* <p>Note: Font rotations can cause text baselines to be rotated. In |
|
213 |
* order to account for this (rare) possibility, font APIs are |
|
214 |
* specified to return metrics and take parameters 'in |
|
215 |
* baseline-relative coordinates'. This maps the 'x' coordinate to |
|
216 |
* the advance along the baseline, (positive x is forward along the |
|
217 |
* baseline), and the 'y' coordinate to a distance along the |
|
218 |
* perpendicular to the baseline at 'x' (positive y is 90 degrees |
|
219 |
* clockwise from the baseline vector). APIs for which this is |
|
220 |
* especially important are called out as having 'baseline-relative |
|
221 |
* coordinates.' |
|
222 |
*/ |
|
223 |
public class Font implements java.io.Serializable |
|
224 |
{ |
|
3928 | 225 |
private static class FontAccessImpl extends FontAccess { |
226 |
public Font2D getFont2D(Font font) { |
|
227 |
return font.getFont2D(); |
|
228 |
} |
|
229 |
||
230 |
public void setFont2D(Font font, Font2DHandle handle) { |
|
231 |
font.font2DHandle = handle; |
|
232 |
} |
|
233 |
||
234 |
public void setCreatedFont(Font font) { |
|
235 |
font.createdFont = true; |
|
236 |
} |
|
237 |
||
238 |
public boolean isCreatedFont(Font font) { |
|
239 |
return font.createdFont; |
|
240 |
} |
|
241 |
} |
|
242 |
||
2 | 243 |
static { |
244 |
/* ensure that the necessary native libraries are loaded */ |
|
245 |
Toolkit.loadLibraries(); |
|
246 |
initIDs(); |
|
3928 | 247 |
FontAccess.setFontAccess(new FontAccessImpl()); |
2 | 248 |
} |
249 |
||
250 |
/** |
|
251 |
* This is now only used during serialization. Typically |
|
252 |
* it is null. |
|
253 |
* |
|
254 |
* @serial |
|
255 |
* @see #getAttributes() |
|
256 |
*/ |
|
257 |
private Hashtable fRequestedAttributes; |
|
258 |
||
259 |
/* |
|
260 |
* Constants to be used for logical font family names. |
|
261 |
*/ |
|
262 |
||
263 |
/** |
|
264 |
* A String constant for the canonical family name of the |
|
265 |
* logical font "Dialog". It is useful in Font construction |
|
266 |
* to provide compile-time verification of the name. |
|
267 |
* @since 1.6 |
|
268 |
*/ |
|
269 |
public static final String DIALOG = "Dialog"; |
|
270 |
||
271 |
/** |
|
272 |
* A String constant for the canonical family name of the |
|
273 |
* logical font "DialogInput". It is useful in Font construction |
|
274 |
* to provide compile-time verification of the name. |
|
275 |
* @since 1.6 |
|
276 |
*/ |
|
277 |
public static final String DIALOG_INPUT = "DialogInput"; |
|
278 |
||
279 |
/** |
|
280 |
* A String constant for the canonical family name of the |
|
281 |
* logical font "SansSerif". It is useful in Font construction |
|
282 |
* to provide compile-time verification of the name. |
|
283 |
* @since 1.6 |
|
284 |
*/ |
|
285 |
public static final String SANS_SERIF = "SansSerif"; |
|
286 |
||
287 |
/** |
|
288 |
* A String constant for the canonical family name of the |
|
289 |
* logical font "Serif". It is useful in Font construction |
|
290 |
* to provide compile-time verification of the name. |
|
291 |
* @since 1.6 |
|
292 |
*/ |
|
293 |
public static final String SERIF = "Serif"; |
|
294 |
||
295 |
/** |
|
296 |
* A String constant for the canonical family name of the |
|
297 |
* logical font "Monospaced". It is useful in Font construction |
|
298 |
* to provide compile-time verification of the name. |
|
299 |
* @since 1.6 |
|
300 |
*/ |
|
301 |
public static final String MONOSPACED = "Monospaced"; |
|
302 |
||
303 |
/* |
|
304 |
* Constants to be used for styles. Can be combined to mix |
|
305 |
* styles. |
|
306 |
*/ |
|
307 |
||
308 |
/** |
|
309 |
* The plain style constant. |
|
310 |
*/ |
|
311 |
public static final int PLAIN = 0; |
|
312 |
||
313 |
/** |
|
314 |
* The bold style constant. This can be combined with the other style |
|
315 |
* constants (except PLAIN) for mixed styles. |
|
316 |
*/ |
|
317 |
public static final int BOLD = 1; |
|
318 |
||
319 |
/** |
|
320 |
* The italicized style constant. This can be combined with the other |
|
321 |
* style constants (except PLAIN) for mixed styles. |
|
322 |
*/ |
|
323 |
public static final int ITALIC = 2; |
|
324 |
||
325 |
/** |
|
326 |
* The baseline used in most Roman scripts when laying out text. |
|
327 |
*/ |
|
328 |
public static final int ROMAN_BASELINE = 0; |
|
329 |
||
330 |
/** |
|
331 |
* The baseline used in ideographic scripts like Chinese, Japanese, |
|
332 |
* and Korean when laying out text. |
|
333 |
*/ |
|
334 |
public static final int CENTER_BASELINE = 1; |
|
335 |
||
336 |
/** |
|
337 |
* The baseline used in Devanigiri and similar scripts when laying |
|
338 |
* out text. |
|
339 |
*/ |
|
340 |
public static final int HANGING_BASELINE = 2; |
|
341 |
||
342 |
/** |
|
343 |
* Identify a font resource of type TRUETYPE. |
|
344 |
* Used to specify a TrueType font resource to the |
|
345 |
* {@link #createFont} method. |
|
5578 | 346 |
* The TrueType format was extended to become the OpenType |
347 |
* format, which adds support for fonts with Postscript outlines, |
|
348 |
* this tag therefore references these fonts, as well as those |
|
349 |
* with TrueType outlines. |
|
2 | 350 |
* @since 1.3 |
351 |
*/ |
|
352 |
||
353 |
public static final int TRUETYPE_FONT = 0; |
|
354 |
||
355 |
/** |
|
356 |
* Identify a font resource of type TYPE1. |
|
357 |
* Used to specify a Type1 font resource to the |
|
358 |
* {@link #createFont} method. |
|
359 |
* @since 1.5 |
|
360 |
*/ |
|
361 |
public static final int TYPE1_FONT = 1; |
|
362 |
||
363 |
/** |
|
364 |
* The logical name of this <code>Font</code>, as passed to the |
|
365 |
* constructor. |
|
366 |
* @since JDK1.0 |
|
367 |
* |
|
368 |
* @serial |
|
369 |
* @see #getName |
|
370 |
*/ |
|
371 |
protected String name; |
|
372 |
||
373 |
/** |
|
374 |
* The style of this <code>Font</code>, as passed to the constructor. |
|
375 |
* This style can be PLAIN, BOLD, ITALIC, or BOLD+ITALIC. |
|
376 |
* @since JDK1.0 |
|
377 |
* |
|
378 |
* @serial |
|
379 |
* @see #getStyle() |
|
380 |
*/ |
|
381 |
protected int style; |
|
382 |
||
383 |
/** |
|
384 |
* The point size of this <code>Font</code>, rounded to integer. |
|
385 |
* @since JDK1.0 |
|
386 |
* |
|
387 |
* @serial |
|
388 |
* @see #getSize() |
|
389 |
*/ |
|
390 |
protected int size; |
|
391 |
||
392 |
/** |
|
393 |
* The point size of this <code>Font</code> in <code>float</code>. |
|
394 |
* |
|
395 |
* @serial |
|
396 |
* @see #getSize() |
|
397 |
* @see #getSize2D() |
|
398 |
*/ |
|
399 |
protected float pointSize; |
|
400 |
||
401 |
/** |
|
402 |
* The platform specific font information. |
|
403 |
*/ |
|
404 |
private transient FontPeer peer; |
|
405 |
private transient long pData; // native JDK1.1 font pointer |
|
406 |
private transient Font2DHandle font2DHandle; |
|
407 |
||
408 |
private transient AttributeValues values; |
|
409 |
private transient boolean hasLayoutAttributes; |
|
410 |
||
411 |
/* |
|
412 |
* If the origin of a Font is a created font then this attribute |
|
413 |
* must be set on all derived fonts too. |
|
414 |
*/ |
|
415 |
private transient boolean createdFont = false; |
|
416 |
||
417 |
/* |
|
418 |
* This is true if the font transform is not identity. It |
|
419 |
* is used to avoid unnecessary instantiation of an AffineTransform. |
|
420 |
*/ |
|
421 |
private transient boolean nonIdentityTx; |
|
422 |
||
423 |
/* |
|
424 |
* A cached value used when a transform is required for internal |
|
425 |
* use. This must not be exposed to callers since AffineTransform |
|
426 |
* is mutable. |
|
427 |
*/ |
|
428 |
private static final AffineTransform identityTx = new AffineTransform(); |
|
429 |
||
430 |
/* |
|
431 |
* JDK 1.1 serialVersionUID |
|
432 |
*/ |
|
433 |
private static final long serialVersionUID = -4206021311591459213L; |
|
434 |
||
435 |
/** |
|
436 |
* Gets the peer of this <code>Font</code>. |
|
437 |
* @return the peer of the <code>Font</code>. |
|
438 |
* @since JDK1.1 |
|
439 |
* @deprecated Font rendering is now platform independent. |
|
440 |
*/ |
|
441 |
@Deprecated |
|
442 |
public FontPeer getPeer(){ |
|
443 |
return getPeer_NoClientCode(); |
|
444 |
} |
|
445 |
// NOTE: This method is called by privileged threads. |
|
446 |
// We implement this functionality in a package-private method |
|
447 |
// to insure that it cannot be overridden by client subclasses. |
|
448 |
// DO NOT INVOKE CLIENT CODE ON THIS THREAD! |
|
449 |
final FontPeer getPeer_NoClientCode() { |
|
450 |
if(peer == null) { |
|
451 |
Toolkit tk = Toolkit.getDefaultToolkit(); |
|
452 |
this.peer = tk.getFontPeer(name, style); |
|
453 |
} |
|
454 |
return peer; |
|
455 |
} |
|
456 |
||
457 |
/** |
|
458 |
* Return the AttributeValues object associated with this |
|
459 |
* font. Most of the time, the internal object is null. |
|
460 |
* If required, it will be created from the 'standard' |
|
461 |
* state on the font. Only non-default values will be |
|
462 |
* set in the AttributeValues object. |
|
463 |
* |
|
464 |
* <p>Since the AttributeValues object is mutable, and it |
|
465 |
* is cached in the font, care must be taken to ensure that |
|
466 |
* it is not mutated. |
|
467 |
*/ |
|
468 |
private AttributeValues getAttributeValues() { |
|
469 |
if (values == null) { |
|
3017
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
470 |
AttributeValues valuesTmp = new AttributeValues(); |
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
471 |
valuesTmp.setFamily(name); |
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
472 |
valuesTmp.setSize(pointSize); // expects the float value. |
2 | 473 |
|
474 |
if ((style & BOLD) != 0) { |
|
3017
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
475 |
valuesTmp.setWeight(2); // WEIGHT_BOLD |
2 | 476 |
} |
477 |
||
478 |
if ((style & ITALIC) != 0) { |
|
3017
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
479 |
valuesTmp.setPosture(.2f); // POSTURE_OBLIQUE |
2 | 480 |
} |
3017
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
481 |
valuesTmp.defineAll(PRIMARY_MASK); // for streaming compatibility |
217bf37bb0ea
6853617: race condition in java.awt.Font.getAttributes() (private method)
prr
parents:
2624
diff
changeset
|
482 |
values = valuesTmp; |
2 | 483 |
} |
484 |
||
485 |
return values; |
|
486 |
} |
|
487 |
||
488 |
private Font2D getFont2D() { |
|
3928 | 489 |
FontManager fm = FontManagerFactory.getInstance(); |
490 |
if (fm.usingPerAppContextComposites() && |
|
2 | 491 |
font2DHandle != null && |
492 |
font2DHandle.font2D instanceof CompositeFont && |
|
493 |
((CompositeFont)(font2DHandle.font2D)).isStdComposite()) { |
|
3928 | 494 |
return fm.findFont2D(name, style, |
2 | 495 |
FontManager.LOGICAL_FALLBACK); |
496 |
} else if (font2DHandle == null) { |
|
497 |
font2DHandle = |
|
3928 | 498 |
fm.findFont2D(name, style, |
499 |
FontManager.LOGICAL_FALLBACK).handle; |
|
2 | 500 |
} |
501 |
/* Do not cache the de-referenced font2D. It must be explicitly |
|
502 |
* de-referenced to pick up a valid font in the event that the |
|
503 |
* original one is marked invalid |
|
504 |
*/ |
|
505 |
return font2DHandle.font2D; |
|
506 |
} |
|
507 |
||
508 |
/** |
|
509 |
* Creates a new <code>Font</code> from the specified name, style and |
|
510 |
* point size. |
|
511 |
* <p> |
|
512 |
* The font name can be a font face name or a font family name. |
|
513 |
* It is used together with the style to find an appropriate font face. |
|
514 |
* When a font family name is specified, the style argument is used to |
|
515 |
* select the most appropriate face from the family. When a font face |
|
516 |
* name is specified, the face's style and the style argument are |
|
517 |
* merged to locate the best matching font from the same family. |
|
518 |
* For example if face name "Arial Bold" is specified with style |
|
519 |
* <code>Font.ITALIC</code>, the font system looks for a face in the |
|
520 |
* "Arial" family that is bold and italic, and may associate the font |
|
521 |
* instance with the physical font face "Arial Bold Italic". |
|
522 |
* The style argument is merged with the specified face's style, not |
|
523 |
* added or subtracted. |
|
524 |
* This means, specifying a bold face and a bold style does not |
|
525 |
* double-embolden the font, and specifying a bold face and a plain |
|
526 |
* style does not lighten the font. |
|
527 |
* <p> |
|
528 |
* If no face for the requested style can be found, the font system |
|
529 |
* may apply algorithmic styling to achieve the desired style. |
|
530 |
* For example, if <code>ITALIC</code> is requested, but no italic |
|
531 |
* face is available, glyphs from the plain face may be algorithmically |
|
532 |
* obliqued (slanted). |
|
533 |
* <p> |
|
534 |
* Font name lookup is case insensitive, using the case folding |
|
535 |
* rules of the US locale. |
|
536 |
* <p> |
|
537 |
* If the <code>name</code> parameter represents something other than a |
|
538 |
* logical font, i.e. is interpreted as a physical font face or family, and |
|
539 |
* this cannot be mapped by the implementation to a physical font or a |
|
540 |
* compatible alternative, then the font system will map the Font |
|
541 |
* instance to "Dialog", such that for example, the family as reported |
|
542 |
* by {@link #getFamily() getFamily} will be "Dialog". |
|
543 |
* <p> |
|
544 |
* |
|
545 |
* @param name the font name. This can be a font face name or a font |
|
546 |
* family name, and may represent either a logical font or a physical |
|
547 |
* font found in this {@code GraphicsEnvironment}. |
|
548 |
* The family names for logical fonts are: Dialog, DialogInput, |
|
549 |
* Monospaced, Serif, or SansSerif. Pre-defined String constants exist |
|
550 |
* for all of these names, for example, {@code DIALOG}. If {@code name} is |
|
551 |
* {@code null}, the <em>logical font name</em> of the new |
|
552 |
* {@code Font} as returned by {@code getName()} is set to |
|
553 |
* the name "Default". |
|
554 |
* @param style the style constant for the {@code Font} |
|
555 |
* The style argument is an integer bitmask that may |
|
556 |
* be {@code PLAIN}, or a bitwise union of {@code BOLD} and/or |
|
557 |
* {@code ITALIC} (for example, {@code ITALIC} or {@code BOLD|ITALIC}). |
|
558 |
* If the style argument does not conform to one of the expected |
|
559 |
* integer bitmasks then the style is set to {@code PLAIN}. |
|
560 |
* @param size the point size of the {@code Font} |
|
561 |
* @see GraphicsEnvironment#getAllFonts |
|
562 |
* @see GraphicsEnvironment#getAvailableFontFamilyNames |
|
563 |
* @since JDK1.0 |
|
564 |
*/ |
|
565 |
public Font(String name, int style, int size) { |
|
566 |
this.name = (name != null) ? name : "Default"; |
|
567 |
this.style = (style & ~0x03) == 0 ? style : 0; |
|
568 |
this.size = size; |
|
569 |
this.pointSize = size; |
|
570 |
} |
|
571 |
||
572 |
private Font(String name, int style, float sizePts) { |
|
573 |
this.name = (name != null) ? name : "Default"; |
|
574 |
this.style = (style & ~0x03) == 0 ? style : 0; |
|
575 |
this.size = (int)(sizePts + 0.5); |
|
576 |
this.pointSize = sizePts; |
|
577 |
} |
|
578 |
||
579 |
/* This constructor is used by deriveFont when attributes is null */ |
|
580 |
private Font(String name, int style, float sizePts, |
|
581 |
boolean created, Font2DHandle handle) { |
|
582 |
this(name, style, sizePts); |
|
583 |
this.createdFont = created; |
|
584 |
/* Fonts created from a stream will use the same font2D instance |
|
585 |
* as the parent. |
|
586 |
* One exception is that if the derived font is requested to be |
|
587 |
* in a different style, then also check if its a CompositeFont |
|
588 |
* and if so build a new CompositeFont from components of that style. |
|
589 |
* CompositeFonts can only be marked as "created" if they are used |
|
590 |
* to add fall backs to a physical font. And non-composites are |
|
591 |
* always from "Font.createFont()" and shouldn't get this treatment. |
|
592 |
*/ |
|
593 |
if (created) { |
|
594 |
if (handle.font2D instanceof CompositeFont && |
|
595 |
handle.font2D.getStyle() != style) { |
|
3928 | 596 |
FontManager fm = FontManagerFactory.getInstance(); |
597 |
this.font2DHandle = fm.getNewComposite(null, style, handle); |
|
2 | 598 |
} else { |
599 |
this.font2DHandle = handle; |
|
600 |
} |
|
601 |
} |
|
602 |
} |
|
603 |
||
604 |
/* used to implement Font.createFont */ |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
605 |
private Font(File fontFile, int fontFormat, |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
606 |
boolean isCopy, CreatedFontTracker tracker) |
2 | 607 |
throws FontFormatException { |
608 |
this.createdFont = true; |
|
609 |
/* Font2D instances created by this method track their font file |
|
610 |
* so that when the Font2D is GC'd it can also remove the file. |
|
611 |
*/ |
|
3928 | 612 |
FontManager fm = FontManagerFactory.getInstance(); |
613 |
this.font2DHandle = fm.createFont2D(fontFile, fontFormat, isCopy, |
|
614 |
tracker).handle; |
|
2 | 615 |
this.name = this.font2DHandle.font2D.getFontName(Locale.getDefault()); |
616 |
this.style = Font.PLAIN; |
|
617 |
this.size = 1; |
|
618 |
this.pointSize = 1f; |
|
619 |
} |
|
620 |
||
621 |
/* This constructor is used when one font is derived from another. |
|
622 |
* Fonts created from a stream will use the same font2D instance as the |
|
623 |
* parent. They can be distinguished because the "created" argument |
|
624 |
* will be "true". Since there is no way to recreate these fonts they |
|
625 |
* need to have the handle to the underlying font2D passed in. |
|
626 |
* "created" is also true when a special composite is referenced by the |
|
627 |
* handle for essentially the same reasons. |
|
628 |
* But when deriving a font in these cases two particular attributes |
|
629 |
* need special attention: family/face and style. |
|
630 |
* The "composites" in these cases need to be recreated with optimal |
|
631 |
* fonts for the new values of family and style. |
|
632 |
* For fonts created with createFont() these are treated differently. |
|
633 |
* JDK can often synthesise a different style (bold from plain |
|
634 |
* for example). For fonts created with "createFont" this is a reasonable |
|
635 |
* solution but its also possible (although rare) to derive a font with a |
|
636 |
* different family attribute. In this case JDK needs |
|
637 |
* to break the tie with the original Font2D and find a new Font. |
|
638 |
* The oldName and oldStyle are supplied so they can be compared with |
|
639 |
* what the Font2D and the values. To speed things along : |
|
640 |
* oldName == null will be interpreted as the name is unchanged. |
|
641 |
* oldStyle = -1 will be interpreted as the style is unchanged. |
|
642 |
* In these cases there is no need to interrogate "values". |
|
643 |
*/ |
|
644 |
private Font(AttributeValues values, String oldName, int oldStyle, |
|
645 |
boolean created, Font2DHandle handle) { |
|
646 |
||
647 |
this.createdFont = created; |
|
648 |
if (created) { |
|
649 |
this.font2DHandle = handle; |
|
650 |
||
651 |
String newName = null; |
|
652 |
if (oldName != null) { |
|
653 |
newName = values.getFamily(); |
|
654 |
if (oldName.equals(newName)) newName = null; |
|
655 |
} |
|
656 |
int newStyle = 0; |
|
657 |
if (oldStyle == -1) { |
|
658 |
newStyle = -1; |
|
659 |
} else { |
|
660 |
if (values.getWeight() >= 2f) newStyle = BOLD; |
|
661 |
if (values.getPosture() >= .2f) newStyle |= ITALIC; |
|
662 |
if (oldStyle == newStyle) newStyle = -1; |
|
663 |
} |
|
664 |
if (handle.font2D instanceof CompositeFont) { |
|
665 |
if (newStyle != -1 || newName != null) { |
|
3928 | 666 |
FontManager fm = FontManagerFactory.getInstance(); |
2 | 667 |
this.font2DHandle = |
3928 | 668 |
fm.getNewComposite(newName, newStyle, handle); |
2 | 669 |
} |
670 |
} else if (newName != null) { |
|
671 |
this.createdFont = false; |
|
672 |
this.font2DHandle = null; |
|
673 |
} |
|
674 |
} |
|
675 |
initFromValues(values); |
|
676 |
} |
|
677 |
||
678 |
/** |
|
679 |
* Creates a new <code>Font</code> with the specified attributes. |
|
680 |
* Only keys defined in {@link java.awt.font.TextAttribute TextAttribute} |
|
681 |
* are recognized. In addition the FONT attribute is |
|
682 |
* not recognized by this constructor |
|
683 |
* (see {@link #getAvailableAttributes}). Only attributes that have |
|
684 |
* values of valid types will affect the new <code>Font</code>. |
|
685 |
* <p> |
|
686 |
* If <code>attributes</code> is <code>null</code>, a new |
|
687 |
* <code>Font</code> is initialized with default values. |
|
688 |
* @see java.awt.font.TextAttribute |
|
689 |
* @param attributes the attributes to assign to the new |
|
690 |
* <code>Font</code>, or <code>null</code> |
|
691 |
*/ |
|
692 |
public Font(Map<? extends Attribute, ?> attributes) { |
|
693 |
initFromValues(AttributeValues.fromMap(attributes, RECOGNIZED_MASK)); |
|
694 |
} |
|
695 |
||
696 |
/** |
|
697 |
* Creates a new <code>Font</code> from the specified <code>font</code>. |
|
698 |
* This constructor is intended for use by subclasses. |
|
699 |
* @param font from which to create this <code>Font</code>. |
|
700 |
* @throws NullPointerException if <code>font</code> is null |
|
701 |
* @since 1.6 |
|
702 |
*/ |
|
703 |
protected Font(Font font) { |
|
704 |
if (font.values != null) { |
|
705 |
initFromValues(font.getAttributeValues().clone()); |
|
706 |
} else { |
|
707 |
this.name = font.name; |
|
708 |
this.style = font.style; |
|
709 |
this.size = font.size; |
|
710 |
this.pointSize = font.pointSize; |
|
711 |
} |
|
712 |
this.font2DHandle = font.font2DHandle; |
|
713 |
this.createdFont = font.createdFont; |
|
714 |
} |
|
715 |
||
716 |
/** |
|
717 |
* Font recognizes all attributes except FONT. |
|
718 |
*/ |
|
719 |
private static final int RECOGNIZED_MASK = AttributeValues.MASK_ALL |
|
720 |
& ~AttributeValues.getMask(EFONT); |
|
721 |
||
722 |
/** |
|
723 |
* These attributes are considered primary by the FONT attribute. |
|
724 |
*/ |
|
725 |
private static final int PRIMARY_MASK = |
|
726 |
AttributeValues.getMask(EFAMILY, EWEIGHT, EWIDTH, EPOSTURE, ESIZE, |
|
727 |
ETRANSFORM, ESUPERSCRIPT, ETRACKING); |
|
728 |
||
729 |
/** |
|
730 |
* These attributes are considered secondary by the FONT attribute. |
|
731 |
*/ |
|
732 |
private static final int SECONDARY_MASK = |
|
733 |
RECOGNIZED_MASK & ~PRIMARY_MASK; |
|
734 |
||
735 |
/** |
|
736 |
* These attributes are handled by layout. |
|
737 |
*/ |
|
738 |
private static final int LAYOUT_MASK = |
|
739 |
AttributeValues.getMask(ECHAR_REPLACEMENT, EFOREGROUND, EBACKGROUND, |
|
740 |
EUNDERLINE, ESTRIKETHROUGH, ERUN_DIRECTION, |
|
741 |
EBIDI_EMBEDDING, EJUSTIFICATION, |
|
742 |
EINPUT_METHOD_HIGHLIGHT, EINPUT_METHOD_UNDERLINE, |
|
743 |
ESWAP_COLORS, ENUMERIC_SHAPING, EKERNING, |
|
534
be8500bc69b2
6684056: SUPERSCRIPT TextAttribute on font needs to trigger layout.
prr
parents:
2
diff
changeset
|
744 |
ELIGATURES, ETRACKING, ESUPERSCRIPT); |
2 | 745 |
|
746 |
private static final int EXTRA_MASK = |
|
747 |
AttributeValues.getMask(ETRANSFORM, ESUPERSCRIPT, EWIDTH); |
|
748 |
||
749 |
/** |
|
750 |
* Initialize the standard Font fields from the values object. |
|
751 |
*/ |
|
752 |
private void initFromValues(AttributeValues values) { |
|
753 |
this.values = values; |
|
754 |
values.defineAll(PRIMARY_MASK); // for 1.5 streaming compatibility |
|
755 |
||
756 |
this.name = values.getFamily(); |
|
757 |
this.pointSize = values.getSize(); |
|
758 |
this.size = (int)(values.getSize() + 0.5); |
|
759 |
if (values.getWeight() >= 2f) this.style |= BOLD; // not == 2f |
|
760 |
if (values.getPosture() >= .2f) this.style |= ITALIC; // not == .2f |
|
761 |
||
762 |
this.nonIdentityTx = values.anyNonDefault(EXTRA_MASK); |
|
763 |
this.hasLayoutAttributes = values.anyNonDefault(LAYOUT_MASK); |
|
764 |
} |
|
765 |
||
766 |
/** |
|
767 |
* Returns a <code>Font</code> appropriate to the attributes. |
|
768 |
* If <code>attributes</code>contains a <code>FONT</code> attribute |
|
769 |
* with a valid <code>Font</code> as its value, it will be |
|
770 |
* merged with any remaining attributes. See |
|
771 |
* {@link java.awt.font.TextAttribute#FONT} for more |
|
772 |
* information. |
|
773 |
* |
|
774 |
* @param attributes the attributes to assign to the new |
|
775 |
* <code>Font</code> |
|
776 |
* @return a new <code>Font</code> created with the specified |
|
777 |
* attributes |
|
778 |
* @throws NullPointerException if <code>attributes</code> is null. |
|
779 |
* @since 1.2 |
|
780 |
* @see java.awt.font.TextAttribute |
|
781 |
*/ |
|
782 |
public static Font getFont(Map<? extends Attribute, ?> attributes) { |
|
783 |
// optimize for two cases: |
|
784 |
// 1) FONT attribute, and nothing else |
|
785 |
// 2) attributes, but no FONT |
|
786 |
||
787 |
// avoid turning the attributemap into a regular map for no reason |
|
788 |
if (attributes instanceof AttributeMap && |
|
789 |
((AttributeMap)attributes).getValues() != null) { |
|
790 |
AttributeValues values = ((AttributeMap)attributes).getValues(); |
|
791 |
if (values.isNonDefault(EFONT)) { |
|
792 |
Font font = values.getFont(); |
|
793 |
if (!values.anyDefined(SECONDARY_MASK)) { |
|
794 |
return font; |
|
795 |
} |
|
796 |
// merge |
|
797 |
values = font.getAttributeValues().clone(); |
|
798 |
values.merge(attributes, SECONDARY_MASK); |
|
799 |
return new Font(values, font.name, font.style, |
|
800 |
font.createdFont, font.font2DHandle); |
|
801 |
} |
|
802 |
return new Font(attributes); |
|
803 |
} |
|
804 |
||
805 |
Font font = (Font)attributes.get(TextAttribute.FONT); |
|
806 |
if (font != null) { |
|
807 |
if (attributes.size() > 1) { // oh well, check for anything else |
|
808 |
AttributeValues values = font.getAttributeValues().clone(); |
|
809 |
values.merge(attributes, SECONDARY_MASK); |
|
810 |
return new Font(values, font.name, font.style, |
|
811 |
font.createdFont, font.font2DHandle); |
|
812 |
} |
|
813 |
||
814 |
return font; |
|
815 |
} |
|
816 |
||
817 |
return new Font(attributes); |
|
818 |
} |
|
819 |
||
820 |
/** |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
821 |
* Used with the byte count tracker for fonts created from streams. |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
822 |
* If a thread can create temp files anyway, no point in counting |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
823 |
* font bytes. |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
824 |
*/ |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
825 |
private static boolean hasTempPermission() { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
826 |
|
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
827 |
if (System.getSecurityManager() == null) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
828 |
return true; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
829 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
830 |
File f = null; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
831 |
boolean hasPerm = false; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
832 |
try { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
833 |
f = File.createTempFile("+~JT", ".tmp", null); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
834 |
f.delete(); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
835 |
f = null; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
836 |
hasPerm = true; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
837 |
} catch (Throwable t) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
838 |
/* inc. any kind of SecurityException */ |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
839 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
840 |
return hasPerm; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
841 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
842 |
|
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
843 |
/** |
2 | 844 |
* Returns a new <code>Font</code> using the specified font type |
845 |
* and input data. The new <code>Font</code> is |
|
846 |
* created with a point size of 1 and style {@link #PLAIN PLAIN}. |
|
847 |
* This base font can then be used with the <code>deriveFont</code> |
|
848 |
* methods in this class to derive new <code>Font</code> objects with |
|
849 |
* varying sizes, styles, transforms and font features. This |
|
850 |
* method does not close the {@link InputStream}. |
|
851 |
* <p> |
|
852 |
* To make the <code>Font</code> available to Font constructors the |
|
853 |
* returned <code>Font</code> must be registered in the |
|
854 |
* <code>GraphicsEnviroment</code> by calling |
|
855 |
* {@link GraphicsEnvironment#registerFont(Font) registerFont(Font)}. |
|
856 |
* @param fontFormat the type of the <code>Font</code>, which is |
|
857 |
* {@link #TRUETYPE_FONT TRUETYPE_FONT} if a TrueType resource is specified. |
|
858 |
* or {@link #TYPE1_FONT TYPE1_FONT} if a Type 1 resource is specified. |
|
859 |
* @param fontStream an <code>InputStream</code> object representing the |
|
860 |
* input data for the font. |
|
861 |
* @return a new <code>Font</code> created with the specified font type. |
|
862 |
* @throws IllegalArgumentException if <code>fontFormat</code> is not |
|
863 |
* <code>TRUETYPE_FONT</code>or<code>TYPE1_FONT</code>. |
|
864 |
* @throws FontFormatException if the <code>fontStream</code> data does |
|
865 |
* not contain the required font tables for the specified format. |
|
866 |
* @throws IOException if the <code>fontStream</code> |
|
867 |
* cannot be completely read. |
|
868 |
* @see GraphicsEnvironment#registerFont(Font) |
|
869 |
* @since 1.3 |
|
870 |
*/ |
|
871 |
public static Font createFont(int fontFormat, InputStream fontStream) |
|
872 |
throws java.awt.FontFormatException, java.io.IOException { |
|
873 |
||
874 |
if (fontFormat != Font.TRUETYPE_FONT && |
|
875 |
fontFormat != Font.TYPE1_FONT) { |
|
876 |
throw new IllegalArgumentException ("font format not recognized"); |
|
877 |
} |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
878 |
boolean copiedFontData = false; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
879 |
try { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
880 |
final File tFile = AccessController.doPrivileged( |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
881 |
new PrivilegedExceptionAction<File>() { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
882 |
public File run() throws IOException { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
883 |
return File.createTempFile("+~JF", ".tmp", null); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
884 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
885 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
886 |
); |
2 | 887 |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
888 |
int totalSize = 0; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
889 |
CreatedFontTracker tracker = null; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
890 |
try { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
891 |
final OutputStream outStream = |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
892 |
AccessController.doPrivileged( |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
893 |
new PrivilegedExceptionAction<OutputStream>() { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
894 |
public OutputStream run() throws IOException { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
895 |
return new FileOutputStream(tFile); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
896 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
897 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
898 |
); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
899 |
if (!hasTempPermission()) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
900 |
tracker = CreatedFontTracker.getTracker(); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
901 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
902 |
try { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
903 |
byte[] buf = new byte[8192]; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
904 |
for (;;) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
905 |
int bytesRead = fontStream.read(buf); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
906 |
if (bytesRead < 0) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
907 |
break; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
908 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
909 |
if (tracker != null) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
910 |
if (totalSize+bytesRead > tracker.MAX_FILE_SIZE) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
911 |
throw new IOException("File too big."); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
912 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
913 |
if (totalSize+tracker.getNumBytes() > |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
914 |
tracker.MAX_TOTAL_BYTES) |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
915 |
{ |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
916 |
throw new IOException("Total files too big."); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
917 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
918 |
totalSize += bytesRead; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
919 |
tracker.addBytes(bytesRead); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
920 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
921 |
outStream.write(buf, 0, bytesRead); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
922 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
923 |
/* don't close the input stream */ |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
924 |
} finally { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
925 |
outStream.close(); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
926 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
927 |
/* After all references to a Font2D are dropped, the file |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
928 |
* will be removed. To support long-lived AppContexts, |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
929 |
* we need to then decrement the byte count by the size |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
930 |
* of the file. |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
931 |
* If the data isn't a valid font, the implementation will |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
932 |
* delete the tmp file and decrement the byte count |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
933 |
* in the tracker object before returning from the |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
934 |
* constructor, so we can set 'copiedFontData' to true here |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
935 |
* without waiting for the results of that constructor. |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
936 |
*/ |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
937 |
copiedFontData = true; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
938 |
Font font = new Font(tFile, fontFormat, true, tracker); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
939 |
return font; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
940 |
} finally { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
941 |
if (!copiedFontData) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
942 |
if (tracker != null) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
943 |
tracker.subBytes(totalSize); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
944 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
945 |
AccessController.doPrivileged( |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
946 |
new PrivilegedExceptionAction<Void>() { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
947 |
public Void run() { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
948 |
tFile.delete(); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
949 |
return null; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
950 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
951 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
952 |
); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
953 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
954 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
955 |
} catch (Throwable t) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
956 |
if (t instanceof FontFormatException) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
957 |
throw (FontFormatException)t; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
958 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
959 |
if (t instanceof IOException) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
960 |
throw (IOException)t; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
961 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
962 |
Throwable cause = t.getCause(); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
963 |
if (cause instanceof FontFormatException) { |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
964 |
throw (FontFormatException)cause; |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
965 |
} |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
966 |
throw new IOException("Problem reading font data."); |
2 | 967 |
} |
968 |
} |
|
969 |
||
970 |
/** |
|
971 |
* Returns a new <code>Font</code> using the specified font type |
|
972 |
* and the specified font file. The new <code>Font</code> is |
|
973 |
* created with a point size of 1 and style {@link #PLAIN PLAIN}. |
|
974 |
* This base font can then be used with the <code>deriveFont</code> |
|
975 |
* methods in this class to derive new <code>Font</code> objects with |
|
976 |
* varying sizes, styles, transforms and font features. |
|
977 |
* @param fontFormat the type of the <code>Font</code>, which is |
|
978 |
* {@link #TRUETYPE_FONT TRUETYPE_FONT} if a TrueType resource is |
|
979 |
* specified or {@link #TYPE1_FONT TYPE1_FONT} if a Type 1 resource is |
|
980 |
* specified. |
|
981 |
* So long as the returned font, or its derived fonts are referenced |
|
982 |
* the implementation may continue to access <code>fontFile</code> |
|
983 |
* to retrieve font data. Thus the results are undefined if the file |
|
984 |
* is changed, or becomes inaccessible. |
|
985 |
* <p> |
|
986 |
* To make the <code>Font</code> available to Font constructors the |
|
987 |
* returned <code>Font</code> must be registered in the |
|
988 |
* <code>GraphicsEnviroment</code> by calling |
|
989 |
* {@link GraphicsEnvironment#registerFont(Font) registerFont(Font)}. |
|
990 |
* @param fontFile a <code>File</code> object representing the |
|
991 |
* input data for the font. |
|
992 |
* @return a new <code>Font</code> created with the specified font type. |
|
993 |
* @throws IllegalArgumentException if <code>fontFormat</code> is not |
|
994 |
* <code>TRUETYPE_FONT</code>or<code>TYPE1_FONT</code>. |
|
995 |
* @throws NullPointerException if <code>fontFile</code> is null. |
|
996 |
* @throws IOException if the <code>fontFile</code> cannot be read. |
|
997 |
* @throws FontFormatException if <code>fontFile</code> does |
|
998 |
* not contain the required font tables for the specified format. |
|
999 |
* @throws SecurityException if the executing code does not have |
|
1000 |
* permission to read from the file. |
|
1001 |
* @see GraphicsEnvironment#registerFont(Font) |
|
1002 |
* @since 1.5 |
|
1003 |
*/ |
|
1004 |
public static Font createFont(int fontFormat, File fontFile) |
|
1005 |
throws java.awt.FontFormatException, java.io.IOException { |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
1006 |
|
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
1007 |
fontFile = new File(fontFile.getPath()); |
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
1008 |
|
2 | 1009 |
if (fontFormat != Font.TRUETYPE_FONT && |
1010 |
fontFormat != Font.TYPE1_FONT) { |
|
1011 |
throw new IllegalArgumentException ("font format not recognized"); |
|
1012 |
} |
|
1013 |
SecurityManager sm = System.getSecurityManager(); |
|
1014 |
if (sm != null) { |
|
1015 |
FilePermission filePermission = |
|
1016 |
new FilePermission(fontFile.getPath(), "read"); |
|
1017 |
sm.checkPermission(filePermission); |
|
1018 |
} |
|
1019 |
if (!fontFile.canRead()) { |
|
1020 |
throw new IOException("Can't read " + fontFile); |
|
1021 |
} |
|
2606
09ad5edb5330
6632886: Font.createFont can be persuaded to leak temporary files
prr
parents:
547
diff
changeset
|
1022 |
return new Font(fontFile, fontFormat, false, null); |
2 | 1023 |
} |
1024 |
||
1025 |
/** |
|
1026 |
* Returns a copy of the transform associated with this |
|
1027 |
* <code>Font</code>. This transform is not necessarily the one |
|
1028 |
* used to construct the font. If the font has algorithmic |
|
1029 |
* superscripting or width adjustment, this will be incorporated |
|
1030 |
* into the returned <code>AffineTransform</code>. |
|
1031 |
* <p> |
|
1032 |
* Typically, fonts will not be transformed. Clients generally |
|
1033 |
* should call {@link #isTransformed} first, and only call this |
|
1034 |
* method if <code>isTransformed</code> returns true. |
|
1035 |
* |
|
1036 |
* @return an {@link AffineTransform} object representing the |
|
1037 |
* transform attribute of this <code>Font</code> object. |
|
1038 |
*/ |
|
1039 |
public AffineTransform getTransform() { |
|
1040 |
/* The most common case is the identity transform. Most callers |
|
1041 |
* should call isTransformed() first, to decide if they need to |
|
1042 |
* get the transform, but some may not. Here we check to see |
|
1043 |
* if we have a nonidentity transform, and only do the work to |
|
1044 |
* fetch and/or compute it if so, otherwise we return a new |
|
1045 |
* identity transform. |
|
1046 |
* |
|
1047 |
* Note that the transform is _not_ necessarily the same as |
|
1048 |
* the transform passed in as an Attribute in a Map, as the |
|
1049 |
* transform returned will also reflect the effects of WIDTH and |
|
1050 |
* SUPERSCRIPT attributes. Clients who want the actual transform |
|
1051 |
* need to call getRequestedAttributes. |
|
1052 |
*/ |
|
1053 |
if (nonIdentityTx) { |
|
1054 |
AttributeValues values = getAttributeValues(); |
|
1055 |
||
1056 |
AffineTransform at = values.isNonDefault(ETRANSFORM) |
|
1057 |
? new AffineTransform(values.getTransform()) |
|
1058 |
: new AffineTransform(); |
|
1059 |
||
1060 |
if (values.getSuperscript() != 0) { |
|
1061 |
// can't get ascent and descent here, recursive call to this fn, |
|
1062 |
// so use pointsize |
|
1063 |
// let users combine super- and sub-scripting |
|
1064 |
||
1065 |
int superscript = values.getSuperscript(); |
|
1066 |
||
1067 |
double trans = 0; |
|
1068 |
int n = 0; |
|
1069 |
boolean up = superscript > 0; |
|
1070 |
int sign = up ? -1 : 1; |
|
1071 |
int ss = up ? superscript : -superscript; |
|
1072 |
||
1073 |
while ((ss & 7) > n) { |
|
1074 |
int newn = ss & 7; |
|
1075 |
trans += sign * (ssinfo[newn] - ssinfo[n]); |
|
1076 |
ss >>= 3; |
|
1077 |
sign = -sign; |
|
1078 |
n = newn; |
|
1079 |
} |
|
1080 |
trans *= pointSize; |
|
1081 |
double scale = Math.pow(2./3., n); |
|
1082 |
||
1083 |
at.preConcatenate(AffineTransform.getTranslateInstance(0, trans)); |
|
1084 |
at.scale(scale, scale); |
|
1085 |
||
1086 |
// note on placement and italics |
|
1087 |
// We preconcatenate the transform because we don't want to translate along |
|
1088 |
// the italic angle, but purely perpendicular to the baseline. While this |
|
1089 |
// looks ok for superscripts, it can lead subscripts to stack on each other |
|
1090 |
// and bring the following text too close. The way we deal with potential |
|
1091 |
// collisions that can occur in the case of italics is by adjusting the |
|
1092 |
// horizontal spacing of the adjacent glyphvectors. Examine the italic |
|
1093 |
// angle of both vectors, if one is non-zero, compute the minimum ascent |
|
1094 |
// and descent, and then the x position at each for each vector along its |
|
1095 |
// italic angle starting from its (offset) baseline. Compute the difference |
|
1096 |
// between the x positions and use the maximum difference to adjust the |
|
1097 |
// position of the right gv. |
|
1098 |
} |
|
1099 |
||
1100 |
if (values.isNonDefault(EWIDTH)) { |
|
1101 |
at.scale(values.getWidth(), 1f); |
|
1102 |
} |
|
1103 |
||
1104 |
return at; |
|
1105 |
} |
|
1106 |
||
1107 |
return new AffineTransform(); |
|
1108 |
} |
|
1109 |
||
1110 |
// x = r^0 + r^1 + r^2... r^n |
|
1111 |
// rx = r^1 + r^2 + r^3... r^(n+1) |
|
1112 |
// x - rx = r^0 - r^(n+1) |
|
1113 |
// x (1 - r) = r^0 - r^(n+1) |
|
1114 |
// x = (r^0 - r^(n+1)) / (1 - r) |
|
1115 |
// x = (1 - r^(n+1)) / (1 - r) |
|
1116 |
||
1117 |
// scale ratio is 2/3 |
|
1118 |
// trans = 1/2 of ascent * x |
|
1119 |
// assume ascent is 3/4 of point size |
|
1120 |
||
1121 |
private static final float[] ssinfo = { |
|
1122 |
0.0f, |
|
1123 |
0.375f, |
|
1124 |
0.625f, |
|
1125 |
0.7916667f, |
|
1126 |
0.9027778f, |
|
1127 |
0.9768519f, |
|
1128 |
1.0262346f, |
|
1129 |
1.0591564f, |
|
1130 |
}; |
|
1131 |
||
1132 |
/** |
|
1133 |
* Returns the family name of this <code>Font</code>. |
|
1134 |
* |
|
1135 |
* <p>The family name of a font is font specific. Two fonts such as |
|
1136 |
* Helvetica Italic and Helvetica Bold have the same family name, |
|
1137 |
* <i>Helvetica</i>, whereas their font face names are |
|
1138 |
* <i>Helvetica Bold</i> and <i>Helvetica Italic</i>. The list of |
|
1139 |
* available family names may be obtained by using the |
|
1140 |
* {@link GraphicsEnvironment#getAvailableFontFamilyNames()} method. |
|
1141 |
* |
|
1142 |
* <p>Use <code>getName</code> to get the logical name of the font. |
|
1143 |
* Use <code>getFontName</code> to get the font face name of the font. |
|
1144 |
* @return a <code>String</code> that is the family name of this |
|
1145 |
* <code>Font</code>. |
|
1146 |
* |
|
1147 |
* @see #getName |
|
1148 |
* @see #getFontName |
|
1149 |
* @since JDK1.1 |
|
1150 |
*/ |
|
1151 |
public String getFamily() { |
|
1152 |
return getFamily_NoClientCode(); |
|
1153 |
} |
|
1154 |
// NOTE: This method is called by privileged threads. |
|
1155 |
// We implement this functionality in a package-private |
|
1156 |
// method to insure that it cannot be overridden by client |
|
1157 |
// subclasses. |
|
1158 |
// DO NOT INVOKE CLIENT CODE ON THIS THREAD! |
|
1159 |
final String getFamily_NoClientCode() { |
|
1160 |
return getFamily(Locale.getDefault()); |
|
1161 |
} |
|
1162 |
||
1163 |
/** |
|
1164 |
* Returns the family name of this <code>Font</code>, localized for |
|
1165 |
* the specified locale. |
|
1166 |
* |
|
1167 |
* <p>The family name of a font is font specific. Two fonts such as |
|
1168 |
* Helvetica Italic and Helvetica Bold have the same family name, |
|
1169 |
* <i>Helvetica</i>, whereas their font face names are |
|
1170 |
* <i>Helvetica Bold</i> and <i>Helvetica Italic</i>. The list of |
|
1171 |
* available family names may be obtained by using the |
|
1172 |
* {@link GraphicsEnvironment#getAvailableFontFamilyNames()} method. |
|
1173 |
* |
|
1174 |
* <p>Use <code>getFontName</code> to get the font face name of the font. |
|
1175 |
* @param l locale for which to get the family name |
|
1176 |
* @return a <code>String</code> representing the family name of the |
|
1177 |
* font, localized for the specified locale. |
|
1178 |
* @see #getFontName |
|
1179 |
* @see java.util.Locale |
|
1180 |
* @since 1.2 |
|
1181 |
*/ |
|
1182 |
public String getFamily(Locale l) { |
|
1183 |
if (l == null) { |
|
1184 |
throw new NullPointerException("null locale doesn't mean default"); |
|
1185 |
} |
|
1186 |
return getFont2D().getFamilyName(l); |
|
1187 |
} |
|
1188 |
||
1189 |
/** |
|
1190 |
* Returns the postscript name of this <code>Font</code>. |
|
1191 |
* Use <code>getFamily</code> to get the family name of the font. |
|
1192 |
* Use <code>getFontName</code> to get the font face name of the font. |
|
1193 |
* @return a <code>String</code> representing the postscript name of |
|
1194 |
* this <code>Font</code>. |
|
1195 |
* @since 1.2 |
|
1196 |
*/ |
|
1197 |
public String getPSName() { |
|
1198 |
return getFont2D().getPostscriptName(); |
|
1199 |
} |
|
1200 |
||
1201 |
/** |
|
1202 |
* Returns the logical name of this <code>Font</code>. |
|
1203 |
* Use <code>getFamily</code> to get the family name of the font. |
|
1204 |
* Use <code>getFontName</code> to get the font face name of the font. |
|
1205 |
* @return a <code>String</code> representing the logical name of |
|
1206 |
* this <code>Font</code>. |
|
1207 |
* @see #getFamily |
|
1208 |
* @see #getFontName |
|
1209 |
* @since JDK1.0 |
|
1210 |
*/ |
|
1211 |
public String getName() { |
|
1212 |
return name; |
|
1213 |
} |
|
1214 |
||
1215 |
/** |
|
1216 |
* Returns the font face name of this <code>Font</code>. For example, |
|
1217 |
* Helvetica Bold could be returned as a font face name. |
|
1218 |
* Use <code>getFamily</code> to get the family name of the font. |
|
1219 |
* Use <code>getName</code> to get the logical name of the font. |
|
1220 |
* @return a <code>String</code> representing the font face name of |
|
1221 |
* this <code>Font</code>. |
|
1222 |
* @see #getFamily |
|
1223 |
* @see #getName |
|
1224 |
* @since 1.2 |
|
1225 |
*/ |
|
1226 |
public String getFontName() { |
|
1227 |
return getFontName(Locale.getDefault()); |
|
1228 |
} |
|
1229 |
||
1230 |
/** |
|
1231 |
* Returns the font face name of the <code>Font</code>, localized |
|
1232 |
* for the specified locale. For example, Helvetica Fett could be |
|
1233 |
* returned as the font face name. |
|
1234 |
* Use <code>getFamily</code> to get the family name of the font. |
|
1235 |
* @param l a locale for which to get the font face name |
|
1236 |
* @return a <code>String</code> representing the font face name, |
|
1237 |
* localized for the specified locale. |
|
1238 |
* @see #getFamily |
|
1239 |
* @see java.util.Locale |
|
1240 |
*/ |
|
1241 |
public String getFontName(Locale l) { |
|
1242 |
if (l == null) { |
|
1243 |
throw new NullPointerException("null locale doesn't mean default"); |
|
1244 |
} |
|
1245 |
return getFont2D().getFontName(l); |
|
1246 |
} |
|
1247 |
||
1248 |
/** |
|
1249 |
* Returns the style of this <code>Font</code>. The style can be |
|
1250 |
* PLAIN, BOLD, ITALIC, or BOLD+ITALIC. |
|
1251 |
* @return the style of this <code>Font</code> |
|
1252 |
* @see #isPlain |
|
1253 |
* @see #isBold |
|
1254 |
* @see #isItalic |
|
1255 |
* @since JDK1.0 |
|
1256 |
*/ |
|
1257 |
public int getStyle() { |
|
1258 |
return style; |
|
1259 |
} |
|
1260 |
||
1261 |
/** |
|
1262 |
* Returns the point size of this <code>Font</code>, rounded to |
|
1263 |
* an integer. |
|
1264 |
* Most users are familiar with the idea of using <i>point size</i> to |
|
1265 |
* specify the size of glyphs in a font. This point size defines a |
|
1266 |
* measurement between the baseline of one line to the baseline of the |
|
1267 |
* following line in a single spaced text document. The point size is |
|
1268 |
* based on <i>typographic points</i>, approximately 1/72 of an inch. |
|
1269 |
* <p> |
|
1270 |
* The Java(tm)2D API adopts the convention that one point is |
|
1271 |
* equivalent to one unit in user coordinates. When using a |
|
1272 |
* normalized transform for converting user space coordinates to |
|
1273 |
* device space coordinates 72 user |
|
1274 |
* space units equal 1 inch in device space. In this case one point |
|
1275 |
* is 1/72 of an inch. |
|
1276 |
* @return the point size of this <code>Font</code> in 1/72 of an |
|
1277 |
* inch units. |
|
1278 |
* @see #getSize2D |
|
1279 |
* @see GraphicsConfiguration#getDefaultTransform |
|
1280 |
* @see GraphicsConfiguration#getNormalizingTransform |
|
1281 |
* @since JDK1.0 |
|
1282 |
*/ |
|
1283 |
public int getSize() { |
|
1284 |
return size; |
|
1285 |
} |
|
1286 |
||
1287 |
/** |
|
1288 |
* Returns the point size of this <code>Font</code> in |
|
1289 |
* <code>float</code> value. |
|
1290 |
* @return the point size of this <code>Font</code> as a |
|
1291 |
* <code>float</code> value. |
|
1292 |
* @see #getSize |
|
1293 |
* @since 1.2 |
|
1294 |
*/ |
|
1295 |
public float getSize2D() { |
|
1296 |
return pointSize; |
|
1297 |
} |
|
1298 |
||
1299 |
/** |
|
1300 |
* Indicates whether or not this <code>Font</code> object's style is |
|
1301 |
* PLAIN. |
|
1302 |
* @return <code>true</code> if this <code>Font</code> has a |
|
1303 |
* PLAIN sytle; |
|
1304 |
* <code>false</code> otherwise. |
|
1305 |
* @see java.awt.Font#getStyle |
|
1306 |
* @since JDK1.0 |
|
1307 |
*/ |
|
1308 |
public boolean isPlain() { |
|
1309 |
return style == 0; |
|
1310 |
} |
|
1311 |
||
1312 |
/** |
|
1313 |
* Indicates whether or not this <code>Font</code> object's style is |
|
1314 |
* BOLD. |
|
1315 |
* @return <code>true</code> if this <code>Font</code> object's |
|
1316 |
* style is BOLD; |
|
1317 |
* <code>false</code> otherwise. |
|
1318 |
* @see java.awt.Font#getStyle |
|
1319 |
* @since JDK1.0 |
|
1320 |
*/ |
|
1321 |
public boolean isBold() { |
|
1322 |
return (style & BOLD) != 0; |
|
1323 |
} |
|
1324 |
||
1325 |
/** |
|
1326 |
* Indicates whether or not this <code>Font</code> object's style is |
|
1327 |
* ITALIC. |
|
1328 |
* @return <code>true</code> if this <code>Font</code> object's |
|
1329 |
* style is ITALIC; |
|
1330 |
* <code>false</code> otherwise. |
|
1331 |
* @see java.awt.Font#getStyle |
|
1332 |
* @since JDK1.0 |
|
1333 |
*/ |
|
1334 |
public boolean isItalic() { |
|
1335 |
return (style & ITALIC) != 0; |
|
1336 |
} |
|
1337 |
||
1338 |
/** |
|
1339 |
* Indicates whether or not this <code>Font</code> object has a |
|
1340 |
* transform that affects its size in addition to the Size |
|
1341 |
* attribute. |
|
1342 |
* @return <code>true</code> if this <code>Font</code> object |
|
1343 |
* has a non-identity AffineTransform attribute. |
|
1344 |
* <code>false</code> otherwise. |
|
1345 |
* @see java.awt.Font#getTransform |
|
1346 |
* @since 1.4 |
|
1347 |
*/ |
|
1348 |
public boolean isTransformed() { |
|
1349 |
return nonIdentityTx; |
|
1350 |
} |
|
1351 |
||
1352 |
/** |
|
1353 |
* Return true if this Font contains attributes that require extra |
|
1354 |
* layout processing. |
|
1355 |
* @return true if the font has layout attributes |
|
1356 |
* @since 1.6 |
|
1357 |
*/ |
|
1358 |
public boolean hasLayoutAttributes() { |
|
1359 |
return hasLayoutAttributes; |
|
1360 |
} |
|
1361 |
||
1362 |
/** |
|
1363 |
* Returns a <code>Font</code> object from the system properties list. |
|
1364 |
* <code>nm</code> is treated as the name of a system property to be |
|
1365 |
* obtained. The <code>String</code> value of this property is then |
|
1366 |
* interpreted as a <code>Font</code> object according to the |
|
1367 |
* specification of <code>Font.decode(String)</code> |
|
1368 |
* If the specified property is not found, or the executing code does |
|
1369 |
* not have permission to read the property, null is returned instead. |
|
1370 |
* |
|
1371 |
* @param nm the property name |
|
1372 |
* @return a <code>Font</code> object that the property name |
|
1373 |
* describes, or null if no such property exists. |
|
1374 |
* @throws NullPointerException if nm is null. |
|
1375 |
* @since 1.2 |
|
1376 |
* @see #decode(String) |
|
1377 |
*/ |
|
1378 |
public static Font getFont(String nm) { |
|
1379 |
return getFont(nm, null); |
|
1380 |
} |
|
1381 |
||
1382 |
/** |
|
1383 |
* Returns the <code>Font</code> that the <code>str</code> |
|
1384 |
* argument describes. |
|
1385 |
* To ensure that this method returns the desired Font, |
|
1386 |
* format the <code>str</code> parameter in |
|
1387 |
* one of these ways |
|
1388 |
* <p> |
|
1389 |
* <ul> |
|
1390 |
* <li><em>fontname-style-pointsize</em> |
|
1391 |
* <li><em>fontname-pointsize</em> |
|
1392 |
* <li><em>fontname-style</em> |
|
1393 |
* <li><em>fontname</em> |
|
1394 |
* <li><em>fontname style pointsize</em> |
|
1395 |
* <li><em>fontname pointsize</em> |
|
1396 |
* <li><em>fontname style</em> |
|
1397 |
* <li><em>fontname</em> |
|
1398 |
* </ul> |
|
1399 |
* in which <i>style</i> is one of the four |
|
1400 |
* case-insensitive strings: |
|
1401 |
* <code>"PLAIN"</code>, <code>"BOLD"</code>, <code>"BOLDITALIC"</code>, or |
|
1402 |
* <code>"ITALIC"</code>, and pointsize is a positive decimal integer |
|
1403 |
* representation of the point size. |
|
1404 |
* For example, if you want a font that is Arial, bold, with |
|
1405 |
* a point size of 18, you would call this method with: |
|
1406 |
* "Arial-BOLD-18". |
|
1407 |
* This is equivalent to calling the Font constructor : |
|
1408 |
* <code>new Font("Arial", Font.BOLD, 18);</code> |
|
1409 |
* and the values are interpreted as specified by that constructor. |
|
1410 |
* <p> |
|
1411 |
* A valid trailing decimal field is always interpreted as the pointsize. |
|
1412 |
* Therefore a fontname containing a trailing decimal value should not |
|
1413 |
* be used in the fontname only form. |
|
1414 |
* <p> |
|
1415 |
* If a style name field is not one of the valid style strings, it is |
|
1416 |
* interpreted as part of the font name, and the default style is used. |
|
1417 |
* <p> |
|
1418 |
* Only one of ' ' or '-' may be used to separate fields in the input. |
|
1419 |
* The identified separator is the one closest to the end of the string |
|
1420 |
* which separates a valid pointsize, or a valid style name from |
|
1421 |
* the rest of the string. |
|
1422 |
* Null (empty) pointsize and style fields are treated |
|
1423 |
* as valid fields with the default value for that field. |
|
1424 |
*<p> |
|
1425 |
* Some font names may include the separator characters ' ' or '-'. |
|
1426 |
* If <code>str</code> is not formed with 3 components, e.g. such that |
|
1427 |
* <code>style</code> or <code>pointsize</code> fields are not present in |
|
1428 |
* <code>str</code>, and <code>fontname</code> also contains a |
|
1429 |
* character determined to be the separator character |
|
1430 |
* then these characters where they appear as intended to be part of |
|
1431 |
* <code>fontname</code> may instead be interpreted as separators |
|
1432 |
* so the font name may not be properly recognised. |
|
1433 |
* |
|
1434 |
* <p> |
|
1435 |
* The default size is 12 and the default style is PLAIN. |
|
1436 |
* If <code>str</code> does not specify a valid size, the returned |
|
1437 |
* <code>Font</code> has a size of 12. If <code>str</code> does not |
|
1438 |
* specify a valid style, the returned Font has a style of PLAIN. |
|
1439 |
* If you do not specify a valid font name in |
|
1440 |
* the <code>str</code> argument, this method will return |
|
1441 |
* a font with the family name "Dialog". |
|
1442 |
* To determine what font family names are available on |
|
1443 |
* your system, use the |
|
1444 |
* {@link GraphicsEnvironment#getAvailableFontFamilyNames()} method. |
|
1445 |
* If <code>str</code> is <code>null</code>, a new <code>Font</code> |
|
1446 |
* is returned with the family name "Dialog", a size of 12 and a |
|
1447 |
* PLAIN style. |
|
1448 |
* @param str the name of the font, or <code>null</code> |
|
1449 |
* @return the <code>Font</code> object that <code>str</code> |
|
1450 |
* describes, or a new default <code>Font</code> if |
|
1451 |
* <code>str</code> is <code>null</code>. |
|
1452 |
* @see #getFamily |
|
1453 |
* @since JDK1.1 |
|
1454 |
*/ |
|
1455 |
public static Font decode(String str) { |
|
1456 |
String fontName = str; |
|
1457 |
String styleName = ""; |
|
1458 |
int fontSize = 12; |
|
1459 |
int fontStyle = Font.PLAIN; |
|
1460 |
||
1461 |
if (str == null) { |
|
1462 |
return new Font(DIALOG, fontStyle, fontSize); |
|
1463 |
} |
|
1464 |
||
1465 |
int lastHyphen = str.lastIndexOf('-'); |
|
1466 |
int lastSpace = str.lastIndexOf(' '); |
|
1467 |
char sepChar = (lastHyphen > lastSpace) ? '-' : ' '; |
|
1468 |
int sizeIndex = str.lastIndexOf(sepChar); |
|
1469 |
int styleIndex = str.lastIndexOf(sepChar, sizeIndex-1); |
|
1470 |
int strlen = str.length(); |
|
1471 |
||
1472 |
if (sizeIndex > 0 && sizeIndex+1 < strlen) { |
|
1473 |
try { |
|
1474 |
fontSize = |
|
1475 |
Integer.valueOf(str.substring(sizeIndex+1)).intValue(); |
|
1476 |
if (fontSize <= 0) { |
|
1477 |
fontSize = 12; |
|
1478 |
} |
|
1479 |
} catch (NumberFormatException e) { |
|
1480 |
/* It wasn't a valid size, if we didn't also find the |
|
1481 |
* start of the style string perhaps this is the style */ |
|
1482 |
styleIndex = sizeIndex; |
|
1483 |
sizeIndex = strlen; |
|
1484 |
if (str.charAt(sizeIndex-1) == sepChar) { |
|
1485 |
sizeIndex--; |
|
1486 |
} |
|
1487 |
} |
|
1488 |
} |
|
1489 |
||
1490 |
if (styleIndex >= 0 && styleIndex+1 < strlen) { |
|
1491 |
styleName = str.substring(styleIndex+1, sizeIndex); |
|
1492 |
styleName = styleName.toLowerCase(Locale.ENGLISH); |
|
1493 |
if (styleName.equals("bolditalic")) { |
|
1494 |
fontStyle = Font.BOLD | Font.ITALIC; |
|
1495 |
} else if (styleName.equals("italic")) { |
|
1496 |
fontStyle = Font.ITALIC; |
|
1497 |
} else if (styleName.equals("bold")) { |
|
1498 |
fontStyle = Font.BOLD; |
|
1499 |
} else if (styleName.equals("plain")) { |
|
1500 |
fontStyle = Font.PLAIN; |
|
1501 |
} else { |
|
1502 |
/* this string isn't any of the expected styles, so |
|
1503 |
* assume its part of the font name |
|
1504 |
*/ |
|
1505 |
styleIndex = sizeIndex; |
|
1506 |
if (str.charAt(styleIndex-1) == sepChar) { |
|
1507 |
styleIndex--; |
|
1508 |
} |
|
1509 |
} |
|
1510 |
fontName = str.substring(0, styleIndex); |
|
1511 |
||
1512 |
} else { |
|
1513 |
int fontEnd = strlen; |
|
1514 |
if (styleIndex > 0) { |
|
1515 |
fontEnd = styleIndex; |
|
1516 |
} else if (sizeIndex > 0) { |
|
1517 |
fontEnd = sizeIndex; |
|
1518 |
} |
|
1519 |
if (fontEnd > 0 && str.charAt(fontEnd-1) == sepChar) { |
|
1520 |
fontEnd--; |
|
1521 |
} |
|
1522 |
fontName = str.substring(0, fontEnd); |
|
1523 |
} |
|
1524 |
||
1525 |
return new Font(fontName, fontStyle, fontSize); |
|
1526 |
} |
|
1527 |
||
1528 |
/** |
|
1529 |
* Gets the specified <code>Font</code> from the system properties |
|
1530 |
* list. As in the <code>getProperty</code> method of |
|
1531 |
* <code>System</code>, the first |
|
1532 |
* argument is treated as the name of a system property to be |
|
1533 |
* obtained. The <code>String</code> value of this property is then |
|
1534 |
* interpreted as a <code>Font</code> object. |
|
1535 |
* <p> |
|
1536 |
* The property value should be one of the forms accepted by |
|
1537 |
* <code>Font.decode(String)</code> |
|
1538 |
* If the specified property is not found, or the executing code does not |
|
1539 |
* have permission to read the property, the <code>font</code> |
|
1540 |
* argument is returned instead. |
|
1541 |
* @param nm the case-insensitive property name |
|
1542 |
* @param font a default <code>Font</code> to return if property |
|
1543 |
* <code>nm</code> is not defined |
|
1544 |
* @return the <code>Font</code> value of the property. |
|
1545 |
* @throws NullPointerException if nm is null. |
|
1546 |
* @see #decode(String) |
|
1547 |
*/ |
|
1548 |
public static Font getFont(String nm, Font font) { |
|
1549 |
String str = null; |
|
1550 |
try { |
|
1551 |
str =System.getProperty(nm); |
|
1552 |
} catch(SecurityException e) { |
|
1553 |
} |
|
1554 |
if (str == null) { |
|
1555 |
return font; |
|
1556 |
} |
|
1557 |
return decode ( str ); |
|
1558 |
} |
|
1559 |
||
1560 |
transient int hash; |
|
1561 |
/** |
|
1562 |
* Returns a hashcode for this <code>Font</code>. |
|
1563 |
* @return a hashcode value for this <code>Font</code>. |
|
1564 |
* @since JDK1.0 |
|
1565 |
*/ |
|
1566 |
public int hashCode() { |
|
1567 |
if (hash == 0) { |
|
1568 |
hash = name.hashCode() ^ style ^ size; |
|
1569 |
/* It is possible many fonts differ only in transform. |
|
1570 |
* So include the transform in the hash calculation. |
|
1571 |
* nonIdentityTx is set whenever there is a transform in |
|
1572 |
* 'values'. The tests for null are required because it can |
|
1573 |
* also be set for other reasons. |
|
1574 |
*/ |
|
1575 |
if (nonIdentityTx && |
|
1576 |
values != null && values.getTransform() != null) { |
|
1577 |
hash ^= values.getTransform().hashCode(); |
|
1578 |
} |
|
1579 |
} |
|
1580 |
return hash; |
|
1581 |
} |
|
1582 |
||
1583 |
/** |
|
1584 |
* Compares this <code>Font</code> object to the specified |
|
1585 |
* <code>Object</code>. |
|
1586 |
* @param obj the <code>Object</code> to compare |
|
1587 |
* @return <code>true</code> if the objects are the same |
|
1588 |
* or if the argument is a <code>Font</code> object |
|
1589 |
* describing the same font as this object; |
|
1590 |
* <code>false</code> otherwise. |
|
1591 |
* @since JDK1.0 |
|
1592 |
*/ |
|
1593 |
public boolean equals(Object obj) { |
|
1594 |
if (obj == this) { |
|
1595 |
return true; |
|
1596 |
} |
|
1597 |
||
1598 |
if (obj != null) { |
|
1599 |
try { |
|
1600 |
Font font = (Font)obj; |
|
1601 |
if (size == font.size && |
|
1602 |
style == font.style && |
|
1603 |
nonIdentityTx == font.nonIdentityTx && |
|
1604 |
hasLayoutAttributes == font.hasLayoutAttributes && |
|
1605 |
pointSize == font.pointSize && |
|
1606 |
name.equals(font.name)) { |
|
1607 |
||
1608 |
/* 'values' is usually initialized lazily, except when |
|
1609 |
* the font is constructed from a Map, or derived using |
|
1610 |
* a Map or other values. So if only one font has |
|
1611 |
* the field initialized we need to initialize it in |
|
1612 |
* the other instance and compare. |
|
1613 |
*/ |
|
1614 |
if (values == null) { |
|
1615 |
if (font.values == null) { |
|
1616 |
return true; |
|
1617 |
} else { |
|
1618 |
return getAttributeValues().equals(font.values); |
|
1619 |
} |
|
1620 |
} else { |
|
1621 |
return values.equals(font.getAttributeValues()); |
|
1622 |
} |
|
1623 |
} |
|
1624 |
} |
|
1625 |
catch (ClassCastException e) { |
|
1626 |
} |
|
1627 |
} |
|
1628 |
return false; |
|
1629 |
} |
|
1630 |
||
1631 |
/** |
|
1632 |
* Converts this <code>Font</code> object to a <code>String</code> |
|
1633 |
* representation. |
|
1634 |
* @return a <code>String</code> representation of this |
|
1635 |
* <code>Font</code> object. |
|
1636 |
* @since JDK1.0 |
|
1637 |
*/ |
|
1638 |
// NOTE: This method may be called by privileged threads. |
|
1639 |
// DO NOT INVOKE CLIENT CODE ON THIS THREAD! |
|
1640 |
public String toString() { |
|
1641 |
String strStyle; |
|
1642 |
||
1643 |
if (isBold()) { |
|
1644 |
strStyle = isItalic() ? "bolditalic" : "bold"; |
|
1645 |
} else { |
|
1646 |
strStyle = isItalic() ? "italic" : "plain"; |
|
1647 |
} |
|
1648 |
||
1649 |
return getClass().getName() + "[family=" + getFamily() + ",name=" + name + ",style=" + |
|
1650 |
strStyle + ",size=" + size + "]"; |
|
1651 |
} // toString() |
|
1652 |
||
1653 |
||
1654 |
/** Serialization support. A <code>readObject</code> |
|
1655 |
* method is neccessary because the constructor creates |
|
1656 |
* the font's peer, and we can't serialize the peer. |
|
1657 |
* Similarly the computed font "family" may be different |
|
1658 |
* at <code>readObject</code> time than at |
|
1659 |
* <code>writeObject</code> time. An integer version is |
|
1660 |
* written so that future versions of this class will be |
|
1661 |
* able to recognize serialized output from this one. |
|
1662 |
*/ |
|
1663 |
/** |
|
1664 |
* The <code>Font</code> Serializable Data Form. |
|
1665 |
* |
|
1666 |
* @serial |
|
1667 |
*/ |
|
1668 |
private int fontSerializedDataVersion = 1; |
|
1669 |
||
1670 |
/** |
|
1671 |
* Writes default serializable fields to a stream. |
|
1672 |
* |
|
1673 |
* @param s the <code>ObjectOutputStream</code> to write |
|
1674 |
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener) |
|
1675 |
* @see #readObject(java.io.ObjectInputStream) |
|
1676 |
*/ |
|
1677 |
private void writeObject(java.io.ObjectOutputStream s) |
|
1678 |
throws java.lang.ClassNotFoundException, |
|
1679 |
java.io.IOException |
|
1680 |
{ |
|
1681 |
if (values != null) { |
|
1682 |
synchronized(values) { |
|
1683 |
// transient |
|
1684 |
fRequestedAttributes = values.toSerializableHashtable(); |
|
1685 |
s.defaultWriteObject(); |
|
1686 |
fRequestedAttributes = null; |
|
1687 |
} |
|
1688 |
} else { |
|
1689 |
s.defaultWriteObject(); |
|
1690 |
} |
|
1691 |
} |
|
1692 |
||
1693 |
/** |
|
1694 |
* Reads the <code>ObjectInputStream</code>. |
|
1695 |
* Unrecognized keys or values will be ignored. |
|
1696 |
* |
|
1697 |
* @param s the <code>ObjectInputStream</code> to read |
|
1698 |
* @serial |
|
1699 |
* @see #writeObject(java.io.ObjectOutputStream) |
|
1700 |
*/ |
|
1701 |
private void readObject(java.io.ObjectInputStream s) |
|
1702 |
throws java.lang.ClassNotFoundException, |
|
1703 |
java.io.IOException |
|
1704 |
{ |
|
1705 |
s.defaultReadObject(); |
|
1706 |
if (pointSize == 0) { |
|
1707 |
pointSize = (float)size; |
|
1708 |
} |
|
1709 |
||
1710 |
// Handle fRequestedAttributes. |
|
1711 |
// in 1.5, we always streamed out the font values plus |
|
1712 |
// TRANSFORM, SUPERSCRIPT, and WIDTH, regardless of whether the |
|
1713 |
// values were default or not. In 1.6 we only stream out |
|
1714 |
// defined values. So, 1.6 streams in from a 1.5 stream, |
|
1715 |
// it check each of these values and 'undefines' it if the |
|
1716 |
// value is the default. |
|
1717 |
||
1718 |
if (fRequestedAttributes != null) { |
|
1719 |
values = getAttributeValues(); // init |
|
1720 |
AttributeValues extras = |
|
1721 |
AttributeValues.fromSerializableHashtable(fRequestedAttributes); |
|
1722 |
if (!AttributeValues.is16Hashtable(fRequestedAttributes)) { |
|
1723 |
extras.unsetDefault(); // if legacy stream, undefine these |
|
1724 |
} |
|
1725 |
values = getAttributeValues().merge(extras); |
|
1726 |
this.nonIdentityTx = values.anyNonDefault(EXTRA_MASK); |
|
1727 |
this.hasLayoutAttributes = values.anyNonDefault(LAYOUT_MASK); |
|
1728 |
||
1729 |
fRequestedAttributes = null; // don't need it any more |
|
1730 |
} |
|
1731 |
} |
|
1732 |
||
1733 |
/** |
|
1734 |
* Returns the number of glyphs in this <code>Font</code>. Glyph codes |
|
1735 |
* for this <code>Font</code> range from 0 to |
|
1736 |
* <code>getNumGlyphs()</code> - 1. |
|
1737 |
* @return the number of glyphs in this <code>Font</code>. |
|
1738 |
* @since 1.2 |
|
1739 |
*/ |
|
1740 |
public int getNumGlyphs() { |
|
1741 |
return getFont2D().getNumGlyphs(); |
|
1742 |
} |
|
1743 |
||
1744 |
/** |
|
1745 |
* Returns the glyphCode which is used when this <code>Font</code> |
|
1746 |
* does not have a glyph for a specified unicode code point. |
|
1747 |
* @return the glyphCode of this <code>Font</code>. |
|
1748 |
* @since 1.2 |
|
1749 |
*/ |
|
1750 |
public int getMissingGlyphCode() { |
|
1751 |
return getFont2D().getMissingGlyphCode(); |
|
1752 |
} |
|
1753 |
||
1754 |
/** |
|
1755 |
* Returns the baseline appropriate for displaying this character. |
|
1756 |
* <p> |
|
1757 |
* Large fonts can support different writing systems, and each system can |
|
1758 |
* use a different baseline. |
|
1759 |
* The character argument determines the writing system to use. Clients |
|
1760 |
* should not assume all characters use the same baseline. |
|
1761 |
* |
|
1762 |
* @param c a character used to identify the writing system |
|
1763 |
* @return the baseline appropriate for the specified character. |
|
1764 |
* @see LineMetrics#getBaselineOffsets |
|
1765 |
* @see #ROMAN_BASELINE |
|
1766 |
* @see #CENTER_BASELINE |
|
1767 |
* @see #HANGING_BASELINE |
|
1768 |
* @since 1.2 |
|
1769 |
*/ |
|
1770 |
public byte getBaselineFor(char c) { |
|
1771 |
return getFont2D().getBaselineFor(c); |
|
1772 |
} |
|
1773 |
||
1774 |
/** |
|
1775 |
* Returns a map of font attributes available in this |
|
1776 |
* <code>Font</code>. Attributes include things like ligatures and |
|
1777 |
* glyph substitution. |
|
1778 |
* @return the attributes map of this <code>Font</code>. |
|
1779 |
*/ |
|
1780 |
public Map<TextAttribute,?> getAttributes(){ |
|
1781 |
return new AttributeMap(getAttributeValues()); |
|
1782 |
} |
|
1783 |
||
1784 |
/** |
|
1785 |
* Returns the keys of all the attributes supported by this |
|
1786 |
* <code>Font</code>. These attributes can be used to derive other |
|
1787 |
* fonts. |
|
1788 |
* @return an array containing the keys of all the attributes |
|
1789 |
* supported by this <code>Font</code>. |
|
1790 |
* @since 1.2 |
|
1791 |
*/ |
|
1792 |
public Attribute[] getAvailableAttributes() { |
|
1793 |
// FONT is not supported by Font |
|
1794 |
||
1795 |
Attribute attributes[] = { |
|
1796 |
TextAttribute.FAMILY, |
|
1797 |
TextAttribute.WEIGHT, |
|
1798 |
TextAttribute.WIDTH, |
|
1799 |
TextAttribute.POSTURE, |
|
1800 |
TextAttribute.SIZE, |
|
1801 |
TextAttribute.TRANSFORM, |
|
1802 |
TextAttribute.SUPERSCRIPT, |
|
1803 |
TextAttribute.CHAR_REPLACEMENT, |
|
1804 |
TextAttribute.FOREGROUND, |
|
1805 |
TextAttribute.BACKGROUND, |
|
1806 |
TextAttribute.UNDERLINE, |
|
1807 |
TextAttribute.STRIKETHROUGH, |
|
1808 |
TextAttribute.RUN_DIRECTION, |
|
1809 |
TextAttribute.BIDI_EMBEDDING, |
|
1810 |
TextAttribute.JUSTIFICATION, |
|
1811 |
TextAttribute.INPUT_METHOD_HIGHLIGHT, |
|
1812 |
TextAttribute.INPUT_METHOD_UNDERLINE, |
|
1813 |
TextAttribute.SWAP_COLORS, |
|
1814 |
TextAttribute.NUMERIC_SHAPING, |
|
1815 |
TextAttribute.KERNING, |
|
1816 |
TextAttribute.LIGATURES, |
|
1817 |
TextAttribute.TRACKING, |
|
1818 |
}; |
|
1819 |
||
1820 |
return attributes; |
|
1821 |
} |
|
1822 |
||
1823 |
/** |
|
1824 |
* Creates a new <code>Font</code> object by replicating this |
|
1825 |
* <code>Font</code> object and applying a new style and size. |
|
1826 |
* @param style the style for the new <code>Font</code> |
|
1827 |
* @param size the size for the new <code>Font</code> |
|
1828 |
* @return a new <code>Font</code> object. |
|
1829 |
* @since 1.2 |
|
1830 |
*/ |
|
1831 |
public Font deriveFont(int style, float size){ |
|
1832 |
if (values == null) { |
|
1833 |
return new Font(name, style, size, createdFont, font2DHandle); |
|
1834 |
} |
|
1835 |
AttributeValues newValues = getAttributeValues().clone(); |
|
1836 |
int oldStyle = (this.style != style) ? this.style : -1; |
|
1837 |
applyStyle(style, newValues); |
|
1838 |
newValues.setSize(size); |
|
1839 |
return new Font(newValues, null, oldStyle, createdFont, font2DHandle); |
|
1840 |
} |
|
1841 |
||
1842 |
/** |
|
1843 |
* Creates a new <code>Font</code> object by replicating this |
|
1844 |
* <code>Font</code> object and applying a new style and transform. |
|
1845 |
* @param style the style for the new <code>Font</code> |
|
1846 |
* @param trans the <code>AffineTransform</code> associated with the |
|
1847 |
* new <code>Font</code> |
|
1848 |
* @return a new <code>Font</code> object. |
|
1849 |
* @throws IllegalArgumentException if <code>trans</code> is |
|
1850 |
* <code>null</code> |
|
1851 |
* @since 1.2 |
|
1852 |
*/ |
|
1853 |
public Font deriveFont(int style, AffineTransform trans){ |
|
1854 |
AttributeValues newValues = getAttributeValues().clone(); |
|
1855 |
int oldStyle = (this.style != style) ? this.style : -1; |
|
1856 |
applyStyle(style, newValues); |
|
1857 |
applyTransform(trans, newValues); |
|
1858 |
return new Font(newValues, null, oldStyle, createdFont, font2DHandle); |
|
1859 |
} |
|
1860 |
||
1861 |
/** |
|
1862 |
* Creates a new <code>Font</code> object by replicating the current |
|
1863 |
* <code>Font</code> object and applying a new size to it. |
|
1864 |
* @param size the size for the new <code>Font</code>. |
|
1865 |
* @return a new <code>Font</code> object. |
|
1866 |
* @since 1.2 |
|
1867 |
*/ |
|
1868 |
public Font deriveFont(float size){ |
|
1869 |
if (values == null) { |
|
1870 |
return new Font(name, style, size, createdFont, font2DHandle); |
|
1871 |
} |
|
1872 |
AttributeValues newValues = getAttributeValues().clone(); |
|
1873 |
newValues.setSize(size); |
|
1874 |
return new Font(newValues, null, -1, createdFont, font2DHandle); |
|
1875 |
} |
|
1876 |
||
1877 |
/** |
|
1878 |
* Creates a new <code>Font</code> object by replicating the current |
|
1879 |
* <code>Font</code> object and applying a new transform to it. |
|
1880 |
* @param trans the <code>AffineTransform</code> associated with the |
|
1881 |
* new <code>Font</code> |
|
1882 |
* @return a new <code>Font</code> object. |
|
1883 |
* @throws IllegalArgumentException if <code>trans</code> is |
|
1884 |
* <code>null</code> |
|
1885 |
* @since 1.2 |
|
1886 |
*/ |
|
1887 |
public Font deriveFont(AffineTransform trans){ |
|
1888 |
AttributeValues newValues = getAttributeValues().clone(); |
|
1889 |
applyTransform(trans, newValues); |
|
1890 |
return new Font(newValues, null, -1, createdFont, font2DHandle); |
|
1891 |
} |
|
1892 |
||
1893 |
/** |
|
1894 |
* Creates a new <code>Font</code> object by replicating the current |
|
1895 |
* <code>Font</code> object and applying a new style to it. |
|
1896 |
* @param style the style for the new <code>Font</code> |
|
1897 |
* @return a new <code>Font</code> object. |
|
1898 |
* @since 1.2 |
|
1899 |
*/ |
|
1900 |
public Font deriveFont(int style){ |
|
1901 |
if (values == null) { |
|
1902 |
return new Font(name, style, size, createdFont, font2DHandle); |
|
1903 |
} |
|
1904 |
AttributeValues newValues = getAttributeValues().clone(); |
|
1905 |
int oldStyle = (this.style != style) ? this.style : -1; |
|
1906 |
applyStyle(style, newValues); |
|
1907 |
return new Font(newValues, null, oldStyle, createdFont, font2DHandle); |
|
1908 |
} |
|
1909 |
||
1910 |
/** |
|
1911 |
* Creates a new <code>Font</code> object by replicating the current |
|
1912 |
* <code>Font</code> object and applying a new set of font attributes |
|
1913 |
* to it. |
|
1914 |
* |
|
1915 |
* @param attributes a map of attributes enabled for the new |
|
1916 |
* <code>Font</code> |
|
1917 |
* @return a new <code>Font</code> object. |
|
1918 |
* @since 1.2 |
|
1919 |
*/ |
|
1920 |
public Font deriveFont(Map<? extends Attribute, ?> attributes) { |
|
1921 |
if (attributes == null) { |
|
1922 |
return this; |
|
1923 |
} |
|
1924 |
AttributeValues newValues = getAttributeValues().clone(); |
|
1925 |
newValues.merge(attributes, RECOGNIZED_MASK); |
|
1926 |
||
1927 |
return new Font(newValues, name, style, createdFont, font2DHandle); |
|
1928 |
} |
|
1929 |
||
1930 |
/** |
|
1931 |
* Checks if this <code>Font</code> has a glyph for the specified |
|
1932 |
* character. |
|
1933 |
* |
|
1934 |
* <p> <b>Note:</b> This method cannot handle <a |
|
1935 |
* href="../../java/lang/Character.html#supplementary"> supplementary |
|
1936 |
* characters</a>. To support all Unicode characters, including |
|
1937 |
* supplementary characters, use the {@link #canDisplay(int)} |
|
1938 |
* method or <code>canDisplayUpTo</code> methods. |
|
1939 |
* |
|
1940 |
* @param c the character for which a glyph is needed |
|
1941 |
* @return <code>true</code> if this <code>Font</code> has a glyph for this |
|
1942 |
* character; <code>false</code> otherwise. |
|
1943 |
* @since 1.2 |
|
1944 |
*/ |
|
1945 |
public boolean canDisplay(char c){ |
|
1946 |
return getFont2D().canDisplay(c); |
|
1947 |
} |
|
1948 |
||
1949 |
/** |
|
1950 |
* Checks if this <code>Font</code> has a glyph for the specified |
|
1951 |
* character. |
|
1952 |
* |
|
1953 |
* @param codePoint the character (Unicode code point) for which a glyph |
|
1954 |
* is needed. |
|
1955 |
* @return <code>true</code> if this <code>Font</code> has a glyph for the |
|
1956 |
* character; <code>false</code> otherwise. |
|
1957 |
* @throws IllegalArgumentException if the code point is not a valid Unicode |
|
1958 |
* code point. |
|
1959 |
* @see Character#isValidCodePoint(int) |
|
1960 |
* @since 1.5 |
|
1961 |
*/ |
|
1962 |
public boolean canDisplay(int codePoint) { |
|
1963 |
if (!Character.isValidCodePoint(codePoint)) { |
|
1964 |
throw new IllegalArgumentException("invalid code point: " + |
|
1965 |
Integer.toHexString(codePoint)); |
|
1966 |
} |
|
1967 |
return getFont2D().canDisplay(codePoint); |
|
1968 |
} |
|
1969 |
||
1970 |
/** |
|
1971 |
* Indicates whether or not this <code>Font</code> can display a |
|
1972 |
* specified <code>String</code>. For strings with Unicode encoding, |
|
1973 |
* it is important to know if a particular font can display the |
|
1974 |
* string. This method returns an offset into the <code>String</code> |
|
1975 |
* <code>str</code> which is the first character this |
|
1976 |
* <code>Font</code> cannot display without using the missing glyph |
|
1977 |
* code. If the <code>Font</code> can display all characters, -1 is |
|
1978 |
* returned. |
|
1979 |
* @param str a <code>String</code> object |
|
1980 |
* @return an offset into <code>str</code> that points |
|
1981 |
* to the first character in <code>str</code> that this |
|
1982 |
* <code>Font</code> cannot display; or <code>-1</code> if |
|
1983 |
* this <code>Font</code> can display all characters in |
|
1984 |
* <code>str</code>. |
|
1985 |
* @since 1.2 |
|
1986 |
*/ |
|
1987 |
public int canDisplayUpTo(String str) { |
|
8520
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1988 |
Font2D font2d = getFont2D(); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1989 |
int len = str.length(); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1990 |
for (int i = 0; i < len; i++) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1991 |
char c = str.charAt(i); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1992 |
if (font2d.canDisplay(c)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1993 |
continue; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1994 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1995 |
if (!Character.isHighSurrogate(c)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1996 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1997 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1998 |
if (!font2d.canDisplay(str.codePointAt(i))) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
1999 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2000 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2001 |
i++; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2002 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2003 |
return -1; |
2 | 2004 |
} |
2005 |
||
2006 |
/** |
|
2007 |
* Indicates whether or not this <code>Font</code> can display |
|
2008 |
* the characters in the specified <code>text</code> |
|
2009 |
* starting at <code>start</code> and ending at |
|
2010 |
* <code>limit</code>. This method is a convenience overload. |
|
2011 |
* @param text the specified array of <code>char</code> values |
|
2012 |
* @param start the specified starting offset (in |
|
2013 |
* <code>char</code>s) into the specified array of |
|
2014 |
* <code>char</code> values |
|
2015 |
* @param limit the specified ending offset (in |
|
2016 |
* <code>char</code>s) into the specified array of |
|
2017 |
* <code>char</code> values |
|
2018 |
* @return an offset into <code>text</code> that points |
|
2019 |
* to the first character in <code>text</code> that this |
|
2020 |
* <code>Font</code> cannot display; or <code>-1</code> if |
|
2021 |
* this <code>Font</code> can display all characters in |
|
2022 |
* <code>text</code>. |
|
2023 |
* @since 1.2 |
|
2024 |
*/ |
|
2025 |
public int canDisplayUpTo(char[] text, int start, int limit) { |
|
8520
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2026 |
Font2D font2d = getFont2D(); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2027 |
for (int i = start; i < limit; i++) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2028 |
char c = text[i]; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2029 |
if (font2d.canDisplay(c)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2030 |
continue; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2031 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2032 |
if (!Character.isHighSurrogate(c)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2033 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2034 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2035 |
if (!font2d.canDisplay(Character.codePointAt(text, i, limit))) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2036 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2037 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2038 |
i++; |
2 | 2039 |
} |
8520
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2040 |
return -1; |
2 | 2041 |
} |
2042 |
||
2043 |
/** |
|
2044 |
* Indicates whether or not this <code>Font</code> can display the |
|
2045 |
* text specified by the <code>iter</code> starting at |
|
2046 |
* <code>start</code> and ending at <code>limit</code>. |
|
2047 |
* |
|
2048 |
* @param iter a {@link CharacterIterator} object |
|
2049 |
* @param start the specified starting offset into the specified |
|
2050 |
* <code>CharacterIterator</code>. |
|
2051 |
* @param limit the specified ending offset into the specified |
|
2052 |
* <code>CharacterIterator</code>. |
|
2053 |
* @return an offset into <code>iter</code> that points |
|
2054 |
* to the first character in <code>iter</code> that this |
|
2055 |
* <code>Font</code> cannot display; or <code>-1</code> if |
|
2056 |
* this <code>Font</code> can display all characters in |
|
2057 |
* <code>iter</code>. |
|
2058 |
* @since 1.2 |
|
2059 |
*/ |
|
2060 |
public int canDisplayUpTo(CharacterIterator iter, int start, int limit) { |
|
8520
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2061 |
Font2D font2d = getFont2D(); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2062 |
char c = iter.setIndex(start); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2063 |
for (int i = start; i < limit; i++, c = iter.next()) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2064 |
if (font2d.canDisplay(c)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2065 |
continue; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2066 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2067 |
if (!Character.isHighSurrogate(c)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2068 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2069 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2070 |
char c2 = iter.next(); |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2071 |
// c2 could be CharacterIterator.DONE which is not a low surrogate. |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2072 |
if (!Character.isLowSurrogate(c2)) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2073 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2074 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2075 |
if (!font2d.canDisplay(Character.toCodePoint(c, c2))) { |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2076 |
return i; |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2077 |
} |
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2078 |
i++; |
2 | 2079 |
} |
8520
a9e798f494cb
6623219: Font.canDisplayUpTo does not work with supplementary characters
okutsu
parents:
7668
diff
changeset
|
2080 |
return -1; |
2 | 2081 |
} |
2082 |
||
2083 |
/** |
|
2084 |
* Returns the italic angle of this <code>Font</code>. The italic angle |
|
2085 |
* is the inverse slope of the caret which best matches the posture of this |
|
2086 |
* <code>Font</code>. |
|
2087 |
* @see TextAttribute#POSTURE |
|
2088 |
* @return the angle of the ITALIC style of this <code>Font</code>. |
|
2089 |
*/ |
|
2090 |
public float getItalicAngle() { |
|
2091 |
return getItalicAngle(null); |
|
2092 |
} |
|
2093 |
||
2094 |
/* The FRC hints don't affect the value of the italic angle but |
|
2095 |
* we need to pass them in to look up a strike. |
|
2096 |
* If we can pass in ones already being used it can prevent an extra |
|
2097 |
* strike from being allocated. Note that since italic angle is |
|
2098 |
* a property of the font, the font transform is needed not the |
|
2099 |
* device transform. Finally, this is private but the only caller of this |
|
2100 |
* in the JDK - and the only likely caller - is in this same class. |
|
2101 |
*/ |
|
2102 |
private float getItalicAngle(FontRenderContext frc) { |
|
2103 |
Object aa, fm; |
|
2104 |
if (frc == null) { |
|
2105 |
aa = RenderingHints.VALUE_TEXT_ANTIALIAS_OFF; |
|
2106 |
fm = RenderingHints.VALUE_FRACTIONALMETRICS_OFF; |
|
2107 |
} else { |
|
2108 |
aa = frc.getAntiAliasingHint(); |
|
2109 |
fm = frc.getFractionalMetricsHint(); |
|
2110 |
} |
|
547
ff9562f275ab
6694480: Two small inefficiencies in getting font strikes for transformed fonts
prr
parents:
534
diff
changeset
|
2111 |
return getFont2D().getItalicAngle(this, identityTx, aa, fm); |
2 | 2112 |
} |
2113 |
||
2114 |
/** |
|
2115 |
* Checks whether or not this <code>Font</code> has uniform |
|
2116 |
* line metrics. A logical <code>Font</code> might be a |
|
2117 |
* composite font, which means that it is composed of different |
|
2118 |
* physical fonts to cover different code ranges. Each of these |
|
2119 |
* fonts might have different <code>LineMetrics</code>. If the |
|
2120 |
* logical <code>Font</code> is a single |
|
2121 |
* font then the metrics would be uniform. |
|
2122 |
* @return <code>true</code> if this <code>Font</code> has |
|
2123 |
* uniform line metrics; <code>false</code> otherwise. |
|
2124 |
*/ |
|
2125 |
public boolean hasUniformLineMetrics() { |
|
2126 |
return false; // REMIND always safe, but prevents caller optimize |
|
2127 |
} |
|
2128 |
||
2129 |
private transient SoftReference flmref; |
|
2130 |
private FontLineMetrics defaultLineMetrics(FontRenderContext frc) { |
|
2131 |
FontLineMetrics flm = null; |
|
2132 |
if (flmref == null |
|
2133 |
|| (flm = (FontLineMetrics)flmref.get()) == null |
|
2134 |
|| !flm.frc.equals(frc)) { |
|
2135 |
||
2136 |
/* The device transform in the frc is not used in obtaining line |
|
2137 |
* metrics, although it probably should be: REMIND find why not? |
|
2138 |
* The font transform is used but its applied in getFontMetrics, so |
|
2139 |
* just pass identity here |
|
2140 |
*/ |
|
2141 |
float [] metrics = new float[8]; |
|
2142 |
getFont2D().getFontMetrics(this, identityTx, |
|
2143 |
frc.getAntiAliasingHint(), |
|
2144 |
frc.getFractionalMetricsHint(), |
|
2145 |
metrics); |
|
2146 |
float ascent = metrics[0]; |
|
2147 |
float descent = metrics[1]; |
|
2148 |
float leading = metrics[2]; |
|
2149 |
float ssOffset = 0; |
|
2150 |
if (values != null && values.getSuperscript() != 0) { |
|
2151 |
ssOffset = (float)getTransform().getTranslateY(); |
|
2152 |
ascent -= ssOffset; |
|
2153 |
descent += ssOffset; |
|
2154 |
} |
|
2155 |
float height = ascent + descent + leading; |
|
2156 |
||
2157 |
int baselineIndex = 0; // need real index, assumes roman for everything |
|
2158 |
// need real baselines eventually |
|
2159 |
float[] baselineOffsets = { 0, (descent/2f - ascent) / 2f, -ascent }; |
|
2160 |
||
2161 |
float strikethroughOffset = metrics[4]; |
|
2162 |
float strikethroughThickness = metrics[5]; |
|
2163 |
||
2164 |
float underlineOffset = metrics[6]; |
|
2165 |
float underlineThickness = metrics[7]; |
|
2166 |
||
2167 |
float italicAngle = getItalicAngle(frc); |
|
2168 |
||
2169 |
if (isTransformed()) { |
|
2170 |
AffineTransform ctx = values.getCharTransform(); // extract rotation |
|
2171 |
if (ctx != null) { |
|
2172 |
Point2D.Float pt = new Point2D.Float(); |
|
2173 |
pt.setLocation(0, strikethroughOffset); |
|
2174 |
ctx.deltaTransform(pt, pt); |
|
2175 |
strikethroughOffset = pt.y; |
|
2176 |
pt.setLocation(0, strikethroughThickness); |
|
2177 |
ctx.deltaTransform(pt, pt); |
|
2178 |
strikethroughThickness = pt.y; |
|
2179 |
pt.setLocation(0, underlineOffset); |
|
2180 |
ctx.deltaTransform(pt, pt); |
|
2181 |
underlineOffset = pt.y; |
|
2182 |
pt.setLocation(0, underlineThickness); |
|
2183 |
ctx.deltaTransform(pt, pt); |
|
2184 |
underlineThickness = pt.y; |
|
2185 |
} |
|
2186 |
} |
|
2187 |
strikethroughOffset += ssOffset; |
|
2188 |
underlineOffset += ssOffset; |
|
2189 |
||
2190 |
CoreMetrics cm = new CoreMetrics(ascent, descent, leading, height, |
|
2191 |
baselineIndex, baselineOffsets, |
|
2192 |
strikethroughOffset, strikethroughThickness, |
|
2193 |
underlineOffset, underlineThickness, |
|
2194 |
ssOffset, italicAngle); |
|
2195 |
||
2196 |
flm = new FontLineMetrics(0, cm, frc); |
|
2197 |
flmref = new SoftReference(flm); |
|
2198 |
} |
|
2199 |
||
2200 |
return (FontLineMetrics)flm.clone(); |
|
2201 |
} |
|
2202 |
||
2203 |
/** |
|
2204 |
* Returns a {@link LineMetrics} object created with the specified |
|
2205 |
* <code>String</code> and {@link FontRenderContext}. |
|
2206 |
* @param str the specified <code>String</code> |
|
2207 |
* @param frc the specified <code>FontRenderContext</code> |
|
2208 |
* @return a <code>LineMetrics</code> object created with the |
|
2209 |
* specified <code>String</code> and {@link FontRenderContext}. |
|
2210 |
*/ |
|
2211 |
public LineMetrics getLineMetrics( String str, FontRenderContext frc) { |
|
2212 |
FontLineMetrics flm = defaultLineMetrics(frc); |
|
2213 |
flm.numchars = str.length(); |
|
2214 |
return flm; |
|
2215 |
} |
|
2216 |
||
2217 |
/** |
|
2218 |
* Returns a <code>LineMetrics</code> object created with the |
|
2219 |
* specified arguments. |
|
2220 |
* @param str the specified <code>String</code> |
|
2221 |
* @param beginIndex the initial offset of <code>str</code> |
|
2222 |
* @param limit the end offset of <code>str</code> |
|
2223 |
* @param frc the specified <code>FontRenderContext</code> |
|
2224 |
* @return a <code>LineMetrics</code> object created with the |
|
2225 |
* specified arguments. |
|
2226 |
*/ |
|
2227 |
public LineMetrics getLineMetrics( String str, |
|
2228 |
int beginIndex, int limit, |
|
2229 |
FontRenderContext frc) { |
|
2230 |
FontLineMetrics flm = defaultLineMetrics(frc); |
|
2231 |
int numChars = limit - beginIndex; |
|
2232 |
flm.numchars = (numChars < 0)? 0: numChars; |
|
2233 |
return flm; |
|
2234 |
} |
|
2235 |
||
2236 |
/** |
|
2237 |
* Returns a <code>LineMetrics</code> object created with the |
|
2238 |
* specified arguments. |
|
2239 |
* @param chars an array of characters |
|
2240 |
* @param beginIndex the initial offset of <code>chars</code> |
|
2241 |
* @param limit the end offset of <code>chars</code> |
|
2242 |
* @param frc the specified <code>FontRenderContext</code> |
|
2243 |
* @return a <code>LineMetrics</code> object created with the |
|
2244 |
* specified arguments. |
|
2245 |
*/ |
|
2246 |
public LineMetrics getLineMetrics(char [] chars, |
|
2247 |
int beginIndex, int limit, |
|
2248 |
FontRenderContext frc) { |
|
2249 |
FontLineMetrics flm = defaultLineMetrics(frc); |
|
2250 |
int numChars = limit - beginIndex; |
|
2251 |
flm.numchars = (numChars < 0)? 0: numChars; |
|
2252 |
return flm; |
|
2253 |
} |
|
2254 |
||
2255 |
/** |
|
2256 |
* Returns a <code>LineMetrics</code> object created with the |
|
2257 |
* specified arguments. |
|
2258 |
* @param ci the specified <code>CharacterIterator</code> |
|
2259 |
* @param beginIndex the initial offset in <code>ci</code> |
|
2260 |
* @param limit the end offset of <code>ci</code> |
|
2261 |
* @param frc the specified <code>FontRenderContext</code> |
|
2262 |
* @return a <code>LineMetrics</code> object created with the |
|
2263 |
* specified arguments. |
|
2264 |
*/ |
|
2265 |
public LineMetrics getLineMetrics(CharacterIterator ci, |
|
2266 |
int beginIndex, int limit, |
|
2267 |
FontRenderContext frc) { |
|
2268 |
FontLineMetrics flm = defaultLineMetrics(frc); |
|
2269 |
int numChars = limit - beginIndex; |
|
2270 |
flm.numchars = (numChars < 0)? 0: numChars; |
|
2271 |
return flm; |
|
2272 |
} |
|
2273 |
||
2274 |
/** |
|
2275 |
* Returns the logical bounds of the specified <code>String</code> in |
|
2276 |
* the specified <code>FontRenderContext</code>. The logical bounds |
|
2277 |
* contains the origin, ascent, advance, and height, which includes |
|
2278 |
* the leading. The logical bounds does not always enclose all the |
|
2279 |
* text. For example, in some languages and in some fonts, accent |
|
2280 |
* marks can be positioned above the ascent or below the descent. |
|
2281 |
* To obtain a visual bounding box, which encloses all the text, |
|
2282 |
* use the {@link TextLayout#getBounds() getBounds} method of |
|
2283 |
* <code>TextLayout</code>. |
|
2284 |
* <p>Note: The returned bounds is in baseline-relative coordinates |
|
2285 |
* (see {@link java.awt.Font class notes}). |
|
2286 |
* @param str the specified <code>String</code> |
|
2287 |
* @param frc the specified <code>FontRenderContext</code> |
|
2288 |
* @return a {@link Rectangle2D} that is the bounding box of the |
|
2289 |
* specified <code>String</code> in the specified |
|
2290 |
* <code>FontRenderContext</code>. |
|
2291 |
* @see FontRenderContext |
|
2292 |
* @see Font#createGlyphVector |
|
2293 |
* @since 1.2 |
|
2294 |
*/ |
|
2295 |
public Rectangle2D getStringBounds( String str, FontRenderContext frc) { |
|
2296 |
char[] array = str.toCharArray(); |
|
2297 |
return getStringBounds(array, 0, array.length, frc); |
|
2298 |
} |
|
2299 |
||
2300 |
/** |
|
2301 |
* Returns the logical bounds of the specified <code>String</code> in |
|
2302 |
* the specified <code>FontRenderContext</code>. The logical bounds |
|
2303 |
* contains the origin, ascent, advance, and height, which includes |
|
2304 |
* the leading. The logical bounds does not always enclose all the |
|
2305 |
* text. For example, in some languages and in some fonts, accent |
|
2306 |
* marks can be positioned above the ascent or below the descent. |
|
2307 |
* To obtain a visual bounding box, which encloses all the text, |
|
2308 |
* use the {@link TextLayout#getBounds() getBounds} method of |
|
2309 |
* <code>TextLayout</code>. |
|
2310 |
* <p>Note: The returned bounds is in baseline-relative coordinates |
|
2311 |
* (see {@link java.awt.Font class notes}). |
|
2312 |
* @param str the specified <code>String</code> |
|
2313 |
* @param beginIndex the initial offset of <code>str</code> |
|
2314 |
* @param limit the end offset of <code>str</code> |
|
2315 |
* @param frc the specified <code>FontRenderContext</code> |
|
2316 |
* @return a <code>Rectangle2D</code> that is the bounding box of the |
|
2317 |
* specified <code>String</code> in the specified |
|
2318 |
* <code>FontRenderContext</code>. |
|
2319 |
* @throws IndexOutOfBoundsException if <code>beginIndex</code> is |
|
2320 |
* less than zero, or <code>limit</code> is greater than the |
|
2321 |
* length of <code>str</code>, or <code>beginIndex</code> |
|
2322 |
* is greater than <code>limit</code>. |
|
2323 |
* @see FontRenderContext |
|
2324 |
* @see Font#createGlyphVector |
|
2325 |
* @since 1.2 |
|
2326 |
*/ |
|
2327 |
public Rectangle2D getStringBounds( String str, |
|
2328 |
int beginIndex, int limit, |
|
2329 |
FontRenderContext frc) { |
|
2330 |
String substr = str.substring(beginIndex, limit); |
|
2331 |
return getStringBounds(substr, frc); |
|
2332 |
} |
|
2333 |
||
2334 |
/** |
|
2335 |
* Returns the logical bounds of the specified array of characters |
|
2336 |
* in the specified <code>FontRenderContext</code>. The logical |
|
2337 |
* bounds contains the origin, ascent, advance, and height, which |
|
2338 |
* includes the leading. The logical bounds does not always enclose |
|
2339 |
* all the text. For example, in some languages and in some fonts, |
|
2340 |
* accent marks can be positioned above the ascent or below the |
|
2341 |
* descent. To obtain a visual bounding box, which encloses all the |
|
2342 |
* text, use the {@link TextLayout#getBounds() getBounds} method of |
|
2343 |
* <code>TextLayout</code>. |
|
2344 |
* <p>Note: The returned bounds is in baseline-relative coordinates |
|
2345 |
* (see {@link java.awt.Font class notes}). |
|
2346 |
* @param chars an array of characters |
|
2347 |
* @param beginIndex the initial offset in the array of |
|
2348 |
* characters |
|
2349 |
* @param limit the end offset in the array of characters |
|
2350 |
* @param frc the specified <code>FontRenderContext</code> |
|
2351 |
* @return a <code>Rectangle2D</code> that is the bounding box of the |
|
2352 |
* specified array of characters in the specified |
|
2353 |
* <code>FontRenderContext</code>. |
|
2354 |
* @throws IndexOutOfBoundsException if <code>beginIndex</code> is |
|
2355 |
* less than zero, or <code>limit</code> is greater than the |
|
2356 |
* length of <code>chars</code>, or <code>beginIndex</code> |
|
2357 |
* is greater than <code>limit</code>. |
|
2358 |
* @see FontRenderContext |
|
2359 |
* @see Font#createGlyphVector |
|
2360 |
* @since 1.2 |
|
2361 |
*/ |
|
2362 |
public Rectangle2D getStringBounds(char [] chars, |
|
2363 |
int beginIndex, int limit, |
|
2364 |
FontRenderContext frc) { |
|
2365 |
if (beginIndex < 0) { |
|
2366 |
throw new IndexOutOfBoundsException("beginIndex: " + beginIndex); |
|
2367 |
} |
|
2368 |
if (limit > chars.length) { |
|
2369 |
throw new IndexOutOfBoundsException("limit: " + limit); |
|
2370 |
} |
|
2371 |
if (beginIndex > limit) { |
|
2372 |
throw new IndexOutOfBoundsException("range length: " + |
|
2373 |
(limit - beginIndex)); |
|
2374 |
} |
|
2375 |
||
2376 |
// this code should be in textlayout |
|
2377 |
// quick check for simple text, assume GV ok to use if simple |
|
2378 |
||
2379 |
boolean simple = values == null || |
|
2380 |
(values.getKerning() == 0 && values.getLigatures() == 0 && |
|
2381 |
values.getBaselineTransform() == null); |
|
2382 |
if (simple) { |
|
3928 | 2383 |
simple = ! FontUtilities.isComplexText(chars, beginIndex, limit); |
2 | 2384 |
} |
2385 |
||
2386 |
if (simple) { |
|
2387 |
GlyphVector gv = new StandardGlyphVector(this, chars, beginIndex, |
|
2388 |
limit - beginIndex, frc); |
|
2389 |
return gv.getLogicalBounds(); |
|
2390 |
} else { |
|
2391 |
// need char array constructor on textlayout |
|
2392 |
String str = new String(chars, beginIndex, limit - beginIndex); |
|
2393 |
TextLayout tl = new TextLayout(str, this, frc); |
|
2394 |
return new Rectangle2D.Float(0, -tl.getAscent(), tl.getAdvance(), |
|
2395 |
tl.getAscent() + tl.getDescent() + |
|
2396 |
tl.getLeading()); |
|
2397 |
} |
|
2398 |
} |
|
2399 |
||
2400 |
/** |
|
2401 |
* Returns the logical bounds of the characters indexed in the |
|
2402 |
* specified {@link CharacterIterator} in the |
|
2403 |
* specified <code>FontRenderContext</code>. The logical bounds |
|
2404 |
* contains the origin, ascent, advance, and height, which includes |
|
2405 |
* the leading. The logical bounds does not always enclose all the |
|
2406 |
* text. For example, in some languages and in some fonts, accent |
|
2407 |
* marks can be positioned above the ascent or below the descent. |
|
2408 |
* To obtain a visual bounding box, which encloses all the text, |
|
2409 |
* use the {@link TextLayout#getBounds() getBounds} method of |
|
2410 |
* <code>TextLayout</code>. |
|
2411 |
* <p>Note: The returned bounds is in baseline-relative coordinates |
|
2412 |
* (see {@link java.awt.Font class notes}). |
|
2413 |
* @param ci the specified <code>CharacterIterator</code> |
|
2414 |
* @param beginIndex the initial offset in <code>ci</code> |
|
2415 |
* @param limit the end offset in <code>ci</code> |
|
2416 |
* @param frc the specified <code>FontRenderContext</code> |
|
2417 |
* @return a <code>Rectangle2D</code> that is the bounding box of the |
|
2418 |
* characters indexed in the specified <code>CharacterIterator</code> |
|
2419 |
* in the specified <code>FontRenderContext</code>. |
|
2420 |
* @see FontRenderContext |
|
2421 |
* @see Font#createGlyphVector |
|
2422 |
* @since 1.2 |
|
2423 |
* @throws IndexOutOfBoundsException if <code>beginIndex</code> is |
|
2424 |
* less than the start index of <code>ci</code>, or |
|
2425 |
* <code>limit</code> is greater than the end index of |
|
2426 |
* <code>ci</code>, or <code>beginIndex</code> is greater |
|
2427 |
* than <code>limit</code> |
|
2428 |
*/ |
|
2429 |
public Rectangle2D getStringBounds(CharacterIterator ci, |
|
2430 |
int beginIndex, int limit, |
|
2431 |
FontRenderContext frc) { |
|
2432 |
int start = ci.getBeginIndex(); |
|
2433 |
int end = ci.getEndIndex(); |
|
2434 |
||
2435 |
if (beginIndex < start) { |
|
2436 |
throw new IndexOutOfBoundsException("beginIndex: " + beginIndex); |
|
2437 |
} |
|
2438 |
if (limit > end) { |
|
2439 |
throw new IndexOutOfBoundsException("limit: " + limit); |
|
2440 |
} |
|
2441 |
if (beginIndex > limit) { |
|
2442 |
throw new IndexOutOfBoundsException("range length: " + |
|
2443 |
(limit - beginIndex)); |
|
2444 |
} |
|
2445 |
||
2446 |
char[] arr = new char[limit - beginIndex]; |
|
2447 |
||
2448 |
ci.setIndex(beginIndex); |
|
2449 |
for(int idx = 0; idx < arr.length; idx++) { |
|
2450 |
arr[idx] = ci.current(); |
|
2451 |
ci.next(); |
|
2452 |
} |
|
2453 |
||
2454 |
return getStringBounds(arr,0,arr.length,frc); |
|
2455 |
} |
|
2456 |
||
2457 |
/** |
|
2458 |
* Returns the bounds for the character with the maximum |
|
2459 |
* bounds as defined in the specified <code>FontRenderContext</code>. |
|
2460 |
* <p>Note: The returned bounds is in baseline-relative coordinates |
|
2461 |
* (see {@link java.awt.Font class notes}). |
|
2462 |
* @param frc the specified <code>FontRenderContext</code> |
|
2463 |
* @return a <code>Rectangle2D</code> that is the bounding box |
|
2464 |
* for the character with the maximum bounds. |
|
2465 |
*/ |
|
2466 |
public Rectangle2D getMaxCharBounds(FontRenderContext frc) { |
|
2467 |
float [] metrics = new float[4]; |
|
2468 |
||
2469 |
getFont2D().getFontMetrics(this, frc, metrics); |
|
2470 |
||
2471 |
return new Rectangle2D.Float(0, -metrics[0], |
|
2472 |
metrics[3], |
|
2473 |
metrics[0] + metrics[1] + metrics[2]); |
|
2474 |
} |
|
2475 |
||
2476 |
/** |
|
2477 |
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by |
|
2478 |
* mapping characters to glyphs one-to-one based on the |
|
2479 |
* Unicode cmap in this <code>Font</code>. This method does no other |
|
2480 |
* processing besides the mapping of glyphs to characters. This |
|
2481 |
* means that this method is not useful for some scripts, such |
|
2482 |
* as Arabic, Hebrew, Thai, and Indic, that require reordering, |
|
2483 |
* shaping, or ligature substitution. |
|
2484 |
* @param frc the specified <code>FontRenderContext</code> |
|
2485 |
* @param str the specified <code>String</code> |
|
2486 |
* @return a new <code>GlyphVector</code> created with the |
|
2487 |
* specified <code>String</code> and the specified |
|
2488 |
* <code>FontRenderContext</code>. |
|
2489 |
*/ |
|
2490 |
public GlyphVector createGlyphVector(FontRenderContext frc, String str) |
|
2491 |
{ |
|
2492 |
return (GlyphVector)new StandardGlyphVector(this, str, frc); |
|
2493 |
} |
|
2494 |
||
2495 |
/** |
|
2496 |
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by |
|
2497 |
* mapping characters to glyphs one-to-one based on the |
|
2498 |
* Unicode cmap in this <code>Font</code>. This method does no other |
|
2499 |
* processing besides the mapping of glyphs to characters. This |
|
2500 |
* means that this method is not useful for some scripts, such |
|
2501 |
* as Arabic, Hebrew, Thai, and Indic, that require reordering, |
|
2502 |
* shaping, or ligature substitution. |
|
2503 |
* @param frc the specified <code>FontRenderContext</code> |
|
2504 |
* @param chars the specified array of characters |
|
2505 |
* @return a new <code>GlyphVector</code> created with the |
|
2506 |
* specified array of characters and the specified |
|
2507 |
* <code>FontRenderContext</code>. |
|
2508 |
*/ |
|
2509 |
public GlyphVector createGlyphVector(FontRenderContext frc, char[] chars) |
|
2510 |
{ |
|
2511 |
return (GlyphVector)new StandardGlyphVector(this, chars, frc); |
|
2512 |
} |
|
2513 |
||
2514 |
/** |
|
2515 |
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by |
|
2516 |
* mapping the specified characters to glyphs one-to-one based on the |
|
2517 |
* Unicode cmap in this <code>Font</code>. This method does no other |
|
2518 |
* processing besides the mapping of glyphs to characters. This |
|
2519 |
* means that this method is not useful for some scripts, such |
|
2520 |
* as Arabic, Hebrew, Thai, and Indic, that require reordering, |
|
2521 |
* shaping, or ligature substitution. |
|
2522 |
* @param frc the specified <code>FontRenderContext</code> |
|
2523 |
* @param ci the specified <code>CharacterIterator</code> |
|
2524 |
* @return a new <code>GlyphVector</code> created with the |
|
2525 |
* specified <code>CharacterIterator</code> and the specified |
|
2526 |
* <code>FontRenderContext</code>. |
|
2527 |
*/ |
|
2528 |
public GlyphVector createGlyphVector( FontRenderContext frc, |
|
2529 |
CharacterIterator ci) |
|
2530 |
{ |
|
2531 |
return (GlyphVector)new StandardGlyphVector(this, ci, frc); |
|
2532 |
} |
|
2533 |
||
2534 |
/** |
|
2535 |
* Creates a {@link java.awt.font.GlyphVector GlyphVector} by |
|
2536 |
* mapping characters to glyphs one-to-one based on the |
|
2537 |
* Unicode cmap in this <code>Font</code>. This method does no other |
|
2538 |
* processing besides the mapping of glyphs to characters. This |
|
2539 |
* means that this method is not useful for some scripts, such |
|
2540 |
* as Arabic, Hebrew, Thai, and Indic, that require reordering, |
|
2541 |
* shaping, or ligature substitution. |
|
2542 |
* @param frc the specified <code>FontRenderContext</code> |
|
2543 |
* @param glyphCodes the specified integer array |
|
2544 |
* @return a new <code>GlyphVector</code> created with the |
|
2545 |
* specified integer array and the specified |
|
2546 |
* <code>FontRenderContext</code>. |
|
2547 |
*/ |
|
2548 |
public GlyphVector createGlyphVector( FontRenderContext frc, |
|
2549 |
int [] glyphCodes) |
|
2550 |
{ |
|
2551 |
return (GlyphVector)new StandardGlyphVector(this, glyphCodes, frc); |
|
2552 |
} |
|
2553 |
||
2554 |
/** |
|
2555 |
* Returns a new <code>GlyphVector</code> object, performing full |
|
2556 |
* layout of the text if possible. Full layout is required for |
|
2557 |
* complex text, such as Arabic or Hindi. Support for different |
|
2558 |
* scripts depends on the font and implementation. |
|
2559 |
* <p> |
|
2560 |
* Layout requires bidi analysis, as performed by |
|
2561 |
* <code>Bidi</code>, and should only be performed on text that |
|
2562 |
* has a uniform direction. The direction is indicated in the |
|
2563 |
* flags parameter,by using LAYOUT_RIGHT_TO_LEFT to indicate a |
|
2564 |
* right-to-left (Arabic and Hebrew) run direction, or |
|
2565 |
* LAYOUT_LEFT_TO_RIGHT to indicate a left-to-right (English) |
|
2566 |
* run direction. |
|
2567 |
* <p> |
|
2568 |
* In addition, some operations, such as Arabic shaping, require |
|
2569 |
* context, so that the characters at the start and limit can have |
|
2570 |
* the proper shapes. Sometimes the data in the buffer outside |
|
2571 |
* the provided range does not have valid data. The values |
|
2572 |
* LAYOUT_NO_START_CONTEXT and LAYOUT_NO_LIMIT_CONTEXT can be |
|
2573 |
* added to the flags parameter to indicate that the text before |
|
2574 |
* start, or after limit, respectively, should not be examined |
|
2575 |
* for context. |
|
2576 |
* <p> |
|
2577 |
* All other values for the flags parameter are reserved. |
|
2578 |
* |
|
2579 |
* @param frc the specified <code>FontRenderContext</code> |
|
2580 |
* @param text the text to layout |
|
2581 |
* @param start the start of the text to use for the <code>GlyphVector</code> |
|
2582 |
* @param limit the limit of the text to use for the <code>GlyphVector</code> |
|
2583 |
* @param flags control flags as described above |
|
2584 |
* @return a new <code>GlyphVector</code> representing the text between |
|
2585 |
* start and limit, with glyphs chosen and positioned so as to best represent |
|
2586 |
* the text |
|
2587 |
* @throws ArrayIndexOutOfBoundsException if start or limit is |
|
2588 |
* out of bounds |
|
2589 |
* @see java.text.Bidi |
|
2590 |
* @see #LAYOUT_LEFT_TO_RIGHT |
|
2591 |
* @see #LAYOUT_RIGHT_TO_LEFT |
|
2592 |
* @see #LAYOUT_NO_START_CONTEXT |
|
2593 |
* @see #LAYOUT_NO_LIMIT_CONTEXT |
|
2594 |
* @since 1.4 |
|
2595 |
*/ |
|
2596 |
public GlyphVector layoutGlyphVector(FontRenderContext frc, |
|
2597 |
char[] text, |
|
2598 |
int start, |
|
2599 |
int limit, |
|
2600 |
int flags) { |
|
2601 |
||
2602 |
GlyphLayout gl = GlyphLayout.get(null); // !!! no custom layout engines |
|
2603 |
StandardGlyphVector gv = gl.layout(this, frc, text, |
|
2604 |
start, limit-start, flags, null); |
|
2605 |
GlyphLayout.done(gl); |
|
2606 |
return gv; |
|
2607 |
} |
|
2608 |
||
2609 |
/** |
|
2610 |
* A flag to layoutGlyphVector indicating that text is left-to-right as |
|
2611 |
* determined by Bidi analysis. |
|
2612 |
*/ |
|
2613 |
public static final int LAYOUT_LEFT_TO_RIGHT = 0; |
|
2614 |
||
2615 |
/** |
|
2616 |
* A flag to layoutGlyphVector indicating that text is right-to-left as |
|
2617 |
* determined by Bidi analysis. |
|
2618 |
*/ |
|
2619 |
public static final int LAYOUT_RIGHT_TO_LEFT = 1; |
|
2620 |
||
2621 |
/** |
|
2622 |
* A flag to layoutGlyphVector indicating that text in the char array |
|
2623 |
* before the indicated start should not be examined. |
|
2624 |
*/ |
|
2625 |
public static final int LAYOUT_NO_START_CONTEXT = 2; |
|
2626 |
||
2627 |
/** |
|
2628 |
* A flag to layoutGlyphVector indicating that text in the char array |
|
2629 |
* after the indicated limit should not be examined. |
|
2630 |
*/ |
|
2631 |
public static final int LAYOUT_NO_LIMIT_CONTEXT = 4; |
|
2632 |
||
2633 |
||
2634 |
private static void applyTransform(AffineTransform trans, AttributeValues values) { |
|
2635 |
if (trans == null) { |
|
2636 |
throw new IllegalArgumentException("transform must not be null"); |
|
2637 |
} |
|
2638 |
values.setTransform(trans); |
|
2639 |
} |
|
2640 |
||
2641 |
private static void applyStyle(int style, AttributeValues values) { |
|
2642 |
// WEIGHT_BOLD, WEIGHT_REGULAR |
|
2643 |
values.setWeight((style & BOLD) != 0 ? 2f : 1f); |
|
2644 |
// POSTURE_OBLIQUE, POSTURE_REGULAR |
|
2645 |
values.setPosture((style & ITALIC) != 0 ? .2f : 0f); |
|
2646 |
} |
|
2647 |
||
2648 |
/* |
|
2649 |
* Initialize JNI field and method IDs |
|
2650 |
*/ |
|
2651 |
private static native void initIDs(); |
|
2652 |
} |