Orx Learning

User Tools

Site Tools

Trace:
en:orx:config:settings_structure:orxtext

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
en:orx:config:settings_structure:orxtext [2016/04/12 03:32 (8 years ago)] – Example of multiline added sausageen:orx:config:settings_structure:orxtext [2023/08/25 01:00 (8 months ago)] – [Summary] sausage
Line 6: Line 6:
  
 <code ini>[TextTemplate] <code ini>[TextTemplate]
 +String = "string to display"
 Font   = FontTemplate Font   = FontTemplate
-String = <string></code>+</code>
  
 === Font === === Font ===
  
-<code ini>[FontTemplate] +<code ini> 
-Texture           = path/to/ImageFile +[FontTemplate] 
-TextureOrigin     = <vector> +Texture            = path/to/ImageFile.ext 
-TextureSize       = <vector> +TextureOrigin      = <vector> 
-CharacterList     = <string> +TextureSize        = <vector> 
-CharacterSpacing  = <vector> +KeepInCache        = <bool> 
-CharacterSize     = <vector> +CharacterList      = "ordered list of character" 
-CharacterHeight   = <float> +CharacterSize      = <vector> 
-CharacterWidthList= <float> # <float> ...</code>+CharacterHeight    = <float> 
 +CharacterWidthList = <float> 
 +CharacterSpacing   = <vector> 
 +</code>
  
 ==== Details ==== ==== Details ====
Line 60: Line 64:
   * ''CharacterWidthList'': Only used for variable width fonts, ie. when ''CharacterSize'' is **not** defined. In this case, this contains a list of widths for every character defined in ''CharacterList'' in the same order.   * ''CharacterWidthList'': Only used for variable width fonts, ie. when ''CharacterSize'' is **not** defined. In this case, this contains a list of widths for every character defined in ''CharacterList'' in the same order.
  
-An example of how to use custom fonts can be found in the [[tutorials:locale|localization]] tutorial ((at the end of 10_Locale.ini)). +An example of how to use custom fonts can be found in the [[en:tutorials:localization:locale|localization]] tutorial ((at the end of 10_Locale.ini)).
  
 ===== orxFontGen ===== ===== orxFontGen =====
  
-orxFontGen is a command line tool that creates orx-formatted custom bitmap fonts (both .png texture and .ini config file).\\ +orxFontGen is a command-line tool that ships with Orx which allows you create bitmap fonts which can be define with the configuration detailed above. It can be found in the orx/tools/orxFontGen/bin folder. Available to compile for Windows, Linux and Mac. To learn how to use it follow the [[en:tutorials:text-fonts:orxfontgen|orxFontGen tutorial]].
-It gathers the needed characters from the given text files and print them, at the requested size, from a TrueType font file. +
- +
-orxFontGen is available for all supported development platforms. ((Windows, Linux, Mac OS X)) +
- +
-It is based on the open source [[http://www.freetype.org/|FreeType library]]. +
- +
-orxFontGen accepts a number of command line parameters: +
-  * [MANDATORY] a list of input text files to gather the needed characters +
-  * [MANDATORY] a TrueType font file ((usually .ttf)) +
-  * [MANDATORY] a size for characters to print, in pixels +
-  * [OPTIONAL]  a name for the custom font to output +
-  * [OPTIONAL]  the option to output monospace (ie. fixed width) characters no matter how the font was designed +
-  * [OPTIONAL]  when creating a non-monospace font, the advance option tells it to pack them as tight as possible or to use the metrics defined in the font (aka advance) +
-  * [OPTIONAL]  use the ascending value to determine the baseline (this value doesn't mean the same thing for all fonts, unfortunately) +
-  * [OPTIONAL]  an internal padding size for characters +
- +
-Here's its syntax: +
- +
-<code dos>orxfontgen -t TextFile [+ ...] -f FontFile -s Size [-o OutputName] [-m] [-a] [-asc] [-p Padding]</code> +
- +
-You can display its help with +
- +
-<code dos>orxfontgen -h</code> +
- +
-For any parameter, help can be diplayed using its long name: +
- +
-<code dos>orxfontgen -h ParameterLongName</code> +
- +
-Let's now see the parameters in details. +
- +
-==== Input text file list ==== +
- +
-**-t / ''-''''-''textlist** +
- +
-The text file list is mandatory. At least one file has to be provided and multiple files have to be separated by spaces. Unfortunately names of input text files can't include spaces for now.\\ +
-These files contains all the texts you want to display using this custom bitmal font: the needed characters will be extracted from them. They should be encoded either in plain ASCII or in UTF-8. +
- +
-Syntax: +
- +
-<code dos>-t TextFile1 [TextFile2 ... TextFileN]</code> +
- +
-If input files are encrypted with a user-provided key, you need to pass it to orxcrypt using its [[#Encryption key|encryption key parameter]]. +
- +
-==== TrueType font file ==== +
- +
-**-f / ''-''''-''font** +
- +
-The TrueType font file parameter is mandatory. It defines the TrueType font file ((usually .ttf)) to use for creating the custom bitmap font. +
- +
-Syntax: +
- +
-<code dos>-f FontFile</code> +
- +
-==== Size ==== +
- +
-**-s / ''-''''-''size** +
- +
-The size parameter is mandatory. It defines the size, in pixels, for the printed characters in the custom bitmap font. +
- +
-Syntax: +
- +
-<code dos>-s Size</code> +
- +
-==== Output name ==== +
- +
-**-o / ''-''''-''output** +
- +
-The output parameter is optional. If none is provided, the custom bitmap font will be stored in orxFont.png/orxFont.ini. +
- +
-==== Monospace ==== +
- +
-**-m / ''-''''-''monospace** +
- +
-This parameter is optional. If defined the font will be treated as a fixed width font, ie. all the characters will have the same size.\\ +
-Otherwise, by default, the tool will output a variable width font. +
- +
-==== Advance ==== +
- +
-**-a / ''-''''-''advance** +
- +
-This parameter is optional and only used if ''-m/--monospace'' is not defined. If defined the characters will use as width the metrics defined in the font.\\ +
-Otherwise, by default, the characters will be packed as tight as possible (usually preferable). +
- +
-==== Ascending ==== +
- +
-**-asc / ''-''''-''ascending** +
- +
-This parameter is optional. It will use the ascending value stored in the font to determine the baseline. Unfortunately the standard isn't always respected and this value might mean different things for different fonts. Only try it if your characters don't look correctly aligned vertically.\\ +
-Otherwise, by default, the max character height will be used to determine the baseline, which should work in most cases. +
- +
-==== Padding ==== +
- +
-**-p / ''-''''-''padding**+
  
-This parameter is optional. It defines the extra space, in pixel, to put around a character glyph and that will become part of the character itself after export. 
  
 ==== Latest config settings for the Development Version ==== ==== Latest config settings for the Development Version ====
 {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}} {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}}
  
en/orx/config/settings_structure/orxtext.txt · Last modified: 2023/08/25 01:09 (8 months ago) by sausage

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC0 1.0 Universal
CC0 1.0 Universal Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki