~ubuntu-branches/ubuntu/karmic/pango1.0/karmic-security

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-description-new">pango_font_description_new</a>

(void);

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-description-copy">pango_font_description_copy</a>

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-description-copy-static">pango_font_description_copy_static</a>

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

href="../glib/glib-Basic-Types.html#guint"

>guint</a> <a href="pango-Fonts.html#pango-font-description-hash">pango_font_description_hash</a> (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

href="../glib/glib-Basic-Types.html#gboolean"

>gboolean</a> <a href="pango-Fonts.html#pango-font-description-equal">pango_font_description_equal</a> (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc1,

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc2);

void <a href="pango-Fonts.html#pango-font-description-free">pango_font_description_free</a> (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

void <a href="pango-Fonts.html#pango-font-descriptions-free">pango_font_descriptions_free</a> (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> **descs,

int n_descs);

void <a href="pango-Fonts.html#pango-font-description-set-family">pango_font_description_set_family</a>

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

const char *family);

void <a href="pango-Fonts.html#pango-font-description-set-family-static">pango_font_description_set_family_static</a>

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

const char *family);

const char* <a href="pango-Fonts.html#pango-font-description-get-family">pango_font_description_get_family</a>

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

void <a href="pango-Fonts.html#pango-font-description-set-style">pango_font_description_set_style</a>

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

<a href="pango-Fonts.html#PangoStyle">PangoStyle</a> style);

<a href="pango-Fonts.html#PangoStyle">PangoStyle</a> <a href="pango-Fonts.html#pango-font-description-get-style">pango_font_description_get_style</a>

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

void <a href="pango-Fonts.html#pango-font-description-set-variant">pango_font_description_set_variant</a>

100

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

101

<a href="pango-Fonts.html#PangoVariant">PangoVariant</a> variant);

102

<a href="pango-Fonts.html#PangoVariant">PangoVariant</a> <a href="pango-Fonts.html#pango-font-description-get-variant">pango_font_description_get_variant</a>

103

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

104

void <a href="pango-Fonts.html#pango-font-description-set-weight">pango_font_description_set_weight</a>

105

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

106

<a href="pango-Fonts.html#PangoWeight">PangoWeight</a> weight);

107

<a href="pango-Fonts.html#PangoWeight">PangoWeight</a> <a href="pango-Fonts.html#pango-font-description-get-weight">pango_font_description_get_weight</a>

108

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

109

void <a href="pango-Fonts.html#pango-font-description-set-stretch">pango_font_description_set_stretch</a>

110

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

111

<a href="pango-Fonts.html#PangoStretch">PangoStretch</a> stretch);

112

<a href="pango-Fonts.html#PangoStretch">PangoStretch</a> <a href="pango-Fonts.html#pango-font-description-get-stretch">pango_font_description_get_stretch</a>

113

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

114

void <a href="pango-Fonts.html#pango-font-description-set-size">pango_font_description_set_size</a> (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

115

116

href="../glib/glib-Basic-Types.html#gint"

117

>gint</a> size);

118

119

href="../glib/glib-Basic-Types.html#gint"

120

>gint</a> <a href="pango-Fonts.html#pango-font-description-get-size">pango_font_description_get_size</a> (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

121

void <a href="pango-Fonts.html#pango-font-description-set-absolute-size">pango_font_description_set_absolute_size</a>

122

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

123

double size);

124

125

href="../glib/glib-Basic-Types.html#gboolean"

126

>gboolean</a> <a href="pango-Fonts.html#pango-font-description-get-size-is-absolute">pango_font_description_get_size_is_absolute</a>

127

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

128

void <a href="pango-Fonts.html#pango-font-description-set-gravity">pango_font_description_set_gravity</a>

129

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

130

<a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> gravity);

131

<a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> <a href="pango-Fonts.html#pango-font-description-get-gravity">pango_font_description_get_gravity</a>

132

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

133

<a href="pango-Fonts.html#PangoFontMask">PangoFontMask</a> <a href="pango-Fonts.html#pango-font-description-get-set-fields">pango_font_description_get_set_fields</a>

134

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

135

void <a href="pango-Fonts.html#pango-font-description-unset-fields">pango_font_description_unset_fields</a>

136

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

137

<a href="pango-Fonts.html#PangoFontMask">PangoFontMask</a> to_unset);

138

void <a href="pango-Fonts.html#pango-font-description-merge">pango_font_description_merge</a> (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

139

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

140

141

href="../glib/glib-Basic-Types.html#gboolean"

142

>gboolean</a> replace_existing);

143

void <a href="pango-Fonts.html#pango-font-description-merge-static">pango_font_description_merge_static</a>

144

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

145

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

146

147

href="../glib/glib-Basic-Types.html#gboolean"

148

>gboolean</a> replace_existing);

149

150

href="../glib/glib-Basic-Types.html#gboolean"

151

>gboolean</a> <a href="pango-Fonts.html#pango-font-description-better-match">pango_font_description_better_match</a>

152

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

153

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *old_match,

154

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *new_match);

155

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-description-from-string">pango_font_description_from_string</a>

156

(const char *str);

157

char* <a href="pango-Fonts.html#pango-font-description-to-string">pango_font_description_to_string</a>

158

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

159

char* <a href="pango-Fonts.html#pango-font-description-to-filename">pango_font_description_to_filename</a>

160

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

161

162

<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>;

163

#define <a href="pango-Fonts.html#PANGO-TYPE-FONT-METRICS:CAPS">PANGO_TYPE_FONT_METRICS</a>

164

<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>* <a href="pango-Fonts.html#pango-font-metrics-ref">pango_font_metrics_ref</a> (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

165

void <a href="pango-Fonts.html#pango-font-metrics-unref">pango_font_metrics_unref</a> (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

166

int <a href="pango-Fonts.html#pango-font-metrics-get-ascent">pango_font_metrics_get_ascent</a> (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

167

int <a href="pango-Fonts.html#pango-font-metrics-get-descent">pango_font_metrics_get_descent</a> (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

168

int <a href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width">pango_font_metrics_get_approximate_char_width</a>

169

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

170

int <a href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width">pango_font_metrics_get_approximate_digit_width</a>

171

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

172

int <a href="pango-Fonts.html#pango-font-metrics-get-underline-thickness">pango_font_metrics_get_underline_thickness</a>

173

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

174

int <a href="pango-Fonts.html#pango-font-metrics-get-underline-position">pango_font_metrics_get_underline_position</a>

175

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

176

int <a href="pango-Fonts.html#pango-font-metrics-get-strikethrough-thickness">pango_font_metrics_get_strikethrough_thickness</a>

177

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

178

int <a href="pango-Fonts.html#pango-font-metrics-get-strikethrough-position">pango_font_metrics_get_strikethrough_position</a>

179

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);

180

181

<a href="pango-Fonts.html#PangoFont-struct">PangoFont</a>;

182

#define <a href="pango-Fonts.html#PANGO-TYPE-FONT:CAPS">PANGO_TYPE_FONT</a>

183

#define <a href="pango-Fonts.html#PANGO-FONT:CAPS">PANGO_FONT</a> (object)

184

#define <a href="pango-Fonts.html#PANGO-IS-FONT:CAPS">PANGO_IS_FONT</a> (object)

185

<a href="PangoEngineShape.html" title="PangoEngineShape">PangoEngineShape</a>* <a href="pango-Fonts.html#pango-font-find-shaper">pango_font_find_shaper</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

186

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language,

187

188

href="../glib/glib-Basic-Types.html#guint32"

189

>guint32</a> ch);

190

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-describe">pango_font_describe</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);

191

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-describe-with-absolute-size">pango_font_describe_with_absolute_size</a>

192

(<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);

193

<a href="pango-Coverage-Maps.html#PangoCoverage">PangoCoverage</a>* <a href="pango-Fonts.html#pango-font-get-coverage">pango_font_get_coverage</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

194

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);

195

void <a href="pango-Fonts.html#pango-font-get-glyph-extents">pango_font_get_glyph_extents</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

196

<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> glyph,

197

<a href="pango-Glyph-Storage.html#PangoRectangle">PangoRectangle</a> *ink_rect,

198

<a href="pango-Glyph-Storage.html#PangoRectangle">PangoRectangle</a> *logical_rect);

199

<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>* <a href="pango-Fonts.html#pango-font-get-metrics">pango_font_get_metrics</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

200

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);

201

<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* <a href="pango-Fonts.html#pango-font-get-font-map">pango_font_get_font_map</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);

202

203

<a href="pango-Fonts.html#PangoFontFamily-struct">PangoFontFamily</a>;

204

#define <a href="pango-Fonts.html#PANGO-TYPE-FONT-FAMILY:CAPS">PANGO_TYPE_FONT_FAMILY</a>

205

#define <a href="pango-Fonts.html#PANGO-FONT-FAMILY:CAPS">PANGO_FONT_FAMILY</a> (object)

206

#define <a href="pango-Fonts.html#PANGO-IS-FONT-FAMILY:CAPS">PANGO_IS_FONT_FAMILY</a> (object)

207

const char* <a href="pango-Fonts.html#pango-font-family-get-name">pango_font_family_get_name</a> (<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);

208

209

href="../glib/glib-Basic-Types.html#gboolean"

210

>gboolean</a> <a href="pango-Fonts.html#pango-font-family-is-monospace">pango_font_family_is_monospace</a> (<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);

211

void <a href="pango-Fonts.html#pango-font-family-list-faces">pango_font_family_list_faces</a> (<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family,

212

<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> ***faces,

213

int *n_faces);

214

215

<a href="pango-Fonts.html#PangoFontFace-struct">PangoFontFace</a>;

216

#define <a href="pango-Fonts.html#PANGO-TYPE-FONT-FACE:CAPS">PANGO_TYPE_FONT_FACE</a>

217

#define <a href="pango-Fonts.html#PANGO-FONT-FACE:CAPS">PANGO_FONT_FACE</a> (object)

218

#define <a href="pango-Fonts.html#PANGO-IS-FONT-FACE:CAPS">PANGO_IS_FONT_FACE</a> (object)

219

const char* <a href="pango-Fonts.html#pango-font-face-get-face-name">pango_font_face_get_face_name</a> (<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);

220

void <a href="pango-Fonts.html#pango-font-face-list-sizes">pango_font_face_list_sizes</a> (<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face,

221

int **sizes,

222

int *n_sizes);

223

<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* <a href="pango-Fonts.html#pango-font-face-describe">pango_font_face_describe</a>

224

(<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);

225

226

<a href="pango-Fonts.html#PangoFontMap-struct">PangoFontMap</a>;

227

#define <a href="pango-Fonts.html#PANGO-TYPE-FONT-MAP:CAPS">PANGO_TYPE_FONT_MAP</a>

228

#define <a href="pango-Fonts.html#PANGO-FONT-MAP:CAPS">PANGO_FONT_MAP</a> (object)

229

#define <a href="pango-Fonts.html#PANGO-IS-FONT-MAP:CAPS">PANGO_IS_FONT_MAP</a> (object)

230

<a href="pango-Fonts.html#PangoFontMapClass">PangoFontMapClass</a>;

231

#define <a href="pango-Fonts.html#PANGO-FONT-MAP-CLASS:CAPS">PANGO_FONT_MAP_CLASS</a> (klass)

232

#define <a href="pango-Fonts.html#PANGO-IS-FONT-MAP-CLASS:CAPS">PANGO_IS_FONT_MAP_CLASS</a> (klass)

233

#define <a href="pango-Fonts.html#PANGO-FONT-MAP-GET-CLASS:CAPS">PANGO_FONT_MAP_GET_CLASS</a> (obj)

234

<a href="pango-Fonts.html#PangoFont">PangoFont</a>* <a href="pango-Fonts.html#pango-font-map-load-font">pango_font_map_load_font</a> (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,

235

<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,

236

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);

237

<a href="pango-Fonts.html#PangoFontset">PangoFontset</a>* <a href="pango-Fonts.html#pango-font-map-load-fontset">pango_font_map_load_fontset</a> (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,

238

<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,

239

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

240

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);

241

void <a href="pango-Fonts.html#pango-font-map-list-families">pango_font_map_list_families</a> (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,

242

<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> ***families,

243

int *n_families);

244

const char* <a href="pango-Fonts.html#pango-font-map-get-shape-engine-type">pango_font_map_get_shape_engine_type</a>

245

(<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap);

246

247

<a href="pango-Fonts.html#PangoFontset-struct">PangoFontset</a>;

248

#define <a href="pango-Fonts.html#PANGO-TYPE-FONTSET:CAPS">PANGO_TYPE_FONTSET</a>

249

<a href="pango-Fonts.html#PangoFontsetClass">PangoFontsetClass</a>;

250

<a href="pango-Fonts.html#PangoFont">PangoFont</a>* <a href="pango-Fonts.html#pango-fontset-get-font">pango_fontset_get_font</a> (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

251

252

href="../glib/glib-Basic-Types.html#guint"

253

>guint</a> wc);

254

<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>* <a href="pango-Fonts.html#pango-fontset-get-metrics">pango_fontset_get_metrics</a> (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset);

255

256

href="../glib/glib-Basic-Types.html#gboolean"

257

>gboolean</a> (<a href="pango-Fonts.html#PangoFontsetForeachFunc">*PangoFontsetForeachFunc</a>) (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

258

<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

259

260

href="../glib/glib-Basic-Types.html#gpointer"

261

>gpointer</a> data);

262

void <a href="pango-Fonts.html#pango-fontset-foreach">pango_fontset_foreach</a> (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

263

<a href="pango-Fonts.html#PangoFontsetForeachFunc">PangoFontsetForeachFunc</a> func,

264

265

href="../glib/glib-Basic-Types.html#gpointer"

266

>gpointer</a> data);

267

<a href="pango-Fonts.html#PangoFontsetSimple-struct">PangoFontsetSimple</a>;

268

#define <a href="pango-Fonts.html#PANGO-TYPE-FONTSET-SIMPLE:CAPS">PANGO_TYPE_FONTSET_SIMPLE</a>

269

<a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>* <a href="pango-Fonts.html#pango-fontset-simple-new">pango_fontset_simple_new</a>

270

(<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);

271

void <a href="pango-Fonts.html#pango-fontset-simple-append">pango_fontset_simple_append</a> (<a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset,

272

<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);

273

int <a href="pango-Fonts.html#pango-fontset-simple-size">pango_fontset_simple_size</a> (<a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset);

274

275

276

</pre>

277

</div>

278

279

<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>

280

281

282

283

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

284

>GObject</a>

285

+----PangoFont

286

+----<a href="PangoFcFont.html" title="PangoFcFont">PangoFcFont</a>

287

</pre>

288

289

290

291

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

292

>GObject</a>

293

+----PangoFontFamily

294

</pre>

295

296

297

298

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

299

>GObject</a>

300

+----PangoFontFace

301

</pre>

302

303

304

305

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

306

>GObject</a>

307

+----PangoFontMap

308

+----<a href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a>

309

</pre>

310

311

312

313

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

314

>GObject</a>

315

+----PangoFontset

316

+----<a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>

317

</pre>

318

319

320

321

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

322

>GObject</a>

323

+----<a href="pango-Fonts.html#PangoFontset">PangoFontset</a>

324

+----PangoFontsetSimple

325

</pre>

326

</div>

327

328

<a name="derived_interfaces"></a><h2>Known Derived Interfaces</h2>

329

<p>

330

PangoFontMap is required by

331

<a href="pango-Cairo-Rendering.html#PangoCairoFontMap">PangoCairoFontMap</a>.</p>

332

</div>

333

334

<a name="desc"></a><h2>Description</h2>

335

<p>

336

Pango supports a flexible architecture where a

337

particular rendering architecture can supply an

338

implementation of fonts. The <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure

339

represents an abstract rendering-system-independent font.

340

Pango provides routines to list available fonts, and

341

to load a font of a given description.

342

