Yamyam: 1版をインポートしました

2018-06-28T17:51:37Z

1版をインポートしました

wiki>Mindrones: moved Dev:2.4/Source/Architecture/UI/Text Rendering to Dev:2.4/Source/UI/Text Rendering: uniforming with structure in 2.5/

2010-05-13T08:25:14Z

moved Dev:2.4/Source/Architecture/UI/Text Rendering to Dev:2.4/Source/UI/Text Rendering: uniforming with structure in 2.5/

新規ページ

==Some Terminology==
APIs that are referred to by their prefixes:
<pre>
BMF_...
FTF_...
FTGL_...
BIF_...
</pre>
The uses of these, and the relationships between them are the subject of this document, but it probably makes this more readable if you know that these are all used for drawing fonts in one way or another, and all of them have one (or more!) DrawString(...) functions.

=Current Specification=
==Overview==

Interface text rendering in Blender is currently achieved through a series of APIs using the FreeType library at the lowest level, as shown by the callgraph.

The callgraph is for a cvs build circa 2.44 The untidy calls from ui_draw_but_tip() (red block, second line) are resolved by [https://projects.blender.org/tracker/index.php?func=detail&aid=6770&group_id=9&atid=127 patch 6770], after this patch all of the translatable interface text rendering is all achieved through the dark blue functions on the third row.

There is <s>some</s> a lot of non-translatable text however - [[#Current Limitations | see below]] - that is still drawn directly using the bitmap functions.

{|
|valign=top|[[Image:Design-BlenderFontCallGraph-BIF_Drawstring.png|200px|thumb|right|cachgrind callgraph for BIF_Drawstring (draws translatable text)]]
|valign=top|[[Image:Design-FTGL-IncumbantFontClassDiagram.png|200px|thumb|right|Class diagram of fonts in the FTGL library]]
|valign=top|[[Image:Design-BlenderFontCallgraph_depth8_70percent.png|200px|thumb|right|cachgrind callgraph for FT_Render_Glyph]]
|}

{{clr}}

==Summary==
The relationships can be summarised:

[[Image:Design-textRenderingInterfaces.png|300px|thumb|right|Structure of the current text rendering system]]

*Bitmap text rendering using internal fonts.
**This is the BMF_Font API, which can only use the bitmap fonts (of various sizes) built into blender at compile time, the actual font drawing is done using 2D OpenGL functions.
*Pixmap text rendering using external fonts.
**Provided by [http://homepages.paradise.net.nz/henryj/code/ FTGL] (a modified version of, compiled into Blender)
**Pixmap fonts are drawn using OpenGL's '''2D drawing functions''', which makes them very slow on most systems.
*Texture text rendering using external fonts.
**Also provided by FTGL, the choice between Pixmap or texture font is made by the BFFont_TTFont layer.
**Texture fonts are fully 3D OpenGL entities, they are also very fast.
*Translation of strings as they are drawn.
*:Using the GNUGetText library.
{{clr}}

==2D and 3D Coordinate systems==
When calling <code>BIF_DrawString()</code>, the string may be drawn in either Bitmap, pixmap, or texture modes, depending on the current settings. This means that any function that draws text must first set up '''both''' the 2D openGL coordinates, and a correct openGL transformation matrix before drawing.
===2D===
The BMF_ and FTGL pixmap fonts both render strings starting from the current openGL raster position, (set with <code>glRasterPos2f(float, float);</code> and family).

The funtion <code>BIF_RasterPos(float x, float y);</code> does not set an offset for the raster fonts, but only for the 3D texture fonts, [[#3D|See below]].

The Pixmap fonts are drawn at the resolution at which they are loaded by FTGL, which can be set with a call to <code>BIF_SetScale(float aspect)</code>. This function calls <code>FTF_SetScale(float s)</code>, which indirectly results in a series of calls to the FTGL functions that change the resolution of the font glyph images that are loaded. This has the same effect on the glyph images used by the 3D fonts.

The scale of the Bitmap fonts is determined by the particular font face (<code>struct BMF_Font*</code>) that is passed as the first argument to <code>BIF_DrawString(...)</code>. At the moment three different built-in fonts are used for different sizes, and are available through the Global struct:

<source lang="c">
typedef struct Global {
...
/* fonts, allocated global data */
struct BMF_Font *font, *fonts, *fontss;
...
} Global;
</source>

Their values are set as:
<source lang="c">
G.font= BMF_GetFont(BMF_kHelvetica12);
G.fonts= BMF_GetFont(BMF_kHelvetica10);
G.fontss= BMF_GetFont(BMF_kHelveticaBold8);
</source>

[[Category:Script]]

===3D===
FTGL draws text strings in texture mode starting at the origin, and then moves in the positive x direction at one texel per pixel.

The funtion <code>BIF_RasterPos(float x, float y);</code> sets an additional x and y offset for the texture fonts, it effectively results in a call to <code>glTranslatef(x, y, 0)</code> before the drawing of each string. This is useful, because since the raster position is transformed by openGL just like a 3D vertex coordinate, provided the matrices are left unchanged between calls, a call to BIF_RasterPos has the same effect for texture fonts that a call to glRasterPos has for bitmap and pixmap fonts.

The function <code>BIF_SetScale(float aspect)</code> that is used to select the resolution of the fonts also sets a scaling factor for texture fonts in order to assure that the text is drawn at one texel per pixel. The calls that result are essentially:
<source lang="c">
FTF_SetScale(float s) ->
FTF_TTFont::SetScale(float s) ->
... ->
glscalef(fsize, fsize , 1)
</source>
This compensates for the increased resolution of the glyph images being drawn into the textures [[#2D|see 2D section]].

[[Category:Script]]

===Setting up for drawing fonts===
In order for fonts drawn by BIF_DrawString to work (ie appear in the same place and at the same scale), the following is a rough guide to the calls that should be made.
''TODO: add more detail here''

*Setting up a matrix for drawing 3D fonts
''TODO: this section''
**The offset of the transformation matrix is not important - since any call to set the openGl raster position is subject to the same matrix as vertices. However, <code>BIF_RasterPos()</code> must be called with the same coordinates as <code>glRasterPos()</code>.
**The scale ?
<source lang="c">
uiPanelPush(block); // push matrix onto the stack
...
uiPanelPop(block); // restore previous matrix
</source>

<source lang="c">
glRasterPos
BIF_Rasterpos
</source>

the function <code>void ui_rasterpos_safe(float x, float y, float aspect);</code> essentially calls both of the above, setting up the 2D raster position for bitmap/pixmap fonts, and the BIF_Rasterpos offset for the 3D fonts

[[Category:Script]]

=Current Limitations=
*Only a single font can be used at any time.
**Font previews in menus are impossible
**The same font must be used for the whole interface

*There is poor support for anti-aliasing, making blenders fonts particularly ugly:
**Hinting is currently turned off.
**There is no support for sub pixel hinting.

*There is a large amount of redundancy in interfaces and ways of doing things:
**There are three different ways of rendering fonts.
**The bitmap font is still used when in international mode for views other than the buttons or nodes.
*:This includes the 3DView, file browsers, Text Editor and many others; the strings in these windows can not be translated, ugly aliased fonts are always used.

*Restricted range of font sizes.
*:As panels are scaled, the font size is picked from one of three distinct sizes, and three fonts are loaded at any time.

[[Category:The Rube Goldberg Internals of Blender]] [[Category:API's]] [[Category:Interface]] [[Category:Development]] [[Category:Architecture]]
[[Category:Script]]

← 古い版	2018年6月28日 (木) 17:51時点における版
(相違点なし)

Dev:2.4/Source/UI/Text Rendering - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Mindrones: moved Dev:2.4/Source/Architecture/UI/Text Rendering to Dev:2.4/Source/UI/Text Rendering: uniforming with structure in 2.5/

Yamyam: 1版をインポートしました