NSX (QFont) - isgallagher/DpOmnicide GitHub Wiki
NSX that holds parameters for NetherMenu font draw module.
Example QFONT file:
''[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 ==
{| border="1" cellpadding="3" cellspacing="0" style="border-collapse: collapse; width:100%" ! width=6% | Key pair ! width=83% | Description |- | '''[qfont]''' | Should be the first groups of file. |- |'''type'''=''x'' |Type of font drawer, each of it has it's advantages and disadvantages:
Possible values:
- FT - Darkplaces vector fonts using freetype library
- ASCII - Quake ascii conchars (256 chars on a 16*16 table)
- GLYPH - QuakeC glyph font renderer (each char is separate picture) |- |'''face'''=''string'' |Font face. For freetype and glyph font renderers this is name of group. For Ascii it's a path to conchars texture. |- |'''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'''=''path'' |Path to font resources. Could be relative (if begins with ./) or absolute (from gamedir). Default is subfolder named as font file (i.e if font file is gfx/myfont.qfont, it's default resources directory will be ''gfx/myfont/''). |}
{{hidden begin | Freetype font face group }}
Attributes of font face for freetype font renderer.
{| border="1" cellpadding="3" cellspacing="0" style="border-collapse: collapse; width:100%" ! width=6% | Key pair ! width=83% | 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. |
| } |
| {{hidden end}} |
{{hidden begin | Glyph font face group }}
Attributes of font face for glyph font renderer.
{| border="1" cellpadding="3" cellspacing="0" style="border-collapse: collapse; width:100%" ! width=6% | Key pair ! width=83% | Description |- |'''respath'''=''path'' |Absolute path that overrides default font resources path. |- |'''glyph'''=''variable'' |Value is a string of: ''picture'' kern ''left'' ''right'' '''codes''' ''code1'' ''code2'' ''codeX''. Kern parmeter is optional. One pic may have many ASCII codes. |} {{hidden end}}
NOTOC