</p>

343

</div>

344

345

<a name="details"></a><h2>Details</h2>

346

347

348

<a name="PangoFontDescription"></a>PangoFontDescription</h3>

349

<a class="indexterm" name="id3042114"></a><pre class="programlisting">typedef struct _PangoFontDescription PangoFontDescription;</pre>

350

<p>

351

The <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure represents the description

352

of an ideal font. These structures are used both to list

353

what fonts are available on the system and also for specifying

354

the characteristics of a font to load.

355

</p>

356

</div>

357

<hr>

358

359

360

<a name="PANGO-TYPE-FONT-DESCRIPTION:CAPS"></a>PANGO_TYPE_FONT_DESCRIPTION</h3>

361

<a class="indexterm" name="id3042156"></a><pre class="programlisting">#define PANGO_TYPE_FONT_DESCRIPTION (pango_font_description_get_type ())

362

</pre>

363

<p>

364

The <a

365

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

366

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

367

</p>

368

</div>

369

<hr>

370

371

372

<a name="PangoStyle"></a>enum PangoStyle</h3>

373

<a class="indexterm" name="id3042202"></a><pre class="programlisting">typedef enum {

374

PANGO_STYLE_NORMAL,

375

PANGO_STYLE_OBLIQUE,

376

PANGO_STYLE_ITALIC

377

} PangoStyle;

378

</pre>

379

<p>

380

An enumeration specifying the various slant styles possible for a font.</p>

381

<p>

382

</p>

383

384

385

<tbody>

386

<tr>

387

<td>

388

<span class="term"><a name="PANGO-STYLE-NORMAL:CAPS"></a><code class="literal">PANGO_STYLE_NORMAL</code></span></td>

389

<td> the font is upright.

390

</td>

391

</tr>

392

<tr>

393

<td>

394

<span class="term"><a name="PANGO-STYLE-OBLIQUE:CAPS"></a><code class="literal">PANGO_STYLE_OBLIQUE</code></span></td>

395

<td> the font is slanted, but in a roman style.

396

</td>

397

</tr>

398

<tr>

399

<td>

400

<span class="term"><a name="PANGO-STYLE-ITALIC:CAPS"></a><code class="literal">PANGO_STYLE_ITALIC</code></span></td>

401

<td> the font is slanted in an italic style.

402

</td>

403

</tr>

404

</tbody>

405

</table></div>

406

</div>

407

<hr>

408

409

410

<a name="PANGO-TYPE-STYLE:CAPS"></a>PANGO_TYPE_STYLE</h3>

411

<a class="indexterm" name="id3042309"></a><pre class="programlisting">#define PANGO_TYPE_STYLE (pango_style_get_type())

412

</pre>

413

<p>

414

The <a

415

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

416

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a>.

417

</p>

418

</div>

419

<hr>

420

421

422

<a name="PangoWeight"></a>enum PangoWeight</h3>

423

<a class="indexterm" name="id3042352"></a><pre class="programlisting">typedef enum {

424

PANGO_WEIGHT_ULTRALIGHT = 200,

425

PANGO_WEIGHT_LIGHT = 300,

426

PANGO_WEIGHT_NORMAL = 400,

427

PANGO_WEIGHT_SEMIBOLD = 600,

428

PANGO_WEIGHT_BOLD = 700,

429

PANGO_WEIGHT_ULTRABOLD = 800,

430

PANGO_WEIGHT_HEAVY = 900

431

} PangoWeight;

432

</pre>

433

<p>

434

An enumeration specifying the weight (boldness) of a font. This is a numerical

435

value ranging from 100 to 900, but there are some predefined values:

436

</p>

437

438

439

<tbody>

440

<tr>

441

<td>

442

<span class="term"><a name="PANGO-WEIGHT-ULTRALIGHT:CAPS"></a><code class="literal">PANGO_WEIGHT_ULTRALIGHT</code></span></td>

443

<td>the ultralight weight (= 200)

444

</td>

445

</tr>

446

<tr>

447

<td>

448

<span class="term"><a name="PANGO-WEIGHT-LIGHT:CAPS"></a><code class="literal">PANGO_WEIGHT_LIGHT</code></span></td>

449

<td> the light weight (=300)

450

</td>

451

</tr>

452

<tr>

453

<td>

454

<span class="term"><a name="PANGO-WEIGHT-NORMAL:CAPS"></a><code class="literal">PANGO_WEIGHT_NORMAL</code></span></td>

455

<td>the default weight (= 400)

456

</td>

457

</tr>

458

<tr>

459

<td>

460

<span class="term"><a name="PANGO-WEIGHT-SEMIBOLD:CAPS"></a><code class="literal">PANGO_WEIGHT_SEMIBOLD</code></span></td>

461

<td>a weight intermediate between normal and bold (=600)

462

</td>

463

</tr>

464

<tr>

465

<td>

466

<span class="term"><a name="PANGO-WEIGHT-BOLD:CAPS"></a><code class="literal">PANGO_WEIGHT_BOLD</code></span></td>

467

<td>the bold weight (= 700)

468

</td>

469

</tr>

470

<tr>

471

<td>

472

<span class="term"><a name="PANGO-WEIGHT-ULTRABOLD:CAPS"></a><code class="literal">PANGO_WEIGHT_ULTRABOLD</code></span></td>

473

<td>the ultrabold weight (= 800)

474

</td>

475

</tr>

476

<tr>

477

<td>

478

<span class="term"><a name="PANGO-WEIGHT-HEAVY:CAPS"></a><code class="literal">PANGO_WEIGHT_HEAVY</code></span></td>

479

<td>the heavy weight (= 900)

480

481

</td>

482

</tr>

483

</tbody>

484

</table></div>

485

</div>

486

<hr>

487

488

489

<a name="PANGO-TYPE-WEIGHT:CAPS"></a>PANGO_TYPE_WEIGHT</h3>

490

<a class="indexterm" name="id3042550"></a><pre class="programlisting">#define PANGO_TYPE_WEIGHT (pango_weight_get_type())

491

</pre>

492

<p>

493

The <a

494

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

495

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a>.

496

</p>

497

</div>

498

<hr>

499

500

501

<a name="PangoVariant"></a>enum PangoVariant</h3>

502

<a class="indexterm" name="id3042594"></a><pre class="programlisting">typedef enum {

503

PANGO_VARIANT_NORMAL,

504

PANGO_VARIANT_SMALL_CAPS

505

} PangoVariant;

506

</pre>

507

<p>

508

An enumeration specifying capitalization variant of the font.

509

</p>

510

511

512

<tbody>

513

<tr>

514

<td>

515

<span class="term"><a name="PANGO-VARIANT-NORMAL:CAPS"></a><code class="literal">PANGO_VARIANT_NORMAL</code></span></td>

516

<td>A normal font.

517

</td>

518

</tr>

519

<tr>

520

<td>

521

<span class="term"><a name="PANGO-VARIANT-SMALL-CAPS:CAPS"></a><code class="literal">PANGO_VARIANT_SMALL_CAPS</code></span></td>

522

<td>A font with the lower case characters

523

replaced by smaller variants of the capital characters.

524

525

</td>

526

</tr>

527

</tbody>

528

</table></div>

529

</div>

530

<hr>

531

532

533

<a name="PANGO-TYPE-VARIANT:CAPS"></a>PANGO_TYPE_VARIANT</h3>

534

<a class="indexterm" name="id3042676"></a><pre class="programlisting">#define PANGO_TYPE_VARIANT (pango_variant_get_type())

535

</pre>

536

<p>

537

The <a

538

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

539

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a>.

540

</p>

541

</div>

542

<hr>

543

544

545

<a name="PangoStretch"></a>enum PangoStretch</h3>

546

<a class="indexterm" name="id3042720"></a><pre class="programlisting">typedef enum {

547

PANGO_STRETCH_ULTRA_CONDENSED,

548

PANGO_STRETCH_EXTRA_CONDENSED,

549

PANGO_STRETCH_CONDENSED,

550

PANGO_STRETCH_SEMI_CONDENSED,

551

PANGO_STRETCH_NORMAL,

552

PANGO_STRETCH_SEMI_EXPANDED,

553

PANGO_STRETCH_EXPANDED,

554

PANGO_STRETCH_EXTRA_EXPANDED,

555

PANGO_STRETCH_ULTRA_EXPANDED

556

} PangoStretch;

557

</pre>

558

<p>

559

An enumeration specifying the width of the font relative to other designs

560

within a family.

561

</p>

562

563

564

<tbody>

565

<tr>

566

<td>

567

<span class="term"><a name="PANGO-STRETCH-ULTRA-CONDENSED:CAPS"></a><code class="literal">PANGO_STRETCH_ULTRA_CONDENSED</code></span></td>

568

<td>ultra condensed width

569

</td>

570

</tr>

571

<tr>

572

<td>

573

<span class="term"><a name="PANGO-STRETCH-EXTRA-CONDENSED:CAPS"></a><code class="literal">PANGO_STRETCH_EXTRA_CONDENSED</code></span></td>

574

<td>extra condensed width

575

</td>

576

</tr>

577

<tr>

578

<td>

579

<span class="term"><a name="PANGO-STRETCH-CONDENSED:CAPS"></a><code class="literal">PANGO_STRETCH_CONDENSED</code></span></td>

580

<td>condensed width

581

</td>

582

</tr>

583

<tr>

584

<td>

585

<span class="term"><a name="PANGO-STRETCH-SEMI-CONDENSED:CAPS"></a><code class="literal">PANGO_STRETCH_SEMI_CONDENSED</code></span></td>

586

<td>semi condensed width

587

</td>

588

</tr>

589

<tr>

590

<td>

591

<span class="term"><a name="PANGO-STRETCH-NORMAL:CAPS"></a><code class="literal">PANGO_STRETCH_NORMAL</code></span></td>

592

<td>the normal width

593

</td>

594

</tr>

595

<tr>

596

<td>

597

<span class="term"><a name="PANGO-STRETCH-SEMI-EXPANDED:CAPS"></a><code class="literal">PANGO_STRETCH_SEMI_EXPANDED</code></span></td>

598

<td>semi expanded width

599

</td>

600

</tr>

601

<tr>

602

<td>

603

<span class="term"><a name="PANGO-STRETCH-EXPANDED:CAPS"></a><code class="literal">PANGO_STRETCH_EXPANDED</code></span></td>

604

<td>expanded width

605

</td>

606

</tr>

607

<tr>

608

<td>

609

<span class="term"><a name="PANGO-STRETCH-EXTRA-EXPANDED:CAPS"></a><code class="literal">PANGO_STRETCH_EXTRA_EXPANDED</code></span></td>

610

<td>extra expanded width

611

</td>

612

</tr>

613

<tr>

614

<td>

615

<span class="term"><a name="PANGO-STRETCH-ULTRA-EXPANDED:CAPS"></a><code class="literal">PANGO_STRETCH_ULTRA_EXPANDED</code></span></td>

616

<td>ultra expanded width

617

618

</td>

619

</tr>

620

</tbody>

621

</table></div>

622

</div>

623

<hr>

624

625

626

<a name="PANGO-TYPE-STRETCH:CAPS"></a>PANGO_TYPE_STRETCH</h3>

627

<a class="indexterm" name="id3042964"></a><pre class="programlisting">#define PANGO_TYPE_STRETCH (pango_stretch_get_type())

628

</pre>

629

<p>

630

The <a

631

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

632

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoStretch"><span class="type">PangoStretch</span></a>.

633

</p>

634

</div>

635

<hr>

636

637

638

<a name="PangoFontMask"></a>enum PangoFontMask</h3>

639

<a class="indexterm" name="id3043009"></a><pre class="programlisting">typedef enum {

640

PANGO_FONT_MASK_FAMILY = 1 << 0,

641

PANGO_FONT_MASK_STYLE = 1 << 1,

642

PANGO_FONT_MASK_VARIANT = 1 << 2,

643

PANGO_FONT_MASK_WEIGHT = 1 << 3,

644

PANGO_FONT_MASK_STRETCH = 1 << 4,

645

PANGO_FONT_MASK_SIZE = 1 << 5,

646

PANGO_FONT_MASK_GRAVITY = 1 << 6

647

} PangoFontMask;

648

</pre>

649

<p>

650

The bits in a <a href="pango-Fonts.html#PangoFontMask"><span class="type">PangoFontMask</span></a> correspond to fields in a

651

<a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> that have been set.

652

</p>

653

654

655

<tbody>

656

<tr>

657

<td>

658

<span class="term"><a name="PANGO-FONT-MASK-FAMILY:CAPS"></a><code class="literal">PANGO_FONT_MASK_FAMILY</code></span></td>

659

<td>the font family is specified.

660

</td>

661

</tr>

662

<tr>

663

<td>

664

<span class="term"><a name="PANGO-FONT-MASK-STYLE:CAPS"></a><code class="literal">PANGO_FONT_MASK_STYLE</code></span></td>

665

<td>the font style is specified.

666

</td>

667

</tr>

668

<tr>

669

<td>

670

<span class="term"><a name="PANGO-FONT-MASK-VARIANT:CAPS"></a><code class="literal">PANGO_FONT_MASK_VARIANT</code></span></td>

671

<td>the font variant is specified.

672

</td>

673

</tr>

674

<tr>

675

<td>

676

<span class="term"><a name="PANGO-FONT-MASK-WEIGHT:CAPS"></a><code class="literal">PANGO_FONT_MASK_WEIGHT</code></span></td>

677

<td>the font weight is specified.

678

</td>

679

</tr>

680

<tr>

681

<td>

682

<span class="term"><a name="PANGO-FONT-MASK-STRETCH:CAPS"></a><code class="literal">PANGO_FONT_MASK_STRETCH</code></span></td>

683

<td>the font stretch is specified.

684

</td>

685

</tr>

686

<tr>

687

<td>

688

<span class="term"><a name="PANGO-FONT-MASK-SIZE:CAPS"></a><code class="literal">PANGO_FONT_MASK_SIZE</code></span></td>

689

<td>the font size is specified.

690

</td>

691

</tr>

692

<tr>

693

<td>

694

<span class="term"><a name="PANGO-FONT-MASK-GRAVITY:CAPS"></a><code class="literal">PANGO_FONT_MASK_GRAVITY</code></span></td>

695

<td>the font gravity is specified (Since: 1.16.)

696

697

</td>

698

</tr>

699

</tbody>

700

</table></div>

701

</div>

702

<hr>

703

704

705

<a name="PANGO-TYPE-FONT-MASK:CAPS"></a>PANGO_TYPE_FONT_MASK</h3>

706

<a class="indexterm" name="id3043231"></a><pre class="programlisting">#define PANGO_TYPE_FONT_MASK (pango_font_mask_get_type())

707

</pre>

708

<p>

709

The <a

710

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

711

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontMask"><span class="type">PangoFontMask</span></a>.

712

</p>

713

</div>

714

<hr>

715

716

717

<a name="pango-font-description-new"></a>pango_font_description_new ()</h3>

718

<a class="indexterm" name="id3043276"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_description_new

719

(void);</pre>

720

<p>

721

Creates a new font description structure with all fields unset.</p>

722

<p>

723

724

</p>

725

726

727

728

<td>

729

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

730

<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which

731

should be freed using <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>.

732

</td>

733

</tr></tbody>

734

</table></div>

735

</div>

736

<hr>

737

738

739

<a name="pango-font-description-copy"></a>pango_font_description_copy ()</h3>

740

<a class="indexterm" name="id3043351"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_description_copy

741

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

742

<p>

743

Make a copy of a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</p>

744

<p>

745

746

</p>

747

748

749

<tbody>

750

<tr>

751

<td>

752

753

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

754

</td>

755

</tr>

756

<tr>

757

<td>

758

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

759

<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

760

be freed with <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>.

761

</td>

762

</tr>

763

</tbody>

764

</table></div>

765

</div>

766

<hr>

767

768

769

<a name="pango-font-description-copy-static"></a>pango_font_description_copy_static ()</h3>

770

<a class="indexterm" name="id3043465"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_description_copy_static

771

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

772

<p>

773

Like <a href="pango-Fonts.html#pango-font-description-copy"><code class="function">pango_font_description_copy()</code></a>, but only a shallow copy is made

774

of the family name and other allocated fields. The result can only

775

be used until <em class="parameter"><code>desc</code></em> is modified or freed. This is meant to be used

776

when the copy is only needed temporarily.</p>

777

<p>

778

779

</p>

780

781

782

<tbody>

783

<tr>

784

<td>

785

786

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

787

</td>

788

</tr>

789

<tr>

790

<td>

791

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

792

<td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should

793

be freed with <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>.

794

</td>

795

</tr>

796

</tbody>

797

</table></div>

798

</div>

799

<hr>

800

801

802

<a name="pango-font-description-hash"></a>pango_font_description_hash ()</h3>

803

<a class="indexterm" name="id3043590"></a><pre class="programlisting"><a

804

href="../glib/glib-Basic-Types.html#guint"

805

>guint</a> pango_font_description_hash (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

806

<p>

807

Computes a hash of a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitable

808

to be used, for example, as an argument to <a

809

href="../glib/glib-Hash-Tables.html#g-hash-table-new"

810

><code class="function">g_hash_table_new()</code></a>.

811

The hash value is independent of <em class="parameter"><code>desc->mask</code></em>.</p>

812

<p>

813

814

</p>

815

816

817

<tbody>

818

<tr>

819

<td>

820

821

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

822

</td>

823

</tr>

824

<tr>

825

<td>

826

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

827

<td> the hash value.

828

</td>

829

</tr>

830

</tbody>

831

</table></div>

832

</div>

833

<hr>

834

835

836

<a name="pango-font-description-equal"></a>pango_font_description_equal ()</h3>

837

<a class="indexterm" name="id3043700"></a><pre class="programlisting"><a

838

href="../glib/glib-Basic-Types.html#gboolean"

839

>gboolean</a> pango_font_description_equal (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc1,

840

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc2);</pre>

841

<p>

842

Compares two font descriptions for equality. Two font descriptions

843

are considered equal if the fonts they describe are provably identical.

844

This means that their masks do not have to match, as long as other fields

845

are all the same. (Two font descriptions may result in identical fonts

846

being loaded, but still compare <a

847

href="../glib/glib-Standard-Macros.html#FALSE:CAPS"

848

><code class="literal">FALSE</code></a>.)</p>

849

<p>

850

851

</p>

852

853

854

<tbody>

855

<tr>

856

<td>

857

858

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

859

</td>

860

</tr>

861

<tr>

862

<td>

863

864

<td> another <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

865

</td>

866

</tr>

867

<tr>

868

<td>

869

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

870

<td> <a

871

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

872

><code class="literal">TRUE</code></a> if the two font descriptions are identical,

873

874

href="../glib/glib-Standard-Macros.html#FALSE:CAPS"

875

><code class="literal">FALSE</code></a> otherwise.

876

</td>

877

</tr>

878

</tbody>

879

</table></div>

880

</div>

881

<hr>

882

883

884

<a name="pango-font-description-free"></a>pango_font_description_free ()</h3>

885

<a class="indexterm" name="id3043851"></a><pre class="programlisting">void pango_font_description_free (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

886

<p>

887

Frees a font description.</p>

888

<p>

889

890

</p>

891

892

893

894

<td>

895

896

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

897

</td>

898

</tr></tbody>

899

</table></div>

900

</div>

901

<hr>

902

903

904

<a name="pango-font-descriptions-free"></a>pango_font_descriptions_free ()</h3>

905

<a class="indexterm" name="id3043922"></a><pre class="programlisting">void pango_font_descriptions_free (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> **descs,

906

int n_descs);</pre>

907

<p>

908

Frees a list of font descriptions from <code class="function">pango_font_map_list_fonts()</code></p>

909

<p>

910

911

</p>

912

913

914

<tbody>

915

<tr>

916

<td>

917

<span class="term"><em class="parameter"><code>descs</code></em> :</span></td>

918

<td> a pointer to an array of <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

919

</td>

920

</tr>

921

<tr>

922

<td>

923

<span class="term"><em class="parameter"><code>n_descs</code></em> :</span></td>

924

<td> number of font descriptions in <em class="parameter"><code>descs</code></em>

925

</td>

926

</tr>

927

</tbody>

928

</table></div>

929

</div>

930

<hr>

931

932

933

<a name="pango-font-description-set-family"></a>pango_font_description_set_family ()</h3>

934

<a class="indexterm" name="id3044035"></a><pre class="programlisting">void pango_font_description_set_family

935

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

936

const char *family);</pre>

937

<p>

938

Sets the family name field of a font description. The family

939

name represents a family of related font styles, and will

940

resolve to a particular <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>. In some uses of

941

<a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, it is also possible to use a comma

942

separated list of family names for this field.</p>

943

<p>

944

945

</p>

946

947

948

<tbody>

949

<tr>

950

<td>

951

952

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

953

</td>

954

</tr>

955

<tr>

956

<td>

957

<span class="term"><em class="parameter"><code>family</code></em> :</span></td>

958

<td> a string representing the family name.

959

</td>

960

</tr>

961

</tbody>

962

</table></div>

963

</div>

964

<hr>

965

966

967

<a name="pango-font-description-set-family-static"></a>pango_font_description_set_family_static ()</h3>

968

<a class="indexterm" name="id3044151"></a><pre class="programlisting">void pango_font_description_set_family_static

969

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

970

const char *family);</pre>

971

<p>

972

Like <a href="pango-Fonts.html#pango-font-description-set-family"><code class="function">pango_font_description_set_family()</code></a>, except that no

973

copy of <em class="parameter"><code>family</code></em> is made. The caller must make sure that the

974

string passed in stays around until <em class="parameter"><code>desc</code></em> has been freed

975

or the name is set again. This function can be used if

976

<em class="parameter"><code>family</code></em> is a static string such as a C string literal, or

977

if <em class="parameter"><code>desc</code></em> is only needed temporarily.</p>

978

<p>

979

980

</p>

981

982

983

<tbody>

984

<tr>

985

<td>

986

987

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

988

</td>

989

</tr>

990

<tr>

991

<td>

992

<span class="term"><em class="parameter"><code>family</code></em> :</span></td>

993

<td> a string representing the family name.

994

</td>

995

</tr>

996

</tbody>

997

</table></div>

998

</div>

999

<hr>

1000

1001

1002

<a name="pango-font-description-get-family"></a>pango_font_description_get_family ()</h3>

1003

<a class="indexterm" name="id3044286"></a><pre class="programlisting">const char* pango_font_description_get_family

1004

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1005

<p>

1006

Gets the family name field of a font description. See

1007

<a href="pango-Fonts.html#pango-font-description-set-family"><code class="function">pango_font_description_set_family()</code></a>.</p>

1008

<p>

1009

1010

</p>

1011

1012

1013

<tbody>

1014

<tr>

1015

<td>

1016

1017

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

1018

</td>

1019

</tr>

1020

<tr>

1021

<td>

1022

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1023

<td> the family name field for the font description, or

1024

1025

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

1026

><code class="literal">NULL</code></a> if not previously set. This has the same life-time

1027

as the font description itself and should not be freed.

1028

</td>

1029

</tr>

1030

</tbody>

1031

</table></div>

1032

</div>

1033

<hr>

1034

1035

1036

<a name="pango-font-description-set-style"></a>pango_font_description_set_style ()</h3>

1037

<a class="indexterm" name="id3044396"></a><pre class="programlisting">void pango_font_description_set_style

1038

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1039

<a href="pango-Fonts.html#PangoStyle">PangoStyle</a> style);</pre>

1040

<p>

1041

Sets the style field of a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The

1042

<a href="pango-Fonts.html#PangoStyle"><span class="type">PangoStyle</span></a> enumeration describes whether the font is slanted and

1043

the manner in which it is slanted; it can be either

1044

<a href="pango-Fonts.html#PANGO-STYLE-NORMAL:CAPS"><span class="type">PANGO_STYLE_NORMAL</span></a>, <a href="pango-Fonts.html#PANGO-STYLE-ITALIC:CAPS"><span class="type">PANGO_STYLE_ITALIC</span></a>, or <a href="pango-Fonts.html#PANGO-STYLE-OBLIQUE:CAPS"><span class="type">PANGO_STYLE_OBLIQUE</span></a>.

1045

Most fonts will either have a italic style or an oblique

1046

style, but not both, and font matching in Pango will

1047

match italic specifications with oblique fonts and vice-versa

1048

if an exact match is not found.</p>

1049

<p>

1050

1051

</p>

1052

1053

1054

<tbody>

1055

<tr>

1056

<td>

1057

1058

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1059

</td>

1060

</tr>

1061

<tr>

1062

<td>

1063

<span class="term"><em class="parameter"><code>style</code></em> :</span></td>

1064

<td> the style for the font description

1065

</td>

1066

</tr>

1067

</tbody>

1068

</table></div>

1069

</div>

1070

<hr>

1071

1072

1073

<a name="pango-font-description-get-style"></a>pango_font_description_get_style ()</h3>

1074

<a class="indexterm" name="id3044542"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoStyle">PangoStyle</a> pango_font_description_get_style

1075

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1076

<p>

1077

Gets the style field of a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See

1078

<a href="pango-Fonts.html#pango-font-description-set-style"><code class="function">pango_font_description_set_style()</code></a>.</p>

1079

<p>

1080

1081

</p>

1082

1083

1084

<tbody>

1085

<tr>

1086

<td>

1087

1088

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1089

</td>

1090

</tr>

1091

<tr>

1092

<td>

1093

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1094

<td> the style field for the font description.

1095

Use <a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

1096

the field was explicitly set or not.

1097

</td>

1098

</tr>

1099

</tbody>

1100

</table></div>

1101

</div>

1102

<hr>

1103

1104

1105

<a name="pango-font-description-set-variant"></a>pango_font_description_set_variant ()</h3>

1106

<a class="indexterm" name="id3044660"></a><pre class="programlisting">void pango_font_description_set_variant

1107

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1108

<a href="pango-Fonts.html#PangoVariant">PangoVariant</a> variant);</pre>

1109

<p>

1110

Sets the variant field of a font description. The <a href="pango-Fonts.html#PangoVariant"><span class="type">PangoVariant</span></a>

1111

can either be <a href="pango-Fonts.html#PANGO-VARIANT-NORMAL:CAPS"><code class="literal">PANGO_VARIANT_NORMAL</code></a> or <a href="pango-Fonts.html#PANGO-VARIANT-SMALL-CAPS:CAPS"><code class="literal">PANGO_VARIANT_SMALL_CAPS</code></a>.</p>

1112

<p>

1113

1114

</p>

1115

1116

1117

<tbody>

1118

<tr>

1119

<td>

1120

1121

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1122

</td>

1123

</tr>

1124

<tr>

1125

<td>

1126

<span class="term"><em class="parameter"><code>variant</code></em> :</span></td>

1127

<td> the variant type for the font description.

1128

</td>

1129

</tr>

1130

</tbody>

1131

</table></div>

1132

</div>

1133

<hr>

1134

1135

1136

<a name="pango-font-description-get-variant"></a>pango_font_description_get_variant ()</h3>

1137

<a class="indexterm" name="id3044789"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoVariant">PangoVariant</a> pango_font_description_get_variant

1138

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1139

<p>

1140

Gets the variant field of a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. See

1141

<a href="pango-Fonts.html#pango-font-description-set-variant"><code class="function">pango_font_description_set_variant()</code></a>.</p>

1142

<p>

1143

1144

</p>

1145

1146

1147

<tbody>

1148

<tr>

1149

<td>

1150

1151

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

1152

</td>

1153

</tr>

1154

<tr>

1155

<td>

1156

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1157

<td> the variant field for the font description. Use

1158

<a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

1159

the field was explicitly set or not.

1160

</td>

1161

</tr>

1162

</tbody>

1163

</table></div>

1164

</div>

1165

<hr>

1166

1167

1168

<a name="pango-font-description-set-weight"></a>pango_font_description_set_weight ()</h3>

1169

<a class="indexterm" name="id3044907"></a><pre class="programlisting">void pango_font_description_set_weight

1170

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1171

<a href="pango-Fonts.html#PangoWeight">PangoWeight</a> weight);</pre>

1172

<p>

1173

Sets the weight field of a font description. The weight field

1174

specifies how bold or light the font should be. In addition

1175

to the values of the <a href="pango-Fonts.html#PangoWeight"><span class="type">PangoWeight</span></a> enumeration, other intermediate

1176

numeric values are possible.</p>

1177

<p>

1178

1179

</p>

1180

1181

1182

<tbody>

1183

<tr>

1184

<td>

1185

1186

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1187

</td>

1188

</tr>

1189

<tr>

1190

<td>

1191

<span class="term"><em class="parameter"><code>weight</code></em> :</span></td>

1192

<td> the weight for the font description.

1193

</td>

1194

</tr>

1195

</tbody>

1196

</table></div>

1197

</div>

1198

<hr>

1199

1200

1201

<a name="pango-font-description-get-weight"></a>pango_font_description_get_weight ()</h3>

1202

<a class="indexterm" name="id3045014"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoWeight">PangoWeight</a> pango_font_description_get_weight

1203

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1204

<p>

1205

Gets the weight field of a font description. See

1206

<a href="pango-Fonts.html#pango-font-description-set-weight"><code class="function">pango_font_description_set_weight()</code></a>.</p>

1207

<p>

1208

1209

</p>

1210

1211

1212

<tbody>

1213

<tr>

1214

<td>

1215

1216

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1217

</td>

1218

</tr>

1219

<tr>

1220

<td>

1221

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1222

<td> the weight field for the font description. Use

1223

<a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

1224

the field was explicitly set or not.

1225

</td>

1226

</tr>

1227

</tbody>

1228

</table></div>

1229

</div>

1230

<hr>

1231

1232

1233

<a name="pango-font-description-set-stretch"></a>pango_font_description_set_stretch ()</h3>

1234

<a class="indexterm" name="id3045123"></a><pre class="programlisting">void pango_font_description_set_stretch

1235

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1236

<a href="pango-Fonts.html#PangoStretch">PangoStretch</a> stretch);</pre>

1237

<p>

1238

Sets the stretch field of a font description. The stretch field

1239

specifies how narrow or wide the font should be.</p>

1240

<p>

1241

1242

</p>

1243

1244

1245

<tbody>

1246

<tr>

1247

<td>

1248

1249

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1250

</td>

1251

</tr>

1252

<tr>

1253

<td>

1254

<span class="term"><em class="parameter"><code>stretch</code></em> :</span></td>

1255

<td> the stretch for the font description

1256

</td>

1257

</tr>

1258

</tbody>

1259

</table></div>

1260

</div>

1261

<hr>

1262

1263

1264

<a name="pango-font-description-get-stretch"></a>pango_font_description_get_stretch ()</h3>

1265

<a class="indexterm" name="id3045221"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoStretch">PangoStretch</a> pango_font_description_get_stretch

1266

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1267

<p>

1268

Gets the stretch field of a font description.

1269

See <a href="pango-Fonts.html#pango-font-description-set-stretch"><code class="function">pango_font_description_set_stretch()</code></a>.</p>

1270

<p>

1271

1272

</p>

1273

1274

1275

<tbody>

1276

<tr>

1277

<td>

1278

1279

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

1280

</td>

1281

</tr>

1282

<tr>

1283

<td>

1284

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1285

<td> the stretch field for the font description. Use

1286

<a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

1287

the field was explicitly set or not.

1288

</td>

1289

</tr>

1290

</tbody>

1291

</table></div>

1292

</div>

1293

<hr>

1294

1295

1296

