svn merge ^/trunk/blender -r49410:49412
[blender.git] / source / blender / blenfont / BLF_api.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version. 
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2009 Blender Foundation.
19  * All rights reserved.
20  *
21  * 
22  * Contributor(s): Blender Foundation
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 /** \file blender/blenfont/BLF_api.h
28  *  \ingroup blf
29  */
30
31
32 #ifndef __BLF_API_H__
33 #define __BLF_API_H__
34
35 struct rctf;
36
37 int BLF_init(int points, int dpi);
38 void BLF_exit(void);
39
40 void BLF_cache_clear(void);
41
42 int BLF_load(const char *name);
43 int BLF_load_mem(const char *name, const unsigned char *mem, int mem_size);
44
45 int BLF_load_unique(const char *name);
46 int BLF_load_mem_unique(const char *name, const unsigned char *mem, int mem_size);
47
48 void BLF_unload(const char *name);
49
50 /* Attach a file with metrics information from memory. */
51 void BLF_metrics_attach(int fontid, unsigned char *mem, int mem_size);
52
53 void BLF_aspect(int fontid, float x, float y, float z);
54 void BLF_position(int fontid, float x, float y, float z);
55 void BLF_size(int fontid, int size, int dpi);
56
57 /* Set a 4x4 matrix to be multiplied before draw the text.
58  * Remember that you need call BLF_enable(BLF_MATRIX)
59  * to enable this.
60  *
61  * The order of the matrix is like GL:
62  *
63  *  | m[0]  m[4]  m[8]  m[12] |
64  *  | m[1]  m[5]  m[9]  m[13] |
65  *  | m[2]  m[6]  m[10] m[14] |
66  *  | m[3]  m[7]  m[11] m[15] |
67  *
68  */
69 void BLF_matrix(int fontid, const double m[16]);
70
71 /* Draw the string using the default font, size and dpi. */
72 void BLF_draw_default(float x, float y, float z, const char *str, size_t len);
73 void BLF_draw_default_ascii(float x, float y, float z, const char *str, size_t len);
74
75 /* Draw the string using the current font. */
76 void BLF_draw(int fontid, const char *str, size_t len);
77 void BLF_draw_ascii(int fontid, const char *str, size_t len);
78
79 /* This function return the bounding box of the string
80  * and are not multiplied by the aspect.
81  */
82 void BLF_boundbox(int fontid, const char *str, struct rctf *box);
83
84 /* The next both function return the width and height
85  * of the string, using the current font and both value 
86  * are multiplied by the aspect of the font.
87  */
88 float BLF_width(int fontid, const char *str);
89 float BLF_height(int fontid, const char *str);
90
91 /* Return dimensions of the font without any sample text. */
92 float BLF_height_max(int fontid);
93 float BLF_width_max(int fontid);
94 float BLF_descender(int fontid);
95 float BLF_ascender(int fontid);
96
97 /* The following function return the width and height of the string, but
98  * just in one call, so avoid extra freetype2 stuff.
99  */
100 void BLF_width_and_height(int fontid, const char *str, float *width, float *height);
101
102 /* For fixed width fonts only, returns the width of a
103  * character.
104  */
105 float BLF_fixed_width(int fontid);
106
107 /* and this two function return the width and height
108  * of the string, using the default font and both value
109  * are multiplied by the aspect of the font.
110  */
111 float BLF_width_default(const char *str);
112 float BLF_height_default(const char *str);
113
114 /* Set rotation for default font. */
115 void BLF_rotation_default(float angle);
116
117 /* Enable/disable options to the default font. */
118 void BLF_enable_default(int option);
119 void BLF_disable_default(int option);
120
121 /* By default, rotation and clipping are disable and
122  * have to be enable/disable using BLF_enable/disable.
123  */
124 void BLF_rotation(int fontid, float angle);
125 void BLF_clipping(int fontid, float xmin, float ymin, float xmax, float ymax);
126 void BLF_clipping_default(float xmin, float ymin, float xmax, float ymax);
127 void BLF_blur(int fontid, int size);
128
129 void BLF_enable(int fontid, int option);
130 void BLF_disable(int fontid, int option);
131
132 /* Shadow options, level is the blur level, can be 3, 5 or 0 and
133  * the other argument are the rgba color.
134  * Take care that shadow need to be enable using BLF_enable!!!
135  */
136 void BLF_shadow(int fontid, int level, float r, float g, float b, float a);
137
138 /* Set the offset for shadow text, this is the current cursor
139  * position plus this offset, don't need call BLF_position before
140  * this function, the current position is calculate only on
141  * BLF_draw, so it's safe call this whenever you like.
142  */
143 void BLF_shadow_offset(int fontid, int x, int y);
144
145 /* Set the buffer, size and number of channels to draw, one thing to take care is call
146  * this function with NULL pointer when we finish, for example:
147  *
148  *     BLF_buffer(my_fbuf, my_cbuf, 100, 100, 4);
149  *
150  *     ... set color, position and draw ...
151  *
152  *     BLF_buffer(NULL, NULL, 0, 0, 0);
153  */
154 void BLF_buffer(int fontid, float *fbuf, unsigned char *cbuf, int w, int h, int nch);
155
156 /* Set the color to be used for text. */
157 void BLF_buffer_col(int fontid, float r, float g, float b, float a);
158
159 /* Draw the string into the buffer, this function draw in both buffer, float and unsigned char _BUT_
160  * it's not necessary set both buffer, NULL is valid here.
161  */
162 void BLF_draw_buffer(int fontid, const char *str);
163
164 /* Add a path to the font dir paths. */
165 void BLF_dir_add(const char *path);
166
167 /* Remove a path from the font dir paths. */
168 void BLF_dir_rem(const char *path);
169
170 /* Return an array with all the font dir (this can be used for filesel) */
171 char **BLF_dir_get(int *ndir);
172
173 /* Free the data return by BLF_dir_get. */
174 void BLF_dir_free(char **dirs, int count);
175
176 /* font->flags. */
177 #define BLF_ROTATION         (1 << 0)
178 #define BLF_CLIPPING         (1 << 1)
179 #define BLF_SHADOW           (1 << 2)
180 #define BLF_KERNING_DEFAULT  (1 << 3)
181 #define BLF_MATRIX           (1 << 4)
182 #define BLF_ASPECT           (1 << 5)
183
184 #define BLF_DRAW_STR_DUMMY_MAX 1024
185
186 /* XXX, bad design */
187 extern int blf_mono_font;
188 extern int blf_mono_font_render; /* don't mess drawing with render threads. */
189
190 #endif /* __BLF_API_H__ */