Latest revision |
Your text |
Line 1: |
Line 1: |
− | [[NSX|NSX scripts]] that holds parameters for [[NetherMenu]] font draw module.
| + | = Introduction = |
| | | |
− | Example QFONT file: | + | .QFONT files are [[NSX|.NSX scripts]] that holds parameters for [[NetherMenu]] font draw module. |
| + | |
| + | Example of .QFONT file contents: |
| | | |
| ''[qfont]'' | | ''[qfont]'' |
Line 17: |
Line 19: |
| r_shadowofs=0 0.5 0.5 | | r_shadowofs=0 0.5 0.5 |
| | | |
− | == Structure ==
| + | = Structure = |
| | | |
− | {| border="1" cellpadding="3" cellspacing="0" style="border-collapse: collapse; width:100%"
| + | == [qfont] group == |
− | ! width=6% | Key pair
| + | |
− | ! width=83% | Description
| + | Should be the first groups of file, it sets font drawer and face group. |
− | |-
| + | |
− | | '''[qfont]'''
| + | ==== type ''x'' ==== |
− | | Should be the first groups of file.
| + | Type of font drawer, each of it has it's advantages and disadvantages: |
− | |-
| + | |
− | |'''type'''=''x''
| + | |
− | |Type of font drawer, each of it has it's advantages and disadvantages:
| + | |
| | | |
| Possible values: | | Possible values: |
− | * FT - Darkplaces vector fonts using freetype library | + | * ''ft'' - Darkplaces vector fonts using freetype library |
− | * ASCII - Quake ascii conchars (256 chars on a 16*16 table) | + | * ''ascii'' - Quake ascii conchars (256 chars on a 16*16 table) |
− | * GLYPH - QuakeC glyph font renderer (each char is separate picture) | + | * ''glyph'' - QuakeC glyph font renderer (each char is separatepic). |
− | |-
| + | |
− | |'''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 }}
| + | ==== face ''path'' ==== |
| + | Path to the glyphs map which have different value based on font renderer type: |
| | | |
− | Attributes of font face for freetype font renderer.
| + | * for ascii conchars its path to conchars map. |
| + | * for freetype is path to .TTF/.OTF file. |
| + | * for glyph renderer it is name of glyph table group. |
| | | |
− | {| border="1" cellpadding="3" cellspacing="0" style="border-collapse: collapse; width:100%"
| + | ==== brightness ''x'' ==== |
− | ! 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.
| + | Floating point value of brightness scale. 1 is nothing, 0.1 is 10% etc. |
− | |-
| + | |
− | |'''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).
| + | Applies to all renderer types. |
− | |-
| + | |
− | |'''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 }}
| + | ==== scale ''x'' ''y'' ==== |
| | | |
− | Attributes of font face for glyph font renderer.
| + | Two floating point values storing horizontal and vertical scale of font chars. |
| | | |
− | {| border="1" cellpadding="3" cellspacing="0" style="border-collapse: collapse; width:100%"
| + | Applies to all renderer types. |
− | ! 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}}
| + | |
| | | |
− | [[Category:File formats]]
| + | ==== width ''x'' ==== |
| | | |
− | __NOTOC__
| + | X component of scale. |
| + | |
| + | ==== height ''y'' ==== |
| + | |
| + | Y component of scale. |
| + | |
| + | ==== respath ''path'' ==== |
| + | |
| + | Path to font resources. Default path is sub-folder named as qfont file without extension. |
| + | |
| + | [[Category:File formats]] |