<a name="pango-font-description-set-size"></a>pango_font_description_set_size ()</h3>

1297

<a class="indexterm" name="id3045330"></a><pre class="programlisting">void pango_font_description_set_size (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1298

1299

href="../glib/glib-Basic-Types.html#gint"

1300

>gint</a> size);</pre>

1301

<p>

1302

Sets the size field of a font description in fractional points. This is mutually

1303

exclusive with <a href="pango-Fonts.html#pango-font-description-set-absolute-size"><code class="function">pango_font_description_set_absolute_size()</code></a>.</p>

1304

<p>

1305

1306

</p>

1307

1308

1309

<tbody>

1310

<tr>

1311

<td>

1312

1313

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1314

</td>

1315

</tr>

1316

<tr>

1317

<td>

1318

1319

<td> the size of the font in points, scaled by PANGO_SCALE. (That is,

1320

a <em class="parameter"><code>size</code></em> value of 10 * PANGO_SCALE is a 10 point font. The conversion

1321

factor between points and device units depends on system configuration

1322

and the output device. For screen display, a logical DPI of 96 is

1323

common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3

1324

pixel font. Use <a href="pango-Fonts.html#pango-font-description-set-absolute-size"><code class="function">pango_font_description_set_absolute_size()</code></a> if you need

1325

a particular size in device units.

1326

</td>

1327

</tr>

1328

</tbody>

1329

</table></div>

1330

</div>

1331

<hr>

1332

1333

1334

<a name="pango-font-description-get-size"></a>pango_font_description_get_size ()</h3>

1335

<a class="indexterm" name="id3045462"></a><pre class="programlisting"><a

1336

href="../glib/glib-Basic-Types.html#gint"

1337

>gint</a> pango_font_description_get_size (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1338

<p>

1339

Gets the size field of a font description.

1340

See <a href="pango-Fonts.html#pango-font-description-set-size"><code class="function">pango_font_description_set_size()</code></a>.</p>

1341

<p>

1342

1343

</p>

1344

1345

1346

<tbody>

1347

<tr>

1348

<td>

1349

1350

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1351

</td>

1352

</tr>

1353

<tr>

1354

<td>

1355

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1356

<td> the size field for the font description in points or device units.

1357

You must call <a href="pango-Fonts.html#pango-font-description-get-size-is-absolute"><code class="function">pango_font_description_get_size_is_absolute()</code></a>

1358

to find out which is the case. Returns 0 if the size field has not

1359

previously been set or it has been set to 0 explicitly.

1360

Use <a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to

1361

find out if the field was explicitly set or not.

1362

</td>

1363

</tr>

1364

</tbody>

1365

</table></div>

1366

</div>

1367

<hr>

1368

1369

1370

<a name="pango-font-description-set-absolute-size"></a>pango_font_description_set_absolute_size ()</h3>

1371

<a class="indexterm" name="id3045587"></a><pre class="programlisting">void pango_font_description_set_absolute_size

1372

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1373

double size);</pre>

1374

<p>

1375

Sets the size field of a font description, in device units. This is mutually

1376

exclusive with <a href="pango-Fonts.html#pango-font-description-set-size"><code class="function">pango_font_description_set_size()</code></a>.</p>

1377

<p>

1378

1379

</p>

1380

1381

1382

<tbody>

1383

<tr>

1384

<td>

1385

1386

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1387

</td>

1388

</tr>

1389

<tr>

1390

<td>

1391

1392

<td> the new size, in Pango units. There are <a href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><code class="literal">PANGO_SCALE</code></a> Pango units in one

1393

device unit. For an output backend where a device unit is a pixel, a <em class="parameter"><code>size</code></em>

1394

value of 10 * PANGO_SCALE gives a 10 pixel font.

1395

</td>

1396

</tr>

1397

</tbody>

1398

</table></div>

1399

<p>Since 1.8

1400

</p>

1401

</div>

1402

<hr>

1403

1404

1405

<a name="pango-font-description-get-size-is-absolute"></a>pango_font_description_get_size_is_absolute ()</h3>

1406

<a class="indexterm" name="id3045722"></a><pre class="programlisting"><a

1407

href="../glib/glib-Basic-Types.html#gboolean"

1408

>gboolean</a> pango_font_description_get_size_is_absolute

1409

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1410

<p>

1411

Determines whether the size of the font is in points or device units.

1412

See <a href="pango-Fonts.html#pango-font-description-set-size"><code class="function">pango_font_description_set_size()</code></a> and <a href="pango-Fonts.html#pango-font-description-set-absolute-size"><code class="function">pango_font_description_set_absolute_size()</code></a>.</p>

1413

<p>

1414

1415

</p>

1416

1417

1418

<tbody>

1419

<tr>

1420

<td>

1421

1422

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1423

</td>

1424

</tr>

1425

<tr>

1426

<td>

1427

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1428

<td> whether the size for the font description is in

1429

points or device units. Use <a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to

1430

find out if the size field of the font description was explicitly set or not.

1431

1432

</td>

1433

</tr>

1434

</tbody>

1435

</table></div>

1436

<p>Since 1.8

1437

</p>

1438

</div>

1439

<hr>

1440

1441

1442

<a name="pango-font-description-set-gravity"></a>pango_font_description_set_gravity ()</h3>

1443

<a class="indexterm" name="id3045850"></a><pre class="programlisting">void pango_font_description_set_gravity

1444

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1445

<a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> gravity);</pre>

1446

<p>

1447

Sets the gravity field of a font description. The gravity field

1448

specifies how the glyphs should be rotated. If <em class="parameter"><code>gravity</code></em> is

1449

<a href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>, this actually unsets the gravity mask on

1450

the font description.

1451

</p>

1452

<p>

1453

This function is seldom useful to the user. Gravity should normally

1454

be set on a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</p>

1455

<p>

1456

1457

</p>

1458

1459

1460

<tbody>

1461

<tr>

1462

<td>

1463

1464

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1465

</td>

1466

</tr>

1467

<tr>

1468

<td>

1469

<span class="term"><em class="parameter"><code>gravity</code></em> :</span></td>

1470

<td> the gravity for the font description.

1471

</td>

1472

</tr>

1473

</tbody>

1474

</table></div>

1475

<p>Since 1.16

1476

</p>

1477

</div>

1478

<hr>

1479

1480

1481

<a name="pango-font-description-get-gravity"></a>pango_font_description_get_gravity ()</h3>

1482

<a class="indexterm" name="id3045986"></a><pre class="programlisting"><a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> pango_font_description_get_gravity

1483

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1484

<p>

1485

Gets the gravity field of a font description. See

1486

<a href="pango-Fonts.html#pango-font-description-set-gravity"><code class="function">pango_font_description_set_gravity()</code></a>.</p>

1487

<p>

1488

1489

</p>

1490

1491

1492

<tbody>

1493

<tr>

1494

<td>

1495

1496

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1497

</td>

1498

</tr>

1499

<tr>

1500

<td>

1501

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1502

<td> the gravity field for the font description. Use

1503

<a href="pango-Fonts.html#pango-font-description-get-set-fields"><code class="function">pango_font_description_get_set_fields()</code></a> to find out if

1504

the field was explicitly set or not.

1505

1506

</td>

1507

</tr>

1508

</tbody>

1509

</table></div>

1510

<p>Since 1.16

1511

</p>

1512

</div>

1513

<hr>

1514

1515

1516

<a name="pango-font-description-get-set-fields"></a>pango_font_description_get_set_fields ()</h3>

1517

<a class="indexterm" name="id3046101"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMask">PangoFontMask</a> pango_font_description_get_set_fields

1518

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1519

<p>

1520

Determines which fields in a font description have been set.</p>

1521

<p>

1522

1523

</p>

1524

1525

1526

<tbody>

1527

<tr>

1528

<td>

1529

1530

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1531

</td>

1532

</tr>

1533

<tr>

1534

<td>

1535

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1536

<td> a bitmask with bits set corresponding to the

1537

fields in <em class="parameter"><code>desc</code></em> that have been set.

1538

</td>

1539

</tr>

1540

</tbody>

1541

</table></div>

1542

</div>

1543

<hr>

1544

1545

1546

<a name="pango-font-description-unset-fields"></a>pango_font_description_unset_fields ()</h3>

1547

<a class="indexterm" name="id3046193"></a><pre class="programlisting">void pango_font_description_unset_fields

1548

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1549

<a href="pango-Fonts.html#PangoFontMask">PangoFontMask</a> to_unset);</pre>

1550

<p>

1551

Unsets some of the fields in a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>. The unset

1552

fields will get back to their default values.</p>

1553

<p>

1554

1555

</p>

1556

1557

1558

<tbody>

1559

<tr>

1560

<td>

1561

1562

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1563

</td>

1564

</tr>

1565

<tr>

1566

<td>

1567

<span class="term"><em class="parameter"><code>to_unset</code></em> :</span></td>

1568

<td> bitmask of fields in the <em class="parameter"><code>desc</code></em> to unset.

1569

</td>

1570

</tr>

1571

</tbody>

1572

</table></div>

1573

</div>

1574

<hr>

1575

1576

1577

<a name="pango-font-description-merge"></a>pango_font_description_merge ()</h3>

1578

<a class="indexterm" name="id3046304"></a><pre class="programlisting">void pango_font_description_merge (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1579

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

1580

1581

href="../glib/glib-Basic-Types.html#gboolean"

1582

>gboolean</a> replace_existing);</pre>

1583

<p>

1584

Merges the fields that are set in <em class="parameter"><code>desc_to_merge</code></em> into the fields in

1585

<em class="parameter"><code>desc</code></em>. If <em class="parameter"><code>replace_existing</code></em> is <a

1586

href="../glib/glib-Standard-Macros.html#FALSE:CAPS"

1587

><code class="literal">FALSE</code></a>, only fields in <em class="parameter"><code>desc</code></em> that

1588

are not already set are affected. If <a

1589

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

1590

><code class="literal">TRUE</code></a>, then fields that are

1591

already set will be replaced as well.</p>

1592

<p>

1593

1594

</p>

1595

1596

1597

<tbody>

1598

<tr>

1599

<td>

1600

1601

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1602

</td>

1603

</tr>

1604

<tr>

1605

<td>

1606

<span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></td>

1607

<td> the <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from

1608

</td>

1609

</tr>

1610

<tr>

1611

<td>

1612

<span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></td>

1613

<td> if <a

1614

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

1615

><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the

1616

corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they

1617

are already exist.

1618

</td>

1619

</tr>

1620

</tbody>

1621

</table></div>

1622

</div>

1623

<hr>

1624

1625

1626

<a name="pango-font-description-merge-static"></a>pango_font_description_merge_static ()</h3>

1627

<a class="indexterm" name="id3046500"></a><pre class="programlisting">void pango_font_description_merge_static

1628

(<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1629

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc_to_merge,

1630

1631

href="../glib/glib-Basic-Types.html#gboolean"

1632

>gboolean</a> replace_existing);</pre>

1633

<p>

1634

Like <a href="pango-Fonts.html#pango-font-description-merge"><code class="function">pango_font_description_merge()</code></a>, but only a shallow copy is made

1635

of the family name and other allocated fields. <em class="parameter"><code>desc</code></em> can only be

1636

used until <em class="parameter"><code>desc_to_merge</code></em> is modified or freed. This is meant

1637

to be used when the merged font description is only needed temporarily.</p>

1638

<p>

1639

1640

</p>

1641

1642

1643

<tbody>

1644

<tr>

1645

<td>

1646

1647

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1648

</td>

1649

</tr>

1650

<tr>

1651

<td>

1652

<span class="term"><em class="parameter"><code>desc_to_merge</code></em> :</span></td>

1653

<td> the <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> to merge from

1654

</td>

1655

</tr>

1656

<tr>

1657

<td>

1658

<span class="term"><em class="parameter"><code>replace_existing</code></em> :</span></td>

1659

<td> if <a

1660

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

1661

><code class="literal">TRUE</code></a>, replace fields in <em class="parameter"><code>desc</code></em> with the

1662

corresponding values from <em class="parameter"><code>desc_to_merge</code></em>, even if they

1663

are already exist.

1664

</td>

1665

</tr>

1666

</tbody>

1667

</table></div>

1668

</div>

1669

<hr>

1670

1671

1672

<a name="pango-font-description-better-match"></a>pango_font_description_better_match ()</h3>

1673

<a class="indexterm" name="id3046678"></a><pre class="programlisting"><a

1674

href="../glib/glib-Basic-Types.html#gboolean"

1675

>gboolean</a> pango_font_description_better_match

1676

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

1677

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *old_match,

1678

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *new_match);</pre>

1679

<p>

1680

Determines if the style attributes of <em class="parameter"><code>new_match</code></em> are a closer match

1681

for <em class="parameter"><code>desc</code></em> than <em class="parameter"><code>old_match</code></em>, or if <em class="parameter"><code>old_match</code></em> is <a

1682

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

1683

><code class="literal">NULL</code></a>, determines if

1684

<em class="parameter"><code>new_match</code></em> is a match at all. Approximate matching is done for

1685

weight and style; other attributes must match exactly.</p>

1686

<p>

1687

1688

</p>

1689

1690

1691

<tbody>

1692

<tr>

1693

<td>

1694

1695

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1696

</td>

1697

</tr>

1698

<tr>

1699

<td>

1700

<span class="term"><em class="parameter"><code>old_match</code></em> :</span></td>

1701

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <a

1702

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

1703

><code class="literal">NULL</code></a>

1704

</td>

1705

</tr>

1706

<tr>

1707

<td>

1708

<span class="term"><em class="parameter"><code>new_match</code></em> :</span></td>

1709

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1710

</td>

1711

</tr>

1712

<tr>

1713

<td>

1714

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1715

<td> <a

1716

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

1717

><code class="literal">TRUE</code></a> if <em class="parameter"><code>new_match</code></em> is a better match

1718

</td>

1719

</tr>

1720

</tbody>

1721

</table></div>

1722

</div>

1723

<hr>

1724

1725

1726

<a name="pango-font-description-from-string"></a>pango_font_description_from_string ()</h3>

1727

<a class="indexterm" name="id3046892"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_description_from_string

1728

(const char *str);</pre>

1729

<p>

1730

Creates a new font description from a string representation in the

1731

form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a

1732

comma separated list of families optionally terminated by a comma,

1733

STYLE_OPTIONS is a whitespace separated list of words where each WORD

1734

describes one of style, variant, weight, stretch, or gravity, and SIZE

1735

is a decimal number (size in points) or optionally followed by the

1736

unit modifier "px" for absolute size. Any one of the options may

1737

be absent. If FAMILY-LIST is absent, then the family_name field of

1738

the resulting font description will be initialized to <a

1739

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

1740

><code class="literal">NULL</code></a>. If

1741

STYLE-OPTIONS is missing, then all style options will be set to the

1742

default values. If SIZE is missing, the size in the resulting font

1743

description will be set to 0.</p>

1744

<p>

1745

1746

</p>

1747

1748

1749

<tbody>

1750

<tr>

1751

<td>

1752

1753

<td> string representation of a font description.

1754

</td>

1755

</tr>

1756

<tr>

1757

<td>

1758

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1759

<td> a new <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.

1760

</td>

1761

</tr>

1762

</tbody>

1763

</table></div>

1764

</div>

1765

<hr>

1766

1767

1768

<a name="pango-font-description-to-string"></a>pango_font_description_to_string ()</h3>

1769

<a class="indexterm" name="id3046999"></a><pre class="programlisting">char* pango_font_description_to_string

1770

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1771

<p>

1772

Creates a string representation of a font description. See

1773

<a href="pango-Fonts.html#pango-font-description-from-string"><code class="function">pango_font_description_from_string()</code></a> for a description of the

1774

format of the string representation. The family list in the

1775

string description will only have a terminating comma if the

1776

last word of the list is a valid style option.</p>

1777

