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 Blood Omnicide font draw overlay (a QuakeC interface 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%"
| + | |
− | ! 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}}
| + | |
| | | |
| [[Category:File formats]] | | [[Category:File formats]] |
− |
| |
− | __NOTOC__
| |