1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
/* texfonts, Copyright (c) 2005-2016 Jamie Zawinski <jwz@jwz.org>
* Loads X11 fonts into textures for use with OpenGL.
*
* Permission to use, copy, modify, distribute, and sell this software and its
* documentation for any purpose is hereby granted without fee, provided that
* the above copyright notice appear in all copies and that both that
* copyright notice and this permission notice appear in supporting
* documentation. No representations are made about the suitability of this
* software for any purpose. It is provided "as is" without express or
* implied warranty.
*/
#ifndef __TEXTURE_FONT_H__
#define __TEXTURE_FONT_H__
typedef struct texture_font_data texture_font_data;
/* Loads the font named by the X resource "res" and returns
a texture-font object.
*/
extern texture_font_data *load_texture_font (Display *, char *res);
/* Bounding box of the multi-line string, in pixels,
and overall ascent/descent of the font.
*/
extern void texture_string_metrics (texture_font_data *, const char *,
XCharStruct *metrics_ret,
int *ascent_ret, int *descent_ret);
/* Draws the string in the scene at the origin.
Newlines and tab stops are honored.
Any numbers inside [] will be rendered as a subscript.
Assumes the font has been loaded as with load_texture_font().
*/
extern void print_texture_string (texture_font_data *, const char *);
/* Draws the string on the window at the given pixel position.
Newlines and tab stops are honored.
Any numbers inside [] will be rendered as a subscript.
Assumes the font has been loaded as with load_texture_font().
Position is 0 for center, 1 for top left, 2 for bottom left.
*/
void print_texture_label (Display *, texture_font_data *,
int window_width, int window_height,
int position, const char *string);
/* Renders the given string into the prevailing texture.
Returns the metrics of the text, and size of the texture.
*/
void string_to_texture (texture_font_data *, const char *,
XCharStruct *extents_ret,
int *tex_width_ret, int *tex_height_ret);
/* Set the various OpenGL parameters for properly rendering things
with a texture generated by string_to_texture().
*/
void enable_texture_string_parameters (void);
/* Releases the texture font.
*/
extern void free_texture_font (texture_font_data *);
#ifdef HAVE_JWXYZ
extern char *texfont_unicode_character_name (texture_font_data *,
unsigned long uc);
#endif
#endif /* __TEXTURE_FONT_H__ */
|