<p>

1778

1779

</p>

1780

1781

1782

<tbody>

1783

<tr>

1784

<td>

1785

1786

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1787

</td>

1788

</tr>

1789

<tr>

1790

<td>

1791

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1792

<td> a new string that must be freed with <a

1793

href="../glib/glib-Memory-Allocation.html#g-free"

1794

><code class="function">g_free()</code></a>.

1795

</td>

1796

</tr>

1797

</tbody>

1798

</table></div>

1799

</div>

1800

<hr>

1801

1802

1803

<a name="pango-font-description-to-filename"></a>pango_font_description_to_filename ()</h3>

1804

<a class="indexterm" name="id3047110"></a><pre class="programlisting">char* pango_font_description_to_filename

1805

(const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

1806

<p>

1807

Creates a filename representation of a font description. The

1808

filename is identical to the result from calling

1809

<a href="pango-Fonts.html#pango-font-description-to-string"><code class="function">pango_font_description_to_string()</code></a>, but with underscores instead of

1810

characters that are untypical in filenames, and in lower case only.</p>

1811

<p>

1812

1813

</p>

1814

1815

1816

<tbody>

1817

<tr>

1818

<td>

1819

1820

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

1821

</td>

1822

</tr>

1823

<tr>

1824

<td>

1825

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1826

<td> a new string that must be freed with <a

1827

href="../glib/glib-Memory-Allocation.html#g-free"

1828

><code class="function">g_free()</code></a>.

1829

</td>

1830

</tr>

1831

</tbody>

1832

</table></div>

1833

</div>

1834

<hr>

1835

1836

1837

<a name="PangoFontMetrics"></a>PangoFontMetrics</h3>

1838

<a class="indexterm" name="id3047217"></a><pre class="programlisting">typedef struct {

1839

guint ref_count;

1840

1841

int ascent;

1842

int descent;

1843

int approximate_char_width;

1844

int approximate_digit_width;

1845

int underline_position;

1846

int underline_thickness;

1847

int strikethrough_position;

1848

int strikethrough_thickness;

1849

} PangoFontMetrics;

1850

</pre>

1851

<p>

1852

A <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure holds the overall metric information

1853

for a font (possibly restricted to a script). The fields of this

1854

structure are private to implementations of a font backend. See

1855

the documentation of the corresponding getters for documentation

1856

of their meaning.

1857

</p>

1858

1859

1860

<tbody>

1861

<tr>

1862

<td>

1863

<span class="term"><a

1864

href="../glib/glib-Basic-Types.html#guint"

1865

>guint</a> <em class="structfield"><code>ref_count</code></em>;</span></td>

1866

<td>reference count. Used internally. See <a href="pango-Fonts.html#pango-font-metrics-ref"><code class="function">pango_font_metrics_ref()</code></a>

1867

and <a href="pango-Fonts.html#pango-font-metrics-unref"><code class="function">pango_font_metrics_unref()</code></a>.

1868

</td>

1869

</tr>

1870

<tr>

1871

<td>

1872

<span class="term">int <em class="structfield"><code>ascent</code></em>;</span></td>

1873

<td>the distance from the baseline to the highest point of the glyphs of

1874

the font. This is positive in practically all fonts.

1875

</td>

1876

</tr>

1877

<tr>

1878

<td>

1879

<span class="term">int <em class="structfield"><code>descent</code></em>;</span></td>

1880

<td>the distance from the baseline to the lowest point of the glyphs of

1881

the font. This is positive in practically all fonts.

1882

</td>

1883

</tr>

1884

<tr>

1885

<td>

1886

<span class="term">int <em class="structfield"><code>approximate_char_width</code></em>;</span></td>

1887

<td>approximate average width of the regular glyphs of

1888

the font.

1889

</td>

1890

</tr>

1891

<tr>

1892

<td>

1893

<span class="term">int <em class="structfield"><code>approximate_digit_width</code></em>;</span></td>

1894

<td>approximate average width of the glyphs for digits

1895

of the font.

1896

</td>

1897

</tr>

1898

<tr>

1899

<td>

1900

<span class="term">int <em class="structfield"><code>underline_position</code></em>;</span></td>

1901

<td>position of the underline. This is normally negative.

1902

</td>

1903

</tr>

1904

<tr>

1905

<td>

1906

<span class="term">int <em class="structfield"><code>underline_thickness</code></em>;</span></td>

1907

<td>thickness of the underline.

1908

</td>

1909

</tr>

1910

<tr>

1911

<td>

1912

<span class="term">int <em class="structfield"><code>strikethrough_position</code></em>;</span></td>

1913

<td>position of the strikethrough line. This is

1914

normally positive.

1915

</td>

1916

</tr>

1917

<tr>

1918

<td>

1919

<span class="term">int <em class="structfield"><code>strikethrough_thickness</code></em>;</span></td>

1920

<td>thickness of the strikethrough line.

1921

1922

</td>

1923

</tr>

1924

</tbody>

1925

</table></div>

1926

</div>

1927

<hr>

1928

1929

1930

<a name="PANGO-TYPE-FONT-METRICS:CAPS"></a>PANGO_TYPE_FONT_METRICS</h3>

1931

<a class="indexterm" name="id3047478"></a><pre class="programlisting">#define PANGO_TYPE_FONT_METRICS (pango_font_metrics_get_type ())

1932

</pre>

1933

<p>

1934

The <a

1935

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

1936

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a>.

1937

</p>

1938

</div>

1939

<hr>

1940

1941

1942

<a name="pango-font-metrics-ref"></a>pango_font_metrics_ref ()</h3>

1943

<a class="indexterm" name="id3047523"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>* pango_font_metrics_ref (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

1944

<p>

1945

Increase the reference count of a font metrics structure by one.</p>

1946

<p>

1947

1948

</p>

1949

1950

1951

<tbody>

1952

<tr>

1953

<td>

1954

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

1955

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

1956

</td>

1957

</tr>

1958

<tr>

1959

<td>

1960

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

1961

<td> <em class="parameter"><code>metrics</code></em>

1962

</td>

1963

</tr>

1964

</tbody>

1965

</table></div>

1966

</div>

1967

<hr>

1968

1969

1970

<a name="pango-font-metrics-unref"></a>pango_font_metrics_unref ()</h3>

1971

<a class="indexterm" name="id3047611"></a><pre class="programlisting">void pango_font_metrics_unref (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

1972

<p>

1973

Decrease the reference count of a font metrics structure by one. If

1974

the result is zero, frees the structure and any associated

1975

memory.</p>

1976

<p>

1977

1978

</p>

1979

1980

1981

1982

<td>

1983

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

1984

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

1985

</td>

1986

</tr></tbody>

1987

</table></div>

1988

</div>

1989

<hr>

1990

1991

1992

<a name="pango-font-metrics-get-ascent"></a>pango_font_metrics_get_ascent ()</h3>

1993

<a class="indexterm" name="id3047685"></a><pre class="programlisting">int pango_font_metrics_get_ascent (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

1994

<p>

1995

Gets the ascent from a font metrics structure. The ascent is

1996

the distance from the baseline to the logical top of a line

1997

of text. (The logical top may be above or below the top of the

1998

actual drawn ink. It is necessary to lay out the text to figure

1999

where the ink will be.)</p>

2000

<p>

2001

2002

</p>

2003

2004

2005

<tbody>

2006

<tr>

2007

<td>

2008

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2009

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2010

</td>

2011

</tr>

2012

<tr>

2013

<td>

2014

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2015

<td> the ascent, in Pango units. (1 point == <a href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><code class="literal">PANGO_SCALE</code></a> Pango units.)

2016

</td>

2017

</tr>

2018

</tbody>

2019

</table></div>

2020

</div>

2021

<hr>

2022

2023

2024

<a name="pango-font-metrics-get-descent"></a>pango_font_metrics_get_descent ()</h3>

2025

<a class="indexterm" name="id3047782"></a><pre class="programlisting">int pango_font_metrics_get_descent (<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2026

<p>

2027

Gets the descent from a font metrics structure. The descent is

2028

the distance from the baseline to the logical bottom of a line

2029

of text. (The logical bottom may be above or below the bottom of the

2030

actual drawn ink. It is necessary to lay out the text to figure

2031

where the ink will be.)</p>

2032

<p>

2033

2034

</p>

2035

2036

2037

<tbody>

2038

<tr>

2039

<td>

2040

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2041

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2042

</td>

2043

</tr>

2044

<tr>

2045

<td>

2046

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2047

<td> the descent, in Pango units. (1 point == <a href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><code class="literal">PANGO_SCALE</code></a> Pango units.)

2048

</td>

2049

</tr>

2050

</tbody>

2051

</table></div>

2052

</div>

2053

<hr>

2054

2055

2056

<a name="pango-font-metrics-get-approximate-char-width"></a>pango_font_metrics_get_approximate_char_width ()</h3>

2057

<a class="indexterm" name="id3047881"></a><pre class="programlisting">int pango_font_metrics_get_approximate_char_width

2058

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2059

<p>

2060

Gets the approximate character width for a font metrics structure.

2061

This is merely a representative value useful, for example, for

2062

determining the initial size for a window. Actual characters in

2063

text will be wider and narrower than this.</p>

2064

<p>

2065

2066

</p>

2067

2068

2069

<tbody>

2070

<tr>

2071

<td>

2072

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2073

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2074

</td>

2075

</tr>

2076

<tr>

2077

<td>

2078

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2079

<td> the character width, in Pango units. (1 point == <a href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><code class="literal">PANGO_SCALE</code></a> Pango units.)

2080

</td>

2081

</tr>

2082

</tbody>

2083

</table></div>

2084

</div>

2085

<hr>

2086

2087

2088

<a name="pango-font-metrics-get-approximate-digit-width"></a>pango_font_metrics_get_approximate_digit_width ()</h3>

2089

<a class="indexterm" name="id3047980"></a><pre class="programlisting">int pango_font_metrics_get_approximate_digit_width

2090

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2091

<p>

2092

Gets the approximate digit width for a font metrics structure.

2093

This is merely a representative value useful, for example, for

2094

determining the initial size for a window. Actual digits in

2095

text can be wider or narrower than this, though this value

2096

is generally somewhat more accurate than the result of

2097

<a href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width"><code class="function">pango_font_metrics_get_approximate_char_width()</code></a> for digits.</p>

2098

<p>

2099

2100

</p>

2101

2102

2103

<tbody>

2104

<tr>

2105

<td>

2106

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2107

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2108

</td>

2109

</tr>

2110

<tr>

2111

<td>

2112

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2113

<td> the digit width, in Pango units. (1 point == <a href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><code class="literal">PANGO_SCALE</code></a> Pango units.)

2114

</td>

2115

</tr>

2116

</tbody>

2117

</table></div>

2118

</div>

2119

<hr>

2120

2121

2122

<a name="pango-font-metrics-get-underline-thickness"></a>pango_font_metrics_get_underline_thickness ()</h3>

2123

<a class="indexterm" name="id3048095"></a><pre class="programlisting">int pango_font_metrics_get_underline_thickness

2124

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2125

<p>

2126

Gets the suggested thickness to draw for the underline.</p>

2127

<p>

2128

2129

</p>

2130

2131

2132

<tbody>

2133

<tr>

2134

<td>

2135

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2136

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2137

</td>

2138

</tr>

2139

<tr>

2140

<td>

2141

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2142

<td> the suggested underline thickness, in Pango units.

2143

2144

</td>

2145

</tr>

2146

</tbody>

2147

</table></div>

2148

<p>Since 1.6

2149

</p>

2150

</div>

2151

<hr>

2152

2153

2154

<a name="pango-font-metrics-get-underline-position"></a>pango_font_metrics_get_underline_position ()</h3>

2155

<a class="indexterm" name="id3048186"></a><pre class="programlisting">int pango_font_metrics_get_underline_position

2156

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2157

<p>

2158

Gets the suggested position to draw the underline.

2159

The value returned is the distance <span class="emphasis"><em>above</em></span> the

2160

baseline of the top of the underline. Since most fonts have

2161

underline positions beneath the baseline, this value is typically

2162

negative.</p>

2163

<p>

2164

2165

</p>

2166

2167

2168

<tbody>

2169

<tr>

2170

<td>

2171

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2172

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2173

</td>

2174

</tr>

2175

<tr>

2176

<td>

2177

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2178

<td> the suggested underline position, in Pango units.

2179

2180

</td>

2181

</tr>

2182

</tbody>

2183

</table></div>

2184

<p>Since 1.6

2185

</p>

2186

</div>

2187

<hr>

2188

2189

2190

<a name="pango-font-metrics-get-strikethrough-thickness"></a>pango_font_metrics_get_strikethrough_thickness ()</h3>

2191

<a class="indexterm" name="id3048284"></a><pre class="programlisting">int pango_font_metrics_get_strikethrough_thickness

2192

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2193

<p>

2194

Gets the suggested thickness to draw for the strikethrough.</p>

2195

<p>

2196

2197

</p>

2198

2199

2200

<tbody>

2201

<tr>

2202

<td>

2203

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2204

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2205

</td>

2206

</tr>

2207

<tr>

2208

<td>

2209

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2210

<td> the suggested strikethrough thickness, in Pango units.

2211

2212

</td>

2213

</tr>

2214

</tbody>

2215

</table></div>

2216

<p>Since 1.6

2217

</p>

2218

</div>

2219

<hr>

2220

2221

2222

<a name="pango-font-metrics-get-strikethrough-position"></a>pango_font_metrics_get_strikethrough_position ()</h3>

2223

<a class="indexterm" name="id3048376"></a><pre class="programlisting">int pango_font_metrics_get_strikethrough_position

2224

(<a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a> *metrics);</pre>

2225

<p>

2226

Gets the suggested position to draw the strikethrough.

2227

The value returned is the distance <span class="emphasis"><em>above</em></span> the

2228

baseline of the top of the strikethrough.</p>

2229

<p>

2230

2231

</p>

2232

2233

2234

<tbody>

2235

<tr>

2236

<td>

2237

<span class="term"><em class="parameter"><code>metrics</code></em> :</span></td>

2238

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> structure

2239

</td>

2240

</tr>

2241

<tr>

2242

<td>

2243

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2244

<td> the suggested strikethrough position, in Pango units.

2245

2246

</td>

2247

</tr>

2248

</tbody>

2249

</table></div>

2250

<p>Since 1.6

2251

</p>

2252

</div>

2253

<hr>

2254

2255

2256

<a name="PangoFont-struct"></a>PangoFont</h3>

2257

<a class="indexterm" name="id3048470"></a><pre class="programlisting">typedef struct _PangoFont PangoFont;</pre>

2258

<p>

2259

The <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure is used to represent

2260

a font in a rendering-system-independent matter.

2261

To create an implementation of a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>,

2262

the rendering-system specific code should allocate

2263

a larger structure that contains a nested

2264

<a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of

2265

the nested <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> with a pointer to

2266

a appropriate <span class="type">PangoFontClass</span>, then call

2267

<code class="function">pango_font_init()</code> on the structure.

2268

</p>

2269

<p>

2270

The <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> structure contains one member

2271

which the implementation fills in.

2272

</p>

2273

</div>

2274

<hr>

2275

2276

2277

<a name="PANGO-TYPE-FONT:CAPS"></a>PANGO_TYPE_FONT</h3>

2278

<a class="indexterm" name="id3048573"></a><pre class="programlisting">#define PANGO_TYPE_FONT (pango_font_get_type ())

2279

</pre>

2280

<p>

2281

The <a

2282

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2283

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

2284

</p>

2285

</div>

2286

<hr>

2287

2288

2289

<a name="PANGO-FONT:CAPS"></a>PANGO_FONT()</h3>

2290

<a class="indexterm" name="id3048617"></a><pre class="programlisting">#define PANGO_FONT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT, PangoFont))

2291

</pre>

2292

<p>

2293

Casts a <a

2294

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2295

><span class="type">GObject</span></a> to a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

2296

</p>

2297

2298

2299

2300

<td>

2301

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

2302

<td>a <a

2303

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2304

><span class="type">GObject</span></a>.

2305

2306

2307

</td>

2308

</tr></tbody>

2309

</table></div>

2310

</div>

2311

<hr>

2312

2313

2314

<a name="PANGO-IS-FONT:CAPS"></a>PANGO_IS_FONT()</h3>

2315

<a class="indexterm" name="id3048688"></a><pre class="programlisting">#define PANGO_IS_FONT(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT))

2316

</pre>

2317

<p>

2318

Returns <a

2319

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

2320

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

2321

</p>

2322

2323

2324

2325

<td>

2326

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

2327

<td>a <a

2328

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2329

><span class="type">GObject</span></a>.

2330

2331

2332

</td>

2333

</tr></tbody>

2334

</table></div>

2335

</div>

2336

<hr>

2337

2338

2339

<a name="pango-font-find-shaper"></a>pango_font_find_shaper ()</h3>

2340

<a class="indexterm" name="id3048768"></a><pre class="programlisting"><a href="PangoEngineShape.html" title="PangoEngineShape">PangoEngineShape</a>* pango_font_find_shaper (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

2341

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language,

2342

2343

href="../glib/glib-Basic-Types.html#guint32"

2344

>guint32</a> ch);</pre>

2345

<p>

2346

Finds the best matching shaper for a font for a particular

2347

language tag and character point.</p>

2348

<p>

2349

2350

</p>

2351

2352

2353

<tbody>

2354

<tr>

2355

<td>

2356

2357

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2358

</td>

2359

</tr>

2360

<tr>

2361

<td>

2362

<span class="term"><em class="parameter"><code>language</code></em> :</span></td>

2363

<td> the language tag

2364

</td>

2365

</tr>

2366

<tr>

2367

<td>

2368

2369

<td> a Unicode character.

2370

</td>

2371

</tr>

2372

<tr>

2373

<td>

2374

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2375

<td> the best matching shaper.

2376

</td>

2377

</tr>

2378

</tbody>

2379

</table></div>

2380

</div>

2381

<hr>

2382

2383

2384

<a name="pango-font-describe"></a>pango_font_describe ()</h3>

2385

<a class="indexterm" name="id3048895"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_describe (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>

2386

<p>

2387

Returns a description of the font, with font size set in points.

2388

Use <a href="pango-Fonts.html#pango-font-describe-with-absolute-size"><code class="function">pango_font_describe_with_absolute_size()</code></a> if you want the font

2389

size in device units.</p>

2390

<p>

2391

2392

</p>

2393

2394

2395

<tbody>

2396

<tr>

2397

<td>

2398

2399

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2400

</td>

2401

</tr>

2402

<tr>

2403

<td>

2404

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2405

<td> a newly-allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.

2406

</td>

2407

</tr>

2408

</tbody>

2409

</table></div>

2410

</div>

2411

<hr>

2412

2413

2414

<a name="pango-font-describe-with-absolute-size"></a>pango_font_describe_with_absolute_size ()</h3>

2415

<a class="indexterm" name="id3049001"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_describe_with_absolute_size

2416

(<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>

2417

<p>

2418

Returns a description of the font, with absolute font size set

2419

(in device units). Use <a href="pango-Fonts.html#pango-font-describe"><code class="function">pango_font_describe()</code></a> if you want the font

2420

size in points.</p>

2421

<p>

2422

2423

</p>

2424

2425

2426

<tbody>

2427

<tr>

2428

<td>

2429

2430

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2431

</td>

2432

</tr>

2433

<tr>

2434

<td>

2435

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2436

<td> a newly-allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> object.

2437

2438

</td>

2439

</tr>

2440

</tbody>

2441

</table></div>

2442

<p>Since 1.14

2443

</p>

2444

</div>

2445

<hr>

2446

2447

2448

<a name="pango-font-get-coverage"></a>pango_font_get_coverage ()</h3>

2449

<a class="indexterm" name="id3049110"></a><pre class="programlisting"><a href="pango-Coverage-Maps.html#PangoCoverage">PangoCoverage</a>* pango_font_get_coverage (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

2450

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);</pre>

2451

<p>

2452

Computes the coverage map for a given font and language tag.</p>

2453

<p>

2454

2455

</p>

2456

2457

2458

<tbody>

2459

<tr>

2460

<td>

2461

2462

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2463

</td>

2464

</tr>

2465

<tr>

2466

<td>

2467

<span class="term"><em class="parameter"><code>language</code></em> :</span></td>

2468

<td> the language tag

2469

</td>

2470

</tr>

2471

<tr>

2472

<td>

2473

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2474

<td> a newly-allocated <a href="pango-Coverage-Maps.html#PangoCoverage"><span class="type">PangoCoverage</span></a> object.

2475

</td>

2476

</tr>

2477

</tbody>

2478

</table></div>

2479

</div>

2480

<hr>

2481

2482

2483

<a name="pango-font-get-glyph-extents"></a>pango_font_get_glyph_extents ()</h3>

2484

<a class="indexterm" name="id3049224"></a><pre class="programlisting">void pango_font_get_glyph_extents (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

2485

<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> glyph,

2486

<a href="pango-Glyph-Storage.html#PangoRectangle">PangoRectangle</a> *ink_rect,

2487

<a href="pango-Glyph-Storage.html#PangoRectangle">PangoRectangle</a> *logical_rect);</pre>

2488

<p>

2489

Gets the logical and ink extents of a glyph within a font. The

2490

coordinate system for each rectangle has its origin at the

2491

base line and horizontal origin of the character with increasing

2492

coordinates extending to the right and down. The macros <a href="pango-Glyph-Storage.html#PANGO-ASCENT:CAPS"><code class="function">PANGO_ASCENT()</code></a>,

2493

<a href="pango-Glyph-Storage.html#PANGO-DESCENT:CAPS"><code class="function">PANGO_DESCENT()</code></a>, <a href="pango-Glyph-Storage.html#PANGO-LBEARING:CAPS"><code class="function">PANGO_LBEARING()</code></a>, and <a href="pango-Glyph-Storage.html#PANGO-RBEARING:CAPS"><code class="function">PANGO_RBEARING()</code></a> can be used to convert

2494

from the extents rectangle to more traditional font metrics. The units

2495

of the rectangles are in 1/PANGO_SCALE of a device unit.</p>

2496

<p>

2497

2498

</p>

2499

2500

2501

<tbody>

2502

<tr>

2503

<td>

2504

2505

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2506

</td>

2507

</tr>

2508

<tr>

2509

<td>

2510

<span class="term"><em class="parameter"><code>glyph</code></em> :</span></td>

2511

<td> the glyph index

2512

</td>

2513

</tr>

2514

<tr>

2515

<td>

2516

2517

<td> rectangle used to store the extents of the glyph as drawn

2518

or <a

2519

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

2520

><code class="literal">NULL</code></a> to indicate that the result is not needed.

2521

</td>

2522

</tr>

2523

<tr>

2524

<td>

2525

<span class="term"><em class="parameter"><code>logical_rect</code></em> :</span></td>

2526

<td> rectangle used to store the logical extents of the glyph

2527

or <a

2528

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

2529

><code class="literal">NULL</code></a> to indicate that the result is not needed.

2530

</td>

2531

</tr>

2532

</tbody>

2533

</table></div>

2534

</div>

2535

<hr>

2536

2537

2538

<a name="pango-font-get-metrics"></a>pango_font_get_metrics ()</h3>

2539

<a class="indexterm" name="id3049432"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>* pango_font_get_metrics (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

2540

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);</pre>

2541

<p>

2542

Gets overall metric information for a font. Since the metrics may be

2543

substantially different for different scripts, a language tag can

2544

be provided to indicate that the metrics should be retrieved that

2545

correspond to the script(s) used by that language.</p>

2546

<p>

2547

2548

</p>

2549

2550

2551

<tbody>

2552

<tr>

2553

<td>

2554

2555

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2556

</td>

2557

</tr>

2558

<tr>

2559

<td>

2560

<span class="term"><em class="parameter"><code>language</code></em> :</span></td>

2561

<td> language tag used to determine which script to get the metrics

2562

for, or <a

2563

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

2564

><code class="literal">NULL</code></a> to indicate to get the metrics for the entire

2565

font.

2566

</td>

2567

</tr>

2568

<tr>

2569

<td>

2570

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2571

<td> a <a href="pango-Fonts.html#PangoFontMetrics"><span class="type">PangoFontMetrics</span></a> object. The caller must call <a href="pango-Fonts.html#pango-font-metrics-unref"><code class="function">pango_font_metrics_unref()</code></a>

2572

when finished using the object.

2573

</td>

2574

</tr>

2575

</tbody>

2576

</table></div>

2577

</div>

2578

<hr>

2579

2580

2581

<a name="pango-font-get-font-map"></a>pango_font_get_font_map ()</h3>

2582

<a class="indexterm" name="id3049573"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* pango_font_get_font_map (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>

2583

<p>

2584

Gets the font map for which the font was created.</p>

2585

<p>

2586

2587

</p>

2588

2589

2590

<tbody>

2591

<tr>

2592

<td>

2593

2594

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>

2595

</td>

2596

</tr>

2597

<tr>

2598

<td>

2599

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2600

<td> the <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> for the font

2601

2602

</td>

2603

</tr>

2604

</tbody>

2605

</table></div>

2606

<p>Since 1.10

2607

</p>

2608

</div>

2609

<hr>

2610

2611

2612

<a name="PangoFontFamily-struct"></a>PangoFontFamily</h3>

2613

<a class="indexterm" name="id3049669"></a><pre class="programlisting">typedef struct _PangoFontFamily PangoFontFamily;</pre>

2614

<p>

2615

The <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> structure is used to represent a family of related

2616

font faces. The faces in a family share a common design, but differ in

2617

slant, weight, width and other aspects.

2618

</p>

2619

</div>

2620

<hr>

2621

2622

2623

<a name="PANGO-TYPE-FONT-FAMILY:CAPS"></a>PANGO_TYPE_FONT_FAMILY</h3>

2624

<a class="indexterm" name="id3049709"></a><pre class="programlisting">#define PANGO_TYPE_FONT_FAMILY (pango_font_family_get_type ())

2625

</pre>

2626

<p>

2627

The <a

2628

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2629

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.

2630

</p>

2631

</div>

2632

<hr>

2633

2634

2635

<a name="PANGO-FONT-FAMILY:CAPS"></a>PANGO_FONT_FAMILY()</h3>

2636

<a class="indexterm" name="id3049755"></a><pre class="programlisting">#define PANGO_FONT_FAMILY(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_FAMILY, PangoFontFamily))

2637

</pre>

2638

<p>

2639

Casts a <a

2640

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2641

><span class="type">GObject</span></a> to a <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.

2642

</p>

2643

2644

2645

2646

<td>

2647

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

2648

<td>a <a

2649

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2650

><span class="type">GObject</span></a>.

2651

2652

2653

</td>

2654

</tr></tbody>

2655

</table></div>

2656

</div>

2657

<hr>

2658

2659

2660

<a name="PANGO-IS-FONT-FAMILY:CAPS"></a>PANGO_IS_FONT_FAMILY()</h3>

2661

<a class="indexterm" name="id3049826"></a><pre class="programlisting">#define PANGO_IS_FONT_FAMILY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_FAMILY))

2662

</pre>

2663

<p>

2664

Returns <a

2665

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

2666

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>.

2667

</p>

2668

2669

2670

2671

<td>

2672

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

2673

<td>a <a

2674

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2675

><span class="type">GObject</span></a>.

2676

2677

2678

</td>

2679

</tr></tbody>

2680

</table></div>

2681

</div>

2682

<hr>

2683

2684

2685

<a name="pango-font-family-get-name"></a>pango_font_family_get_name ()</h3>

2686

<a class="indexterm" name="id3049908"></a><pre class="programlisting">const char* pango_font_family_get_name (<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);</pre>

2687

<p>

2688

Gets the name of the family. The name is unique among all

2689

fonts for the font backend and can be used in a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>

2690

to specify that a face from this family is desired.</p>

2691

<p>

2692

2693

</p>

2694

2695

2696

<tbody>

2697

<tr>

2698

<td>

2699

<span class="term"><em class="parameter"><code>family</code></em> :</span></td>

2700

<td> a <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>

2701

</td>

2702

</tr>

2703

<tr>

2704

<td>

2705

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2706

<td> the name of the family. This string is owned

2707

by the family object and must not be modified or freed.

2708

</td>

2709

</tr>

2710

</tbody>

2711

</table></div>

2712

</div>

2713

<hr>

2714

2715

2716

<a name="pango-font-family-is-monospace"></a>pango_font_family_is_monospace ()</h3>

2717

<a class="indexterm" name="id3050005"></a><pre class="programlisting"><a

2718

href="../glib/glib-Basic-Types.html#gboolean"

2719

>gboolean</a> pango_font_family_is_monospace (<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family);</pre>

2720

<p>

2721

A monospace font is a font designed for text display where the the

2722

characters form a regular grid. For Western languages this would

2723

mean that the advance width of all characters are the same, but

2724

this categorization also includes Asian fonts which include

2725

double-width characters: characters that occupy two grid cells.

2726

2727

href="../glib/glib-Unicode-Manipulation.html#g-unichar-iswide"

2728

><code class="function">g_unichar_iswide()</code></a> returns a result that indicates whether a

2729

character is typically double-width in a monospace font.

2730

</p>

2731

<p>

2732

The best way to find out the grid-cell size is to call

2733

<a href="pango-Fonts.html#pango-font-metrics-get-approximate-digit-width"><code class="function">pango_font_metrics_get_approximate_digit_width()</code></a>, since the results

2734

of <a href="pango-Fonts.html#pango-font-metrics-get-approximate-char-width"><code class="function">pango_font_metrics_get_approximate_char_width()</code></a> may be affected

2735

by double-width characters.</p>

2736

<p>

2737

2738

</p>

2739

2740

2741

<tbody>

2742

<tr>

2743

<td>

2744

<span class="term"><em class="parameter"><code>family</code></em> :</span></td>

2745

<td> a <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>

2746

</td>

2747

</tr>

2748

<tr>

2749

<td>

2750

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2751

<td> <a

2752

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

2753

><code class="literal">TRUE</code></a> if the family is monospace.

2754

2755

</td>

2756

</tr>

2757

</tbody>

2758

</table></div>

2759

<p>Since 1.4

2760

</p>

2761

</div>

2762

<hr>

2763

2764

2765

<a name="pango-font-family-list-faces"></a>pango_font_family_list_faces ()</h3>

2766

<a class="indexterm" name="id3050151"></a><pre class="programlisting">void pango_font_family_list_faces (<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> *family,

2767

<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> ***faces,

2768

int *n_faces);</pre>

2769

<p>

2770

Lists the different font faces that make up <em class="parameter"><code>family</code></em>. The faces

2771

in a family share a common design, but differ in slant, weight,

2772

width and other aspects.</p>

2773

<p>

2774

2775

</p>

2776

2777

2778

<tbody>

2779

<tr>

2780

<td>

2781

<span class="term"><em class="parameter"><code>family</code></em> :</span></td>

2782

<td> a <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>

2783

</td>

2784

</tr>

2785

<tr>

2786

<td>

2787

<span class="term"><em class="parameter"><code>faces</code></em> :</span></td>

2788

<td> location to store an array of pointers to <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>

2789

objects, or <a

2790

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

2791

><code class="literal">NULL</code></a>. This array should be freed with <a

2792

href="../glib/glib-Memory-Allocation.html#g-free"

2793

><code class="function">g_free()</code></a>

2794

when it is no longer needed.

2795

</td>

2796

</tr>

2797

<tr>

2798

<td>

2799

<span class="term"><em class="parameter"><code>n_faces</code></em> :</span></td>

2800

<td> location to store number of elements in <em class="parameter"><code>faces</code></em>.

2801

</td>

2802

</tr>

2803

</tbody>

2804

</table></div>

2805

</div>

2806

<hr>

2807

2808

2809

<a name="PangoFontFace-struct"></a>PangoFontFace</h3>

2810

<a class="indexterm" name="id3050310"></a><pre class="programlisting">typedef struct _PangoFontFace PangoFontFace;</pre>

2811

<p>

2812

The <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a> structure is used to represent a group of fonts with

2813

the same family, slant, weight, width, but varying sizes.

2814

</p>

2815

</div>

2816

<hr>

2817

2818

2819

<a name="PANGO-TYPE-FONT-FACE:CAPS"></a>PANGO_TYPE_FONT_FACE</h3>

2820

<a class="indexterm" name="id3050349"></a><pre class="programlisting">#define PANGO_TYPE_FONT_FACE (pango_font_face_get_type ())

2821

</pre>

2822

<p>

2823

The <a

2824

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2825

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

2826

</p>

2827

</div>

2828

<hr>

2829

2830

2831

<a name="PANGO-FONT-FACE:CAPS"></a>PANGO_FONT_FACE()</h3>

2832

<a class="indexterm" name="id3050395"></a><pre class="programlisting">#define PANGO_FONT_FACE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_FACE, PangoFontFace))

2833

</pre>

2834

<p>

2835

Casts a <a

2836

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2837

><span class="type">GObject</span></a> to a <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

2838

</p>

2839

2840

2841

2842

<td>

2843

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

2844

<td>a <a

2845

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2846

><span class="type">GObject</span></a>.

2847

2848

2849

</td>

2850

</tr></tbody>

2851

</table></div>

2852

</div>

2853

<hr>

2854

2855

2856

<a name="PANGO-IS-FONT-FACE:CAPS"></a>PANGO_IS_FONT_FACE()</h3>

2857

<a class="indexterm" name="id3050466"></a><pre class="programlisting">#define PANGO_IS_FONT_FACE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_FACE))

2858

</pre>

2859

<p>

2860

Returns <a

2861

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

2862

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

2863

</p>

2864

2865

2866

2867

<td>

2868

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

2869

<td>a <a

2870

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

2871

><span class="type">GObject</span></a>.

2872

2873

2874

</td>

2875

</tr></tbody>

2876

</table></div>

2877

</div>

2878

<hr>

2879

2880

2881

<a name="pango-font-face-get-face-name"></a>pango_font_face_get_face_name ()</h3>

2882

<a class="indexterm" name="id3050547"></a><pre class="programlisting">const char* pango_font_face_get_face_name (<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);</pre>

2883

<p>

2884

Gets a name representing the style of this face among the

2885

different faces in the <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> for the face. This

2886

name is unique among all faces in the family and is suitable

2887

for displaying to users.</p>

2888

<p>

2889

2890

</p>

2891

2892

2893

<tbody>

2894

<tr>

2895

<td>

2896

2897

<td> a <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

2898

</td>

2899

</tr>

2900

<tr>

2901

<td>

2902

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2903

<td> the face name for the face. This string is

2904

owned by the face object and must not be modified or freed.

2905

</td>

2906

</tr>

2907

</tbody>

2908

</table></div>

2909

</div>

2910

<hr>

2911

2912

2913

<a name="pango-font-face-list-sizes"></a>pango_font_face_list_sizes ()</h3>

2914

<a class="indexterm" name="id3050645"></a><pre class="programlisting">void pango_font_face_list_sizes (<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face,

2915

int **sizes,

2916

int *n_sizes);</pre>

2917

<p>

2918

List the available sizes for a font. This is only applicable to bitmap

2919

fonts. For scalable fonts, stores <a

2920

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

2921

><code class="literal">NULL</code></a> at the location pointed to by

2922

<em class="parameter"><code>sizes</code></em> and 0 at the location pointed to by <em class="parameter"><code>n_sizes</code></em>. The sizes returned

2923

are in Pango units and are sorted in ascending order.</p>

2924

<p>

2925

2926

</p>

2927

2928

2929

<tbody>

2930

<tr>

2931

<td>

2932

2933

<td> a <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>.

2934

</td>

2935

</tr>

2936

<tr>

2937

<td>

2938

<span class="term"><em class="parameter"><code>sizes</code></em> :</span></td>

2939

<td> location to store a pointer to an array of int. This array

2940

should be freed with <a

2941

href="../glib/glib-Memory-Allocation.html#g-free"

2942

><code class="function">g_free()</code></a>.

2943

</td>

2944

</tr>

2945

<tr>

2946

<td>

2947

<span class="term"><em class="parameter"><code>n_sizes</code></em> :</span></td>

2948

<td> location to store the number of elements in <em class="parameter"><code>sizes</code></em>

2949

</td>

2950

</tr>

2951

</tbody>

2952

</table></div>

2953

<p>Since 1.4

2954

</p>

2955

</div>

2956

<hr>

2957

2958

2959

<a name="pango-font-face-describe"></a>pango_font_face_describe ()</h3>

2960

<a class="indexterm" name="id3050806"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_face_describe

2961

(<a href="pango-Fonts.html#PangoFontFace">PangoFontFace</a> *face);</pre>

2962

<p>

2963

Returns the family, style, variant, weight and stretch of

2964

a <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>. The size field of the resulting font description

2965

will be unset.</p>

2966

<p>

2967

2968

</p>

2969

2970

2971

<tbody>

2972

<tr>

2973

<td>

2974

2975

<td> a <a href="pango-Fonts.html#PangoFontFace"><span class="type">PangoFontFace</span></a>

2976

</td>

2977

</tr>

2978

<tr>

2979

<td>

2980

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

2981

<td> a newly-created <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure

2982

holding the description of the face. Use <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>

2983

to free the result.

2984

</td>

2985

</tr>

2986

</tbody>

2987

</table></div>

2988

</div>

2989

<hr>

2990

2991

2992

<a name="PangoFontMap-struct"></a>PangoFontMap</h3>

2993

<a class="indexterm" name="id3050920"></a><pre class="programlisting">typedef struct _PangoFontMap PangoFontMap;</pre>

2994

<p>

2995

The <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> represents the set of fonts available for a

2996

particular rendering system. This is a virtual object with

2997

implementations being specific to particular rendering systems. To

2998

create an implementation of a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, the rendering-system

2999

specific code should allocate a larger structure that contains a nested

3000

<a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>, fill in the <em class="structfield"><code>klass</code></em> member of the nested <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> with a

3001

pointer to a appropriate <a href="pango-Fonts.html#PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>, then call

3002

<code class="function">pango_font_map_init()</code> on the structure.

3003

</p>

3004

<p>

3005

The <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> structure contains one member which the implementation

3006

fills in.

3007

</p>

3008

</div>

3009

<hr>

3010

3011

3012

<a name="PANGO-TYPE-FONT-MAP:CAPS"></a>PANGO_TYPE_FONT_MAP</h3>

3013

<a class="indexterm" name="id3051026"></a><pre class="programlisting">#define PANGO_TYPE_FONT_MAP (pango_font_map_get_type ())

3014

</pre>

3015

<p>

3016

The <a

3017

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3018

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

3019

</p>

3020

</div>

3021

<hr>

3022

3023

3024

<a name="PANGO-FONT-MAP:CAPS"></a>PANGO_FONT_MAP()</h3>

3025

<a class="indexterm" name="id3051070"></a><pre class="programlisting">#define PANGO_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FONT_MAP, PangoFontMap))

3026

</pre>

3027

<p>

3028

Casts a <a

3029

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3030

><span class="type">GObject</span></a> to a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

3031

</p>

3032

3033

3034

3035

<td>

3036

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

3037

<td>a <a

3038

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3039

><span class="type">GObject</span></a>.

3040

3041

3042

</td>

3043

</tr></tbody>

3044

</table></div>

3045

</div>

3046

<hr>

3047

3048

3049

<a name="PANGO-IS-FONT-MAP:CAPS"></a>PANGO_IS_FONT_MAP()</h3>

3050

<a class="indexterm" name="id3051143"></a><pre class="programlisting">#define PANGO_IS_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FONT_MAP))

3051

</pre>

3052

<p>

3053

Returns <a

3054

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

3055

><code class="literal">TRUE</code></a> if <em class="parameter"><code>object</code></em> is a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

3056

</p>

3057

3058

3059

3060

<td>

3061

<span class="term"><em class="parameter"><code>object</code></em> :</span></td>

3062

<td>a <a

3063

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3064

><span class="type">GObject</span></a>.

3065

3066

3067

</td>

3068

</tr></tbody>

3069

</table></div>

3070

</div>

3071

<hr>

3072

3073

3074

<a name="PangoFontMapClass"></a>PangoFontMapClass</h3>

3075

<a class="indexterm" name="id3051222"></a><pre class="programlisting">typedef struct {

3076

GObjectClass parent_class;

3077

3078

3079

PangoFont * (*load_font) (PangoFontMap *fontmap,

3080

PangoContext *context,

3081

const PangoFontDescription *desc);

3082

void (*list_families) (PangoFontMap *fontmap,

3083

PangoFontFamily ***families,

3084

int *n_families);

3085

PangoFontset *(*load_fontset) (PangoFontMap *fontmap,

3086

PangoContext *context,

3087

const PangoFontDescription *desc,

3088

PangoLanguage *language);

3089

3090

const char *shape_engine_type;

3091

} PangoFontMapClass;

3092

</pre>

3093

<p>

3094

The <a href="pango-Fonts.html#PangoFontMapClass"><span class="type">PangoFontMapClass</span></a> structure holds the virtual functions for

3095

a particular <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> implementation.

3096

</p>

3097

3098

3099

<tbody>

3100

<tr>

3101

<td>

3102

<span class="term"><a

3103

href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"

3104

>GObjectClass</a> <em class="structfield"><code>parent_class</code></em>;</span></td>

3105

<td>parent <a

3106

href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"

3107

><span class="type">GObjectClass</span></a>.

3108

</td>

3109

</tr>

3110

<tr>

3111

<td>

3112

3113

<td>a function to load a font with a given description. See

3114

<a href="pango-Fonts.html#pango-font-map-load-font"><code class="function">pango_font_map_load_font()</code></a>.

3115

</td>

3116

</tr>

3117

<tr>

3118

<td>

3119

<span class="term"><em class="structfield"><code>list_families</code></em> ()</span></td>

3120

<td>A function to list available font families. See

3121

<a href="pango-Fonts.html#pango-font-map-list-families"><code class="function">pango_font_map_list_families()</code></a>.

3122

</td>

3123

</tr>

3124

<tr>

3125

<td>

3126

<span class="term"><em class="structfield"><code>load_fontset</code></em> ()</span></td>

3127

<td>a function to load a fontset with a given given description

3128

suitable for a particular language. See

3129

<a href="pango-Fonts.html#pango-font-map-load-fontset"><code class="function">pango_font_map_load_fontset()</code></a>.

3130

</td>

3131

</tr>

3132

<tr>

3133

<td>

3134

<span class="term">const char *<em class="structfield"><code>shape_engine_type</code></em>;</span></td>

3135

<td>the type of rendering-system-dependent engines that

3136

can handle fonts of this fonts loaded with this fontmap.

3137

3138

</td>

3139

</tr>

3140

</tbody>

3141

</table></div>

3142

</div>

3143

<hr>

3144

3145

3146

<a name="PANGO-FONT-MAP-CLASS:CAPS"></a>PANGO_FONT_MAP_CLASS()</h3>

3147

<a class="indexterm" name="id3051414"></a><pre class="programlisting">#define PANGO_FONT_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), PANGO_TYPE_FONT_MAP, PangoFontMapClass))

3148

</pre>

3149

<p>

3150

Casts a <a

3151

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3152

><span class="type">GObject</span></a> to a <a href="pango-Fonts.html#PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.

3153

</p>

3154

3155

3156

3157

<td>

3158

<span class="term"><em class="parameter"><code>klass</code></em> :</span></td>

3159

<td>a <a

3160

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3161

><span class="type">GObject</span></a>.

3162

3163

3164

</td>

3165

</tr></tbody>

3166

</table></div>

3167

</div>

3168

<hr>

3169

3170

3171

<a name="PANGO-IS-FONT-MAP-CLASS:CAPS"></a>PANGO_IS_FONT_MAP_CLASS()</h3>

3172

<a class="indexterm" name="id3051487"></a><pre class="programlisting">#define PANGO_IS_FONT_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), PANGO_TYPE_FONT_MAP))

3173

</pre>

3174

<p>

3175

Returns <a

3176

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

3177

><code class="literal">TRUE</code></a> if <em class="parameter"><code>klass</code></em> is a subtype of <a href="pango-Fonts.html#PangoFontMapClass"><span class="type">PangoFontMapClass</span></a>.

3178

</p>

3179

3180

3181

3182

<td>

3183

<span class="term"><em class="parameter"><code>klass</code></em> :</span></td>

3184

<td>a <a

3185

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3186

><span class="type">GObject</span></a>.

3187

3188

3189

</td>

3190

</tr></tbody>

3191

</table></div>

3192

</div>

3193

<hr>

3194

3195

3196

<a name="PANGO-FONT-MAP-GET-CLASS:CAPS"></a>PANGO_FONT_MAP_GET_CLASS()</h3>

3197

<a class="indexterm" name="id3051568"></a><pre class="programlisting">#define PANGO_FONT_MAP_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), PANGO_TYPE_FONT_MAP, PangoFontMapClass))

3198

</pre>

3199

<p>

3200

Returns the type of a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

3201

</p>

3202

3203

3204

3205

<td>

3206

3207

<td>a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>.

3208

3209

3210

</td>

3211

</tr></tbody>

3212

</table></div>

3213

</div>

3214

<hr>

3215

3216

3217

<a name="pango-font-map-load-font"></a>pango_font_map_load_font ()</h3>

3218

<a class="indexterm" name="id3051632"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFont">PangoFont</a>* pango_font_map_load_font (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,

3219

<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,

3220

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>

3221

<p>

3222

Load the font in the fontmap that is the closest match for <em class="parameter"><code>desc</code></em>.</p>

3223

<p>

3224

3225

</p>

3226

3227

3228

<tbody>

3229

<tr>

3230

<td>

3231

<span class="term"><em class="parameter"><code>fontmap</code></em> :</span></td>

3232

<td> a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

3233

</td>

3234

</tr>

3235

<tr>

3236

<td>

3237

<span class="term"><em class="parameter"><code>context</code></em> :</span></td>

3238

<td> the <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with

3239

</td>

3240

</tr>

3241

<tr>

3242

<td>

3243

3244

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load

3245

</td>

3246

</tr>

3247

<tr>

3248

<td>

3249

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3250

<td>the font loaded, or <a

3251

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

3252

><code class="literal">NULL</code></a> if no font matched.

3253

</td>

3254

</tr>

3255

</tbody>

3256

</table></div>

3257

</div>

3258

<hr>

3259

3260

3261

<a name="pango-font-map-load-fontset"></a>pango_font_map_load_fontset ()</h3>

3262

<a class="indexterm" name="id3051793"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontset">PangoFontset</a>* pango_font_map_load_fontset (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,

3263

<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,

3264

const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,

3265

<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);</pre>

3266

<p>

3267

Load a set of fonts in the fontmap that can be used to render

3268

a font matching <em class="parameter"><code>desc</code></em>.</p>

3269

<p>

3270

3271

</p>

3272

3273

3274

<tbody>

3275

<tr>

3276

<td>

3277

<span class="term"><em class="parameter"><code>fontmap</code></em> :</span></td>

3278

<td> a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

3279

</td>

3280

</tr>

3281

<tr>

3282

<td>

3283

<span class="term"><em class="parameter"><code>context</code></em> :</span></td>

3284

<td> the <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> the font will be used with

3285

</td>

3286

</tr>

3287

<tr>

3288

<td>

3289

3290

<td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> describing the font to load

3291

</td>

3292

</tr>

3293

<tr>

3294

<td>

3295

<span class="term"><em class="parameter"><code>language</code></em> :</span></td>

3296

<td> a <a href="pango-Text-Attributes.html#PangoLanguage"><span class="type">PangoLanguage</span></a> the fonts will be used for

3297

</td>

3298

</tr>

3299

<tr>

3300

<td>

3301

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3302

<td>the fontset, or <a

3303

href="../glib/glib-Standard-Macros.html#NULL:CAPS"

3304

><code class="literal">NULL</code></a> if no font matched.

3305

</td>

3306

</tr>

3307

</tbody>

3308

</table></div>

3309

</div>

3310

<hr>

3311

3312

3313

<a name="pango-font-map-list-families"></a>pango_font_map_list_families ()</h3>

3314

<a class="indexterm" name="id3051985"></a><pre class="programlisting">void pango_font_map_list_families (<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap,

3315

<a href="pango-Fonts.html#PangoFontFamily">PangoFontFamily</a> ***families,

3316

int *n_families);</pre>

3317

<p>

3318

List all families for a fontmap.</p>

3319

<p>

3320

3321

</p>

3322

3323

3324

<tbody>

3325

<tr>

3326

<td>

3327

<span class="term"><em class="parameter"><code>fontmap</code></em> :</span></td>

3328

<td> a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

3329

</td>

3330

</tr>

3331

<tr>

3332

<td>

3333

<span class="term"><em class="parameter"><code>families</code></em> :</span></td>

3334

<td> location to store a pointer to an array of <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a> *.

3335

This array should be freed with <a

3336

href="../glib/glib-Memory-Allocation.html#g-free"

3337

><code class="function">g_free()</code></a>.

3338

</td>

3339

</tr>

3340

<tr>

3341

<td>

3342

<span class="term"><em class="parameter"><code>n_families</code></em> :</span></td>

3343

<td> location to store the number of elements in <em class="parameter"><code>families</code></em>

3344

</td>

3345

</tr>

3346

</tbody>

3347

</table></div>

3348

</div>

3349

<hr>

3350

3351

3352

<a name="pango-font-map-get-shape-engine-type"></a>pango_font_map_get_shape_engine_type ()</h3>

3353

<a class="indexterm" name="id3052128"></a><pre class="programlisting">const char* pango_font_map_get_shape_engine_type

3354

(<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *fontmap);</pre>

3355

<p>

3356

Returns the render ID for shape engines for this fontmap.

3357

See the <em class="structfield"><code>render_type</code></em> field of

3358

<a href="pango-Engines.html#PangoEngineInfo"><span class="type">PangoEngineInfo</span></a>.</p>

3359

<p>

3360

3361

</p>

3362

3363

3364

<tbody>

3365

<tr>

3366

<td>

3367

<span class="term"><em class="parameter"><code>fontmap</code></em> :</span></td>

3368

<td> a <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a>

3369

</td>

3370

</tr>

3371

<tr>

3372

<td>

3373

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3374

<td> the ID string for shape engines for

3375

this fontmap. Owned by Pango, should not be modified

3376

or freed.

3377

3378

</td>

3379

</tr>

3380

</tbody>

3381

</table></div>

3382

<p>Since 1.4

3383

</p>

3384

</div>

3385

<hr>

3386

3387

3388

<a name="PangoFontset-struct"></a>PangoFontset</h3>

3389

<a class="indexterm" name="id3052232"></a><pre class="programlisting">typedef struct _PangoFontset PangoFontset;</pre>

3390

<p>

3391

A <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> represents a set of <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> to use

3392

when rendering text. It is the result of resolving a

3393

<a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> against a particular <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.

3394

It has operations for finding the component font for

3395

a particular Unicode character, and for finding a composite

3396

set of metrics for the entire fontset.

3397

</p>

3398

</div>

3399

<hr>

3400

3401

3402

<a name="PANGO-TYPE-FONTSET:CAPS"></a>PANGO_TYPE_FONTSET</h3>

3403

<a class="indexterm" name="id3052298"></a><pre class="programlisting">#define PANGO_TYPE_FONTSET (pango_fontset_get_type ())

3404

</pre>

3405

<p>

3406

The <a

3407

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3408

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>.

3409

</p>

3410

</div>

3411

<hr>

3412

3413

3414

<a name="PangoFontsetClass"></a>PangoFontsetClass</h3>

3415

<a class="indexterm" name="id3052343"></a><pre class="programlisting">typedef struct {

3416

GObjectClass parent_class;

3417

3418

3419

PangoFont * (*get_font) (PangoFontset *fontset,

3420

guint wc);

3421

3422

PangoFontMetrics *(*get_metrics) (PangoFontset *fontset);

3423

PangoLanguage * (*get_language) (PangoFontset *fontset);

3424

void (*foreach) (PangoFontset *fontset,

3425

PangoFontsetForeachFunc func,

3426

gpointer data);

3427

} PangoFontsetClass;

3428

</pre>

3429

<p>

3430

The <a href="pango-Fonts.html#PangoFontsetClass"><span class="type">PangoFontsetClass</span></a> structure holds the virtual functions for

3431

a particular <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> implementation.

3432

</p>

3433

3434

3435

<tbody>

3436

<tr>

3437

<td>

3438

<span class="term"><a

3439

href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"

3440

>GObjectClass</a> <em class="structfield"><code>parent_class</code></em>;</span></td>

3441

<td>parent <a

3442

href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"

3443

><span class="type">GObjectClass</span></a>.

3444

</td>

3445

</tr>

3446

<tr>

3447

<td>

3448

3449

<td>a function to get the font in the fontset that contains the

3450

best glyph for the given Unicode character; see <a href="pango-Fonts.html#pango-fontset-get-font"><code class="function">pango_fontset_get_font()</code></a>.

3451

</td>

3452

</tr>

3453

<tr>

3454

<td>

3455

<span class="term"><em class="structfield"><code>get_metrics</code></em> ()</span></td>

3456

<td>a function to get overall metric information for the fonts

3457

in the fontset; see <a href="pango-Fonts.html#pango-fontset-get-metrics"><code class="function">pango_fontset_get_metrics()</code></a>.

3458

</td>

3459

</tr>

3460

<tr>

3461

<td>

3462

<span class="term"><em class="structfield"><code>get_language</code></em> ()</span></td>

3463

<td>a function to get the language of the fontset.

3464

</td>

3465

</tr>

3466

<tr>

3467

<td>

3468

<span class="term"><em class="structfield"><code>foreach</code></em> ()</span></td>

3469

<td>a function to loop over the fonts in the fontset. See

3470

<a href="pango-Fonts.html#pango-fontset-foreach"><code class="function">pango_fontset_foreach()</code></a>.

3471

3472

</td>

3473

</tr>

3474

</tbody>

3475

</table></div>

3476

</div>

3477

<hr>

3478

3479

3480

<a name="pango-fontset-get-font"></a>pango_fontset_get_font ()</h3>

3481

<a class="indexterm" name="id3052529"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFont">PangoFont</a>* pango_fontset_get_font (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

3482

3483

href="../glib/glib-Basic-Types.html#guint"

3484

>guint</a> wc);</pre>

3485

<p>

3486

Returns the font in the fontset that contains the best glyph for the

3487

Unicode character <em class="parameter"><code>wc</code></em>.</p>

3488

<p>

3489

3490

</p>

3491

3492

3493

<tbody>

3494

<tr>

3495

<td>

3496

<span class="term"><em class="parameter"><code>fontset</code></em> :</span></td>

3497

<td> a <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3498

</td>

3499

</tr>

3500

<tr>

3501

<td>

3502

3503

<td> a Unicode character

3504

</td>

3505

</tr>

3506

<tr>

3507

<td>

3508

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3509

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>. The caller must call g_object_unref when finished

3510

with the font.

3511

</td>

3512

</tr>

3513

</tbody>

3514

</table></div>

3515

</div>

3516

<hr>

3517

3518

3519

<a name="pango-fontset-get-metrics"></a>pango_fontset_get_metrics ()</h3>

3520

<a class="indexterm" name="id3052648"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMetrics">PangoFontMetrics</a>* pango_fontset_get_metrics (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset);</pre>

3521

<p>

3522

Get overall metric information for the fonts in the fontset.</p>

3523

<p>

3524

3525

</p>

3526

3527

3528

<tbody>

3529

<tr>

3530

<td>

3531

<span class="term"><em class="parameter"><code>fontset</code></em> :</span></td>

3532

<td> a <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3533

</td>

3534

</tr>

3535

<tr>

3536

<td>

3537

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3538

3539

when finished using the object.

3540

</td>

3541

</tr>

3542

</tbody>

3543

</table></div>

3544

</div>

3545

<hr>

3546

3547

3548

<a name="PangoFontsetForeachFunc"></a>PangoFontsetForeachFunc ()</h3>

3549

<a class="indexterm" name="id3052752"></a><pre class="programlisting"><a

3550

href="../glib/glib-Basic-Types.html#gboolean"

3551

>gboolean</a> (*PangoFontsetForeachFunc) (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

3552

<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,

3553

3554

href="../glib/glib-Basic-Types.html#gpointer"

3555

>gpointer</a> data);</pre>

3556

<p>

3557

A callback function used by <a href="pango-Fonts.html#pango-fontset-foreach"><code class="function">pango_fontset_foreach()</code></a> when enumerating

3558

the fonts in a fontset.</p>

3559

<p>

3560

3561

</p>

3562

3563

3564

<tbody>

3565

<tr>

3566

<td>

3567

<span class="term"><em class="parameter"><code>fontset</code></em> :</span></td>

3568

<td> a <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3569

</td>

3570

</tr>

3571

<tr>

3572

<td>

3573

3574

<td> a font from <em class="parameter"><code>fontset</code></em>

3575

</td>

3576

</tr>

3577

<tr>

3578

<td>

3579

3580

<td> callback data

3581

</td>

3582

</tr>

3583

<tr>

3584

<td>

3585

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3586

<td> if <a

3587

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

3588

><code class="literal">TRUE</code></a>, stop iteration and return immediately.

3589

3590

</td>

3591

</tr>

3592

</tbody>

3593

</table></div>

3594

<p>Since 1.4

3595

</p>

3596

</div>

3597

<hr>

3598

3599

3600

<a name="pango-fontset-foreach"></a>pango_fontset_foreach ()</h3>

3601

<a class="indexterm" name="id3052912"></a><pre class="programlisting">void pango_fontset_foreach (<a href="pango-Fonts.html#PangoFontset">PangoFontset</a> *fontset,

3602

<a href="pango-Fonts.html#PangoFontsetForeachFunc">PangoFontsetForeachFunc</a> func,

3603

3604

href="../glib/glib-Basic-Types.html#gpointer"

3605

>gpointer</a> data);</pre>

3606

<p>

3607

Iterates through all the fonts in a fontset, calling <em class="parameter"><code>func</code></em> for

3608

each one. If <em class="parameter"><code>func</code></em> returns <a

3609

href="../glib/glib-Standard-Macros.html#TRUE:CAPS"

3610

><code class="literal">TRUE</code></a>, that stops the iteration.</p>

3611

<p>

3612

3613

</p>

3614

3615

3616

<tbody>

3617

<tr>

3618

<td>

3619

<span class="term"><em class="parameter"><code>fontset</code></em> :</span></td>

3620

<td> a <a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a>

3621

</td>

3622

</tr>

3623

<tr>

3624

<td>

3625

3626

<td> Callback function

3627

</td>

3628

</tr>

3629

<tr>

3630

<td>

3631

3632

<td> data to pass to the callback function

3633

</td>

3634

</tr>

3635

</tbody>

3636

</table></div>

3637

<p>Since 1.4

3638

</p>

3639

</div>

3640

<hr>

3641

3642

3643

<a name="PangoFontsetSimple-struct"></a>PangoFontsetSimple</h3>

3644

<a class="indexterm" name="id3053056"></a><pre class="programlisting">typedef struct _PangoFontsetSimple PangoFontsetSimple;</pre>

3645

<p>

3646

<a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> is a implementation of the abstract

3647

<a href="pango-Fonts.html#PangoFontset"><span class="type">PangoFontset</span></a> base class in terms of an array of fonts,

3648

which the creator provides when constructing the

3649

<a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.

3650

</p>

3651

</div>

3652

<hr>

3653

3654

3655

<a name="PANGO-TYPE-FONTSET-SIMPLE:CAPS"></a>PANGO_TYPE_FONTSET_SIMPLE</h3>

3656

<a class="indexterm" name="id3053112"></a><pre class="programlisting">#define PANGO_TYPE_FONTSET_SIMPLE (pango_fontset_simple_get_type ())

3657

</pre>

3658

<p>

3659

The <a

3660

href="../gobject/gobject-The-Base-Object-Type.html#GObject"

3661

><span class="type">GObject</span></a> type for <a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.

3662

</p>

3663

</div>

3664

<hr>

3665

3666

3667

<a name="pango-fontset-simple-new"></a>pango_fontset_simple_new ()</h3>

3668

<a class="indexterm" name="id3053158"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a>* pango_fontset_simple_new

3669

(<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);</pre>

3670

<p>

3671

Creates a new <a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a> for the given language.</p>

3672

<p>

3673

3674

</p>

3675

3676

3677

<tbody>

3678

<tr>

3679

<td>

3680

<span class="term"><em class="parameter"><code>language</code></em> :</span></td>

3681

<td> a <a href="pango-Text-Attributes.html#PangoLanguage"><span class="type">PangoLanguage</span></a> tag

3682

</td>

3683

</tr>

3684

<tr>

3685

<td>

3686

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3687

<td> the newly allocated <a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>, which should

3688

be freed with <a

3689

href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"

3690

><code class="function">g_object_unref()</code></a>.

3691

</td>

3692

</tr>

3693

</tbody>

3694

</table></div>

3695

</div>

3696

<hr>

3697

3698

3699

<a name="pango-fontset-simple-append"></a>pango_fontset_simple_append ()</h3>

3700

<a class="indexterm" name="id3053270"></a><pre class="programlisting">void pango_fontset_simple_append (<a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset,

3701

<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>

3702

<p>

3703

Adds a font to the fontset.</p>

3704

<p>

3705

3706

</p>

3707

3708

3709

<tbody>

3710

<tr>

3711

<td>

3712

<span class="term"><em class="parameter"><code>fontset</code></em> :</span></td>

3713

<td> a <a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.

3714

</td>

3715

</tr>

3716

<tr>

3717

<td>

3718

3719

<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.

3720

</td>

3721

</tr>

3722

</tbody>

3723

</table></div>

3724

</div>

3725

<hr>

3726

3727

3728

<a name="pango-fontset-simple-size"></a>pango_fontset_simple_size ()</h3>

3729

<a class="indexterm" name="id3053371"></a><pre class="programlisting">int pango_fontset_simple_size (<a href="pango-Fonts.html#PangoFontsetSimple">PangoFontsetSimple</a> *fontset);</pre>

3730

<p>

3731

Returns the number of fonts in the fontset.</p>

3732

<p>

3733

3734

</p>

3735

3736

3737

<tbody>

3738

<tr>

3739

<td>

3740

<span class="term"><em class="parameter"><code>fontset</code></em> :</span></td>

3741

<td> a <a href="pango-Fonts.html#PangoFontsetSimple"><span class="type">PangoFontsetSimple</span></a>.

3742

</td>

3743

</tr>

3744

<tr>

3745

<td>

3746

<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

3747

<td> the size of <em class="parameter"><code>fontset</code></em>.

3748

</td>

3749

</tr>

3750

</tbody>

3751

</table></div>

3752

</div>

3753

</div>

3754

</div>

3755

</body>

3756

</html>

Older »