2022-02-10 23:07:11 +01:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
* Copyright 2008 Blender Foundation. All rights reserved. */
|
2009-01-29 06:19:27 +01:00
|
|
|
|
2019-02-17 22:08:12 +01:00
|
|
|
/** \file
|
|
|
|
* \ingroup blf
|
2011-02-27 21:42:42 +01:00
|
|
|
*/
|
|
|
|
|
2012-02-17 19:59:41 +01:00
|
|
|
#pragma once
|
2009-01-29 06:19:27 +01:00
|
|
|
|
2018-06-22 02:35:37 +02:00
|
|
|
#include "GPU_texture.h"
|
2020-03-19 09:33:03 +01:00
|
|
|
#include "GPU_vertex_buffer.h"
|
2018-03-30 19:16:14 +02:00
|
|
|
|
2018-03-31 13:09:03 +02:00
|
|
|
#define BLF_BATCH_DRAW_LEN_MAX 2048 /* in glyph */
|
2018-03-30 19:16:14 +02:00
|
|
|
|
2021-08-13 23:31:10 +02:00
|
|
|
/* Number of characters in GlyphCacheBLF.glyph_ascii_table. */
|
|
|
|
#define GLYPH_ASCII_TABLE_SIZE 128
|
|
|
|
|
|
|
|
/* Number of characters in KerningCacheBLF.table. */
|
|
|
|
#define KERNING_CACHE_TABLE_SIZE 128
|
|
|
|
|
2021-08-21 02:48:42 +02:00
|
|
|
/* A value in the kerning cache that indicates it is not yet set. */
|
|
|
|
#define KERNING_ENTRY_UNSET INT_MAX
|
|
|
|
|
2018-04-21 20:42:27 +02:00
|
|
|
typedef struct BatchBLF {
|
2018-03-30 19:16:14 +02:00
|
|
|
struct FontBLF *font; /* can only batch glyph from the same font */
|
2018-07-18 00:12:21 +02:00
|
|
|
struct GPUBatch *batch;
|
|
|
|
struct GPUVertBuf *verts;
|
BLF: Optimize text rendering and caching
The current code allocates and transfers a lot of memory to the GPU,
but only a small portion of this memory is actually used.
In addition, the code calls many costly gl operations during the
caching process.
This commit significantly reduce the amount of memory by allocating
and transferring a flat array without pads to the GPU.
It also calls as little as possible the gl operations during the cache.
This code also simulate a billinear filter `GL_LINEAR` using a 1D texture.
**Average drawing time:**
|before:|0.00003184 sec
|now:|0.00001943 sec
|fac:|1.6385156675048407
**5 worst times:**
|before:|[0.001075, 0.001433, 0.002143, 0.002915, 0.003242]
|now:|[0.00094, 0.000993, 0.001502, 0.002284, 0.002328]
Differential Revision: https://developer.blender.org/D6886
2020-02-23 21:30:27 +01:00
|
|
|
struct GPUVertBufRaw pos_step, col_step, offset_step, glyph_size_step;
|
|
|
|
unsigned int pos_loc, col_loc, offset_loc, glyph_size_loc;
|
2018-03-31 13:09:03 +02:00
|
|
|
unsigned int glyph_len;
|
2018-03-30 19:16:14 +02:00
|
|
|
float ofs[2]; /* copy of font->pos */
|
2018-03-30 20:59:45 +02:00
|
|
|
float mat[4][4]; /* previous call modelmatrix. */
|
2018-03-30 22:50:17 +02:00
|
|
|
bool enabled, active, simple_shader;
|
BLF: Optimize text rendering and caching
The current code allocates and transfers a lot of memory to the GPU,
but only a small portion of this memory is actually used.
In addition, the code calls many costly gl operations during the
caching process.
This commit significantly reduce the amount of memory by allocating
and transferring a flat array without pads to the GPU.
It also calls as little as possible the gl operations during the cache.
This code also simulate a billinear filter `GL_LINEAR` using a 1D texture.
**Average drawing time:**
|before:|0.00003184 sec
|now:|0.00001943 sec
|fac:|1.6385156675048407
**5 worst times:**
|before:|[0.001075, 0.001433, 0.002143, 0.002915, 0.003242]
|now:|[0.00094, 0.000993, 0.001502, 0.002284, 0.002328]
Differential Revision: https://developer.blender.org/D6886
2020-02-23 21:30:27 +01:00
|
|
|
struct GlyphCacheBLF *glyph_cache;
|
2018-03-30 19:16:14 +02:00
|
|
|
} BatchBLF;
|
|
|
|
|
|
|
|
extern BatchBLF g_batch;
|
|
|
|
|
2018-03-31 15:24:10 +02:00
|
|
|
typedef struct KerningCacheBLF {
|
2021-08-16 06:13:53 +02:00
|
|
|
/**
|
|
|
|
* Cache a ascii glyph pairs. Only store the x offset we are interested in,
|
|
|
|
* instead of the full #FT_Vector since it's not used for drawing at the moment.
|
|
|
|
*/
|
|
|
|
int ascii_table[KERNING_CACHE_TABLE_SIZE][KERNING_CACHE_TABLE_SIZE];
|
2018-03-31 15:24:10 +02:00
|
|
|
} KerningCacheBLF;
|
|
|
|
|
2009-02-17 17:56:29 +01:00
|
|
|
typedef struct GlyphCacheBLF {
|
|
|
|
struct GlyphCacheBLF *next;
|
|
|
|
struct GlyphCacheBLF *prev;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* font size. */
|
2021-11-13 18:39:18 +01:00
|
|
|
float size;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* and dpi. */
|
2013-05-12 08:33:21 +02:00
|
|
|
unsigned int dpi;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
2020-06-06 00:39:17 +02:00
|
|
|
bool bold;
|
|
|
|
bool italic;
|
|
|
|
|
2022-02-05 02:49:21 +01:00
|
|
|
/* Column width when printing monospaced. */
|
|
|
|
int fixed_width;
|
|
|
|
|
2009-02-09 08:15:22 +01:00
|
|
|
/* and the glyphs. */
|
|
|
|
ListBase bucket[257];
|
|
|
|
|
2011-09-12 11:12:34 +02:00
|
|
|
/* fast ascii lookup */
|
2021-08-13 23:31:10 +02:00
|
|
|
struct GlyphBLF *glyph_ascii_table[GLYPH_ASCII_TABLE_SIZE];
|
2011-09-12 11:12:34 +02:00
|
|
|
|
2009-02-09 08:15:22 +01:00
|
|
|
/* texture array, to draw the glyphs. */
|
BLF: Optimize text rendering and caching
The current code allocates and transfers a lot of memory to the GPU,
but only a small portion of this memory is actually used.
In addition, the code calls many costly gl operations during the
caching process.
This commit significantly reduce the amount of memory by allocating
and transferring a flat array without pads to the GPU.
It also calls as little as possible the gl operations during the cache.
This code also simulate a billinear filter `GL_LINEAR` using a 1D texture.
**Average drawing time:**
|before:|0.00003184 sec
|now:|0.00001943 sec
|fac:|1.6385156675048407
**5 worst times:**
|before:|[0.001075, 0.001433, 0.002143, 0.002915, 0.003242]
|now:|[0.00094, 0.000993, 0.001502, 0.002284, 0.002328]
Differential Revision: https://developer.blender.org/D6886
2020-02-23 21:30:27 +01:00
|
|
|
GPUTexture *texture;
|
|
|
|
char *bitmap_result;
|
|
|
|
int bitmap_len;
|
|
|
|
int bitmap_len_landed;
|
|
|
|
int bitmap_len_alloc;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
} GlyphCacheBLF;
|
|
|
|
|
2009-08-06 22:06:02 +02:00
|
|
|
typedef struct GlyphBLF {
|
|
|
|
struct GlyphBLF *next;
|
|
|
|
struct GlyphBLF *prev;
|
|
|
|
|
2021-08-13 23:31:10 +02:00
|
|
|
/* and the character, as UTF-32 */
|
2009-08-06 22:06:02 +02:00
|
|
|
unsigned int c;
|
|
|
|
|
2009-08-18 21:26:53 +02:00
|
|
|
/* freetype2 index, to speed-up the search. */
|
|
|
|
FT_UInt idx;
|
|
|
|
|
2009-08-06 22:06:02 +02:00
|
|
|
/* glyph box. */
|
|
|
|
rctf box;
|
|
|
|
|
|
|
|
/* advance size. */
|
|
|
|
float advance;
|
2014-07-16 03:09:42 +02:00
|
|
|
/* avoid conversion to int while drawing */
|
|
|
|
int advance_i;
|
2009-08-06 22:06:02 +02:00
|
|
|
|
2009-02-09 08:15:22 +01:00
|
|
|
/* position inside the texture where this glyph is store. */
|
BLF: Optimize text rendering and caching
The current code allocates and transfers a lot of memory to the GPU,
but only a small portion of this memory is actually used.
In addition, the code calls many costly gl operations during the
caching process.
This commit significantly reduce the amount of memory by allocating
and transferring a flat array without pads to the GPU.
It also calls as little as possible the gl operations during the cache.
This code also simulate a billinear filter `GL_LINEAR` using a 1D texture.
**Average drawing time:**
|before:|0.00003184 sec
|now:|0.00001943 sec
|fac:|1.6385156675048407
**5 worst times:**
|before:|[0.001075, 0.001433, 0.002143, 0.002915, 0.003242]
|now:|[0.00094, 0.000993, 0.001502, 0.002284, 0.002328]
Differential Revision: https://developer.blender.org/D6886
2020-02-23 21:30:27 +01:00
|
|
|
int offset;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
2009-08-06 22:51:41 +02:00
|
|
|
/* Bitmap data, from freetype. Take care that this
|
|
|
|
* can be NULL.
|
|
|
|
*/
|
|
|
|
unsigned char *bitmap;
|
|
|
|
|
2020-05-03 09:55:39 +02:00
|
|
|
/* Glyph width and height. */
|
|
|
|
int dims[2];
|
2009-08-18 21:26:53 +02:00
|
|
|
int pitch;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
2020-05-03 09:55:39 +02:00
|
|
|
/**
|
|
|
|
* X and Y bearing of the glyph.
|
2009-02-09 08:15:22 +01:00
|
|
|
* The X bearing is from the origin to the glyph left bbox edge.
|
|
|
|
* The Y bearing is from the baseline to the top of the glyph edge.
|
|
|
|
*/
|
2020-05-03 09:55:39 +02:00
|
|
|
int pos[2];
|
2009-08-06 22:51:41 +02:00
|
|
|
|
2020-02-27 14:55:07 +01:00
|
|
|
struct GlyphCacheBLF *glyph_cache;
|
2009-02-09 08:15:22 +01:00
|
|
|
} GlyphBLF;
|
|
|
|
|
2012-08-13 00:18:20 +02:00
|
|
|
typedef struct FontBufInfoBLF {
|
|
|
|
/* for draw to buffer, always set this to NULL after finish! */
|
|
|
|
float *fbuf;
|
|
|
|
|
|
|
|
/* the same but unsigned char */
|
|
|
|
unsigned char *cbuf;
|
|
|
|
|
2020-05-03 09:55:39 +02:00
|
|
|
/** Buffer size, keep signed so comparisons with negative values work. */
|
|
|
|
int dims[2];
|
2012-08-13 00:18:20 +02:00
|
|
|
|
|
|
|
/* number of channels. */
|
|
|
|
int ch;
|
|
|
|
|
Color Management, Stage 2: Switch color pipeline to use OpenColorIO
Replace old color pipeline which was supporting linear/sRGB color spaces
only with OpenColorIO-based pipeline.
This introduces two configurable color spaces:
- Input color space for images and movie clips. This space is used to convert
images/movies from color space in which file is saved to Blender's linear
space (for float images, byte images are not internally converted, only input
space is stored for such images and used later).
This setting could be found in image/clip data block settings.
- Display color space which defines space in which particular display is working.
This settings could be found in scene's Color Management panel.
When render result is being displayed on the screen, apart from converting image
to display space, some additional conversions could happen.
This conversions are:
- View, which defines tone curve applying before display transformation.
These are different ways to view the image on the same display device.
For example it could be used to emulate film view on sRGB display.
- Exposure affects on image exposure before tone map is applied.
- Gamma is post-display gamma correction, could be used to match particular
display gamma.
- RGB curves are user-defined curves which are applying before display
transformation, could be used for different purposes.
All this settings by default are only applying on render result and does not
affect on other images. If some particular image needs to be affected by this
transformation, "View as Render" setting of image data block should be set to
truth. Movie clips are always affected by all display transformations.
This commit also introduces configurable color space in which sequencer is
working. This setting could be found in scene's Color Management panel and
it should be used if such stuff as grading needs to be done in color space
different from sRGB (i.e. when Film view on sRGB display is use, using VD16
space as sequencer's internal space would make grading working in space
which is close to the space using for display).
Some technical notes:
- Image buffer's float buffer is now always in linear space, even if it was
created from 16bit byte images.
- Space of byte buffer is stored in image buffer's rect_colorspace property.
- Profile of image buffer was removed since it's not longer meaningful.
- OpenGL and GLSL is supposed to always work in sRGB space. It is possible
to support other spaces, but it's quite large project which isn't so
much important.
- Legacy Color Management option disabled is emulated by using None display.
It could have some regressions, but there's no clear way to avoid them.
- If OpenColorIO is disabled on build time, it should make blender behaving
in the same way as previous release with color management enabled.
More details could be found at this page (more details would be added soon):
http://wiki.blender.org/index.php/Dev:Ref/Release_Notes/2.64/Color_Management
--
Thanks to Xavier Thomas, Lukas Toene for initial work on OpenColorIO
integration and to Brecht van Lommel for some further development and code/
usecase review!
2012-09-15 12:05:07 +02:00
|
|
|
/* display device used for color management */
|
|
|
|
struct ColorManagedDisplay *display;
|
2012-08-13 00:18:20 +02:00
|
|
|
|
|
|
|
/* and the color, the alphas is get from the glyph!
|
2021-10-06 05:44:27 +02:00
|
|
|
* color is sRGB space */
|
2015-09-18 12:10:26 +02:00
|
|
|
float col_init[4];
|
|
|
|
/* cached conversion from 'col_init' */
|
|
|
|
unsigned char col_char[4];
|
|
|
|
float col_float[4];
|
|
|
|
|
2012-08-13 00:18:20 +02:00
|
|
|
} FontBufInfoBLF;
|
|
|
|
|
2009-02-09 08:15:22 +01:00
|
|
|
typedef struct FontBLF {
|
2009-02-12 06:02:42 +01:00
|
|
|
/* font name. */
|
2009-02-09 08:15:22 +01:00
|
|
|
char *name;
|
2009-02-12 06:02:42 +01:00
|
|
|
|
2019-01-14 06:28:07 +01:00
|
|
|
/* # of times this font was loaded */
|
|
|
|
unsigned int reference_count;
|
|
|
|
|
2022-03-24 06:33:32 +01:00
|
|
|
/** File-path or NULL. */
|
|
|
|
char *filepath;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* aspect ratio or scale. */
|
Change the BLF_aspect function to handle 3d text.
This is need to properly handle 3d text (dalai work on GE), before
the BLF_aspect only take one argument, and the result was a call to:
glScalef(aspect, aspect, 1.0)
Now the three value are store in the font (x, y and z) and also
need to be enable using BLF_enable(BLF_ASPECT).
By default all the code that don't have BLF_ASPECT enable work with
a scale of 1.0 (so nothing change to the current UI).
I also remove all the call of BLF_aspect(fontid, 1.0) found in
the editors, because is disable by default, so no need any more.
Campbell the only thing to check is the python api, right now
I modify the api to from:
BLF_aspect(fontid, aspect)
to:
BLF_aspect(fontid, aspect, aspect, 1.0)
This is to avoid break the api, but now you need add the BLF_ASPECT
option to the function py_blf_enable and in some point change
py_blf_aspect to take 3 arguments.
2010-12-09 23:27:55 +01:00
|
|
|
float aspect[3];
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* initial position for draw the text. */
|
|
|
|
float pos[3];
|
|
|
|
|
2013-02-21 18:15:19 +01:00
|
|
|
/* angle in radians. */
|
2009-02-19 17:39:36 +01:00
|
|
|
float angle;
|
2018-06-08 08:07:48 +02:00
|
|
|
|
2016-10-16 17:28:12 +02:00
|
|
|
#if 0 /* BLF_BLUR_ENABLE */
|
2009-04-10 16:27:29 +02:00
|
|
|
/* blur: 3 or 5 large kernel */
|
|
|
|
int blur;
|
2016-10-16 01:40:41 +02:00
|
|
|
#endif
|
2009-06-23 18:27:35 +02:00
|
|
|
|
|
|
|
/* shadow level. */
|
|
|
|
int shadow;
|
|
|
|
|
|
|
|
/* and shadow offset. */
|
|
|
|
int shadow_x;
|
|
|
|
int shadow_y;
|
|
|
|
|
|
|
|
/* shadow color. */
|
2016-10-16 08:08:16 +02:00
|
|
|
unsigned char shadow_color[4];
|
2011-09-17 12:45:20 +02:00
|
|
|
|
2016-10-16 08:08:16 +02:00
|
|
|
/* main text color. */
|
|
|
|
unsigned char color[4];
|
2011-09-17 12:45:20 +02:00
|
|
|
|
2010-12-09 05:36:58 +01:00
|
|
|
/* Multiplied this matrix with the current one before
|
|
|
|
* draw the text! see blf_draw__start.
|
|
|
|
*/
|
2015-12-14 03:19:45 +01:00
|
|
|
float m[16];
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* clipping rectangle. */
|
|
|
|
rctf clip_rec;
|
|
|
|
|
2015-09-18 12:10:26 +02:00
|
|
|
/* the width to wrap the text, see BLF_WORD_WRAP */
|
|
|
|
int wrap_width;
|
|
|
|
|
2009-02-09 08:15:22 +01:00
|
|
|
/* font dpi (default 72). */
|
2013-05-12 08:33:21 +02:00
|
|
|
unsigned int dpi;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* font size. */
|
2021-11-13 18:39:18 +01:00
|
|
|
float size;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
|
|
|
/* max texture size. */
|
2018-03-31 13:40:23 +02:00
|
|
|
int tex_size_max;
|
2009-02-09 08:15:22 +01:00
|
|
|
|
2009-02-20 06:42:44 +01:00
|
|
|
/* font options. */
|
|
|
|
int flags;
|
|
|
|
|
2020-06-06 00:39:17 +02:00
|
|
|
/* List of glyph caches (GlyphCacheBLF) for this font for size, dpi, bold, italic.
|
2019-09-14 02:22:42 +02:00
|
|
|
* Use blf_glyph_cache_acquire(font) and blf_glyph_cache_release(font) to access cache!
|
|
|
|
*/
|
2020-06-06 00:39:17 +02:00
|
|
|
ListBase cache;
|
2009-03-02 06:20:48 +01:00
|
|
|
|
2021-08-21 02:48:42 +02:00
|
|
|
/* Cache of unscaled kerning values. Will be NULL if font does not have kerning. */
|
2018-03-31 15:24:10 +02:00
|
|
|
KerningCacheBLF *kerning_cache;
|
|
|
|
|
2011-02-19 14:43:22 +01:00
|
|
|
/* freetype2 lib handle. */
|
|
|
|
FT_Library ft_lib;
|
|
|
|
|
2013-06-28 15:05:15 +02:00
|
|
|
/* Mutex lock for library */
|
|
|
|
SpinLock *ft_lib_mutex;
|
|
|
|
|
2009-05-08 21:47:40 +02:00
|
|
|
/* freetype2 face. */
|
|
|
|
FT_Face face;
|
2009-08-18 21:26:53 +02:00
|
|
|
|
2012-08-13 00:18:20 +02:00
|
|
|
/* data for buffer usage (drawing into a texture buffer) */
|
|
|
|
FontBufInfoBLF buf_info;
|
2019-09-14 02:22:42 +02:00
|
|
|
|
|
|
|
/* Mutex lock for glyph cache. */
|
|
|
|
SpinLock *glyph_cache_mutex;
|
2009-02-09 08:15:22 +01:00
|
|
|
} FontBLF;
|
|
|
|
|
2009-03-02 06:20:48 +01:00
|
|
|
typedef struct DirBLF {
|
|
|
|
struct DirBLF *next;
|
|
|
|
struct DirBLF *prev;
|
|
|
|
|
|
|
|
/* full path where search fonts. */
|
|
|
|
char *path;
|
|
|
|
} DirBLF;
|