NSX (QFont)
From Blood Wiki
(Difference between revisions)
(→[qfont] group) |
|||
| Line 63: | Line 63: | ||
|Path to font resources. Could be relative (if begins with ./) or absolute (from gamedir). Default is subfolder named as font file. | |Path to font resources. Could be relative (if begins with ./) or absolute (from gamedir). Default is subfolder named as font file. | ||
|} | |} | ||
| − | |||
| − | |||
== Freetype font face group == | == Freetype font face group == | ||
Revision as of 20:24, 2 July 2012
Contents |
Introduction
.QFONT files are .NSX scripts that holds parameters for NetherMenu font draw module.
Example of .QFONT file contents:
[qfont] type=FT face=default brightness=0.8 width=1.2 [default] file=./big.ttf sizes=38 glyphs=abcdefghijklmnopqrttuvwxyz0123456789 r_shadow=0.8 r_shadowblur=1 r_shadowofs=0 0.5 0.5
Structure
[qfont] group
Should be the first groups of file, it sets font drawer and face group.
| Key | Value | Description |
|---|---|---|
| type | x | Type of font drawer, each of it has it's advantages and disadvantages:
Possible values:
|
| face | string | Font face group. |
| brightness | value | Floating point value of brightness scale. 1 is nothing, 0.1 is 10% etc. |
| scale | x y | Two floating point values storing horizontal and vertical scale of font chars. |
| width | x | X component of scale. |
| height | y | Y component of scale. |
| respath | y | Path to font resources. Could be relative (if begins with ./) or absolute (from gamedir). Default is subfolder named as font file. |
Freetype font face group
Attributes of font face for freetype font renderer.
| Key | Value | Description |
|---|---|---|
| file | path | Path to .OTF/.TTF font file. Could be relative to respath (if begins with ./) or absolute (from gamedir root). |
| slot | slotname | Engine font slot. Used to replace fontmaps that was already initialized.
Darkplaces engine have this fixed slots: default, console, sbar, notify, chat, centerprint, infobar, menu, user0, user1, user2, user3, user4, user5, user6, user7. |
| glyphs | string | Engine font slot. Used to replace fontmaps that was already initialized.
Engine will render font pages containing this string chars (others will be rendered on demand). |
| r_antialias | 0/1 | Toggles antialiasing for font pages renderer. |
| r_hinting | 0/1/2/3 | Toggles hinting for font pages renderer. 0 - no hinting, 1 - light autohintinh, 2 - full autohinting, 3 - full hinting. |
| r_shadow | strength | Outline shadow strength (could be more than 1). |
| r_shadowblur | strength | Outline shadow blur. |
| r_shadowofs | x y z | Outline shadow offset. X and Y applied during rendering. Z is applied during blur. |
| r_charcushion | x | Characters vertical offset in percents (1 - 100%, 0.1 - 10%). |
| r_charscale | x | Characters uniform scale. |
Ascii font face group
Attributes of font face for freetype font renderer.
| Key | Value | Description |
|---|---|---|
| 1 | 2 | 3 |
