blob: ff32d7305d45f8c8889386926529f4d9dca71d69 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* $Id$ */
package org.apache.fop.fonts;
import java.util.Map;
import java.util.Set;
/**
* Main interface for access to font metrics.
*/
public interface FontMetrics {
/**
* Returns the "PostScript" font name (Example: "Helvetica-BoldOblique").
* @return the font name
*/
String getFontName();
/**
* Returns the font's full name (Example: "Helvetica Bold Oblique").
* @return the font's full name
*/
String getFullName();
/**
* Returns the font's family names as a Set of Strings (Example: "Helvetica").
* @return the font's family names (a Set of Strings)
*/
Set<String> getFamilyNames();
/**
* Returns the font name for font embedding (may include a prefix, Example: "1E28bcArialMT").
* @return the name for font embedding
*/
String getEmbedFontName();
/**
* Returns the type of the font.
* @return the font type
*/
FontType getFontType();
/**
* Returns the maximum ascent of the font described by this
* FontMetrics object. Note: This is not the same as getAscender().
* @param size font size
* @return ascent in milliponts
*/
int getMaxAscent(int size);
/**
* Returns the ascent of the font described by this
* FontMetrics object. It returns the nominal ascent within the em box.
* @param size font size
* @return ascent in milliponts
*/
int getAscender(int size);
/**
* Returns the size of a capital letter measured from the font's baseline.
* @param size font size
* @return height of capital characters
*/
int getCapHeight(int size);
/**
* Returns the descent of the font described by this
* FontMetrics object.
* @param size font size
* @return descent in milliponts
*/
int getDescender(int size);
/**
* Determines the typical font height of this
* FontMetrics object
* @param size font size
* @return font height in millipoints
*/
int getXHeight(int size);
/**
* Return the width (in 1/1000ths of point size) of the character at
* code point i.
* @param i code point index
* @param size font size
* @return the width of the character
*/
int getWidth(int i, int size);
/**
* Return the array of widths.
* <p>
* This is used to get an array for inserting in an output format.
* It should not be used for lookup.
* @return an array of widths
*/
int[] getWidths();
/**
* Indicates if the font has kering information.
* @return True, if kerning is available.
*/
boolean hasKerningInfo();
/**
* Returns the kerning map for the font.
* @return the kerning map
*/
Map<Integer, Map<Integer, Integer>> getKerningInfo();
}
|
