1/****************************************************************************
2 *
3 * ftsnames.c
4 *
5 * Simple interface to access SFNT name tables (which are used
6 * to hold font names, copyright info, notices, etc.) (body).
7 *
8 * This is _not_ used to retrieve glyph names!
9 *
10 * Copyright (C) 1996-2023 by
11 * David Turner, Robert Wilhelm, and Werner Lemberg.
12 *
13 * This file is part of the FreeType project, and may only be used,
14 * modified, and distributed under the terms of the FreeType project
15 * license, LICENSE.TXT. By continuing to use, modify, or distribute
16 * this file you indicate that you have read the license and
17 * understand and accept it fully.
18 *
19 */
20
21
22#include <freetype/internal/ftdebug.h>
23
24#include <freetype/ftsnames.h>
25#include <freetype/internal/tttypes.h>
26#include <freetype/internal/ftstream.h>
27
28
29#ifdef TT_CONFIG_OPTION_SFNT_NAMES
30
31
32 /* documentation is in ftsnames.h */
33
34 FT_EXPORT_DEF( FT_UInt )
35 FT_Get_Sfnt_Name_Count( FT_Face face )
36 {
37 return ( face && FT_IS_SFNT( face ) ) ? ((TT_Face)face)->num_names : 0;
38 }
39
40
41 /* documentation is in ftsnames.h */
42
43 FT_EXPORT_DEF( FT_Error )
44 FT_Get_Sfnt_Name( FT_Face face,
45 FT_UInt idx,
46 FT_SfntName *aname )
47 {
48 FT_Error error = FT_ERR( Invalid_Argument );
49
50
51 if ( aname && face && FT_IS_SFNT( face ) )
52 {
53 TT_Face ttface = (TT_Face)face;
54
55
56 if ( idx < (FT_UInt)ttface->num_names )
57 {
58 TT_Name entry = ttface->name_table.names + idx;
59
60
61 /* load name on demand */
62 if ( entry->stringLength > 0 && !entry->string )
63 {
64 FT_Memory memory = face->memory;
65 FT_Stream stream = face->stream;
66
67
68 if ( FT_QNEW_ARRAY ( entry->string, entry->stringLength ) ||
69 FT_STREAM_SEEK( entry->stringOffset ) ||
70 FT_STREAM_READ( entry->string, entry->stringLength ) )
71 {
72 FT_FREE( entry->string );
73 entry->stringLength = 0;
74 }
75 }
76
77 aname->platform_id = entry->platformID;
78 aname->encoding_id = entry->encodingID;
79 aname->language_id = entry->languageID;
80 aname->name_id = entry->nameID;
81 aname->string = (FT_Byte*)entry->string;
82 aname->string_len = entry->stringLength;
83
84 error = FT_Err_Ok;
85 }
86 }
87
88 return error;
89 }
90
91
92 /* documentation is in ftsnames.h */
93
94 FT_EXPORT_DEF( FT_Error )
95 FT_Get_Sfnt_LangTag( FT_Face face,
96 FT_UInt langID,
97 FT_SfntLangTag *alangTag )
98 {
99 FT_Error error = FT_ERR( Invalid_Argument );
100
101
102 if ( alangTag && face && FT_IS_SFNT( face ) )
103 {
104 TT_Face ttface = (TT_Face)face;
105
106
107 if ( ttface->name_table.format != 1 )
108 return FT_THROW( Invalid_Table );
109
110 if ( langID > 0x8000U &&
111 langID - 0x8000U < ttface->name_table.numLangTagRecords )
112 {
113 TT_LangTag entry = ttface->name_table.langTags +
114 ( langID - 0x8000U );
115
116
117 /* load name on demand */
118 if ( entry->stringLength > 0 && !entry->string )
119 {
120 FT_Memory memory = face->memory;
121 FT_Stream stream = face->stream;
122
123
124 if ( FT_QNEW_ARRAY ( entry->string, entry->stringLength ) ||
125 FT_STREAM_SEEK( entry->stringOffset ) ||
126 FT_STREAM_READ( entry->string, entry->stringLength ) )
127 {
128 FT_FREE( entry->string );
129 entry->stringLength = 0;
130 }
131 }
132
133 alangTag->string = (FT_Byte*)entry->string;
134 alangTag->string_len = entry->stringLength;
135
136 error = FT_Err_Ok;
137 }
138 }
139
140 return error;
141 }
142
143
144#else /* !TT_CONFIG_OPTION_SFNT_NAMES */
145
146
147 FT_EXPORT_DEF( FT_UInt )
148 FT_Get_Sfnt_Name_Count( FT_Face face )
149 {
150 FT_UNUSED( face );
151
152 return 0;
153 }
154
155
156 FT_EXPORT_DEF( FT_Error )
157 FT_Get_Sfnt_Name( FT_Face face,
158 FT_UInt idx,
159 FT_SfntName *aname )
160 {
161 FT_UNUSED( face );
162 FT_UNUSED( idx );
163 FT_UNUSED( aname );
164
165 return FT_THROW( Unimplemented_Feature );
166 }
167
168
169 FT_EXPORT_DEF( FT_Error )
170 FT_Get_Sfnt_LangTag( FT_Face face,
171 FT_UInt langID,
172 FT_SfntLangTag *alangTag )
173 {
174 FT_UNUSED( face );
175 FT_UNUSED( langID );
176 FT_UNUSED( alangTag );
177
178 return FT_THROW( Unimplemented_Feature );
179 }
180
181
182#endif /* !TT_CONFIG_OPTION_SFNT_NAMES */
183
184
185/* END */
186