NSX (QFont)

From Blood Wiki
(Difference between revisions)
Jump to: navigation, search
Line 58: Line 58:
 
|''y''
 
|''y''
 
|Y component of scale.
 
|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.
 
|}
 
|}
  
Line 70: Line 74:
 
! width=6% | Value
 
! width=6% | Value
 
! width=83% | Description
 
! 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
 
|slot
Line 111: Line 119:
 
|Characters uniform scale.
 
|Characters uniform scale.
 
|}
 
|}
 
  
  

Revision as of 20:23, 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:

  • 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 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
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox